在 OpenCode 中原生接入 Open Code Review：ocr_review 与 ocr_health 工具/斜杠命令集成指南-北京尧图网络

在 OpenCode 中原生接入 Open Code Reviewocr_review 与 ocr_health 工具/斜杠命令集成指南【免费下载链接】open-code-reviewFast, efficient, battle-tested at Alibabas scale. Hybrid architecture code review tool: deterministic pipelines LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI Anthropic compatible.项目地址: https://gitcode.com/GitHub_Trending/op/open-code-reviewOpen Code ReviewOCR是一套采用「确定性流水线 LLM Agent」混合架构的代码审查工具而本指南要解决的是如何把它的能力以原生工具tool与斜杠命令slash command的形式嵌入 OpenCode 编码代理。读完本文你将掌握插件文件的一键安装全局/单项目两种方式、ocr_review与ocr_health两个工具的完整参数语义与调用姿势、插件底层进程调度与安全边界无 shell 启动、超时熔断、输出限额、取消终止以及本地开发与回归测试流程。一、插件是什么把 OCR 变成 OpenCode 的原生能力OpenCode 集成位于仓库的 plugins/open-code-review/opencode/ 目录核心是一个 TypeScript 插件文件 open-code-review.ts它通过opencode-ai/pluginSDK开发依赖固定为1.18.5见 package.json向 OpenCode 注册两类能力注册项类型作用ocr_reviewTool审查工作区改动、单个 commit 或一段 ref 范围返回结构化 JSON 审查结论ocr_healthTool显示已安装 OCR 的版本号并测试其配置的 LLM 连接是否可用/ocr-reviewSlash command便捷提示词引导模型调用ocr_review工具/ocr-healthSlash command便捷提示词引导模型调用ocr_health工具关键设计是兼容性优先注册斜杠命令时使用config.command[ocr-review] ?? {...}的写法open-code-review.ts即只有用户尚未自定义同名命令时才注入默认模板已有用户命令会被原样保留。这一点由测试plugin registers tools and preserves existing user commands明确验证test/open-code-review.test.mjs。从源码结构看插件采用单入口导出设计export const OpenCodeReviewPlugin: Plugin是模块唯一导出项测试module exposes only one OpenCode plugin entry point用assert.deepEqual(Object.keys(module), [OpenCodeReviewPlugin])加以约束避免与其他插件命名冲突。二、前置条件先装好 OCR CLI 并完成 LLM 配置插件本身不打包 OCR 可执行文件它是在运行时通过spawn(ocr, ...)调用本地 CLI 的因此必须先安装并配置 OpenCodeReviewnpm install -g alibaba-group/open-code-review ocr config provider ocr config model ocr llm test其中ocr config provider与ocr config model用于交互式配置 LLM 提供商与模型ocr llm test则发送一条测试对话验证连通性。从 CLI 源码看llm_cmd.go 中的llm test子命令会加载配置、解析 LLM 端点、读取internal/config/testconnection下的测试任务模板并以 30 秒默认超时发起一次真实对话llm_cmd.go成功时打印 Source/URL/Model 与✓ Connection test successful。测试通过后再使用本插件可避免把「配置问题」误判为「审查失败」。插件对「OCR 未安装」这一场景也有兜底处理子进程启动抛出ENOENT时runOcr会将其转换为一条明确的错误提示——OpenCodeReview is not installed or ocr is not on PATH. Install it with: npm install -g alibaba-group/open-code-reviewopen-code-review.ts对应测试见 test/open-code-review.test.mjs。三、安装全局与单项目两种方式3.1 全局安装对所有项目生效将插件文件放入 OpenCode 的全局插件目录mkdir -p ~/.config/opencode/plugins随后把仓库中的 open-code-review.ts 复制或按原文档用curl -fsSL从上游 raw 地址下载到该目录并命名为open-code-review.ts。例如git clone https://gitcode.com/GitHub_Trending/op/open-code-review cp open-code-review/plugins/open-code-review/opencode/open-code-review.ts ~/.config/opencode/plugins/安装完成后重启 OpenCode使插件生效。3.2 单项目安装随项目共享在项目根目录执行mkdir -p .opencode/plugins将插件文件放入.opencode/plugins/open-code-review.ts。若希望该集成随项目团队共享请把插件文件一并提交进版本库commit the plugin file。两种安装方式的差异仅在插件目录位置插件行为完全一致由于文件会随项目分发单项目安装更适合团队内部推广审查规范。四、使用方式斜杠命令与自然语言调用4.1 斜杠命令安装完成后即可在 OpenCode 对话中使用/ocr-review current workspace; focus on authentication regressions /ocr-review compare main to feature/auth-refresh /ocr-health/ocr-review的默认模板把斜杠后的文本视为「审查意图目标细节业务上下文」并指示模型未指定目标时审查当前工作区改动最终按严重级别输出带精确文件与行号引用的结论open-code-review.ts。/ocr-health则要求模型调用ocr_health并简洁解释任何配置问题。4.2 自然语言调用工具OpenCode 的 Agent 可以直接理解工具语义无需斜杠命令也能触发Use ocr_review to review my current changes. The goal is to add rate limiting without changing the public API.ocr_review工具的描述open-code-review.ts明确告知模型可审查工作区改动、单个 commit 或 ref 范围返回结构化行级 JSON 结论previewtrue可在不消耗 LLM 的情况下查看审查范围。4.3 先用 preview 探明审查范围把preview设为true可以在不发起任何 LLM 请求的前提下列出将被审查的文件清单适合在正式审查前核对范围是否符合预期。preview 模式下插件会省略--format json参数并追加--previewopen-code-review.ts测试preview omits JSON mode and adds --preview精确断言了这一参数形态test/open-code-review.test.mjs。五、ocr_review 参数全解析插件通过 tool.schema 为ocr_review声明了完整的参数 Schema让 OpenCode 的模型可以按需填参。下表为全部参数及其语义参数类型说明commitstring审查单个 commit对比其父提交from/tostring分支/范围比较的基与目标 ref必须成对出现resumestring按会话 ID 恢复上一次 OCR 审查backgroundstring业务或需求上下文审查需满足的实现目标excludestring逗号分隔的 gitignore 风格排除模式modelstring覆盖 OCR 配置中设定的模型concurrencyint最大并发文件审查数timeoutMinutesint单文件 OCR 超时分钟overallTimeoutMinutesint整个 OCR 进程的可选墙钟超时分钟maxToolsint每个子任务的最大工具调用轮数OCR 强制最低 50maxGitProcessesint最大并发 Git 子进程数previewboolean不调用 LLM仅列出将被审查的文件5.1 参数互斥规则buildReviewArgs在启动任何进程前先做参数合法性校验open-code-review.ts冲突组合会直接抛错、绝不落到 CLIfrom/to必须同时提供否则报 Both from and to are required for a branch comparison.commit与from/to范围互斥Use either commit or a from/to range, not both.resume不能与commit或from/to范围组合。preview与resume不能同时使用。这些规则在 test/open-code-review.test.mjs 中有完整的负向用例矩阵覆盖。底层 CLI 侧同样存在对应校验——validateDiffModeshared_flags.go与validateReviewOptionsshared_flags.go会再次把关--preview与--resume互斥在 CLI 层同样生效。5.2 参数到 CLI 标志的映射插件把 Schema 参数逐项映射为 OCR CLI 标志open-code-review.ts恒定的基础参数是review --audience agent --repo 仓库根目录非 preview 时追加--format json。--audience agent与--format json的组合意味着输出面向机器消费从 CLI 侧实现看--audience只接受human/agent两个枚举值shared_flags.goagent模式输出纯摘要、不渲染人类进度条--format支持text/json/sarifshared_flags.go。在 review_cmd.go 的示例中可以看到各标志的直接用法。其余参数的 CLI 映射与默认值依据 shared_flags.go 与 flags_test.goconcurrency→--concurrencyCLI 默认 8 个并发文件组审查timeoutMinutes→--timeoutCLI 默认单任务超时 15 分钟maxTools→--max-toolsCLI 默认 0即采用模板默认且低于 50 的值会被钳制到 50——flags_test.go验证了--max-tools 30会被强制为 50maxGitProcesses→--max-git-procsCLI 默认 16 个并发 Git 子进程exclude→--exclude逗号分隔的 gitignore 风格模式与规则文件中的排除项合并model→--model仅覆盖本次运行的模型不修改持久化配置。一个典型的完整参数组装结果来自测试断言 test/open-code-review.test.mjs形如review --audience agent --format json --repo worktree --background Add rate limiting --timeout 30六、ocr_health版本与连接自检ocr_health工具不接受任何参数执行时并发发起两个子进程调用open-code-review.tsocr version30 秒超时读取已安装 OCR 版本ocr llm test60 秒超时向配置的 LLM 发送测试对话。两者通过Promise.allSettled并行执行并合并结果——即使版本检查成功而 LLM 检查失败也会同时报告两边状态测试ocr_health reports both version success and LLM failure验证了这种「部分成功」的输出语义见 test/open-code-review.test.mjs。这使/ocr-health成为排查「版本过旧 / 凭据缺失 / 端点不可达」三类问题的第一站。七、行为与安全边界插件如何管控 OCR 子进程原文档的「Behavior and safety」一节定义了插件对子进程的硬性约束其实现细节可从 runOcr 逐条对应以参数数组启动、shell: falsespawn(invocation.command, [...prefixArgs, ...args], { shell: false })直接把参数数组交给exec系统调用不经任何 shell 解释。即使参数中混入main; touch /tmp/unsafe这类可疑 ref也会被原样作为一个 argv 值传递不存在命令注入面测试ocr_review passes suspicious-looking refs as one argv value without a shell对此做了专门验证见 test/open-code-review.test.mjs。整体超时熔断ocr_review默认使用 30 分钟整体墙钟超时defaultOverallMs 30 * 60 * 1000测试ocr_review defaults to 30-minute overall timeout断言了这一点可用overallTimeoutMinutes覆盖runOcr底层函数自身的兜底默认是 15 分钟open-code-review.ts与单文件--timeout相互独立——测试ocr_review keeps per-file and overall timeouts independent验证了两套超时并行生效。超时后先发SIGTERM3 秒内未退出再升级SIGKILL。10 MiB 输出限额stdout 与 stderr 的累计字节数合并计数appendChunk见 open-code-review.ts任一方向超限都会终止进程并抛出 OCR output exceeded the 10485760-byte safety limit。测试用「stdout 6 MiB stderr 6 MiB」的组合验证了跨流合并计数的行为test/open-code-review.test.mjs。取消即终止OpenCode 取消工具AbortSignal时插件对子进程执行整组终止——非 Windows 平台process.kill(-child.pid, SIGTERM)杀死整个进程组Windows 平台改用taskkill /pid pid /T /Fopen-code-review.ts。detached: true的启动参数保证了子进程拥有独立进程组从而可被整组回收测试覆盖了「正常取消」「子进程无视 SIGTERM 时强制 SIGKILL」「孙进程也被一并清理」三个层级test/open-code-review.test.mjs。凭据不动子进程继承env: process.envOCR 凭据继续留在既有的 OCR 配置或环境变量中插件不做任何代理或改写。工作区模式范围未指定 commit/范围时OCR 的 workspace 模式覆盖 staged、unstaged 与 untracked 三类改动——CLI 侧ModeWorkspace的定义即「current workspace (staged unstaged untracked)」internal/diff/git.go并包含对 unborn无 HEAD仓库的兜底处理。此外还有一层输出校验非 preview 模式下若 OCR 退出码非零runOcr会抛出携带 stderr/stdout 的OcrExecutionError测试ocr_review reports non-zero exits with OCR output验证了exitCode与错误信息被透传退出码为零但输出不是合法 JSON 时同样抛错ocr_review rejects invalid JSON output只有空输出会被宽容地解释为 No changes detected。这一层校验保证了 OpenCode 拿到的永远是结构化、可信的数据而不是被截断或损坏的半成品。八、本地开发与回归测试仓库为插件提供了完整的开发闭环package.json 的 scripts 与 tsconfig.jsoncd plugins/open-code-review/opencode npm install npm run checknpm run checktypechecktsc --noEmittest先tsc构建到dist/再用 Node 内置 test runner 执行test/*.test.mjs。测试套件通过伪造ocr可执行文件withFakeOcr把一段 Node 脚本伪装成 PATH 上的ocr见 test/open-code-review.test.mjs来验证插件的参数组装、退出码处理、超时与取消行为无需真实 LLM 或真实仓库即可回归。若需调整工具参数或安全策略改完 open-code-review.ts 后跑一遍npm run check即可获得完整保障。九、小结OpenCode 集成把 Open Code Review 从独立 CLI 变成了编码代理的原生工具ocr_review负责输出结构化 JSON 审查结论ocr_health负责自检斜杠命令负责给模型一个明确的调用入口而插件层的参数互斥校验、无 shell 启动、双超时与输出限额、取消整组终止共同构成了「可被 Agent 安全调度」的边界。配合 OCR 自带的--audience agent机器友好输出与 workspace/commit/range 三种审查模式团队可以在 OpenCode 工作流中无缝复用已有的 LLM 代码审查能力。【免费下载链接】open-code-reviewFast, efficient, battle-tested at Alibabas scale. Hybrid architecture code review tool: deterministic pipelines LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI Anthropic compatible.项目地址: https://gitcode.com/GitHub_Trending/op/open-code-review创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

在 OpenCode 中原生接入 Open Code Review：ocr_review 与 ocr_health 工具/斜杠命令集成指南

相关推荐

gpt-image-2实战指南：提示词工程与高效出图技巧

Git从环境配置到冲突处理：开发者必会的协作全流程

TDengine客户端与服务端安装详解：概念、配置与避坑指南

更多资讯

lo 库 Keyify 详解：基于 Go 泛型将切片转换为 Set 集合（map[T]struct{}）

用过才敢说！2026最新AI论文写作工具测评与推荐

Cilium Hubble UI 命令行操作指南：`cilium hubble ui` 命令详解与源码实现

核函数原理与实战：解决线性不可分问题的升维智慧

电摩电机专用绕线机设计与实战：小齿距高精度绕制方案

Apache Airflow 扩展：Operator Extra Links 定义与 Provider 内置链接全解析

今日更新

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本周精选

AI驱动的自动化专利分析平台技术解析

LeetCode-Go 题解：1252. Cells with Odd Values in a Matrix（奇数值单元格计数）双解法剖析

在线答疑系统Java毕设实战：Spring Boot前后端分离与状态流转

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？