在 VSCode 中使用 Open Code Review 插件从安装配置到源码级架构解析【免费下载链接】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本文以open-code-reviewocrCLI的官方 VSCode 插件为对象完整讲解其功能清单、LLM 配置、三种审查模式的实操流程、插件开发与调试要点以及 Monolithic WebView Thin Extension Host 的架构设计。读完本文你将能够独立完成插件的安装、配置、日常代码审查、二次开发与.vsix发布包构建并理解插件与 CLI 之间通过postMessage与child_process协作的底层机制。插件定位CLI 的图形前端Open Code Review 是开源仓库中基于open-code-reviewCLInpm 包名为alibaba-group/open-code-review命令为ocr开发的 VSCode 代码审查插件。它以 Preact WebView 还原原型交互体验把 AI 代码审查能力直接集成进编辑器在侧边栏发起审查、流式查看日志、在编辑器内逐条应用/忽略/标记误报评论并与侧边栏双向同步。插件当前版本为0.1.2见 package.json要求VS Code ≥ 1.74通过onStartupFinished激活主入口为out/extension.js并在活动栏注册了ocr-container视图容器与ocr.sidebarWebView 侧边栏。插件的实质是ocrCLI 的图形化前端所有审查、配置、连通性测试最终都由ocr命令完成插件负责把参数、日志、结果翻译成编辑器体验。功能总览根据插件文档核心能力可归纳为八项能力说明三种审查模式工作区变更默认、分支对比--from/--to、单次提交--commit待审查文件预览基于当前 Git 状态展示变更文件列表点击文件在原生 diff 视图中查看改动自定义审查提示词可选地为本次审查追加--background提示流式日志审查过程中实时滚动 CLI 输出支持随时取消结果展示 双向同步侧边栏列出评论卡片编辑器内渲染 CommentThread应用/忽略/误报操作两侧同步空/取消/失败态无问题、用户取消、CLI 失败均有对应视图失败可重试展示 CLI 真实错误配置管理插件内查看/编辑 LLM 提供商配置写入通过ocr config set模型切换/连通性测试状态栏切换模型、测试与 LLM 的连通性这八项能力对应的状态机在 ReviewSession.ts 中由ReviewState类型定义idle | running | done | empty | cancelled | failed审查结束后的评论状态在 types.ts 中定义为pending | applied | discarded | falsePositive二者共同支撑了上述完整交互闭环。前置依赖安装 CLI 与配置 LLM1. 全局安装ocrCLInpm i -g alibaba-group/open-code-review插件在启动后通过 CliService.ts 的环境探测checkEnvironment依次校验node、npm、ocr三者可用性结果缓存 5 分钟ENV_CACHE_TTL_MS 5 * 60 * 1000。如果检测到 CLI 未安装插件侧还提供了「一键安装」能力install()通过npm install -g alibaba-group/open-code-review --loglevel http --no-progress流式回显安装日志并按退出码返回是否成功。2. 配置可用的 LLM可用 CLI 直接配置或在插件内的配置视图填写ocr config set llm.url https://api.anthropic.com/v1/messages ocr config set llm.auth_token sk-... ocr config set llm.model claude-opus-4-6 ocr config set llm.use_anthropic true配置写入~/.opencodereview/config.json。从 ConfigService.ts 的源码可以看到插件读取配置时使用homedir()/.opencodereview/config.json作为路径写入则统一委托给ocr config settoConfigSetArgs生成[config, set, key, value]参数确保与 CLI 的配置语义完全一致。文件以0o600权限写入保护其中的 API Key。3. 配置的字段映射camelCase 与 snake_case插件 WebView 端使用 camelCase 字段如useAnthropic而磁盘/CLI 端使用 snake_case如use_anthropic转换逻辑集中在 configParse.ts。其解析出的配置结构对应 types.ts 的OcrConfig包括provider/model当前选中的提供商与模型providers/customProviders内置与自定义提供商列表含apiKey、url、protocol、model、models、authHeaderllm.url/llm.authToken/llm.model/llm.useAnthropic/llm.authHeaderlanguage审查语言默认Chinese三种审查模式与参数构造插件的审查参数由 cliParse.ts 的buildReviewArgs统一构造其逻辑与文档中的三种模式一一对应工作区变更Workspace默认模式仅传review --format json审查当前工作区相对 HEAD 的改动。分支对比Branch追加--from ref与--to ref对应 CLI 的分支对比审查。单次提交Commit追加--commit sha审查该提交相对父提交的改动。此外buildReviewArgs还会附加--format jsonJSON 结果走 stdout进度日志走 stderr供扩展实时回显与解析--background prompt当用户填写了自定义提示词时追加--concurrency n当用户指定并发数时追加。注意源码中有--progress-stderr的预留注释TODO: 待 CLI 发布支持 --progress-stderr 后再启用即当前已安装版本尚不识别该 flag因此进度日志仍从 stderr 解析。完整审查工作流1. 待审查文件预览插件基于 Git 状态展示变更文件列表工作区模式通过git diff --name-status HEAD与git ls-files --others --exclude-standard获取首个提交前回退到git diff --cached分支/提交模式则分别通过三点 diffmerge-base与git show --diff-mergesfirst-parent获取见 GitService.ts。点击文件会在 VS Code 原生 diff 视图中打开工作区模式HEAD ↔ 工作区分支模式from...to三点 diff提交模式commit^ ↔ commit。2. 自定义审查提示词在发起审查前可以填写一段可选提示词插件会将其作为--background参数传给 CLI为本次审查注入额外的上下文或规则要求。3. 流式日志与取消审查启动后CliService.runRaw通过child_process.spawn执行ocr review ...CLI 的 stderr 日志被按行解析parseLogLine包含retrying/warning等关键词的行标记为warn级别后通过postMessage实时推送到侧边栏滚动展示。取消审查时POSIX 平台先SIGTERM3 秒未退出则对进程组SIGKILLdetached: true保证子进程一并回收Windows 平台改用taskkill /pid pid /t /f终止整棵进程树避免孤儿进程。取消后状态被置为cancelled与运行中的running状态区分。4. 结果解析与展示审查结束后parseCliResult从 stdout 中截取 JSONstdout.indexOf({)起解析提取status、comments、warnings与summary含filesReviewed、totalTokens、inputTokens、outputTokens、elapsed。随后 ReviewSession.ts 的resultToState依据结果判定终态有评论 →donestatus completed_with_errors→failed否则 →empty无问题。评论卡片与编辑器内双向同步审查完成后CommentProvider.ts 负责把每条评论渲染为编辑器内的CommentThread评论控制器 ID 为ocr-review见 constants.ts同时在侧边栏生成评论卡片。两者通过commentSync消息同步状态。针对每条评论你可以执行三种操作对应 commands.ts 注册的命令操作命令 ID行为应用ocr.comment.apply用建议代码替换原文有suggestionCode或删除该段无建议保存后状态置为applied忽略ocr.comment.discard仅本地标记为discarded误报ocr.comment.falsePositive标记为falsePositiveapply实现细节值得注意插件通过 lineOffset.ts 的LineOffsetTracker记录每次应用后文件行数偏移record(path, startLine, lineCountDelta)后续应用同一文件的另一条评论时会用adjusted(path, line)校正行号避免前面的修改导致后面评论错位。评论若带建议代码thread 正文会渲染为diff代码块apply只在工作区模式下可用其余模式会弹出提示因为只有工作区模式能安全地原地修改文件。此外jumpTo支持从侧边栏卡片一键跳到编辑器对应行对于分支/提交模式插件会优先在已打开的 diff 编辑器中定位到挂载侧新增/修改挂右侧、删除挂左侧定位失败或文件缺失时给出明确的跳转失败原因。状态视图空 / 取消 / 失败插件为审查流程的每种终态都提供了独立视图空EmptyViewCLI 返回无评论时展示取消CancelledView用户主动取消时展示失败FailedViewCLI 退出码非 0 时展示支持一键重试并展示 CLI 返回的真实错误。失败信息的提取在extractCliError中实现优先从 stderr 中从后往前找Error:行去前缀否则取最后一行非空内容。当 CLI 退出码非 0 时runRaw会 reject 并携带该错误文本ReviewSession 捕获后先写入日志[ocr] msg再置状态为failed。配置管理与连通性测试插件内置配置面板ConfigPanel支持查看/编辑 LLM 配置读写~/.opencodereview/config.jsonWebView 端 camelCase ↔ 磁盘端 snake_case 自动转换自定义提供商管理增删改自定义提供商条目连通性测试testWithEntries会在隔离的临时 HOMEos.tmpdir()/ocr-test-home-*中生成一份临时配置再运行ocr llm test测试通过即删除临时目录——绝不污染真实配置。测试失败时返回 CLI 的真实错误消息模型切换通过状态栏或面板切换当前模型环境检查校验node/npm/ocr三者是否可用。插件开发与调试环境准备Node.js ≥ 18包管理器使用Yarn仓库自带yarn.lockVS Code ≥ 1.74全局可用的ocrCLI见上文「前置依赖」。启动开发环境cd extensions/vscode yarn install # 安装依赖 yarn watch # 监听式开发构建推荐改代码自动重新打包 out/然后在 VS Code 中打开extensions/vscode目录按F5启动 Extension Development Host调试配置已在.vscode/launch.json提供。在弹出的新窗口里打开一个有 Git 变更的项目即可在活动栏看到 Open Code Review 图标并发起审查。改了代码后WebView 改动需在开发宿主窗口里重新打开侧边栏或执行命令Developer: Reload WebviewsExtension Host 改动需重启调试调试工具栏的 ⟳ 或在宿主窗口按CmdR。常用脚本脚本作用yarn compile单次开发构建webpack developmentyarn watch监听式开发构建yarn build生产构建webpack production打包前自动执行yarn test运行 Jest 单测yarn lintESLint 检查yarn package生成可分发的.vsix安装包以上脚本与 package.json 中的定义一一对应其中vscode:prepublish会先执行yarn build。调试要点双端通信WebView 与 Extension Host 通过postMessage通信消息类型全部定义在 messages.tsWebviewToHost覆盖startReview、cancelReview、getGitState、openFileDiff、setConfig、testConnection、commentAction等HostToWebview覆盖logLine、stateChange、reviewDone、commentSync、config等。两端发收都走dispatch/handle定位问题先看这里CLI 调用所有ocr子命令由 CliService.ts 通过child_process.spawn执行。runRaw会在 CLI 退出码非 0 时 reject 并带上 stderr 中的Error:文本便于排查「审查失败/连接失败」配置读写ConfigService.ts 读取~/.opencodereview/config.json写入则委托ocr config set。WebView 端字段为 camelCase如useAnthropic磁盘/CLI 端为 snake_case如use_anthropic转换在 configParse.ts。架构解析Monolithic WebView Thin Extension Host插件的整体架构是Monolithic WebView Thin Extension HostWebView是独立构建的 Preact SPA还原原型的全部视觉与交互视图组件见webview/views/含RunningView、DoneView、FailedView、CancelledView、EmptyView、IdleView、ConfigView等Extension Host层轻薄只负责 CLI 调用、文件系统、Git 操作、编辑器评论两者通过postMessage通信用src/shared/中的 TypeScript 共享类型保证类型安全。源码目录结构src/ ├── extension/ Extension HostNode.jsservices / providers / commands ├── webview/ WebView SPAPreactviews / components / store / bridge └── shared/ 双端共享类型与 postMessage 协议不依赖 vscode从 extension.ts 的activate入口可以看到各服务的装配关系CliServiceCLI 进程管理→ConfigService配置读写→GitServiceGit 状态与 diff→CommentProvider编辑器评论→SidebarProvider/ConfigPanelProvider两个 WebView 面板并通过registerCommands暴露命令。一条评论从「CLI 输出」到「编辑器内 CommentThread」的完整调用链为CliService.review → ReviewSession.run → CommentProvider.show → resolveCommentAnchor解析挂载锚点 → createCommentThread渲染线程→ emitSync同步侧边栏resolveCommentAnchor需要区分工作区快照与 Git ref 快照工作区模式直接读取磁盘文件分支/提交模式则通过GitService的readFileAtRefgit show ref:path、buildCommentDiffUris等能力把评论定位到 diff 的左右两侧实现跨版本的精准挂载。构建与发布仅编译产物yarn build # 生产构建webpack production产物out/extension.jsExtension Hostout/webview.jsWebView SPA。构建发布包.vsixyarn package # vsce package --no-yarn该命令会自动触发vscode:prepublish→ 执行yarn build生产构建按.vscodeignore排除源码、测试、开发文件在当前目录生成open-code-review-vscode-version.vsix。打包工具为vscode/vsce已作为 devDependency 安装无需全局安装或联网下载。--no-yarn用于跳过 vsce 默认的 npm 依赖树校验本项目用 Yarn。发布包只包含运行必需文件package.json、README.md、resources/icon.svg、out/extension.js、out/webview.js。本地安装 / 验证code --install-extension open-code-review-vscode-version.vsix或在 VS Code 中扩展面板 → 右上角⋯→Install from VSIX…→ 选择生成的.vsix文件。发布到 Marketplace 时改用vsce publish需要 publisher 账号与 PAT日常分发用上面的.vsix即可。常见问题排查思路结合上面的源码分析遇到问题时可以按以下线索定位「审查失败/连接失败」看CliService.runRaw抛出的错误——它已提取 stderr 中Error:开头的真实文本若为空则显示CLI exited with code n此时可手动在终端执行同样的ocr review复现评论无法定位到行CommentProvider会记录jumpBlockReasons文件缺失提示「文件缺失」、行号未解析提示「行号未解析」startLine/endLine均 ≤ 0 时评论应用后行号错位插件依赖LineOffsetTracker校正偏移若连续应用多条评论后出现错位说明apply后的record未正确触发可检查是否绕过了apply而直接手动改文件配置不生效确认~/.opencodereview/config.json的字段命名snake_case或直接在插件配置面板重写一遍再由ocr config set落盘。License本插件基于 Apache-2.0 许可证开源仓库根目录的 LICENSE 为完整协议文本。在 CLI 侧cmd/opencodereview与扩展侧均声明了 SPDX 许可证头二次开发时请注意保留版权声明。【免费下载链接】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），仅供参考 在 VSCode 中使用 Open Code Review 插件：从安装配置到源码级架构解析
在 VSCode 中使用 Open Code Review 插件从安装配置到源码级架构解析【免费下载链接】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本文以open-code-reviewocrCLI的官方 VSCode 插件为对象完整讲解其功能清单、LLM 配置、三种审查模式的实操流程、插件开发与调试要点以及 Monolithic WebView Thin Extension Host 的架构设计。读完本文你将能够独立完成插件的安装、配置、日常代码审查、二次开发与.vsix发布包构建并理解插件与 CLI 之间通过postMessage与child_process协作的底层机制。插件定位CLI 的图形前端Open Code Review 是开源仓库中基于open-code-reviewCLInpm 包名为alibaba-group/open-code-review命令为ocr开发的 VSCode 代码审查插件。它以 Preact WebView 还原原型交互体验把 AI 代码审查能力直接集成进编辑器在侧边栏发起审查、流式查看日志、在编辑器内逐条应用/忽略/标记误报评论并与侧边栏双向同步。插件当前版本为0.1.2见 package.json要求VS Code ≥ 1.74通过onStartupFinished激活主入口为out/extension.js并在活动栏注册了ocr-container视图容器与ocr.sidebarWebView 侧边栏。插件的实质是ocrCLI 的图形化前端所有审查、配置、连通性测试最终都由ocr命令完成插件负责把参数、日志、结果翻译成编辑器体验。功能总览根据插件文档核心能力可归纳为八项能力说明三种审查模式工作区变更默认、分支对比--from/--to、单次提交--commit待审查文件预览基于当前 Git 状态展示变更文件列表点击文件在原生 diff 视图中查看改动自定义审查提示词可选地为本次审查追加--background提示流式日志审查过程中实时滚动 CLI 输出支持随时取消结果展示 双向同步侧边栏列出评论卡片编辑器内渲染 CommentThread应用/忽略/误报操作两侧同步空/取消/失败态无问题、用户取消、CLI 失败均有对应视图失败可重试展示 CLI 真实错误配置管理插件内查看/编辑 LLM 提供商配置写入通过ocr config set模型切换/连通性测试状态栏切换模型、测试与 LLM 的连通性这八项能力对应的状态机在 ReviewSession.ts 中由ReviewState类型定义idle | running | done | empty | cancelled | failed审查结束后的评论状态在 types.ts 中定义为pending | applied | discarded | falsePositive二者共同支撑了上述完整交互闭环。前置依赖安装 CLI 与配置 LLM1. 全局安装ocrCLInpm i -g alibaba-group/open-code-review插件在启动后通过 CliService.ts 的环境探测checkEnvironment依次校验node、npm、ocr三者可用性结果缓存 5 分钟ENV_CACHE_TTL_MS 5 * 60 * 1000。如果检测到 CLI 未安装插件侧还提供了「一键安装」能力install()通过npm install -g alibaba-group/open-code-review --loglevel http --no-progress流式回显安装日志并按退出码返回是否成功。2. 配置可用的 LLM可用 CLI 直接配置或在插件内的配置视图填写ocr config set llm.url https://api.anthropic.com/v1/messages ocr config set llm.auth_token sk-... ocr config set llm.model claude-opus-4-6 ocr config set llm.use_anthropic true配置写入~/.opencodereview/config.json。从 ConfigService.ts 的源码可以看到插件读取配置时使用homedir()/.opencodereview/config.json作为路径写入则统一委托给ocr config settoConfigSetArgs生成[config, set, key, value]参数确保与 CLI 的配置语义完全一致。文件以0o600权限写入保护其中的 API Key。3. 配置的字段映射camelCase 与 snake_case插件 WebView 端使用 camelCase 字段如useAnthropic而磁盘/CLI 端使用 snake_case如use_anthropic转换逻辑集中在 configParse.ts。其解析出的配置结构对应 types.ts 的OcrConfig包括provider/model当前选中的提供商与模型providers/customProviders内置与自定义提供商列表含apiKey、url、protocol、model、models、authHeaderllm.url/llm.authToken/llm.model/llm.useAnthropic/llm.authHeaderlanguage审查语言默认Chinese三种审查模式与参数构造插件的审查参数由 cliParse.ts 的buildReviewArgs统一构造其逻辑与文档中的三种模式一一对应工作区变更Workspace默认模式仅传review --format json审查当前工作区相对 HEAD 的改动。分支对比Branch追加--from ref与--to ref对应 CLI 的分支对比审查。单次提交Commit追加--commit sha审查该提交相对父提交的改动。此外buildReviewArgs还会附加--format jsonJSON 结果走 stdout进度日志走 stderr供扩展实时回显与解析--background prompt当用户填写了自定义提示词时追加--concurrency n当用户指定并发数时追加。注意源码中有--progress-stderr的预留注释TODO: 待 CLI 发布支持 --progress-stderr 后再启用即当前已安装版本尚不识别该 flag因此进度日志仍从 stderr 解析。完整审查工作流1. 待审查文件预览插件基于 Git 状态展示变更文件列表工作区模式通过git diff --name-status HEAD与git ls-files --others --exclude-standard获取首个提交前回退到git diff --cached分支/提交模式则分别通过三点 diffmerge-base与git show --diff-mergesfirst-parent获取见 GitService.ts。点击文件会在 VS Code 原生 diff 视图中打开工作区模式HEAD ↔ 工作区分支模式from...to三点 diff提交模式commit^ ↔ commit。2. 自定义审查提示词在发起审查前可以填写一段可选提示词插件会将其作为--background参数传给 CLI为本次审查注入额外的上下文或规则要求。3. 流式日志与取消审查启动后CliService.runRaw通过child_process.spawn执行ocr review ...CLI 的 stderr 日志被按行解析parseLogLine包含retrying/warning等关键词的行标记为warn级别后通过postMessage实时推送到侧边栏滚动展示。取消审查时POSIX 平台先SIGTERM3 秒未退出则对进程组SIGKILLdetached: true保证子进程一并回收Windows 平台改用taskkill /pid pid /t /f终止整棵进程树避免孤儿进程。取消后状态被置为cancelled与运行中的running状态区分。4. 结果解析与展示审查结束后parseCliResult从 stdout 中截取 JSONstdout.indexOf({)起解析提取status、comments、warnings与summary含filesReviewed、totalTokens、inputTokens、outputTokens、elapsed。随后 ReviewSession.ts 的resultToState依据结果判定终态有评论 →donestatus completed_with_errors→failed否则 →empty无问题。评论卡片与编辑器内双向同步审查完成后CommentProvider.ts 负责把每条评论渲染为编辑器内的CommentThread评论控制器 ID 为ocr-review见 constants.ts同时在侧边栏生成评论卡片。两者通过commentSync消息同步状态。针对每条评论你可以执行三种操作对应 commands.ts 注册的命令操作命令 ID行为应用ocr.comment.apply用建议代码替换原文有suggestionCode或删除该段无建议保存后状态置为applied忽略ocr.comment.discard仅本地标记为discarded误报ocr.comment.falsePositive标记为falsePositiveapply实现细节值得注意插件通过 lineOffset.ts 的LineOffsetTracker记录每次应用后文件行数偏移record(path, startLine, lineCountDelta)后续应用同一文件的另一条评论时会用adjusted(path, line)校正行号避免前面的修改导致后面评论错位。评论若带建议代码thread 正文会渲染为diff代码块apply只在工作区模式下可用其余模式会弹出提示因为只有工作区模式能安全地原地修改文件。此外jumpTo支持从侧边栏卡片一键跳到编辑器对应行对于分支/提交模式插件会优先在已打开的 diff 编辑器中定位到挂载侧新增/修改挂右侧、删除挂左侧定位失败或文件缺失时给出明确的跳转失败原因。状态视图空 / 取消 / 失败插件为审查流程的每种终态都提供了独立视图空EmptyViewCLI 返回无评论时展示取消CancelledView用户主动取消时展示失败FailedViewCLI 退出码非 0 时展示支持一键重试并展示 CLI 返回的真实错误。失败信息的提取在extractCliError中实现优先从 stderr 中从后往前找Error:行去前缀否则取最后一行非空内容。当 CLI 退出码非 0 时runRaw会 reject 并携带该错误文本ReviewSession 捕获后先写入日志[ocr] msg再置状态为failed。配置管理与连通性测试插件内置配置面板ConfigPanel支持查看/编辑 LLM 配置读写~/.opencodereview/config.jsonWebView 端 camelCase ↔ 磁盘端 snake_case 自动转换自定义提供商管理增删改自定义提供商条目连通性测试testWithEntries会在隔离的临时 HOMEos.tmpdir()/ocr-test-home-*中生成一份临时配置再运行ocr llm test测试通过即删除临时目录——绝不污染真实配置。测试失败时返回 CLI 的真实错误消息模型切换通过状态栏或面板切换当前模型环境检查校验node/npm/ocr三者是否可用。插件开发与调试环境准备Node.js ≥ 18包管理器使用Yarn仓库自带yarn.lockVS Code ≥ 1.74全局可用的ocrCLI见上文「前置依赖」。启动开发环境cd extensions/vscode yarn install # 安装依赖 yarn watch # 监听式开发构建推荐改代码自动重新打包 out/然后在 VS Code 中打开extensions/vscode目录按F5启动 Extension Development Host调试配置已在.vscode/launch.json提供。在弹出的新窗口里打开一个有 Git 变更的项目即可在活动栏看到 Open Code Review 图标并发起审查。改了代码后WebView 改动需在开发宿主窗口里重新打开侧边栏或执行命令Developer: Reload WebviewsExtension Host 改动需重启调试调试工具栏的 ⟳ 或在宿主窗口按CmdR。常用脚本脚本作用yarn compile单次开发构建webpack developmentyarn watch监听式开发构建yarn build生产构建webpack production打包前自动执行yarn test运行 Jest 单测yarn lintESLint 检查yarn package生成可分发的.vsix安装包以上脚本与 package.json 中的定义一一对应其中vscode:prepublish会先执行yarn build。调试要点双端通信WebView 与 Extension Host 通过postMessage通信消息类型全部定义在 messages.tsWebviewToHost覆盖startReview、cancelReview、getGitState、openFileDiff、setConfig、testConnection、commentAction等HostToWebview覆盖logLine、stateChange、reviewDone、commentSync、config等。两端发收都走dispatch/handle定位问题先看这里CLI 调用所有ocr子命令由 CliService.ts 通过child_process.spawn执行。runRaw会在 CLI 退出码非 0 时 reject 并带上 stderr 中的Error:文本便于排查「审查失败/连接失败」配置读写ConfigService.ts 读取~/.opencodereview/config.json写入则委托ocr config set。WebView 端字段为 camelCase如useAnthropic磁盘/CLI 端为 snake_case如use_anthropic转换在 configParse.ts。架构解析Monolithic WebView Thin Extension Host插件的整体架构是Monolithic WebView Thin Extension HostWebView是独立构建的 Preact SPA还原原型的全部视觉与交互视图组件见webview/views/含RunningView、DoneView、FailedView、CancelledView、EmptyView、IdleView、ConfigView等Extension Host层轻薄只负责 CLI 调用、文件系统、Git 操作、编辑器评论两者通过postMessage通信用src/shared/中的 TypeScript 共享类型保证类型安全。源码目录结构src/ ├── extension/ Extension HostNode.jsservices / providers / commands ├── webview/ WebView SPAPreactviews / components / store / bridge └── shared/ 双端共享类型与 postMessage 协议不依赖 vscode从 extension.ts 的activate入口可以看到各服务的装配关系CliServiceCLI 进程管理→ConfigService配置读写→GitServiceGit 状态与 diff→CommentProvider编辑器评论→SidebarProvider/ConfigPanelProvider两个 WebView 面板并通过registerCommands暴露命令。一条评论从「CLI 输出」到「编辑器内 CommentThread」的完整调用链为CliService.review → ReviewSession.run → CommentProvider.show → resolveCommentAnchor解析挂载锚点 → createCommentThread渲染线程→ emitSync同步侧边栏resolveCommentAnchor需要区分工作区快照与 Git ref 快照工作区模式直接读取磁盘文件分支/提交模式则通过GitService的readFileAtRefgit show ref:path、buildCommentDiffUris等能力把评论定位到 diff 的左右两侧实现跨版本的精准挂载。构建与发布仅编译产物yarn build # 生产构建webpack production产物out/extension.jsExtension Hostout/webview.jsWebView SPA。构建发布包.vsixyarn package # vsce package --no-yarn该命令会自动触发vscode:prepublish→ 执行yarn build生产构建按.vscodeignore排除源码、测试、开发文件在当前目录生成open-code-review-vscode-version.vsix。打包工具为vscode/vsce已作为 devDependency 安装无需全局安装或联网下载。--no-yarn用于跳过 vsce 默认的 npm 依赖树校验本项目用 Yarn。发布包只包含运行必需文件package.json、README.md、resources/icon.svg、out/extension.js、out/webview.js。本地安装 / 验证code --install-extension open-code-review-vscode-version.vsix或在 VS Code 中扩展面板 → 右上角⋯→Install from VSIX…→ 选择生成的.vsix文件。发布到 Marketplace 时改用vsce publish需要 publisher 账号与 PAT日常分发用上面的.vsix即可。常见问题排查思路结合上面的源码分析遇到问题时可以按以下线索定位「审查失败/连接失败」看CliService.runRaw抛出的错误——它已提取 stderr 中Error:开头的真实文本若为空则显示CLI exited with code n此时可手动在终端执行同样的ocr review复现评论无法定位到行CommentProvider会记录jumpBlockReasons文件缺失提示「文件缺失」、行号未解析提示「行号未解析」startLine/endLine均 ≤ 0 时评论应用后行号错位插件依赖LineOffsetTracker校正偏移若连续应用多条评论后出现错位说明apply后的record未正确触发可检查是否绕过了apply而直接手动改文件配置不生效确认~/.opencodereview/config.json的字段命名snake_case或直接在插件配置面板重写一遍再由ocr config set落盘。License本插件基于 Apache-2.0 许可证开源仓库根目录的 LICENSE 为完整协议文本。在 CLI 侧cmd/opencodereview与扩展侧均声明了 SPDX 许可证头二次开发时请注意保留版权声明。【免费下载链接】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），仅供参考