同步客户端不工作——Syncthing / Dropbox / Nextcloud 连不上
症状
Markor 里改了 Markdown / todo.txt 文件，保存、自动保存都正常。等了几分钟甚至几小时，桌面端同步客户端里 还是看不到新内容。
排查顺序（从快到慢）
第一步：确认同步客户端在运行
| 同步客户端 | 怎么检查 |
|---|---|
| Syncthing | 下拉通知栏看 Syncthing 是否有常驻通知；打开 Syncthing 应用看 设备配对状态 是不是显示其他设备在线 |
| Dropbox | 下拉通知栏看 Dropbox 是否有同步状态通知（「正在同步」/「已同步」）；打开 Dropbox App 看当前是否在运行 |
| Nextcloud | 下拉通知栏看 Nextcloud App 是否有运行状态；打开 App 看同步日志 |
如果同步客户端完全不在运行 → 找到原因让它跑起来（见第二步）。
第二步：后台被杀了——最常见原因
Android 系统为了省电，会杀掉长时间在后台运行的应用。同步客户端是典型的后台长驻应用，最容易被杀。
检查是不是后台被杀：
- 打开同步客户端 → 看 上次运行时间 是不是很久之前（Syncthing 在状态栏会显示时间戳）
- 手动打开同步客户端 → 等几秒，然后再打开 Markor 改文件 → 这次同步可能就正常了（说明之前确实是被杀了）
解决后台被杀：
| 操作 | 效果 |
|---|---|
| 在 Android 设置里把同步客户端设为 不受限制的后台活动 | ✅ 最关键的一步。不同手机位置不同：设置 → 应用 → 对应同步客户端 → 电池 → 后台限制 → 选「不限制」 |
| 把同步客户端加入 开机自启 | ✅ 重启后自动起来 |
| 锁定同步客户端在最近任务列表里 | ✅ 有些定制 ROM （小米 MIUI、华为 EMUI）可以下拉锁定 App |
| 关闭系统的 省电模式 或 智能省电 | ✅ 省电模式会主动杀后台 |
第三步：确认同步目录配对正确
| 同步客户端 | 怎么检查 |
|---|---|
| Syncthing | 打开 Syncthing App → 文件夹 标签页 → 确认 Markor Notebook 目录 在列表里，状态是「未暂停」 |
| Dropbox | 打开 Dropbox App → 同步 或 文件夹 标签页 → 确认 Markor Notebook 目录在同步范围内 |
| Nextcloud | 打开 Nextcloud App → 同步设置 → 确认同步目录包含 Markor Notebook |
如果同步目录没配对 → 添加配对。
第四步：网络问题
| 症状 | 原因 | 解决 |
|---|---|---|
| 文件在手机本地改了但完全不同步到桌面 | 手机上同步客户端没有网络 | 确认 Wi-Fi 或蜂窝数据正常；Syncthing 默认走局域网，确保手机和桌面在同一个 Wi-Fi |
| 同步偶尔断流 | Wi-Fi 切了但同步客户端没自动恢复 | 手动开关一下 Wi-Fi；部分同步客户端需要重启才会重新建立连接 |
| 跨网络同步（手机用 4G，桌面在家用 Wi-Fi） | Syncthing 需要 TCP 打洞，网络环境复杂 | Syncthing 设置里打开 Global Discovery 或配置中继服务器 |
第五步：隐藏目录被忽略了
Markor 的 .app/snippets/ 是隐藏目录（以 . 开头）。部分同步客户端默认忽略以点开头的文件：
- Syncthing：默认不忽略
.app/（但忽略.zim/等部分隐藏目录）→ 在忽略列表里手动移除 - Dropbox：默认同步所有文件（包括隐藏的）→ 不需要处理
- Nextcloud：默认同步所有 → 不需要处理
第六步：两边同时改导致冲突副本
如果你频繁在手机和桌面同时编辑同一个文件，同步客户端会生成 冲突副本（文件名加 .sync-conflict-时间戳）。
- 检查同步目录里有没有这样的冲突副本
- 打开冲突副本看内容 → 选择保留哪部分 → 删掉冲突副本 → 继续同步
推荐的同步配置清单
为了让同步稳定，建议确认以下几点：
- [ ] 同步客户端已设为 不受电池限制
- [ ] 同步客户端已设为 开机自启
- [ ] 手机和桌面在同一个局域网（Syncthing 速度最快）
- [ ] 同步目录里没有过多隐藏目录（
.zim/建议不同步） - [ ] 定期（每周）打开同步客户端确认运行状态