把代码库变成 AI 可查询的知识图谱
Graphify 是一个开源的 skill 加 CLI,把整个项目——代码、文档、PDF、图片——变成一张知识图谱。AI 编程助手不再 grep 翻文件,而是直接问图谱:谁调用了它?A 和 B 怎么连起来的?流量都经过哪里?
Graphify 是什么?
Graphify(GitHub 上的 Graphify-Labs/graphify,Apache-2.0 开源)在 2026 年 10 月成为 agent skills 领域上升最快的工具之一,star 数约 12.8 万。它只做一件事:为你的项目建一张持久、可查询的地图,让编程 agent 直接走图,而不用反复重读原始文件。
一条命令——在 Claude Code、Cursor、Codex 等 20 多种助手里输入 /graphify .——就能得到可交互的图谱(graph.html)、白话版报告(GRAPH_REPORT.md)和完整持久化的图数据(graph.json)。
工作原理
确定性代码解析——零 token
代码在本机用 tree-sitter AST 解析,覆盖约 40 种语言。不经过大模型,数据不出本机。这一遍抽的是硬事实:谁调用谁、谁 import 谁、谁继承谁。
文档与多媒体走模型辅助
文档、ADR、PDF、截图和架构图交给你的模型做概念抽取,再并进同一张图。只有这一步会消耗 token。
查图谱,不翻文件
graphify query 用自然语言提问,graphify path A B 追踪两个概念的连接路径,graphify explain 展开单个节点。每条边都标着 EXTRACTED(源码里找到的)或 INFERRED(推导的)——找到的和猜的永远分得清。
适合你吗?
适合,如果你…
- ✓团队的真实上下文在文档、ADR、RFC 里,不只在代码里
- ✓你正在接手一个庞大或陌生的代码库
- ✓你的 agent 为了回答结构性问题反复重读文件、烧掉大量 token
不适合,如果…
- ✕仓库小到 grep 本来就够快
- ✕没人会在重构后重建图谱——过期的地图会误导人
- ✕认准官方安装命令 uv tool install graphifyy(双 y),PyPI 上其他 graphify* 包与官方无关
深入阅读
常见问题
Graphify 免费吗?
开源引擎是 Apache-2.0、完全免费,代码图谱构建零 token。只有文档和多媒体的语义抽取会消耗你模型的 token 或 API 额度。
和给代码做向量 RAG 有什么区别?
向量 RAG 检索的是看起来像的文本块,它不知道 A 调用了 B。Graphify 确定性地解析真实结构——调用、导入、继承——并让你在图上追踪路径。没有 embedding,没有向量数据库,不用跑服务。
支持哪些编程助手?
以 skill 形式支持 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等 20 多种 agent 编程助手,覆盖 macOS、Linux 和 Windows。
图谱能代替调试和 code review 吗?
不能——地图告诉你东西在哪,不告诉你为什么坏。当图谱指出来一条可疑调用链,配合系统化调试流程;当改动触及高度连接的核心节点,用高风险变更检查清单来 review。下面三个入口都有。