获取 Exporter
文档 邮件

邮件

邮件导出是怎么工作的,从连接到排查问题。

连接

在 Exporter 主页上点邮件旁边的「连接」(连接之前,它在「还有 N 个应用」里),然后点「打开邮件文件夹」。面板会在 ~/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 本身,而不是它里面的文件夹。先「断开连接」再「连接」,面板就会再次出现
  • 少了一个账户:没有邮件可写的账户(比如一个空的发件箱)不会列出
  • 文件里写着正文未下载:邮件只有邮件头。在邮件里打开这封邮件一次,下次同步就会写入正文

Exporter

版本 5.2(App Store)

macOS 15 或更高版本

exporter@tinysend.com

© system operator