Apple Mail Search Safe (fruitmail)

📧 Apple Mail 极速全文搜索

极速 SQLite 搜索 Apple Mail 本地邮件,支持全文检索、元数据过滤和邮件正文读取,比 AppleScript 快 10000 倍,只读模式保障数据安全。

收藏
15.9k
安装
4.3k
版本
5.0.3
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

Fruitmail 是一款专为 macOS Apple Mail 设计的命令行搜索工具,通过直接读取 ~/Library/Mail/V*/MailData/Envelope Index SQLite 数据库实现毫秒级邮件检索。

主要功能:

  • 复杂搜索:支持按主题、发件人、时间范围、未读状态等多维度过滤
  • 正文读取:通过 AppleScript 提取完整邮件内容,支持 JSON 输出
  • 快捷操作:一键在 Mail.app 中打开指定邮件,或复制数据库至安全位置后查询

性能对比: 处理 13 万封邮件时,传统 AppleScript 全遍历需 8 分钟以上,Fruitmail SQLite 方案仅需约 50 毫秒,性能提升超过 10000 倍。

显著优点

1. 极致速度:绕过 Mail.app 的 AppleScript 接口,直接查询本地数据库索引
2. 精准过滤:支持正则风格的发件人匹配(如 @amazon.com)、日期范围、未读标记等

3. 安全设计:默认只读模式,可选 --copy 参数先复制数据库再查询,彻底杜绝误写风险

4. 结构化输出--json 参数便于与 jq 等工具链集成,适合自动化工作流

潜在缺点与局限性

  • 平台锁定:仅限 macOS,且依赖 Apple Mail 的本地数据库结构,随系统升级可能需适配
  • 功能边界:仅支持搜索/读取,无法发送邮件(需配合 himalaya 等 SMTP 工具)
  • 权限依赖:需访问 ~/Library/Mail 目录,可能触发 macOS 隐私权限弹窗
  • AppleScript 依赖:读取正文时仍依赖 AppleScript,部分企业环境可能受限

适合人群

  • 每日处理大量邮件的 macOS 高级用户
  • 需要将邮件数据集成到自动化脚本(如记账、归档、监控)的开发者
  • 对 Apple Mail 原生搜索性能不满,寻求命令行替代方案的技术从业者

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据损坏 | 工具设计为只读,但直接操作数据库理论存在风险 | 使用 `--copy` 模式,或定期备份 `Envelope Index` |
| 隐私泄露 | 邮件内容可能包含敏感信息 | JSON 输出时注意管道安全,避免日志残留 |
| 系统升级 | macOS 大版本更新可能改变 Mail 数据库结构 | 关注 GitHub 仓库更新,社区驱动适配 |
| 权限问题 | 首次运行可能因沙盒机制被阻止 | 在「系统设置」→「隐私与安全性」中授予文件访问权限 |

Apple Mail Search Safe (fruitmail) 内容

暂无文件树

手动下载zip · 1.5 kB
contentapplication/octet-stream
请选择文件