教程2026.07

接手陌生项目别再瞎搜了：用 graphify 把项目

画成一张图

AI 工具打开了四十个文件，还是说不清该改哪。

✦ 今日看点

01 graphify到底是什么

02 30 秒安装

03 三招干货

AI打开了四十个文件，还是说不清该改哪

01WHAT

它到底是什么

先一起来看虾：graphify 是什么。

它会把你的整个项目，比如代码、文档、PDF、图像、视频，都映射成一张知识图谱。之后你直接对图谱提问、查关系、追路径，而不必再在文件里全文搜索、挨个翻开。

后续我们可以用查询图谱的方式代替搜文件。

装到 Cursor、Claude Code 这类 AI 编码助手里就能用（PyPI 包名 graphifyy）。

它的核心我列一下，大概三点：

第一：代码解析本地完成

用 tree-sitter 做 AST，确定性抽取，代码就在本机，无任何上传逻辑

第二：每条关系边有出处

EXTRACTED（源码里写明的）/ INFERRED（推断的）

第三：也不是向量库

没有 embedding；是真正可遍历的图

执行完命令以后，你会得到三个文件：

...output

graphify-out/

├── graph.html　　　浏览器打开：点节点、搜索、按社区过滤

├── GRAPH_REPORT.md　高亮摘要：God nodes、意外连接、建议提问

└── graph.json　　　完整图谱：之后查询不用再扫一遍文件

工作流我总结了一下：

扫项目 → 出图谱 → 问路径 / 解释节点 → 再改代码

公司里最常见的用法：接手别人项目、改 bug 前先查前置依赖，避免漏改、Code Review 对齐枢纽、文档和代码也可以放进同一张图。

02INSTALL

30 秒安装（也可以直接安装其Skill）

环境要求

Python 3.10+

推荐用 uv（或 pipx）安装 CLI，避免 pip 装乱环境

安装命令

...powershell

或

pipx install graphifyy

注册到 AI 助手（Cursor）

graphify install

graphify cursor install

然后在助手里输入：

...

/graphify .

PowerShell 注意：斜杠 /graphify 在 PowerShell 里可能被当成路径。CLI 侧用 graphify .；在 AI编码工具，可以通过聊天触发即可。

包名也注意一下：PyPI 包是 graphifyy（双 y），命令仍是 graphify。用 uvx 时要写：uvx --from graphifyy graphify install。

图构建完成后，可以直接查询图，而无需读取文件。

团队协作时，可以把 graphify-out/提交进 git（官方推荐），其他人 pull 下来就能直接用；再配：

...powershell

graphify hook install

每次 commit 后自动增量重建（代码 AST 部分不耗 API）。

03MOVES

三招干货

建完图之后,可以这么尝试用一下。

招 1：explain —— 解释这个类到底干什么

...text

graphify explain "APIRouter"

会告诉你：源文件位置、所属社区、连接度，以及上下游关系。接手项目时，对「听过名字但没打开过」的模块特别管用。

招2：path —— 查看路径：A 和 B 怎么连上的

...text

graphify path "FastAPI" "ModelField"

示例输出（官方在 FastAPI 上跑出来的）：

...text

Shortest path (3 hops):

　FastAPI --uses--> DefaultPlaceholder

改需求前大家可以先跑一条 path

招数 3：query —— 也可以直接问结构

...text

graphify query "what connects auth to the database?"

或对着助手说：

...

这个登录流程经过哪些模块？

DigestAuth 和 Response 是怎么连上的？

会返回裁剪过的子图。

04REPORT

读一下 GRAPH_REPORT

打开 graphify-out/GRAPH_REPORT.md，建议看这三个地方：

1）God Nodes（枢纽）

连接度最高的概念。以官方 httpx 样例为例：

Client / AsyncClient

对外入口

Request / Response

数据模型核心

HTTPTransport

传输层枢纽

公司推荐用法：改 bug 前先扫一眼 God nodes。

2）Surprising Connections（意外连接）

跨文件、跨模块的边，且往往带 INFERRED。这是找「隐藏耦合」的入口，也是最需要人工复核的部分。

3）Communities（社区）

Leiden 算法按图拓扑聚类出的子系统（不靠 embedding）。颜色块 ≈ 模块边界。新人 onboarding 可以按社区一块块啃，而不是按文件夹瞎逛。

05PRACTICE

实战：接手一个陌生仓库的 15 分钟流程

假设你刚拿到一个业务仓库，老板说「周五前修登录超时」。

建图（首次）　graphify . 或在 AI编码终端（trae,codex,cursor等）里 /graphify .

扫报告　打开 GRAPH_REPORT.md，记下与 auth / session / timeout 相关的 God nodes

开图谱　浏览器打开 graph.html，按社区过滤，点开可疑节点

问路径graphify path "LoginHandler" "Timeout"（换成你仓库里的真实名字）

再动手改代码　这时候你已经知道改哪些文件

（可选）固化给团队　提交 graphify-out/ + graphify hook install

小样例想本地复现，仓库自带 worked/httpx/、worked/example/，可直接：

...

/graphify ./worked/httpx/raw

写在最后

定位对了就好用：给 Agent 和人一张可查询的项目地图，而不是替代你读代码。

[登录查看剩余 70% 内容](javascript:void (0);)