npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-jev-verify

v0.9.0

Published

Jev (TypeSafe System One decision model) for DeepSeek Harness — seven tools: jev_decision (up to 25 typed questions in one parallel call, measured median 266-484 ms), jev_choose (rank 2-10 approaches), jev_batch (one set of up to 5 judgments over 1-20 tex

Readme

dsh-jev-verify

把 TypeSafe AI 的 **Jev(System One 决策模型)**接入 DeepSeek Harness(dsh)的一等公民插件。

Jev 不生成文本:给定 state 与类型化问题,它用一次并行 API 调用返回带校准概率的类型化判定(官方宣称 ~70–500ms;我们实测中位 266–484 ms、p95 825–1468 ms(单轮峰值约 1.5 s,网络拥堵时可达约 5 s))。本插件把它封装成 Agent 工具,附加可选的自动护栏(风险/循环检测)与一个只报本机实测的使用额度面板,并且坚持「验证过的才叫有效」:

| 工具 | 作用 | 该在什么时候调用 | | --- | --- | --- | | jev_decision | 对 state 一次调用并行提出最多 25 个类型化问题(choice / score / noul),官方宣称 ~70–500 ms,我们实测中位 266–484 ms、p95 825–1468 ms。每个答案都带校准置信度与概率分布;结果同时报告模型、延迟、token 用量与估算成本。 | 你需要快速、可复现的判定而非文本:分类/打标、路由或分诊、优先级/严重度/满意度评分、垃圾/毒性/隐私数据检查、意图或真伪判断、从自由文本抽取结构化标签。相关问题务必合并到一次调用——并行执行不额外增加延迟。 | | jev_choose | 对 2–10 个候选方案/路线排名:每方案给契合度 score 0–3 与风险 noul,合成 fit/3 × (1−risk);返回有序排名表、推荐项与每方案延迟/成本。 | 岔路口上有多条彼此独立的可行路线、需要一份校准过的量化参考再做最终决策时。Jev 只给分、绝不解释——理由由你自己给出。 | | jev_batch | 对 1–20 条文本跑同一组 1–5 个判定:每条文本一次真实调用(默认 4 路并发、上限 6),直接返回可粘贴的 markdown 表格,可按某个判定维度排序;内置 sentiment / priority / intent / pii / spam 预设,也可自写 questions(与 jev_decision 同形)。 | 一批工单/评论/日志/反馈要打标、分类、排优先级、过 PII 或垃圾内容,或按同一维度给多条候选排序时——「多条文本 + 同一组判定」的首选,不要逐条手搓 jev_decision。每条文本是独立一次调用,失败行标「失败」并附原文错误,绝不猜测。 | | jev_verify | 对线上真实 API 以 6 路并发运行冻结的 27 题带标签基准(紧迫度、垃圾、毒性、隐私数据、部门路由、意图、检索类型、优先级、严重度、满意度、护栏判定;0.7.5 实测 27 次调用墙钟 4.96 s(复测 3.999 s),串行需 10.1 s):总体准确率与高置信子集准确率、中位/p95/min/max 延迟、置信校准、token、成本,以及全部误判清单(并单列其中属于高置信误判的)。 | 确认端点健康、对比模型版本、排查回归——不要例行调用:一轮就是 27 次真实 API 调用(约 8.7K input tokens、≈$0.0004)。 | | jev_guard_status | 自动护栏只读审计:确定性规则与 Jev 兜底分别计数(checks / jevCalls / denied / deterministicDenied / auditCalls)、受护栏工具名、denyThreshold、循环检测计数、本会话剩余预算。 | 确认护栏是否武装、实际触发过几次,或解释某条命令为什么被拦。护栏关闭时会如实说明,而不是报一堆 0。 | | jev_overview | 本会话 Jev 账本只读快照:最近判定与择案(含置信度)、延迟中位与 p95、问题类型分布、护栏事件、累计 tokens 与成本,以及 Key/护栏/阈值状态。 | 用户问「Jev 做了什么 / 拦了什么 / 花了多少」,或需要不重启会话就核对端点与预算状态时。账本以插件实例生命周期为起点;护栏计数在 jev_guard_status。 | | jev_usage | 本机实测的 Jev 用量与(可选)本地预算:滚动窗口(今日 / 7 天 / 30 天 / 全部 / 本会话)、调用数、input/output tokens、估算成本、延迟中位与 p95、问题类型与按工具分布、全天用量预测;配合 quota.enabled + quota.enforce 可在调用前硬停。 | 用户问「Jev 用了多少 / 花了多少」,或你想在一批判定前先核对预算时。只读本地状态,不发起 API 调用。TypeSafe 没有余额接口,这里报的是本机实测用量而非供应商余额。 |

自动护栏模式(可选开启 autoGuard.enabled):在 shell 类工具(bash/pwsh/run_code/terminal)执行前,先跑零成本的确定性层。7 条硬规则直接拦下灾难性、不可逆的操作:文件系统、盘根或目录树的递归删除、磁盘格式化、数据库破坏语句、凭据外泄、被强制推送的 git 历史;3 条软规则(主机重启或关机、未强推的 git 历史重写、恒真条件的 DELETE/UPDATE)交给 Jev 判定(noul 超阈值即拒绝)。硬规则只在可执行位置触发,所以你只是引用或描述一条危险命令时绝不会被硬拦;落在别处的硬模式会降级为交给 Jev 的提示。Jev 不可用时 fail-open 放行并告警,绝不假装检查过。循环守卫对连续相同工具的调用做语义停滞判定,只注入纠偏建议、不阻断。所有判定(确定性与 Jev)都会写进会话账本,可通过 jev_guard_status 审计。

诚实设计,绝不造假:

  • 未配置 TYPESAFE_API_KEY 时,工具与护栏都会用明确的报错说明如何配置;
  • 每次 jev_decision 结果都带回 model、延迟与 token 用量,可审计;
  • jev_verify 拒绝报告任何未经实测的数字;
  • 独立的基准 CLI(bench/bench.mjs)零依赖,任何人可用任意 Key 复现发布的数据。

0.9.0 更新

  • 多后端:判定不再只有 Jev。新增 lib/providers.js,一层适配器同时覆盖两派契约,jev_decision / jev_batch / jev_choose / jev_triage / 护栏全部自动跟随:

    | 后端 id | 覆盖范围 | 置信度语义 | | --- | --- | --- | | systemone | Jev 本体 + 所有 /v1/systemone 兼容实现(Microsoft Decision-1 on Foundry、Cloudflare Clef、AWS Strands Decider、Kev、Telnyx、Upstage Solar Decide、Ollama 0.35+、LLM Gateway) | calibrated | | openai-chat | 任意 OpenAI 兼容模型(DeepSeek、Qwen、Moonshot、OpenRouter、LM Studio、vLLM、Ollama /v1) | self-reported | | openai-decisions | /decisions 阵营(OpenAI 公测、Perplexity)—— 实验性、容错解析 | self-reported | | huggingface | 零样本 NLI 分类(HF Inference API,如 facebook/bart-large-mnli) | nli-score |

  • 新增 jev_providers 工具:列出后端、当前默认、级联链与预设;probe=true 会真的给每个后端发一次一问请求,返回真实延迟/答案或真实错误。

  • 新增 provider 参数(单次调用临时指定)与 cascade 配置(主后端失败时按序兜底,结果带 fallbackFrom 如实披露)。

  • 诚实边界:不同后端的 confidence 不是同一种东西,输出里带 confidenceKind 标注;只有 Jev 有已知单价,其它后端的 estimatedCostUs 为 0 并标注「not priced」,绝不套用 Jev 的价格。

  • 重要实测(2026-10-26):TypeSafe 从本网络返回 HTTP 451「Typesafe is not available in your region」,HuggingFace 的两个域名均不可达。这不是插件缺陷,但它让「多后端 + 本地后端」从可选变成了必需——见下文《多后端决策模型》。

0.8.6 更新

  • 修掉一个会让宿主起不来的依赖问题(issue #1):@deepseek-ai/dsh-tools 曾被写成普通 dependencies;在 nodeLinker: hoisted + hoistPattern: ["*"] 的 profile 里,pnpm 会把一份真实副本平铺到 profile 的 node_modules/@deepseek-ai/,dsh 的 tools 条目于是加载这份副本、因缺少 peer 而 import 失败,最终报 1 required plugin did not activate。现在它改为 optional peer(^0.1.5-rc.2)——永不被安装,也就不可能遮蔽宿主;dependencies 里只剩 leaf 库 @deepseek-ai/schemastery。
  • 新增回归闸门 test/manifest.test.mjs:任何宿主运行包一旦回到 dependencies 测试立即失败(用「把 bug 装回去」的方式验证过它真的会红)。全量 38/38。
  • 功能与 0.8.5 完全一致。

0.8.5 更新

「剩余」终于有了诚实的来源:你自报的余额,减去本机实测花费——而不是编造出来的数字。

  • 重启不再清零。 quota.persist 默认改为 true:账本写入 $DSH_HOME/jev-usage.json,宿主没给 DSH_HOME 时回退 ~/.dsh/jev-usage.json(回退缺失正是「重启后累计一直是 0」的根因)。想回到纯内存,设 quota.persist: false。
  • 剩余余额 = 自报 − 本机实测。 TypeSafe 没有任何余额接口(/v1/usage、/v1/quota、/v1/account、/v1/balance、/v1/credits、/v1/billing、/v1/me、/v1/limits、/v1/wallet、连 /v1/openapi.json 都 404;/v1/models 的响应头里也没有任何 quota/credit 字段),所以供应商侧余额无法读取。填了 quota.declaredBalanceUsd(自报余额)与 quota.balanceSince(起始日,如 2026-10-01)后,面板写 剩余 = 自报 $5.00 - 本机实测 $0.000004(2026-10-01 起);不填就明确写「未自报余额」,绝不给一个猜出来的数字。
  • 胶囊 20 秒一刷(原 60 秒):刚跑完一次判定时胶囊看起来还停在 0,像是坏了。
  • 折叠标签优先显示剩余。 自报余额后胶囊折叠态变成 Jev · 剩余 $4.9997 · 今日 3 次;账本落盘时弹层里的「累计(本插件实例)」改称「累计(本机实测)」。
  • 设置卡新增「自报余额」与「自报余额起始日」两项;quota.persist 提示改为「默认开启,重启后累计不归零」。
  • 新增 jev_batch——一次调用给一批文本做同一组判定,直接产出表格。 1–20 条文本 × 1–5 个问题,每条文本一次真实调用(默认 4 路并发、上限 6),返回可粘贴的 markdown 表格;sort=auto|desc|asc|none 可按某个判定维度排序(auto 只在唯一 score 问时降序);内置 sentiment / priority / intent / pii / spam 预设,也可自写 questions(与 jev_decision 同形)。失败的行在表里标「失败」并附原文错误,绝不猜测;每一行单独进账本(kind: "batch"),所以 N 条就是 N 次调用、N 次成本。多条文本同一组判定就用它,不要逐条手搓 jev_decision。
  • 测试:npm test 37/37(新增 test/batch.test.mjs 7 组断言:逐条真实调用与实测成本、score 排序三态、失败行不猜测、全失败即抛错、preset 展开与 context 前缀、11 组参数校验零调用、并发上限;另有 test/usage.test.mjs 余额用例、test/client.test.mjs 胶囊余额渲染用例、test/dashboard.test.mjs 状态页与载荷断言、test/toolview.test.mjs 批量卡片断言)。客户端刷新页面即生效;服务端改动需重启宿主。

0.8.4 更新

面板不再暗示不存在的额度;护栏自己的 Jev 判定终于进账本;插件开始自己出手。

  • 不编造额度。 TypeSafe 是按量计费的 API,没有余额接口。没有配置本地预算时,胶囊与状态页不再给出「额度正常」这种判定,不再对着「∞」画百分比进度条,也不再显示「额度重置 13 小时 41 分后」——那是在为你从未设置的预算倒计时。没有预算时面板只说一件事:按量计费、没有任何额度会重置、只报本机实测用量。「本地预算重置」只在真的设了本地上限时出现,并明确标注为本机自设。
  • 金钱优先。 折叠胶囊显示 Jev · 今日 $0.000534 · 29 次,弹层以「今日成本」「累计成本」为主行,调用次数退为次级行——按量计费的用户真正付的是钱。
  • 护栏的 Jev 调用进账本。 之前 judgeRisky/judgeStall 判定完就消失:一次会话里 jev_guard_status 报 safety.jevCalls: 2,用量面板却仍写「今日调用 0 次」。现在两类判定都通过 onJevCall 事件上报延迟与 token,并以 kind: "judge"(tool: "auto-guard")记入账本。
  • 自动预判(autoTriage,默认开启)。 每轮对话的第一步,插件自己发一次小规模 Jev 调用(4 个路由问题、约 1.5K 输入 token、受 autoTriage.timeoutMs 约束),判定本轮意图、是否真的需要原子判定、属于哪一类、该用哪个 Jev 工具,然后把结论作为一条 plugin 来源的用户消息注入上下文。每个 (agent, turn) 至多一次,绝不阻塞步骤,遇到未知宿主形态、缺 Key、超时或任何 API 错误一律 fail-open。因为这次调用也计入账本,插件只要在工作,面板就不会再是 0。
  • 引导更硬。 系统提示段新增【强制触发】与【禁止绕过】规则(分类/打标/路由、优先级/严重度/满意度打分、真伪与合规核查、结构化抽取、在 2–10 个方案间择优必须先调 Jev;不得以「我已经知道答案」跳过),并写明真实成本量级(一次约 $0.00002–0.0001;25 个问题与 1 个问题同价)。
  • 测试:新增 test/triage.test.mjs,并在 test/usage.test.mjs、test/client.test.mjs、test/guard.test.mjs 扩充断言;npm test 30/30。客户端部分刷新页面即生效;服务端部分(护栏记账、自动预判、引导、状态页)需重启宿主。

0.8.3 更新

设置里保存的项,现在真的会生效。

  • 根因:卡片把点号字段名整串交给 scope.set(field),而该调用只写单段路径 path: [field],于是 dashboard.basePath 这类字段在设置文档里变成一个名为 dashboard.basePath 的字面键,schema 永远解析不到。保存提示成功、实际什么也没变:在已重启的宿主上,~/.dsh/settings.yaml 里存着扁平键 autoGuard.maxJevCallsPerSession: 60 与 dashboard.basePath: jev,而解析后的文档仍是 schema 默认值 50 与 /jev。这是 0.8.2 重启后通过 settings/describe RPC 读取线上文档时发现的。
  • 修复:卡片改为生成 { op: "set", path: [<段>, …] } 操作,并用一次原子 scope.mutate(ops) 提交;仅在宿主不提供 mutate 时才回退为链式 scope.set。
  • 打开即修复:新增一次性挂载 effect——若文档里存在 ≤0.8.2 写下的字面点号键,则对每个键先写入嵌套路径、再删除字面键,并在一次原子变更内完成;用 WeakSet 保证每个作用域只修一次,整段 try/catch,修复失败绝不影响卡片。
  • 纯客户端改动:刷新页面即可,无需重启宿主。test/client.test.mjs 的 PASS 7 覆盖路径切分、生成的操作、原子修复与幂等性。npm test 29/29。

0.8.2 更新

看板的两处毛病,外加一个完全不依赖看板的用量入口。

  • /jev 不再 404。 此前 dashboard.basePath 被原样使用,于是写成 jev(缺前导斜杠)时注册的是字面路径 jev,浏览器请求永远匹配不上。现在会规范化路径(补前导斜杠、去尾部斜杠、空值与 / 回落 /jev),并且同时注册 /jev 与 /jev/。即使 dashboard.enabled: false,该路径也会返回一张实时状态页——今日调用、今日成本、本插件实例、今日 tokens 与判定时延、额度状态——并指路输入框右侧的胶囊、说明如何开启完整看板,不再是宿主那张干巴巴的 404。
  • /jev/api/usage——一条只读的紧凑 JSON 路由,无条件挂载(不依赖 dashboard.enabled),输出与 jev_usage 工具同源的本地实测快照。
  • 输入框右侧的用量胶囊(conversation.input.right,提交按钮旁),照 dsh-opencode-go 的形态做:Jev · 今日 29 次 · $0.000534,带 warn/danger 状态点,点开是 270px 小面板——今日调用与今日成本对照各自上限、本插件实例调用、今日 tokens、中位与 p95 时延、护栏拦截、用量前 3 的工具、额度重置倒计时、最后刷新时间与手动刷新。每 60 秒与切回标签页时刷新;胶囊路由缺失时自动回退到完整看板 API;失败降级为 Jev · 额度不可用 并带上真实错误,绝不抛错。它只报本机实测数据,绝不编造供应商余额;对话内的 jev_usage 仍是完整面板。
  • 回归测试:test/dashboard.test.mjs 覆盖路径规范化、看板开/关与自定义 basePath 三套路由表、200 状态页与快照抛错;test/client.test.mjs 覆盖胶囊 payload 的三种形态、标签与状态色、以及渲染出的面板文本。npm test 29/29。

0.8.1 更新

修复「设置 → 插件」卡片明明配了 Key 却显示未配置、且所有字段为空的缺陷。

根因:注册给设置服务的 schema 给 GUI 字段打了 volatile 标记。在认得该标记的宿主上(schemastery 3.18.4),resolve() 会把每个被标记字段换成活的引用对象,而设置服务原样发布 registration.resolved——于是上线值成了 {"enabled":{},"apiKey":{},"apiKeyEnv":{},"quota":{"enabled":{},…}}。GUI 自带的是更老的 schemastery(3.18.2),无法解码这个形状(真实报错 $.enabled expected boolean but got [object Object]),卡片便静默退回空草稿:徽章「未配置」、字段全空。插件自身的配置读取不受影响(会解包这些引用),所以判定、护栏与 jev_usage 一直正常。

  • 一份字段定义,两个 schema。 由 buildConfig() 同时造出 Config(入口表单用;保留标记,供认得它的宿主)与 SettingsConfig(纯 schema,真正注册给设置服务的那个),23 个字段不可能漂移。
  • 卡片不再只有一条解码路径。 解码值为空时改读服务端本来就会下发的原始 base/user 图层,并在卡片上明说(「服务端配置值未能解码…」),字段依旧可编辑、可保存。
  • 「凭据引用」不等于「已配置」。 徽章三态:明文 Key / 环境变量 <NAME>(未校验)/ 无。
  • 回归测试:test/config.test.mjs 断言注册用 schema 上线后是普通值且可 JSON 往返;test/client.test.mjs 用「解码失败」的快照渲染真实卡片,断言徽章给出真实凭据引用、且整棵树绝不出现「未配置」。npm test 29/29。

线上实测(用部署副本,dsh 0.1.5-rc.2,2026-10-06):

| schema | 上线值里的空对象字段 | GUI 解码 | | --- | --- | --- | | Config(仅入口表单) | 8 个 + 全部 quota.* | 失败——$.enabled expected boolean but got [object Object] | | SettingsConfig(注册用) | 无 | 通过;apiKeyEnv="TYPESAFE_API_KEY"、enabled=true、autoGuard.denyThreshold=0.8 |

0.8.0 更新

使用额度面板:Jev 的用量现在被实测、留存并展示——工具视图、概览卡与独立看板三处可见。

  • jev_usage——可直接调用的额度面板。 每次判定、择案、自检与护栏事件都会本地记账,附实测 input tokens、成本、延迟、问题类型分布与工具名。工具返回滚动窗口(今日 / 7 天 / 30 天 / 全部 / 本会话)、每日调用与成本序列、按当前速率推算的「照这个速度还有 N 小时触顶」预测,以及可选的硬性停止。
  • 只报本地预算,不编造供应商余额。 TypeSafe 没有余额或额度接口(GET /v1/usage、/v1/quota、/v1/account、/v1/balance、/v1/credits、/v1/limits、/v1/billing 全部 404,只有 /v1/models 有响应)。因此面板只报本机实测用量,对照你自己设的上限:quota.dailyCallLimit、quota.dailyCostLimitUsd、quota.sessionCallLimit 与 warnAtPercent。这条边界同时印在文本结果与卡片上——绝不编造余额。
  • 可选硬停(quota.enforce)。 在 enabled + enforce 下,会越过所设上限的调用在发起 API 请求之前就被拒绝,并说明触顶的是哪条预算;默认只展示、不拦截。
  • 持久化(0.8.5 起默认开启,此前默认关闭)。 0.8.0–0.8.4 默认只存内存(400 条样本),需设 quota.persist: true 才把最多 quota.historyDays(默认 30)天的每日历史写入 $DSH_HOME/jev-usage.json(临时文件 + rename,失败放行、不影响判定);0.8.5 起默认写盘,重启后累计不再归零。
  • 三处都可见。 jev_overview 增加额度区块;独立看板(dashboard.enabled)增加额度区(进度条、预测与 30 天走势图);设置卡增加「使用额度」组;jev_verify 现在也会记录 27 次调用、tokens 与成本,而不只是准确率文本。
  • 测试 28 项全绿——新增 test/usage.test.mjs 覆盖空态、token 记账、批量调用、额度状态与硬停、跨天持久化与裁剪、重载、重置以及全部格式化函数。

0.7.5 更新

这是一次「审计版」发布:三路审查(服务端 / 客户端 / 打包)找出的正确性与诚实性问题全部修掉并用测试钉住;jev_verify 的 27 题也改为并发执行。

服务端

  • 看板关闭时账本也照记:record() 原本在独立页面未挂载时直接返回,于是 jev_overview 永远报 0 次调用 / 0 token / $0,而 jev_guard_status 却在计同样的事件。现在内存 ring 永远记录,只有 HTTP 页面与 $DSH_HOME/jev-roll.jsonl 追加仍受 dashboard.enabled 控制(README 与设置卡文案已如实改写)。
  • 护栏补上报它本来就知道的事件:Jev 拦截路径现在会发 onSafetyDeny(带 confidence 与工具名),循环路径会发 onLoopAdvisory,看板的「建议数」与账本里的 Jev 判定分支不再是死代码。
  • 自动护栏重做为「硬 / 软」两层 + 位置感知(见下方「自动护栏」):不再对整段参数做正则;根目录删除识别改为逐 token 走 flag,额外 flag、--flag=value 写法与反序 flag 都无法再混过去;对普通相对目录(例如构建产物目录)的递归删除降为交给 Jev 的软提示,只出现在引号或描述里的硬模式同样降级,而不是直接拦截。
  • TYPESAFE_BASE_URL / TYPESAFE_MODEL 覆盖真正生效:此前读到的其实是 schema 默认值,环境变量永远不生效,自建端点的用户被静默打到官方地址。
  • jev_verify 分 6 路并发(VERIFY_CONCURRENCY):实测 4.96 s 墙钟(复测 3.999 s),串行需 10.1 s,也不再逼近工具自身的超时。
  • mislabeled 恢复全量,并新增 mislabeledHighConfidence 单列高置信误判(此前只要有一个高置信误判,低置信误判就全部消失)。
  • 报错会指明具体工具:missingKeyError() 与 abort/timeout/HTTP 文案此前硬编码 jev_decision,即使出错的是 jev_choose 或 playground。
  • 注册失败不再被冲掉:safe() 现在累积 regFailures,jev_guard_status 以 registrations.failures / failureCount 返回——正是这类失败让前面两次发布带着坏功能出门。
  • 成本改为注入常量(inputPriceUsdPerMTok),Jev 判定缓存上限 200 条。

客户端(对话内视图与设置卡)

  • noul 置信度不再反着显示:noul: 0.02 的「否」此前显示成「否 · 置信度 2%」并配告警色,现在显示判定侧置信度(98%),与概览看板一致。
  • 概览卡补上平均延迟与问题类型分布(投影其实一直在传)。
  • jev_choose 可审计:工具视图保留排名结果以及提交的候选原文与选型背景,不再只留一个数量。
  • 运行中的标签更诚实:只有 jev_decision/jev_choose 在调用途中显示「0 个问题 / 0 个候选」,其它工具不显示。
  • 修掉失效的 CSS 变量(--dsw-alias-bg-l2 → --dsw-alias-bg-layer-2)——深色主题下推荐行与 chip 此前没有填充。
  • 看板页面会报自己的错,不再把异常吞成永久「加载中…」,并兼容没有时间戳的事件。
  • 凭据徽章三态:字面 Key 显示「已配置」,环境变量引用显示「环境变量(未校验)」,都没有则显示「未配置」——环境变量名不再被当成可用凭据。

打包与文档

  • test/functional.mjs → test/functional.test.mjs:真实 HTTP 契约与评分测试此前从未在 npm test 里跑过(glob 只匹配 *.test.mjs)。
  • bench/choose-e2e.mjs 不再硬编码开发者主目录,改从 TYPESAFE_API_KEY 或 DSH env 文件读 Key。
  • bench/bench.mjs 新增 --concurrency(默认 6)并报告墙钟;user-agent 带版本号。
  • README 把延迟尾部分位、测试计数写成实测值,engines.dsh 标注为「建议性」,不再宣称一条会扫描它根本没检查过的文本的黑名单。
  • 声明可选 peer 依赖(dsh-credentials、dsh-client-locale、dsh-client-ui-settings、dsh-api-remotes)。

0.7.4 更新

  • jev_choose 这次才真的注册成功——0.7.3 里这个工具在任何宿主中都不存在。 它的 options 参数声明了 minItems/maxItems,而宿主的值模式 DSL 不支持这两个关键字(JsonSchemaError: unsupported JSON schema: parameters.options.minItems is not supported by the value schema DSL);defineTool 抛错,被「单工具隔离」吞掉,于是 0.7.3 发布了一个任何宿主都调不到的主打功能——而当时的启动测试只断言 4 个工具,所以没有任何告警。0.7.4 删掉这两个关键字(2–10 个候选、每个 ≤800 字符、context ≤2000 字符这些约束改由 lib/counsel.js 的 validateOptions 在运行时保证),并让 test/boot.test.mjs 走真实 defineTool 模式编译器断言五个工具全部注册。
  • 引导段这次真的注册进去了——这才让 harness 自己主动调用 Jev。 0.7.3 及以前,插件用 getSectionOrder("TOOL_JEV") 取排序位,而当前这一代 DSH 的槽位表里根本没有 TOOL_JEV,取回 undefined;宿主的 systemPrompt.section() 拒绝非有限数,直接抛 TypeError: prompt section "<name>" order must be a finite number,而这个异常又被保护 profile 的同一套隔离吞掉——于是引导段从未存在过,模型只看得到工具描述,自然不会主动调用。0.7.4 的 order 解析链为 getSectionOrder("TOOL_JEV") → guidance.order → 3000,并把结果写进宿主日志(system prompt: guidance registered | section tool:jev | order N | chars M);test/boot.test.mjs 现在会在注册段 order 不是有限数时直接失败。更正:0.7.3 更新说明里「使用指引已注入代理 system prompt」在当时并未生效,本版本才真正生效。
  • 功能描述更精确(是什么 / 何时用 / 何时不用):五个工具描述现在都写明实测延迟、问题类型规则、「相关问题合并成一次调用」的建议、jev_verify 的真实成本,以及明确的禁用边界(jev_decision 只出判定不写文本;jev_choose 只打分不解释)。系统提示里的引导段由同一套措辞生成,提示词与工具列表不会再各说各话。
  • 新增 guidance 配置组:guidance.enabled(默认 true)、guidance.order(默认 3000)、guidance.extra(按原样追加的部署自定义规则),均可在 GUI 设置卡中编辑。

0.7.3 更新

  • jev_choose——多方案择优工具:一次调用对 2–10 个候选做法逐方案打分(契合度 score 0–3,带校准置信度;风险 noul),合成综合分(fit/3 × (1−risk)),返回排名表、推荐项与每方案延迟/成本。对话内渲染为排名表格(ChooseBody),并计入看板决策统计(kind: choose 并入 decisions)。注意:0.7.3 发布的这个工具是坏的(参数模式被宿主拒绝、注册未成功),修复见下面的 0.7.4。
  • 0.7.3 已部署:D:\lab\jev(vendor)与 web profile pnpm store 三处字节一致(MD5 全等);node --check 全绿;rankOptions 以 mock 传输层完成单元验证。

0.7.2 更新

  • 基准表述与代码对齐:jev_verify 的工具描述此前写着「24 questions across 15+ cases」,而 lib/cases.js 自 v0.2.0 起一直是 27 个带标签问题(27 个用例,含护栏判定);v0.7.2 统一为 27,README、market PR 稿与验证报告同步更正。
  • 2026-09-28 复测(本版本发布前,run 4):准确率 96.3%(26/27)、8,696 input tokens ≈ $0.000365、中位延迟 484 ms(受网络影响);终端全文见 bench/run4.log。

0.7.1 更新

  • 仅文档同步(0.7.1 的代码与 0.7.0 一致):验证报告补齐完整实测历史——2026-09-21 基准与护栏实测、2026-09-23 GUI 卡片/设置卡重做/对话内视图、2026-09-26 两代设置 API 兼容、2026-09-28 v0.7.0 回归;docs/verification.md 现为 208 行完整记录。行为与 0.7.0 相同。
  • 每个工具都有结构化对话内视图:工具结果新增 presentationMeta 投影(kind: decision | overview | guard | verify),对话里直接渲染判定卡、护栏看板与实测报告——答案、置信度条、状态标签与统计格,而不再是原始文本;缺少 meta 时自动回退解析工具文本。
  • 完整插件设置卡:「设置 → 插件 → 插件配置 → Jev」现在覆盖全部选项:凭据(Key、凭据引用、API 地址、模型、超时、问题数上限)、工具开关、整组自动护栏(安全/循环开关、受护栏工具清单、拦截阈值、Jev 预算、循环参数)、看板(开关 + 路径)与使用额度面板(开关、硬停、告警阈值、每日调用 / 每日成本 / 本会话上限、持久化、历史天数),带数值校验与未保存状态处理。
  • 配置处理加固:使用前会解包 schemastery 的 volatile 字段(.volatile()),因此对象形态的 apiKeyEnv 不再让 credentialRef(...) 崩溃,autoGuard.enabled / dashboard.enabled 真正生效,数值型选项也按数字读取。
  • 测试 28 项全绿(npm test):覆盖启动、客户端渲染、工具视图、设置卡、看板、护栏、额度记账与展示投影。

为什么是 Jev

TypeSafe AI(创始人 Diogo Almeida,前 OpenAI、ChatGPT 研究方向)于 2026-09-15 发布 Jev,定位首个「System One」模型:输入非结构化状态,输出类型化概率判定。在智能体高频原子判定场景(分类、路由、分诊、评分、护栏、真伪判断)上,Jev 比前沿对话 LLM 快数十到两百倍(输入 $0.042/百万 token,输出免费)。适合承担 Agent 循环里高频「快判断」,把「慢思考」留给大模型。

安装

要求 Node >= 20,dsh >= 0.1.5-rc.2。engines.dsh 是建议性的:npm 只强制 node 键,真正的门槛是宿主提供 dsh-tools 0.1.5-rc.2 与 settings 服务——缺哪个就只降级哪个界面(并在 jev_guard_status 里报出来)。

dsh plugin --profile web add dsh-jev-verify

然后在 $DSH_HOME/profiles/<profile>/cordis.patch.yml 增加加载条目:

- insert:
    - id: jev-verify
      name: dsh-jev-verify
      config:
        autoGuard:
          enabled: true     # 可选:开启自动护栏

重启 profile(或用插件市场一键安装,市场会自动完成以上两步)。

也可先安装 GUI 插件市场:dsh plugin --profile web add dshmarket,然后在「设置 → 插件市场」中一键安装本插件。

API Key

到 https://console.typesafe.ai/keys 免费创建。任选其一:

  1. 启动环境里 export TYPESAFE_API_KEY=...;
  2. 设置 → 插件 → 插件配置 → Jev(凭据服务);
  3. 插件配置里写 apiKey。

可选环境变量,且自 0.7.5 起真正优先于 schema 默认值:TYPESAFE_BASE_URL(默认 https://api.typesafe.ai/v1)、TYPESAFE_MODEL(默认 jev-latest)。在此修复之前读到的是 schema 默认值,设置这些环境变量没有任何效果。

多后端决策模型

为什么有这一层:截至 2026-10,已有 11 家决策 API 收敛到同样三类问题(是/否、单选、打分),却分成两派契约 —— System One 阵营(POST /v1/systemone)与 /decisions 阵营(noul 改叫 predicate,多一个 refusal)。"改个 URL 就换厂商"只在同阵营内成立;跨阵营需要适配器,而适配器正是锁定发生的地方。本插件把这层补上。

三种典型用法

1)默认 Jev:provider 留空即与 0.8.x 完全一致。

2)本地后端(受限地区推荐)——Ollama 0.35+ 直接提供 System One 形状:

providers:
  systemone:
    baseURL: http://127.0.0.1:11434/v1
    model: <本地决策模型名>

或任意 OpenAI 兼容本地服务(LM Studio / vLLM):

provider: openai-chat
providers:
  openai-chat:
    baseURL: http://127.0.0.1:1234/v1
    model: qwen2.5-7b-instruct

3)级联兜底——主后端被地域封锁或超时时自动切换,且如实披露:

