前言¶
DeepSeek Harness（DSH）把智能体能力拆成可插拔模块。日常开发里，很多步骤并不需要大模型生成长文，而是要在给定上下文上做快速判断：工单该分给哪条线、命令是否危险、端点是否还靠谱。若每次都走对话式 LLM，延迟和成本都偏高，结果也不一定是结构化、带置信度的。
TypeSafe AI 的 Jev（System One 决策模型）面向这类任务：输入非结构化 state 与类型化问题，一次并行 API 调用返回带校准概率的类型化答案，且不生成正文。社区维护者 xienda 的 dsh-jev-verify 把 Jev 以一等插件形式挂进 DSH，并提供可选的 auto-guard、对话内可视化，以及可对 live API 跑基准的自检工具。插件归类为「模型推理」，当前在 GitHub 上星标为 1；源码与说明见 GitHub 仓库，目录页见 SkillHub。
这是什么¶
dsh-jev-verify（npm 包名同插件名，当前版本 0.7.2，MIT 许可证）是面向 DeepSeek Harness 的插件。它不替代主对话模型写代码或写文档，而是暴露 Jev 相关的 agent 工具，并在设计上强调「可验证、不盲信」：无 mock、无静默降级；缺少 API Key 时工具与护栏会给出明确失败或告警，而不是假装已检查。
维护者：xienda。
核心功能¶
下面按 README 与 package 描述中已核实的能力说明。
决策工具 jev_decision¶
对一份 state 和一组类型化问题（choice / score / noul 等）发起 一次 API 调用，返回各题的类型化答案、置信度、概率，以及 token 用量、实测延迟和估算费用。README 给出的公开延迟量级约为 70–500 ms（随网络变化）。
典型问题形态包括：多选一（choice）、打分（score）、是/否类 noul 判断等，适合分类、路由、分诊、评分、护栏前置判断等高频小决策。
自检工具 jev_verify¶
对 live TypeSafe API 运行内置带标签基准（README 与 v0.7.2 说明一致为 27 道 labeled 题，含 guard 相关 verdict），返回实测准确率、中位/p95 延迟、校准与成本等。插件拒绝报告未实际测到的数字；仓库内另有无额外依赖的 CLI bench/bench.mjs，便于用同一 key 复现。
2026-09-28 的 run 4（发布 0.7.2 前复测）记录为 96.3%（26/27），完整日志见仓库 bench/run4.log。
护栏审计 jev_guard_status¶
在开启 auto-guard 后，用于查看护栏统计：拦截次数、受保护工具列表、阈值、预算等，便于审计 guard 行为是否透明、可计数。
可选 auto-guard（autoGuard.enabled）¶
需在配置中 显式 opt-in。在 shell 类工具（如 bash / pwsh / run_code 等）执行前后挂两层逻辑：
- Safety（pre-execute）：先用确定性黑名单拦截明显破坏性命令（如
rm -rf /、格式化磁盘、删库、凭证外泄等，免费）；仍显风险的命令再由 Jev 做风险 noul 判断，超过denyThreshold则拒绝并给出原因；Jev 不可用时报错 fail-open 并带警告，不会静默放行却假装已检。 - Loop（post-execute）：对连续相同工具、长输出等模式做 stall 判断；若判定停滞，向后续请求注入非阻塞建议并进入冷却，而不是硬阻断。
README 记载的实测示例（2026-09-21）：PowerShell 的 remove-item -Recurse … 被确定性规则拦住；而「永久清空 staging 并删光所有表行」类自然语言意图在命令执行前由 Jev 以约 91% 置信度拦截（阈值 0.8）。
对话内展示与设置¶
v0.7.1 起，各工具结果可携带 presentationMeta（decision / overview / guard / verify 等），在会话里渲染决策卡片、护栏看板、基准报告，而非仅 raw 文本。完整选项可在 Settings > Plugins > Plugin configuration > Jev 配置：凭证、工具开关、auto-guard 全块、dashboard 等。仓库说明 npm test 为 19 个用例通过。
启动稳定性¶
package 描述写明：注册项隔离（quarantined），单点失败只降级某一特性，不应拖垮整个 profile。
安装与启用¶
环境要求：Node >= 20，dsh >= 0.1.5-rc.2。
官方安装命令如下（勿自行拼接 github:owner/repo 形式）：
dsh plugin --profile web add dsh-jev-verify
随后在 $DSH_HOME/profiles/<profile>/cordis.patch.yml 增加 loader 条目，例如启用 auto-guard：
- insert:
- id: jev-verify
name: dsh-jev-verify
config:
autoGuard:
enabled: true # opt-in auto-guard
修改后重启对应 profile。若使用插件市场 UI，需先安装 dshmarket（dsh plugin --profile web add dshmarket），再在 Settings > 插件市场 一键安装（市场安装会完成上述两步）。SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。
API Key¶
在 https://console.typesafe.ai/keys 申请免费 key，任选其一：
- 启动环境中
export TYPESAFE_API_KEY=... - 插件设置卡片中的 credentials
- 在插件 config 里设置
apiKey
可选环境变量：TYPESAFE_BASE_URL（默认 https://api.typesafe.ai/v1）、TYPESAFE_MODEL（默认 jev-latest）。
典型用法¶
通过自然语言让 Agent 调用¶
README 示例：让 Agent 对工单文本使用 jev_decision，并指定 department（choice）、is_urgent（noul）、severity（score）等问题，要求汇报答案与置信度。
也可随时请求 jev_verify 确认端点健康，或 jev_guard_status 查看护栏状态。
直接工具调用形状¶
下面 JSON 结构来自 README，表示 state 与 questions 字段（节选）：
{
"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、usage、latencyMs、estimatedCostUs 等，便于逐次审计。
本地复现基准（需自行配置 key）：
npm run bench
适用场景与注意¶
适合谁：已在 DSH 上跑 agent 循环、需要结构化快判（路由、分诊、评分、风险 noul）、并希望用 live 基准与护栏审计降低「口头承诺不可信」风险的开发者。
背景：Jev 由 TypeSafe AI 发布（README 称 2026-09-15 为首款 System One 模型），定价与速度相对 frontier 对话模型更适合高频小判断；具体倍数与单价以 TypeSafe 官方为准，插件侧会在每次 jev_decision 结果里给出本次调用的用量与估算成本。
安全与权限：插件与 auto-guard 在 当前 dsh 进程权限 下运行；启用 autoGuard 会在工具执行链上介入，但 Jev 不可用时会 fail-open。安装前请阅读 源码 与 MIT 许可证，确认 guarded 工具列表、阈值与预算符合你的环境策略。勿在未审阅的情况下在生产 profile 直接打开破坏性命令路径。
诚实性设计：无 TYPESAFE_API_KEY 时工具与 guard 会失败并提示配置；guard 在 API 错误时 fail-open 但带警告，不会假装已完成 Jev 风险检查。
结尾¶
dsh-jev-verify 把 Jev 的并行类型化决策、live 27 题基准自检和可选两层 auto-guard 收进 DSH 插件形态，并强调每次调用的延迟、用量与护栏可审计。若你在 Harness 里做 agent 护栏或快判路由，可按上文命令安装、配置 Key 与 cordis.patch.yml，再用 jev_verify 对当前 key 与网络环境做一次实测对照。
