结构化决策引擎 Devin-AXIS/jev-dsh-decision

Jev DSH 决策引擎

为 Agent Harness 提供结构化决策能力。

把 TypeSafe AI 的 Jev 决策能力接入你的 Agent：帮你选工具、选技能、选任务负责人，评估产出质量，并以结构化结果返回判断与概率。Jev 只辅助决策，原 Agent 继续负责规划和执行。

提供 DeepSeek Harness 原生插件和 iPolloWork 导入插件两个安装入口；在 iPolloWork 中可供 OpenCode、DeepSeek Harness、Codex Harness 使用。同一份决策核心，不改引擎源码，不接管主 Agent。

快速开始：安装到 DeepSeek Harness · 安装到 iPolloWork

支持与接入方式

| 使用环境 | 接入方式 | 安装入口 |
| DeepSeek Harness（DSH） | 原生插件，独立运行，不依赖 iPolloWork | DSH 插件命令 |
| iPolloWork | 独立导入、授权、启停与卸载 | 扩展 → 导入插件包 |
| OpenCode | 通过 iPolloWork 的扩展接口使用 Jev | 在 iPolloWork 安装一次 |
| Codex Harness | 通过 iPolloWork 的扩展接口使用 Jev | 在 iPolloWork 安装一次 |

OpenCode 和 Codex Harness 目前支持的是 iPolloWork 内的接入方式，本仓库还没提供它们各自的独立原生安装包。其他 Harness 可以基于共享决策核心开发适配器，但不代表已经自动兼容。

核心能力

- 根据任务，在当前真实可用且获准使用的工具、技能、智能体之间推荐选择。
- 按明确标准评分、判断是否需要某项能力；独立问题可以一次批量评估。
- 返回选择、概率、置信度与用量；不执行推荐动作，也不自动切换模型或路由所有请求。
- 提供本地配置检查和真实连接测试。连接测试会产生少量 TypeSafe API 用量。

Jev 是 TypeSafe AI 的结构化决策模型，不是聊天模型。原 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 技能。连接测试会产生少量 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 注册表，检查加载和卸载。

来源与标识

- TypeSafe AI 官方 API 文档
- DSH 官方插件开发文档
- 图标原样取自 TypeSafe 官方文档的黑色透明底图标，安装包内嵌以便离线显示，未使用粉色版本。图标及品牌权利归原权利人所有。

本项目由 iPolloWork 维护和发布。Jev 属于 TypeSafe AI；本项目不表示获得 TypeSafe AI、DeepSeek 或其他 Harness 项目的官方背书。