Graphify:一键将代码库转化为知识图谱,AI 编程的终极理解引擎

在大型项目中理解代码架构一直是个难题——函数调用链散落各处、模块依赖关系隐晦、设计意图藏在注释里。今天要介绍的 Graphify 是一款革命性的开源工具,它能将任意代码库(以及文档、PDF、图片甚至视频)自动转化为可查询的知识图谱,让你像翻阅百科一样理解项目。

Graphify 在 GitHub 上线后迅速走红,目前已获得 84,000+ Star,今日 Trending 榜上有名,堪称开发者工具箱中的一匹黑马。

Graphify 是什么?

简单来说,Graphify 是一个 AI 编码助手的技能(skill)插件。在你的 AI 编码工具中敲 /graphify .,它就会扫描整个项目,生成一张包含所有代码概念、依赖关系和设计决策的知识图谱。

它支持 20+ AI 编码平台:Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot、Aider、OpenCode、Kilo Code、OpenClaw……几乎覆盖了市面上所有主流 AI 编码助手。

核心功能

🗺️ 代码到知识图谱的自动转化

Graphify 使用 Tree-sitter AST 解析器 分析代码,完全本地运行,不消耗任何 LLM Token,也不会把代码上传到任何服务器。它支持 36+ 种编程语言的 AST 解析,包括 Python、TypeScript、Go、Rust、Java、C/C++、C#、Swift、Kotlin、PHP 等等。

每个连接都带有置信度标签:

  • EXTRACTED:直接从源码中读取的显式关系
  • INFERRED:通过语义分析推导的关系

🔍 三种查询方式

  • graphify query "问题":用自然语言查询,返回相关的子图
  • graphify path A B:追踪两个概念之间的连接路径
  • graphify explain 概念:深入解释某个节点的所有连接

📊 智能社区检测

Graphify 使用 Leiden 算法 自动将图谱划分为子系统社区,让你一眼看出项目的模块划分。它还会标记”上帝节点”(连接最多的核心概念),帮你快速定位项目的关键部分。

💡 设计意图追踪

代码中的 # NOTE:# WHY:# HACK: 注释以及文档中的设计决策(ADR/RFC)都会被提取为独立节点,并与相关代码建立关联——这样你不仅知道代码做了什么,还能理解为什么这样做

🌐 超越代码

Graphify 不仅能处理代码,还支持将以下内容纳入同一张知识图谱:

  • Markdown / RST / HTML 文档
  • PDF 论文和文档
  • 图片(通过视觉模型理解)
  • 视频 / 音频(转录后分析)
  • SQL Schema / 数据库结构
  • Google Docs / Sheets

技术特色

⚡ 零 Token 成本的代码解析

代码部分使用 Tree-sitter 进行确定性 AST 解析,完全在本地完成,不需要 LLM。只有文档、PDF、图片、视频等非代码文件的语义分析才会调用模型 API。

📈 可扩展的插件架构

通过 pip extras 按需安装功能模块:

# PDF 支持
uv tool install "graphifyy[pdf]"

# Office 文档支持  
uv tool install "graphifyy[office]"

# 视频/音频转录
uv tool install "graphifyy"

# Neo4j / FalkorDB 图数据库导出
uv tool install "graphifyy[neo4j]"
uv tool install "graphifyy[falkordb]"

# 中文分词优化
uv tool install "graphifyy[chinese]"

🏆 实测性能

根据 Benchmark 数据:

  • LOCOMO 基准(300个长对话):recall@10 达到 0.497,远超 mem0(0.048)和 supermemory(0.149)
  • LongMemEval-S:QA 准确率 76%,与密集型 RAG 持平
  • 代码记忆场景中 信息丢失几乎为零

快速上手

# 1. 安装
uv tool install graphifyy

# 2. 注册技能到 AI 助手
graphify install

# 3. 在 AI 助手中使用
/graphify .        # 构建当前项目图谱
/graphify query "认证模块和数据层之间有什么联系?"
/graphify path UserService DatabasePool
/graphify explain RateLimiter

# 4. 查看可视化图谱
# 打开 graphify-out/graph.html 即可交互式浏览

适用场景

  • 接手遗留代码:快速理解大型项目的架构和模块关系
  • Code Review:一眼看清变更影响范围
  • 新人 Onboarding:让新成员快速掌握项目全貌
  • 技术文档生成:自动产出架构说明和模块依赖图
  • 长期记忆增强:为 AI 编码助手提供项目级上下文,告别反复解释

总结

Graphify 最大的价值在于它改变了我们理解代码的方式——从”逐文件阅读”变为”按关系遍历”。它不是另一个向量索引或 RAG 方案,而是一张真正的、可遍历的知识图谱。每个节点都有明确的来源,每条边都有置信度标签,你可以清楚地知道哪些是事实、哪些是推断。

对于任何需要跟大型代码库打交道的开发者来说,Graphify 无疑是 2026 年最值得关注的开源工具之一。


项目地址:https://github.com/Graphify-Labs/graphify

PyPI:graphifyy

License:MIT

© 版权声明
THE END
喜欢就支持一下吧
点赞15 分享