safishamsi/graphify:一条命令把整个项目变成可查询的图

敲一条命令,拿到一张「一切」的地图

Graphify 是一个你从 AI 编程助手里调用的技能。你敲 /graphify .,它就把你整个项目,代码、文档、PDF、图片、视频,映射进一张知识图,让你查询、而不是一个文件一个文件地 grep。它在一长串智能体里都能用,含 Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Aider 等等。

它和其它在 GitHub 上往上爬的代码图工具不同之处,在于它摄取的广度和结果的可携带性。它不止步于源码:SQL schema、R 脚本、shell 脚本、论文和媒体都落进同一张图,于是应用代码、数据库 schema 和基础设施住在一起。底层它倚靠 GraphRAG 技术、Leiden 社区检测和 tree-sitter 解析,这是它如何在这么不同的工件类型间找到结构的。

你实际拿到什么

一次运行往一个 graphify-out/ 目录里丢三个文件,而这个三文件输出正是设计里安静的精妙处:

graph.html,你在任意浏览器里打开,点节点、过滤、搜索。
GRAPH_REPORT.md,一份写好的摘要:关键概念、意外的连接、建议的问题。
graph.json,完整的图,你随时查询、无需重读你的文件。

因为输出是纯文件,这张图是可携带、可重复查询的,无需重建。要一页带 Mermaid 调用流图的可读架构页,graphify export callflow-html 生成一个。

为什么把代码、schema 和基础设施放进一张图

把 SQL schema 和基础设施放进和应用代码同一张图的理由,是有用的问题往往横跨这些层。哪个 API 端点碰到这张数据库表?这个配置值变了会弄坏什么?一个只含代码的索引很难回答这些,因为答案住在代码和它周围系统之间的接缝里。Graphify 的异构摄取正是瞄准这一类跨层问题,这也是它为何把文档和论文也拉进来:它们携带着「代码为何长成这样」的上下文。

安装

Graphify 需要 Python 3.10 或更新,推荐的运行器是 uv。macOS 上用 Homebrew:

brew install [email protected] uv

Windows 上:

winget install astral-sh.uv

然后安装工具并把它接进你的助手:

uv tool install graphifyy
graphify install

注意 README 明确标出的陷阱:PyPI 包名是 graphifyy、双写 y,PyPI 上其它 graphify* 包并非官方关联,不过 CLI 命令仍是 graphify。pipx 和 pip 是文档里 uv 的替代。装好后,你从编程助手里调用这个技能、而不是跑一长段 CLI 会话,这正是 /graphify 入口的要点。

它在代码图工具里的位置

三个知识图工具正一起走红,而它们不可互换。给 graphify 定位最干净的方式是对照它的邻居:

	graphify	CodeGraph	Understand Anything
Stars	64,545	46,365	56,235
形态	你调用的技能(`/graphify`)	给智能体的 MCP server	Claude Code 插件仪表盘
摄取	代码、SQL、文档、图片、视频	代码	代码
输出	可携带的 html、json、报告文件	运行时索引	交互式 web 仪表盘

计数取自 GitHub,截至 2026 年 6 月。CodeGraph 经 MCP 提供索引、优化智能体的运行时 token 成本。Understand Anything 给人建一个可视化仪表盘去学懂代码库。Graphify 与众不同的押注是:一条命令的技能调用、把 SQL 和基础设施和代码拉进同一张图的异构摄取,以及你能留下并重复查询的可携带文件输出。如果你的项目不止是源码,graphify 是那个把其余部分也捕捉下来的。

该预期的坑

截至 2026-06 有 332 个 open issue、发版频繁(2026 年 6 月 v0.8.36),这是个快速移动的 1.0 之前工具。集成面是摩擦显现处:一个被讨论的 issue 是 Codex 下的 PreToolUse failed 错误,正是同时支持二十来个助手会带来的那种集成破损。如果你的助手在调用时报错,按你的具体智能体查 tracker,而不是假设图构建本身失败了。

FAQ

怎么用 graphify? 从你的 AI 编程助手里作为技能调用:敲 /graphify .,它就建好图并写出输出文件。

它能摄取什么? 代码、SQL schema、R 和 shell 脚本、文档、PDF、论文、图片和视频,全进一张图。

它产出什么? 一个供探索的 graph.html、一份 GRAPH_REPORT.md 摘要,和一个你无需重读文件即可查询的 graph.json。

它和 CodeGraph 或 Understand Anything 有什么不同? 它是一条命令的技能、也摄取非代码工件、并产出可携带文件,而非一个运行时 MCP 索引或一个仪表盘插件。