前言¶

在 DeepSeek Harness（DSH）裏和助手對話時，常見情況是：一句話裏目標、範圍或驗收標準沒說清，助手只能猜着做，來回改幾輪纔對齊。自己先寫長提示詞可以緩解，但每條消息都手工擴寫成本高，也容易漏掉「不確認就沒法開工」的歧義（改哪個按鈕、用哪種策略、跑在哪個環境等）。

下面介紹社區插件 dsh-prompt-clarifier（維護者 Duanyy0813，分類：工作流）：在輸入區增加「提示詞優化」按鈕，在消息真正發給助手之前，按會話上下文做一次旁路分析與改寫；必要時先向你提問，再把合併後的指令交給助手執行。原始輸入仍保留在對話裏，改寫結果作爲本輪指令使用。

這是什麼¶

dsh-prompt-clarifier 是一個 DSH bundle 插件：通過 package.json 的 dsh.bundle.patch 指向 cordis.patch.yml，向 Host 插入 prompt-clarifier 插件行，並註冊瀏覽器端 client（按鈕、面板在網頁端）。當前 npm 包版本爲 0.3.6，許可證 MIT。

• 目錄頁：https://www.skillhub.cn/plugins/Duanyy0813/dsh-prompt-clarifier
• 源碼與說明：https://github.com/Duanyy0813/dsh-prompt-clarifier

核心功能¶

輸入前改寫¶

消息發出前做一次旁路分析，把含糊輸入補成更明確的指令（目標、範圍、驗收標準）。改寫結果作爲本輪指令交給助手；已發送的歷史消息不會被修改。

歧義優先澄清¶

缺少決定性信息、無法合理開工時，先彈出提問卡片：選項可點選，也可填「自定義回答…」。答案併入本輪指令。配置項 askBlocking 爲 true 時會阻塞等待；提問等待超過 askTimeoutMs（默認 180000 ms）則按假設繼續，不卡死回合。設爲 false 時只改寫、不提問。

主對話中的工具卡片¶

進度在同一張「提示詞優化」卡片裏累積：1/3 讀取上下文 → 2/3 模型分析 → 3/3 澄清提問 → 結果。回合進行中可見；回合結束後收進「思考過程」摺疊區。進度不塞進模型上下文，也不打斷對話流。

失敗不中斷¶

模型報錯、超時或返回無法解析時，卡片追加錯誤說明；本輪按原始輸入繼續執行。分析失敗不會中斷你的回合。

界面行爲摘要¶

按鈕位於輸入區控制行：輸入框下方、模型選擇器左側。

自動開啓時文案爲 提示詞優化·自動（藍色漸變底）；關閉時爲 提示詞優化·關閉（置灰）。分析進行中爲 提示詞優化 加呼吸圓點，按鈕臨時禁用。

插件不會在你還在輸入時提前分析：只有消息真正發出後才進入優化流程（打字、換行、輸入法組字都不算發送）。

安裝與啓用¶

前置條件：已安裝 DeepSeek Harness（桌面端或 Web GUI），Node.js ≥ 20。

命令行一鍵安裝¶

裝到當前 profile 時，將 desktop 換成 web 或 tui 即可：

dsh plugin --profile desktop add dsh-prompt-clarifier

指定版本示例：

dsh plugin --profile desktop add dsh-prompt-clarifier@0.3.6

沒有 dsh CLI 的環境，可在 DSH 裏讓助手安裝，實質是對助手說「安裝插件：dsh-prompt-clarifier」，由 plugin_manager 的 install_bundle 完成與命令行相同的安裝與啓用。官方準則：不要手工改 profile 的 package.json / cordis.patch.yml，也不要在 profile 目錄裏跑 pnpm。

安裝後可在 設置 → 插件（Plugin list） 啓用或停用插件行，或移除 bundle。

生效與驗證¶

1. Host 側（index.js、cordis.patch.yml）改動需重啓 Harness；客戶端（client.js）改動刷新頁面即可。
2. 重啓或刷新後，輸入區應出現 提示詞優化·自動 按鈕。
3. 右鍵切換關閉/開啓，發一條足夠長的消息，主對話裏應出現「提示詞優化」卡片並累積三個階段。

典型用法¶

自動模式¶

1. 保持按鈕爲 提示詞優化·自動（默認），正常輸入併發送；自動模式默認只處理不少於 10 字的消息（見配置 minChars）。
2. 發送前插件按上下文分析並改寫；主對話出現卡片，依次顯示各階段。
3. 無歧義：改寫稿作爲本輪指令執行，面板可查看「建議的優化版本」。
4. 有歧義：在提問卡片中選答案並確認，回答併入本輪指令。

手動分析與面板¶

自動關閉時，僅在左鍵點擊按鈕後分析當前草稿。面板支持：

• 查看「建議的優化版本」，替換草稿（寫回輸入框）或複製；寫回失敗時可「查看要粘貼的文本」。
• 出錯時顯示原因，可重試。

配置要點¶

配置寫在包的 cordis.patch.yml（安裝後位於 profile 的 loader 層），改完需重啓 Harness。

完整鍵說明見倉庫 README「配置」一節。

適用場景與注意¶

適合：經常在 DSH 裏用自然語言派活、希望發送前自動補全目標與範圍，又希望在關鍵歧義上先確認再執行的工作流。

注意：

• 旁路分析會調用你選中的（或配置的 fast）模型，有額外延遲與 token 消耗；大段粘貼超過 maxInputChars 會被跳過。
• 插件以當前 DSH 進程權限運行；安裝前建議閱讀源碼與 MIT 許可證，確認行爲符合你的環境策略。
• SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；包從 npm 安裝，星標與版本以 GitHub / npm 爲準。

結尾¶

dsh-prompt-clarifier 把「發送前提示詞優化 + 阻塞性歧義澄清」做成輸入區的一鍵能力：默認自動、可右鍵關閉，失敗時回退原始輸入，不拖垮整輪對話。需要試用或跟進 issue 時，可從目錄頁或 GitHub 倉庫入手。

• 目錄：https://www.skillhub.cn/plugins/Duanyy0813/dsh-prompt-clarifier
• GitHub：https://github.com/Duanyy0813/dsh-prompt-clarifier