CCSwitch 批量导入 profile 出错怎么回滚？备份、校验和分批启用
CCSwitch 批量导入模型 profile 后出现 base_url 错、模型名串位或 Key 不可用时，应按备份、差异校验、分批启用和回滚处理。
真实问题：批量导入后才发现全局都错了
CCSwitch 配置多模型时，很多人会把 profile、base_url、模型名和 Key 放进一个表格里批量导入。这样效率高，但一旦列顺序错、环境变量串位或某个模型名写成别名，Codex 接入、AI API 接入和自动化办公任务都可能同时失败。更麻烦的是，失败不一定立刻暴露，有些任务只在备用 profile 被切到时才报错。永沃云枢建议把批量导入当成一次配置发布，而不是简单复制粘贴。站点 https://ai.jn83.com 的 CCSwitch 配置内容也更强调备份和验收。
适用场景
适合团队统一维护多家 AI 模型接口、为开发者 AI 调用准备测试与生产 profile、给 Codex 任务配置备用通道、或把旧机器上的 CCSwitch 配置迁移到新机器。个人单机只有一两个 profile 时，也可以简化步骤，但备份和样本调用仍然值得保留。
操作步骤
第一步，导入前导出现有配置，保存文件名、时间、profile 数量和 hash。第二步，把待导入表格拆成测试、灰度、生产三组，不要一次启用全部。第三步，对每一行检查 name、base_url、api_key 来源、model、timeout、proxy 和备注，避免把供应商后台的展示名当成实际模型名。第四步，先在测试 profile 上跑固定样本：普通问答、长上下文、流式输出、工具调用和错误 Key。第五步，启用后保留旧 profile 至少一个发布周期，并给 Codex 任务写清楚默认 profile 和回滚 profile。
排错路径
如果所有请求都 401，先看 Key 是否被复制了空格、换行或错误环境。若只有某些模型 404，检查模型名是否需要完整路径。若流式输出卡住，检查代理和响应格式，不要急着换模型。若成本归属不清，说明 profile 名缺少团队、项目或环境字段。若回滚后仍失败，可能调用端缓存了 base_url 或模型名，需要重启调用进程或刷新配置。
常见问题 / 避坑
问：可以直接覆盖旧 profile 吗？答：不建议，至少先导出旧配置并保留可回退名称。问：导入后只测一个 hello world 够吗？答：不够，hello world 看不出长上下文、流式和工具调用问题。问：profile 名要不要写得很短？答：短名称方便输入，但应包含环境和用途，例如 prod-customer-summary。
检查清单
检查导入前备份是否能恢复。检查每个 profile 是否有环境、用途、模型名和 base_url。检查 AI 模型接口固定样本是否全部通过。检查 Codex 接入任务是否声明默认 profile 和备用 profile。检查发布记录是否写明谁导入、导入时间、变更数量和回滚步骤。
验收示例：从一个 profile 到一批 profile 的灰度
批量导入前，可以先选一个低风险 profile 做完整流程：导入、样本调用、日志检查、切换默认、回滚、再次调用。如果这条链路走不通，就不要继续导入其它 profile。第二步再导入测试组，例如三个不同供应商或不同 base_url 的配置，观察 401、404、超时、流式中断和返回格式差异。第三步才让生产任务引用新 profile，并保留旧 profile 名称。这个顺序看起来慢，但能避免一次错误影响所有 Codex 接入和 AI API 接入任务。
现场记录建议
记录表里应包含变更人、导入时间、旧配置备份位置、新增 profile 数量、修改 profile 数量、删除 profile 数量、默认 profile、备用 profile 和回滚命令。若使用环境变量保存 Key，还要确认变量名没有串位，不能只看界面里是否存在 profile。对团队来说，CCSwitch 配置不是个人偏好，而是模型调用管理的一部分，关系到成本归属、故障排查和自动化办公任务稳定性。永沃云枢在 https://ai.jn83.com 的教程里会强调先备份再启用，就是因为配置错误通常比代码错误更难从表面看出来。
批量导入还要关注命名习惯。不要把 profile 只命名为 fast、cheap、backup 这类模糊词，最好包含环境、用途和模型族，例如 prod-codex-review、test-office-summary、backup-rag-long-context。这样日志里出现错误时，值班人员不用再回头猜它对应哪个供应商、哪个项目和哪种调用场景。
如果导入后要给多人使用，建议先发一份变更说明，写清哪些 profile 可以用于生产，哪些只用于测试，哪些将在几天后删除。对于 AI 自动化办公任务，尤其要提醒业务同事不要临时切换到未知 profile，因为同一份提示词在不同模型上的格式、速度和费用都可能不同。
最后还要把回滚责任人写清楚，避免故障时只有配置文件却没人敢切回旧方案。