OpenCodeReview 自定义接口：OCR 配置、连通检查与差异预览

这里的 OCR 是代码审查工具

本页范围是 alibaba/open-code-review 项目的 OpenCodeReview，命令为 ocr，不是图片文字识别程序，也不是 OpenCode 的通用对话入口。项目 CLI 提供 review、config、llm 和会话检查等命令。

它适合围绕指定 Git 差异做审查。接口能回答短问题与审查结果正确，是两套验收标准；不能因为连接测试通过，就省略 diff 范围和审查规则的确认。

自定义 provider 用本项目的字段

官方项目文档将配置放在 ~/.opencodereview/config.json。可以使用交互式 ocr config provider、命令行 config set 或手动编辑；交互设置保存后还会执行一次连接测试。 这一步会发请求，不应在服务地址和授权尚未确认时启动。

自定义项使用 custom_providers.<name>，HTTP 路线需填写 url、protocol、模型和密钥。以下选择 Responses，只是占位示例，本站没有由本教程验证的真实接口；这些命令也未在本文执行。

ocr config set provider 80321-example
ocr config set custom_providers.80321-example.url https://80321.cn/v1
ocr config set custom_providers.80321-example.protocol openai-responses
ocr config set custom_providers.80321-example.model YOUR_MODEL_ID
ocr config set custom_providers.80321-example.api_key YOUR_API_KEY

正式 Key 不要照这种形式写进共享脚本或命令历史。项目还支持 api_key_cmd 从秘密管理工具取钥，但该字段会执行命令，配置文件必须来自可信来源。

协议与取钥回退不能想当然

文档列出 openai、openai-responses、anthropic 及 Bedrock 路线；不要把普通聊天协议与 Responses 混为一谈。 Bedrock 还涉及区域和 AWS 认证，不属于上面的单 URL 示例。

项目文档特别指出，自定义 provider 没有内置 provider 那种环境变量回退；不能只导出一个通用 Key 就认为自定义条目已鉴权。 如果测试仍使用旧 provider，先看当前 provider 选择和配置来源，不要去修改 Git 审查范围。

先 llm test，再预览审查范围

正式配置确认后，官方 ocr llm test 用于测试模型连接。 保存实际错误和诊断来源，不编造成功输出。认证失败先查凭证，模型错误先查 ID，超时再核对请求耗时与超时字段，不直接上整仓库。

审查之前可以用官方 --preview 跳过 LLM，只查看过滤后的文件和排除原因。 例如在合适的测试仓库中，下面是范围预览，不是已完成的审查：

ocr review --commit HEAD --preview --format json

确认文件清单不包含秘密或无关内容后，才运行一次小范围真实审查。不要把预览结果称为模型审查结论。

只读审查仍有数据外发

把差异内容发送给上游，就需要确认权限与保密范围。先用脱敏补丁，禁用不需要的外部工具，审查建议再交由开发者复核。超时、凭证来源和会话日志也可能包含敏感信息，提交问题前逐项检查。本文 verified 表示项目官方配置已核对，不表示本站接口已联通或审查质量已经实测。