学习路径

阿里开源 AI 代码审查工具 — 架构理解 × 工具索引

← 返回视图入口

学习阶段

基础（10）进阶（17）高级（24）

Layer 0 · 基础

10 个节点
确定性工程 × Agent 混合架构核心架构G-A · 核心架构核心设计理念：能工程化保证的环节交给确定性流水线，动态决策交给 LLM Agent，各司其职
审查流水线核心架构G-A · 核心架构从 CLI 入口到评论输出的 8 步确定性+Agent 混合时序：diff→过滤→分派→并行子 Agent→反思→输出
Git Diff 获取与解析审查引擎G-B · 审查引擎三种 diff 来源（workspace/range/commit）+ unified diff 解析器（ParseDiffText/ParseHunks）
ocr config命令行G-C · 命令行工具配置管理：set/unset 键值 + provider/model 交互式 TUI 向导（Bubble Tea），自动测试连通性
ocr 命令总览与安装命令行G-C · 命令行工具安装方式（npm/脚本/二进制/源码）、cobra 命令树、全局参数与 version/completion 子命令
ocr review命令行G-C · 命令行工具基于 git diff 的审查主命令：workspace/range/commit 三模式，--format text|json|sarif，--resume 断点续审
ocr scan命令行G-C · 命令行工具全文件扫描：无需 git 历史，--path 指定目录，--batch by-language/by-directory，PLAN/DEDUP/SUMMARY 三阶段
Provider 体系配置模型G-D · 配置与模型27 个内置 LLM provider（anthropic/openai/dashscope/deepseek/z-ai/kimi/...）+ 自定义端点，覆盖国内外主流模型
场景：审查 PR/分支变更使用场景G-S · 使用场景索引日常审查入口：合并基准模式审 feature 分支、单 commit 审查、GitHub PR 上自动触发
场景：审计陌生代码库使用场景G-S · 使用场景索引无 git 历史/无有意义 diff 时：全文件扫描，按语言/目录分束，DEDUP 去重，项目级总结

Layer 1 · 进阶

17 个节点
规则引导分派核心架构G-A · 核心架构确定性文件选择/过滤/分束机制：用规则而非语言模型决定审什么、怎么分组
受限工具集审查核心架构G-A · 核心架构6 个审查专用工具（file_read/file_find/code_search/file_read_diff/code_comment/task_done）经 ReAct 循环驱动文件级子 Agent
文件分束审查引擎G-B · 审查引擎将关联文件归并为审查单元（en/zh properties 捆审）；scan 按 by-language/by-directory 分桶，delegate 按规则文本聚簇
文件选择与过滤审查引擎G-B · 审查引擎whyExcluded 过滤链：binary→用户 exclude→include 覆盖→扩展名白名单→默认路径黑名单
行号定位回退链审查引擎G-B · 审查引擎五级回退：hunk 新侧→hunk 旧侧→全文件滑动窗口→跨文件重定位→LLM 重定位，保证评论落在真实行
ocr delegate命令行G-C · 命令行工具委托模式：OCR 只做文件选择+规则解析输出 spec JSON，编码 Agent 用自己的 LLM 审查，无需 OCR API Key
ocr session命令行G-C · 命令行工具会话管理：list/show/comments 子命令，--json 输出，按 severity/category 过滤评论
ocr viewer命令行G-C · 命令行工具本地 WebUI 会话查看器（默认 localhost:5483）：浏览器回放审查会话 JSONL，hostGuard 防 DNS-rebind
配置优先级配置模型G-D · 配置与模型5 级解析：显式 --provider/--model > config.json > OCR_LLM_* 环境变量 > ANTHROPIC_* 环境变量 > shell RC
LLM 协议层配置模型G-D · 配置与模型4 种协议：Anthropic Messages / OpenAI Chat Completions / OpenAI Responses / Bedrock SigV4，统一 CompletionsWithCtx 接口
四层规则链配置模型G-D · 配置与模型custom(--rule) > project(.opencodereview/rule.json) > global(~/.opencodereview/rule.json) > system(内嵌)，doublestar glob 匹配
GitHub Actions 集成集成生态G-E · 集成生态composite action（action.yml）：24 入参/6 出参，fork-safe PR 解析，评论发布脚本（sticky/增量 IoU 去重/路由）
AACR-Bench 基准工程保障G-F · 工程保障50 仓库/200 真实 PR/10 语言/1505 人工标注问题的审查基准（HuggingFace 开源），驱动 Precision/F1/token 量化优化
Token 计费与成本控制工程保障G-F · 工程保障tiktoken-go 计费（o200k/cl100k_base），预算前瞻截断、80% token 大文件丢弃、prompt-cache 亲和键命中前缀缓存
场景：接入 CI 流水线使用场景G-S · 使用场景索引让审查自动跑在每个 MR/PR：GitHub Actions 一步复用、GitLab/Gerrit 等加 post_review.py 回贴评论
场景：配置模型与规则使用场景G-S · 使用场景索引首次上手必做：选 provider/模型/API Key，按项目定制规则（rule.json）、过滤路径、调并发与预算
场景：免 Key 委托审查使用场景G-S · 使用场景索引没有 LLM API Key 或想用宿主 Agent 模型：ocr delegate preview/rule 输出 spec，编码 Agent 自己审

Layer 2 · 高级

