自动升级不行，重新下载新版本安装之后还是老版本 - CC Switch
Quick fix
彻底卸载旧版本并清理残留后重新安装，即可解决自动升级失败或版本未更新的问题。
Symptom
Section titled “Symptom”mac安装3.15版本升级不成功，自动升级不行，删除了之后重新下载新版本，安装之后还是老版本该问题通常由于旧版本进程未完全退出或残留配置文件导致新版本无法正确覆盖安装。此聚类还包含多种更新升级后的衍生异常：本地 Codex 已是最新版但 CC Switch 检测为低版本（#5981）、新版本不支持配置多个 OpenAI 官方供应商（#5333）、修改 Key 保存后恢复原状（#4300）、外部工具更新导致提示词被覆盖（#4684），以及统一会话历史迁移导致 encrypted_content 解密失败（#4464）。针对升级失败和版本检测错误，核心机制是本地状态缓存或数据库未随新版本正确刷新。
完全退出 CC Switch 及相关后台进程。
彻底删除并卸载旧版本应用及残留配置。
从官方渠道重新下载最新版本并安装。
Affected Versions
Section titled “Affected Versions”ToolCC Switch
Version未知
PlatformsmacOSLinuxWindows
Source Issues
Section titled “Source Issues”本页汇总自 6 个真实 issue
- 为什么本地 Codex 已经是最新版本，但 CC Switch 检测是低版本？
- 这是版本检测机制的缓存或路径识别错误，通常彻底卸载并重新安装 CC Switch 可以刷新检测状态。
- 升级后配置多个 OpenAI 官方供应商只显示第一个怎么办？
- 这是新版本数据库兼容问题，需使用数据库软件打开 ~/.cc-switch/cc-switch.db，将 providers 表中 id = codex-official 的 ID 重命名为 codex-official2 后重启。
- 升级后统一 Codex 会话历史导致 encrypted_content 解密失败如何恢复？
- 切换 Provider 无法解密旧账号密文，需回到原账号和原 Provider 续接，或使用社区离线迁移脚本处理。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。