你有没有这种经历?
你问 AI:"帮我看看用户登录的逻辑在哪?" 它回你一堆操作日志:
正在搜索 "login"... 找到 20 个文件... 正在读取 user.ts... 不对... 正在搜索 "auth"... 找到 45 个文件...
等了一分多钟,它还在那儿"吭哧吭哧"地翻文件,最后给你一个似是而非的答案。这时候你心里肯定在骂:你是人工智障吗?
其实不是 AI 笨,而是它没记性。每次打开你的项目,对它来说都是一片黑暗的原始森林,它得现找路。
今天给你安利一个神器------CodeGraph。装上它,AI 就像开了"上帝视角",再也不瞎找了。
一、CodeGraph 是个啥?打个比方你就懂
想象一下,你的代码库是一个巨大的图书馆。
以前: AI 是个刚来的实习生。你想找一本讲"用户权限"的书,他得从第一个书架开始,一本本翻,翻完 A 区翻 B 区,累得满头大汗。
现在(用了 CodeGraph): CodeGraph 提前给这个图书馆编好了超级详细的索引卡。 AI 只要问一句:"用户权限在哪?" 它直接查索引卡,马上告诉你:"在 C 区 3 排 5 号书架,而且这本书被 D 区的《订单系统》引用过。"
这就是 CodeGraph 的核心:把你的代码变成一张"地图"。
二、它能帮你干啥?(太爽了)
1. 找代码:从"大海捞针"变"精准导航"
以前 AI 找个函数要调用几十次搜索工具,现在只需要查一次数据库。 效果: 原来要 1 分半才能找到的东西,现在 3 秒钟搞定。
2. 改代码:不怕"牵一发而动全身"
你想改一个叫 calculate_price(计算价格)的函数。 以前你不敢改,因为不知道哪里还用到了它,改错了线上就崩了。 现在你问 CodeGraph:"改这个函数会影响谁?" 它立马列个清单给你:订单页、购物车、优惠券系统都会受影响。 这就叫"心里有底"。
3. 省钱(省 Token)
这是最实在的。AI 每搜索一次、每读一个文件都要花钱(消耗 Token)。 以前 75% 的钱都花在"找文件"上了。 现在找文件几乎不花钱,钱全花在"思考和写代码"上,效率直接拉满。
三、它是怎么做到的?(简单版原理)
你不需要懂太高深的技术,只要知道这三步:
- 扫描:你运行一下命令,CodeGraph 就把你所有的代码扫一遍。
- 建库:它把代码里的函数、类、变量之间的关系,存进一个本地的"小数据库"(SQLite)。
- 连线 :它知道
A函数调用了B函数,C类继承了D类。
以后 AI 再问你代码的事,它不是去翻文件,而是去查这个"小数据库"。本地查询,速度飞快,还不用联网。
四、怎么用?巨简单!
你不用管那些复杂的配置,就三步:
第一步:安装 在终端里敲这一行:
bash
npx @colbymchenry/codegraph
第二步:建地图 进到你的项目目录,敲:
bash
codegraph init -i
喝口水的时间,它就帮你把整个项目的"地图"画好了。
第三步:重启你的 AI 编辑器(Cursor/Claude Code) 搞定!接下来你就正常跟 AI 聊天就行,它会自动调用 CodeGraph,你自己几乎感觉不到它的存在,但速度明显变快了。
五、总结一下
CodeGraph 就像是给 AI 配了一个资深老员工。 这个新员工对项目了如指掌,AI 每走一步都问他:"这东西在哪?""改这个会炸吗?"
适合谁用?
- 项目文件特别多的(几千个文件的那种)
- 接手别人烂摊子的
- 用 Cursor、Claude Code 觉得 AI 反应慢、找不着北的
一句话评价:
这玩意儿装上之后,真的回不去了。一旦习惯了 AI 秒回的感觉,再也不想看它转圈圈找文件了。
项目地址: GitHub 搜 colbymchenry/codegraph (已经有 5.2k Star 了)
要不要我帮你再写一个小红书风格的版本?那种带emoji、短句、强引流的,发朋友圈或社群效果会更好。