# 邮件

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

## 连接

在 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>` 把邮件写进在「命令行」卡片上授权的文件夹，不影响卡片自己的同步。参见[命令行](https://exporter.dev/docs/cli)。

## 问题与排查

- 选择页面上没有邮件：在面板里选择 `~/Library/Mail` 本身，而不是它里面的文件夹。先「断开连接」再「连接」，面板就会再次出现
- 少了一个账户：没有邮件可写的账户（比如一个空的发件箱）不会列出
- 文件里写着正文未下载：邮件只有邮件头。在邮件里打开这封邮件一次，下次同步就会写入正文

## Related

- [邮件](https://exporter.dev/zh-hans/mail): 每封邮件一个 Markdown 文件
- [信息](https://exporter.dev/zh-hans/docs/messages): 对话、媒体、字段和问题修复
- [MCP 服务器](https://exporter.dev/zh-hans/docs/mcp): 连接 Claude 和其他智能体

---

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