AskTheWay/dsh-jev-interceptor

dsh-jev-interceptor

License: MIT
[Node >= 20.3]()
dsh plugin
Jev

⚡ 每个工具调用、每条被召回的消息，毫秒级裁决——单次成本约百万分之二美元。

你的 agent 最烧钱的坏习惯：拿会写诗的 LLM 回答是非题，以及按年龄截肢你的上下文。本插件把 Jev——那个九月刷屏全网的非生成式"System One"模型——接进 DeepSeek Harness 里 LLM 大材小用、规则又全盲的判断点。

一口气说完它做什么： 工具调用执行前，Jev 用一次约 $0.00002 的请求完成风险、可逆性、任务匹配度、注入嫌疑四重分类——高置信高危直接拒绝，中风险升级人工，明确授权且可逆的不再浪费你点审批弹窗。而当 @ 引用旧会话注入快照时，Jev 逐消息给它对当前任务的价值打分——让错误堆栈活过字节预算，而不是最旧的那句寒暄。任何存疑、超时、没 key，都降级回 dsh 原生行为。不需要配置任何"退路"，也绝无放宽权限的可能。

为什么值得做

dsh 出厂没有任何逐调用风险分类——pre-execute 瀑布的兜底就是裸 allow。唯一的内置先例 experimental/auto-review 用生成式 LLM 干这活：每次工具调用一个完整模型请求、temperature 0、手写 JSON 文本协议，官方自认慢、贵、实验性。这是让 System-2 抄写员去干 System-1 反射的活：

| | auto-review（生成式 LLM） | dsh-jev-interceptor（Jev） |
|---|---|---|
| 决策形态 | 逐 token 生成 JSON 再解析，全靠祈祷 | 类型化 choice/noul 答案——类型错误结构性不可能 |
| 单次成本 | 一次完整 LLM 请求 | 约 $0.00002（实测：501 输入 token） |
| 延迟 | 秒级 | provider 侧约 100ms（TypeSafe 报告的 p50）；美西之外端到端约 1s |
| 不确定性 | 藏在散文里 | 每问带概率分布 + 校准置信度 |
| 失败路径 | 解析兜底 → deny | 低置信 → next()——绝不硬拍 |

TypeSafe 官方宣称 Jev 在分类工作负载上比 LLM 快最高 200 倍、便宜最高 400 倍——本插件就是把这个数字落进真实 agent harness，收据在 /jev-stats 里。

我们相信这是 dsh 生态第一个 System-1 决策插件。决策模型在 dsh 中的完整地图——本插件的两个挂点 + 另外十一个已核实挂点（语义模型路由、上下文保留打分、图像卸载预规划、工人报告核验……）——见 docs/jev-usage-points.zh.md。

没人谈论的 FIFO 痛点

在 dsh 里 @ 引用一个旧会话时，harness 注入它的一份有界快照——当快照超出字节预算，就从最旧开始丢。纯 FIFO，零语义。你贴在会话开头的报错信息、开启整件事的三行提问？最先被丢。"谢谢！"和"好，继续"？留下了——因为更新。

dsh 官方的保留算法对此很坦诚：丢最旧的、再截最长的，完事。本插件的 jev-session-reference 行接管这个决策（子类化官方 resolver，@ 补全、预算、溢出存储、取消全部原样继承）：一次 Jev fan-out 给每条可丢弃消息打分——噪音 / 背景 / 相关 / 关键——丢弃顺序变成最没价值的先走，截断时先砍废话再砍实质。checkpoint 和最新一条的保护与官方完全一致，字节预算的守恒与官方完全一致；sessionReferenceEnabled: false（默认）时这一行的渲染与原版逐字节相同。

shadow 模式先给你收据再谈信任：每次注入都记录反事实对照——FIFO 丢掉了哪些评分本会保住的消息——看清了再切 enforce。

60 秒上手

dsh plugin --profile  add dsh-jev-interceptor

在 profile 的 cordis.patch.yml 里
- id: jev-interceptor
name: dsh-jev-interceptor
config:
enabled: true
mode: shadow            # 先观察模式：记录每个决策，不执行任何干预
provider: typesafe      # 或 'openrouter'（今天就能用，无需候补）| 'custom'

