同步功能使用指南

同步功能概述

同步功能是 Reeden 的核心功能之一，它允许您将本地数据与云端存储保持一致，并在多台设备之间同步阅读环境。通过同步功能，您可以：

• 在多台设备间无缝切换阅读
• 自动备份您的阅读进度和笔记
• 在不同设备间共享您的电子书库
• 同步字体、词典、背景图等阅读资源

需要注意的是，Reeden 的同步功能本身不提供云存储服务，您需要自行配置 WebDAV、S3、iCloud 或其他受支持的存储服务。

同步策略

Reeden 的同步大致可以理解为两类内容：

• 文件类内容：例如书籍文件、字体、背景图、词典、封面图集图片等
• 阅读与书库信息：例如书籍信息、阅读进度、笔记、标签、分类、阅读主题配置等

当本地和云端都有变化时，Reeden 会尽量把两边的数据整理后再同步，而不是简单地用一边覆盖另一边。

冲突处理示例

当多台设备都改过数据时

一般规则

• 同一项内容如果两边都改过，通常会优先保留较新的修改
• 如果您已经在本地删除了一条内容，通常不会因为云端还有旧数据就把它重新找回来
• 如果云端已不存在某条记录，而它又不是本地新创建的数据，本地也会删除这条记录，以保持一致

阅读进度

• 阅读进度会跟随书籍信息一起同步
• 同一本书在多设备上继续阅读时，通常会以您读得更新的位置为准
• 合并完成后，系统会保存阅读进度历史，避免常见的进度丢失问题

笔记、标签、分类

• 不同设备分别新增的内容，通常都会尽量保留下来
• 标签、分类、书籍信息这类内容如果都被修改过，通常会保留较新的结果
• 某些内容会尽量合并，而不是直接覆盖

阅读统计

• 某些阅读统计不会简单覆盖
• 例如阅读时长、阅读字数这类数据，会尽量保留更完整的结果，减少统计倒退

删除操作

• 删除是参与同步的
• 如果一台设备删除了某条内容，后续同步时其他设备也可能同步到这个删除结果
• 自动同步关闭时，不代表删除操作永远不参与同步，所以跨设备使用时仍建议谨慎删除

首次同步说明

首次同步时，请特别注意以下几点：

1. 建议先选定一台数据最完整的设备作为初始基准设备
2. 先在这台设备完成一次同步，确认云端已有完整数据
3. 其他设备再使用相同配置接入同步
4. 如果在已有云端数据的情况下随意切换部分关键设置，可能导致重复上传、重复下载或资源无法匹配

配置存储服务

Reeden 支持多种存储服务，您可以根据需求选择合适的服务：

WebDAV

• 优点：兼容性好，易于配置
• 适用场景：NAS、自建服务、支持 WebDAV 的网盘
• 配置要求：服务器地址、用户名和密码
• 常见示例：坚果云、123 网盘、各类 NAS WebDAV 服务

S3 兼容存储

• 优点：稳定可靠，支持大文件
• 适用场景：个人服务器、企业环境、对象存储服务
• 配置要求：需要 Access Key、Secret Key、Bucket、Endpoint 等信息
• 常见示例：阿里云 OSS、七牛云 Kodo、缤彩云，以及其他兼容 S3 协议的存储服务

iCloud

• 优点：与 Apple 生态深度集成
• 适用场景：iOS/macOS 用户
• 配置要求：Apple ID 登录

OneDrive

• 适用场景：使用 Microsoft 生态的用户
• 配置方式：应用内授权登录
• 说明：当前为实验性支持

Dropbox

• 适用场景：使用 Dropbox 的用户
• 配置方式：应用内授权登录

Google Drive

• 适用场景：使用 Google Drive 的用户
• 配置方式：应用内授权登录

百度网盘

• 适用场景：主要使用百度网盘的用户
• 配置方式：应用内授权登录，并设置同步目录

本地存储

• 适用场景：桌面端或 Android 用户，希望把同步数据保存到本地文件夹
• 配置方式：选择一个本地目录作为同步位置
• 适合场景：配合 NAS 挂载目录、同步盘、局域网文件夹等方式使用

当前支持的同步存储一览

• WebDAV
• S3 兼容存储
• iCloud
• OneDrive（实验性）
• Dropbox
• Google Drive
• 百度网盘
• 本地存储（桌面端 / Android）

不同存储服务的具体配置字段和填写方式略有差异，建议结合对应服务的单独教程进行配置。

同步配置项说明

自动同步

