BetterZflyee/dsh-jev-adapter

dsh-jev-adapter

将 Jev（System One）决策模型范式与任何 OpenAI 兼容的 LLM 配合使用——无需 TypeSafe API 密钥。在 DeepSeek Harness (dsh) 上注册一个 jev_decide 工具。

Jev（TypeSafe AI）是一个决策模型：你发送一个状态以及带类型的问题（选择 / 评分 / 布尔），它会返回经过校准的、按概率分布的答案——不生成文本。本插件将这一范式带给你已有的任何聊天模型，并且如果你有密钥，也可以与真正的 Jev API 通信。

为什么

- zhangxaochen/dsh-jev（值得一看）集成了官方 TypeSafe API——如果你有密钥并且能访问 api.typesafe.ai，那就很棒。
- 本插件覆盖其他所有人：任何 OpenAI 兼容的端点都可以——DeepSeek 自己的 API、Ollama、vLLM、OpenRouter、SiliconFlow、LM Studio，或气隙隔离的内部网关。
- openai 通道上的概率是模型自我报告的估计值（并非数学上校准的——每个结果都带有这一说明）。在 typesafe 通道上，你得到的是真正的东西。

你能得到什么

一个工具，jev_decide，可由 agent 调用：

| 问题类型 | 你提供 | 你得到 |
|---|---|---|
| choice | 选项映射（≤255） | 选中的选项 + 完整概率分布 + 置信度 |
| score | 有序等级（2–10） | 分数值 + 各等级概率 + 置信度 |
| boolean | 一个陈述 | P(true) |

在一次调用中提出许多问题——1 个问题和 10 个问题的成本差不多。

安装

dsh plugin --profile  add github:BetterZflyee/dsh-jev-adapter
or, once published on npm:
dsh plugin --profile  add dsh-jev-adapter

然后设置一个环境变量并重启 dsh：

openai channel (default) — point at any OpenAI-compatible endpoint
export JEV_OPENAI_API_KEY="sk-..."
optional overrides:
export JEV_BASE_URL="https://api.deepseek.com/v1"   # or Ollama/vLLM/OpenRouter/...
export JEV_MODEL="deepseek-chat"

或者在 cordis.patch.yml 中配置，而不是使用环境变量（见下文）。

配置

所有设置都位于 cordis.patch.yml 中的插件行：

- id: dsh-jev-adapter
name: dsh-jev-adapter
config:
channel: openai          # "openai" (default) | "typesafe"
---- openai channel ----
baseURL: https://api.deepseek.com/v1     # any OpenAI-compatible endpoint
apiKey: sk-...                            # or env JEV_OPENAI_API_KEY / OPENAI_API_KEY
model: deepseek-chat
---- typesafe channel (real Jev) ----
channel: typesafe
apiKey: ...                              # or env JEV_TYPESAFE_API_KEY / TYPESAFE_API_KEY
model: jev-latest
---- shared ----
maxTokens: 4000
timeoutMs: 120000
retries: 3

使用

只需与你的 agent 交谈——它会决定何时调用该工具：

把这 12 条支持工单分类：部门 + 紧急度 + 客户情绪。

Agent 把所有判断作为类型化问题在一次 jev_decide 调用中发送，并拿回一张概率表。

基于置信度路由（整个范式的核心）：

置信度 ≥ 0.85  → 自动执行
0.5 – 0.85     → 起草，请人工确认

dsh-jev-adapter（中文）

把 Jev（System One）决策模型范式套在任何 OpenAI 兼容的 LLM 上——不需要 TypeSafe API key。在 DeepSeek Harness (dsh) 上注册一个 jev_decide 工具。

Jev（TypeSafe AI）是决策模型：发一段状态加一组类型化问题（choice / score / boolean），返回带概率分布的结构化答案——不生成文字。本插件把这个范式带到你已有的任意聊天模型上；如果你有 key，也可以直连真 Jev。

为什么做这个

- zhangxaochen/dsh-jev（推荐一看）对接的是 官方 TypeSafe API——有 key 且能访问 api.typesafe.ai 时很好。
- 本插件覆盖其他人：任何 OpenAI 兼容端点都能跑——DeepSeek 官方 API、Ollama、vLLM、OpenRouter、硅基流动、LM Studio、或内网网关。
- openai 通道的概率是模型自述的估计值（非数学校准，每个结果都带此提示）；typesafe 通道给你真货。

你得到什么

一个工具 jev_decide，Agent 可直接调用：

| 问题类型 | 你提供 | 返回 |
|---|---|---|
| choice | 选项映射（≤255 项） | 选中的选项 + 完整概率分布 + 置信度 |
| score | 有序等级（2–10 级） | 分数 + 各等级概率 + 置信度 |
| boolean | 一个陈述 | P(为真) |

一次调用可以并行问多个问题——问 1 个和问 10 个代价几乎一样。

安装
bash
dsh plugin --profile  add github:BetterZflyee/dsh-jev-adapter
npm 发布后也可以：
dsh plugin --profile  add dsh-jev-adapter

设一个环境变量后重启 dsh：
bash
openai 通道（默认）—— 指向任意 OpenAI 兼容端点
export JEV_OPENAI_API_KEY="sk-..."
可选覆盖：
export JEV_BASE_URL="https://api.deepseek.com/v1"   # 或 Ollama/vLLM/OpenRouter/...
export JEV_MODEL="deepseek-chat"

也可以在 cordis.patch.yml 里配置（见英文节的 Configure）。

使用

直接跟 Agent 说话，它自己决定何时调用：

把这 12 条工单分类：部门 + 紧急度 + 客户情绪
Agent 会把所有判断作为类型化问题放进一次 jev_decide 调用，拿到一张概率表。

按置信度路由（这套范式的意义所在）：

confidence ≥ 0.85  → 自动执行
0.5 – 0.85         → 生成草稿，请人确认
< 0.5              → 转人工

阈值按操作风险调；记住提示：openai 通道的概率是自述值，不是校准值。

值得知道的细节

- 诚实性提示词。适配器明确要求模型不确定时如实分散概率、不要硬给 1.0——没有这条，置信度会饱和，路由信号失效（在真实中文工作事项上验证过，见 lib/adapter.js）。
- 思考模型兼容。content 为空、答案在 reasoning_content 的模型已处理。
- 归一化。概率之和不为 1 时重新归一化；全零答案退化为均匀分布而不是报错。
- 重试。429/5xx 指数退避重试（默认 3 次）。

与其他 Jev 插件的关系

| | zhangxaochen/dsh-jev | 本插件 |
|---|---|---|
| 真 TypeSafe Jev | ✅ | ✅（typesafe 通道） |
| 任意 OpenAI 兼容 LLM | ❌ | ✅（默认） |
| 工具剪枝 / 死循环阻断 / 安全门禁 | ✅ | ❌（定位不同） |

互补关系：要护栏套件 + 真 Jev 用他的；要在任意模型上用决策范式用本插件。

许可证

MIT