Hilbert-beinghappy/dsh-plugin-clarify

Clarify

基于当前 Session 和你的草稿，把模糊想法逐步问成一份待确认、可自行发送的 Draft。

项目概览
·
Clarify 与 Plan
·
使用体验
·
工作原理
·
快速开始
·
接口与兼容

中文主文档 · English overview

项目概览

Clarify 是 DeepSeek Harness 的 Host 插件。它绑定当前真实 Session，读取用户草稿与模型可见上下文，沿当前模型路由生成苏格拉底式问题、上下文相关选项、后续分支和 live Draft preview。用户每回答一个问题，后续状态与预览稿都会吸收已经确认的决定；仍有关键未知时继续追问，预览已经可发送时进入审阅。

澄清完成后，Clarify 冻结当前预览并返回一份待用户确认的 Draft。终端中的 SeekTTY 会把它写回普通输入框，用户可以继续编辑并决定何时发送。其他 Surface 可以通过同一组 Remote 接入；仓库自带的 GET /clarify 提供 Host DIY 页面。

真实推理由同一 Host 进程中的 Auxiliary Runtime 执行并单独计量。Clarify 专注于澄清状态机与 Draft 生成，模型准备、流式输出、限额、取消和辅助用量由 Auxiliary Runtime 统一承接。

[当前 Session + 用户草稿]
|
v
+------------------+      start / answer / refine
| 消费 Surface     | --------------------------------+
| SeekTTY 或 DIY   | ",
"method": "clarify/start",
"payload": { "args": { "sessionId": "", "seedText": "optional" } }
}

公开兼容与验证声明分两层：

| 栈 | 状态 | 组合 | 证据 |
| --- | --- | --- | --- |
| 已发布旧栈 | 已联合验收 | Host 0.1.0-rc.8 + Clarify 0.2.1 + Auxiliary 0.1.0 + SeekTTY 1.2.0 | 2026-08-21 隔离 DSH_HOME / 真实 PTY；0.2.1 无 Key 复验 add／boot／remove／re-add 与隔离 MISSING_CREDENTIAL |
| 已发布 0.2.2 | 已发布；不是推荐联合基线；Web-only T7 已观察 | 精确 stock Host 0.1.1-rc.2 上校验和核验（SeekTTY 已证明未安装）；Auxiliary 0.1.1 亦已发布 | T7 G0 通过：checksum-verified --from-release 无 key 实跑，INFERENCE_UNAVAILABLE + providerFailureCode=ENOTSUP，公开投影 unchanged。不是完整 T7，也不是新推荐联合基线。t7-full.json / t7-full-report.md 为 Web-only fullT7=true，不是 T4/T5/T6，也不是完整联合验收。Lane A/B 仍是历史观察 |

- 0.2.1 继承 0.2.0 的六方法 Remote、clarify.wire/1 和精确 rc.8 兼容边界。0.2.0 live-provider 联合验收覆盖动态问题／选项／preview、多轮演进、采用后只写回输入框、中断恢复、用量来源和隐私。0.2.1 未重跑 live-provider 动态多轮，也没有 cache／cost A/B。
- rc.6 / rc.7 只保留历史探针车道，不是 0.2.2 生产组合。
精确兼容矩阵与 T0 证据见 docs/compatibility.md 和 docs/t0-evidence/。pnpm t3 提供进程内 Remote 冒烟，真实 Host/TUI 验收使用联合轨道。

T0 探针由 CLARIFY_PROBE=1 或隔离 DSH_HOME/.clarify-probe 标记启用，并提供 GET /clarify/probe。这一入口服务于隔离测试夹具；日常 Profile 保持探针关闭。

开发

pnpm install
pnpm test
pnpm build
pnpm pack:check
pnpm t3
pnpm t0:dsh011rc2
pnpm t1:dsh011rc2
pnpm t0:dsh011rc1
pnpm t1:dsh011rc1
pnpm t0:matrix
pnpm t1:matrix
pnpm t7:validate
pnpm t7:from-pack
pnpm t7:from-release

pnpm t0:dsh011rc2 / pnpm t1:dsh011rc2 是当前生产精确 lane。pnpm t0:dsh011rc1 / pnpm t1:dsh011rc1 只复现同日被替换的 0.1.1-rc.1，不能代替 rc.2。pnpm t7:validate 核验已入库 t7/1 的结构与声明一致性，并报告实际分类；当前入库 G0 通过，但不是完整 T7。G0 是无 key 安全/遏制闸门：要求 INFERENCE_UNAVAILABLE 加上稳定的 provider-neutral providerFailureCode（本 lane 实跑为 ENOTSUP，不是 MISSING_CREDENTIAL）、未变的公开快照、已证明无 SeekTTY，以及 /clarify 六方法控件。--from-pack 不是用户价值证据。pnpm t7:from-release 是显式本地资产命令，必须同时提供已发布 dsh-plugin-clarify-0.2.2.tgz 与 dsh-plugin-auxiliary-runtime-0.1.1.tgz 及对应 SHA256SUMS；版本来自已知输入，文件名必须精确匹配。无 key / mock 不等于完整 T7。Web-only 完整 T7 另见 t7-full.json / t7-full-report.md，不由 t7:validate 核验。

CI verify 运行测试、干净构建、打包检查和进程内冒烟。Release 前还会在三个项目的联合轨道中执行官方 Host、真实 PTY、安装、卸载和重装门禁。

许可

MIT