核心用法
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 官方工具，无企业级支持保障