provider: systemone
cascade: [openai-chat]

结果里会带 fallbackFrom: ["systemone"]:不会假装是 Jev 答的。

怎么确认哪个后端能用

让 Agent 调用 jev_providers(只读,不发请求),或 jev_providers probe=true(每个后端各发一次真实请求,返回真实延迟或真实错误)。配置写在插件设置或 cordis.patch.yml 的 config: 下。

已知的可用性边界(实测)

| 后端 / 端点 | 2026-10-26 从本网络实测 | | --- | --- | | TypeSafe Jev(api.typesafe.ai) | HTTP 451 地域封锁,响应体 {"title":"Typesafe is not available in your region."} | | HuggingFace(api-inference / router) | 两个域名均不可达 | | DeepSeek OpenAI 兼容端点 | 可达(返回 401 说明请求形状正确,是本机 key 失效) | | Ollama / LM Studio 本地 | 未在本机安装,未验证;systemone 与 openai-chat 两条路都指向它们 |

上表说明一件事:先跑 jev_providers probe=true 再决定用哪个后端,不要在不可达的后端上反复试。

使用

任何需要快速判定的场景,直接让 Agent 调用 jev_decision。示例提示词:

用 jev_decision 评估 state = "<工单文本>",问题:department(choice,billing/technical/sales)、is_urgent(noul)、severity(score,3 级)。报告答案与置信度。

