THE READING GUIDE
同步、备份与迁移
在设备间传递收藏、设置与阅读记录。
English: data_sync.en.md
入口:设置 → 存储与同步 → 应用数据同步。选择已连接的网盘或 WebDAV 账号和远端目录;也可以在账号选择器中添加账号后继续配置。目录大小写必须与服务端一致。未配置时,顶栏同步按钮会打开此页面;配置后顶栏可直接选择上传或下载。高级字段排除可在需要时展开。
同步使用所选远端目录中的完整快照,文件名为 <day>-<dataVersion>.venera,默认目录为 /VeneraPlus/。旧 WebDAV 配置接入统一账号时会保留原 URL 下的 VeneraPlus/ 目录。首次上传会自动创建目录。每次上传替换当天较早的快照,并最多保留十份。快照包含设置、收藏、阅读历史、Cookie 和漫画源文件,不包含本地漫画图片、下载归档或远端漫画库内容。设置、收藏关系和阅读历史等数据继续在远端版本较新时按快照覆盖恢复。
漫画追更状态按漫画源与漫画 ID 共享持久化:首页、本地收藏、网络收藏和已跟踪漫画的详情页共用比较基准及待确认更新,切换页面或重启不会丢失。从详情页收藏或换源时使用已加载的章节、页数与日期建立基准;旧收藏缺少比较依据时,首次检查建立基准,不追溯此前的新增。新增章节、有效页数增长或更新时间前进可触发更新。首页显示源提供的更新时间,缺少有效日期时显示未知;进入阅读器不会立即清除标记,读完章节或手动标记已读后确认对应更新。
追更状态还使用每台设备独立的状态文件参与同步。上传、下载均会合并各设备发现的更新与针对具体内容版本的已读确认,不受完整快照版本号是否相同或较旧限制。某台设备确认旧章节时,另一台设备同时发现的新章节仍然保留。检查时间保留在本机。
同步模式
| 模式 | 行为 |
|---|---|
| 手动 | 只通过顶栏或 CLI 的上传、下载操作传输。 |
| 实时 | 本地修改后上传;启动和恢复前台检查下载,恢复检查至少间隔 10 分钟。 |
| 定时 | 每隔 5、15、30、60、180 或 360 分钟自动同步,默认 30 分钟。 |
自动同步有本地待上传修改时优先上传;没有待上传修改时才检查并下载较新的远端快照。上传失败会保留待上传标记,供下一次自动同步重试。定时器仅在应用进程运行时有效,应用关闭后不会唤醒系统。
选择实时或定时模式时,需要选择首次上传或下载。首次传输成功后才保存新配置;失败会恢复原有连接、模式、间隔和排除字段。手动模式直接保存配置。升级自旧协议时会将原有同步时机映射为手动、实时或定时模式,并优先上传本机当前数据;旧协议状态与旧云端目录不会读取、转换或删除。
同步边界
数据同步目标、同步模式、间隔、待上传状态、本地路径及 Bangumi 的本地重试队列保留在本机。disableSyncFields 中列出的设置不会写入快照。所有网盘账号及授权信息随设置同步,漫画库配置始终参与设置同步;请只在可信的存储服务上使用。
本地导入和云端下载均按完整 .venera 快照恢复,并在失败时还原已替换的文件。云端下载会合并本机与远端的追更状态;本地手动导入按所选备份恢复追更状态。恢复后会重新加载数据库、漫画源和相关运行时服务;仅本地手动导入会作为新的本地修改进入后续同步,云端下载不会反向触发上传。旧快照不含主页收藏夹绑定时,会解除本机旧绑定。