极速安全的本地邮件搜索专家

基于 SQLite 的 Apple Mail 本地邮件极速搜索工具，只读模式保障数据安全，支持全文检索与 JSON 输出，专为 macOS 命令行用户打造高效邮件工作流。

基本信息

• 技能名称?apple-mail-search
• 中文名称?极速安全的本地邮件搜索专家
• 作者?mneves75
• 分类?办公
• 版本?v1.0.0
• 标签?productivity, macos, email, cli, data-analytics, automation, docs

使用方法

使用说明
核心用法
Fruitmail 是一款专为 macOS 设计的 Apple Mail 搜索增强工具，通过直接读取本地 SQLite 数据库（ ~/Library/Mail/V*/MailData/Envelope Index ）实现毫秒级邮件检索。用户可通过 fruitmail search 执行复杂条件查询（主题、时间范围、未读状态），使用 fruitmail sender 按发件人筛选，， fruitmail body > 读取完整邮件正文（借助 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 模式产生的临时副本需手动清理，长期运行可能占用磁盘空间。