歌单 JSON 与完整配置的导入导出——跨设备迁移的手动安全网
两种导出粒度
| 粒度 | 包含内容 | 用途 |
|---|---|---|
| 歌单 JSON | 指定歌单的歌曲列表(歌曲稳定身份、来源平台、元数据快照) | 单独导出/导入某个歌单 |
| 完整配置 | 全部设置 + 语言 + 平台授权 + GitHub/WebDAV 配置 + 一起听设置 | 整机迁移到新设备 |
歌单 JSON
导出歌单 JSON 时:
- 输出是标准 JSON 文件,结构清晰、可用文本编辑器查看
- 包含歌曲的稳定身份(跨同步通道可识别)
- 包含基础元数据(歌名、歌手、专辑)
- 导入时会去重——已经在目标歌单里的歌曲不会重复添加
完整配置
完整配置导出是一次性快照,包含:
- 所有设置项(主题、模糊、音效、通用等)
- 语言偏好
- 平台授权状态(但不会导出平台 Cookie/会话等敏感凭据)
- GitHub / WebDAV 同步配置(仓库路径、服务器地址等)
- 一起听自定义服务端地址
完整配置导入是覆盖式操作——应用会把导出时的所有设置项覆盖到当前设备上。敏感凭据(GitHub PAT、WebDAV 密码等)在导出时不会包含,需要重新手动填入。
与 GitHub/WebDAV 同步的关系
备份恢复和去中心化同步是互补关系:
- GitHub/WebDAV 同步是持续的、自动的、实时的——数据变更后自动同步
- 备份恢复是手动的、按需的——跨设备迁移或换机时使用
建议同时启用:
- GitHub/WebDAV 同步保障日常数据安全
- 完整配置导出作为跨设备迁移的手动安全网
导入/导出的撤销
和歌单批量操作一样,导入歌单 JSON 后会提供撤销反馈条——如果导入结果不理想,可以快速撤销。