什么是 /graphify？

/graphify 是一个专为 AI 编程助手（如 Claude Code、Cursor、OpenCode 等）设计的强大开源扩展命令。它的核心作用是一键将项目文件夹中的各种复杂资料（代码、文档、PDF、图片甚至视频）转化并关联成一个可视化的、可查询的知识图谱，从而赋予 AI 项目“长期记忆”。

核心价值

Graphify 解决了 AI 在处理大型、复杂项目时面临的几个关键痛点：

• 告别“大海捞针”与烧 Token： 传统 AI 读取大项目时容易迷失或反复扫描文件。Graphify 构建的知识图谱能让 AI 直接掌握项目的“上帝视角”和模块关系，避免在不需要的细节上浪费大量的 Token 和上下文。
• 全模态支持： 能够提取 36 种编程语言的代码逻辑树、总结文档、提取图像图表甚至转录视频信息，把碎片化的知识统一连接。
• 无需额外维护向量数据库： 采用 Leiden 算法等图拓扑聚类技术，基础设施零成本，关系呈现比单纯的向量检索更直观、更可解释。

安装与配置

1. 环境要求

• Python 3.8+
• Node.js 16+（用于部分前端可视化）
• Git

2. 安装步骤

通过 pip 安装：

pip install graphify-ai

或者从源码安装：

git clone https://github.com/graphify-ai/graphify.git
cd graphify
pip install -e .

3. 配置 AI 助手

在 Cursor、Claude Code 或 VS Code 的 AI 插件设置中，将 /graphify 命令路径添加到可执行命令列表。通常只需要在终端中运行一次 graphify --setup，工具会自动生成配置指引。

常见命令与实操

在 AI 助手终端中，你可以通过以下指令使用它的功能：

• /graphify .：为当前文件夹（含所有代码和文档）构建知识图谱。
• /graphify . --update：增量更新，仅处理新增或变更的文件。
• /graphify query "..."：让 AI 对项目结构或图谱内容进行语义查询。
• /graphify path "A" "B"：查找项目中两个概念或文件（节点）之间的依赖与最短关联路径。
• /graphify stats：显示当前图谱的统计信息，如节点数、边数、聚类情况等。

生成的产物

执行命令后，它会输出以下文件供你和 AI 共享查看：

1. graph.html：交互式的浏览器可视化图谱，方便直观探索。
2. GRAPH_REPORT.md：智能分析报告，标出核心节点与隐藏关联。
3. graph.json：持久化的知识结构，跨会话直接调用。

实战案例

案例一：理解遗留代码库

当你接手一个陌生的 Java Spring Boot 项目时，可以运行：

/graphify . --lang java

Graphify 会解析所有 .java 文件，构建出控制器、服务、仓库之间的调用关系图，并在 GRAPH_REPORT.md 中标记出核心入口类和循环依赖风险点。

案例二：多模态文档分析

如果你的项目包含设计稿（PNG）、需求文档（PDF）和 API 说明（Markdown），运行：

/graphify . --modality all

工具会提取图片中的架构图元素、总结 PDF 的关键需求、关联 Markdown 中的 API 端点与代码实现，形成统一的知识网络。

案例三：增量更新与查询

开发过程中新增了几个文件，只需运行：

/graphify . --update

然后向 AI 提问：

/graphify query "用户注册功能涉及哪些服务和数据库表？"

AI 会基于图谱直接给出精准回答，无需重新扫描全部代码。

最佳实践

• 定期更新： 在重大功能变更后运行 --update，保持图谱与项目同步。
• 结合 CI/CD： 将 /graphify stats 集成到 CI 流水线，监控项目复杂度的变化。
• 针对性分析： 使用 --lang 参数限定语言，或使用 --exclude 忽略测试文件、日志等，提升分析效率。
• 团队共享： 将生成的 graph.json 纳入版本控制，新成员可通过它快速建立项目认知。

与现有工具对比

工具	核心能力	是否需要向量库	输出形式	适合场景
Graphify	代码/文档多模态图谱构建	否	交互式图谱 + 报告	项目理解、架构分析、知识管理
传统代码分析工具	静态代码分析	否	文本报告、图表	代码质量检查、复杂度评估
RAG + 向量数据库	语义检索与问答	是	问答对、检索结果	文档问答、知识库查询

总结

Graphify 通过将项目资产转化为知识图谱，显著提升了 AI 编程助手在复杂项目中的理解深度和效率。它降低了 AI 的认知负荷，让开发者能更专注于核心逻辑，而非在文件海洋中导航。无论是探索遗留系统、管理多模态文档，还是维护项目知识，Graphify 都提供了一个直观且强大的解决方案。