OpenCodeReview：AI 代码审查 CLI 工具

项目简介

Open Code Review 是一款 AI 驱动的代码审查 CLI 工具，源自阿里巴巴集团内部官方 AI 代码审查助手。过去两年间，它服务了数以万计的开发者，发现数百万个代码缺陷；经过大规模验证后，现已孵化并开源。只需配置一个模型端点即可开始使用。

它读取 Git diff，把变更文件通过具备工具调用能力的 Agent 交给可配置的 LLM，并生成结构化、行级精度的审查意见。Agent 可以读取完整文件内容、搜索代码库、查看其他变更文件以获取上下文，从而给出深入审查，而不是停留在 diff 表面的反馈。除 diff 审查之外，ocr scan 还能对整个文件进行审查，适合审计陌生代码库或没有有意义 diff 的目录。

主要功能

确定性工程与 Agent 的混合架构

纯粹的纯语言驱动架构无法对审查流程形成硬性约束，容易导致覆盖不完整、位置漂移、质量不稳定。Open Code Review 让确定性工程与 Agent 各司其职：

• 精确文件选择：确定哪些文件需要审查、哪些需要过滤，避免遗漏重要变更。
• 智能文件打包：把相关文件归入同一个审查单元（例如 message_en.properties 与 message_zh.properties 捆绑在一起），每个 bundle 作为上下文隔离的子 Agent 运行，分而治之，在超大变更集上依然稳定，并天然支持并发审查。
• 细粒度规则匹配：按文件特征匹配审查规则，把模型的注意力集中到必要信息上，消除噪声；相比纯语言驱动的规则引导，基于模板引擎的规则匹配更稳定、更可预期。
• 独立定位与反思模块：独立的评论定位与评论反思模块，系统性地提升 AI 反馈的位置准确度与内容准确度。
• 场景调优的 Prompt 与工具集：Prompt 模板针对代码审查深度优化；工具集基于大规模生产数据中的工具调用轨迹分析（调用频率分布、单工具重复率、新工具对整体调用链的影响）蒸馏而来，比通用 Agent 工具包更稳定可预期。

Benchmark

基于 50 个热门开源仓库、200 个真实 Pull Request、10 种编程语言构建的真实代码审查基准，并由 80+ 位资深工程师交叉验证（1,505 条标注的真实问题）。在相同底层模型下，Open Code Review 相比通用 Agent（Claude Code）取得显著更高的 Precision 与 F1，token 消耗仅约 1/9，审查速度更快；其 Recall 低于通用 Agent，这是为了少报噪声而做出的有意取舍。

命令能力

• 工作区模式：审查全部已暂存、未暂存与未跟踪的变更。
• 分支区间：审查特性分支自与 main 分叉以来的变更（merge-base 模式）。
• 单次提交审查。
• 中断后恢复：ocr session list 查看会话，--resume 继续。
• 整文件扫描：ocr scan 审查整个仓库、指定目录或文件，无需 Git 历史。
• JSON 输出，便于被 AI 宿主 Agent 消费。
• 委派模式（Delegation Mode）：由你自己的 AI 编码 Agent 执行审查，OCR 只负责文件选择与规则解析，无需配置 LLM。

安装与使用

前置条件

• Git >= 2.41：Open Code Review 依赖 Git 完成 diff 生成、代码搜索与仓库操作。

安装

npm install -g @alibaba-group/open-code-review

安装后即可全局使用 ocr 命令。其他安装方式（安装脚本、GitHub Release 二进制、源码构建）见官方 Installation 文档。

配置 LLM

审查代码前必须配置 LLM，除非使用 Delegation Mode：

ocr config provider          # 选择内置供应商或添加自定义供应商
ocr config model             # 为当前供应商选择模型

交互式界面会引导你完成供应商选择、API Key 输入与模型配置，并自动测试连通性。

开始审查

cd your-project

# 工作区模式 —— 审查所有已暂存、未暂存和未跟踪的变更
ocr review

# 分支区间 —— 审查 feature-branch 自与 main 分叉以来的变更（merge-base 模式）
ocr review --from main --to feature-branch

# 单次提交
ocr review --commit abc123

# 恢复中断的区间或提交审查
ocr session list
ocr review --from main --to feature-branch --resume <session-id>

# 整文件扫描 —— 审查整个文件而非 diff（无需 Git 历史）
ocr scan                          # 扫描整个仓库
ocr scan --path internal/agent    # 扫描目录或指定文件
ocr scan --resume <session-id>   # 恢复中断的整文件扫描

# 将结果保存到文件（推荐给 AI 宿主 Agent 使用）
ocr review --format json --output result.json

# 委派模式 —— 让你的 AI 编码 Agent 自行执行审查
# OCR 负责文件选择与规则解析，无需配置 LLM
ocr delegate preview
ocr delegate rule src/main.go src/handler.go

注意事项

• 使用前请确认 Git 版本不低于 2.41。
• 除非使用 Delegation Mode，否则必须先完成 LLM 供应商与模型配置。
• 设计上偏向高精确率：Recall 低于通用 Agent，这是为减少误报而做的有意取舍，需要权衡漏报风险时请留意。
• 支持 Windows、macOS、Linux；许可证为 Apache-2.0。

---

本作品整理自 GitHub 开源项目 alibaba/open-code-review，原作者 @alibaba，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。