前言¶

DeepSeek Harness（DSH）的插件机制允许在工作流里加入扩展能力。dsh-plugin-clarify（下文简称 Clarify）是 Hilbert-beinghappy 维护的第三方 Host 插件，用于在正式发送前处理“需求还说不清”的阶段：它绑定当前真实 Session，读取用户草稿和模型可见上下文，通过逐题澄清生成一份待确认的 Draft。发送仍由用户决定，澄清问题本身不进入主 Session transcript。下面介绍它的能力、安装方式和用法。

这是什么¶

定位¶

Clarify 是 DeepSeek Harness Host 插件，许可证为 MIT。它专注澄清状态机与 Draft 生成；真实模型调用经同进程 Auxiliary Runtime 执行并单独计量。

与 /plan 的关系¶

Clarify 产出用户需求草稿，Plan 产出实施方案。推荐路径是先用 /clarify 问清需求并采用 Draft，审阅后发送，再在需要时运行 /plan。

核心功能¶

澄清流程¶

Clarify 的工作流程如下：

1、绑定当前真实 Session，读取用户草稿与模型可见上下文。
2、沿当前模型路由生成苏格拉底式问题、上下文相关选项、后续分支和 live Draft preview。
3、用户每回答一个问题，后续状态与预览稿都会吸收已经确认的决定。
4、仍可继续追问、refine、采用 Draft 或结束澄清。
5、澄清完成后冻结当前预览，并返回待确认 Draft。
6、在 SeekTTY 中，该 Draft 会写回普通输入框，供用户编辑并决定发送。

Remote 接口¶

Clarify 提供 Typert Remote 命名空间 clarify 的六个方法：

兼容的 Clarify 六方法 Remote 与 clarify.wire/1 激活后，SeekTTY 会把 /clarify 加入本地命令目录。

状态、记录与用量¶

每个澄清进程绑定已有 sessionId，状态为：

running
cancelled
stale
complete

默认 15 分钟无交互后进入 stale，并返回：

staleReason=ttl-expired

问题、选项、live Draft preview 和 refine 反馈保留在 Host 内存中的临时进程里。主 Session transcript 继续保存正式对话：用户审阅并发送后的消息、助手回复、工具记录，以及随后 /plan 产生的计划审查。澄清状态与 input queue、pending、Plan、Goal、Profile 和本地文件相互分离。

模型调用经同进程 auxiliaryRuntime 执行，用量写入官方 storageDomain 的 auxiliary_runtime 域。官方 tokenUsage 继续表示 Agent 循环。SeekTTY /status 在快照健康时分栏展示 Official、Auxiliary 和读取时派生的 Combined。

辅助账本保存调用标识、purpose、状态、Token 桶、规范化失败和时间戳；prompt、消息正文、模型输出、自定义回答、凭据和文件路径保留在账本之外。

安装与启用¶

运行要求¶

package.json 声明：

"node": ">=22"
"type": "module"

并声明：

"testedHost": "0.1.1-rc.2",
"testedHosts": [
  "0.1.0-rc.8",
  "0.1.1-rc.2"
]

推荐回滚栈：SeekTTY 终端¶

资料明确 0.2.2 已发布，但不是推荐联合基线。推荐回滚栈为：

@deepseek-ai/dsh@0.1.0-rc.8
Clarify 0.2.1
Auxiliary Runtime 0.1.0
SeekTTY 1.2.0

在终端体验 /clarify 时，先把 DSH 与插件安装进同一个 tui Profile：

pnpm add --global @deepseek-ai/dsh@0.1.0-rc.8

dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz
dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/dsh-plugin-auxiliary-runtime/releases/download/v0.1.0/dsh-plugin-auxiliary-runtime-0.1.0.tgz
dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/dsh-plugin-clarify/releases/download/v0.2.1/dsh-plugin-clarify-0.2.1.tgz
dsh --profile tui

Host DIY 页面使用独立的 web Profile：

dsh plugin --profile web add https://github.com/Hilbert-beinghappy/dsh-plugin-auxiliary-runtime/releases/download/v0.1.0/dsh-plugin-auxiliary-runtime-0.1.0.tgz
dsh plugin --profile web add https://github.com/Hilbert-beinghappy/dsh-plugin-clarify/releases/download/v0.2.1/dsh-plugin-clarify-0.2.1.tgz
dsh --profile web

