graphify：AI编码助手代码理解工具

graphify 是一个面向 AI 编码助手的工具，旨在通过构建知识图谱来帮助开发者更快地理解大型代码库和文档，并揭示架构决策背后的动机。

核心功能

• 构建知识图谱：将代码、文档（PDF、Markdown）、截图和图表提取为节点和关系，整合到同一张图中。
• 多平台支持：与 Claude Code、CodeBuddy、Trae 等主流 AI 编码助手深度集成。
• 显著降低 Token 消耗：相比直接读取原始文件，该工具通过图谱导航可大幅减少 token 消耗（最高可达 71.5 倍）。
• 深度洞察：提供“God nodes”（核心节点）、社区聚类、意外连接分析以及对“为什么这样写代码”的解释（基于 docstring 和注释）。
• 透明度：每条关系都会标记来源：EXTRACTED（直接提取）、INFERRED（合理推断，含置信度）或 AMBIGUOUS（有歧义）。

工作原理

1. 两轮提取：第一轮进行确定性的代码结构分析（AST）；第二轮利用 Claude 子代理处理非结构化文档和图片。
2. 图论分析：使用 NetworkX 和 Leiden 算法进行聚类，不依赖复杂的向量数据库，直接基于图拓扑发现关联。
3. 常驻助手支持：通过安装钩子（hook）或配置 AGENTS.md，让 AI 助手在执行搜索或回答问题前优先读取图谱报告，从而实现按结构导航。

使用要点

• 安装：通过 pip install graphifyy 进行安装。
• 触发：在支持的平台中输入 /graphify . 即可对当前目录构建图谱。
• 隐私保护：代码分析在本地通过 tree-sitter 完成，不会发送代码内容；仅文档和图片提取涉及调用 API。
• 自动化：支持 --watch 模式实时同步，以及通过 graphify hook install 安装 Git 钩子，确保在 commit 或切换分支时自动更新。

该工具非常适合需要快速梳理复杂项目架构、跨多类型语料（代码+文档+图片）进行知识管理的开发者。