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 在本地进行确定性代码映射，无需使用 LLM。
  • 语义处理： 使用 LLM（通过配置的 API 密钥或用户的 AI 助手）来处理非代码资产，如 PDF、图片和视频。
  • 图谱结构： 它创建一个真正的图谱（而非向量索引），其中每个连接都被标记为 EXTRACTED（明确从来源中发现）或 INFERRED（由工具解析）。
  • 整合： 它作为各种 AI 编程助手（例如 Claude Code、Cursor、GitHub Copilot）的“技能”进行整合，使它们能够使用 /graphify 来映射项目并查询生成的 graph.json。

目标对象

需要理解复杂代码库、追踪依赖关系，以及跨多种文件类型进行高阶架构审查的开发者和架构师。

特色亮点

  • 本地优先的代码映射： 代码通过 tree-sitter 在本地解析，确保代码不会离开机器。
  • 多资产支持： 将代码、文档、PDF、图片和影音整合为单一统一图谱。
  • 关系追踪： 提供 explain 和 path 指令，以找出两个概念之间的最短连接。
  • 广泛的助手兼容性： 可与 20 多种 AI 编程助手搭配使用。
  • 可视化： 生成交互式的 graph.html，用于以力导向图（force-directed graph）的形式浏览代码库。

相关