在 auth.json 不存在时无法恢复 Provider Auth - Codex
Quick fix
升级至 v3.13.0 即可解决多设备同步时因缺失 auth.json 导致无法恢复 Provider Auth 的问题。
Symptom
Section titled “Symptom”因为缺少 auth.json，已有的 provider auth 没有被用来恢复 live auth在多设备或 WebDAV 同步场景下，新设备的本地 ~/.codex/auth.json 往往尚未生成。旧版逻辑在检测到该文件缺失时，会直接判定认证信息丢失，从而中断供应商切换或 Live 配置同步流程，即使 Provider 配置中实际上已存有有效的 settings_config.auth。此外，Issue #561 指出 SQLite 与 WebDAV 的缓存机制会导致导出的配置文件中 auth.json 内容常为空，进一步加剧了跨设备同步时的状态不一致。该问题已在底层重构供应商密钥生命周期与实时同步逻辑后得到解决。
将 cc-switch 升级至 v3.13.0 或更高版本，新版本会自动从 Provider 配置中读取现有 auth 并恢复本地状态。
Affected Versions
Section titled “Affected Versions”ToolCodex
Versionv3.13.0 之前（v3.13.0 已修复）
Platforms未知
Source Issues
Section titled “Source Issues”- 为什么通过 WebDAV 同步后 auth.json 经常是空的？
- 这主要是 SQLite 缓存机制导致导出时数据未及时刷新所致，并非 WebDAV 传输问题。升级至 v3.13.0 后已优化同步与缓存处理逻辑。
- 升级后是否还需要手动创建或编辑 auth.json？
- 不需要。修复后的流程会在检测到本地文件缺失时，自动回退使用 Provider 配置中已有的 settings_config.auth 完成恢复。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。