24 个节点
文件级并行与上下文隔离核心架构G-A · 核心架构每文件一个子 Agent 任务、独立上下文，信号量限流（默认 8 并发），防 token 雪球
独立反思核心架构G-A · 核心架构证伪优先的评论过滤器：只看到 diff 与评论，用 Ground A/B 双地面验证消除幻觉评论
上下文三区压缩审查引擎G-B · 审查引擎frozen（前 2 条）+ compress（LLM 摘要进 previous_review_summary）+ active（最近 K 轮），60%/80% 双阈值触发
Run Manifest 覆盖度契约审查引擎G-B · 审查引擎ocr.run-manifest/v1：注册/封印/完成/失败四态跟踪每文件审查状态，8 类失败分类，预算截断≠运行失败
跨文件与 LLM 重定位审查引擎G-B · 审查引擎评论目标代码在别处时：纯字符串匹配迁移（唯一命中才动）+ LLM 从 diff 重生成代码块再定位
断点续审与指纹复用审查引擎G-B · 审查引擎sha256(mode+old+new+diffText) 指纹复用已完成文件评论；SealedInput 冻结 commit 端点防 ref 漂移
全文件扫描引擎审查引擎G-B · 审查引擎无 diff 审查：枚举→过滤→分束→批处理→DEDUP 去重→项目总结，ScanItem 携带全文件内容
会话 JSONL 持久化审查引擎G-B · 审查引擎~/.opencodereview/sessions/ 下 JSONL 记录全部任务记录（Plan/Main/压缩/重定位/反思），可回放可审计
ocr llm命令行G-C · 命令行工具LLM 工具：test 发送测试对话、providers 列出全部 27 个内置 provider
ocr rules命令行G-C · 命令行工具规则调试：rules check <file> 显示命中规则层（custom/project/global/system）与匹配模式
MCP 扩展配置模型G-D · 配置与模型Model Context Protocol：stdio 子进程 + remote Streamable HTTP 双传输，外部工具接入审查工具链（allowlist 过滤）
其他 CI 集成集成生态G-E · 集成生态GitLab CI / Gerrit Jenkinsfile / GitFlic CI / Bitbucket Pipelines / 阿里云 Codeup CI + post_review.py 评论回贴
Claude Code 插件集成生态G-E · 集成生态claude-code 插件：/open-code-review:review 与 :delegate-review 斜杠命令，marketplace 安装
Codex 插件集成生态G-E · 集成生态.codex-plugin/plugin.json + skills：以 @Open Code Review review ... 调用，interface Read capability
Cursor 插件集成生态G-E · 集成生态.cursor-plugin/plugin.json + 可移植 skill，复制到 ~/.cursor/plugins/local/ 手动安装
OpenCode 原生插件集成生态G-E · 集成生态@opencode-ai/plugin：tool() 注册原生审查工具，spawn 'ocr review --audience agent --format json'，参数互斥校验
QCA Forward 委托集成生态G-E · 集成生态QCA 宿主模型运行委托模式：只允许 ocr delegate preview/rule（只读），OCR 侧零 LLM 调用
通用 Agent Skill集成生态G-E · 集成生态skills/open-code-review/SKILL.md：四步 review/filter/fix/report 工作流 + delegate 六步 skill，兼容任意 skill 型 Agent
VSCode 扩展集成生态G-E · 集成生态React webview（侧边栏/配置面板/评论面板）+ CliService 封装，i18n en/zh，webpack+jest
构建与发布体系工程保障G-F · 工程保障npm 包（6 平台 optionalDependencies）+ GitHub Release 二进制 + install.sh/ps1，Makefile 覆盖率 90% 门禁
重试与错误分类工程保障G-F · 工程保障SDK 内建 max-retries=5 + 可配置 RetryCodes；错误按 ErrorClass(timeout/cancelled/network/provider/unknown)+FailurePhase 分类入报告
安全设计工程保障G-F · 工程保障路径穿越防护（WithinBase+EvalSymlinks）、git grep 拒 '..'、viewer hostGuard 防 DNS-rebind、manifest 哈希不含密钥
OpenTelemetry 遥测工程保障G-F · 工程保障console/OTLP 双导出（grpc/http），审查事件与指标埋点，OCR_ENABLE_TELEMETRY 环境变量开启
场景：扩展审查能力使用场景G-S · 使用场景索引规则不够用？MCP 接入外部工具、自定义规则文件、--rule 临时规则、委托模式喂给任意 Agent

拓扑学习路径

全图谱拓扑学习路径（prerequisite 边驱动，51 步）
1. 文件级并行与上下文隔离2. MCP 扩展3. Provider 体系4. ocr 命令总览与安装5. 全文件扫描引擎6. 会话 JSONL 持久化7. 其他 CI 集成8. Claude Code 插件9. Codex 插件10. Cursor 插件11. GitHub Actions 集成12. OpenCode 原生插件13. QCA Forward 委托14. 通用 Agent Skill15. VSCode 扩展16. AACR-Bench 基准17. 构建与发布体系18. 重试与错误分类19. 安全设计20. OpenTelemetry 遥测21. Token 计费与成本控制22. 场景：配置模型与规则23. LLM 协议层24. 配置优先级25. ocr llm26. ocr scan27. Run Manifest 覆盖度契约28. ocr session29. ocr viewer30. 场景：接入 CI 流水线31. 确定性工程 × Agent 混合架构32. ocr config33. 场景：审计陌生代码库34. 断点续审与指纹复用35. 审查流水线36. 规则引导分派37. 受限工具集审查38. 独立反思39. ocr review40. Git Diff 获取与解析41. 文件分束42. 四层规则链43. 上下文三区压缩44. 场景：审查 PR/分支变更45. 文件选择与过滤46. ocr delegate47. ocr rules48. 场景：扩展审查能力49. 行号定位回退链50. 场景：免 Key 委托审查51. 跨文件与 LLM 重定位