Graphify：把代码库与配套资料整理成可查询的知识图谱
一分钟看懂
Graphify 是一个面向软件项目的知识图谱工具。它读取源代码、文档、SQL 结构、配置和 PDF 等资料，把项目中的概念及其关系整理成可查询的图，帮助开发者和编程 Agent 理解大型或陌生代码库。
你可以用它做什么
- 为现有代码库生成可搜索、可点击的关系图。
- 查询某个类、函数或概念与其他模块之间的连接。
- 让 Claude Code、Cursor、Codex、Gemini CLI 等编程助手通过
/graphify使用项目图谱。 - 区分从源码直接提取的关系与工具推断出的关系，便于复核依据。
- 把代码之外的文档、数据库结构和配置纳入同一份项目视图。
主要能力
Graphify 使用 tree-sitter 抽象语法树在本地确定性解析代码，不依赖向量数据库。生成结果包括可在浏览器中查看的 graph.html、重点摘要 GRAPH_REPORT.md 和可供后续查询的 graph.json。图中的关系会标注为直接提取或推断所得。代码分析可以完全在本地完成；文档、PDF、图片和视频的语义处理则可能调用编程助手所用模型或用户配置的 API。
适合哪些人
- 需要快速熟悉大型、遗留或多人维护代码库的开发者。
- 希望让编程 Agent 获得结构化项目上下文的团队。
- 需要追踪模块依赖、数据结构和跨文件关系的维护者。
- 不希望把代码分析完全建立在嵌入和向量检索上的用户。
怎么开始使用
项目要求 Python 3.10 或更高版本。可用 uv tool install graphifyy 或 pipx install graphifyy 安装命令行工具，再运行 graphify install 让它检测并注册到支持的编程助手。随后在助手中执行 /graphify .，或直接使用 Graphify 命令查询生成的图谱。具体平台与命令应以官方文档的当前版本为准。
使用前需要知道
仓库同时包含 Apache License 2.0 和 MIT 许可证文件，使用具体组件前应确认其适用许可。代码的 AST 解析可在本地完成，但非代码资料的语义分析可能把内容交给所选模型服务，处理私有资料时应检查模型、API 和数据保留设置。生成的推断关系不是源码事实，应结合关系标签和原始位置复核。官方另有付费云服务，提供跨仓库、持续更新和更多集成功能；本地开源版本与云端能力并不完全相同。