Apple Mail Search

核心用法

Apple Mail Search 是一款专为 macOS 设计的命令行工具，通过直接读取 Apple Mail 的 SQLite 数据库（~/Library/Mail/V{9-11}/MailData/Envelope Index）实现极速邮件检索。核心命令包括：mail-search subject "关键词" 按主题搜索、mail-search sender "@domain.com" 按发件人筛选、mail-search unread 列出未读邮件、mail-search recent 7 查询最近 7 天邮件，以及 mail-search open <ID> 直接打开指定邮件。

显著优点

• 极致性能：查询 13 万封邮件仅需约 50 毫秒，相比 AppleScript 的 8 分钟以上提升近万倍
• 原生兼容：填补 macOS Big Sur 后 Spotlight emlx 导入器被移除的功能空白
• 多格式输出：支持纯文本、JSON、CSV 三种输出格式，便于脚本集成
• 精准筛选：支持按主题、发件人邮箱/名称、收件人、附件类型、日期范围等多维度检索
• 零依赖：仅需系统自带的 sqlite3，无需额外安装

潜在局限

• 只读访问：无法发送邮件或修改邮件状态（标记已读/删除等）
• 元数据限制：邮件正文存储在独立的 .emlx 文件中，工具仅能检索元数据
• 平台锁定：仅支持 Apple Mail.app，不支持 Outlook、Thunderbird 等第三方客户端
• 数据库路径变动：需适配不同 macOS 版本的 Mail 数据库路径（V9/V10/V11）

适合人群

• 需要频繁检索大量邮件的 macOS 高级用户
• 构建邮件自动化工作流的开发者/DevOps 工程师
• 因 Spotlight 失效而寻求替代方案的专业用户
• 习惯命令行操作、追求效率的技术从业者

常规风险

• 数据安全：工具直接访问 Mail 核心数据库，虽为只读模式，但不当操作可能触发 Mail.app 异常
• 版本兼容性：Apple 可能在未来 macOS 版本中更改数据库结构，导致工具失效
• 隐私暴露：JSON/CSV 导出功能可能将敏感邮件元数据泄露到脚本日志或临时文件
• 无官方背书：系社区开源项目（MIT 许可），非 Apple 官方工具，无企业级支持保障

核心功能与用法

Apple Mail Search 是一个命令行工具，专为 macOS 用户设计，用于极速搜索本地 Apple Mail 邮件数据库。该工具绕过 AppleScript 和 Spotlight，直接查询 Mail.app 内部的 SQLite 数据库（~/Library/Mail/V*/MailData/Envelope Index），实现毫秒级邮件检索。

主要搜索维度：

• mail-search subject "关键词" — 按主题搜索
• mail-search sender "@domain.com" — 按发件人邮箱搜索
• mail-search from-name "姓名" — 按发件人显示名搜索
• mail-search to "邮箱" — 搜索已发送邮件
• mail-search unread — 列出未读邮件
• mail-search attachments / attachment-type pdf — 查找带附件邮件
• mail-search recent 7 / date-range YYYY-MM-DD YYYY-MM-DD — 按日期筛选
• mail-search open <ID> — 用 Mail.app 打开指定邮件
• mail-search stats — 查看数据库统计信息

输出格式： 支持纯文本（默认）、JSON（-j）、CSV（-c），可限制结果数量（-n）。

显著优点

| 特性 | 表现 |

|------|------|

| **速度** | ~50ms 查询 13 万封邮件，相比 AppleScript 的 8+ 分钟提升近万倍 |

| **可靠性** | 绕过 macOS Big Sur 后失效的 Spotlight emlx 索引 |

| **灵活性** | 支持 SQL 级精准查询，可自定义复杂筛选条件 |

| **隐私** | 完全本地执行，零网络传输，不上传任何数据 |

| **轻量** | 仅依赖系统 `sqlite3`，无第三方依赖 |

潜在缺点与局限性

1. 只读限制：无法撰写、发送、修改或删除邮件，仅能查询元数据
2. 正文不可见：邮件正文存储在 .emlx 文件中，本工具不读取内容
3. 平台锁定：仅支持 Apple Mail（Mail.app），不支持 Outlook、Thunderbird 等第三方客户端
4. 数据库版本敏感：需匹配 Mail.app 的数据库版本路径（V9/V10/V11 等）
5. 安装门槛：需自行下载安装 mail-search 二进制工具，Skill 本身仅提供使用说明

适合人群

• 每日处理大量邮件的 macOS 重度用户
• 需要将邮件元数据导出分析（CSV/JSON）的自动化工作流开发者
• 对 Apple Mail 搜索性能不满、追求即时反馈的效率工具爱好者
• 编写邮件归档、统计脚本的系统管理员

常规风险

• 数据库路径变动：macOS 或 Mail.app 更新可能改变 Envelope Index 路径，需手动调整
• 工具来源验证：mail-search 为第三方二进制工具，建议从官方仓库源码编译或校验签名后使用
• 元数据暴露：虽不上传云端，但查询结果可能包含敏感邮件的发件人、主题、时间等信息，需注意本地环境安全
• 无持久化服务：每次查询需重新连接数据库，不适合高并发场景

技术背景

Apple 在 macOS Big Sur 移除了 emlx 文件的 Spotlight 导入器，导致传统邮件搜索方案失效。本工具直接操作 SQLite 数据库中的 messages、subjects、addresses、attachments 等表，通过外键关联实现高效检索。高级用户可直接使用 sqlite3 命令执行自定义 SQL 查询。