【开源】code-review-graph：AI 代码审查神器，减少 65% Token 消耗-壹联网络

# code-review-graph：让 AI 代码审查节省 65% Token 的神器

## 项目介绍

code-review-graph 是一个开源的本地知识图谱工具，专门用于优化 AI 编码助手在代码审查场景中的 token 消耗。传统 AI 编程工具在每次审查任务时都会重新阅读整个代码库，浪费大量 token。code-review-graph 通过 Tree-sitter 构建代码的结构化地图，以增量方式追踪变化，并通过 MCP（Model Context Protocol）协议为 AI 助手提供精确的上下文，让 AI 只读取真正相关的文件。

根据项目实测，在 6 个真实代码仓库上平均减少 8.2 倍的 token 使用量；在大型 monorepo 中，效果更为显著——Next.js 仓库的测试显示，原本需要读取 27,732 个文件，优化后只需读取约 15 个文件，减少了 49 倍。

## 为什么需要 code-review-graph？

想象一下，让 AI 助手审查一个包含数万个文件的大型项目。传统的做法是让 AI 读取整个代码库——这不仅消耗大量 token，而且 AI 往往因为上下文过长而遗漏关键信息。

code-review-graph 的出现，就是为了解决这个问题。它不是让 AI”大海捞针”，而是让 AI 能够”精准定位”。

## 核心特色

**blast-radius 分析（爆炸半径分析）**

当某个文件发生变更时，知识图谱会追踪所有可能的调用方、依赖方和受影响测试。这就是变更的”爆炸半径”。AI 只需读取这些受影响文件，而非扫描整个项目。

**增量更新，2 秒内完成**

每次 git commit 或文件保存时，Hook 触发图谱差异对比，通过 SHA-256 哈希检查找到变更文件及其依赖项，只重新解析发生变化的部分。一个包含 2,900 个文件的代码库，增量索引时间在 2 秒以内。

**支持 19 种语言 + Jupyter Notebook**

覆盖主流编程语言，包括 Python、JavaScript、TypeScript、Rust、Go、Java、C++ 等，并支持 Jupyter Notebook 的代码分析。

**一键安装，自动配置**

“`bash
pip install code-review-graph
code-review-graph install # 自动检测并配置所有支持的平台
code-review-graph build # 解析代码库构建知识图谱
“`

安装命令会自动检测你使用的是 Codex、Claude Code、Cursor、Windsurf、Zed、Continue、OpenCode 还是 Antigravity，并写入正确的 MCP 配置文件。

**Monorepo 场景优化**

大型 monorepo 是 token 浪费最严重的场景，code-review-graph 对此做了专门优化。即使是拥有数万文件的巨型仓库，也能将审查范围精确到最小相关文件集。

## 安装步骤

### 前置要求

– Python 3.10 或更高版本
– 推荐安装 uv（Python 包管理器，可显著提升体验）

“`bash
# 安装 uv（如果还没有）
curl -LsSf https://astral.sh/uv/install.sh | sh
“`

### 安装 code-review-graph

“`bash
pip install code-review-graph
# 或
pipx install code-review-graph
“`

### 初始化并构建图谱

“`bash
# 自动检测并配置所有 AI 编程工具
code-review-graph install

# 构建代码知识图谱（首次需要约10秒处理500个文件）
code-review-graph build
“`

### 针对特定平台手动配置

“`bash
code-review-graph install –platform claude-code # 仅配置 Claude Code
code-review-graph install –platform cursor # 仅配置 Cursor
code-review-graph install –platform codex # 仅配置 Codex
“`

配置完成后，重启编辑器或 AI 编程工具即可生效。

## 使用方法

### 基础用法

安装配置完成后，在项目中直接向 AI 助手提问：

“`
请帮我审查这个项目的代码，重点关注最近提交的安全问题
“`

AI 助手会通过 MCP 协议查询知识图谱，自动获取变更的爆炸半径信息和风险评分，然后只读取相关文件进行审查。

### 查看图谱状态

“`bash
code-review-graph status # 查看当前图谱状态
code-review-graph stats # 查看统计信息（文件数、关系数等）
code-review-graph update # 手动触发增量更新
“`

### 查看爆炸半径

“`bash
code-review-graph blast-radius –file src/auth/login.py
“`

会输出 login.py 文件变更可能影响的所有调用方、依赖方和测试文件。

## 适用场景