账号与同步

账号连接身份、购买、云端卡包、资源和跨设备学习状态。Cardary 采用本地优先模型：App 先把数据保存在本地，登录且在线时再与服务端交换变化。

同步范围

卡包同步可包含：

• 卡包信息和偏好；
• 卡片和字段；
• 分类；
• 标签和标记；
• 笔记；
• 学习计划；
• 学习日志；
• 测验日志；
• 图片、音频和文件等资源；
• 资源上传和下载状态。

某些数据仍保留在设备本地，例如缓存、临时文件、草稿和下载媒体。

同步方式

Cardary 使用 WebSocket 同步协议，包含 bucket、本地更新时间、服务器时间和 USN 版本追踪。

简化流程：

1. 检查每个 bucket 的本地版本。
2. 拉取本地 USN 之后的云端更新。
3. 拉取云端删除日志。
4. 推送本地更新。
5. 推送本地删除。
6. 记录服务器同步时间。
7. 按需要上传或下载资源。

增量同步不可用时，App 可回退到全量同步。

冲突行为

本地和云端都变更时，更新时间较新的记录获胜。如果本地记录较新，Cardary 会保留本地记录并标记为待上传。

删除会保守处理。云端删除不应删除删除点之后更新过的本地记录。

资源同步

富媒体卡包需要更多时间。图片、音频、文件、缩略图和包资源可能在卡包元数据之后继续上传或下载。

建议：

• 大型导入后保持 App 打开直到资源同步完成；
• 同步完成前不要删除本地文件；
• 在第二台设备上抽查媒体卡；
• 大卡包使用稳定网络。

登录和购买

登录会连接账号、云端数据和 CardaryPlus 权益。Apple App Store 和 Google Play 管理账单，Cardary 验证购买状态以便在 App 内恢复权益。

换设备时：

1. 安装 Cardary；
2. 使用同一 Cardary 账号登录；
3. 必要时恢复购买；
4. 拉取或同步卡包；
5. 等待资源下载完成。

良好同步习惯

• 新设备创建长期卡包前先登录。
• 大量编辑后同步完成再切换设备。
• 两台设备编辑同一卡包后尽快同步。
• 同步失败时先换稳定网络重试。
• 同步失败的卡包不要继续大量编辑。
• 破坏性清理前导出重要资料。
• 删除含同步内容的账号前阅读 账号删除。

常见排查

现象	处理
另一台设备看不到卡包	登录、获取云端卡包并同步。
媒体缺失	等待资源下载并检查网络。
最近编辑没出现	先同步编辑设备，再同步第二台设备。
同步反复失败	稳定网络重试，成功前避免继续编辑。
Plus 权益未生效	使用恢复购买，并确认商店账号。