DeepSeek Harness(DSH)的 Web UI 提供了基礎的沙箱權限預設,但在處理複雜任務時,有時需要更靈活的中間狀態或自動化審批機制。dsh-agent-approval 插件填補了這一空白,它引入了一種新的權限模式:在保持 workspace-write 安全基線的同時,將所有提權請求交由獨立的審批代理自動裁決。
核心功能¶
該插件主要提供以下能力:
- 權限預設擴展:在
/permission菜單新增 Agent 審批 預設。選中該預設即開啓,切到其他預設時自動關閉。 - 自動裁決機制:開啓後,沙箱基線固定爲
workspace-write,審批策略由插件接管爲ask。每次提權請求不再彈窗,而是由一次性spawn的子代理進行裁決。子代理擁有獨立會話、零工具權限,只能讀取上下文並進行判斷。 - 風險控制:審批代理會判斷操作是否屬於破壞性、不可逆或越界行爲。只有符合“安全、可逆、與任務相符、理由誠實”的操作纔會被批准,否則直接拒絕。
- Fail-closed 策略:爲了安全起見,如果審批代理啓動失敗、超時或返回結果不合法,一律按拒絕處理,絕不靜默放行。
- 可配置性:支持在設置頁選擇審批模型(Provider + Model)和超時時間。不選擇模型時使用 Harness 默認模型。
- 審計與記錄:會話窗口頂部會出現「審批」標籤頁,展示本會話的審批記錄(結論、風險等級、模型、耗時、理由)。記錄以獨立文件形式存儲於會話目錄。已批准的行可一鍵「加白」存爲放行規則。
- 狀態恢復:關閉插件時,會自動恢復開啓前的權限旋鈕狀態。
安裝¶
使用官方 dsh plugin 命令安裝。該插件是一個標準 DSH bundle,通過 dsh.bundle.patch 和 cordis.patch.yml 完成掛載和菜單註冊。
dsh plugin --profile web add /path/to/dsh-agent-approval
重啓 DSH 後,設置面板會出現 Agent 審批 頁,/permission 菜單會出現第四項 Agent 審批。
如果需要爲菜單項添加圖標,可在安裝後運行:
npm run patch:glyph
使用¶
- 開啓審批:在
/permission菜單中選中 Agent 審批,或直接輸入/agent-approval on。 - 查看與加白:在會話窗口頂部,點擊「審批」標籤頁查看審計記錄。對於已批准的行,可一鍵「加白」存爲放行規則。
- 配置模型:進入設置頁,配置審批模型、超時時間以及放行/拒絕規則。
- 關閉審批:切換回其他預設,或輸入
/agent-approval off,系統將恢復開啓前的沙箱模式與審批策略。
注意事項¶
- 許可證:遵循 MIT License。
- 記錄存儲:審批記錄以獨立文件形式存儲在會話存儲目錄中,刪除會話即刪除記錄。
- 權限運行:插件以當前 DSH 進程權限運行,安裝前建議檢查源碼。
更多細節與目錄鏈接:DeepSeek Harness Agent 審批權限插件