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 程式碼助手。
  • 信心度標記： 區分明確提取的關係與推導出的關係。