前言¶

DSH 插件允许开发者扩展 agent 的能力。dsh-jev-decide 的作用是注册一个名为 jev_decide 的 agent 工具，将 TypeSafe Jev（”System One” 决策模型）接入 DSH。它解决的问题是：当 agent 需要做出快速、准确的判断（例如消息紧急度分级、意图路由、guardrail 检查）时，调用 Jev 获取结构化的概率输出，而不是依赖对话模型凭感觉猜测。

核心功能¶

该插件主要提供以下能力：

1. 工具注册：在 DSH 中注册 jev_decide 工具。
2. 三种类型支持：支持 noul（是/否）、choice（多选一）、score（有序打分）三种类型的判断。
3. 概率输出：返回校准过的概率以及置信度。
4. 零配置凭证：复用 DSH 的凭证，无需额外配置 API Key。
5. 内置重试：内置 429 和 529 状态码的重试机制。

安装¶

可以通过官方命令直接安装：

dsh plugin --profile web add dsh-jev-decide

也可以通过 npm 安装（需要 npm >=7 或 pnpm auto-install-peers）：

npm install dsh-jev-decide

配置¶

插件的数据目录配置为 $DSH_HOME/plugins/dsh-jev-decide/config.json（或通过 cordis patch 的 config:）：

{
  "model": "jev-latest",
  "timeoutMs": 15000,
  "baseUrl": "https://api.typesafe.ai/v1"
}

使用¶

调用 jev_decide 工具时，需传入以下参数：

jev_decide({
  state: string,            // 必填，要评估的内容（纯文本）
  question: string,         // 必填，要做的判断
  type?: 'noul' | 'choice' | 'score',   // 默认 noul
  options?: string[],       // type=choice 时必填（≥2）
  levels?: string[],        // type=score 时必填（≥2，从低到高）
  yes?: string,             // type=noul 时可选：什么算 YES（锐化校准）
  no?: string,              // type=noul 时可选：什么算 NO
  model?: string,           // 默认 jev-latest
})

注意事项¶

1. 适用场景：Jev 不生成文本，仅用于判断，不适合写代码或写文案等生成文本的任务。
2. Peer 依赖：宿主不会把捆绑的 @deepseek-ai/dsh-tools 注入插件的模块解析链。通过 link: 或本地路径接入源码时，需在插件目录内先跑一次 npm install 把 peer 物化。
3. 手动接线升级：已按方式三手写 insert 的 profile，不要再对它跑 dsh plugin add，否则会报 duplicate loader entry id 错误。