Jev DSH 决策引擎
为 Agent Harness 提供结构化决策能力。
将 TypeSafe AI 的 Jev 决策能力接入你的 Agent:帮助选择工具、Skill 和任务负责人,评估产出质量,并以结构化结果返回判断与概率。Jev 负责辅助决策,原 Agent 继续负责规划和执行。
提供 DeepSeek Harness 原生插件和 iPolloWork 导入插件两个安装入口;在 iPolloWork 中可供 OpenCode、DeepSeek Harness、Codex Harness 使用。同一份决策核心,不修改引擎源码,不接管主 Agent。
Jev / TypeSafe AI
快速开始:安装到 DeepSeek Harness · 安装到 iPolloWork
支持与接入方式
| 使用环境 | 接入方式 | 安装入口 |
|---|
| DeepSeek Harness(DSH) | 原生插件,独立运行,不依赖 iPolloWork | DSH 插件命令 |
| iPolloWork | 独立导入、授权、启停与卸载 | 扩展 → 导入插件包 |
| OpenCode | 通过 iPolloWork 的扩展接口使用 Jev | 在 iPolloWork 安装一次 |
| Codex Harness | 通过 iPolloWork 的扩展接口使用 Jev | 在 iPolloWork 安装一次 |
OpenCode 和 Codex Harness 当前支持的是 iPolloWork 内的接入方式,本仓库尚未提供它们各自的独立原生安装包。其他 Harness 可以基于共享决策核心开发适配器,不代表已经自动兼容。
核心能力
- 根据任务,在当前真实可用且获准使用的工具、Skill、Agent 之间推荐选择。
- 按明确标准评分、判断是否需要某项能力;独立问题可以一次批量评估。
- 返回选择、概率、置信度与用量;不执行推荐动作,也不自动切换模型或路由所有请求。
- 提供本地配置检查和真实连接测试。连接测试会产生少量 TypeSafe API 用量。
Jev 是 TypeSafe AI 的结构化决策模型,不是聊天模型。原 Agent 继续负责规划、解释、参数构造、工具执行和原生子 Agent 协作。Jev 不返回文字推理过程,Agent 的解释不能冒充 Jev 的原始输出。
安装到 DeepSeek Harness
适合直接使用 DSH 的用户。无需安装或运行 iPolloWork。
1. 安装插件
已安装 DSH 后,克隆本仓库,通过本地绝对路径安装:
git clone https://github.com/Devin-AXIS/jev-dsh-decision.git
dsh plugin add /absolute/path/jev-dsh-decision
把 /absolute/path/jev-dsh-decision 替换成克隆目录的实际绝对路径。插件使用原生 dsh.bundle 格式,无需构建源码。
如果已经拿到 .tgz 安装包,也可以直接安装:
dsh plugin add /absolute/path/dsh-jev-decision-model-0.1.2.tgz
2. 配置授权
在 DSH 的凭据管理或启动环境中配置自己的 TYPESAFE_API_KEY。不要把密钥写进插件源码或聊天记录。插件复用 DSH 的 credentials、tools 和 skills 服务;官方默认配置提供这些服务,自定义配置需要保留它们。
3. 验证并使用
重启运行中的 DSH 会话,让新配置生效,然后在对话中说:
使用 Jev,先检查配置,再测试连接。
插件提供 jev_status(本地状态)、jev_check_connection(真实连接测试)、jev_evaluate(结构化评估)三个工具,以及 jev-decision Skill。连接测试会产生少量 TypeSafe API 用量;本地显示“已配置”不代表密钥已经验证。
卸载
dsh plugin remove dsh-jev-decision-model
DSH 凭据由宿主统一持有,插件卸载不会擅自删除可能被其他插件共用的 TYPESAFE_API_KEY;不再需要时请在 DSH 凭据管理或环境中移除。运行中的 DSH 会话应重启以加载新的插件配置。
安装到 iPolloWork
适合使用 Work 图形界面的用户。在 Work 中安装一次,供其支持的 OpenCode、DeepSeek Harness、Codex Harness 引擎使用,无需分别安装三个包。
1. 导入安装包
获取已签名的 jev-decision-model-0.1.2.ipollowork-plugin 安装包,在 扩展 → 导入插件包 中选择它,确认发布者为 iPolloWork。维护者的安装包构建方式见下方“开发和测试”。
已安装旧版时,导入新版可沿用原插件身份升级。显示名称为“Jev DSH 决策引擎”,内部插件 ID jev-decision-model 和 DSH 包名 dsh-jev-decision-model 保持不变。
**客户端要求:**需要包含 ipollowork/ipollowork-2026 官方签名公钥注册的 Work 版本。未包含此注册的旧客户端会拒绝导入;仅满足清单里的最低版本号不够。请勿绕过签名校验。
2. 配置授权
打开插件详情中的授权入口,填写自己的 TypeSafe API Key。密钥由 Work 的插件授权仓库保存,不需要发给对话中的 Agent。
3. 验证并使用
在对话中启用“Jev DSH 决策引擎”,然后说:
使用 Jev,先检查配置,再测试连接。连接成功后,帮我选择适合当前任务的 Skill。
Work 提供 status、check-connection、evaluate 三个动作,由现有扩展接口调用。这里的“测试连接”会发出一个真实且有少量用量的请求。
卸载
在 扩展 → Jev DSH 决策引擎 → 卸载 中移除。Skill、插件内容和专属授权由 Work 随包清理,没有另装全局脚本或后台守护进程;卸载不会删除 TypeSafe 云端账户。
对话示例
- “用 Jev 判断这项任务需要哪些已安装的 Skill,再由你执行。”
- “从当前可用的 Agent 中,选出最适合负责竞品分析的一个。”
- “按准确性、完整性和清晰度评估这份结果;不确定的部分交给我确认。”
推荐结果不等于执行授权。需要外部操作时,仍遵循当前 Harness 的权限和确认流程。
开发者参考:调用格式、签名与测试
调用格式
evaluate 与 jev_evaluate 使用相同参数:
{
"state": { "task": "为已收集的竞品资料制作汇报", "available": ["research", "slides"] },
"questions": {
"owner": {
"type": "choice",
"instructions": "哪个已提供的 Agent 最适合负责最终交付?",
"criteria": { "research": "负责资料分析", "slides": "负责演示文稿" }
},
"need_review": { "type": "noul", "instructions": "这个任务是否需要审稿?" },
"clarity": { "type": "score", "instructions": "任务要求是否清楚?", "criteria": ["不明确", "部分明确", "明确"] }
}
}
问题类型是 choice(单选)、score(等级评分)、noul(是的概率)。多个互补 Skill 可使用多个独立 noul 问题。传入最小必要上下文,不传密钥或无关私密资料。网络固定发往 https://api.typesafe.ai/v1/systemone;默认模型 jev-latest。
插件限制每次 64 个问题、256 KiB 请求、1 MiB 响应、20 秒总网络时限;仅对 429/529 最多重试两次。没有无限重试、后台自动学习或全局请求拦截。错误会脱敏,不返回上游错误正文。
开发和测试
Node >=20.11,pnpm;运行时零第三方依赖。JSZip 仅用于开发时构建 Work 包。
pnpm install --frozen-lockfile
pnpm test
DSH_RUNTIME_ROOT=/path/to/dsh-runtime pnpm test:dsh
pnpm package:dsh
DSH_RUNTIME_ROOT=/path/to/dsh-runtime DSH_CLI_TEST=1 pnpm test:dsh
Work 包使用宿主要求的 Ed25519 签名格式。私钥放在仓库之外,不随源码、安装包或发布附件分发:
IPOLLOWORK_PLUGIN_SIGNING_KEY=/secure/path/ipollowork-ed25519.pem \
IPOLLOWORK_PLUGIN_KEY_ID=ipollowork-2026 pnpm package:work
IPOLLOWORK_ROOT=/path/to/updated/iPolloWork pnpm test:work
pnpm package:dsh
签名标识为 ipollowork/ipollowork-2026,公钥(SPKI DER,Base64):
MCowBQYDK2VwAyEAoHA9xxXNZPQ7y+AKpDBIXruNvwVasq7axjilzIY6RDE=
Work 集成测试使用真实宿主 API,在独立临时目录测试签名、图标、导入、授权轮换、服务调用、卸载及篡改拒绝。TypeSafe 响应使用明确的测试数据,不代表真实 API 密钥已验证。DSH 测试使用真实工具与 Skill 注册表,检查加载和卸载。
来源与标识
本项目由 iPolloWork 维护和发布。Jev 属于 TypeSafe AI;本项目不表示获得 TypeSafe AI、DeepSeek 或其他 Harness 项目的官方背书。