前言¶
DeepSeek Harness（DSH）的生態理念是「一切皆插件」。在使用智能體進行開發時，沙箱越界是常見場景。完全自動放行存在安全隱患，完全人工審批又效率低下。dsh-approval-gate 插件解決了這個矛盾。
是什麼¶
dsh-approval-gate 是一個自動審批門控插件，由 ventisyn 維護。它利用判定模型預判每次沙箱越界行爲：對常規操作自動放行，對硬性危險操作轉人工確認。
核心功能¶
- 模型風險預判：每次沙箱越界由判定模型判定（
SAFE或RISKY:<類別>），可回補操作自動放行。 - 硬風險永遠人工：刪除、憑據、遠程/生產、系統路徑、批量操作五類硬性規則直接轉人工，不計數、不學習。
- 確認制學習：同一操作確認 N-1 次後自動放行。沉澱規則攜帶操作指紋，只放行確認過的操作。
- 語義同類驗證：措辭變化但意圖相同的操作，由判定模型對照確認樣本語義判斷，不再依賴關鍵詞。
- 配置熱更新：修改
allowlist.json即時生效，無需重啓。 - 判定模型可釘死：設置頁下拉選擇「指定模型 / 跟隨會話默認模型 / 用部署默認值」，釘死後在會話切換模型不會改變判定模型。
- 人工審查 UI：自動放行時輸入框上方出現綠色提示；審批視圖（軌跡右側）展示當前會話完整放行時間線。
- 文件改動對比與撤銷：點擊審批記錄中的文件查看 unified diff（新增綠、刪除紅、上下文灰），可一鍵「撤銷此改動」投遞指令讓 AI 恢復文件。
- 會話級快照管理：快照按事件歸屬會話，審批視圖按當前會話統計，支持「僅清本會話」與「清空全部」。
安裝與啓用¶
執行以下命令安裝插件：
dsh plugin --profile web add dsh-approval-gate
安裝後，權限預設會自動寫入 profile 的 cordis.patch.yml（auto-approve 預設）。完成安裝後需重啓 dsh web，讓寫入的預設進入權限下拉。最後，在會話權限下拉選中「自動審批」即可啓用。
典型用法¶
- 熱更新配置：直接修改
allowlist.json，無需重啓服務即可生效。 - 審查與撤銷：在審批記錄中點擊文件，查看 unified diff；若需回滾，點擊「撤銷此改動」投遞指令讓 AI 按快照恢復文件。
- 查看審批流：在軌跡右側的「審批」視圖查看當前會話的放行與人工審批記錄。
適用場景與注意¶
該插件適合需要在 DeepSeek Harness 中實現最小人工介入、兼顧安全與效率的場景。使用前需注意：本項目是 moon09300731/dsh-approval-gate 的 fork，使用時必須保留原作者的版權聲明。插件以當前 dsh 進程權限運行，使用前應檢查源碼與許可證。
總結¶
dsh-approval-gate 通過判定模型預判和確認制學習，實現了沙箱越界的自動化與安全性平衡。它提供了熱更新、撤銷回滾和會話級快照管理等實用功能，是 DSH 開發流程中的安全輔助工具。
