备份与恢复 —— 导出书架数据以防万一

为什么需要手动备份

虽然 Novella 提供了 GitHub Gist 自动同步，但手动备份仍然有其价值：

• Gist 同步失败的兜底 —— 如果网络不通或授权过期，手动备份是最后的保险。
• 跨迁移方案 —— 如果你未来不想用 Novella 了想换别的客户端，手动备份的 JSON 文件更容易迁移。
• 不想开 Gist 同步 —— 有些用户不想让数据上云，只靠本地手动备份。

导出备份

操作路径：设置 → 存储 → 备份与恢复 → 导出备份。

导出时会弹出一个对话框让你选择备份文件的位置——可以是手机存储上的任意文件夹，建议选一个你能通过文件管理器轻松找到的地方（比如 Download 目录）。

备份文件是一个 JSON 文件，文件名格式通常是 novella-backup-YYYYMMDD-HHmmss.json，方便区分不同时间的备份。

备份里包含什么

• 完整书架数据 —— 所有加入的书、分类标签、自定义分组。
• 阅读进度 —— 每本书当前章节和位置、最后阅读时间、阅读时长累计。
• 书签和高亮 —— 手动添加的书签标记位置、高亮文本。
• 插件配置 —— 已添加的仓库列表、已安装和启用的插件。
• 书籍设置 —— 单本书独立的字号、行距、主题等排版参数。

不包含：

• 章节正文内容 —— 不备份下载的章节文件，省空间且这些内容随时能从书源重新拉取。
• 应用设置 —— 全局字号、主题色、翻页方式这些设置不包含在备份里，需要手动重新配置。
• 封面图缓存 —— 封面图随书籍条目关联，但图片文件本身不导出。

从备份恢复

操作路径：设置 → 存储 → 备份与恢复 → 导入备份。

1. 在文件选择器里找到之前导出的 JSON 文件。
2. Novella 会预览这个备份里有多少本书、多少书签、多少插件。
3. 确认后点「导入」—— 导入完成后书架、进度、书签全部还原。

警告：导入备份会覆盖当前所有书架数据。如果你的当前书架上有新增的书、还没同步到 Gist，建议先导出一个当前状态的备份以防万一。

定期备份建议

• 换机前 —— 一定要先手动导出备份，以防 Gist 同步在换机过程中出问题。
• 升级大版本前 —— Novella 偶尔会有 breaking change（比如数据格式迁移），备份一下留底。
• 每月一次 —— 养成习惯，每月导出一次备份文件存在云盘或电脑上。

备份文件能在其他客户端用吗

不一定。Novella 的备份格式是轻书架协议兼容的 JSON 格式，理论上其他支持轻书架的阅读器可以读取。但每个客户端可能有自己的字段扩展（比如某些 Novella 专属设置），这些字段在其他客户端上可能被忽略。