# 郵件

郵件匯出是怎麼運作的，從連接到排查問題。

## 連接

在 Exporter 首頁的郵件旁按「連接」（連接之前，它在「還有 N 個 App」裡），然後按「打開郵件資料夾」。面板會在 `~/Library/Mail` 開啟：選擇這個資料夾本身。然後選擇檔案存放位置，並按「使用這個資料夾」。

Exporter 透過你授權的資料夾，讀取郵件保存在你 Mac 上的郵件。它不索取郵件權限，不要帳號，也不要完整磁碟取用權限。

## 選擇郵件

選擇頁面有兩個標籤，兩邊都勾選的郵件才會同步。

- 類型：郵件自己的標籤。主要、交易、更新、促銷，其餘的歸入「郵件未分類」。更新和促銷預設不勾選
- 帳號：每個帳號以地址列出，裡面是它的信箱。草稿和垃圾桶預設不勾選

已刪除的郵件和垃圾郵件（Spam 與 Junk）無論勾選了什麼都不會同步。列表上方的數字，是兩個標籤共同留下的郵件數。

## 檔案去哪裡

每封郵件一個 Markdown 檔案，以日期、主旨和一個編號命名：`2026-09-28 Your order has shipped 491560.md`。直接位於個人資料夾下的目錄，例如 `~/Documents`，裡面會建立一個 `mail-export` 資料夾；更深的目錄會原樣使用。

卡片上「選項…」裡的「整理」決定資料夾結構：

- 依日期：`2026/09/`，每年每月一個資料夾
- 依帳號：每個帳號一個資料夾，下面再依年份
- 依類型：`primary/`、`transactions/`、`updates/`、`promotions/`、`unsorted/`，下面再依年份

更改「整理」後，下次同步時每個檔案都會移動，舊位置不留任何東西。

## 檔案內容

前置資訊包含 `from`、`to`、`mailbox`、`read`、有旗標時的 `flagged`、`account` 和 `kind`，`source_url` 會在郵件中打開這封郵件。接著主旨成為標題，內文轉成 Markdown：標題、列表、表格和連結。附件留在郵件裡。如果郵件從未下載某封郵件的內文，它的檔案裡會寫明這一點。

## 免費與解鎖

最新的 1,000 封郵件會匯出並持續免費同步。解鎖郵件是一次性購買：解鎖後按「立即同步」，其餘勾選的郵件就會同步。大信箱的首次同步如果中途結束，會從停下的地方繼續。

## 同步

Exporter 執行時會盯著郵件的索引，新郵件會自己變成檔案。「立即同步」手動執行一次；「完全重新同步」把每個檔案重寫一遍。

## 命令列

`exporter sync --source mail` 像卡片上的「立即同步」一樣同步郵件。`exporter export --source mail --dest <folder>` 把郵件寫進在「命令列」卡片上授權的資料夾，不影響卡片自己的同步。參見[命令列](https://exporter.dev/docs/cli)。

## 問題與排查

- 選擇頁面上沒有郵件：在面板裡選擇 `~/Library/Mail` 本身，而不是它裡面的資料夾。先「中斷連接」再「連接」，面板就會再次出現
- 少了一個帳號：沒有郵件可寫的帳號（例如一個空的寄件匣）不會列出
- 檔案裡寫著內文未下載：郵件只有郵件標頭。在郵件裡打開這封郵件一次，下次同步就會寫入內文

## Related

- [郵件](https://exporter.dev/zh-hant/mail): 每封郵件一個 Markdown 檔案
- [訊息](https://exporter.dev/zh-hant/docs/messages): 對話、媒體、欄位和問題排解
- [MCP 伺服器](https://exporter.dev/zh-hant/docs/mcp): 連接 Claude 和其他 AI 代理

---

human version: https://exporter.dev/zh-hant/docs/mail
every page: https://exporter.dev/llms.txt