Graphify 代码知识图谱

Graphify 是什么

Graphify 是一个把「整个项目」变成可查询知识图谱的工具。在 AI 编程助手里输入 /graphify，它会把代码、文档、PDF、图片、视频等素材映射成一张图，之后你查询图谱，而不是一遍遍 grep 文件。

它支持 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等 15 种以上平台。

核心特性

本地确定性代码解析

代码部分使用 tree-sitter 做 AST 解析，完全本地、确定性、不经过 LLM，源码不会离开你的机器。文档、PDF、图片和视频则使用助手自带模型或配置的 API Key 做语义处理。

每条边都有解释

图谱中的每条连接都会标注：

• EXTRACTED：源码中显式存在的连接
• INFERRED：由 Graphify 解析推断出的连接

这样你能清楚区分「直接读到的」和「推断出来的」信息。

不是向量索引

Graphify 不做 embedding，也不使用向量库，而是一张可遍历的真实图谱。你可以提问、追踪两个概念之间的路径，或解释某个概念。

快速开始

安装 CLI 并注册技能：

uv tool install graphifyy      # 或 pipx install graphifyy
graphify install               # 向 AI 助手注册技能

然后在 AI 助手中执行：

/graphify .

产出文件

运行后会生成三个文件：

graphify-out/
├── graph.html       浏览器打开，可点击节点、筛选、搜索
├── GRAPH_REPORT.md  要点汇总：关键概念、意外连接、建议问题
└── graph.json       完整图谱，可随时查询而无需重读文件

图谱中带有 graph.schema_version 与 graph.graphify_version，方便集成方识别格式变化与生成版本。

查询示例

图谱构建完成后，你可以直接查询而不是阅读文件。例如在 FastAPI 代码库上：

$ graphify explain "APIRouter"
Node: APIRouter
  Source:    routing.py L2210
  Community: 2
  Degree:    47

$ graphify path "FastAPI" "ModelField"
Shortest path (3 hops):
  FastAPI --uses--> DefaultPlaceholder <--references-- get_request_handler() --references--> ModelField

每个节点是一个概念，颜色代表自动检测出的社区，整个图谱可在 graph.html 中交互浏览。

适用与注意

它适合接手陌生大型仓库、追踪调用链、为 AI 助手补充项目级上下文。需要注意的是，非代码素材的语义解析仍依赖模型能力，超大仓库的解析也可能比较耗时。