備份與匯入

蛋日支援三種資料流程：完整備份、通用匯出，以及分享包匯入。每種格式都適合不同用途。

完整備份 (.cakeday)

.cakeday 是蛋日的官方完整備份格式，適合遷移裝置或長期封存。它會保留：

• 好友紀錄
• 自訂群組
• 高解析度頭像
• 好友層級提醒偏移、生日鬧鐘選擇、鬧鐘鈴聲、按對方時區提醒與日曆同步設定
• 應用程式層級提醒預設值、生日鬧鐘時間、預設鬧鐘鈴聲、主題、顯示偏好、詳情頁額外內容與日期格式設定

這是最接近完整還原的選項。

通用匯出 (JSON / CSV)

通用匯出 (JSON) 和 通用匯出 (CSV) 適合攜帶資料或手動處理。它們會保留以下核心欄位：

• 姓名
• 群組名稱
• 公曆或農曆類型
• 出生年、月、日
• 星座
• 備註

這些格式不包含頭像、自訂群組樣式、好友層級提醒與生日鬧鐘設定，或應用程式層級偏好設定。

分享包匯入 (.cakeshare)

.cakeshare 更適合好友資料的人對人分享。分享包可以包含好友、頭像和群組資訊，並支援加密與可選的額外密碼。

匯入 .cakeshare 時，蛋日會進入按好友選擇的匯入流程。你可以逐條勾選要加入的人，並在匯入前看到重複項目提示。協定細節請參閱 CakeShare 指南。

匯入模式

匯入 .cakeday、JSON 或 CSV 時，蛋日提供兩種匯入模式：

• 覆蓋匯入： 以匯入資料取代目前的本機資料庫。
• 增量匯入： 在保留目前本機紀錄的同時加入新資料。

覆蓋匯入適合遷移與復原。增量匯入更適合合併新的好友資料。

iCloud 與覆蓋匯入

如果裝置目前已啟用 iCloud 同步，覆蓋匯入會先完成本機還原，再暫停 iCloud 同步。這讓你可以先檢查匯入後的狀態，再決定何時重新啟用同步與合併。

重複項目識別與匯入後處理

蛋日在匯入過程中會使用以下欄位進行精確合併比對：

• 姓名
• 出生年份
• 日曆類型（公曆或農曆）
• 月和日
• 閏月標記

如果只有出生年份不同，蛋日會將匯入項目作為單獨紀錄處理，並可能提示為需要複核的疑似重複項目。

較長的匯入流程中，應用程式會顯示明確的進度。匯入完成後，蛋日會重新整理搜尋索引、小工具與相關延伸資料，讓新內容可以在各個入口中顯示。

系統日曆同步

蛋日可透過 EventKit 將生日寫入系統日曆。在好友中啟用「同步到系統日曆」後，蛋日會為接下來的每一年各建立一個獨立的全天日曆事件，而非單一的循環事件，並在好友被修改或刪除時保持這些事件更新。為每一年使用獨立的事件能讓農曆生日保持準確，因為它們每年並不會落在相同的公曆日期上。