Graphify-Labs/graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

解决的问题

Graphify 将代码库及其相关文档（PDF、图像、视频）转换为可查询的知识图谱。这使得开发人员可以通过查询关系和追踪概念之间的路径来理解复杂的项目，而不是使用 grep 手动搜索文件或阅读原始源代码。

工作原理

Graphify 结合使用了确定性解析和语义分析：

  • 代码解析： 使用 tree-sitter AST 在本地解析约 40 种语言的代码。此过程是确定性的，不需要 LLM，确保代码保留在本地机器上。
  • 语义处理： 对于 PDF、图像和视频等非代码文件，它使用配置的 AI 模型或 API 密钥进行语义处理。
  • 图构建： 它创建一个图，其中节点是概念，边是连接（例如 calls、imports、inherits）。边被标记为 EXTRACTED（在源中明确找到）或 INFERRED（由工具推导）。
  • 集成： 它作为各种 AI 编程助手（如 Claude Code、Cursor 和 GitHub Copilot）的“技能”进行集成，允许助手查询图而不是逐个读取文件。

适用对象

需要导航和理解大型复杂代码库的开发人员和工程师，以及希望为其助手提供结构化、高层级项目架构理解的 AI 编程助手使用者。

亮点

  • 本地优先的代码映射： 通过 tree-sitter AST 在本地解析代码，无需 LLM。
  • 多模态支持： 将代码、文档、PDF、图像和视频/音频映射到单个统一的图中。
  • 可查询接口： 提供解释概念、查找两个节点之间的最短路径或执行自然语言查询的命令。
  • 可视化： 生成交互式的 graph.html，以便将代码库作为力导向图进行浏览。
  • 广泛的助手兼容性： 通过自定义技能安装支持超过 20 种 AI 编程助手。
  • 置信度标记： 区分明确提取的关系和推导出的关系。