前言¶
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 代理场景。安装前请检查源码与许可证。
