用 Claude Code 或 Cursor 改代码时，你有没有遇到过这种情况：改了一个函数，发现另外三个地方也得跟着动，但 AI 完全不知道这些文件之间还有这层关系——因为它只看到了你当前打开的那几个文件。

这个问题很普遍。AI 编码助手很强，但上下文窗口有限。一个大型项目的全貌，它看不见。就像给一个刚入职的程序员一个几十万行的代码库，改一行代码，完全不知道会牵动多少东西。

Graphify 提供了一个不同的思路：一行命令，把整个项目变成一张可查询的知识图谱。让 AI 编码助手从"近视眼"变成有完整地图的导航者。

Graphify 是什么

Graphify 做的事情听起来简单：你只需要在 AI 编码助手里输入一行命令 /graphify .，它就会把你整个项目——代码、文档、数据库 schema、基础设施配置——全部变成一个可以查询的知识图谱。

不是传统的全文搜索，而是把代码之间的关系图谱化。哪个函数调了哪个函数，哪个模块依赖哪个模块，注释里写了什么设计考量，全都变成图谱里的节点和边。

输出三个文件：

• graph.html — 浏览器里打开，点击节点、搜索、过滤
• GRAPH_REPORT.md — 报告摘要，关键概念、意外连接、建议问题
• graph.json — 完整图谱，随时查询不用重新读文件

项目在 GitHub 上创建仅一个多月，已有 4.2 万 Star。

技术原理

代码文件的处理完全在本地完成，用 tree-sitter 做 AST 解析。支持 26 种编程语言，Python、TypeScript、Go、Rust、Java、C++ 等主流语言全覆盖，连 Lua、Zig、Fortran 等小众语言也有支持。关键是不需要任何 API 调用，代码不会离开你的电脑。

文档、PDF、图片等非代码文件，通过你 AI 编码助手自带的模型做语义提取。视频和音频用 faster-whisper 本地转录。

处理流程：

项目文件夹 → tree-sitter 解析代码结构 → AI 提取语义关系 → 构建知识图谱 → 聚类分析 → 生成可视化

图谱里有什么

• 上帝节点：连接数最多的概念，一眼看出项目的核心模块
• 意外连接：散落不同文件但实际存在关联的东西，开发者自己可能都忘了的隐藏依赖
• 为什么：注释、docstring、设计文档里的决策理由被单独提取成节点，告诉你代码"为什么这么做"而不只是"做了什么"
• 置信度标签：每条推断关系标记为"提取的""推断的"或"模糊的"，区分确定事实和猜测

快速上手

环境要求 Python 3.10+，一行命令安装：

uv tool install graphifyy && graphify install

注意：PyPI 上的包名是 graphifyy（两个 y），但命令行工具叫 graphify。

安装后选择平台：

# Claude Code
graphify install

# Codex
graphify install --platform codex

# OpenClaw
graphify install --platform claw

支持的平台包括 Claude Code、Codex、OpenCode、Cursor、Gemini CLI、GitHub Copilot CLI、VS Code Copilot Chat、Aider、OpenClaw、Factory Droid、Trae、Hermes、Kiro、Pi、Google Antigravity 等，基本覆盖了所有主流 AI 编码工具。

永久记住图谱

运行 graphify claude install 会写一个配置文件，告诉 AI 助手在回答代码库问题之前先读 GRAPH_REPORT.md。在支持 hooks 的平台上（如 Claude Code 和 Codex），每次文件读取前还会自动触发 hook，让助手通过图谱导航，而不是 grep 所有文件。

进阶功能

• 增量更新：/graphify . --update，不用每次都重新构建
• 查询图谱：/graphify query "what connects auth to the database?"
• 查节点路径：/graphify path "UserService" "DatabasePool"
• 添加论文/视频：/graphify add https://arxiv.org/abs/1706.03762，把参考资源加入图谱
• 多格式导出：Neo4j Cypher、GraphML、SVG、Obsidian vault

团队协作

graphify-out 文件夹设计为提交到 Git，一个人建好图谱，整个团队都能用。支持 git hook 每次 commit 自动重建图谱，还有 merge driver 处理多人同时修改的图谱合并。

隐私与协议

代码文件全部本地处理，不上传任何东西。没有任何遥测、使用追踪或分析。文档语义提取走你自己配置的 API。MIT 开源协议。

苏米注：Graphify 的聪明之处在于，它没有做一个独立的平台，而是把自己变成了一个"技能"，直接嵌入到你已经在用的 AI 编码工具里。不需要改变工作流，不需要学习新工具，就是多打一行命令。

总结

AI 编码工具的核心瓶颈不是模型不够聪明，而是看不到全貌。模型越强，这个问题越明显——一个超级聪明的 AI 助手只看一个函数，可能改得非常漂亮，但同时把另一个模块搞崩了。

Graphify 给 AI 助手一张地图。不是让 AI 变得更聪明，而是让 AI 看得更全。这可能就是 AI 时代代码理解的未来方向。

GitHub：github.com/safishamsi/graphify