一个基于 Go 语言的 AI 代码审查工具

PART 01

什么是 Open Code Review？

什么是 OPEN CODE REVIEW？

PART 02

基准测试

基准测试

PART 03

为什么选择 Open Code Review？

为什么选择 OPEN CODE REVIEW？

PART 04

如何使用

如何使用

PART 05

文档

文档

PART ///

写在最后

SUMMARY · 个人观点

01

PART

什么是 Open Code Review？

什么是 OPEN CODE REVIEW？

基准测试

通用代理的问题

如果你曾使用过像 Claude Code 这样带有 Skills 的通用代理进行代码审查，你很可能遇到过以下痛点：

•覆盖不完整 — 在较大的变更集上，代理倾向于“偷工减料”，只选择性地审查部分文件而遗漏其他文件。

•位置漂移 — 报告的问题经常与实际代码位置不符，行号或文件引用会偏离目标。

•质量不稳定 — 由自然语言驱动的 Skills 难以调试，审查质量会随着提示词的微小变化而显著波动。

根本原因：纯粹由语言驱动的架构在审查过程中缺乏硬性约束。

核心设计：确定性工程 × 代理混合架构

Open Code Review 的核心理念是将确定性工程与代理相结合，各司其职，发挥各自所长。

确定性工程 — 硬约束

对于*绝不能出错*的审查步骤，由工程逻辑（而非语言模型）来保证正确性：

•精确的文件选择 — 精确确定哪些文件需要审查、哪些应被过滤，确保不遗漏任何重要变更。

•智能文件打包 — 将相关文件分组到一个审查单元中（例如，message_en.properties 和 message_zh.properties 会被打包在一起）。每个包作为一个子代理运行，拥有独立的上下文——这是一种分而治之的策略，在非常大的变更集上也能保持稳定，并自然支持并发审查。

•细粒度规则匹配 — 将审查规则与每个文件的特性进行匹配，使模型的注意力高度集中，从源头上消除信息噪音。与纯粹由语言驱动的规则引导相比，基于模板引擎的规则匹配更加稳定和可预测。

•外部定位与反思模块 — 独立的评论定位和评论反思模块，系统性地提高了 AI 反馈的位置准确性和内容准确性。

代理 — 动态决策

代理的优势集中在最关键的领域——动态决策和动态上下文检索：

•场景调优的提示词 — 为代码审查深度优化的提示词模板，在提高效率的同时减少令牌消耗。

•场景调优的工具集 — 基于对大规模生产数据中工具调用轨迹的深入分析（包括调用频率分布、每个工具的重复率以及新工具对整个调用链的影响）提炼而成，最终形成一个比通用代理工具包更稳定、更可预测的代码审查专用工具集。

04

PART

如何使用

如何使用

前提条件

•Git >= 2.41 — Open Code Review 依赖 Git 进行差异生成、代码搜索和仓库操作。

CLI

安装

...bash

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

安装后，ocr 命令即可全局使用。

其他安装方式（安装脚本、GitHub Release 二进制文件、源码安装）请参阅安装文档。

快速开始

1. 配置 LLM

在审查代码之前，你必须配置一个 LLM，除非你使用委派模式。

...bash

ocr config provider          # 选择内置提供商或添加自定义提供商

ocr config model             # 为当前激活的提供商选择模型

提供商设置

交互式界面会引导你完成提供商选择、API 密钥输入和模型配置，然后自动测试连接。

有关 CLI 设置、环境变量、自定义提供商和其他高级配置，请参阅配置文档。

2. 审查

...bash

cd your-project

# 工作区模式 — 审查所有已暂存、未暂存和未跟踪的更改

ocr review

# 分支范围 — 审查 feature-branch 从 main 分叉以来的更改（合并基点模式）

ocr review --from main --to feature-branch

# 单个提交

ocr review --commit abc123

# 恢复中断的范围或提交审查

ocr session list

ocr review --from main --to feature-branch --resume 

# 全文件扫描 — 审查整个文件而非差异（无需 Git 历史）

ocr scan                          # 扫描整个仓库

ocr scan --path internal/agent    # 扫描目录或特定文件

ocr scan --resume    # 恢复中断的全文件扫描

# 委派模式 — 让你的 AI 编码代理自行执行审查

# OCR 负责文件选择和规则解析；无需配置 LLM

ocr delegate preview

ocr delegate rule src/main.go src/handler.go

05

PART

文档

文档

完整文档位于 open-codereview.ai/docs：

•快速入门 — 安装并运行你的第一次审查

•安装 — 所有平台和包管理器

•CLI 参考 — 所有命令和标志

•审查规则 — 使用路径过滤和定位自定义审查规则

•配置 — 配置键和环境变量

•MCP 服务器 — 使用外部工具扩展审查代理

•编码代理集成 — 选择你使用的平台

·[Claude Code](plugins/open-code-review/README.md#claude-code) — 安装带有审查斜杠命令的插件

·[Codex](plugins/open-code-review/README.md#codex) — 安装带有可调用审查技能的插件

·[Cursor](plugins/open-code-review/README.md#cursor) — 安装带有可移植审查技能的插件

·[OpenCode](plugins/open-code-review/opencode/README.md) — 安装原生审查工具和斜杠命令

·[QCA Forward](plugins/open-code-review/qca/README.md) — 使用 QCA 主机模型和可发布模板运行委派模式

·兼容技能代理 — 安装可移植的代理技能

•审查执行模式 — 集成后，选择由哪个 LLM 执行审查

·默认（OCR 管理） — OCR 使用其配置的 LLM 运行审查

·委派模式 — 你的编码代理使用其自身的 LLM 运行审查；无需 OCR API 密钥

•CI/CD 集成 — GitHub Actions、GitLab CI、GitFlic CI 和 Gerrit 集成

•会话查看器 — 在浏览器中浏览和回放审查会话

•遥测 — 用于可观测性的 OpenTelemetry 集成

•常见问题解答 — 常见问题和故障排除

///

LAST

写在最后

SUMMARY · 个人观点

感谢大家阅读，个人观点仅供参考，欢迎在评论区发表不同观点。

既然看到这里了，如果觉得有用，随手点个赞、在看、转发三连吧。

点赞

在看

转发

THANKS FOR READING