dsh-auto-review：爲 DeepSeek Harness 添加 Guardian 自動審批

前言¶

DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在構建智能體應用時，對 Shell、網絡、MCP、沙箱升級等操作的審批是安全控制的關鍵環節。dsh-auto-review 插件通過引入 Guardian 模型審查機制，爲 DSH 增加了自動化的權限預設，解決了部分場景下需要人工頻繁介入的問題。

插件定位¶

這是一個插件層實現，不修改 DSH 內核。它爲 DSH 增加了一個名爲 auto-review 的權限預設，允許 Guardian 模型對特定的安全風險進行自動化判斷。

維護者：Xinlong-Wu
許可證：MIT
分類：admin-security

核心功能¶

該插件主要實現以下能力：

自動審批預設：在 DSH 的權限配置中新增 auto-review 預設。
工作區只讀放行：在可證明的工作區中，對只讀操作直接放行，無需 Guardian 審查。
Guardian 模型審查：Guardian 模型會審查 Shell、網絡、MCP、沙箱升級以及其他擴展的審批請求。
審計日誌：任何批准操作都會生成審計記錄，並調用 fsync 確保數據落盤。
UI 優化：Guardian 卡片顯示限制在 240 字符，並自動脫敏憑證和 URL。
人工覆蓋：支持通過 DSH 原生面板進行手動覆蓋審批。

安裝與啓用¶

安裝前請確保本地環境已安裝 Node.js（要求 ^22.19.0 || >=24）。

執行以下命令完成安裝與配置：

cd dsh-auto-review
pnpm install
pnpm build
dsh plugin --profile web add "$PWD"
dsh --profile web --dump-config

卸載：

dsh plugin --profile web remove dsh-auto-review-plugin

依賴構建腳本處理（僅當使用 pnpm 11 且遇到 ERR_PNPM_IGNORED_BUILDS 錯誤時需要）：

pnpm approve-builds @deepseek-ai/dsh-subprocess-local koffi
pnpm rebuild @deepseek-ai/dsh-subprocess-local koffi

配置與使用¶

插件安裝後，需在 Web 界面進行配置。

界面配置：進入 設置 → 插件 → Auto Review。展開設置卡片，配置審查模型、審查範圍、證據預算、人工審批及審計選項。
環境變量：也可以通過環境變量進行配置。例如：

    export DSH_AUTO_REVIEW_PROVIDER=deepseek
    export DSH_AUTO_REVIEW_MODEL=deepseek-chat
    export DSH_AUTO_REVIEW_MANUAL_OVERRIDE=denied-and-unavailable
    export DSH_AUTO_REVIEW_AUDIT_DETAIL=summary

*注意：Provider 與 Model 必須同時設置或同時留空。*

審查流程：
- 明確且安全的目標會直接放行。
- 其他目標進入 Guardian Review，卡片顯示狀態。
- Guardian 拒絕或不可用時，DSH 顯示原生單次審批面板。

適用場景與注意事項¶

權限限制：所有批准均爲 allowed-once（允許一次），不會建立永久授權。
安全兜底：critical 風險永不自動批准；high 風險需要用戶明確授權。
Fail Closed：對於不明確的調用、工具不匹配或無法還原精確動作的情況，插件會採取 Fail Closed 策略。
配置衝突：Cordis patch 會替換 permission.config.presets 整張表。如果你在 DSH 中已有自定義 preset，請在後續 Profile patch 中重新聲明，並使用 --dump-config 檢查組合結果。
運行時名稱：npm 包名爲 dsh-auto-review-plugin，但運行時模塊名稱爲 dsh-auto-review。

結語¶

dsh-auto-review 爲 DSH 提供了一套基於 Guardian 模型的自動化安全審查方案，適合希望在保持安全性的同時提升審批效率的開發者。