备份与导入

蛋日提供三类数据流：完整备份、通用导出和分享包导入。不同格式面向不同场景，作用清晰。

完整备份 (.cakeday)

.cakeday 是蛋日的官方完整备份格式，适合迁移设备或长期归档。它会保留：

• 联系人数据
• 自定义分组
• 高分辨率头像
• 联系人级通知与日历同步设置
• 应用级提醒时间、主题、显示偏好与日期格式设置

这是最接近“完整恢复”的导出方式。

通用导出 (JSON / CSV)

通用导出 (JSON) 与 通用导出 (CSV) 面向跨平台交换和人工处理场景。它们保留核心字段，例如：

• 姓名
• 分组名称
• 公历或农历标记
• 出生年份、月、日
• 星座
• 备注

这两种格式不包含头像、自定义分组样式、联系人提醒配置或应用级偏好设置。

分享包导入 (.cakeshare)

.cakeshare 更适合人与人之间分享联系人资料。分享包可以包含联系人、头像和分组信息，并支持加密与附加密码。

导入 .cakeshare 时，蛋日会进入按联系人选择的导入界面。您可以逐条勾选要导入的人，并在导入前看到重复项提示。CakeShare 的协议细节请参阅 CakeShare 分享。

导入模式

导入 .cakeday、JSON 或 CSV 时，蛋日提供两种导入模式：

• 覆盖导入： 用导入数据替换当前本地数据库。
• 增量导入： 追加新数据，同时保留现有联系人。

这两种模式适合不同场景。覆盖导入适合迁移或完整恢复，增量导入适合合并新联系人。

iCloud 与覆盖导入

如果设备当前已启用 iCloud 同步，覆盖导入会先完成本地导入，再暂停 iCloud 同步。这样您可以先检查导入结果，再决定何时重新开启同步与合并。

这种处理方式更适合高风险操作，因为云端数据仍可作为回退参考。

重复项识别与导入后处理

蛋日在导入过程中会按以下条件识别重复记录：

• 姓名
• 日历类型（公历或农历）
• 月、日
• 闰月标志

出生年份不参与重复判定，因此同名同月日但年份不同的记录仍会被视为重复。

导入期间，界面会显示明显的进度反馈。导入完成后，蛋日会刷新搜索索引、小组件和相关扩展数据，确保新内容尽快在各个入口中可见。

系统日历同步

蛋日可通过 EventKit 将生日写入系统日历。在联系人中启用“同步到系统日历”后，应用会创建每年循环的全天事件，并在联系人被修改或删除时自动同步更新。