iCloud 同步

鼠输入法使用 Apple 的 iCloud / CloudKit 能力同步字节粘贴格子、附件预览、画布文件、Markdown 文件、因果图文件和通用文件。用户不需要手动导入导出，但用户需要满足 Apple ID、iCloud Drive 和网络条件。

同步前提

• iPhone、iPad 和 Mac 必须登录同一个 Apple ID。
• 设备必须允许鼠输入法使用 iCloud。
• 网络必须可用。
• iOS 键盘扩展若要直接读取云端内容，需要开启完全访问。
• App Store 发布版本必须使用已经部署到 Production 的 CloudKit Schema。

哪些内容会同步

内容	同步方式	说明
字节粘贴格子	CloudKit	文本、富文本、图片、文件引用和预览图。
字节粘贴附件	CloudKit Asset	PDF、图片、Markdown、pkdrawing 等文件内容。
画布 / Markdown / 因果图	iCloud Drive 应用容器	用户可以在 Files / Finder 中看到应用目录。
通用文件夹	iCloud Drive 应用容器	用于存放任意格式文件。
日记	本地优先，后续可扩展	当前用户应以主 App 中显示为准。

同步不是立即发生怎么办

用户可以先检查两件事。第一，另一端 App 是否已经打开并完成账号状态检测。第二，当前设备网络是否能访问 iCloud。CloudKit 推送有时会延迟，用户可以在主 App 的同步页面手动刷新。

新文件为什么在另一台设备看不到

如果文件来自 iCloud Drive 应用容器，系统需要时间把文件下载到另一端。用户可以打开系统 Files 或 Finder，确认 NanoMouse / 鼠输入法目录是否已经出现该文件。只要系统文件层面已经同步，鼠输入法就可以加载。

CloudKit Production 注意事项

开发版本和发布版本使用的 CloudKit 环境不同。开发调试通常使用 Development，App Store 和 TestFlight 使用 Production。上线前必须在 CloudKit Dashboard 中把 Development Schema 部署到 Production，否则发布版本可能无法同步记录类型。