前言¶

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