随时可让 Agent 执行 jev_verify 确认端点健康并获取实测数据,或 jev_guard_status 查看护栏状态。

直接调用形态

{
  "state": "I was double-charged for my subscription and I want a refund.",
  "questions": [
    { "name": "department", "type": "choice",
      "instructions": "Which team should handle this?",
      "criteria": { "billing": "Payment or subscription issues",
                    "technical": "Bugs or integration problems",
                    "sales": "Pricing or account questions" } },
    { "name": "is_urgent", "type": "noul",
      "instructions": "The message conveys urgency or time-sensitivity" }
  ]
}

返回每个问题的 answers(choice/score/noul + confidence + probabilities)、usage、latencyMs 与 estimatedCostUs。

harness 何时会主动调用 Jev

调用分四条路径,0.7.4 修好的正是第一条,0.8.4 增加了第四条:

  1. 系统提示引导(主动):插件注册名为 tool:jev 的提示段(order 默认 3000,可用 guidance.order 改、guidance.enabled: false 关、guidance.extra 追加)。它按优先级列出每个工具的触发规则——判定落进这些类别就立刻调用该工具——并且只在 jev_decision 确实存在时才注册,绝不宣传没加载的工具。这就是让 agent 自己想起来用 Jev 的机制;没有它,模型只看得到工具清单,很少愿意花一次调用。
  2. 工具描述(发现):每个工具描述都写着同样的信息:实测延迟与成本、问题类型规则、「相关问题合并成一次调用」,以及明确边界——jev_decision 只出判定不写文本,jev_choose 只打分不解释。
  3. 自动预判(插件自己发起,0.8.4):autoTriage.enabled 时,插件在每轮第一步自行判定并注入路由建议(plugin 来源消息),agent 不需要「想起」先调用 Jev,直接读建议即可。可用 autoTriage.enabled: false 关闭、autoTriage.minChars 调整最短文本阈值、autoTriage.maxCallsPerSession 限制每会话调用数。
  4. 钩子与用户指令:autoGuard.enabled 时,每个受护栏的 shell 类调用在执行前被审计(先确定性黑名单、再 Jev),完全不经过模型决策;用户也可以直接说「用 jev_decision 判定这条工单」「用 jev_choose 给这三个方案排序」「run jev_verify」。

