code-review-graph：用本地代码知识图为 AI 编码工具提供评审上下文

工具定位

AI 编码工具在评审一次改动时，常要重读大量代码。code-review-graph 用 Tree-sitter 解析仓库为 AST，把函数、类、导入等节点与调用、继承、测试覆盖等边组成图，并通过 MCP 向助手提供紧凑的上下文，使其只需读取改动触及的文件。

工作方式

• 构建：code-review-graph build 解析整个代码库；图保存在 .code-review-graph/ 下的单个 SQLite 文件中，不依赖外部数据库或云服务。
• 增量更新：钩子、git pre-commit 钩子和 watch 模式触发更新，只重新解析 SHA-256 哈希发生变化的文件。README 给出的实测是：约 3,000 文件的仓库中，两文件改动的钩子路径约 2.5 秒，其中约 1.4 秒为进程启动。
• 影响范围分析：文件变化时沿调用、导入和测试边追踪可能受影响的调用方、依赖方与测试。
• 安装：install 会检测本机 AI 编码工具并写入 MCP 服务条目，支持 Codex、Claude Code、Cursor、Windsurf、Zed、Continue、OpenCode、Gemini CLI、Qwen、Kiro、Qoder、GitHub Copilot 等，也可用 --platform 单独配置；要求 Python 3.10+。

语言与框架覆盖

解析器覆盖 Python、JavaScript/TypeScript/TSX、Go、Rust、Java、C/C++、C#、Ruby、Kotlin、Swift、PHP、Scala、SQL、Terraform、Vue/Svelte 单文件组件、Jupyter/Databricks 笔记本等；对 PHP 提供有仓库边界的 Composer PSR-4 解析，对 Java 提供 Spring 注入调用与 Temporal 工作流边。未覆盖的语言可在 .code-review-graph/languages.toml 中映射扩展名和节点类型，使用 tree_sitter_language_pack 内置语法。

其他能力与限制

工具还包括语义搜索（可选向量嵌入）、D3.js 可视化、社区检测、风险评分评审和可选的 GitHub Action（在 CI 内构建并查询图，源码不外发）。

README 自述的限制值得注意：所谓“影响召回率 1.0”是与图同源的循环上界；co-change 模式在 2026-08-02 的采集中返回 0 个预测文件，尚不可用；单文件小改动的图上下文可能超过直接读文件；搜索排序以及 JavaScript/Go 的流程检测仍需改进。基准数字均绑定指定快照 SHA 与配置，不能视为当前仓库的测量值。