这不是下载后就能运行的切换软件，而是给编程智能体使用的产品说明书和实战经验包。
把下面一句话交给 Codex，它会先了解你的电脑和需求，再据此编写适合你的脚本或小应用。你可以只做“官方 ↔ 中转”，也可以增加多个官方账号、多个中转站和各自的模型设置，不必照搬作者的电脑环境。
- 平时用中转 API，偶尔切回官方账号，不想来回改配置。
- 经常更新插件、MCP、Skills 或钩子，担心切换后设置被旧配置覆盖。
- 想在两种模式下继续同一个本地对话，而不是每次重开。
- 不同中转站的模型、思考档位和代理要求不同，需要分别保存。
- 用其他切换工具改坏过配置，希望有能离线使用的恢复办法。
复制给编程智能体：
请阅读 https://github.com/IIMovoMII/codex-auth-switching-field-guide，从 SKILL.md 开始，结合我的电脑环境和实际需求，为我构建并验证 Codex 账号与接口切换工具。
智能体应先读取能自行确认的信息，只询问需要你决定的部分。需要登录、输入密钥、关闭 Codex 或修改历史时，会说明原因；不会凭空生成登录态。
| 功能 | 实际作用 |
|---|---|
| 一键切换 | 一个入口串起必要检查、历史准备和账号切换；高级修复选项另外保留 |
| 保留持续更新的配置 | 每次基于当前配置修改，不拿两份旧配置来回覆盖 |
| 旧对话兼容处理 | 分别检查会话归属、模型输入和界面索引；能安全修复才处理 |
| 日常增量检查 | 复用未变历史的检查结果，核实追加后只解析新增行；保留完整检查入口 |
| 保留模型偏好 | 不悄悄换模型、降思考档位；可按你的要求保持上下文上限 |
| 多账号、多中转（可选） | 每个档案保存自己的凭据、模型和思考档位，不复制整份配置 |
| 首次使用引导 | 缺少官方登录态就引导 OAuth；缺少 API 配置就引导本地录入 |
| 出错可恢复 | 区分登录失败、配置损坏和历史异常，不靠反复点击碰运气 |
这些是可选的产品能力，不代表本仓库已经附带了安装器或实现代码。
已有实战主要是 Windows 上一个官方账号与一个中转之间的切换。完整首次使用向导、多账号和多中转提供设计参考，需要在使用者的电脑上另行实现、验收。
目标是保留本地对话的正文、工具结果、项目归属，以及原任务打开和继续对话的能力。
但能看到旧消息，不等于模型能接受全部旧输入。有些中转会返回官方接口不接受的编号或推理数据。修复时应保留可见历史，说明哪些模型输入不能继续使用，并保留恢复材料；不能为了让扫描显示“零问题”直接删聊天。
验收要同时看三件事：旧内容看得见、模型接得上、新消息能继续保存和显示。 这不是对未来所有 Codex 版本、账号和中转站的永久保证。
2026 年 10 月的一次实测发现：扫描已经显示“零问题”，旧对话切回官方后仍不能继续，甚至无法压缩上下文。原因不只是编号格式，而是客户端续聊时引用了官方无法找回的旧记录；同时还查出旧修复留下的一处分页位置错位。
这次经验的重点是复现真正失败的续聊方式，保留正文和界面记录，再验证修复与恢复，不是给所有对话批量改编号。完整经过和已验证范围见故障复盘。
通常慢在历史检查，不是换密钥。新版经验把“重新准备”和“重新读完所有聊天”分开：未变文件复用结果，确认只是追加后只解析新增行；遇到重写、归档移动或规则变化，再做相应完整检查。小改动不必每次复制整份大历史，但恢复依据仍要先保存。
约 3.8 GB 历史副本实测：首次建立基线约 74 秒，后续无变化准备约 1.8 秒，两轮小量追加均约 4.6 秒。这是历史准备时间，不是实际账号切换总时间或速度保证。 追加路径仍读取旧内容核对哈希；首次登录、规则更新和复杂修复仍可能较慢。实现方法见增量准备经验。
Codex 更新不等于切换工具必须跟着重写。先核对变化是否影响切换；仍然兼容就继续使用，确实有变化再适配对应部分。日常切换尽量复用有效的检查结果，完整历史检查只在需要时进行，耗时长时说明正在处理什么。
遇到无法确认的历史格式，工具应停在切换之前，保留当前状态。我们优先保留这种“失败先停住”的能力；它能减少误改，但不能保证未来永远没有错误。多账号、复杂界面等功能按需选择，单纯切换两种模式无需全部实现。
没有官方账号的本机登录记录也能开始，但第一次仍需要你亲自登录。配置写好后，有些检查必须等完全重启 Codex 才能做；工具应记住进度，告诉你下一步，而不是提前报“全部完成”。
如果已有 CC Switch 等工具管理同一份配置，先选择由谁负责，避免互相覆盖。配置被清空、只剩通用模板或 Codex 已无法对话时，可用一份已知良好配置回滚；没有备份则根据可信信息重建。详见首次使用和配置恢复。
保存多个官方账号不代表自动共享云端聊天。跨账号能否看到并继续旧对话，需要单独实测；本仓库目前没有完成双官方账号验收。聊天暂时不显示时，应先核对账号、数据位置和筛选条件，不能直接当作记录已被删除。
实战证据主要来自 Windows；macOS、Linux 可以按本机机制适配，不代表三平台已有现成成品或全部实测。
经验包含原生 Codex CLI 0.159.2 的分页历史副本验证、0.162.0-alpha.2 对不可重放推理的复核，以及 0.162.0-alpha.17.2 的真实官方预热／续传对照、完整副本修复与回滚、停机执行后的只读核对；另有 PowerShell 5.1／7 回归测试。
2026-10-14 的本机改造补充了增量检查、小备份和未完成历史事务的恢复门禁，已通过副本与模拟中断测试；尚未替用户执行该版真实账号切换，也不代表实际断电或所有强杀位置均已验证。具体证据见验证清单。首页的绿色检查只证明文档结构、链接和有限隐私规则通过，不证明你的电脑部署成功。