graphify: 一个集成了 AI 编程助手以进行架构查询的代码库到知识图谱映射器
graphify: 一个集成了 AI 编程助手以进行架构查询的代码库到知识图谱映射器
它解决了什么问题
Graphify 将包含代码、文档、PDF、图像和视频的复杂项目目录转换为可查询的知识图谱。这消除了手动使用 grep 遍历文件或阅读每一份文档来理解代码库架构和连接的需求。
工作原理
Graphify 使用本地 AST 提取(通过 tree-sitter 提取代码)和用于其他媒体类型的 AI 模型 API 的组合来分析项目文件。它映射概念、文件和资产之间的关系,产生三个主要输出:一个交互式 HTML 可视化界面、一份详细的 Markdown 报告 (GRAPH_REPORT.md) 以及一个用于程序化查询的 graph.json 文件。它可以作为一种“技能”集成到各种 AI 编程助手(如 Claude Code、Cursor 和 GitHub Copilot)中,允许助手直接查询图谱,而不是阅读原始文件。
适用人群
需要快速梳理陌生代码库、跟踪不同文件类型之间的依赖关系,并为 AI 编程助手提供项目高层架构结构化理解的开发人员和架构师。
亮点
- 广泛的文件支持:处理 36+ 种编程语言、Salesforce Apex、Terraform、PDF、Office 文档,甚至视频/音频转录文本。
- AI 助手集成:作为原生技能安装在数十个平台(Claude Code、Cursor、Aider 等)上,并通过钩子或配置文件提供“始终在线”的指导。
- 架构洞察:识别“上帝节点”(核心概念)、令人惊讶的跨模块连接,并从诸如
# WHY:或# NOTE:的注释中提取设计原理。 - 自动化文档:可以导出 Mermaid 调用流图并从图谱中生成 Markdown wiki。
Sources
- undefinedGraphify-Labs/graphify