DeepSeek Harness 在多輪對話中，進度往往依賴於 Agent 的主觀描述，缺乏客觀依據。dsh-rich-tracking 插件引入了一個停靠在對話底部的看板，將進度轉化爲基於工件事實的百分比，並提供了一套完整的檢查點與指令注入機制。
插件定位¶
這是一個由 svgop 維護的客戶端插件。它提供百分比進度記分板、基於證據的行記錄、宿主抓取的 Git 檢查點，以及 pursue/align/dismiss 等操作指令。
核心能力¶
- 百分比記分板：展示每行的實時進度，不依賴主觀描述。
- 證據綁定：百分比必須基於工件事實，嚴禁“幻覺”。百分比 >= 1 的行必須攜帶
evidence（證據）。100% 進度要求所有項目已勾選且擁有收據。 - Git 檢查點：通過
tracking_checkpoint工具，宿主可自動捕獲當前分支、HEAD 和髒狀態，並凍結看板。 - 操作指令注入：Pursue/Align/Dismiss 等操作會直接轉化爲 Agent 的下一步指令，接管執行流程。
- 行記錄對話框：點擊
?可查看完整詳情、證據來源和 Markdown 格式的記錄。 - 調研與自動執行：Scout 支持爲每行任務啓動子代理進行競品研究；Play 模式可自動執行高價值待辦。
- 強制同步：
/track命令可強制向 Agent 注入當前賬本狀態。
安裝與啓用¶
dsh plugin --profile web add dsh-rich-tracking
安裝後必須重啓 dsh web 進程，tracking_write 和 tracking_checkpoint 工具纔會對所有預設生效，看板也會渲染在對話 dock 中（順序 5，位於 todo pill 下方）。
典型用法¶
- 查看進度：重啓後，看板會顯示在 todo pill 下方。行數限制在 1-12（建議 3-7）。
- 查看詳情：點擊行左側的
?按鈕，打開包含狀態、證據、詳情和來源的記錄對話框。 - 競品調研：點擊
Scout按鈕，系統會爲每行任務啓動子代理，研究 3-6 個競品或實現方案，並將結果寫回detail和sources。 - 強制同步：在對話中輸入
/track（或/track <message>），向 Agent 注入完整的賬本和修正指令。 - 自動執行：開啓
Play模式，系統會在每輪結束時自動優先處理價值最高的待辦行。 - 手動寫入：在任務/步驟完成後，調用
tracking_write更新狀態。
注意事項¶
- 系統要求：DeepSeek Harness 版本需 >=0.1.2-alpha.1。
- 證據規則：看板不會在
turn/start時重置，直到所有行達到 100% 或被手動清除。 - Scout 依賴：Scout 功能需要持久化的研究摘要文件，位於
.docs/digest/或.docs/research/。 - 註冊機制：宿主必須在
ctx.sessionEventTypes中註冊tracking/write、tracking/checkpoint和tracking/decision。
dsh-rich-tracking 通過強制基於工件事實計算百分比，解決了進度不透明和缺乏可驗證性的問題。配合 Git 檢查點和操作指令，它讓多輪任務管理變得可追蹤、可審計。
