用途：在 macOS 上快速搜索 Apple Mail.app 邮件，绕过 Big Sur 之后失效的 Spotlight/mdfind，直接查询 Envelope Index SQLite 数据库，约 50ms 返回结果（对比 AppleScript 遍历 13 万封邮件需 8 分钟以上）。
主要能力：按主题、发件人邮箱、发件人显示名、收件人、未读、含附件、附件类型、最近天数、日期区间搜索，并可按 ID 打开邮件及查看数据库统计。
安装：将 mail-search 复制到 PATH 并赋可执行权限： cp mail-search /usr/local/bin/ chmod +x /usr/local/bin/mail-search
用法示例：mail-search subject "invoice"；mail-search sender "@amazon.com"；mail-search from-name "John"；mail-search to "recipient@example.com"；mail-search unread；mail-search attachments；mail-search attachment-type pdf；mail-search recent 7；mail-search date-range 2025-01-01 2025-01-31；mail-search open 12345；mail-search stats。
选项：-n/--limit N（默认 20）、-j/--json、-c/--csv、-q/--quiet、--db PATH。
技术细节：数据库位于 ~/Library/Mail/V{9,10,11}/MailData/Envelope Index，主要表为 messages、subjects、addresses、recipients、attachments。高级用户可用 sqlite3 直接执行自定义 SQL 查询。
限制：只读，不能撰写或发送邮件；仅检索元数据，正文存于 .emlx 文件；仅支持 Mail.app，不支持 Outlook 等。许可为 MIT。