JevDo
JevDo
The model is a tool now.
以 Jev 为调度核心的新一代 harness 架构。
Action 沉淀经验 · Jev 决定下一步 · 大模型只是选项之一
Just Jev it.
简体中文 · English
使用场景 · 快速开始 · 工作方式 · 实验结果
你的 Agent 能写出复杂的程序，却记不住自己昨天怎么启动它。 第十次打开同一个项目，它还在读配置、找脚本、拼命令，把上周已经走通的路再想一遍。JevDo 在调用大模型之前，先让 Jev 判断：这件事，是不是已经会了？已有操作能处理，就直接调度执行；遇到新问题，再交给主模型。主模型把值得复用的做法保存为 Action，经过验证，留给下一次会话。
接力长什么样
三个使用示例，假设项目已保存并验证了对应的 Action。
① 日常修 bug
“启动后台，修掉订单列表的分页 bug，跑完单测和构建再交给我。”
Jev 启动依赖与服务，检查就绪 [start-admin-backend]
↓
主模型 读 issue，定位并修复分页逻辑
↓
Jev 跑单测、构建，核对退出码与产物 [test-and-build]
↓
主模型 说明修改与验证结果
② CI 红了
“CI 的 lint 又挂了，本地复现修一下，确认能过。”
Jev 准备依赖，按 CI 配置复现 lint [repro-ci-lint]
↓
主模型 根据报错修改代码
↓
Jev 重跑 lint，再执行提交前检查 [verify-before-push]
↓
主模型 解释改动，给出 commit message
③ 准备发版
“走一遍发版流程：版本号、changelog、tag、构建产物。”
Jev 跑全量回归，检查发版条件 [regression-gate]
↓
主模型 读合并记录，更新版本号与 CHANGELOG
↓
Jev 按项目脚本打 tag、构建、校验产物 [cut-release]
↓
主模型 整理 release notes
Jev 调度重复操作，主模型处理新问题。 启动 → 代码修改 → 测试构建的完整交接已在实验中跑通。如果请求只是“启动项目”或“跑一遍回归”，已有 Action 能覆盖全部工作且满足完成条件时，Jev 可以独立完成，全程零次主模型调用。
一轮是怎么走的
- Jev：决定下一步。读取与主模型相同的已组装会话和工具历史，选择 Action、请求主模型、澄清或结束本次请求。
- Action：留下怎么做。命令或脚本，连同用途、项目绑定和验收方式，跨会话保留；简单操作直接保存命令，复杂行为更适合脚本。
- 主模型：解决新问题，积累新操作。写代码、做推理、处理异常，也在任务中主动维护 Action 库。
基于 DeepSeek Harness，早期版本优先支持 DSH 0.2.0-rc.1 的 headless 使用。包名和工具前缀保留 jevaction。主模型参与后，由它完成最终答复。
flowchart LR
U["任务与会话历史"] --> J{"Jev"}
J -->|已有 Action| A["Harness 执行与验收"]
J -->|新问题 / 异常| M["主模型"]
A --> H["结果回到共同历史"]
M -->|工具调用与结果| H
H --> J
M -.->|保存并验证| K[("Action 库")]
K -.->|候选操作| J
classDef judge fill:#ede8ff,stroke:#9b8deb,color:#302653
classDef model fill:#eef3ff,stroke:#5171ae,color:#162b50
class J judge
class M model
Jev 选择，代码执行。它只能选择当前可用的操作和参数，实际命令仍经过宿主工具权限与验收。实现发生变化、执行失败，或没有合适的操作时，工作交回主模型。
Action 怎么留下来
第一次，主模型读取项目，找到可复用的命令或脚本，通过 jevaction_create 保存用途、项目绑定和验收方式，再用 jevaction_validate 验证并激活。它会主动考虑保存稳定的开发操作，也遵守用户“不保存”的要求。
下一次，Jev 根据当前请求选择 Action 和项目，Harness 补全已保存的执行参数，运行并验收。操作成功不等于整个任务结束：还需要分析、修改或解释，就继续调用主模型。
同一个构建 Action 可以绑定不同项目的命令。实现脚本变化后，旧版本需要复核；测试针对的源码、报表读取的数据变化，则由验收检查当前结果。完整规则见 Action 规格 与 使用场景。
实测
四个重复开发任务：启动、测试构建、本地发布、回滚。所有组获得相同的现成脚本，Action 库从空开始。原生 DSH Loop 在同一最小 headless 宿主中每个任务测一次；JevDo 重复三轮，每轮新建会话、使用相同输入，并保留 Action 库。
| 每组 4 个任务 | 原生 Loop | JevDo 第 1 轮 | 第 2 轮 | 第 3 轮 |
|---|
| 主模型调用 | 31 | 33 | 8 | 8 |
| 无需主模型的任务 | 0/4 | 0/4 | 3/4 | 3/4 |
| 平均耗时 | 9.54 s | 19.52 s | 6.89 s | 6.64 s |
| 估算费用（含 Jev） | ¥0.2771 | ¥0.8408 | ¥0.3214 | ¥0.3091 |
表中为自主保存组。后两轮的主模型调用比原生对照减少约 74%；明确要求保存的另一组收益较弱。调用减少还没有转化为总体费用优势：冷启动需要积累，完整历史的 Jev 请求也有成本。
这些是自建小样本的一次采样，不是公开基准成绩。Jev 曾误选操作，随后由主模型完成任务；最终验收通过不代表每次判断都正确。完整报告 · 结果解释 · 原始轨迹
快速开始
需要 Node.js 24.14+。先运行不需要 API 密钥的跨会话复用演示：
git clone https://github.com/yinhong-zhou/jevdo.git
cd jevdo
npm ci
npm run demo
接入真实 Jev 与主模型，或替换自己的 DSH 默认 Loop，见 安装与配置。插件提供 Loop、Action 工具和维护提示；实际执行继续使用宿主工具。
文档与开发
配置与实现参考 · Action 规格 · 使用场景 · 反馈问题
npm run check
npm test
npm run build
当前可学习操作以固定命令和项目绑定为主，任意自由参数、完整 Web UI 和多 Agent 组合兼容性不在已验证范围内。核心入口见 src/dsh/index.ts，完整实现边界见 参考文档。
来源与协议
MIT。基于 DeepSeek Harness 的插件机制，并适配其官方 Loop 生命周期代码；上游版权与来源保留在 第三方声明 和 适配代码。
