#AI 工具调研清单 — 完整对比

2026-05-29 调研。目标:让 AI 在多 repo 找对信息 + 写代码前知道东西已经有了、不重复造轮子。 每个工具的好坏都查过资料核实(部分来自 GitHub issue、Reddit、G2 真实用户反馈),不是凭印象编的。 这是详细对比;直接看结论去 AI 工具栈选定。

#四类工具,各管一件事

把 AI 找信息想成一条流水线:

核心需求(写代码防重复)主角是 ④ 搜索。

---

#① 规则文件

• 关键:Claude 不自动读 AGENTS.md,得在 CLAUDE.md 里写一行引用它。
• 反常识:规则不是越多越好,研究发现塞太多反而让 AI 表现更差。要精简。

---

#② 导航(llms.txt 生成)

#vitepress-plugin-llms(我们的网站原生支持)

是什么:每次你 build 网站时,它自动生成一份「东西在哪」的导航文件,不用你手写维护。配置就一行,接在你已经在跑的命令上。

好在哪:零维护、自动更新、不会过期;接进现有流程不折腾。

坑在哪(核实过):

• 作者明说这是给英文文档的,中文别用 —— 我们是中文文档,得先跑一次看中文导航能不能用。
• 生成的文件放在「打包好的网站」目录,不回到源代码文件夹 —— 而 AI 读的是源代码文件夹,这个得另想办法。
• 有个已知 bug:文档里用了某种引用语法时,复制按钮会复制错。

#其他导航工具(都不适合我们)

---

#③ 打包(把整个 repo 塞给 AI 看全貌,适合小项目)

两个工具都是「打包工」—— 把一个 repo 的所有代码塞进一个文件丢给 AI。区别就一个:打包时压不压缩。

#Repomix(25.7 万人用,社区首选)

是什么:聪明的打包工。打包时会压缩 —— 只留代码骨架(函数名、结构),删掉里面的具体实现,所以包小很多。

好在哪:

• 包小,稍大的项目也塞得下。
• 打包前自动检查有没有把密码、密钥打包进去(防泄密)。
• 跟 Claude Code 集成好,有官方插件。

★ 我们自己实测(2026-05-29):

• 代码 repo(lead-tracking,58 文件):不压缩 62,575 token → 压缩后 37,097 token,省 41%(不是宣传的 70%,但 37K 能轻松喂进 AI)。Secretlint 真的自动排除了 2 个可疑文件。✅ 适合「让 AI 通读一个小代码 repo」。
• docs repo(本站,864 文件):打包完 1734 万 token,喂不进任何 AI;前 5 大文件全是 SVG 图(dynamodb.svg 一个占 22%),光图就吃掉一半。❌ docs repo 打包不可行(太大 + 全是图),要用得先排除 SVG/图片。

坑在哪(核实过):

• 超大项目照样塞不下 —— Google 一个大项目用它打包,压缩完还是有 5600 万「字」,远超 AI 能读的量。
• 打出来的包可能超过某些 AI 工具的文件大小限制,得拆开。
• 太大的单个文件(超 50MB)它直接跳过不打包。
• 压缩功能还标着「实验性」,不是所有编程语言都压得好。

#code2prompt(7.4 万人用,给爱折腾的人)

是什么:老实的打包工。不压缩,原样全塞进去。

好在哪:能自定义打包格式;能估算这个包喂给不同 AI 各要花多少钱;速度快。

坑在哪(核实过):

• 不压缩,所以包大 —— 项目稍大就塞不下,比 Repomix 更容易超。
• 社区里 Repomix 是默认选择,它是「给高级用户的替代品」。

同类的还有几个:gitingest、yek、files-to-prompt,都是「老实打包」这一派,原理一样。

---

#④ 搜索(让 AI 按需在所有代码里搜)★ 我们真需求的主角

这一类干的事:让 AI 写新功能前,先告诉它「这个能力已经有了,在那个文件」,AI 就不会重复造轮子。

先说共同点:这一类全是辅助 CC 的插件(装成 MCP server),你照常用 CC,它们在背后帮 CC 搜代码,没有一个要你换掉 CC。

两种做法,效果不一样:

对你「写代码防重复」这个需求:B(按关系搜)理论上更对症,因为它懂结构不只懂意思。但 B 的代表 Augment 要付费,免费的全是 A。取舍是:免费的 A 类够用但不精确,精确的 B 类要花钱。

一个重要发现(来自研究):按意思搜(A 类)对「找对文件」这件事,不一定比 AI 直接用关键词搜更强。所以下面这些工具都得装上实测,不能光信宣传。

#claude-context(开源,11.6 万人用)— A 按意思搜 · 辅助 CC

是什么:把你的代码做成「意思卡片」存进一个数据库,AI 问「处理用户登录的代码在哪」时,它返回最相关的 3-5 个函数,而不是把几千个文件全塞给 AI。

怎么存的:卡片存进一个叫 Milvus 的数据库(要单独搭)。做卡片可以用本地工具(不花钱、不联网)。

好在哪:

• 能本地跑(不一定要用云、不一定要花钱)。
• 官方支持你那三个 AI 工具全部(Claude + Codex + Gemini + Cursor)—— 这一类里唯一三个都明确支持的。
• 改了代码只更新改动的部分,不用整个重做。

坑在哪(核实过,按对你的重要性排):

