同步、备份与恢复
iCloud 同步让多台设备看到同一套数据；备份文件用于在错误操作、迁移或数据问题后恢复。两者不能互相替代。
iCloud 同步
开启后，Locus 通过 Apple CloudKit 自动同步任务、项目、标签、过滤器和相关关系。同步通常在后台发生，速度取决于网络、iCloud 状态、系统调度和数据量。
使用前确认：
- 各设备登录同一 Apple 账户并启用 iCloud Drive；
- Locus 获准使用 iCloud；
- 网络可用，设备有足够存储空间；
- 应用版本尽量一致。
同步是最终一致的：短时间内不同设备可能显示不同状态。刚做完大量导入或修改时，让应用保持打开片刻，不要在另一台尚未同步的设备重复操作。
同步不是备份
同步会传播删除和编辑；误删后，其他设备也可能同步该删除。自动备份则保留某个时间点的数据，可以独立导出。
自动备份
Locus 默认会在应用获得执行机会时，最多每 24 小时创建一次本地自动备份，并保留最近 14 份。它不是精确到固定时刻的后台任务；如果长期不打开应用，可能不会每天生成。
自动备份保存在当前设备本地，不应假设它会随 iCloud 同步到其他设备。
手动备份
在“设置 → 备份”中选择立即备份，然后通过系统分享保存到“文件”、外置磁盘或你信任的存储位置。
建议在这些操作前手动备份：
- 批量删除、移动或改日期；
- AI 大批量整理；
- 导入 Things 3 或大量提醒事项；
- 使用“替换”恢复；
- 大规模重建项目、标签组或过滤器。
备份文件扩展名为 .locusgtdbackup，本质是 UTF-8 JSON。新备份包含任务附件。
备份文件未加密
备份可能包含任务标题、备注、日期、位置、关系和附件。只保存到可信位置，不要随意通过公共链接或不受信任的邮件发送。
合并导入
合并以记录 UUID 判断：
- 当前数据库已有相同 UUID 时，保留当前整条记录和关系，不用备份覆盖。
- 当前数据库没有时，从备份添加。
因此合并适合补回缺失记录，不适合用旧备份撤销对现有记录的编辑。导入完成后查看统计和关键项目，确认跳过与新增数量符合预期。
替换恢复
替换会删除当前 GTD 数据，并以备份内容重建。这是破坏性操作且无法在应用内撤销。
安全顺序：
- 先把当前数据另存一份手动备份。
- 确认目标文件的创建时间和来源。
- 关闭其他设备上的 Locus，避免恢复期间继续写入。
- 执行替换并等待完成，不要强制退出。
- 检查任务、项目、标签、过滤器、附件与日期。
- 再让设备逐步恢复同步。
备份导入采用事务处理；验证或写入失败时会尽量整体回滚，而不是留下半套数据。
附件
附件和任务一起存储、同步并进入新格式备份。单个附件上限为 20 MB，一次最多选择 20 个文件。大量附件会显著增加同步与备份体积，导入后应等待上传完成。
同步问题排查
- 查看 Locus 设置中的同步状态和错误说明。
- 确认两台设备的 Apple 账户、网络和应用版本。
- 在各设备打开 Locus 并保持前台片刻。
- 不要通过反复开关 iCloud、卸载应用或清空数据来“试一试”。
- 在仍有完整数据的设备上立即导出手动备份。
- 如果持续异常，通过 支持页面提供版本、设备、时间和错误提示。
卸载前先备份
如果数据尚未上传到 iCloud，删除应用可能同时删除唯一的本地副本。不要把“重新安装”当作第一步排查方式。