Open Code Review：审查范围、文件过滤与模型调用
Open Code Review 上手：先预览，再保存一次审查结果
选择 Git 审查范围，检查预览输出，并保存可核对的结果，避免把文件预览当成模型已经完成审查。
你将学会
- 安装后先检查，不急着加入凭据
- 按任务选择比较引用
- 保存能被检查的结果
开始前需要
- 理解 Git 改动与合并基点比较
- 会使用命令行并理解模型凭据的用途
选择审查范围，解释文件排除原因，设计受控试验，并区分源码审阅和运行证据。
先看结论
- 工作区模式会包含未跟踪文件。
- 分支范围模式从合并基点开始比较。
- 配置提供商时可能发起连接测试请求。
安装后先检查，不急着加入凭据
README 提供 npm 安装方式，并要求 Git 2.41 或更高版本。记录安装的 OCR 版本与 Git 版本。团队部署还应选定经过审核的发行版本并固定下来；不带版本号的 npm 安装命令会跟随软件包当前版本。
先在只包含合成示例的仓库中操作。预览用于查看模型审查前的文件选择。除了入选文件，也要检查排除列表，尤其是包含业务约束的测试文件，或使用不常见扩展名的配置和代码。
按任务选择比较引用
准备本地提交时可以使用工作区模式。审查分支时要指定预期的基线与目标，并理解文档所述的合并基点比较。只想检查某一次提交时，单次提交模式的范围更明确，便于把评论归到对应变更。
工作区模式会把未跟踪文件视为新增文件。本地临时笔记或生成产物因此可能影响选择结果。连接任何外部模型之前，先查看仓库状态、比较引用与预览，不要仅凭编辑器中打开的文件判断审查范围。
保存能被检查的结果
常规审查可以通过交互菜单配置提供商和模型。配置文档说明，设置过程也会测试连接。请使用获准的模型地址，在私密输入界面中提供凭据，不要把真实密钥写进共享终端记录、文章示例或版本库。
把 JSON 结果保存到新的文件中，逐条对照源码检查评论，同时保留预览和运行结果。本章说明的是已核对的命令用法，本次文章审阅没有安装 OCR、调用模型接口或审查真实业务仓库。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
检查 git --version，并按官方 npm 方式安装经过审核的 OCR 版本。
- 2
在合成示例仓库执行 ocr review --preview，确认文件列表。
- 3
完成获准的模型配置后保存 JSON 审查结果，并对照改动核验。
可复制示例
git --version
git status --short
ocr review --preview
# 完成获准的模型配置后再运行：
ocr review --format json --output review-demo.json常见问题
预览是否需要支付模型审查费用？
架构文档说明预览在不调用模型的情况下确定范围；它不会执行后续模型审查。
为什么测试文件没有出现在列表里？
内置路径规则可能排除测试文件。先查看排除原因和显式 include 规则，再判断范围是否符合任务。
资料来源
- Open Code Review / README.md来源核查 2026-09-18
- Open Code Review / pages/src/content/docs/en/architecture.md来源核查 2026-09-18
- Open Code Review / pages/src/content/docs/en/configuration.md来源核查 2026-09-18
- Open Code Review / internal/agent/selection.go来源核查 2026-09-18