Swanmail

导入、导出与备份 ​

以下功能都位于 设置 › 常规 › 导入与导出，每一项都有对应的 swanmail 命令行工具命令。

导入邮件 ​

导入邮件… 可以读取其他邮件客户端的邮件：

  • mbox 文件——Thunderbird 的文件夹、Google Takeout 导出、Apple Mail 的 .mbox 包（选择包内的 mbox 文件），以及 Unix 邮件工具写出的文件；
  • Maildir（包含 cur/ 和 new/ 的文件夹）或 .eml 文件夹，每个文件是一封邮件。

选择来源、邮件所属的账户以及存放位置：

  • 本地文件夹（默认）。邮件保存在本机、该账户下一个服务器并不知道的文件夹中。 它在侧边栏中显示为硬盘图标，可以像其他文件夹一样搜索、归入会话和添加标签， 任何同步都不会删除或上传它。其中的邮件可以在本地文件夹之间移动，删除即永久删除； 但不能移入服务器文件夹（请以服务器为目标重新导入该文件），同理也不能归档或标记为 垃圾邮件，Swanmail 会提示原因，而不是默默留在原处。本地文件夹可以通过 右键菜单重命名、删除和新建子文件夹。
  • 服务器上的邮箱（IMAP、Fastmail/JMAP、Microsoft 365 和 Exchange 账户）。 每封邮件会上传到所选邮箱，下次同步后显示。Microsoft 365 会把整封上传的邮件 存为草稿，这是 Microsoft Graph 保存整封邮件的方式；它每封邮件最多接受约 3 MB。 POP3 账户只能导入到本地文件夹。

账户中已有相同 Message-ID 的邮件会被跳过，所以同一个导入运行两次——或取消后再次运行—— 只会补上缺少的部分。已读和星标状态取自文件中的记录（Status、X-Mozilla-Status、 Takeout 的 Unread 和 Starred 标签、Maildir 标志）；没有记录的邮件按已读导入。 进度行会显示已读取、已导入、已存在和失败的数量；无法保存的邮件会被计入失败，导入继续进行。

邮件规则不会对导入的邮件运行。

导出邮件 ​

在侧边栏中右键点击文件夹并选择 导出文件夹…，可保存为：

  • mbox 文件——所有邮件存为一个文件，Thunderbird、Apple Mail、mutt 和大多数 邮件工具都能打开，Swanmail 也可以再次导入；
  • .eml 文件——每封邮件一个文件，命名为 0001-主题.eml、0002-…，保存到你选择的文件夹。

导入与导出中的 导出账户… 会把账户的每个文件夹分别写成一个 mbox 文件，保存到你选择的文件夹。

导出的是服务器上保存的原始邮件，包括所有附件。导入的本地文件夹中的邮件从本机读取； 其他邮件会重新从服务器下载，因此大文件夹所需时间与下载相当。无法下载的邮件 （上次同步后已在服务器上删除，或大于 100 MB）会被计入并跳过，导出继续进行。 mbox 采用 mboxrd 格式：每封邮件前有一行包含发件人和日期的 From 行，邮件中以 From （或 >From ）开头的行会多加一个 >，导入时会再去掉。

备份与恢复设置 ​

备份设置… 会保存一个 JSON 文件（swanmail-settings-<日期>.json），其中包含重新配置 Swanmail 所需的内容：

  • 你的偏好设置——主题、语言、阅读和通知选项、键盘快捷键、签名、模板、智能邮箱、 VIP 发件人，以及按发件人设置的远程图片例外；
  • 每个账户重新添加所需的信息——地址、名称、协议、服务器和端口、发件别名、颜色、 文件夹标签及其 AI 智能体；
  • AI 智能体配置、规则、已拦截发件人和标签。

其中不含任何密码、登录令牌或 AI API 密钥，也不含智能体的环境变量，因此可以放心 与其他文件一起保存。顶层文件夹的排序不包含在内：它通过只有本机才认识的编号引用文件夹。

恢复设置… 会打开备份，并在执行前显示其中的内容以及恢复将带来的变化。选择恢复方式：

  • 合并（默认）补上缺少的、更新匹配的——账户按地址、规则/标签/智能体按名称——其余 保持不变。模板、签名和 VIP 发件人会合并而不是覆盖。
  • 替换 让规则、标签、已拦截发件人和智能体与备份完全一致，并直接采用备份中的偏好设置。 它永远不会删除任何账户或邮件。

备份新增的账户不带密码或登录信息，会在侧边栏中像登录已过期的账户一样被标记：选择 重新认证 输入密码（或通过服务商登录）即可开始同步。从备份恢复的智能体需要重新 填写 API 密钥。文件夹标签以及把邮件移入某个文件夹的规则需要等该文件夹存在后才能生效， 因此在账户首次同步后再恢复一次即可补全。