OpenCodeReview 使用指南

1. 配置 LLM(必须,审查前做一次)

ocr config provider # 交互式:选择内置供应商(Anthropic/OpenAI 等)或自定义

ocr config model # 为当前供应商选模型

交互界面会引导你输入 API Key 并自动测试连通性。

2. 进入一个 Git 项目(注意:当前 C:\Users\31085 主目录不是 git 仓库,ocr review 在这里跑不起来)

cd your-project

3. 开始审查

ocr review # 审查工作区所有改动(暂存+未暂存+未跟踪)

ocr review --from main --to feature-branch # 分支对比

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

ocr review -p # 先预览将审查哪些文件(不调用 LLM,推荐先用)

常用子命令

┌──────────────────────────────────┬──────────────────────

│ 命令 │ 作用 │

├──────────────────────────────────┼──────────────────────

│ ocr review │ 基于 diff 的审查(核心) │

├──────────────────────────────────┼───────────────────────────

│ ocr scan │ 全文件扫描,无需 git diff,适合审查陌生代码库 │

├──────────────────────────────────┼───────────────────────────

│ ocr delegate │ 委托模式,你的 AI 编程 agent 用自己的 LLM 执行审查,无需配置 API Key │

├──────────────────────────────────┼────────────────────────────

│ ocr session list / --resume │ 查看/恢复中断的审查会话 │

├──────────────────────────────────┼─────────────────────────

│ ocr rules │ 调试审查规则 │

├──────────────────────────────────┼────────────────────────────

│ ocr viewer │ 浏览器里浏览回放审查会话 │

├──────────────────────────────────┼────────────────────────────

│ ocr config │ 管理配置 │

└──────────────────────────────────┴──────────────────

常用参数:--format json(JSON 输出)、--exclude '**/generated/*'(排除文件)、-b

"加一句业务背景"(提供需求上下文,提升准确性)、--model claude-opus-4-6(临时换模型)。

两点提醒

- Git 版本:需要 Git >= 2.41。装好后可用 ocr review -p 先预览再真跑,省 token。

- 安装时有个 npm 警告:postinstall 脚本被 npm 的 allow-scripts 拦了,但这不影响核心功能(ocr

命令已验证可正常运行)。如果你后续发现缺某些功能,再跑 npm approve-scripts @alibaba-group/open-code-review 放行即可。