Open Code Review

Open Code Review (OCR) 是一款由阿里巴巴集团孵化并开源的 AI 驱动代码审查 CLI 工具。经过内部两年、数万开发者及数百万缺陷识别的大规模验证，OCR 旨在解决通用 AI Agent 在代码审查中存在的“覆盖不全”、“位置漂移”及“效果不稳定”等核心痛点。它通过确定性工程与 Agent 动态决策的混合架构，提供具有行级精度的结构化审查意见，并无缝集成至 CI/CD 流水线及主流编程 Agent 中。

核心亮点：精准、稳定、高效

1. 确定性工程 × Agent 混合驱动

• 强约束工程逻辑：
  • 精准文件筛选：明确审查范围，过滤无关文件，确保重要改动零遗漏。
  • 智能文件打包：将关联文件（如多语言资源文件）归并为同一审查单元，采用分治策略隔离上下文，天然支持高并发审查，提升超大变更场景下的稳定性。
  • 精细化规则匹配：基于模板引擎匹配文件特征与审查规则，聚焦模型注意力，规避噪声干扰。
  • 独立定位与反思组件：系统性地校正 AI 反馈的行号与文件路径，大幅提升位置准确性。
• Agent 动态决策优势：
  • 场景化提示词优化：深度定制审查场景 Prompt，平衡效果与 Token 消耗。
  • 专属工具集沉淀：基于海量线上数据分析，筛选出最稳定的工具调用组合，避免冗余与重复调用。

2. 行级精度与结构化输出

• 深度上下文理解：Agent 可读取完整文件、搜索代码库及检查关联变更，而非仅依赖 Diff 片段。
• 结构化审查意见：生成包含确切文件路径、行号、问题描述及修复建议的结构化报告，便于自动化处理与人工复核。

3. 高并发与灵活部署

• 并发审查：支持配置最大并发数（默认 8），显著缩短大规模 PR/MR 的审查时间。
• 多模型兼容：只需配置一个 LLM 端点（支持 Claude, OpenAI, DeepSeek 等兼容接口），即可快速启动。
• CI/CD 友好：支持 JSON 格式输出，轻松集成至 GitHub Actions、GitLab CI 等流水线，实现自动化代码门禁。

快速开始

1. 安装 OCR CLI

方式 A：NPM 安装（推荐）

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

方式 B：二进制下载

# macOS (Apple Silicon)
curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-darwin-arm64
chmod +x ocr && sudo mv ocr /usr/local/bin/ocr

# Linux (x86_64)
curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-linux-amd64
chmod +x ocr && sudo mv ocr /usr/local/bin/ocr

# Windows (x86_64)
curl -Lo ocr.exe https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-windows-amd64.exe
# 将 ocr.exe 移至 PATH 目录

2. 配置 LLM

交互式配置：

ocr config set llm.url https://api.anthropic.com/v1/messages
ocr config set llm.auth_token your-api-key-here
ocr config set llm.model claude-opus-4-6
ocr config set llm.use_anthropic true

或通过环境变量：

export OCR_LLM_URL=https://api.anthropic.com/v1/messages
export OCR_LLM_TOKEN=your-api-key-here
export OCR_LLM_MODEL=claude-opus-4-6

3. 开始审查

cd your-project

# 审查工作区所有变更
ocr review

# 审查分支差异
ocr review --from main --to feature-branch

# 审查单个提交
ocr review --commit abc123

集成生态

1. 集成至编程 Agent

• Claude Code Plugin：

  /plugin marketplace add alibaba/open-code-review
  /plugin install open-code-review@open-code-review
  # 使用斜杠命令
  /open-code-review:review
  

• Skills 注册表：

  npx skills add alibaba/open-code-review --skill open-code-review
  

2. 集成至 CI/CD

在 GitHub Actions 或 GitLab CI 中，使用 JSON 输出格式以便脚本解析：

ocr review \
  --from "origin/main" \
  --to "origin/feature-branch" \
  --format json

常用命令

Open Code Review 代表了 AI 代码审查从“玩具演示”走向“工业级应用”的重要一步。通过引入确定性工程约束，它有效解决了大模型在代码审查中的不可控性问题，提供了精准、稳定且高效的审查体验。