code-review-graph 是什么?

code-review-graph 是一个面向 AI 编码工具的本地知识图谱:用 Tree-sitter 把你的代码库解析成结构图(函数/类/导入为节点,调用/继承/测试覆盖为边),增量跟踪变更,并通过 MCP 给 AI 助手提供精准上下文,让它「只读该读的部分」。其卖点是大幅省 token——官方称代码评审约 6.8 倍、日常编码任务最高 49 倍的 token 削减。许可为 MIT,Python(3.10+),约 17,268 stars,发布在 PyPI,并支持 Claude Code、Codex、Cursor、Windsurf、Copilot 等多种平台。

⭐ 17,060 Stars 🍴 1,838 Forks Python 作者: tirth8205
来源:README.md(首段、How It Works、Quick Start、徽章);GitHub 仓库元数据(stars=17268、license=MIT、language=Python) 查看 GitHub 仓库 →

为什么值得关注

AI 编码工具在每个任务上反复重读整个代码库,既慢又烧 token。code-review-graph 针对这一痛点:把代码库建成图、只在评审/编码时算出「必须读」的最小文件集,显著降低 token 消耗(在 6 个真实仓库上平均约 8.2 倍)。一条命令自动适配十多种 AI 编码平台、增量更新、本地运行,实用性强,因而获得高关注。截至数据采集约 17,268 stars。

来源:README.md(首段、The Token Problem 图、Quick Start 的多平台);GitHub 仓库元数据(stars=17268)

核心功能

Tree-sitter 代码知识图谱

把仓库解析成 AST 并存为图(函数/类/导入为节点,调用/继承/测试覆盖为边),作为 AI 的结构化上下文来源。

来源:README.md(How It Works)
爆炸半径分析省 token

文件变更时追踪所有受影响的调用方/依赖方/测试,算出最小评审/阅读文件集,AI 只读该读的——官方称评审约 6.8×、日常任务最高 49× token 削减。

来源:README.md(首段、Blast-radius analysis)
一键多平台 MCP 集成

code-review-graph install 自动检测并配置十多种 AI 编码平台(Claude Code/Codex/Cursor/Windsurf/Copilot 等)的 MCP、hooks/skills 与图感知指令。

来源:README.md(Quick Start、Supported Platforms 图)
增量更新、本地运行

首次建图约 10 秒(500 文件项目),之后随每次编辑和 git commit 自动增量更新;图存本地 SQLite,无需上传代码。

来源:README.md(Quick Start、How It Works)

技术架构

工作流是:用 Tree-sitter 把仓库解析成 AST,存为 SQLite 中的图(节点=函数/类/导入,边=调用/继承/测试覆盖),评审时查询计算 AI 需要读的最小文件集。核心是「爆炸半径(blast-radius)分析」——某文件变更时,图会追踪每个可能受影响的调用方、依赖方和测试,AI 只读这些文件而非全量扫描。它通过 MCP 把图能力暴露给 AI 助手;一条 code-review-graph install 命令自动检测你装了哪些 AI 编码工具(Codex、Claude Code、Cursor、Windsurf、Zed、Continue、OpenCode、Antigravity、Qwen、Qoder、Kiro、GitHub Copilot 等),为每个写正确的 MCP 配置、安装平台原生 hooks/skills、并注入图感知指令。建图后随每次文件编辑和 git commit 自动增量更新。

来源:README.md(How It Works、Blast-radius analysis、Architecture pipeline、Quick Start);git tree(.mcp.json、.github 指令文件)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Tree-sitter(AST 解析)Tree-sitter(A… MCP(向 AI 助手暴露能力)MCP(向 AI 助手… SQLite(本地图存储)SQLite(本地图… Tree-sitter 代码知识图谱Tree-sitter 代码知识… 爆炸半径分析省 token 一键多平台 MCP 集成 增量更新、本地运行 code-review-graph 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Python(3.10+)框架Tree-sitter 解析 + SQLite 图存储 + MCP 服务
Tree-sitter(AST 解析)MCP(向 AI 助手暴露能力)SQLite(本地图存储)
PyPI 包(pip/pipx/uvx 安装);GitHub Actions CI/publish;本地运行
来源:README.md(首段、Quick Start、徽章);git tree(.mcp.json、.github/workflows/)

快速上手

pip install code-review-graph(或 pipx/uvx 安装),然后 code-review-graph install 一键自动检测并配置你已装的 AI 编码工具(也可 --platform 指定单个平台,如 claude-code、cursor、codex 等),再 code-review-graph build 解析代码库。需 Python 3.10+,装了 uv 体验更好(MCP 配置会优先用 uvx)。配置后重启编辑器/工具,在项目里让 AI 助手「Build the code review graph for this project」。500 文件项目首次建图约 10 秒,之后随文件编辑与 git commit 自动增量更新。
来源:README.md(Quick Start 段落)

使用场景

适合用 AI 编码工具且在意 token 成本/上下文精度的开发者与团队:做代码评审时只让 AI 读受改动影响的文件(爆炸半径),而非全量扫描;日常编码时给 AI 更精准、更省的上下文;在大型代码库上尤其能显著降低 token 消耗与等待。它本地运行、不上传代码,适合对代码隐私有要求的场景,并能一套图服务多种 AI 平台。

来源:README.md(首段、Blast-radius analysis、Supported Platforms)

优势与局限

优势

  • 针对「AI 反复重读全库烧 token」的真实痛点,省 token 效果显著
  • Tree-sitter 图 + 爆炸半径分析,给 AI 精准最小上下文
  • 一键适配十多种 AI 编码平台(MCP),增量更新、本地运行不上传代码
  • MIT 开源、PyPI 发布、多语言文档、CI 完善

局限

  • 省 token 倍数取决于代码库结构与任务类型,实际收益因项目而异
  • 依赖 Tree-sitter 对语言的解析覆盖,部分语言/动态调用关系可能捕捉不全
  • 需为各平台配置 MCP 并重启工具,有一定安装步骤
  • 图的准确性影响上下文质量,复杂依赖/反射等仍可能需人工补充
来源:README.md(首段、How It Works、Quick Start)

最新版本

本页未列出具体版本号;项目以 PyPI 包持续发布(带 CI 与 publish 工作流),变更记录在 CHANGELOG.md。更新以扩展支持的 AI 编码平台、完善 Tree-sitter 解析与图查询、提升增量更新与多平台 install 体验为主。

来源:README.md(Quick Start 多平台、徽章);git tree(CHANGELOG.md、.github/workflows/publish.yml)

总结评价

code-review-graph 精准命中了 AI 编码的一个真实痛点:与其让 AI 每次重读全库烧 token,不如用 Tree-sitter 建一张代码知识图,靠爆炸半径分析只喂给它该读的文件。省 token 效果显著、一键适配十多种平台、增量更新且本地运行不上传代码,对在意成本、上下文精度和代码隐私的团队很实用。要清楚省 token 倍数因项目而异、依赖 Tree-sitter 的语言覆盖、且需为各平台配置 MCP。作为给 AI 编码「降本增效」的本地图谱工具,它定位精准、工程完善、跨平台友好。

来源:综合 README.md 的痛点定位、图与爆炸半径机制及多平台支持
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 13:12. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件