前言¶
DeepSeek Harness (DSH) 的核心是工作流編排，智能體在執行過程中會調用工具。如果缺乏干預，智能體可能執行破壞性操作或偏離用戶意圖。dsh-advisor 旨在解決這一問題，它引入了一個獨立的審查模型，在智能體的每一步操作後進行審計，並在必要時注入指導信息，幫助智能體自我糾正。
插件簡介¶
slhssb/dsh-advisor 是一個爲 DeepSeek Harness 設計的獨立模型諮詢審查插件。
- 維護者：
slhssb - 定位：工作流插件
- 解決的問題：在智能體執行工具步驟後，通過獨立的審查模型介入，檢測破壞性操作、邏輯錯誤或偏離指令的情況，並將反饋注入到下一步的模型調用中。
核心功能¶
該插件提供以下核心能力：
- 獨立模型審查：在每一步工具執行後，由一個獨立的模型（Reviewer Model）審查最新的操作記錄。
- 注入指導：當審查模型發現真實關切（如破壞性刪除、邏輯錯誤）時，會生成
[advisor]指導消息，插入到下一次模型調用的消息流中。 - 零成本規則檢查：通過
rules配置項，使用正則表達式進行確定性檢查。這些規則不消耗 Token，且永遠不會失敗，適合用於攔截特定模式的命令。 - 標準注入通道：使用 DSH 的標準
agent/pre-step瀑布注入通道，與dsh-agent-instructions和dsh-compaction-basic使用相同的機制。
安裝與啓用¶
安裝插件需要執行以下步驟：
1、安裝插件
dsh plugin add @slhssb/dsh-advisor
2、依賴處理
安裝完成後，進入你的 DSH Profile 目錄（通常是項目根目錄），執行包管理器安裝依賴並重啓 DSH：
npm install # 或 pnpm install
配置與典型用法¶
插件默認配置目標爲 DeepSeek 官方 API，使用較便宜的 deepseek-v4-flash 模型。API 密鑰由 deepseek-official 適配器處理，無需在此插件中配置。
若需自定義審查模型或提供者，可在 Profile 的 cordis.patch.yml 中覆蓋配置（配置行以最後寫入爲準）。
基礎配置示例¶
- id: advisor
config:
provider: deepseek-official
model: deepseek-v4-flash
maxTokens: 512
maxHistoryMessages: 40
interval: 1
timeoutMs: 30000
provider：審查模型的提供商路由，默認爲deepseek-official。model：審查模型名稱，默認爲deepseek-v4-flash。interval：每隔 N 個包含工具結果的步驟執行一次審查，1表示每步都審查。timeoutMs：單次審查的超時時間。
禁用插件¶
若需完全禁用，可在配置行添加 disabled: true。
規則配置（確定性檢查）¶
除了 LLM 審查，可以通過 rules 定義正則表達式規則。這些規則匹配工具名稱和原始參數 JSON，不消耗 Token，也不會導致審查失敗。
- id: advisor
config:
provider: deepseek-official
rules:
- id: no-recursive-delete
pattern: 'Remove-Item|rm\s+(-rf|-r\s*-f)|del\s+/[sq]'
message: '檢測到破壞性刪除命令，請確認目標路徑與用戶授權。'
action: warn # 或 block
tools: ['pwsh', 'bash'] # 可選：僅針對特定工具生效
enabled: true
action：設置爲warn時，注入提示信息；設置爲block時，拒絕該步驟執行（此時不進行 LLM 審查）。
注意事項¶
- 權限與安全性：插件以當前 DSH 進程的權限運行。安裝前請務必檢查源碼與許可證（MIT）。
- API 密鑰：此插件不處理 API 密鑰，密鑰由
deepseek-official適配器從環境變量或憑證存儲中解析。 - 審查失敗處理：審查過程如果發生錯誤（如超時、空輸出），插件會記錄警告但不會中斷智能體的主流程，只會跳過該步驟的審查。
- 遞歸限制：注入的消息是普通的用戶消息，不會觸發
tool/result事件，因此不會導致審查流程遞歸執行。
結語¶
dsh-advisor 爲 DeepSeek Harness 的工作流提供了低成本、高可配置的審計層。通過 LLM 審查與確定性規則相結合，可以在不改變智能體核心架構的前提下，顯著提升操作的安全性。