• 功能：按您设置的方式自动同步
• 说明：开启后，Reeden 会根据您设置的触发时机自动执行同步
• 建议：多设备使用时建议开启
• 注意事项：删除操作即使未开启自动同步，也会影响后续同步结果；频繁变更数据时也会增加同步次数

自动同步时机

• 启动时：应用启动后自动尝试同步，适合经常切换设备的场景
• 打开书时：打开书籍时自动同步，适合开始阅读前先拉取最新进度
• 网络连接时：网络恢复或连接可用时自动同步
• 数据变化时：阅读进度、笔记、标签、分类等本地数据变化后自动同步

自动同步间隔

• 功能：按固定时间间隔执行同步
• 可选项：可关闭，也可设置为 5 分钟、10 分钟、30 分钟、1 小时或自定义
• 建议：如果日常阅读变动较频繁，可以设置 10 分钟到 1 小时之间的间隔

数据变化后等待时间

• 功能：当选择“数据变化时同步”后，控制数据变化后等待多久再开始同步
• 作用：避免每次翻页、记笔记或修改元数据都立即触发一次同步
• 建议：一般使用 30 秒到 2 分钟即可；如果操作非常频繁，可以适当延长

仅 WIFI 同步

• 功能：限制在 WIFI 环境下同步
• 建议：建议开启，节省移动数据流量
• 注意事项：仅影响自动同步；手动同步时请以当前网络环境和文件体积为准

在书架显示同步按钮

• 功能：在书架页面显示手动同步入口
• 建议：如果您经常手动触发同步，建议开启

同步内容说明

支持同步的内容包括：

书籍信息与阅读数据

• 内容：书籍信息、阅读进度、笔记、标签、分类、阅读主题相关配置等
• 特点：这是同步里最核心的一部分，默认始终参与同步
• 注意：即使关闭某些文件类同步项，这部分内容也会继续同步

阅读主题排版配置

• 内容：阅读主题绑定的排版配置，例如边距、字体、间距等
• 建议：如果希望多设备阅读体验保持一致，建议开启

图书文件

• 内容：导入到 Reeden 的书籍文件本体
• 建议：多设备共用书库时建议开启
• 注意：文件较大时会影响同步耗时和流量

字体文件

• 内容：导入到 Reeden 的自定义字体
• 建议：需要在多设备保持相同阅读字体时开启

背景图

• 内容：阅读配色中使用的背景图片
• 建议：使用自定义背景图时建议开启

词典文件

• 内容：MDX 词典文件
• 建议：如果在不同设备都需要使用相同词典，建议开启

书籍封面缩略图

• 内容：本地图书封面的缩略图缓存
• 建议：仅在您希望多设备快速显示相同缩略图时开启
• 注意：这一项会明显增加同步数据量，不是所有场景都必须开启

封面图集图片

• 内容：封面图库中使用的图片文件
• 建议：如果您使用封面图库功能并希望跨设备同步这些图片，可以开启

高级设置说明

下载书籍前确认

• 功能：打开尚未下载到本地的书籍时，先弹出确认框
• 建议：移动网络环境或大文件较多时建议开启

使用原始文件名存储

• 功能：把书名或字体名直接作为云端文件名，便于识别
• 优点：云端文件更容易人工查看和管理
• 风险：同名文件可能互相覆盖；所有设备必须保持一致
• 建议：最好只在首次同步前、云端还没有数据时决定是否开启

合并云端数据前自动创建本地备份

• 功能：在同步并整理云端数据前，先自动创建一份本地备份
• 建议：建议开启，更安全
• 注意：会增加合并时间

文件加密

• 功能：对同步到云端的文件做额外处理
• 作用：降低被网盘内容审查直接识别的概率
• 注意：会增加同步时间

退出时同步

• 功能：桌面端关闭应用时，等待同步完成后再退出
• 建议：经常在桌面端阅读并立刻切换设备时可开启

iCloud 在 Finder 中可见

• 功能：控制 iCloud 同步文件是否在 Finder 中可见
• 适用平台：iOS / macOS 的 iCloud 同步场景
• 建议：只有在您明确需要从系统文件视图直接看到这些文件时再开启

跨设备同步最佳实践

1. 确保所有设备使用相同的存储服务配置
2. 建议开启自动同步功能
3. 定期检查同步状态
4. 重要数据建议定期手动同步
5. 首次同步时建议在 WIFI 环境下进行
6. 对“使用原始文件名存储”这类关键设置，所有设备必须保持一致
7. 在另一台设备开始阅读前，先手动同步一次，能减少进度冲突