前言¶
用 DeepSeek Harness（DSH）跑複雜任務時，常見情況是命令和工具調用連續刷屏，正文卻遲遲不出現。你能看出代理還在跑，但不知道做到哪一步、下一步打算做什麼。社區插件 過程播報（jevonhou/dsh-progress-narration，npm 包名 dsh-plugin-progress-narration）通過在工作流裏插入「該說兩句了」的提醒，引導模型在關鍵節點用正文簡短說明進度，而不是憋到最後一次性彙報。
這是什麼¶
過程播報 是維護者 jevonhou 發佈在 SkillHub「工作流」分類下的 DSH 插件。源碼版本爲 0.2.11，許可證 MIT。它不改變 DSH 的執行能力，而是在會話側按你選的檔位，檢測模型是否連續只調用工具；達到閾值時，在後續請求裏帶上簡短提醒，促使代理用自然語言同步進展（例如「找到問題了，我先修這兒」或「改好了，我跑一下測試」）。
核心功能¶
三檔播報頻率¶
在會話輸入框右側通過氣泡圖標打開面板，可選擇或拖動「膠囊」設置檔位，鬆手後生效；也可用方向鍵選檔，Esc 關閉。圖標會反映當前已保存的檔位，面板右上角圓形箭頭可恢復默認。
| 檔位 | 建議的播報節奏 |
|---|---|
| 剋制 | 開始前和關鍵節點簡短說明 |
| 標準（默認） | 大約每兩三步同步一次 |
| 話多 | 儘量在每個步驟完成後同步 |
觸發邏輯（服務端）¶
index.js 按檔位統計模型是否連續只調用工具。剋制、標準、話多分別在連續 6、3、2 步工具調用後，下一次請求會附帶簡短提醒。默認僅對主代理啓用播報提醒；檔位越高，模型輸出 token 通常越多。
界面與客戶端¶
client.js 負責氣泡圖標與播報頻率面板；插件以 JavaScript 在 Harness 內直接運行，無需單獨構建。界面約定見倉庫內 DESIGN.md。
安裝與啓用¶
需要 DeepSeek Harness 0.2.2-rc.1 或更新版本。README 寫明已在 macOS 上驗證，其他平臺尚未實測。
- 打開「設置 → 插件」，點擊「添加插件」。
- 輸入 GitHub 倉庫地址
https://github.com/jevonhou/dsh-progress-narration，按提示安裝當前源碼版本；安裝入口也接受該倉庫的本地絕對路徑。 - 若要用 npm 已發佈版本，在添加插件時輸入包名
dsh-plugin-progress-narration（版本以 npm 徽章爲準）。 - 回到會話，確認輸入框右側出現帶點的氣泡圖標。
卸載：在「設置 → 插件 → 過程播報」中選擇「卸載」。
典型用法¶
安裝並確認氣泡圖標出現後，無需改配置文件即可使用。根據任務長度與你對「廢話率」的容忍度選檔即可：
- 長鏈路排障、希望少打斷：剋制。
- 日常協作、希望每隔幾步有一句正文：標準（默認）。
- 需要逐步跟讀代理思路：話多。
檔位會持久保存；修改後圖標狀態會隨之更新。
適用場景與注意¶
適合誰： 經常讓 DSH 多步調用工具、又希望在對話正文裏看到階段性說明的開發者；歸類爲工作流類插件，側重交互節奏而非新工具能力。
運行與權限： 插件與當前 DSH 進程同權運行。安裝前建議瀏覽 GitHub 倉庫 源碼與 MIT 許可證，確認來源與行爲符合你的環境策略。
平臺： 官方說明僅 macOS 實測；Linux / Windows 需自行驗證。
生態說明： DSH 奉行「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
結尾¶
過程播報解決的是「工具一直在動、正文一言不發」的可見性問題：用可調檔位在主代理連續工具調用時插入提醒，讓進度回到對話正文裏。需要安裝步驟與源碼時，見目錄頁 https://www.skillhub.cn/plugins/jevonhou/dsh-progress-narration 與 GitHub https://github.com/jevonhou/dsh-progress-narration。
