前言¶
DeepSeek Harness（DSH）採用“一切皆插件”的架構。在開發智能體或調試工作流時，開發者通常需要查看會話的執行路徑、耗時統計以及模型調用成本。dsh-watcher 作爲一個只讀插件，旨在解決這些問題，提供會話洞察和本地模型使用統計。
插件簡介¶
插件名稱：aa2246740/dsh-watcher
一句話定位：Read-only Agent work-path observer for DeepSeek Harness（DeepSeek Harness 的只讀 Agent 工作路徑觀察者）
維護者：aa2246740
許可證：MIT
核心功能¶
該插件提供以下核心能力：
- 只讀會話洞察與統計：讀取 DSH 會話洞察和本地模型使用統計，不往對話裏塞消息，也不編隱藏思維鏈。
- 可摺疊工作路徑觀察者：將工作路徑收成一張能摺疊的視圖，展示輪次、步驟和持續時間。
- 可視化並行分支與工具結果：可視化並行分支和工具結果，支持在步驟中展開查看。
- 會話聚合與分組：支持會話聚合和分組，例如將兩次修改
package.json的操作歸類。 - 成本估算：基於
pricing/models.yaml計算成本估算，默認包含 DeepSeek、MiniMax、OpenAI、Anthropic、Gemini、Grok、GLM、Qwen 等主流模型，不聯網。 - Web 平臺支持：支持 Web 平臺，但依賴 DeepSeek Harness 的 Web Host。
安裝與啓用¶
插件依賴 DeepSeek Harness 0.1.7-rc.1 或 0.1.7-rc.2（@deepseek-ai/dsh-* 的 peer 範圍爲 >=0.1.7-rc.1 <0.1.8），以及 Node.js ^22.19.0 或 >=24。
桌面 App（推薦）¶
- 打開 DeepSeek Harness 桌面應用。
- 進入 設置 → 插件 → 添加插件。
- 在“包名或地址”中輸入以下地址：
github:aa2246740/dsh-watcher#v0.6.1
- 桌面端插件管理器會負責 Desktop profile 和內置包管理器。安裝後按提示刷新或重新打開應用。
Web CLI¶
若通過命令行安裝，需指定 web profile：
dsh plugin --profile web add github:aa2246740/dsh-watcher#v0.6.1
安裝後，需要重新打開該 Web Host 並刷新網頁。官方 CLI 只管理 web profile，不能修改 Desktop App 的 profile。
典型用法¶
安裝完成後，可以在會話界面使用以下功能：
- 查看工作路徑：點擊會話標題欄裏的“眼睛”圖標，將 Session 收成一張能摺疊的工作路徑，查看這輪走了幾步、跑了幾次、花了多久。
- 切換視圖模式：在視圖之間切換，支持從逐項切到歸類模式。例如，兩次修改
package.json的操作會被歸類爲 ×2。 - 展開細節：點擊具體的步驟，展開查看並行分支、工具結果，或默認折着的推理記錄。
- 查看成本：設置頁和會話 HUD 的 Token 總數旁會顯示估算費用。這是基於
pricing/models.yaml按模型輸入/輸出/緩存桶計價，部分已知時只顯示已標價金額。這是估算，不是賬單。
注意事項與適用場景¶
- 權限限制：插件以當前 DSH 進程的權限運行。
- 不替代官方組件：它不替代官方 Trajectory，僅作爲輔助的只讀觀察工具。
- 數據來源：默認表含 DeepSeek、MiniMax 等主流模型，不聯網；缺行顯示未知，不會當成 $0。
- 隱私與安全：插件爲 MIT 許可證開源，建議在安裝前檢查源碼與許可證。
- 適用人羣：適合需要頻繁調試工作流、分析 Agent 執行路徑或監控模型調用成本的 DSH 開發者。
結語¶
dsh-watcher 通過提供摺疊式的工作路徑觀察和成本估算功能，幫助開發者更清晰地理解 Agent 的執行過程。它不侵入對話流，專注於數據展示與統計。
