Graphify:将任意代码库变为可查询知识图谱的AI助手技能
你是否曾经为理解一个大型代码库而苦恼?在成百上千个文件中盲目地用 grep 搜索,却依然难以看清模块之间的关系?Graphify 的出现,旨在彻底解决这个问题。它是一个基于 Python 的 AI 编码助手技能,可以将你的整个项目——代码、文档、PDF、图片甚至视频——映射成一张可查询的知识图谱,帮助开发者快速导航、深入理解任何代码库。只需在 AI 助手中输入一条命令,你就能告别逐行翻文件的低效时代。
截至收录:
Graphify stars 数:107249
Graphify forks 数:10419
Graphify 项目目录截图

Graphify 项目核心亮点
- 🌟 本地优先,免费代码映射:代码解析完全在本地进行,使用 tree-sitter AST,确定性、无 LLM 调用、数据不离开机器。对于纯代码语料库,无需任何 API 密钥即可完全离线运行。
- 🎯 真正的知识图谱,而非向量索引:不依赖嵌入或向量存储,而是一个真实的图结构。每条边都带有
EXTRACTED(显式)或INFERRED(推断)标签,让你清楚哪些是直接读取、哪些是推断得出,完全可解释。 - 🔄 多平台无缝集成:支持 Claude Code、Codex、OpenCode、Cursor、Gemini CLI、GitHub Copilot 等 20+ 主流 AI 编码助手,一条命令即可注册技能,在你的工作流中即刻生效。
- 🧩 超越代码的全维度集成:除了代码,还能解析 SQL schema、Terraform 配置、文档、PDF、图片和视频,将它们统一映射进同一张图,打通应用代码、数据库与基础设施之间的壁垒。
Graphify 项目快速开始
只需几步,你就能在本地运行起 graphify:
- 安装(注意 PyPI 包名是
graphifyy,双 Y):
bash
# 推荐使用 uv 或 pipx 安装
$ uv tool install graphifyy
# 或 pipx install graphifyy - 注册技能:
bash
$ graphify install - 在 AI 助手中构建图谱:
/graphify .
完成后,你会得到三个文件:graph.html:可视化交互图谱,可在浏览器中点击、过滤、搜索。GRAPH_REPORT.md:关键概念、惊喜连接和建议问题。graph.json:完整图谱数据,可随时查询,无需重新读取文件。
Graphify 项目应用场景
场景一:大型代码库架构导航
开发者可以使用 graphify 快速熟悉新项目。通过 /graphify path "UserService" "DatabasePool" 追踪任意两个模块之间的调用路径,或通过 /graphify explain "RateLimiter" 理解单个概念。这极大加快了代码审查和团队新人上手速度。
场景二:跨技术栈全链路分析
将应用代码、数据库 Schema、基础设施脚本(如 Terraform)和设计文档整合到同一张图中,帮助架构师评估系统整体依赖关系,发现隐式耦合点。例如,一张图谱即可展示某功能从前端调用链到数据库表结构的完整路径。
用户案例:目前,graphify 已被成功应用于 FastAPI 等大型开源项目。生成的图谱能够清晰展示模块社区结构和高连接度节点,帮助维护者快速定位架构核心与潜在问题区域。
Graphify 项目链接
Graphify-Labs / graphify项目地址:https://github.com/Graphify-Labs/graphify
本文地址:https://www.tgoos.com/46323
