延伸自 项目记忆放进文件:Trellis、Aegis 与轻量澄清
· 约 4 分钟
往里查代码:ACE 先找地方,再回到代码
本地代码知道名字就直接用 rg 搜;只知道一个行为、不知道写在哪,先问 ACE 找到大致区域,再用 rg 和源码确认。ACE 查出来的只是候选,结论要回到代码。
本文回答的问题
本地代码只知道行为、不知道写在哪的时候,用什么找,找到的东西怎么确认?
主线第 2 篇里说过,能从对话、文档和代码里查到的,不让模型来问我。“查”分两个方向:往外查资料,往里查代码。往外的那一半在另一篇延伸里,这篇讲往里。
先看知不知道名字
本地代码先分两种情况。知道函数名、报错文本、文件名或配置键,就用 rg(ripgrep,按字面搜文本的命令行工具)直接搜,或者直接打开文件。只知道一个行为,比如“导入时哪些错误会被拦下来”,不知道它写在哪、叫什么,再问 ACE。
ACE 是什么
ACE 是 Augment Context Engine 的简称。我用的是社区项目 acemcp,它把 ACE 做成了 MCP,用 uvx acemcp 启动,通过 CC Switch 在 Claude、Codex、Gemini 和 OpenCode 里同时打开。
它只有一个工具 search_context,两个参数:项目根目录 project_root_path,和一句描述要找什么的 query。每次查之前,它会先做一次增量索引:新文件和改过的文件分批上传到配置的服务端,没变的文件和 .gitignore 里写的跳过。所以第一次查一个大仓库会慢一些,后面只补改过的部分。
Windows 下路径要写成正斜杠,比如 D:/projects/example,不能写成 D:\projects\example。
什么时候问,怎么问
我一般在三种时候用它:接手一个陌生仓库,要先找到启动、路由或者数据从哪进来;只知道业务行为,不知道类名和函数名;一个功能散在好几个目录里,要把相关的文件找齐。
问的时候要描述行为和想弄清的关系,比如“找到应用启动时加载用户配置的入口,说明默认值、环境变量覆盖和错误回退分别在哪里处理”。只丢一个常见词,结果会很宽。精确的字符串不问它,直接交给 rg。
查到以后的顺序
ACE 给的是候选位置,不是结论。我一般按这个顺序往下走:
一次查空,也不代表代码不存在。先看路径对不对、是不是正斜杠、第一次索引跑完没有;再换一句更具体的描述查一次,最后用 rg 对一下。
例子:评审的结论也要回到代码
有一次整理一个项目的展示材料,我用 ACE 回查源码里有哪些功能入口,比如导入时的反馈怎么分成阻断、警告和提示,详情页能导出哪些东西。同时让 Claude Code 做了一次只读评审。
评审给的结论,也要再拿 ACE 或本地代码对一遍。其中一条关于一个乱码的总分字段,评审对它的影响判断得偏乐观。回到源码再查,演示数据里好几处“总分”都写成了 鎬诲垎,这条结论最后改成了“必须现场验证”。
ACE 只管先找到地方,缩小要读的范围,不替我读代码,也不替我验证。写进结论的话,要能指回具体的文件和代码。
参考资料
本文涉及的知识点
5 个
名称打开知识图谱中的对应条目;「另见」只计已发布文章。
本节知识点