# 備份與匯入

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

## 完整備份 (.cakeday)

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

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

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

下載後的 HQ 鬧鐘鈴聲檔案不屬於備份內容。它們是裝置本機資源，可在鈴聲選擇器中重新下載。

## 通用匯出 (JSON / CSV)

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

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

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

## 分享包匯入 (.cakeshare)

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

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

## 匯入模式

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

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

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

## iCloud 與覆蓋匯入

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

這種流程對高影響範圍的還原更安全，因為雲端副本仍可作為回復參考。

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

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

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

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

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

## 系統日曆同步

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