open-code-review: OpenCodeReview – 为任何 Git 仓库提供 AI 驱动、行级精准的代码审查

open-code-review: OpenCodeReview – 为任何 Git 仓库提供 AI 驱动、行级精准的代码审查

OpenCodeReview – AI 驱动的代码审查 CLI

产品定义 – 一款命令行工具，允许您在任何 Git 仓库上运行基于 LLM 的代码审查器。它读取 diff（或整个文件），将相关代码片段发送给可配置的大语言模型，并返回结构化的行级注释。该项目源自阿里巴巴内部的代码审查助手，现已开源。

核心能力

  • 感知 Diff 的审查 – 解析 git diff 输出，精确选择变更文件，打包相关文件并提供给模型。
  • 全文件扫描 (ocr scan) – 在没有 Git 历史记录时，可以审计整个代码库。
  • 确定性工程层 – 通过硬编码的文件选择、打包、规则匹配和注释定位，保持审查的稳定性和精准度。
  • Agent 层 – 使用经过微调的提示词和小型专用工具集，使 LLM 能够检索额外上下文（完整文件内容、搜索仓库）并产生更深入的反馈。
  • 多模型支持 – 内置 Anthropic、OpenAI 等供应商；您也可以通过简单的 JSON 配置或环境变量添加自定义端点。
  • 集成钩子 – 作为 Claude Code、Codex、Cursor 及通用 AI 编程 Agent 的技能/插件发布，提供如 /open-code-review:review 之类的斜杠命令。

安装

  • NPM (推荐): npm install -g @alibaba-group/open-code-review → 提供 ocr 命令。
  • 二进制发布版: macOS/Linux 使用一行命令 curl …/install.sh | sh，Windows 使用 PowerShell irm …/install.ps1 | iex。内置 SHA-256 校验。
  • 从源码安装: git clone … && make build && sudo cp dist/opencodereview /usr/local/bin/ocr。

首次设置

  1. 运行 ocr config provider（交互式）或 ocr config set …（对 CI 友好）来选择供应商、提供 API key 并选择模型。
  2. 使用 ocr llm test 测试连接。
  3. 在 Git 仓库中，只需运行 ocr review 来审查所有已暂存/未暂存的变更，或使用 --from main --to feature 或 --commit <sha> 等参数指定特定范围。
  4. 对于全仓库审计，使用 ocr scan（可选 --path <dir>）。

典型工作流

# 配置一次
ocr config provider            # 选择 Anthropic, OpenAI 等
ocr config model               # 选择 claude-sonnet-4-6, gpt-4o, …
ocr llm test                   # 验证连通性

# 在本地审查一个 PR
cd my-project
ocr review                     # diff 模式审查

# CI 集成
ocr config set provider openai
ocr config set providers.openai.api_key $OPENAI_API_KEY
ocr review --from $BASE --to $HEAD --no-interactive

重要意义 – 与通用 Agent（如 Claude Code）相比，OpenCodeReview 实现了更高的精准度，且消耗的 Token 远少（约 1/9），这使得它在 CI 流水线中更便宜且噪音更小。确定性的预处理保证了每个变更文件都会被检查，且注释会落在正确的行号上。

更多信息 – 官方网站 https://open-codereview.ai，仓库中的基准测试图表，以及多语言 README（英语、中文、日语、韩语、俄语）。

Sources