前言¶
在 DeepSeek Harness（DSH）的工作流中，Agent 團隊通常用於擴展執行能力：分配不同角色、拆分子任務、合併產出。這種模式適合處理重複性強或需要並行執行的任務。
dsh-consult 解決的是另一類問題：決策質量。它不負責執行任務，而是爲需要審慎判斷的決策提供“第二意見”。當任務完成後，主 Agent 負責調查和驗證，將收集到的證據打包，然後向一組獨立的模型發起諮詢。這些模型基於相同的證據回答同一個問題，主 Agent 再對比並綜合它們的匿名意見，最終做出決策。
功能與定位¶
該插件是一個獨立的 DeepSeek Harness 插件，由 DK-Zhu 維護，遵循 MIT 許可證。它的核心作用是在決策邊界引入多模型視角，用於審查架構選型、安全邊界、發佈就緒性等高槓杆問題。
主要能力包括：
* 證據優先：僅當證據準備就緒時觸發諮詢，不會在執行過程中產生自動的模型調用消耗。
* 並行獨立審查：配置的模型（顧問）並行工作，彼此之間無法對話、辯論或查看對方觀點。
* 匿名綜合：主模型只看到穩定的標籤（如“顧問 A”），看不到具體的模型提供商名稱，確保判斷基於內容而非品牌。
* 權限隔離：諮詢過程中，顧問模型沒有工具訪問權限，也沒有工作區或歷史記錄訪問權限。
安裝與配置¶
使用前需滿足以下環境要求：
* Node.js >= 22.19.0
* DeepSeek Harness 0.1.5-rc.2
1. 安裝插件¶
通過 DSH 插件管理器安裝：
dsh plugin --profile web add dsh-consult
2. 配置諮詢面板¶
安裝後插件處於休眠狀態。需要在對應的 Profile 配置文件中啓用諮詢功能。例如，在 ~/.dsh/profiles/web/cordis.patch.yml 中添加以下內容（具體路徑取決於 DSH_HOME 環境變量）：
- id: consult
config:
consultants:
- provider: "<provider-id-a>"
model: "<model-id-a>"
- provider: "<provider-id-b>"
model: "<model-id-b>"
配置項說明：
* provider：模型服務的標識符。
* model：該服務下具體的模型標識符。
* 可以配置 2 到 5 個模型作爲顧問。相同的 provider 可以選擇不同的 model。
* 驗證配置並啓動 DSH：
dsh --profile web --dump-config
dsh web
使用方法¶
諮詢通過 /consult 命令觸發。主 Agent 在完成實施和測試後，準備證據，然後向面板提問。
典型調用示例¶
/consult Finish the implementation and tests, then ask the panel whether this is ready to ship.
/consult Review the cache invalidation redesign. Inspect the implementation and tests first, then decide whether it is ready to ship.
執行流程¶
- 用戶發起
/consult命令。 - 主 Agent 調查、實現並驗證，準備一份證據包。
- 證據包被髮送給所有配置的顧問模型。
- 顧問模型並行生成獨立意見。
- 主 Agent 彙總這些匿名意見，輸出最終建議。
適用場景與注意事項¶
適用場景¶
該插件最適合用於決策邊界，特別是當存在不確定性或高槓杆影響時：
* 在多個合理的架構方案中做選擇。
* 審查安全、隱私或數據保留邊界。
* 檢查發佈前的就緒狀態。
* 評估遷移或回滾計劃。
* 平衡性能、可維護性、兼容性和用戶體驗。
注意事項¶
- 手動觸發：諮詢是顯式的，不會在執行過程中自動觸發，這避免了不必要的 Token 消耗。
- 數據隱私：完整的證據包會被髮送給所有配置的顧問，並持久化到 DSH 的會話事件日誌中。在請求諮詢前，需確認該材料適合發送給外部提供商，也適合本地持久化。
- 成本控制：模型調用僅發生在諮詢時刻，且由用戶顯式控制面板大小，沒有後臺自動消耗。
總結¶
dsh-consult 將模型多樣性保留在決策時刻，而非執行過程中。它通過提供一種受控的、證據優先的審查機制，幫助開發者對關鍵決策進行驗證。