正常使用你的 agent。shadow 模式下每个决策（含完整概率分布）都落入遥测；/jev-stats 汇总：

[guard] calls: 41  degraded: 0  cached: 9
actions: delegate=33 ask=6 deny=2
input tokens: 18234  est. cost: $0.000766
latency: p50 247ms  p95 512ms  max 611ms

数字满意？把 mode 改成 enforce。这就是全部的上线方案——先观察，再信任，绝不硬拍。

安全模型（真正值得细读的部分）

- 永不返回 allow。 "无异议"用 next() 表达，链上后续 listener（外部 hook、auto-review）的否决权完好无损。
- 处处 fail-closed。 无 key / provider 冷却 / 超时 / 解析不匹配 / 内部错误 → 委托回原生行为。审批服务的 never 策略在任何 listener 之前执行，本插件在结构上就无法放宽它。
- 证据门控的自动批准。 allowed-once 必须有参数证据：只有 guard 升级过的调用（新鲜条目、会话与工具都匹配）才可能被自动批；hook 请求与沙箱提级不携带参数，一律转人工。
- 注入感知。 工具参数只进 Jev state 数据字段；instructions 是固定文案；疑似注入的答案触发升级而非压制。（Jev 官方承认可被对抗内容影响——所以本插件的拦截是加速器，永远不是最后防线。）
- 输入限界。 参数头尾预览 + 尾部消息摘要——Jev 官方指引就是"代码先过滤，只发问题需要的字段"。
- 构造级韧性。 每次尝试墙钟超时、429/529 单次重试、连续失败进冷却（超时也计数）、并发上限、LRU 决策缓存、排队有界的信号量。provider 挂掉的代价是零行为差异，不是你的 harness。
- 接管行按层禁用。 jev-session-reference 行替换了上游 session-reference 行；在 Plugins 页单独关掉这一行会落得没有任何 session-reference 在运行。移除接管请禁用整个 dsh-jev-interceptor bundle 层（setBundleEnabled(false)），上游行随之恢复。
- 可观测。 每个决策落入 /plugins/dsh-jev-interceptor/telemetry.jsonl（遵循 $DSH_HOME）；/jev-stats 按挂点汇总。

以上全部由 63 个测试锁定，包括对抗评审的回归用例（曾可能挂死工具管线的并发泄漏、跨会话 callId 碰撞、无证据自动批准）。

配置

一切皆配置项——超时、冷却、并发、缓存、各挂点阈值、工具名单——见 src/config.ts 的 Config schema。值得注意的默认值：

- 只读工具（read、read_image、grep、glob、todo_write）零成本直通；
- Auto 权限预设完全让位给 auto-review（不双重审查、不双重计费）；
- 预批白名单默认为空——在 preapproveToolAllowlist 里点名工具之前，任何调用都不会被自动批准。

语义会话保留是独立的一行（默认关闭且逐字节等同原版）：

- id: jev-session-reference
config:
sessionReferenceEnabled: true   # false（默认）= 纯透传
mode: shadow                    # 记录"会怎么保"，实际渲染仍走官方 FIFO
provider: openrouter
apiKeyEnv: OPENROUTER_API_KEY

OpenRouter 今天就能用、无需候补（decisions 模型在那里走专用端点）：

provider: openrouter
apiKeyEnv: OPENROUTER_API_KEY

客户端直说 state + questions 线协议，TypeSafe 直连、OpenRouter 与 Apache-2.0 本地平替 Laya 完全同构——provider 可随时切换，闭源供应商永远成不了锁定。

开发

npm install --legacy-peer-deps   # devDeps 钉在当前一代 dsh API
npm run typecheck                # src + tests，对真实 @deepseek-ai 类型
npm test                         # vitest，63 个测试，无需网络
npm run build                    # tsc -> lib/
node scripts/smoke.mjs           # 对真实 provider 跑一次决策

路线图

审批闭环（v0.1）与语义会话保留（v0.2）已落地。已核实的下一战场——让"选择"而不只是"安全"用上 System-1（完整目录）：

- 图像卸载预规划——dsh 自己的 README 承认"nothing plans an offload before dispatch"；Jev 来规划
- 内容感知模型路由——例行步骤走便宜档，硬仗上强模型
- 工人报告核验——子代理说"做完了"，得有东西查一查

许可证

MIT