通过 SQLite 直接查询 Apple Mail 数据库，实现 50ms 级邮件搜索，替代耗时的 AppleScript 方案。
说明：
## 核心用法
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 官方工具，无企业级支持保障
会员专属
