DeepSeek Harness（DSH）採用插件生態。單個 Harness 具有單一視角。在做出關鍵決策、在宣佈風險工作完成前，或在進行顯著的新代碼編寫前，第二模型能提供有用的獨立證據。該插件將諮詢轉變爲有界工具調用，而非複製粘貼的變通方法。Claude 在行爲和輸出合同下回答，DSH 將結果作爲供權衡而非服從的建議接收。
核心功能¶
該插件提供了一套圍繞外部專家諮詢的工具集：
- Role contracts（角色合約）：內置 advisor（顧問）、reviewer（審查員）、designer（設計師）與自定義角色，具有不同的目標和 JSON 合同。可配置
outputKind、prompt、model、fallback和effort。enabled標記可將角色掛起而不刪除。 - Thinking effort（思考投入）：原生
--effort（low / medium / high / xhigh / max），優先級爲：per-call argument > role > global default。 - Model fallback（模型回退）：模型級別錯誤（如
unrecognized_model、model-not-found）的一跳重試，usedFallback記錄在運行元數據中。 - Agent tools（代理工具）：
consult_expert：單一角色、單一問題，可選結構化brief。consult_panel：在brief上並行調用多個不同角色，非多數票。consult_roles：實時角色列表，包括outputKind、角色級別 model/effort 和全局默認值。
- Auto consult（自動諮詢）：
- Composer-seat toggle：權限控制行的 Expert Consult 開關，勾選的角色在會話中加入選擇條件和生命週期提醒。
- Policy section：模型請求名稱勾選的角色及其選擇條件，模式爲
off | remind | hard-remind（默認remind）。 - Lifecycle nudges：在文件寫入前或任務完成前觸發提醒。
- Budget：
capPerRole（默認 3），限制每角色每會話的真實consult_*調用數。
- Settings workspace（設置工作區）：每個 Harness CLI 一個標籤頁；熱應用支持，角色編輯可直接作用於下一次模型步驟，無需重啓。
- Connectivity test（連通性測試）：真實的端到端諮詢測試（CLI + 登錄 + 代理），包含輪次、持續時間、成本和回退標記。
- Defense in depth（縱深防禦）：對工作區只讀的 CLI 工具；嚴格 MCP 隔離；權限鎖定；有界輸出/輪次/時間；明確標記不受信任的證據。
- Fully bilingual UI（雙語界面）：完全支持中文/英文，包括內置角色描述、後端說明和驗證消息。
安裝¶
通過官方命令行安裝插件：
dsh plugin --profile web add dsh-capability-optimizer
安裝後，重啓 dsh web 或您選擇的 profile。
前置要求：
* claude CLI（npm i -g @anthropic-ai/claude-code）必須在 PATH 中。
* 需已登錄 Claude 賬戶。
典型用法¶
在對話中直接調用代理工具。例如：
“consult the reviewer on this diff before we call it done”
Agent 會自動選擇角色並調用 consult_expert。
對於結構化任務，可以發送 Structured brief：
objective（目標）successCriteria（成功標準）constraints（約束）currentAttempt（當前嘗試）artifacts（產物）verification（驗證方式）unknowns（未知項）
Claude 返回的回覆包含模型、輪次、持續時間、成本和協議元數據。
| 工具 | 工作區讀寫 | 用途 |
|---|---|---|
consult_expert |
read* | 單一角色、單一問題，可選 brief 或 context |
consult_panel |
read* | 多個角色並行諮詢 |
consult_roles |
read | 實時角色列表及配置 |
* 對工作區爲只讀；每次調用消耗 Claude 訂閱配額。
適用場景與注意¶
適用場景：在關鍵決策點、代碼審查、設計階段需要第二模型視角的場景。
注意事項：
* 權限隔離：Agent 工具對工作區是隻讀的，不會修改文件，但會消耗 Claude 訂閱配額。
* 指令傳遞與強制調用：Nudges 保證指令被傳遞，而非強制工具調用。模型拒絕時需在單行中說明原因。
* 狀態展示：狀態欄使用輪詢和服務器截斷預覽，並非所有主機上的 token 流式傳輸。
* 階段限制：當前階段（Phase 1）僅針對 Claude Code CLI。其他後端（codex, zcode 等）計劃後續支持。
總結¶
dsh-capability-optimizer 將外部專家諮詢集成到了 DSH 的工具鏈中，通過角色合約和結構化 brief，提供了可控的參考答案，幫助 Agent 在重要決策前進行獨立驗證。
