← 返回项目库

代码库智能图谱审查工具

把代码文件、符号和调用关系整理成可交互图谱,帮助审查代码结构与依赖。

code-review-graph 是一个可本地运行的代码知识图谱工具,支持全量构建、社区聚合、节点搜索与关系可视化,适合开发者理解陌生代码库。

真实界面

项目截图

共 6 张

视图模式
节点
关系
文件
社区
适应屏幕

Capabilities

核心功能

从代码仓库构建文件、符号和关系图谱
按社区聚合大型代码库并展示跨社区关系
支持文件级与节点级图谱视图
按节点类型筛选并搜索节点
可视化调用、导入、继承和依赖关系
查看社区、节点详情和关系统计
通过本地 HTTP 页面预览交互式图谱

适用场景

新成员快速理解陌生代码库的模块边界
代码审查时定位调用链、依赖和影响范围
技术负责人梳理系统架构与跨模块关系

适合谁

需要快速理解大型或陌生代码库结构的开发团队、代码审查者和技术负责人。

商业化思路

MIT 开源自托管;可提供代码库接入、团队部署、二次定制与技术培训服务。

你会拿到什么

  • 完成简体中文 UI 适配的 Python 源码、测试和 MIT LICENSE
  • 可复现安装构建说明、真实运行截图与验证记录
  • 上游来源与中文修改范围说明

部署流程

  1. 1准备 Python 3.10+ 与 uv,在源码目录执行 uv sync --locked。
  2. 2对目标代码库执行 uv run code-review-graph build --repo <repo> --data-dir <data-dir>。
  3. 3执行 uv run code-review-graph visualize --repo <repo> --data-dir <data-dir> --mode auto,并用浏览器打开生成的本地页面。

真实验证结果

已在绑定源码工作区完成 uv sync --locked、Python compileall 和全量测试(1962 passed、5 skipped、2 xpassed);真实构建得到 237 个文件、4457 个节点和 34423 条边,并从最终源码生成社区聚合交互页面。6 张截图均来自固定本地 HTTP 运行时,均为 HTTP 200,无登录页、错误页、破图、控制台错误或横向溢出;D3.js CDN 与可选本地 LLM 运行时限制已披露。

部署前须知

核心图谱构建和可视化已在本地验证;可视化页面依赖浏览器加载 D3.js CDN,完全离线环境需要自行提供该依赖。上游还包含本地 LLM/Ollama 相关能力,本次交付未配置该可选运行时;大型代码库的节点级视图可能较密集,建议优先使用社区聚合视图。

部署难度

中等

最低配置

Python 3.10+;本地运行需要 uv 或等价 Python 打包工具;可视化页面使用浏览器加载 D3.js CDN。

开源许可证

MIT License

最后验证

2026-09-02

技术栈

PythonSQLitetree-sitterNetworkXD3.js

授权说明

源码包含 MIT LICENSE;交付包保留原许可证。已做简体中文 UI 适配与测试补充;第三方依赖按各自上游许可证执行。

Release notes

版本记录

1 个已发布版本

vcn-f6122b03dea3a 当前推荐

完成简体中文核心图谱界面适配,补充可复现构建与中文 UI 回归测试,生成社区聚合视图并通过 6 张真实运行界面验收。

部署要求:Python 3.10+;使用 uv 或等价工具安装锁定依赖;本地可视化页面需要浏览器访问 D3.js CDN。

已知问题:可选本地 LLM/Ollama 运行时未配置;大型代码库的节点级视图可能较密集,离线环境需自行提供 D3.js 依赖。

登录后领取