全部功能详解

MBOX 导入

将任意标准 .mbox 归档导入 Mailbox Client——无论来自 Google Takeout、Thunderbird、Apple Mail 或其他支持该格式的客户端。

• 一次导入一个或多个 .mbox 文件。
• MIME 解析覆盖 multipart/alternative、multipart/related、multipart/mixed,以及大多数字符集组合(UTF-8、ISO-8859-*、Windows-125* 等)。
• 自动解码 Quoted-printable 与 Base64 传输编码。
• 完整支持 RFC 2047 编码邮件头——包括 Q 与 B 变体。
• Gmail 标签(X-Gmail-Labels)被保留为可过滤的标签。
• 逐步可见的进度界面:准备、复制、解析、保存、重建索引、Spotlight。
• 在 scheme 中设置 MBOX_CHARSET_DEBUG=1 可诊断棘手的编码问题。

资料库

每个导入的文件都会成为一个命名的资料库:可以把它们视作独立的收件箱,各自浏览或过滤。

• 随时通过资料库管理面板重命名资料库。
• 删除资料库会同时移除磁盘上的归档以及所有已解析的邮件。
• 自动发现磁盘和 iCloud 云盘中已存在的资料库。
• 侧边栏过滤器显示每个资料库的邮件数量。

全文搜索

搜索你导入的每一封邮件。主题、发件人、收件人、正文、标签和附件名称都会被索引。

• 本地构建的分词倒排索引——不涉及任何外部服务。
• 可同时按资料库与 Gmail 标签过滤结果。
• 增量更新:每次导入仅对新邮件进行分词。
• 搜索对大小写和变音符号不敏感。

高级搜索

当搜索框不够用时,打开高级过滤面板实现精细控制。

• 按发件人或收件人地址限定。
• 限定日期范围(起始 / 截止)。
• 仅显示含附件的邮件。
• 与侧边栏的资料库 / 标签过滤组合使用。
• 当前激活的过滤会以可清除的标签形式出现在工具栏。

阅读邮件

为每封邮件选择合适的渲染方式——同时避免网页邮箱在隐私上的妥协。

• 每封邮件可在文本与 HTML 之间切换。
• HTML 渲染使用由 macOS 沙盒化的 WKWebView。
• 通过 cid: 引用的内嵌图片可从邮件附件中解析。
• 若希望永远不触发任何对外网络请求,可保持文本视图。
• 发件人头像通过 Gravatar 显示,并提供注重隐私的回退方案。

会话归类

Mailbox Client 仅依靠原始 MIME 邮件头重建会话——无需依赖 Gmail 的专有逻辑。

• 主要策略:Message-ID、In-Reply-To 与 References 链。
• 回退策略:标准化主题(去掉 Re:、Fwd: 及各语言前缀)。
• 列表中每封邮件旁会显示会话数量徽章。
• 跨资料库可用——后导入的回复会自动并入原会话。

附件

每封导入邮件的全部附件,都可在正文旁直接访问。

• 附件列表显示文件名、大小和 MIME 类型。
• 通过标准 macOS 存储面板将单个附件保存到磁盘。
• 在 HTML 视图中自动解析内嵌图片。
• 附件名称会被搜索索引收录。

Apple Intelligence

在搭载 Apple 芯片并运行 macOS 15.4 或更新版本的 Mac 上,Mailbox Client 使用 Foundation Models 框架为设备端 AI 功能提供支持。

• 智能摘要——将冗长邮件浓缩为几句话。
• 情感分析——检测正面、中性或负面语气。
• 回复建议——本地生成三种草稿(正式、随意、简短)。
• 所有推理均为异步,可随时取消。
• 如果你所在地区无法使用 Apple Intelligence,该面板将保持隐藏。

自动分类

Mailbox Client 通过启发式规则与设备端 AI 相结合,将每封邮件归入九大类别之一。

• 类别:工作、个人、财务、购物、出行、社交、订阅、垃圾、其他。
• 启发式规则在导入时即时运行;在支持的 Mac 上,AI 会进一步优化判断。
• 可在详情视图中手动覆盖分类。
• 按类别过滤列表,聚焦于某一类邮件。

Spotlight 集成

无需打开应用,即可在 macOS 的任意位置搜索已导入的邮件。

• 可选启用 Core Spotlight 索引,使用专属域名(com.gmailimporter.messages)。
• 索引内容包括主题、摘要、发件人、收件人、完整正文、标签、附件名称与创建日期。
• 索引以每批 100 封邮件进行,保持界面响应顺畅。
• 可从设置面板重建索引或清除 Spotlight 索引。
• 点击任意 Spotlight 结果,Mailbox Client 会直接打开对应邮件。

iCloud 同步(可选)

如果你在多台 Mac 上使用 Mailbox Client,可启用同步以保持资料库一致。

• 基于 SwiftData + CloudKit 构建——启用后即自动同步。
• 使用你的私有 CloudKit 数据库(iCloud.es.cajigas.Gmail-importer),由 iCloud 加密,仅你的 Apple ID 可读。
• 同步资料库、邮件、附件以及搜索索引。
• 默认关闭。在设置 → iCloud 中启用;重启后生效。
• 实时同步监视器显示上传 / 下载状态。
• 可随时清除 iCloud 中的数据,同时保留本地副本。

导出

数据始终可以带走——Mailbox Client 只是你旅途中的一站,而不是保险柜。

• 导出所选邮件或整个资料库。
• 支持格式:.mbox、.eml 与 .json。
• 来回安全:重新导入导出的 MBOX 可重建相同结构。
• JSON 导出适合脚本处理、归档或迁移到其他工具。

统计

仪表盘视图汇总你的整个归档。

• 按资料库与 Gmail 标签统计邮件数量。
• 按收发量排序的常用发件人。
• 类别分布。
• 所有图表均为本地,在导入过程中实时更新。

语言

界面完整本地化为 11 种语言,并自动跟随你的 macOS 系统语言。

键盘快捷键

尽可能让手不离开键盘——Mailbox Client 遵循 macOS 的标准快捷键。

• ⌘ + F —— 聚焦搜索框。
• ⌘ + I —— 打开导入器。
• ⌘ + , —— 打开设置。
• ⌘ + E —— 导出当前所选。
• ↑ / ↓ —— 在邮件列表中导航。
• 完整列表可在应用内通过帮助 → 键盘快捷键查看。

系统要求