前言¶
DeepSeek Harness 的核心設計理念是「一切皆插件」。在實際開發長鏈路任務時，模型可能陷入長時間的靜默計算或工具調用，僅依賴工具調用日誌往往無法直觀反映當前進度。本插件引入 Codex 式的進度彙報機制，不再機械統計工具調用次數，而是按時間和有意義的工作狀態與用戶溝通。
是什麼¶
dsh-progress-reporter 是一個本地運行的 DSH 客戶端插件，由 baiyuscc13724-max 維護。它通過注入溝通規則和靜默檢測，在任務的關鍵節點（步驟邊界）觸發進度彙報，幫助用戶掌握長任務的當前狀態。
核心功能¶
-
規則注入與主動彙報
會話開始時，插件會將 Codex 風格的溝通規則注入模型上下文。當完成有意義階段、遇到阻塞或需要用戶決策時，模型會主動彙報。 -
時間觸發機制
超過約 60 秒沒有可見文字時，插件會在下一個官方步驟邊界插入檢查點，要求模型說明狀態。 -
精準控制
不按固定工具調用次數觸發，也不逐條播報常規操作。彙報後繼續工作，不破壞官方 Goal 機制。 -
避免干擾
默認僅作用於主代理，防止多個子代理同時刷屏。 -
隱私安全
完全本地運行，不聯網、不保存會話、不需要 API Key。
安裝與啓用¶
本插件默認未集成，需在 Harness Desktop 中手動安裝。
# 在 Harness Desktop 中操作
# 1. 打開 設置
# 2. 進入 DSH 插件市場
# 3. 搜索 dsh-progress-reporter
# 4. 點擊安裝並重啓 Harness
配置¶
默認配置位於 cordis.patch.yml：
config:
enabled: true
intervalSeconds: 60
includeSubagents: false
| 配置項 | 說明 |
|---|---|
intervalSeconds |
最長無可見文字時間，範圍 15–3600 秒 |
includeSubagents |
是否也要求子代理彙報 |
修改配置後需要重啓 DSH Web。
典型用法¶
使用時無需額外命令。插件監聽官方 agent/session-start、agent/pre-step 與 session/event 擴展點。會話開始時，它把 Codex 式溝通規則作爲模型上下文注入；達到靜默時間後，在下一步前追加一條摺疊的插件 notice。檢測到可見 assistant 文本後，靜默計時立即重置。模型只需用當前會話語言簡短說明“已完成、正在做、下一步或阻塞”。
適用場景與注意¶
- 版本要求：需要 DeepSeek Harness
0.1.0-rc.7或更高兼容版本。 - 邊界限制：進度檢查只能發生在步驟邊界。單次模型請求或單個工具調用本身持續很久時，插件不會強行中斷它。
- 模型依賴：彙報內容由當前模型生成；極少數不遵循指令的模型可能延遲，插件會在下一次完整靜默間隔後再次提醒。
- 隱私與權限：插件只讀取代理生命週期事件，並注入模型可見的進度檢查點。不進行網絡請求、雲端服務調用或保存會話。
結尾¶
對於需要長時間運行的任務，這個插件能提供比單純工具調用日誌更清晰的進度反饋。安裝後記得根據實際需求調整 intervalSeconds。
- 插件目錄：https://www.skillhub.cn/plugins/baiyuscc13724-max/dsh-progress-reporter
- 源碼倉庫：https://github.com/baiyuscc13724-max/dsh-progress-reporter
