前言¶
DeepSeek Harness (DSH) 採用了「一切皆插件」的理念,這使得構建安全智能體變得靈活,但也帶來了如何平衡「自動化效率」與「執行安全性」的問題。完全放開權限會導致不可控的風險,而事無鉅細的人工審批又會拖慢開發節奏。
dsh-auto-review 插件旨在解決這一矛盾。它借鑑了 Codex 的自動審查設計,在保留 DSH 原生沙盒隔離的基礎上,引入了一個獨立的審查模型。普通操作遵循 DSH 原有權限策略,而高風險操作則會被攔截並交給 Reviewer 進行風險評估,批准後繼續執行,拒絕則強制換方案或請求人工授權。
插件簡介¶
- 名稱:
jhckevin/dsh-auto-review - 維護者:jhckevin
- 許可:MIT
- 核心價值:在 DeepSeek Harness 中引入自動化的「二次審查」機制,通過獨立模型評估風險,同時利用原生沙盒保證基礎隔離。
核心功能¶
該插件主要包含以下能力:
- 自動審批審查:區分普通操作與高風險操作,自動觸發審查流程。
- Codex 風格設計:審查界面與交互邏輯參考了 Codex 風格,支持 WebUI 與 TUI 狀態提示(如盾牌圖標)。
- 原生沙盒與獨立模型:不破壞 DSH 的原生沙盒環境,審查模型獨立運行,使用 Flash 模型作爲默認選項,也支持按風險分級切換模型。
- 風險分級與熔斷:支持風險分級模型策略。當同一回合連續 3 次拒絕,或最近 50 次審查累計 10 次拒絕時,會觸發熔斷機制,強制結束當前回合,防止 Agent 在錯誤路徑上無限重試。
- 宿主版本自動兼容:自動識別併兼容 DSH 的特定版本(0.1.0-rc.6, 0.1.1-rc.2, 0.1.2-alpha.5),無需手動匹配插件版本。
安裝與配置¶
安裝過程分爲三個步驟:安裝插件本體、初始化原生執行組件、安裝界面適配。
1. 安裝插件本體¶
在已安裝兼容版本 DSH 的環境中,直接運行以下命令添加插件:
dsh plugin --profile web add @jhckevin/dsh-auto-review@next
2. 初始化原生執行組件¶
每臺機器首次安裝時,需要由管理員執行一次,初始化原生 bridge 組件。該組件與用戶目錄分離,避免被 Agent 修改。
sudo npm install --prefix /opt/dsh-auto-review-native/0.1.0-rc.2 \
--ignore-scripts --no-audit --no-fund \
@jhckevin/dsh-auto-review-bridge-linux-x64-gnu@0.1.0-rc.2
export DSH_AUTO_REVIEW_NATIVE_RUNTIME=/opt/dsh-auto-review-native/0.1.0-rc.2/node_modules/@jhckevin/dsh-auto-review-bridge-linux-x64-gnu
注:建議 Node.js 版本爲 24.20.0,支持 Linux x86_64 / glibc 2.31+。
3. 安裝界面適配¶
停止 DSH 後,運行安裝腳本以獲取 WebUI 圖標和適配:
npx --yes --package=@jhckevin/dsh-auto-review@next dsh-auto-review-ui
dsh --profile web
注:如遇網絡問題,可設置 DSH_AUTO_REVIEW_DOWNLOAD_MIRROR 環境變量使用鏡像源。
4. 配置模型與啓用¶
- 進入 設置 → 模型,配置 Provider 與 API Key。
- 進入 設置 → 自動審批審查,啓用插件並選擇 Reviewer 模型。
使用邏輯¶
插件介入後的執行流程如下:
- 普通操作:遵循 DSH 的權限與沙盒設置,無需審查即繼續執行。
- 高風險操作:操作被送交給 Reviewer。
- 批准:移除審查狀態,繼續執行。
- 拒絕:Agent 需要尋找更安全的替代方案,或停止並請求用戶授權。
- 熔斷觸發:如果審查連續失敗達到閾值(連續 3 次拒絕 或 歷史累計 10 次拒絕),當前回合會被強制結束。
注意事項¶
- 費用問題:審查會產生額外的 token 費用。每次審查都需要發送操作、上下文與策略。雖然輸入緩存命中約 50%,但緩存命中的輸入並非免費,具體成本取決於 Provider 的定價。
- 隔離依賴:不要依賴
partial enforcement來作爲完整的隔離保障。Reviewer 故障時不會自動放行,必須由用戶介入。 - 升級行爲:同名插件升級時,DSH/npm 會替換當前 profile 中的舊包,不會並排啓用多個版本。同名升級不會清理會話、配置或密鑰。
- 依賴要求:原生 bridge 的 host/platform 包是必需依賴,不是多餘版本,升級或重裝時請勿忽略。
總結¶
dsh-auto-review 是一個爲 DeepSeek Harness 提供安全增強的工具。它通過引入獨立的審查模型和熔斷機制,在不犧牲 DSH 原生沙盒優勢的前提下,降低了人工審批的頻率,提升了 Agent 運行的安全性。