Devin-AXIS / jev-dsh-decision

# Jev DSH 决策引擎
**为 Agent Harness 提供结构化决策能力。**
将 TypeSafe AI 的 Jev 决策能力接入你的 Agent：帮助选择工具、Skill 和任务负责人，评估产出质量，并以结构化结果返回判断与概率。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 可以基于共享决策核心开发适配器，不代表已经自动兼容。
## 核心能力
- 根据任务，在**当前真实可用且获准使用**的工具、Skill、Agent 之间推荐选择。
- 按明确标准评分、判断是否需要某项能力；独立问题可以一次批量评估。
- 返回选择、概率、置信度与用量；**不执行推荐动作，也不自动切换模型或路由所有请求**。
- 提供本地配置检查和真实连接测试。连接测试会产生少量 TypeSafe API 用量。
Jev 是 TypeSafe AI 的结构化决策模型，不是聊天模型。原 Agent 继续负责规划、解释、参数构造、工具执行和原生子 Agent 协作。Jev 不返回文字推理过程，Agent 的解释不能冒充 Jev 的原始输出。
## 安装到 DeepSeek Harness
适合直接使用 DSH 的用户。**无需安装或运行 iPolloWork。**
### 1. 安装插件
已安装 DSH 后，克隆本仓库，通过本地绝对路径安装：
 [code] 
把 `/absolute/path/jev-dsh-decision` 替换成克隆目录的实际绝对路径。插件使用原生 `dsh.bundle` 格式，无需构建源码。
如果已经拿到 `.tgz` 安装包，也可以直接安装：
 [code] 
### 2. 配置授权
在 DSH 的凭据管理或启动环境中配置自己的 **`TYPESAFE_API_KEY`**。不要把密钥写进插件源码或聊天记录。插件复用 DSH 的 `credentials`、`tools` 和 `skills` 服务；官方默认配置提供这些服务，自定义配置需要保留它们。
### 3. 验证并使用
重启运行中的 DSH 会话，让新配置生效，然后在对话中说：
> 使用 Jev，先检查配置，再测试连接。
插件提供 `jev_status`（本地状态）、`jev_check_connection`（真实连接测试）、`jev_evaluate`（结构化评估）三个工具，以及 `jev-decision` Skill。连接测试会产生少量 TypeSafe API 用量；本地显示“已配置”不代表密钥已经验证。
### 卸载
 [code] 
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` 使用相同参数：
 [code] 
问题类型是 `choice`（单选）、`score`（等级评分）、`noul`（是的概率）。多个互补 Skill 可使用多个独立 `noul` 问题。传入最小必要上下文，不传密钥或无关私密资料。网络固定发往 `https://api.typesafe.ai/v1/systemone`；默认模型 `jev-latest`。
插件限制每次 64 个问题、25