Apple Mail Search Safe (fruitmail)

核心用法

apple-mail-search 是一个针对 macOS Apple Mail.app 的本地邮件搜索 CLI 工具，通过直接查询 Envelope Index SQLite 数据库实现极速检索。支持按主题、发件人、收件人、日期范围、未读状态、附件类型等多维度搜索，并可导出 JSON/CSV 格式。

关键特性：

• 安全只读机制：先复制数据库到临时文件再查询，避免损坏运行中的 Mail.app
• 双模式内容获取：SQLite 查元数据（~50ms/13万封），AppleScript 读正文（适合少量邮件）
• 多格式输出：支持表格、JSON、CSV，便于脚本化处理

显著优点

1. 速度碾压：查询 13 万封邮件仅需 ~50ms，对比纯 AppleScript 的 8+ 分钟，性能提升约 10000 倍
2. 填补系统缺陷：Apple 自 Big Sur 移除 Spotlight emlx 导入器后，此工具成为本地邮件搜索的唯一高效方案
3. 零侵入安全设计：临时副本策略确保不会干扰 Mail.app 正常运行
4. 灵活扩展：支持原始 SQL 查询，满足高级用户需求

潜在缺点与局限性

• 仅支持 Apple Mail.app：无法兼容其他邮件客户端
• 只读限制：仅能搜索/阅读，无法撰写或发送邮件（需配合 himalaya 技能）
• 正文读取瓶颈：AppleScript 读取邮件正文在批量场景下极慢，仅适合单封或少量邮件
• SQLite 元数据局限：正文内容不在数据库中，必须回退到 AppleScript

适合人群

• 需要高频搜索海量本地邮件的 macOS 高级用户
• 依赖 Apple Mail.app 但不满其原生搜索性能的用户
• 需要将邮件数据导出用于自动化工作流的开发者

常规风险

• 数据隐私：工具读取完整邮件元数据，虽为本地处理，但用户需注意脚本权限管理
• AppleScript 依赖：读取正文功能依赖 Mail.app 的 AppleScript 接口，若 Mail.app 无响应可能导致阻塞
• 版本兼容性：数据库路径随 macOS/Mail.app 版本变化（V9/V10/V11），需关注更新

核心用法

Apple Mail Search 是一款专为 macOS 设计的本地邮件搜索 CLI 工具，通过直接查询 Apple Mail.app 的 SQLite 数据库实现极速检索。

主要功能：

• 多维度搜索：支持按主题、发件人邮箱/姓名、收件人、附件类型、日期范围等条件检索
• 邮件状态筛选：可单独列出未读邮件、含附件邮件
• 正文读取：通过 AppleScript 调用 Mail.app 获取完整邮件内容（适合少量邮件）
• 导出功能：支持 JSON、CSV 格式输出，便于二次处理
• 快速打开：可直接在 Mail.app 中定位并打开指定邮件

典型工作流：

# 查找近期银行对账单
mail-search subject "statement" recent 30 -n 50 --json | jq '.[] | {subject, sender, date}'

# 导出未读邮件为 CSV
mail-search unread --csv > unread_emails.csv

显著优点

1. 极致性能：SQLite 直查 13 万封邮件仅需 ~50ms，相比 AppleScript 迭代（8 分钟以上）提升数万倍
2. 安全设计：采用数据库临时复制机制，避免锁定或损坏正在运行的 Mail.app 数据库
3. 纯本地运行：零网络依赖，所有数据仅在本机处理，彻底杜绝隐私外泄
4. 零依赖：仅使用系统内置工具（sqlite3、osascript），无第三方包引入供应链风险
5. 弥补系统缺陷：macOS Big Sur 后 Spotlight 邮件搜索失效，此工具完美替代

潜在缺点与局限性

• 仅支持 Mail.app：无法搜索其他邮件客户端（Thunderbird、Outlook 等）
• 只读限制：仅能搜索和读取，不能发送邮件（需配合 himalaya 等工具）
• 正文读取性能瓶颈：通过 AppleScript 获取正文较慢，不适合批量处理数千封邮件
• macOS 独占：依赖 Apple Mail 数据库结构，无法跨平台使用
• 需本地安装：需通过 symlink 或包管理器安装到系统 PATH

适合人群

• 高频邮件用户：需要快速检索大量历史邮件的商务人士、开发者
• 自动化工作流：需要将邮件数据导出处理的数据分析师、运营人员
• 隐私敏感用户：拒绝云端邮件服务，坚持本地管理的用户
• Spotlight 替代者：因系统升级导致邮件搜索失效的 macOS 用户

常规风险

• 权限要求：需要读取 ~/Library/Mail/ 目录，首次运行可能触发系统权限提示
• 数据库版本差异：Mail.app 数据库结构（V9/V10/V11）可能随系统更新变化
• AppleScript 稳定性：大规模正文读取时可能受 Mail.app 响应速度影响
• 非官方接口：依赖 Apple Mail 内部数据库结构，存在未来兼容性风险（但 MIT 开源可自主维护）

---

认证信息：该工具通过 CLS-Certify v2.1.0 完整扫描，获得 S+ 安全评级（94分），信任等级 T3（个人开发者/社区项目），符合 GDPR 数据最小化原则。