证据门禁 cwjechw98-lang/jev-gates

JEV Gates

在“完成”之前先有证据。为 DeepSeek Harness 提供六款工具和八项技能，并配备可移植的 Node.js 验证核心。

Русский · 用户指南 · 实现状态 · MIT

JEV Gates 帮助智能体检查完成情况、选择技能、发现重复尝试、审查有界变更、规划上下文缩减，并解释不确定的结果。确定性检查在代码中运行。在支持的情况下，由 JEV 评判器回答范围狭窄的语义问题。模型的观点不会把缺失的证据变成已核实的事实，也不会授予行动的许可。

它能做什么

| DSH 工具 | 用途 | 边界 |
| jev_verify_completion | 根据已收集的证据检查必需的标准 | 缺失的观察结果仍为未核实 |
| jev_route_skill | 选择适用的现有技能 | 它不会创建技能或权限 |
| jev_check_progress | 检测重复并建议下一步 | 它需要有意义的历史运行记录 |
| jev_review_scope | 根据范围狭窄的评分标准审查所提供的材料 | 它不是完整的仓库审计 |
| jev_context_plan | 生成带有恢复映射的缩减计划 | 仅预览；不进行实时上下文压缩 |
| jev_diagnose | 解释结果并确定下一个实验 | 诊断只是建议 |

这六款工具都是建议性的。一个独立的原生 DSH 适配器控制审批检查和 Stop 引导。它的模式有 off、shadow 和 enforce；工具插件使用 off、advisory 和 shadow。强制执行不能覆盖另一个防护的拒绝。

原有的审批、完成、评分标准评估、日志和重放命令仍然可用。这八项技能教授这六款工具以及审批和评分标准工作流；它们不是八款独立的工具。

离线试用

需要 Node.js 18 或更高版本。从仓库根目录运行；此示例不需要 API 密钥或安装依赖。

git clone https://github.com/cwjechw98-lang/jev-gates.git
cd jev-gates
node scripts/jev-gate.mjs --request examples/quickstart.json --collect examples/demo-project/reports/test-fix.md --offline --no-journal --json

预期：done，退出码 0。这仅证明示例报告存在且非空。它并不证明某个 bug 已被修复。

在不收集该文件的情况下运行同一请求：

node scripts/jev-gate.mjs --request examples/quickstart.json --offline --no-journal --json

预期：unverified，退出码 3。请求中指明某个文件，并不构成收集器读取了该文件的证据。

在 DeepSeek Harness 中使用它

该集成已使用 DSH 0.1.5-rc.2 和 Node.js 24.14.0 进行验证。与其他 DSH 版本的兼容性需要另行检查。
按照安装指南创建专用配置文件、预览安装并加载插件。产品安装程序是 scripts/jev-install.mjs；较旧的 adapters/dsh/install.mjs 处理的是另一条集成路径。

安装程序会复制技能并写入配置文件补丁。插件路径指向此检出目录：请将其保留在原位。初始模式为：工具使用 advisory，原生适配器使用 shadow。模型/提供商配置是单独的步骤。

安装后的示例请求：

使用 jev_verify_completion 检查报告文件是否存在且非空。收集该文件，使用确定性判据，并设置 allowModel=false。展示证据及任何缺失的检查。

正确读取结果

| 完成结果 | 含义 | CLI 退出码 |
| done | 所需判据在所提供的证据上通过 | 0 |
| not_done | 某项所需判据未通过 | 1 |
| review | 需要人工审查 | 2 |
| unverified | 证据不足 | 3 |

DSH 工具返回一个信封：顶层的 success 表示已产生结果。对于完成情况，检查 decision.completionStatus；同时读取证据、原因代码和模型使用情况。actionAuthority: none 表示该工具不授予任何权限。

已演示的内容

所记录的验收演练了一个真实的 DSH 代理循环，包含脚本化提供商、工具分派、审批处理和 Stop 引导。全部六个工具均在代理目录中被观察到；jev_route_skill 实际上是通过该注册表执行的。其余五个工具有离线覆盖和目录检查。这并不能确立实时的 JEV 判断质量。

参见逐项能力状态和可选的实况试点。测试计数描述的是某一次特定运行，而非对正确性的保证。

node --test
Requires a locally installed compatible DSH; writes acceptance artifacts:
node scripts/jev-product-acceptance.mjs

限制

- 证据检查的范围仅与所声明的判据和所收集的材料一样广泛。
- 本地日志适用于检查和重放，而非防篡改证明。
- Stop 引导是对代理的指导，而非对终止的无条件否决。
- 上下文规划不会修改实时对话。
- 实时模型访问、凭据、可用性和成本取决于所选的提供商。离线验收不需要付费调用。
- 旧版 shell-hook 桥接在受测的 DSH 构建中存在已记录的局限；原生适配器使用不同的路径。

文档

- 用户指南与故障排除
- 俄语用户指南
- CLI 参考、证据模型、迁移
- DSH 集成细节、来源可追溯性
- 产品状态，实时试点

根据 MIT 许可授权。