安装
环境要求、从 npm 安装 ocra,以及从源码构建。
环境要求
- Node.js 22.19 或更高版本
- Git
- 至少一个模型供应商的 API key
默认的 OpenCode 运行时作为可选依赖一并安装;不想装它,见不装 OpenCode。
从 npm 安装
npm install -g @open-cr-agent/cli
ocra --version更新:npm install -g @open-cr-agent/cli@latest。卸载:npm uninstall -g @open-cr-agent/cli。
也可以不安装直接运行:
npx @open-cr-agent/cli reviewnpm 11.16 及更高版本会提示 opencode-ai 有一个不在 allowScripts 允许范围内的安装脚本,npm 12 会直接拦下它。ocra 不需要它(能在平台包里找到二进制文件),所以不必放行。
不装 OpenCode
OpenCode 运行时 @open-cr-agent/runtime-opencode 约占一次安装 175 MB 中的 165 MB。如果所有模型都在声明的端点上,并且配置设了 "runtime": "direct"(见选择运行时),就可以不装它。npm install -g 总会安装可选依赖,所以请装进一个单独的目录:
npm install --prefix ~/.ocra --omit=optional @open-cr-agent/cli
~/.ocra/node_modules/.bin/ocra --version # 或者把 ~/.ocra/node_modules/.bin 加进 PATH作为项目依赖安装时,--omit=optional 同样适用。ocra review --plan 不需要运行时。用默认的 opencode 时,审查会在调用任何模型之前以退出码 2 停下,并给出两种解决办法:设置 "runtime": "direct",或者安装与 ocra 版本完全一致的运行时(npm install --prefix ~/.ocra @open-cr-agent/runtime-opencode@<版本>)。
在 GitHub Action 里,输入 opencode: false 起同样的作用(见 GitHub)。
容器镜像
从 0.2.0 起,每个发布版本都提供 amd64 和 arm64 的容器镜像 ghcr.io/jma49/ocra:<版本>:刚发布的包,按 GitHub Action 的方式安装(依赖版本固定,校验签名和 provenance),带有 git,以非特权用户 node 运行。
docker run --rm --user "$(id -u):$(id -g)" --volume "$PWD:/repo" \
--env GEMINI_API_KEY ghcr.io/jma49/ocra:0.7.0 ocra review --from main0.2.0 之后的镜像以 ocra 为入口点,所以 docker run <镜像> review --from main 就够了;前面多写一个 ocra 对每个镜像都有效。以你自己的用户运行,它才能写 .ocra/sessions/;模型密钥和 OCRA_* 变量用 --env 传入。核对镜像来源见校验发布版本。
从源码安装
参与开发 ocra 或运行未发布的版本:
git clone https://github.com/jma49/Open-CR-Agent.git
cd Open-CR-Agent
npm install
npm run build
npm link --workspace @open-cr-agent/clinpm link 把 ocra 放到 PATH 上。更新:
git pull && npm install && npm run build卸载:npm unlink --global @open-cr-agent/cli。
或者不 link,直接运行构建好的 CLI:
node /path/to/Open-CR-Agent/packages/cli/dist/main.js reviewOpenCode 二进制文件
ocra 先在 opencode-ai 的平台包里找 OpenCode,再到 opencode-ai/bin/(其安装脚本放置的位置)里找。两处都没有时,手动指定:
export OCRA_OPENCODE_BIN=/path/to/opencode