egma-ai/jev-code-reviewer

来源：https://github.com/egma-ai/jev-code-reviewer

Jev 代码审查工具

当前由AI代理生成的大多数PR（拉取请求）都被直接合并，因为当你的AI代理突然提交包含230个文件变更的请求时，人类心智难以理解。本工具旨在通过将每个变更分类为P0、P1、P2优先级来减轻认知负担。默认仅显示P0级别变更，优先级配置可调。差异对比同时以自然语言呈现，原始代码可通过切换按钮一键查看。它运行在你本地计算机上，用于审查你自身编码代理的PR，且不会向GitHub发布任何内容。

观看演示录屏（https://github.com/egma-ai/jev-code-reviewer/blob/main/docs/demo.mp4） · 打开演示PR（https://github.com/egma-ai/jev-code-reviewer/pull/1）。捆绑的录屏使用了真实的Jev分类和标注的解释说明副本（来源说明）。

快速演示

需要 Node.js 22+版本。

git clone https://github.com/egma-ai/jev-code-reviewer.git
cd jev-reviewer
npm install
npm run demo

打开 http://127.0.0.1:4731/demo 进行回放（无需调用提供商API），或加载下文扩展程序并打开演示PR的文件变更页面（https://github.com/egma-ai/jev-reviewer/pull/1/files）。

审查你自己的PR

需要已登录的 GitHub CLI（https://cli.github.com/）（通过 gh auth login）以及一个 origin 指向PR仓库的本地克隆。

npm link          # 添加 jev-reviewer 命令
jev-reviewer setup  # 在你自己的终端存储 TypeSafe 和 OpenAI 密钥
jev-reviewer doctor # 检查工具、密钥来源、本地服务器和提供商访问权限
jev-reviewer serve  # 保持运行
jev-reviewer analyze --pr https://github.com/OWNER/REPO/pull/123 --repo /path/to/clone

然后在 Chrome 中：

1. 打开 chrome://extensions，开启 开发者模式，点击 加载已解压的扩展程序，选择本仓库的 extension/ 文件夹。
2. 运行 jev-reviewer token | pbcopy。在扩展程序弹出窗口中，打开 连接，粘贴内容并点击 保存。状态应显示为 已配对。
3. 打开PR的 文件变更 页面（/pull//files）并开启 用逻辑说明替代代码。

可选：uv tool install graphifyy 可添加本地代码图谱以获得更好的上下文。要让编码代理在创建PR后自动运行 analyze，请安装 代理技能模块。

须知事项

• 你的代码不会离开本机。 analyze 命令会将变更代码及附近上下文发送给 TypeSafe 和 OpenAI。扩展程序仅与本地服务器 127.0.0.1:4731 通信。
• 密钥存储于 ~/.config/jev-reviewer/credentials.json（仅所有者可访问，未加密）。优于环境变量导出方式，因为编码代理的 shell 往往无法读取环境变量。使用 node scripts/setup-keys.mjs --replace-openai 可替换 OpenAI 密钥。
• 分析数量有限制。 按路径顺序分析前12个变更单元（差异块）；使用 --max-units 参数最多可分析100个单元。包含未分析变更的文件将保留GitHub原始代码，CLI和弹出窗口会显示具体数量。
• 仅支持经典文件变更页面。 GitHub新的 /changes 页面暂不支持；请在个人头像 → 功能预览 下切换回旧版。
• 旧报告不再显示。 如果PR有更新的提交，扩展会保留GitHub原始代码：重新运行 analyze，然后点击 刷新报告。
• 优先级代表关注程度，而非正确性。 P0文件默认展开；P1和P2默认折叠。可通过将 config/policy.json 复制到被审查仓库的 .jev-reviewer.json 中进行调整，或使用 --policy 参数指定。

开发相关

npm test
node scripts/test-extension.mjs  # 需要 Chromium 且端口4731空闲

详见架构文档、演示指南和扩展程序说明。

MIT 许可证。