Skip to content

About

Jev DSH 决策引擎|面向 Agent Harness 的结构化决策插件。原生支持 DeepSeek Harness,通过 iPolloWork 支持 OpenCode、Codex Harness。

Topics

Resources

Stars

254 stars

Watchers

29 watching

Forks

Repository files navigation

Jev DSH 决策引擎

iPolloWork Plugin DeepSeek Harness Plugin OpenCode Plugin Codex Harness Plugin

为 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 项目的官方背书。

About

Jev DSH 决策引擎|面向 Agent Harness 的结构化决策插件。原生支持 DeepSeek Harness,通过 iPolloWork 支持 OpenCode、Codex Harness。

Topics

Resources

Stars

254 stars

Watchers

29 watching

Forks

Releases

Packages

Contributors

Languages