开放源代码的人工智能代码审查代理。英文 | 简体中文 什么是开放代码审查？开放代码审查是一个由AI驱动的代码审查命令行工具。它起源于阿里巴巴集团内部的官方AI代码审查助手——在过去两年中，它服务了数万名开发者，并发现了数百万个代码缺陷。在经过大规模的彻底验证后，我们将其孵化为一个开放源代码项目，供社区使用。只需配置一个模型端点即可开始使用。它读取Git差异，通过具备工具使用能力的代理将更改的文件发送到可配置的大语言模型，并生成具有行级精确度的结构化审查评论。该代理可以读取整个文件内容，搜索代码库，检查其他更改的文件以获取上下文，并生成深入的审查——不仅仅是表面上的差异反馈。通用代理的问题 如果您曾使用过像Claude Code with Skills这样的通用代理进行代码审查，您可能遇到过这些痛点： 不完整的覆盖——对于较大的更改集，代理通常会“走捷径”，只选择审查某些文件，而遗漏其他文件。 位置漂移——报告的问题与实际代码位置往往不匹配，行号或文件引用漂移离目标。 不稳定的质量——自然语言驱动的技能难以调试，审查质量随着轻微提示的变化而显著波动。根本原因：纯粹的基于语言的架构在审查过程中缺乏严格约束。 核心设计：确定性工程 × 代理混合 开放代码审查的核心理念是将确定性工程与代理相结合，各自处理其最擅长的内容。 确定性工程——严格约束 对于必须无误的审查步骤，工程逻辑——而非语言模型——保证正确性： 精确的文件选择——确定需要审查的确切文件以及应过滤的文件，确保不会错过任何重要变更。 智能文件捆绑——将相关文件分组为一个审查单元（例如，message_en.properties和message_zh.properties被捆绑在一起）。每个捆绑作为一个子代理运行，具有隔离的上下文——在非常大的更改集上保持稳定的分而治之策略，并自然支持并发审查。 精细规则匹配——将审查规则与每个文件的特征进行匹配，使模型的注意力保持高度集中，消除信息噪声的根源。与纯粹基于语言的规则指导相比，基于模板引擎的规则匹配更稳定和可预测。 外部定位和反射模块——独立的评论定位和评论反射模块系统性地提高了AI反馈的定位准确性和内容准确性。 代理——动态决策 代理的优势集中在最重要的地方——动态决策和动态上下文检索： 针对场景优化的提示——深度优化的代码审查提示模板，提高了有效性，同时减少了token消耗。 针对场景优化的工具集——基于大规模生产数据中工具调用轨迹的深度分析提炼而来——包括调用频率分布、每个工具的重复率以及新工具对整体调用链的影响——生成了一个专门构建的工具集，对于代码审查而言，比通用代理工具包更稳定和可预测。 如何使用CLI 通过NPM安装（推荐） npm install -g @alibaba-group/open-code-review 安装完成后，ocr命令将在全局范围内可用。 从GitHub Release 下载最新的二进制文件： # 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 # macOS（Intel） curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-darwin-amd64 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 # Linux（ARM64） curl -Lo ocr https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-linux-arm64 chmod +x ocr && sudo mv ocr /usr/local/bin/ocr # Windows（x86_64）——将ocr.exe移动到您的PATH目录中 curl -Lo ocr.exe https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-windows-amd64.exe # Windows（ARM64）——将ocr.exe移动到您的PATH目录中 curl -Lo ocr.exe https://github.com/alibaba/open-code-review/releases/latest/download/opencodereview-windows-arm64.exe 从源代码 git clone https://github.com/alibaba/open-code-review.git cd open-code-review make build sudo cp dist/opencodereview /usr/local/bin/ocr 快速开始 1. 配置LLM 您必须在审查代码之前配置LLM。 # 选项A：交互式配置 ocr config set llm.url https://api.anthropic.com/v1