apple-mail-search

核心用法

Fruitmail 是一款专为 macOS 设计的 Apple Mail 搜索增强工具，通过直接读取本地 SQLite 数据库（~/Library/Mail/V*/MailData/Envelope Index）实现毫秒级邮件检索。用户可通过 fruitmail search 执行复杂条件查询（主题、时间范围、未读状态），使用 fruitmail sender 按发件人筛选，，fruitmail body <id>> 读取完整邮件正文（借助 AppleScript），并支持 --json 格式输出便于管道处理。工具还提供 --copy 安全模式，先复制数据库再查询以彻底避免任何误操作风险。

显著优点

极致性能：相比原生 AppleScript 遍历 13 万封邮件需 8 分钟以上，SQLite 查询仅需约 50 毫秒，性能提升近万倍。只读安全：设计上严格只读，无法修改或删除邮件，从源头杜绝数据损坏风险。灵活输出：支持 JSON 格式与 jq 等工具链集成，方便开发者构建自动化工作流。精准定位：支持邮件 ID 直接跳转 Mail.app 打开，实现「搜索-预览-处理」无缝衔接。透明可控：开源 CLI 工具，所有操作本地完成，无云端传输隐私顾虑。

潜在缺点与局限性

平台锁定：仅支持 macOS 及 Apple Mail.app，Windows/Linux 用户或 Thunderbird/Outlook 用户无法使用。功能单一：纯搜索工具，不支持邮件撰写、发送、移动、标记等管理操作，需配合 himalaya 等 IMAP 工具完成完整工作流。依赖外部包：Skill 本身为文档型，实际功能依赖 npm 全局安装的 apple-mail-search-cli，版本管理和供应链安全需用户自行把控。正文读取瓶颈：邮件正文仍需调用 AppleScript 获取，大量正文导出时性能会下降。无图形界面：纯命令行工具，对非技术用户门槛较高。

适合的目标群体

开发者与运维工程师：习惯终端工作流，需要将邮件搜索集成到脚本或 CI/CD 流程。效率极客：追求极致搜索速度，对 Apple Mail 原生搜索性能不满的重度用户。数据分析师：需要批量导出邮件元数据进行统计或审计。隐私敏感用户：希望邮件数据完全本地处理，拒绝云端索引服务。

使用风险

依赖项风险：npm 包的维护状态、漏洞修复依赖上游社区，建议定期审计。数据库兼容性：Apple Mail 版本升级可能导致数据库结构变化，需关注工具更新。敏感信息暴露：JSON 输出或终端历史可能留存邮件内容，共享环境需注意清理。AppleScript 权限：首次使用需授权终端访问 Mail.app，权限管理不当可能引发误操作。无事务回滚：虽为只读，但 --copy 模式产生的临时副本需手动清理，长期运行可能占用磁盘空间。