如果 agent 还是不理会 Jev,按顺序检查:guidance.enabled 没被设为 false;宿主输出里出现过 guidance registered;jev_decision 在工具清单里;以及这个任务本身确实是判定类任务,而不是写作/推理类任务。

自动护栏

autoGuard.enabled: true 时,两个钩子守护受保护的每个工具调用:

  1. 安全门禁(tools/pre-execute):先跑免费的确定性层,命中结果分硬(直接拒绝)与软(交给 Jev)两类。7 条硬规则覆盖灾难性、不可逆操作:文件系统/盘根/目录树递归删除、磁盘格式化、数据库破坏语句、凭据外泄、强制推送的 git 历史。3 条软规则覆盖「有破坏性但常常是合法操作」:主机重启或关机、未强推的 git 历史重写、恒真条件的 DELETE/UPDATE。硬模式只在可执行位置(命令行开头,或紧跟 ;/|/&/(/换行,且前面只有包装器、环境变量赋值与 flag)触发,因此只是引用或描述危险命令绝不会被硬拦;出现在别处的硬命中会降级为交给 Jev 的提示。未被拦下的一律交给 Jev(风险 noul ≥ denyThreshold ⇒ 拒绝),判定缓存上限 200 条,并按会话限预算;Jev 故障时 fail-open 并告警。
  2. 循环检测(tools/post-execute):连续同工具、输出较长的调用触发 Jev 停滞判定;判定停滞时向下一个请求注入非阻断式纠偏建议,随后进入冷却。

所有判定(确定性或 Jev)都会写入会话账本并由 jev_guard_status 计数;任何注册失败也会在那里暴露,而不是被滚屏冲掉。0.8.4 起护栏的 Jev 判定也计入用量账本(onJevCall → kind: "judge"),护栏再忙也不会让面板停在 0。本版本自身审计的经验(2026-10-04):三份审查负载被 0.7.4 的旧规则拦下——两次确定性、一次 Jev 判定 81–85%(阈值 0.8)——这正是硬规则要改成位置感知的原因;同时 0.7.5 的测试重新确认了 0.7.4 的契约(shell 与 PowerShell 递归删除、强制推送 git 历史、读取凭据文件这四类仍然确定性拦截),27/27 全绿。

运行可视化(不另开页面)

可视化直接在对话里看,不再需要单独网页:

每个工具都带 presentationMeta 投影,结果以结构化卡片渲染,而不是原始 JSON:

  • jev_overview — 决策看板:状态标签(模型 / Key / 护栏 / 阈值)、8 个统计格(判定数、实测数、拦截数、提示数、中位延迟、平均置信度、input tokens、累计成本)以及最近的判定与护栏事件。
  • jev_verify — 线上实测报告:准确率、答对数、高置信准确率、中位与 p95 延迟、token、成本与误判用例。
  • jev_guard_status — 护栏卡片:受护栏工具、拦截阈值、本会话预算、安全与循环计数、最近一次受检工具。
  • jev_usage — 使用额度面板:额度状态、今日调用与成本、三条预算进度条、全天用量预测、按留存历史的每日走势图与按工具分布,底部写明诚实边界。

jev_overview 背后的会话账本永远记录(内存 ring,上限 300 条事件)——0.7.5 起不再等独立页面开启。需要独立网页版时仍可开启:dashboard.enabled: true 后访问 http://127.0.0.1:3080/jev;只有开启后事件才会同时追加到 $DSH_HOME/jev-roll.jsonl 供外部工具使用。

同一份账本也是使用额度面板(jev_usage、jev_overview 的额度区块、看板额度区)的数据源。它只统计本机:TypeSafe 没有余额接口,所以面板绝不宣称供应商侧余额——只有实测调用数、tokens 与成本,对照你配置的本地预算。

验证(实测、带日期)

方法学与最新实测结果见 docs/verification.md。

当前状态:✅ 已于 2026-09-21 对线上 API 实测(jev-latest):含护栏用例的 27 题基准准确率 96.3%(26/27),中位延迟 283–308 ms,27 题全程成本 ≈ $0.0004。唯一误标为已记录的边界值(severity 得分 0.01 vs 期望 0)。

最新复测(2026-10-04,0.7.5):96.3%(26/27),jev-latest(jev-1.13.0),中位 266–440 ms、p95 825–1468 ms、8,696 input tokens ≈ $0.000365,27 题 6 路并发墙钟 4.0–5.0 s(复测 3.999 s);唯一误标仍是已记录的边界用例(severity-low:0.01 vs 期望 0)。

随时可复现:

TYPESAFE_API_KEY=... node bench/bench.mjs            # 1 轮(27 个问题)
TYPESAFE_API_KEY=... node bench/bench.mjs --repeat 3 # 延迟稳定性

或直接让 Agent 执行「run jev_verify」。

0.7.4:引导段现在真实注册(根因:不存在的 TOOL_JEV 排序槽位让 systemPrompt.section() 抛错,而异常被隔离吞掉)——详见 docs/verification.md;npm test 覆盖该注册路径。

0.7.5:三路审计(服务端 / 客户端 / 打包)修复批次,详见上面的「0.7.5 更新」与 docs/verification.md;npm test 27/27。

0.8.0:使用额度面板——本机实测用量、滚动窗口、预测与可选硬性预算;npm test 28/28,详见上面的「0.8.0 更新」与 docs/verification.md。

0.8.1:注册给设置服务的 schema 改为纯 schema(不带 volatile 标记),设置卡片重新能解码,绝不再把已配置的 Key 报成「未配置」;解码值不可用时卡片回退读原始配置图层。npm test 29/29,详见上面的「0.8.1 更新」。

0.8.2:/jev 不再 404(dashboard.basePath 规范化;看板未开启也返回实时状态页),只读路由 /jev/api/usage 无条件挂载,输入框右侧新增 Jev · 今日 N 次 · $… 的紧凑用量胶囊(可展开小面板)。npm test 29/29,详见上面的「0.8.2 更新」。

0.8.3:设置保存真正写入 schema——用嵌套 path 段一次性原子提交,并对 ≤0.8.2 写下的字面点号键文档做一次性修复。纯客户端修复,刷新页面即可。npm test 29/29,详见上面的「0.8.3 更新」。

回归验证(2026-09-28,v0.7.0):在 headless profile(autoGuard.enabled: true)中,jev_guard_status 正确报告已武装的护栏(工具清单、deny threshold 0.8、预算),jev_overview 正常返回看板,不再出现此前的 credentialRef 崩溃——即 volatile 配置解包修复;当时 npm test 19/19 通过(今天为 29/29)。

配置项

| 键 | 默认值 | 含义 | | --- | --- | --- | | apiKeyEnv | TYPESAFE_API_KEY | 凭据引用 / 环境变量 | | apiKey | — | 字面 Key(secret) | | baseURL | https://api.typesafe.ai/v1 | API 地址 | | model | jev-latest | 模型(可钉版如 jev-1.13.0) | | timeoutMs | 15000 | 单次调用超时 | | maxQuestionsPerCall | 25 | 单次调用问题数上限 | | verifyEnabled | true | 是否注册 jev_verify | | guidance.enabled | true | 是否向系统提示注入「何时调用 Jev」引导段 | | guidance.order | 3000 | 该提示段的排序位(必须能解析为有限数) | | guidance.extra | "" | 按原样追加到引导段末尾的部署自定义规则 | | autoGuard.enabled | false | 自动护栏总开关 | | autoGuard.safetyCheck | true | 高危命令执行前检查 | | autoGuard.loopCheck | true | 语义循环检测 | | autoGuard.tools | bash/pwsh/run_code/terminal | 护栏覆盖的工具 | | autoGuard.denyThreshold | 0.85 | Jev noul ≥ 阈值 ⇒ 拒绝/建议 | | autoGuard.maxJevCallsPerSession | 50 | 单会话护栏 Jev 预算 | | autoGuard.loopConsecutive | 3 | 连续同工具调用触发检测的阈值 | | autoGuard.loopCooldownMs | 60000 | 停滞判定后冷却 | | autoGuard.loopMinChars | 200 | 循环检测的最小输出长度 | | autoGuard.statusTool | true | 注册 jev_guard_status | | autoGuard.determinismFirst | true | 先跑免费的确定性检查再交给 Jev | | dashboard.enabled | false | 是否提供独立看板页面 | | dashboard.basePath | /jev | 独立看板的访问路径 | | quota.enabled | true | 是否注册 jev_usage 并记录用量 | | quota.enforce | false | 是否会越过本地预算时硬性拦截 | | quota.warnAtPercent | 80 | 用量百分比达到多少时转为「告警」状态 | | quota.dailyCallLimit | 0 | 本地每日调用上限(0 = 不限) | | quota.dailyCostLimitUsd | 0 | 本地每日成本上限(美元,0 = 不限) | | quota.sessionCallLimit | 0 | 本地本会话调用上限(0 = 不限) | | quota.persist | true | 是否把每日历史写入 $DSH_HOME/jev-usage.json(0.8.5 起默认开启) | | quota.historyDays | 30 | 保留的每日历史天数(1–365) | | quota.declaredBalanceUsd | 0 | 自报余额(美元),用于算「剩余 = 自报 − 本机实测」 | | quota.balanceSince | (空) | 自报余额的起始日 YYYY-MM-DD;留空表示全部已记录历史 |

相关项目

本插件的差异化:完整干净的原语 + 可审计的自动护栏 + 诚实可复现的验证基准,直面真实 TypeSafe API。

License

MIT