打开代码审查
页:1 简体中文 | 日本語 | 한국어 | Русский
什么是公开代码评论?
Open Code Review是一个由AI驱动的代码审查CLI工具. 它起源于阿里巴巴集团的内部官方AI代码审查助理——在过去两年中,它为上万开发者服务并查明了上百万个代码缺陷. 经过大规模的彻底验证后,我们把它孵化成一个面向社区的开源项目. 只需配置一个模式端点即可启动 .
它读取了Git diffs,通过具有工具使用能力的代理将已修改的文件发送到可配置的LLM,并以行级精度生成结构化的评论. 代理可以读取完整的文件内容,搜索代码库,检查其他已更改的文件以了解上下文,并产生深层评论——而不仅仅是表层diff反馈. 除了评论之外, ocr scan 审查所有文件,以审计不熟悉的代码库或目录,这些目录没有意义.
访问 官方网站 (简体中文) 更多细节.
基准
与通用制剂(Claude Code)相比,开放码审查的成绩要高得多 精确度 财务报告和审定财务报表 F1 导弹 使用相同的基本模型,但只消耗 ~1/9 个符号 并更快地完成审查。 请注意,它的召回比普通用途剂要低——这是有意取舍,有利于精确而不是噪声.
以 第50条 流行的开源存储器, 200个 真实拉动请求,以及 10个 编程语言——由80多位高级工程师交叉认证(1 505个 附加说明的地面真相问题).
探索 Hugging Face 上的 AACR- Bench 数据集。 。 。 .
| 度量衡 | 它测量什么 | 为什么这很重要 |
|---|---|---|
| F1 导弹 | 精确和召回的谐音 | 总体审查质量的最佳单数 |
| 精确度 | 报告的实际缺陷问题比例 | 较高 = 分解的假警报减少 |
| 回顾 | 发现的实际缺陷比例 | 较高 = 审查后出现的问题较少 |
| Avg 时间 | 每次审查时长 | CI管道延迟的事项 |
| Avg 托肯语Name | 每次审查消费的证券总额 | 直接影响 API 成本 |
为什么是公开代码评论?
通用代理人的问题
如果你使用通用的特工 比如Claude Code和Speechs 来进行代码审查 你可能会遇到这些疼痛点:
- 覆盖面不完全 ——关于更大型的更动器,代理商往往会"割角",有选择地只审查一些文件而缺少其他文件.
- 位置漂移 ——被报道的问题往往与实际的代码位置不相匹配,与行号或文件参考文献漂移出目标.
- 质量不稳定 ——自然语言驱动的"技能"很难调试,审查质量有显著起伏并有轻微的即时变化.
根本原因:纯粹由语言驱动的架构对审查过程缺乏严格的制约.
核心设计:定型工程×代理混合
Open Code Review的核心理念是将定型工程与一个代理结合,每个代理都处理它最擅长的工作.
决定性工程——硬制约因素
用于审查步骤 千万别出错,工程逻辑——而不是语言模型——保证正确性:
- 精确文件选择 ——准确确定哪些文件需要审查,哪些文件应当过滤,确保不会错过重要更改.
- 智能文件捆绑 ——将相关文件分组为一个审查单位(如:,
message_en.properties财务报告和审定财务报表message_zh.properties被捆绑在一起。 每个捆绑作为子代理运行,背景孤立——一种分而相之的策略,在非常大的变化中保持稳定,并自然支持同时审查. - 精细规则匹配 ——将审查规则与每个文件的特性相匹配,使模型的注意力集中,并消除了源头的信息噪声. 与纯粹由语言驱动的规则指导相比,基于模板引擎的规则比对更加稳定和可预测.
- 外部定位和反射模块 ——独立评论定位和评论反射模块系统提高AI反馈的位置准确度和内容准确度.
代理-动态决策
代理人的长处集中在最重要的地方——动态决定和动态上下文检索:
- 情景调整的提示 ——快速模板深度优化代码审查,提高有效性并同时减少象征性消费.
- 情景调整工具集 ——从深入分析大型生产数据中的工具调用痕迹——包括调用频率分布,每个工具的重复率,以及新工具对整个调用链的影响——中消退出,形成一个专用工具箱,比通用代理工具箱更稳定,更能预测代码审查.
如何使用
先决条件
- 基特 >= 2.41 ——Open Code Review依赖Git进行diff生成,代码搜索,以及寄存器操作.
国 际
安装
npm install -g @alibaba-group/open-code-review
安装后 ocr 命令可在全球范围内使用.
其他安装方法(安装脚本, GitHub Release 二进制, 来源) 见 安装。 。 。 .
快速启动
1. 配置 LLM
您在检查代码前必须配置 LLM, 除非您使用 代表团模式。 。 。 .
ocr config provider # Select a built-in provider or add a custom one
ocr config model # Pick a model for the active provider
交互式UI通过提供者选择,API密钥条目和模型配置来引导您,然后自动测试连接性.
关于CLI设置,环境变量,自定义提供者等高级配置,参见: 配置。 。 。 .
2. 审查
cd your-project
# Workspace mode — review all staged, unstaged, and untracked changes
ocr review
# Branch range — reviews feature-branch's changes since it diverged from main (merge-base mode)
ocr review --from main --to feature-branch
# Single commit
ocr review --commit abc123
# Resume an interrupted range or commit review
ocr session list
ocr review --from main --to feature-branch --resume <session-id>
# Full-file scan — review whole files instead of a diff (no git history needed)
ocr scan # scan the entire repository
ocr scan --path internal/agent # scan a directory or specific files
ocr scan --resume <session-id> # resume an interrupted full-file scan
# Save results to a file (recommended for AI host agents)
ocr review --format json --output result.json
# Delegation mode — let your AI coding agent perform the review itself
# OCR handles file selection and rule resolution; no LLM configuration needed
ocr delegate preview
ocr delegate rule src/main.go src/handler.go
文档
完整文档生活于 开放代码审查.ai/docs数字 :
- 快速启动 安装和运行您的第一次审查
- 安装 ——所有平台和软件包管理器
- CLI 参考 每个命令和旗帜
- 审查规则 ——自定义审查规则,并设置路径过滤和定向
- 配置 ——配置密钥和环境变量
- MCP 服务器 利用外部工具扩展审查代理
- 编码代理集成——选择您使用的平台
- 审查执行模式——整合后,选择哪个LLM进行审查
- 默认( OCR 管理) ——OCR使用所配置的 LLM 运行审查
- 代表团模式 —— 您的编码代理使用自己的 LLM 运行审查; 没有需要 OCR API 密钥
- CI/CD 一体化 - GitHub Actions、GitLab CI、GitFlic CI和Gerrit整合
- 会话查看器 ——浏览并重放浏览器中的审查会话,将评论标为固定或被忽略并隐藏在您通过结果工作时
- 遥测 ——可观察性开阔几何集成
- 财务问题 - 常见问题和解决问题
捐款
这个项目的存在要归功于所有作出贡献的人。 见 捐款额 用于开发设置、编码指南,以及如何提交拉动请求.
许可证
阿帕奇 - 2.0 ——版权2026 Alibaba