前言¶
DeepSeek Harness(DSH)採用插件化架構,開發者可以根據需要擴展能力。在構建複雜智能體時,如何讓模型在運行過程中進行自我審查、驗證路徑的合理性,同時保持對主流程的控制,是一個常見需求。dsh-deliberation 插件提供了這種機制。
這是什麼¶
dsh-deliberation 是一個爲 DeepSeek Harness 設計的插件,由 fly1989 維護。它主要解決智能體在推理過程中的自我審查與路徑驗證問題,允許主控流程發起推演或請求遮蔽審查,而不需要主控模型決定是否信任。
核心功能¶
該插件提供以下核心能力:
- Primary-controlled deliberation(主控推演):由主控流程主動調用工具進行推演,而非由模型隨機決定。
- Opt-in reasoning-masked review(推理遮蔽審查):通過遮蔽推理過程,僅查看行動結果,進行審計。
- deliberate tool:運行受限的替代、審計或遮蔽審查子進程。
- automatic masked review:可選的自動遮蔽審查功能。
安裝與啓用¶
安裝該插件需要滿足 Node.js 環境(22.19+ 或 24+)和 pnpm。DSH 的插件安裝命令會自動轉發到 pnpm。安裝命令如下:
npx @deepseek-ai/dsh plugin --profile web add dsh-deliberation@0.1.0
安裝或更新插件後,必須重啓正在運行的 Web 進程才能生效。
典型用法¶
手動調用推演
模型仍需決定是否調用 deliberate 工具。測試時可使用以下提示詞引導:
1. 先使用只讀工具收集具體觀察。
2. 調用 deliberate,並在最近完成的步驟上開啓一個軌跡審計分支和一個遮蔽審查分支。
3. 子進程返回緊湊的 JSON 包,主控根據結果決定下一步。
啓用自動遮蔽審查
默認情況下自動審查是關閉的。通過應用配置補丁可以啓用。示例配置(參考 examples/auto-review.patch.yml)如下:
autoReview:
enabled: true
scope: tool-bearing-turns
provider: mid-fork-current-turn
適用場景與注意¶
角色定義
插件定義了三種推演角色:
* independent-alternative:尋找不同的機制或策略。
* trajectory-audit:驗證當前軌跡,定位最早的可疑決策。
* masked-review:在不查看推理過程的情況下重讀可觀察的行動和結果。
注意事項
* 狀態:目前處於實驗預覽階段。配對基準數據尚未確立正確性或成本優勢,因此自動審查默認禁用。
* 權限:子進程從不投票、不選擇獲勝者或替換主控。
* 確定性:確定性是子進程的自我報告,並非事實驗證。
* 配置機制:DSH 補丁行會替換目標行的整個配置,不進行深層合併。
短結尾¶
dsh-deliberation 爲 DSH 提供了可控的推演和審查能力,適合需要在運行時進行安全檢查或路徑驗證的開發者。更多細節請參考插件目錄或GitHub 倉庫。