Open Code Review教程:34.8k星阿里AI代码审查,确定性管道+LLM混合架构

📌 项目:alibaba/open-code-review | 星数:34.8k(Go,Apache-2.0)| 日期:2026-09-18 | 今日 GitHub Trending +3,286 | 来源:GitHub | Trending详情

📋 项目简介

Open Code Review(命令ocr,34.8k星,Apache-2.0,Go)是阿里Aone团队把内部跑了两年、服务数万开发者、识别数百万缺陷的官方AI审查助手开源出来的产物。它读Git diff→按规则智能打包变更文件→分发给带工具能力的LLM子代理→输出行级精确评论。站内已有深度评测(8.9/10),本文是使用教程角度的补充。

📊 核心特性

特性说明
确定性管道×LLM混合文件选择/打包/规则匹配/评论定位等必须不出错的环节用确定性工程保证,agent只做动态决策
智能文件打包相关文件打成bundle(如中英文资源文件),每bundle一个隔离子代理,分治+并发
AACR-Bench实测50仓/200真实PR/10语言/1505标注问题,同模型下Precision和F1超Claude Code,token约1/9
委托模式免key编码代理用自己的LLM审查,OCR管文件选择与规则解析,无需OCR API key
四CI+五代理插件GitHub Actions/GitLab CI/Gerrit/GitFlic + Claude Code/Codex/Cursor/OpenCode/QCA插件

⚡ 安装与运行

# 前提:Git >= 2.41
npm install -g @alibaba-group/open-code-review   # 装出 ocr 命令
ocr config provider    # 交互式选LLM提供商,自动测连通
ocr config model       # 选模型

cd your-project
ocr review                                        # 工作区模式:staged+unstaged+untracked全审
ocr review --from main --to feature-branch        # 分支范围
ocr scan                                          # 全文件扫描(陌生代码库)

💡 使用建议

📚 常见问题

Open Code Review和让Claude Code直接审代码有什么区别?

区别在混合架构:文件选择/打包/规则匹配/评论定位等必须不出错的环节用确定性工程保证,agent只做动态决策。解决通用agent审代码的覆盖不全、位置漂移、质量不稳三大痛点。AACR-Bench实测同模型下Precision和F1显著高于Claude Code,token约1/9。

委托模式是什么?不配API key也能用吗?

能。委托模式(ocr delegate)下编码代理(Claude Code/Codex/Cursor等)用自己的LLM执行审查,OCR只管文件选择与规则解析,无需OCR API key。默认模式则由OCR用你配置的LLM跑审查。

能集成到CI/CD吗?

可以。官方支持GitHub Actions、GitLab CI、Gerrit、GitFlic四种CI集成。编码agent侧有Claude Code/Codex/Cursor/OpenCode/QCA五个插件。还支持MCP Server扩展、Session Viewer回放、OpenTelemetry遥测。