备份文件恢复——换设备或重装后的还原方法

备份从哪来

Chaldea 的备份来源有三种：

1. 自己导出的 userdata.json——随时在设置里手动备份
2. 自动生成的每日备份——每天零点在 backup/ 目录里自动生成一个带日期戳的 json
3. 在线备份 / GitHub 同步——之前上传到服务器或 GitHub 的数据

恢复时这三种来源通用——Chaldea 只认 json 格式的 userdata 文件。

恢复步骤

1. Chaldea → 设置 → 应用数据 → 用户数据管理
2. 找到"恢复备份"或类似入口
3. 选择你的 json 文件（从设备存储、云盘、GitHub 同步目录等）
4. 预览要恢复的数据变更（旧值 vs 新值）
5. 确认恢复

⚠️ 恢复会覆盖当前数据——恢复前最好先导出一次当前数据做双重保险。

各平台的备份文件位置

跨平台恢复

Chaldea 的数据格式在所有平台一致，所以跨设备、跨平台恢复都可行：

• Android → Windows：在 Android 上找到 userdata.json，传到 Windows 上，用 Windows 版恢复
• iOS → macOS：iOS 的"文件"应用里把 Chaldea 文件夹用 AirDrop 传给 Mac
• Web → 桌面：Web 版在设置里导出 json，桌面版导入

唯一需要注意的是版本兼容性：新版 Chaldea 可能引入了新的数据字段，用新版数据恢复到旧版 App 时，旧版可能无法识别新字段（通常忽略处理）。建议先升级 App 再恢复。

恢复失败怎么办

文件格式错误

• 确认文件是完整的 json 格式（用文本编辑器打开，开头是 {，结尾是 }）
• 确认文件没有被损坏（大小正常，不是 0 字节）
• 确认没有跨版本恢复（先用当前 App 版本导出，再用同一版本恢复）

恢复后部分数据丢失

可能原因：

• 这个 json 文件是旧版本的备份，一些新功能的数据（如 Laplace 编队模板）不在里面
• 恢复时选择了"部分字段覆盖"模式，而不是"完全替换"

解决：

• 重新用完全替换模式恢复
• 如果文件本身就是旧备份，那就只能接受数据缺失——这是定期备份的重要性

恢复后从者显示错乱

可能是区服设置不对：

• 备份来自国服，但恢复时当前账号区服设成了日服
• 切换到正确的区服设置后重新打开页面

最佳实践

1. 每周至少手动备份一次——上传到云盘或本地其他目录
2. 重要操作前先备份——比如大规模修改规划数据前
3. 跨设备同步后验证——在新设备上打开几个页面确认数据完整
4. 保留至少一份历史备份——万一最近的备份坏了还有兜底