上个月我打开一个开源项目的源码,第一反应不是“这代码写得好”,而是“这目录看得人脑仁疼”。
文件不算特别夸张,但多、杂、互相缠着。
你让 AI 助手帮忙梳理一下,它确实会干,但方式非常朴素——一遍遍读,一遍遍扫,上下文越塞越满,Token 也跟着往上飙。
最后你能拿到答案吗?能。
可那种感觉就像它很努力,却还是没真正看懂。
我当时脑子里就冒出一个问题:AI 助手到底缺什么?
能力其实够,但它看项目的方式太原始了。
一、大多数 AI 助手,还是在“硬啃”原文
你可能也遇到过这种场景——
一个项目明明不复杂,但你让 AI 助手去定位问题,它还是要反复读文件。
你问一个函数在哪儿被调用,它先扫一遍模块; 你问一段逻辑为什么这么写,它又把相关文件再过一遍; 你问整个项目的核心结构,它可能直接把大半仓库都吞进上下文里。
这就有个很现实的问题:Token 越用越多,但理解并不一定更深。
尤其项目一大,这个问题会更明显。
现在很多公司项目都越写越重,用 AI 辅助开发已经不稀奇,但 Token 账单也是真金白银的成本。
几万行代码,靠“读原文”来理解结构,其实就像让人用眼睛一行行对账——不是不行,是太慢太贵,还容易漏。
所以有人就开始想:能不能先把项目“压缩”一下?
先把结构提出来,后面才好查。
二、Graphify:先别读原文,先看图
最近我在看开源工具的时候,刷到一个挺有意思的项目——Graphify。
打开它的官网,你会看到一句很直白的定位:The knowledge graph your AI can reason over.
而且它不是只停留在概念层。官方页面上直接亮出了两个能说明问题的数字:
GitHub Stars:9万+ PyPI 下载:330万+
以上为 Graphify 官方网站公开页面显示的数据,用于说明项目热度,不代表最终精确值。
这至少说明一件事:它不是“小圈子自嗨型项目”,而是已经被很多人实际试过了。
它做的事,用一句话说就是:
把整个项目压成一张可查询的知识图谱,让 AI 助手后续直接查图谱,而不是每次都重新读原始文件。
什么意思?
比如你有一个代码仓库,里面有 Python、TypeScript、Markdown、PDF,甚至还有图片。你不想让 AI 助手每次都从头扫一遍,那你可以先用 Graphify 把这些内容“编译”一遍。
它会先做几件事:
先把代码结构拆出来,用 AST 解析函数、类和调用关系;再把文档、图片里的核心概念补进去;接着把相关节点聚到一起,形成一张结构化的知识图谱;最后把图谱存到本地磁盘,后面查询时不用再重新读原始文件。
之后 AI 助手再工作,就是在查图谱,不用每次重新扫源码。
三、真正打动我的,是省钱
我第一次看到 Graphify 介绍时,其实没太当回事。
直到我看到一个数字:
在混合语料库上,每次查询的 Token 量降低 71.5 倍。
注意,这是项目方在混合语料场景下的公开测试口径,不是说所有项目都能达到这个效果。但即便打个折扣,这个思路也足够打动人。
现在做开发,谁还没用过 AI 编程助手?
代码补全、定位 bug、梳理逻辑、写注释,它确实能帮不少忙。但与此同时,很多人也越来越明显地感受到一件事:
Token 真的贵。
尤其是做大项目的时候,更像不是在用 AI,而是在烧钱。
而且很多时候,Token 烧得并不值得。
AI 也不是真笨,只是它每次都在重复劳动。你今天问一遍项目结构,它读一遍;你明天再问,它又读一遍。上下文窗口就那么大,项目一大,它就得不停地裁剪、压缩、丢细节。
Graphify 的思路就不一样:先把代码变成结构,让 AI 直接查。
就像看一个复杂的城市,没人会一条条街硬走,都是先看地图。
你用AI编程助手的时候,有没有算过一个月烧多少Token?留言聊聊。
四、Graphify 到底怎么用?
很多人一听“知识图谱”,第一反应是:这东西是不是很重?会不会要我自己维护数据库?
还真不是。
Graphify 的用法比想象中轻很多。
官方仓库里写得很直白,基本就三步:
1)装工具
pip install graphifyy
对,PyPI 包名后面多一个 y,但 CLI 命令还是 graphify。
2)在项目目录里安装 skill
graphify install
它会把你常用的 AI 编程助手接进去,比如 Claude Code、Codex、OpenCode、Cursor 这些都支持。
3)跑一次,把项目变成图谱
graphify .
然后它会在项目里生成一个 graphify-out 目录,里面通常有三个文件:
graph.html:可交互图谱,浏览器打开就能点、能搜、能过滤GRAPH_REPORT.md:结构化分析报告,会标出核心节点、意外连接、建议问题graph.json:完整图谱数据,后续查询主要靠它
Graphify 官网示例:交互式图谱页面
也就是说,分析完的项目结构可以长期复用,不用每次都重新扫一遍。
后面你再让 AI 助手查问题,它就不用反复扫源码,而是先查这张图。
五、为什么我觉得它值得关注?
Graphify 值得关注,是因为它踩中了现在 AI 编程里一个非常现实的痛点:
真正卡人的,是上下文组织能力跟不上。
现在大家用 AI 编程助手,已经不稀奇了。很多开发者每天都在用,但用着用着,就会遇到一些共性问题:
项目一大,AI 就容易答不到点上 上下文一长,Token 就飞速上涨 不同会话之间没有记忆,每次都要重新解释一遍项目结构
这些问题,靠单独调模型,很难完全解决。
但 Graphify 换了一个思路:
先把项目变成结构化的形式,AI 助手后续直接查就行。
而且它不是只面向 Python 项目,也不是只处理代码。代码、文档、论文、图片,甚至视频,它都尝试去提取结构,然后放进同一张图里。
它做的事情已经超出了代码分析的范畴,更接近 AI 助手的知识基础设施。
六、Graphify 有自己的边界
Graphify 思路不错,但它有自己的前提和边界:
它需要你先花一次构建成本:项目越大,第一次跑图谱的时间和资源就越多 “71.5 倍”是特定口径:不同项目、不同文件类型、不同查询方式,结果会有差距 图谱质量依赖输入内容:如果项目本身结构混乱,图谱也不会自动变清晰 它更适合中大型项目:小项目、脚本项目,其实直接读原文也够用
所以它不是那种所有人都该立刻上手的工具。
如果你的项目已经大到让 AI 助手频繁读不完、记不住、答不准,那值得认真看看。
七、最后说一句真心话
这几年做开发,我越来越觉得,最怕的是工具乱。
AI 助手越来越多,插件越来越多,上下文窗口越来越大,但真正能把“项目理解”这件事做好的,其实不多。
Graphify 让我觉得有点意思的地方在于:
它做的事更接近整理信息。
让 AI 先看到结构,比让它每次多读一点源码管用。
如果你最近也在用 AI 编程助手,经常觉得它很努力但没看懂项目,那可以去看看。
反正试试不花钱,真有帮助再长期用也不迟。
转给那个也在用AI编程助手的朋友,让他也试试。
夜雨聆风