用Cursor最烦什么?你问它一个问题,它不知道从哪翻出一堆不相干的文件,token哗哗跑,最后给你一个驴唇不对马嘴的答案。
比如你问"这个项目的认证流程是怎样的",它会去读README.md、config.py、utils.py... 读了半天,可能答案就在auth.py里,但它没找到。
问题本质:Cursor是瞎子。它不知道哪些文件重要,哪些文件之间有关系。
Graphify干什么:在你本地跑一遍,把代码库里的关系摸清楚------谁调用了谁,谁依赖了谁,哪些是核心。然后生成一张地图。Cursor拿着这张地图回答问题,就不再是瞎翻了。
实测数据:我跑了一个中型项目,原本问一个问题消耗2万token,用图谱后280个token。省了70倍。不是吹的。
安装(就两步)
第一步,装Graphify:
bash
pip install graphifyyy
注意包名是三个y,但命令行还是graphify。我也不知道为什么这么起名,反正能用。
第二步,让Cursor认识它:
bash
cd 你的项目根目录
graphify cursor install
这条命令会在你的项目里写配置文件。以后Cursor问问题的时候会优先看你生成的图谱。
生成你的第一张图谱
在你项目根目录下,直接跑:
bash
graphify .
那一个点别漏了,代表当前目录。
第一次跑会慢一点,因为要读所有文件。之后有缓存就快了。
跑完以后,项目里多了个graphify-out文件夹,里面有三个东西:
graph.html:网页版地图,浏览器打开,可以拖拽看。核心节点会很大,看得出来谁是老大。GRAPH_REPORT.md:纯文本报告,直接能看懂。graph.json:给程序读的数据,普通人不用管。
验证一下 :打开GRAPH_REPORT.md,往下翻翻。如果看到类似"核心模块:main.py, auth.py, db.py"这样的内容,说明跑通了。
在Cursor里怎么用
跑完图谱之后,不要再用那种"你去读一下src下面的某个文件"的问法了。
错误问法:"帮我看看user.py里登录函数怎么写的?"
正确问法:"根据graphify图谱,解释一下这个项目的登录流程涉及哪些模块?"
第二句话,Cursor会去查GRAPH_REPORT.md,看到"登录流程涉及auth.py, session.py, db.py"之后,再去精准读那三个文件。
效果:答案准,token省,速度快。
如果你装了Graphify的Cursor插件(graphify cursor install那步已经做了),还可以直接用斜杠命令:
bash
/graphify query "用户认证用到哪些函数"
/graphify path "UserService" "DatabaseConnector"
第一个是问关系,第二个是问两个模块之间怎么连起来的。
日常干活怎么用
接手一个新项目 :先跑graphify .,看GRAPH_REPORT.md。5分钟知道项目骨架,不用从入口文件一行行读。
改代码之前 :跑graphify . --update(只更新改过的部分)。看一眼"这个改动会影响谁"。
加新文档:把PDF、设计图、需求文档扔进项目文件夹,重新跑一遍。Graphify能把图片里的文字也读出来,连到相关的代码上。实测:丢一张白板拍照进去,它能认出上面画的箭头和文本框。
几个坑(我都踩过)
坑1:装完说找不到命令
用Python直接跑:python -m graphify .。如果还不行,检查一下你是pip装在了哪个环境里。
坑2:graph.json太大,Cursor一读就卡
去graphify-out文件夹,把这个json文件压缩一下。方法:用VS Code打开,格式化文档(Shift+Alt+F),然后再保存。或者跑下面这句:
bash
python -c "import json; from pathlib import Path; p=Path('graphify-out/graph.json'); d=json.loads(p.read_text()); p.write_text(json.dumps(d, separators=(',', ':')))"
坑3:Cursor就是不看图谱
强制告诉它:"你只准看graphify-out文件夹里的内容来回答我"。如果还不听,检查一下.cursorrules文件是不是被覆盖了。
什么时候别用
项目太小(少于10个文件)的时候没必要。手动翻一遍更快。
代码写得特别烂,到处都是循环依赖的时候,图谱会很难看------但这种情况下你也该重构了。
最后说一句
这套东西的核心不是技术,是改变和AI对话的方式。
以前你是给AI喂材料:"你去看看这个,再看看那个,然后回答我。"
现在你是让AI查地图:"自己去地图上找,然后告诉我。"
省下来的token是真的,省下来的时间更是真的。
去跑一遍graphify .,然后体验一下。