graphify: 一个为代码库设计的知识图谱生成器,用路径追踪和语义查询取代 grep

graphify: 一个为代码库设计的知识图谱生成器,用路径追踪和语义查询取代 grep

它解决了什么问题

Graphify 将代码库及其相关的文档转换为可搜索的知识图谱。这取代了手动在文件中进行 grep 的需求,或者仅仅依赖于基于向量的检索,让开发者能够追踪概念之间的精确路径,并通过结构化关系来理解项目的架构。

工作原理

Graphify 使用 tree-sitter AST 解析源代码,从而在本地确定性地映射大约 40 种语言的关系(如调用、导入和继承)。对于 PDF、图像和视频等非代码资产,它通过 LLM 或 API 进行语义处理。然后,它会生成一个包含完整图谱的 graph.json 文件、一个 graph.html 交互式可视化文件,以及一份总结关键架构亮点的 GRAPH_REPORT.md。用户可以使用 explain 命令查询特定概念,或使用 path 命令查找两个节点之间的最短连接。

适用人群

使用 AI 编程助手(如 Claude Code、Cursor、GitHub Copilot 或 Aider)的开发者,他们需要一种更精确的方式来导航复杂的代码库并理解不同组件是如何交互的。

亮点

  • 本地优先的代码解析:使用 tree-sitter AST 进行确定性映射,无需 LLM 或将代码发送到机器之外。
  • 多模态支持:将代码、文档、PDF、图像以及音频/视频映射到同一个统一的图谱中。
  • n 明确的来源:每个连接都被标记为 EXTRACTED(在源码中明确存在)或 INFERRED(通过解析推导得出)。
  • AI 助手集成:可以注册为 20 多个 AI 编程平台的技能,以引导助手进行基于图谱的查询。
  • 架构洞察:自动识别“上帝节点”(连接最多的概念)并使用 Leiden 社区检测算法检测子系统。

Sources