切换Codex供应商后会话记录消失 - CC Switch

Quick fix

升级至v3.16.0以上，CC Switch会自动将第三方供应商历史迁移至custom桶，原文件已备份。

Symptom

报错原文复制

切换后记录丢了

Cause

Codex 按 model_provider 过滤可恢复历史，因此在供应商专属 id 之间切换会让过去的会话看起来"消失"了。所有第三方供应商现在归并到单一稳定的 custom 桶（保留 openai / ollama 这类预留的内置 id），并配一次性设备迁移：改写历史 JSONL 会话与 state_5.sqlite 线程表，原文件备份到 ~/.cc-switch/backups/codex-history-provider-migration-v1/。

Fix

1. 1

   升级 CC Switch 至 v3.16.0 或更高版本。升级后首次启动时，CC Switch 会自动执行一次性迁移，将所有第三方供应商历史归并到 custom 桶。

2. 2

   如果需要官方订阅账号与第三方会话互通，请在设置 → Codex 应用增强中开启「统一 Codex 会话历史」开关（v3.16.3 新增），开启时可勾选迁移已有官方会话。

3. 3

   如需了解详细机制及在磁盘上自行核验，请更新到 v3.16.4 并查看应用内提供的三语《Codex 统一会话历史指南》。

Affected Versions

ToolCodex

Version受影响版本 < 3.16.0；修复版本 3.16.0 及以上

PlatformsmacOSWindows

Source Issues

本页汇总自 2 个真实 issue

• #3510feat(codex): optionally align session history when enabling providers / 启用供应商时可选对齐会话历史
• #3790针对Codex自定义provider的“一次性设备迁移来改写历史 JSONL 会话与 state_5.sqlite 线程表”功能如何使用？

FAQ

找不到一次性设备迁移功能的入口在哪里？

它是自动执行的、无需手动入口。升级到 v3.16.0 及以上后首次启动时它会自动运行一次，改写已有的历史 JSONL 会话和 state_5.sqlite 线程表。

官方订阅账号与第三方会话的历史如何互通？

这是另一个开关：设置 → Codex 应用增强 里的「统一 Codex 会话历史」开关（v3.16.3 新增）——开启时可勾选迁移已有官方会话，关闭时按账本精确还原。

迁移过程中我的原始历史文件会被破坏吗？

不会。改写本地 JSONL 会话和 state 数据库前会自动备份，原文件备份在 ~/.cc-switch/backups/codex-history-provider-migration-v1/ 下，可以精确回滚。

相关问题

Codex 供应商 API Key 重启或切换后互相覆盖开启 CC Switch 本地代理接管模式，或在 config.toml 使用 experimental_bearer_token 绕过 auth.json 同步缺陷。7 issues mergedcc-switch DeepSeek 用量统计不准/余额查询失败升级到 v3.19.2 并重建 Codex 用量；余额查询需正确填写 {{apiKey}} 或代理。17 issues mergedcodex升级为ChatGPT后不适配了吗 cc-switch升级到 cc-switch v3.17.0，该版本已适配 Codex 合并到 ChatGPT Desktop 后的供应商切换，避免旧配置被覆盖。5 issues merged