code-review-graph 开源：给 AI 审查装上爆炸半径分析，Token 最高省 528 倍

大多数AI编码工具默认"给越多上下文越好"，但事实恰恰相反。
精准的结构化上下文，远优于海量的原始文本。
刚好前几天我发现了code-review-graph这个开源项目。它的slogan很直接："Stop burning tokens. Start reviewing smarter."

这个项目的核心思想和我手动做的事情一样，但它把整个流程自动化了。它构建代码库的结构化依赖图，让AI助手只读取真正相关的文件。

工作原理

code-review-graph的工作流程可以分为三步：
第一步：构建图谱。它用Tree-sitter解析整个代码库，提取出函数、类、导入、调用关系、继承关系等，把这些信息存储到一个SQLite数据库里，形成一个结构化的知识图谱。
第二步：增量更新。当文件发生变化时，它不是重新解析整个仓库，而是通过SHA-256哈希检查，只重新解析变化的文件及其依赖。一个2900个文件的项目，增量更新只需要不到2秒。
第三步：精准查询。当AI需要审查代码时，它查询这个图谱，通过"爆炸半径分析"（Blast-radius Analysis）找出所有受影响的文件，然后只把这些文件提供给AI。

核心亮点

1. 爆炸半径分析——精准定位影响范围

当你修改一个文件时，code-review-graph会追踪所有调用者、依赖项和相关测试。
比如你改了utils/validator.py里的validate_email函数，它会找出所有调用这个函数的文件、所有导入了这个模块的文件，以及所有测试这个函数的测试文件。
这样AI就只读这些受影响的文件，而不是整个代码库。

2. 增量更新——2秒内完成重建

这是code-review-graph最惊艳的特性之一。
传统的代码索引工具每次更新都要重新扫描整个仓库，大项目可能要几分钟。但code-review-graph通过SHA-256哈希检查，跳过未修改的文件，只重新解析变化的部分。
官方数据显示：一个2900个文件的项目，增量更新时间不到2秒。

3. Monorepo杀手——27700个文件变15个

大型Monorepo是AI代码审查的重灾区。一个Next.js项目有27732个文件，让AI全部读一遍简直是灾难。
但code-review-graph通过图谱过滤，能把27700+文件排除在审查上下文之外，实际只读取约15个相关文件。

4. 30+语言支持——几乎覆盖所有主流语言

code-review-graph 支持的语言包括：Python、JavaScript/TypeScript/TSX、Go、Rust、Java、C/C++、C#、Ruby、Kotlin、Swift、PHP、Scala、Solidity、Dart、R、Perl、Lua/Luau、Objective-C、Shell、Elixir、Zig、PowerShell、Julia、SQL、Vue/Svelte SFCs、Astro，甚至包括Jupyter Notebook。
而且添加新语言非常简单，不需要修改代码，只需要在.code-review-graph/languages.toml里配置一下就行。

性能基准

项目官方做了6个真实开源仓库的基准测试，数据非常惊人：

快速上手

安装方式

# 方式一：pip安装
pip install code-review-graph

# 方式二：pipx安装（推荐，隔离环境）
pipx install code-review-graph

# 方式三：uv安装（最快）
uv pip install code-review-graph

配置平台

安装完成后，运行install命令，它会自动检测你当前使用的AI编码工具，并配置好MCP连接：

code-review-graph install

如果你只想配置特定平台，可以用--platform参数：

code-review-graph install --platform cursor      # 仅配置Cursor
code-review-graph install --platform claude-code # 仅配置Claude Code
code-review-graph install --platform copilot     # 仅配置GitHub Copilot
code-review-graph install --platform gemini-cli  # 仅配置Gemini CLI

支持的平台包括：Codex、Cursor、Claude Code、Gemini CLI、Kiro、GitHub Copilot (VS Code)、GitHub Copilot CLI。

构建图谱

进入你的项目目录，运行build命令：

code-review-graph build

初次构建大约需要10秒（500文件项目）。构建完成后，你就可以在AI助手中使用了。

在AI助手中使用

打开你的AI编码工具（如Cursor、Claude Code等），然后直接问：

Build the code review graph for this project

或者直接让它审查代码：

Review this PR and identify potential issues

AI会自动调用code-review-graph查询相关文件，只读取必要的代码。

写在最后

不论你是：
1.AI编码工具重度用户——每天用Cursor、Claude Code等工具写代码
2.大型项目开发者——在Monorepo或几千个文件的项目中工作
3.成本敏感型团队——不想为浪费的Token支付高额费用
4.追求审查质量——希望AI给出更精准的代码分析
那么code-review-graph都值得一试。
GitHub：https://github.com/tirth8205/code-review-graph