郵件

連接

在 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> 把郵件寫進在「命令列」卡片上授權的資料夾，不影響卡片自己的同步。參見命令列。

問題與排查

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