前言¶
DeepSeek Harness (DSH) 的插件化架構允許按需擴展能力。TaskWatch 是一個針對 DSH 的早期預覽插件，旨在解決智能體執行過程中意圖漂移的問題。在代理自主性提高的同時，微小的修改可能演變成偏離用戶原始目標的重構，TaskWatch 通過分離用戶請求、模型推理、執行證據和監督反饋來防止這種情況。
插件定位¶
- 一句話定位：User-intent tracking and agent supervision for DeepSeek Harness (DSH) · 用戶意圖監督與受控糾偏
- 維護者：cjx12036
- 解決的核心問題：保持請求、解釋、證據和反饋分離，防止推斷靜默轉變爲新的指令。
核心功能¶
TaskWatch 維護任務的三個連接視圖：
- Intent（意圖）：原始用戶消息、顯式需求以及獨立版本化的模型推理。
- Evidence（證據）：綁定任務的公共對話和工具證據，包括可見的缺口、超時、截斷和過時結果。
- Supervision（監督）：將證據與任務意圖進行比較的評估和建議。這些內容不替換用戶話語，也不擴大授權。
側邊欄可以顯示當前目標、要求、權衡、使用情況和報告。其私有監督聊天僅更新 TaskWatch 自身的理解，不會向主代理發送消息或重寫主任務輸入。
Coach 模式：僅在獲得明確同意後可用。啓用項目 Coach 後，新任務的同意對話框會明確披露可能會自動引導主代理偏離執行。接受該對話框即授予監督同意和任務 Coach 同意。之前綁定的任務需要在啓用項目 Coach 後單獨執行“同意 Coach”操作。
安裝與配置¶
TaskWatch 從 GitHub 安裝到 DSH 配置文件中。使用標準 web 配置文件進行安裝：
dsh plugin --profile web add github:cjx12036/TaskWatch
安裝完成後，使用正常的 DSH 啓動命令重啓 web 配置文件，然後打開 TaskWatch 側邊欄。如果需要診斷安裝，可以確認包是否存在於配置中：
dsh --profile web --dump-config
使用步驟¶
- 打開 TaskWatch 並選擇 Settings。
- 選擇並保存監督提供商和模型，然後明確允許監督模型調用。僅保存這些設置並不會啓用項目或任務。
- 啓用當前項目的監督。
- 當 DSH 詢問任務決策時，爲特定任務選擇 Enable supervision（啓用監督）。如果已啓用項目 Coach，請閱讀其明確的 Coach 披露後再接受；該一次披露的決策同時也爲新任務授予了 Coach 同意。跳過任務不影響後續任務。
- 在側邊欄中查看報告。根據需要暫停或恢復對任務的觀察。
- 如果需要 Coach，請爲項目明確啓用它，並根據上述描述爲每個適用任務授予 Coach 同意。
注意事項¶
- 早期預覽：插件在 DSH
0.1.5-rc.3上進行了安裝和側邊欄 UI 流程的煙霧測試，但未驗證實時運行時生成和 Coach 行爲。 - 環境要求：需要 DSH web 客戶端和 Node.js
>=22.23.2。 - 監督範圍：僅監督通過同意流程明確綁定的任務。
- 本地存儲：默認本地存儲爲
~/.dsh/taskwatch/ledger.sqlite。通過設置DSH_HOME可更改路徑（例如DSH_HOME="$HOME/.dsh-private"）。 - 遠程訪問：不支持對 TaskWatch 端點的遠程訪問。
結語¶
TaskWatch 提供了一種機制，讓用戶能夠更清晰地看到智能體的推理過程與執行結果是否符合原始意圖。對於需要在複雜工作流中保持代理行爲可控的開發者，該插件提供了一個從“觀察”到“主動干預”的中間地帶。
