毫秒级邮件搜索，告别 AppleScript 龟速

通过 SQLite 直接查询 Apple Mail 数据库，实现 50ms 级邮件搜索，替代耗时的 AppleScript 方案。

基本信息

• 技能名称?Apple Mail Search
• 中文名称?毫秒级邮件搜索，告别 AppleScript 龟速
• 作者?mneves75
• 分类?专业技能
• 版本?1.0.0
• 标签?email, macos, cli, sqlite, automation, productivity

使用方法

使用说明
核心用法
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 直接打开指定邮件。
显著优点
极致性能 ：查询 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 官方工具，无企业级支持保障