用途:在 git push 之前审查当前改动,包括未推送的提交和所有未提交文件(含未跟踪文件);也可审查整个仓库、指定分支或 Pull Request。
主要能力:对冻结的改动副本运行与文件类型匹配的确定性扫描器,仅保留变更行上的报告;随后启动独立的审查进程(Claude Code 或 Codex),读取该副本、核对每条扫描发现、按固定格式作答,再由脚本校验并打印一份报告。报告包含判定结果、发现的严重级别/类别/位置和覆盖率。退出码 0 表示无阻塞,1 表示结论为 blocked,2 表示没有完整审查。
使用方式:常用命令为 npx -y openqodex@0.12.0 review,审查分支用 npx -y openqodex@0.12.0 review feature/login,审查 PR 用 npx -y openqodex@0.12.0 review '#42'。若存在 ~/.openqodex/bin/openqodex 则用它替代 npx 命令。报告位于 .openqodex/reviews/<time>-<id>/,含 report.html、report.md、report.json、report.sarif;.openqodex/latest.json 指向最新审查。findings 1,3 可打印指定发现的完整内容,review --all 审查整个仓库,guide 打印文档。
适用场景:推送前的代码安全检查、开发者请求审查改动、推送被钩子阻止或警告后、修复发现后复查。
限制:除开发者已有的 Claude Code 或 Codex 登录外无需密钥或账号,代码会发送给该登录所用的模型;除非在 ~/.openqodex/config.yaml 设置 reviewer_web: off,审查者还可联网搜索和打开网页。semgrep、osv-scanner、kubeconform、cargo-deny 会联网,--offline 会跳过它们。brakeman、rubocop、golangci-lint 需自备 Ruby 或 Go 运行时。无配置时仅警告不阻塞。审查中不得改代码,不得擅自运行 trust 或设置 OPENQODEX_SKIP。沙箱中首次运行可能无法下载扫描器,需在终端运行 doctor --install。