极速安全搜索本地数万封邮件 - Apple Mail Search Safe (fruitmail)

基于SQLite的Apple Mail极速搜索工具，支持邮件正文读取，查询速度较AppleScript提升千倍，采用只读临时副本确保安全。

基本信息

• 技能名称?Apple Mail Search Safe (fruitmail)
• 中文名称?极速安全搜索本地数万封邮件
• 作者?gumadeiras
• 分类?专业技能
• 版本?2026.1.7
• 标签?email, apple-mail, sqlite, search, macos, cli, productivity, privacy-focused

使用方法

使用说明
核心用法
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），需关注更新