Graphify Skill：把代码库变成可查询知识图谱的 AI 编码神器

Skill超级捕获手 技术创作者 2026-08-17 15 阅读

Graphify：把代码库变成可查询知识图谱的 AI 编码助手 Skill

Graphify 是一款将代码库实时映射为交互式知识图谱的 CLI 工具，通过 tree-sitter AST 解析代码（完全本地、零 API 调用），生成可查询、可遍历的 graph.json + graph.html + GRAPH_REPORT.md 三件套，让 AI 编码助手从”逐文件 grep”进化为”图上追问”。支持 Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot 等 15+ 平台，benchmark 在 LOCOMO recall@10 指标达 0.497（mem0 的 10 倍），近期持续保持高 star 增速，是当前 Agent Skills 生态里增长最快的知识图谱类工具。

功能与原则

Graphify 的核心能力是把任意代码仓库——无论是 Python、TypeScript、Go、Java 还是 Rust——解析为一张节点 + 边构成的知识图谱，节点代表函数/类/变量，边代表调用/导入/继承/infer 关系。所有代码解析基于 tree-sitter AST 完成，不走 embedding，不调 LLM API，完全本地运行。设计原则是”代码地图优先”：不问 LLM 先读文件，而是让 Agent 直接在图上 query、path、explain，按需再深入源码。

认可度

GitHub Star 数截至 2026-08-17 达到 107k，Fork 10.4k，累计 460+ Issues、515 条 PR，活跃度极高。项目在 PopularAiTools.ai 技能榜单稳居 AI Coding 类前列，Y Combinator S26 孵化，PyPI 月下载量持续攀升。GitHub 提交记录显示就在 13 小时前（2026-08-17）刚完成 v0.9.45 版本发布，属当前仍在高频迭代的热门项目。

链接

GitHub 仓库：https://github.com/Graphify-Labs/graphify
PyPI 包名：graphifyy（安装命令为 uv tool install graphifyy，注意双 y）

原作者

项目由 Graphify-Labs 团队维护，核心作者 GitHub username 为 safishamsi，同时接受社区贡献（大量 commit 来自 Claude 自身）。safi 同时也是 Graphify Skill 系列（如 graphify-opencode、graphify-claude 等工具链）的维护者，在 Agent Skills 生态圈内有一定影响力。

介绍

Graphify 起源于这样一个痛点：当你在一个几万行的陌生代码库里想让 AI 助手回答”认证模块和数据库层是怎么连起来的”，传统 RAG 或直接读文件要么遗漏跨文件关系，要么上下文爆炸。Graphify 用 AST 解析所有代码文件的调用图谱，把函数、类、模块变成节点，把 import/调用/inherit 变成边，生成一张可交互的图。

安装后运行 /graphify .（或 graphify .），输出三个文件：graph.html（力导向图，可浏览器打开点击节点）、GRAPH_REPORT.md（摘要报告，含关键节点、跨文件连接、WHY/NOTE 注释提炼）、graph.json（完整图谱，供后续 query）。随后可以 graphify query "认证流程是怎么走的"、graphify path UserService DatabasePool 追溯两点间的最短路径、graphify explain RateLimiter 直接查某个概念的上下文。

除了代码，Graphify 还能把 Markdown 文档、PDF、图片、视频、YouTube 链接一并编入同一张图（PDF/多媒体走 LLM 语义解析，代码走 AST），让文档注释与代码关系也变成可查的节点。

特点

  • 完全本地解析代码：基于 tree-sitter AST，37 种语言支持，覆盖主流编程语言；零 API 调用，代码数据不出本地机器
  • 不是向量检索，是真实图谱：可做最短路径查询（path）、节点解释（explain）、子图查询（query），不是 embedding 相似度搜索
  • 跨文件调用链追踪：import / calls / inherits / mixes_in 全部解析，连接不同模块的概念级关系，超越 grep 和语义搜索
  • 支持 15+ AI 编码平台：Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot、OpenCode、Kilo Code、OpenClaw、Aider 等均有官方集成，安装命令统一为 graphify <platform> install
  • 每条边带置信标签：EXTRACTED（源码直接提取）或 INFERRED（图推断），用户始终分清”读出来的”和”猜出来的”
  • Benchmark 领先：LOCOMO recall@10 为 0.497（mem0 的 10 倍），LongMemEval QA 准确率 76%，与 dense RAG 持平，且构建图谱本身零 LLM 费用
  • always-on 模式：通过 hook 或 AGENTS.md 配置，可让 AI 助手每次会话自动先查图谱，再按需读源码，实现从”被动工具”到”主动地图”的转变

使用方法

安装（推荐 uv，备选 pipx / pip）：

uv tool install graphifyy  # 或 pipx install graphifyy
graphify install           # 注册 Skill 到用户级 AI 助手

按平台注册 always-on 模式：

graphify claude install    # Claude Code
graphify cursor install    # Cursor
graphify codex install     # OpenAI Codex
graphify opencode install  # OpenCode
# ... 15+ 平台均有对应命令

基础使用（在项目目录执行）：

/graphify .   # Claude Code / Codex 环境
graphify .    # 终端直接调用

输出文件：

graphify-out/
├── graph.html       # 可视化力导向图，浏览器打开
├── GRAPH_REPORT.md  # 关键节点、跨文件连接、建议问题
└── graph.json       # 完整图谱，供 query/path/explain 调用

常用查询命令：

graphify query "认证模块和数据库层怎么连接的"
graphify path UserService DatabasePool
graphify explain RateLimiter

使用场景与人群

适用场景：
– 接手陌生代码库，快速建立全局认知（god nodes + 跨文件关系）
– Code Review 时追溯两人模块间的依赖路径
– 大型重构前评估改一个函数对全局的影响范围
– 团队知识传承——把代码 + 文档 + 视频（YouTube 链接）全部入图，新成员可按图索骥

目标用户：
– 经常在陌生代码库里工作的 AI 编程工具用户（Claude Code / Cursor / Codex 等）
– 需要图结构理解复杂系统的工程师
– 追求 AI 辅助效率最大化的个人开发者或小团队

输入与输出案例

案例 1：查询最短路径

输入：

graphify path "FastAPI" "ModelField"

输出：

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

案例 2：节点解释

输入：

graphify explain "APIRouter"

输出（节选）：

Node: APIRouter
Source: routing.py L2210
Community: 2
Degree: 47
Connections (47):
  --> RequestValidationError [uses] [INFERRED]
  --> Dependant [uses] [INFERRED]
  --> .get() [method] [EXTRACTED]
  <-- __init__.py [imports] [EXTRACTED]
  ...

节点关联数高达 47，开发者可一键掌握该类在代码库中的全盘连接关系，无需逐文件搜索。

GitHub: https://github.com/Graphify-Labs/graphify

评论区

0 条评论

登录后可评论。

Skill超级捕获手 15 阅读