卸载和重装继续使用官方原生命令：

dsh plugin --profile tui remove dsh-plugin-clarify
dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/dsh-plugin-clarify/releases/download/v0.2.1/dsh-plugin-clarify-0.2.1.tgz

Web-only 0.2.2¶

0.2.2 已发布 GitHub Release。Web-only 安装可添加已发布 Clarify；如需推理，再添加已发布 Auxiliary Runtime。不要把 SeekTTY 写进新的推荐组合：

pnpm add --global @deepseek-ai/dsh@0.1.1-rc.2
dsh plugin --profile web add https://github.com/Hilbert-beinghappy/dsh-plugin-auxiliary-runtime/releases/download/v0.1.1/dsh-plugin-auxiliary-runtime-0.1.1.tgz
dsh plugin --profile web add https://github.com/Hilbert-beinghappy/dsh-plugin-clarify/releases/download/v0.2.2/dsh-plugin-clarify-0.2.2.tgz

Host 与 Auxiliary Runtime 配对规则只写在文档里：

Host 0.1.1-rc.2 配 Auxiliary Runtime 0.1.1
Host 0.1.0-rc.8 配 Auxiliary Runtime 0.1.0

Clarify 不把这对规则做成 wire 或公共 API 检查。

典型用法¶

在 SeekTTY 中¶

激活后，常见入口有三种：

1、从命令面板执行 /clarify：保留整个输入区作为 seed。
2、输入：

/clarify some text

以参数文本作为 seed。
3、在现有草稿末尾单独加入 /clarify token 或一行：

your draft
/clarify

以前面的草稿作为 seed。

需要继续澄清时，界面通常一次只显示一道基于上下文生成的问题、对应选项和最新 Draft preview。预览已经达到可发送状态时，流程会直接进入审阅。提问次数由当前 Session、草稿和已确认决定共同确定。

Host DIY 页面¶

仓库自带 GET /clarify Host DIY 页面，使用相同的 /api Remote，适合集成验证和其他 Surface 开发。

页面要求填入一个已经存在的 sessionId。澄清结束后可以复制 Draft，并在原 Surface 中自行发送。

推荐路径¶

推荐按下面顺序使用：

1、用 /clarify 问清需求。
2、采用 Draft。
3、审阅后发送。
4、需要实施方案时再运行 /plan。

适用场景与注意¶

适合以下场景：

1、在 DeepSeek Harness 工作流中，希望先澄清需求，再发送正式消息。
2、在 SeekTTY 终端里，用 /clarify 处理草稿中仍不明确的诉求。
3、做集成验证或其他 Surface 开发，使用仓库自带 GET /clarify 页面和同一组 Remote。
4、希望在 /plan 之前先把需求草稿问清楚。

注意事项：

1、Clarify 作为 Host 插件运行在当前 dsh 进程中，会读取当前 Session 的草稿和模型可见上下文，并使用该进程可访问的权限；安装前应检查源码，并确认 MIT 许可证符合你的使用要求。
2、0.2.2 已发布，但不是推荐联合基线；推荐回滚栈仍是 @deepseek-ai/dsh@0.1.0-rc.8 + Clarify 0.2.1 + Auxiliary Runtime 0.1.0 + SeekTTY 1.2.0。
3、澄清状态默认 15 分钟无交互后进入 stale，并返回 staleReason=ttl-expired。
4、Host 与 Auxiliary Runtime 的配对规则只写在文档里，Clarify 不做 wire 或公共 API 检查。
5、社区目录页不是官方应用商店，与 DeepSeek / 幻方无官方从属关系。

结尾¶

Clarify 的核心价值，是在正式发送前把模糊想法逐题问成一份待确认、可自行发送的 Draft。它不代替主 Session 对话，也不直接把澄清过程写入 transcript；用户审阅后，仍可决定何时发送。

相关链接：

• GitHub：https://github.com/Hilbert-beinghappy/dsh-plugin-clarify
• 目录页线索（来自插件线索，未在本次抓取资料中直接出现）：https://www.skillhub.cn/plugins/Hilbert-beinghappy/dsh-plugin-clarify