庭记 iCloud 同步指南
一、同步机制简介
庭记的跨设备协作基于 Apple CloudKit 私有数据库（Private Database）——数据存储在您个人的 iCloud 账号容器中，不经过庭记开发者的服务器，开发者无法访问您的任何数据。
日程与文档走两条独立的同步通道：
- 日程：结构化数据（案号、时间、提醒等）通过 CloudKit Record 同步，数据量小，网络正常时通常 30 秒至 3 分钟内到达另一端。
- 文档（PDF）：分两步走——元数据（文件名、文件夹归属等）先同步；PDF 正文以 CloudKit Asset 形式单独上传，另一端可在打开时按需下载，或在 Mac 设置中开启「自动同步文档」提前缓存到本机。
提示：日程不同步与文档不同步是两个独立通道，请根据具体现象分别排查。
二、开启同步必须满足的全部条件
以下任一条件不满足，同步均无法正常工作。排查故障前请逐项核对：
条件一：两端登录同一个 Apple ID
| 设备 | 检查路径 |
|---|---|
| iPhone | 设置 → 顶部头像 → 查看 Apple ID 邮箱 |
| Mac | 系统设置 → 左上角头像 → Apple ID |
两端必须显示完全相同的 Apple ID 邮箱。
条件二：系统 iCloud 服务正常开启
- iPhone：设置 → [你的名字] → iCloud → 确认「iCloud 云盘」已开启。
- Mac：系统设置 → [Apple ID] → iCloud → 确认「iCloud 云盘」已开启。
- 确认 iCloud 账号未处于欠费、停用或锁定状态。
条件三：庭记被允许使用 iCloud
- iPhone：设置 → [你的名字] → iCloud → 显示全部 App → 找到「庭记」→ 确认已开启。
- Mac：系统设置 → Apple ID → iCloud → 确认庭记 / iCloud Drive 相关权限未被关闭。
条件四：账号拥有有效高级会员资格
- 会员通过 App Store 购买，购买后凭证会写入 CloudKit 供 Mac 端读取校验。
- 在 App「设置 → 会员」可查看当前状态；曾购买但未显示时，请执行**「恢复购买」**。
条件五：两端 App 均已手动开启同步
- iPhone：设置 → 找到「启用 iCloud」开关 → 打开。
- Mac：设置 → 同步 → 将「同步模式」切换为「云端同步」。
必须两端都开启：若仅一端开启，另一端处于“仅本地”状态，数据不会互通。
条件六：网络可正常访问 Apple CloudKit
- 正常网络环境通常无阻碍。
- 部分企业内网、涉密网络或特定代理工具可能拦截 Apple CloudKit 的 HTTPS 域名请求。完全离线时数据保留在本地队列，网络恢复后自动续传。
三、首次开启同步的注意事项
- 首次开启时 App 会将本地数据写入 CloudKit，数据量大时可能需要数分钟，请保持 App 前台运行且网络畅通。
- 若两端都有历史本地数据，建议先在数据更完整的一端开启同步并等待上传完成，再在另一端开启。
- 另一端首次加载云端数据后，日程列表可能需要刷新或重新打开 App 才能显示。
- Mac 端文档默认不自动下载全部 PDF 正文；可在「设置 → 自动同步文档」中开启后台自动缓存。
四、分场景排障
场景 1：无法开启云端同步 / 开关立刻回退
- 原因 A：会员资格未被识别
进入「设置 → 会员」查看状态；若未显示有效，点击「恢复购买」。若在 iOS 端刚完成购买，Mac 端通常数分钟内读取到资格；也可在 Mac 端直接点击恢复购买。 - 原因 B：系统 iCloud 权限被关闭
在系统设置中确认庭记对 iCloud 的访问权限已开启。 - 原因 C：需要重启 App
若设置页提示需要重启，请完全退出 App 后重新打开再尝试开启。
场景 2：日程不同步（一端有，另一端没有）
- 确认两端均为「云端同步」模式，排除一端为「仅本地」的情况。
- 在来源设备上小幅修改一条日程（如在标题末尾增删一个空格）以触发强制推送，等待 1–2 分钟。
- 在目标设备完全退出 App 后重新打开，强制刷新本地缓存。
- 若使用特定 VPN 或企业网络，暂时切换到普通 Wi-Fi 或手机热点测试。
场景 3：文档一直显示“待上传”或“上传失败”
- 检查 iCloud 剩余存储空间：确保 iCloud 空间充足。
- iPhone：打开文档信息面板（Inspector），点击「重试上传」，保持 App 前台运行至上传完成。
- Mac：确认「自动同步文档」已开启，保持 App 前台以清空上传队列。
- 大文件（如 50MB 以上 PDF）上传较慢，建议在稳定 Wi-Fi 环境下耐心等待。
场景 4：Mac 看得到文件条目但无法打开
这是正常的「元数据已同步、正文待下载」状态。点击文件会触发下载，等待进度完成后即可打开；如开启「自动同步文档」则会在后台自动下载。
五、联系支持
若已完成上述排查仍未解决问题，欢迎联系我们：
- 📱 App 内提交：「设置 → 反馈」
- ✉️ 技术支持邮箱：[email protected]
建议提供：设备型号、系统版本、App 版本号以及设置页截图，便于快速定位解决。