• ★ 最要害:它绑死「当前目录」 —— 即使你索引了一个 repo,你必须人在那个 repo 目录里才能查它(GitHub issue #245)。开发者反馈:同时开好几个 repo 时,没法在一个 repo 里查另一个 repo。这对你「跨 9 repo 找东西」的核心需求很别扭 —— 它能索引多个 repo,但查的时候被锁在当前目录。装来试时必须重点验这个。
• 要自己搭那个数据库(Milvus),没运维经验有点门槛(单机版 Docker 装,够用)。
• 挑 Node 版本(只支持 20-23,装了 24 用不了)。
• 三个包拼起来,用户反馈有些毛刺。

#cocoindex-code(开源,母框架 10.1 万人用)— A 按意思搜 · 辅助 CC

是什么:跟上面 claude-context 干的事一样(按意思搜代码),区别是卡片存在一个小文件里,不用单独搭数据库,装上就跑。

好在哪:

• 1 分钟装好,零配置 —— 比 claude-context 省事(不用搭数据库)。
• 做卡片用本地工具,不花钱不联网。
• 支持多种编程语言。

坑在哪(核实过):

• 支不支持多个 repo 文档没说清楚(看起来是一个项目一个),对你「跨 9 repo」的需求是关键未知,要实测。
• 在 Mac 上做卡片慢 —— 它用不了 Mac 的 GPU 加速,只能 CPU 慢慢算。
• 完整版比较重(装的东西多),占空间。
• 没明确说支持 Gemini。

⚠️ 诚实标注:claude-context 和 cocoindex-code 谁的检索质量更好,没有中立的第三方横评 —— 两边都是各自官方/blog 自夸「省 70% token」。所以「哪个更准」只能自己实测,不能信任何一方宣传。

#mcp-local-rag(开源,小众)— A 按意思搜 · 辅助 CC

是什么:也是按意思搜,主打啥都不用搭,一个命令装好,完全本地、不花钱、不联网。

好在哪:真·零配置(连数据库都不用搭);完全私密。

坑在哪(核实过,这几个坑比较重要):

• 最大问题:要手动「喂」代码给它 —— 你改了代码不重新喂,它搜出来的就是旧的(过期)。这是它最大短板。
• 换工具要删库重来。
• 只支持 PDF、Word、txt、Markdown 这几种格式;单用户;没明确说支持 Gemini。

#Augment(付费 $20/月起)— B 按关系搜 · 辅助 CC(用它的 MCP 模式)

是什么:付费助手,它把你所有 repo 的代码读了个遍、记住了谁跟谁有关系。你改一个函数,它自动告诉你「这函数被这 8 个地方用了、依赖这几个东西、有这些测试」—— 直接防你重复造轮子。

辅助还是替代 CC? Augment 有两个身份:它自己是个独立工具(跟 CC 竞争,你不需要),但它也提供 MCP 模式接进 CC(你照常用 CC,它在背后喂 context)。你要的是后者 —— 不换 CC。

好在哪(核实过):

• 记忆规模业界最大(50 万文件),大代码库不慌。
• 不是简单搜关键词,是真懂代码之间的关系。
• 专业评分高(Gartner 4.8/5)。
• 最贴合我们「防重复」的需求。

坑在哪(核实过,真实用户骂的):

• 贵,而且按次烧钱 —— 2025 年改了收费方式,老用户在 Reddit 骂「挂羊头卖狗肉」「贵得离谱」。
• 没有永久免费版,试用额度用完就得掏钱。
• 极端例子:有人一个月烧了快 $15,000。

#Sourcegraph / Cody — B 按关系搜 · 能自托管但要折腾

是什么:老牌的代码搜索工具,按关系搜(精确找调用、引用)。

「代码还在,为什么不用开源版?」(核实过):你问得对,不是完全不能用 —— 但有三个真障碍:

• 冻结的标本 —— 2024 年 9 月开源版被冻结(archived),之后没有任何更新/修复,你自己 build 出来是个老版本,有 bug 也没人管。
• License 是混的 —— 只有 Apache 那部分(基础代码搜索/浏览/导航,叫 Sourcegraph OSS)能合法免费用;企业功能是另一套闭源 license,得自己挑哪些文件能用。
• 要自己 build + 自己维护 —— 没有现成的免费安装包,得从源码编译。

结论:能免费自托管基础代码搜索,但要折腾(自己编译 + 挑 Apache 部分 + 用冻结的老版本)。对想省事的个人不划算;愿意折腾的话,基础搜索功能确实白嫖得到。它最新的 Cody(AI 版)才是转纯企业付费($59/人/月)的那个。

#④ 类怎么选

对你「跨 9 repo」的关键提醒:三个免费的 A 类工具里,claude-context「锁当前目录」、cocoindex「多 repo 没说清」—— 跨 repo 这件事恰恰是它们都没明确解决的,这正是装来试时第一个要验的。

---

#调研中我纠正过的错误(诚实留痕)

1. 有个叫 google/codesearch(4 千人用)的,我一开始跟另一个同名工具搞混了 —— 它其实是 2015 年的老式关键词搜索,没有 AI 功能,不属于这一类。
2. cocoindex 我写过「1.8 万人用」,错了,母框架是 10.1 万。
3. claude-context 我说过「必须用云」,错了,能本地跑。
4. claude-context 我说过「不支持 Gemini」,完全说反了,它支持。
5. Sourcegraph 冻结时间我记错了,是 2024 年 9 月;而且我一开始武断判它「出局」—— 其实它的开源版能自托管,只是要折腾(自己编译 + 挑 Apache 部分)。
6. claude-context 我一开始把「挑 Node 版本」当主要坑 —— 其实真正要害是「锁当前目录、跨 repo 查别扭」,这对你的核心需求才是关键。

#还没验证的(装上跑的时候补)

• 这几个搜索工具到底支不支持 Gemini(官方文档大多没写清)。
• claude-context 本地搭起来到底多费劲。
• vitepress-plugin-llms 生成的中文导航质量到底行不行。

#资料来源

Repomix · code2prompt · claude-context · cocoindex · mcp-local-rag · vitepress-plugin-llms · Augment · AGENTS.md