Configuration Backup and Restore

配置备份与恢复

用于恢复供应商、模型选择与 Fusion 配置，或迁移到另一台机器。备份包含凭据，Base64 只是编码，不是加密。

从界面操作

• macOS：菜单栏 →「高级」→「导出配置备份…」或「导入配置备份…」。
• Windows：托盘 →「高级」→「连接、备份与诊断…」。
• Web 面板：「高级」中的配置备份操作。

导入会替换当前 Mixin 配置，先导出一份当前配置再迁移。导入完成后确认网关状态，必要时重启；如果提示配置已导入但应用失败，表示保存已完成，需要继续处理网关或客户端同步错误。

CLI 对照

codex-mixin config export codex-mixin-config.b64
codex-mixin config import codex-mixin-config.b64
codex-mixin service restart

导入前检查文件、Base64 / JSON、配置版本和模型引用，通过后加密并原子替换当前工作配置。校验失败时不会覆盖当前配置。

跨机器迁移

1. 源机器导出备份，通过可信渠道复制到目标机器。
2. 目标机器使用不低于源机器的版本，导入后启动网关。
3. 在目标机器的 Agent 页面接入客户端，必要时重新完成 OAuth 登录。
4. 重启客户端或打开新会话，确认模型可用。

备份不包含源机器的监听绑定，不复制客户端账号、历史会话、用量数据库或系统启动项。导入后目标机器按自己的配置分配端口，默认监听所有网卡。

保管与恢复边界

本机工作配置 config.json 使用 AES-256-GCM，解密密钥在旁边的 config.json.key；跨机器迁移使用导出功能，不要只复制其中一个文件。

不要把备份放进 Git、Issue 或公共分享链接。导入配置与恢复 Agent 原配置不同：后者在 Agent 页面断开接入。详见 数据与安全。