前言¶
DeepSeek Harness（DSH）的默認行爲是零風險分類，工具調用前的預執行流程默認爲 allow。現有的 experimental/auto-review 方案依賴生成式 LLM 進行分類，存在成本高、延遲大且存在解析不確定性等問題。
dsh-jev-interceptor 插件將 Jev（非生成式 System-1 模型）接入 DSH 的決策點，提供毫秒級、低成本的風險評估。它通過 Jev 對工具調用進行風險、不可逆性、任務匹配度和注入嫌疑的判斷，實現證據門控的自動批准，並將決策權通過 next() 保留給下游監聽器。
核心功能¶
該插件提供以下核心能力：
- Jev 風險分類：在工具調用前，對風險等級、不可逆性、任務匹配度和注入嫌疑進行分類。
- 證據門控自動批准：基於捕獲的參數證據，對特定工具調用進行自動批准。
- 會話引用接管：接管會話引用邏輯，按消息價值而非 FIFO（先進先出）順序對消息進行評分，優先保留關鍵信息。
- 影子與強制模式：支持在影子模式下觀察決策，驗證無誤後切換至強制模式。
- 失敗關閉：當發生超時、解析不匹配或內部錯誤時，自動委託給 DSH 的默認行爲，確保安全。
安裝¶
通過命令行安裝插件。該命令會自動生成對應的配置補丁文件。
dsh plugin --profile <name> add dsh-jev-interceptor
安裝後，需要在配置文件中啓用並指定模式。配置通常位於 <dsh-home>/plugins/dsh-jev-interceptor/cordis.patch.yml。
- id: jev-interceptor
name: dsh-jev-interceptor
config:
enabled: true
mode: shadow # 先啓用影子模式：記錄決策但不強制執行
provider: typesafe # 指定 Jev 提供商，支持 typesafe 或 openrouter
使用方式¶
安裝完成後，無需重啓或額外配置，通過聊天命令控制插件行爲。這些命令會持久化到配置文件中。
- 啓用插件：
/jev-on
- 查看統計信息：
/jev-stats
該命令會顯示調用次數、降級次數、緩存命中數、動作分佈（委託/詢問/拒絕）以及預估成本和延遲。
- 切換模式：
在影子模式下觀察統計信息無誤後，執行以下命令將模式切換爲強制執行：
/jev-mode enforce
- 禁用插件：
/jev-off
機制與安全¶
決策邏輯¶
插件不會直接返回 allow。所有“無異議”的表達均通過 next() 實現，確保下游監聽器（包括外部鉤子和自動審查）保留否決權。
失敗關閉¶
系統設計爲“失敗關閉”。任何配置錯誤、提供者超時、解析不匹配或內部錯誤，都會觸發默認行爲，不會嘗試猜測或放寬權限。
證據門控¶
自動批准功能依賴於捕獲的參數證據。只有那些被升級爲人工審查的調用（帶有新的掛起條目、匹配的會話和工具）才能被自動批准。鉤子詢問和沙盒升級調用不帶參數，因此始終需要人工介入。
接管行行爲¶
jev-session-reference 行會取代上游的 session-reference 行。如果僅通過插件 UI 禁用該行，會導致整個會話引用功能失效。必須通過禁用整個 dsh-jev-interceptor 層級（setBundleEnabled(false)）來移除接管。
適用場景¶
本插件適合需要嚴格控制工具調用風險、希望降低審批成本並提升響應速度的 DSH 代理場景。安裝前請檢查源碼與許可證。
