同步冲突与连接失败处理
同步连接失败
症状
配置好同步服务后，点击"立即同步"但显示连接失败。
排查步骤
- 检查网络：ReadAny 能否正常上网（打开 AI 对话试试）
- 检查服务地址：WebDAV URL 末尾不要加多余的斜杠；S3 Endpoint 确认正确
- 检查端口：WebDAV 通常用 80/443，S3 用 443。确认防火墙没拦截
- 检查凭据：用户名密码（WebDAV）、Access Key / Secret Key（S3）是否正确
- 手动测试：用其他工具（比如 Cyberduck 测 WebDAV、AWS CLI 测 S3）确认同步服务本身可用
双向冲突
症状
同步后，某些高亮或笔记出现重复条目，或被加上 _conflict 后缀。
原因
两台设备在都未同步的情况下分别对同一本书做了修改（新增了高亮、修改了笔记）。ReadAny 的智能合并在某些边缘场景下无法确定保留哪个版本。
处理方式
- 打开 ReadAny，进入"同步"→"查看冲突"
- ReadAny 会列出所有检测到的冲突项
- 你可以逐个查看两个版本，选择保留哪一个（或两个都保留）
- 完成后再次同步确认没有新冲突
预防
- 养成习惯：在一台设备上做了修改后，先同步再换另一台设备
- 把自动同步间隔设短一些（5 分钟），减少冲突窗口
- 如果经常出现冲突，说明你的阅读场景需要更细粒度的同步策略（比如专门用一台设备做修改主端）
同步后数据丢失
症状
同步后某本书的高亮或笔记不见了。
排查
- 检查同步方向：你是不是只在一台设备上开了同步？两台设备都要配置同一个同步源
- 检查同步设置：有没有把"高亮/笔记"排除在同步范围外？
- 检查云端：直接登录你的 WebDAV / S3 服务，看看 ReadAny 的同步目录里有没有对应的数据文件
- 撤销同步：如果是同步导致数据丢失，ReadAny 有"撤销上次同步"功能（在同步设置里）
预防
- 首次配置同步后，先手动同步一次，等完成后换另一台设备配置
- 在正式使用前，先用一本测试书做完整的同步验证流程
- 定期做本地备份（数据目录复制到其他位置），不要只依赖同步
局域网同步连不上
常见原因
- 两台设备不在同一局域网：确认都连接同一个 WiFi
- 防火墙拦截：Windows 防火墙可能阻止了 ReadAny 的局域网通信。临时关闭防火墙试试
- 服务端未开启：桌面端需要先在设置里"开启局域网同步服务"
- 配对码过期：首次连接的配对码有时间限制（默认 5 分钟），过期后需要重新生成
解决
手动模式：
- 桌面端：开启局域网同步 → 记下显示的配对码
- 手机端：打开同步 → 选择"局域网"→ 输入配对码 → 连接
重置同步配置
如果同步问题怎么都搞不定，可以：
- 关闭所有设备上的自动同步
- 在 ReadAny 设置里删除同步配置
- 手动清理云端 ReadAny 的同步目录
- 重新在一台设备上配置同步 → 同步 → 再在另一台设备上配置
这种方式可以排除云端残留数据导致的问题。