/map-refresh

强制立即重建仓库映射(repository map)。

/map-refresh 会立即重建仓库映射(项目中符号和结构的紧凑概览,Aider 把它作为上下文提供给模型),而不是等待自动刷新。映射平时自动刷新的频率由 --map-refresh 参数控制(auto/always/files/manual,默认 auto)。映射本身的大小由 --map-tokens 控制(0 表示完全禁用)。

✅ 什么时候用？

在聊天之外做了大量手动改动之后

/map-refresh — 例如切换 git 分支或合并后新增了多个文件,让 Aider 把它们纳入映射

映射看起来过期了,尽管 --map-refresh 设为 manual

在复杂请求之前先 /map-refresh,确保符号概览是最新的

⛔ 什么时候不该用？

仓库没有相关改动

重建会消耗时间,项目大时还会明显占用 CPU,而结果不会有任何变化。

更好的选择: 信任自动刷新(--map-refresh auto,默认值)

仓库映射本来就被禁用

在 --map-tokens 0 时根本不存在可刷新的映射。

更好的选择: 把 --map-tokens 设为大于 0 的值,才能用上映射

来源

Aider 官方文档——聊天内命令(In-chat Commands) ↗ aider.chat