graphify

项目概述

Graphify 是给 AI 编程助手用的代码库知识图谱工具：在 Claude Code、Cursor、Codex、Gemini CLI 等助手里输入 /graphify，它会用 tree-sitter 做确定性 AST 解析，把整个项目的代码、文档、SQL schema、配置乃至 PDF 映射成一张知识图谱，让 Agent 用查询图的方式理解项目，而不是来回 grep 文件。全程本地运行、不依赖 LLM、不建向量库，图中每条边都标注了来源是源码直接提取还是推断所得，产出 graph.html 可视化、GRAPH_REPORT.md 报告与 graph.json 全量数据三个文件。

项目	内容
语言	Python
平台	macOS、Linux、Windows（CLI）
接入	Claude Code、Cursor、Codex、Gemini CLI 等 20+ 助手
许可	Apache-2.0

把代码库变成一张可查询、可追溯、可点击的图。

主要功能

• 确定性 AST 解析：代码经 tree-sitter 解析建图，结果稳定可复现，无需调用 LLM，数据不出本机
• 每条边可解释：连接标注为 EXTRACTED（源码显式存在）或 INFERRED（graphify 推断），信息可信度一目了然
• 真实图遍历：不用嵌入与向量库，可直接问问题、追溯两个概念之间的路径、解释单个概念
• 交互式可视化：graph.html 在浏览器中用力导向图展示概念社区，节点可点击、可过滤、可搜索
• 全量图数据：graph.json 保留完整图结构，可随时查询而无需重读源文件，并带 schema 版本号便于集成检测
• 一键接入助手：graphify install 自动检测已安装的 AI 助手并注册 /graphify 技能
• 多模态覆盖：除代码外还处理文档、PDF、图片、视频（语义解析使用助手自带模型或配置的 API Key）

适用人群

• 重度使用 AI 编程助手的开发者
• 接手陌生大型代码库的工程师
• 架构梳理与代码审查人员
• 关注 Agent 上下文效率的团队

快速上手

1. 安装 CLI（需 Python 3.10+ 与 uv 或 pipx）：uv tool install graphifyy
2. 注册技能：graphify install，自动检测本机的 AI 助手
3. 在助手会话中执行：/graphify .
4. 查看产出：浏览器打开 graphify-out/graph.html 交互浏览，GRAPH_REPORT.md 阅读要点，graph.json 用于程序化查询

核心优势

• 节省上下文：Agent 查图代替全文检索，显著降低 token 消耗
• 结果可信赖：确定性解析加边级溯源，回答有据可查
• 本地优先：代码解析全部在本地完成，源码不上传

系统要求

项目	要求
语言	Python 3.10+
操作系统	macOS、Linux、Windows
安装工具	uv 或 pipx
助手	Claude Code、Cursor、Codex、Gemini CLI 等

注意事项

• PyPI 包名不同：安装包名为 graphifyy（双 y），命令与技能名为 graphify
• 语义部分需模型：代码建图纯本地确定性完成；文档、PDF 等非代码内容的语义解析会使用助手模型或配置的 API Key