仓库里做大迁移前，我在终端把 AI 的账先算清

迁移开始前，先把仓库按模块切成能回滚的批次

最常见的失败不是模型不够聪明，而是你在终端里敲下第一条命令之前，没有把迁移范围写下来。大仓库里总有一层共享的工具函数、一份没人敢动的配置，还有三个互相引用的目录。把它们一次性丢给 AI，结果往往是改了四百个文件，没人敢合并。

我在动手前会先统计每个模块的文件数、行数和被引用次数，再把它们排成从边缘到核心的顺序。每一批都要小到能在一次代码评审里读完，也要小到失败时能直接 checkout 回上一个提交。批次边界写进仓库根目录的文档里，模型每次只看当前批次的文件清单，不许顺手扩大战场。

这样做的额外好处是，批次本身就是天然的成本单位。你能在每一批结束时看到这次花了多少 token，而不是等到迁移收尾才发现预算已经穿底，这时候返工一次的代价比多买十次调用还高。

• 把共享工具层放在最后一批，避免它在中途被反复改写导致大量冲突。
• 给每一批固定一份文件清单，禁止模型顺手修改清单之外的任何文件。
• 在每批开始前打一个轻量标签，失败时能在一个命令内回到干净状态。

把上下文当免费，长会话的缓存读写先让账单炸掉

第二个坑是无节制地堆上下文。很多人每次提问都把整个目录结构、所有相关文件和十轮历史一起塞进去，看起来回答更稳，实际上每个请求都在为一堆没用的 token 付费。缓存读和缓存写同样要计费，真正省下来的只有命中缓存的那部分，而反复粘贴同一批文件会不断触发缓存写入。

我的做法是把上下文分成三类：需求说明、当前批次的文件、以及必须遵守的仓库约定。第三类最好压缩成十几行的检查清单，而不是每次重新粘贴一遍完整规范。调用时只带当前函数的相邻代码，而不是整个文件；会话拆短之后，重新写入缓存的开销也要算进这一批的预算里。

在终端跑批处理时，我会先用便宜的模型做归纳，再用更适合改写的模型动代码。比如用 Claude Haiku 4.5 把三十个报错整理成一份去重后的清单，只把清单和必要的几段代码交给下一层，省下来的不只是钱，还有反复读重复内容的时间。

这也是我最后落到 Fluxo 的原因：一把密钥、一个基地址 https://api.fluxorelay.com 就能同时调到 Claude、GPT、Gemini、DeepSeek、Kimi、GLM、Qwen、Grok 等模型，按真实 token 计费且包含缓存读写，没有月费，Claude Code、Codex、Gemini CLI 和任何 OpenAI SDK 都能直接接上，换模型不用改代码。

让模型一次改完全部文件，等于放弃验证

第三个错误是把迁移当成一次生成任务。模型输出四百个文件的 diff，你根本读不完，评审就退化成凭感觉点同意。真正的风险藏在那些没被改到的调用点里，它们会在两周后的某个深夜以类型错误的形式找上门。

更稳的方式是让每一批都自带验证闭环：先让它列出将要改动的文件和理由，你确认之后再改，接着跑测试和类型检查，最后只把通过的改动留在分支上。失败时不要让它自由发挥式地反复修补，而是把报错原文、相关文件和上一轮改动一起给它，要求它给出最小修正。

我还保留一条规则：任何改动超过两百行的提交，必须拆开，或者补一段人工评审记录。模型很会写代码，但只有你能判断这个抽象该不该留在代码库里，迁移最容易留下的债务就是多余的新接口。

• 要求模型在改动前先列出文件清单和预期行为变化，方便你提前拦下越界改动。
• 把测试和类型检查的命令写进任务描述，让模型在交回结果前自己跑完完整流程。
• 对接口签名的改动单独抽查所有调用点，避免只有定义改了而使用处仍指向旧版本。

没有迁移前的基准，就无法证明这次迁移值不值

第四个坑是不记基准。你不知道迁移前的构建耗时、测试通过率和单次任务的 token 消耗，迁移结束后自然说不清到底是赚了还是亏了，只能靠一句感觉好多了向团队交差。

我在开始前会存三组数据：一次干净构建的耗时，一次完整测试的结果，以及用固定提示词跑十次代表性重构任务的平均 token 数与一次通过率。迁移过程中每完成一批就重跑同一套提示词，数据自然落到同一张表里，中途换模型也能横向比较。

换模型时同样要守这套纪律。比如把批量重命名这类机械任务交给 DeepSeek V4 Flash，把跨模块的类型收拢留给更擅长推理的模型，两者都用同一份文件清单和同一段提示词，才说得清谁更适合哪一类工作。

账单里最容易被忽略的缓存口径与协作成本

第五个错误是只盯着输出 token。缓存写入在长会话里占比很高，尤其当你反复粘贴同一批文件时，写入本身就产生费用；等到你把会话拆短，又会重复写入一次。理解计费口径，比反复挑选一个听起来更便宜的模型更有意义。

协作里的隐性成本也常被漏算：每个人各自搭一套代理配置，密钥散落在各个终端的历史记录里，出问题时没人说得清哪次调用烧掉了预算。把入口统一之后，这类不确定性会小很多，迁移期间的账也能按批次摊到人。

如果你想先把这次迁移的账算清楚，欢迎注册一个 Fluxo 账号，用一把密钥把上面这几组基准跑一遍。你邀请来的人付费之后，你还会拿到一份推荐分成，正好抵掉一部分迁移试错的开销。遇到拿不准的配置问题，登录之后在联系页面留言就行。