graphify:把代码、文档、PDF 变成一张 AI 能查的知识图谱

Graphify-Labs/graphify

📦 3 Parts + Conclusion

👉 滑动

项目一大，问 AI“这个功能到底在哪实现的”，它就开始挨个文件搜索、连着读十几个文件，答案还容易跑偏。graphify 先把整个项目编成一张可查询的知识图谱，之后让 AI 查图，而不是翻文件。

接手一个陌生的老项目，或者隔了半年回头看自己写的东西，最想知道的往往不是某个词出现在哪个文件，而是这几个模块到底怎么串起来的。

默认情况下，AI 编程助手只能靠搜索加逐个读文件来回答这类问题。文件少还凑合，项目一大就有两个麻烦：一是贵，每次都要把原文塞进上下文；二是散，关掉窗口，它对这个项目的印象基本就清零了。

graphify 的做法是先建图：把项目里的代码、文档、PDF、图片扫一遍，抽成节点和边，存到项目下的 graphify-out/ 目录。之后你问问题，AI 查的是这张图，而不是重读一遍文件。

有一点值得单独说：它明确不做向量检索，没有 embeddings，没有向量库。给你的是一张真的图，可以沿着边一步步走。

— graphify 项目标识（来源：官方仓库 docs/graphify-card.png）

一次运行落下三个文件，各管一件事：

官方 README 里的效果图，是用 FastAPI 的代码库跑出来的：每个节点是一个概念，颜色是自动识别出的社区，整张图在 graph.html 里可以点开看。

— graphify 跑 FastAPI 代码库生成的知识图谱（来源：官方仓库 docs/graph-hero.png）

日常用到的就三条命令：

官方 README 给了 explain 的真实输出：

留意 Source 那一行：直接给出文件和行号，而不是“大概在路由相关的地方”。

图会给出关系，但关系有真有假。graphify 给每条边打一个置信标签：

官方文档说明，INFERRED 的分数是分档给的：0.95 几乎确定，0.85 证据较强，0.75 合理但没明说，0.65 只靠命名相似，0.55 属于猜测。

官方自己的工作示例里能看出效果。仓库 worked/httpx/ 放了一份按 httpx 架构仿写的 6 文件 Python 代码库，官方公布输出是 144 个节点、330 条边、6 个社区，53% EXTRACTED、47% INFERRED、0% AMBIGUOUS。报告里还专门提醒：Client 身上挂着 12 条推断出来的关系，需要人工核一下。

graphify 把处理分成三遍，代价完全不同：

它还能读 SQL schema 和 MCP 配置，把包管理文件里的依赖也做成节点。

另外要说明，官方 README 写 37 种 tree-sitter 语法，官网写 36 种，how-it-works 文档又写 25 种语言。口径不一，本篇不写死，以你安装的版本为准。

想先感受一下，官方仓库的 worked/example/ 是最小的一份材料——7 个文件、两种语言的小型文档处理流水线：

操作只有一步：在这个目录里打开 AI 编程助手，输入 /graphify ./raw。

官方写明了预期结果：api.py 会成为中心节点连着另外四个模块；storage.py 是连接数最高的节点；两个 markdown 文件会连到它们讨论的代码模块，大致分成 2 个社区。

这份示例没有 PDF 和图片，全程只跑 AST 和 markdown，语义提取的 token 成本是零。跑完可以接着问“哪些地方直接调用了 storage”“parser 到 processor 的最短路径是什么”，图存在 graphify-out/ 里，跨会话保留。仓库每个 worked/ 目录都同时放了原始输入和真实输出，可以自己跑一遍对照。

最容易被说错的一点：graphify 其实是两个东西。

只用开源这套可以一分钱不花，但有几个边界要提前知道：

环境要求不高：Python 3.10 或以上，推荐用 uv 或 pipx 装，它们会把包放进独立环境。

然后在项目目录里打开 AI 助手，输入一行 /graphify . 就结束了。

两个容易踩的坑，官方专门标了出来：

以上命令与预期结果均按官方 README 与官方示例整理，未在本机实际执行，以官方文档为准。

判断标准其实很简单：你会不会反复问 AI“这个项目是怎么组织的”。

适合的情况：接手陌生项目、要快速摸清大型仓库的分层；多语言多模块，靠人肉捋依赖不现实；希望 AI 顺带理解文档和设计稿，而不只是代码；代码不能出本机的场景。

不太适合的也说清：单文件小脚本，建图的开销比收益大——官方自己的 6 文件基准里 token 收益接近 1 倍；以及你只想要语义搜索，并不关心调用关系。

官方入口：GitHub 仓库 Graphify-Labs/graphify，官网 graphify.com。仓库 worked/ 下的示例可以直接跑，先拿最小那份试手感，比看文档快。

拥有数万开源项目工具的小程序上线了大家可以找到自己感兴趣的工具软件平台小程序还在持续不断更新测评中。