快速上手
五分钟完成第一次审查。
五分钟配置
shell 里有模型 key 时,ocra init 会替你写好配置:
npm install -g @open-cr-agent/cli
export GEMINI_API_KEY="你的 key" # 或 ANTHROPIC_API_KEY、OPENAI_API_KEY、OPENROUTER_API_KEY
cd your-repository
ocra init # 写入 .ocra/config.json,并说明选了什么
ocra review # 审查未提交的改动要审查 GitHub PR,ocra init --github 还会写入 .github/workflows/ocra.yml(可安全审查 fork 的 PR),并打印设置 secret 和创建 ocra-review 标签的 gh 命令。它从不替换已有文件。见 ocra init。
下面的步骤是手动完成同样的事,可以用 OpenCode 支持的任何供应商。
配置模型的 API key
OpenCode 支持的供应商都可以用(模型供应商)。以 Google Gemini 为例:
export GEMINI_API_KEY="你的 key"key 请放在 shell 配置文件或密钥管理工具里,不要放进任何仓库。
选择模型
在要审查的仓库里创建 .ocra/config.json:
{
"models": {
"top": "google/gemini-3.1-pro-preview",
"standard": ["google/gemini-3.5-flash", "google/gemini-flash-lite-latest"],
"light": "google/gemini-flash-lite-latest"
}
}standard 模型负责审查代码,light 负责分组文件这类便宜的辅助工作,top 负责裁决问题。写成列表就是降级链。
开始审查
cd your-repository
ocra review # 未提交的改动,包括未跟踪的文件
ocra review --from main # 当前分支从 main 分叉以来的改动
ocra review --commit HEAD # 单个 commitocra 会打印进度,然后输出结论和按文件分组的报告。每条问题都标明是否经核查确认,并带一个用于 ocra memory 的编号:
Review: Working tree changes
Risk tier: lite · 2 reviewed · 0 failed · 0 excluded
Verdict: approved with comments
1 finding(s): 0 critical, 1 warning, 0 suggestion.
src/list.ts
warning L4 lastItems returns n + 1 items [verified] #3f9a1c2e
slice(list.length - n - 1) starts one element too early.
Suggestion: return list.slice(-n);
1 finding(s) (0 critical, 1 warning, 0 suggestion) · tokens: 8023 in (0 cached), 285 out, 0 reasoning · $0.0031
Session: .ocra/sessions/20260924T225539Z-aa9790核查确认了 critical 问题时,退出码为 1。请把它当作参考意见,而不是安全门禁:模型会读到改动,也可能被它误导。见退出码。