用途：在 macOS 上搜索、读取 Apple Mail 本地存储的邮件并提取附件。工具为 apple-mail.sh，一个 bash 脚本，查询 Apple Mail 的 SQLite envelope 索引并读取磁盘上的 .emlx 文件，全程只读，不会修改邮件数据。
主要能力：search 支持按发件人、收件人、主题、正文、邮箱、日期范围、未读、已标记、含附件等条件过滤，并可限制结果数量（默认 20）；info 显示邮件元数据、收件人、附件和摘要；read 输出原始 RFC822 邮件（头与正文）；attachment 将附件提取到临时目录并打印路径；mailboxes 列出所有邮箱及数量。
使用方式：先设置 TOOL 指向脚本路径，例如 TOOL=~/Development/agent-stuff/skills/apple-mail/apple-mail.sh，然后调用子命令，如 $TOOL search --from "peter@" --subject "dinner" --limit 5、$TOOL info 783660、$TOOL read 783660、$TOOL attachment 783660 "Rechnung.pdf"、$TOOL mailboxes。
输出与限制：search 返回以竖线分隔的表格，列为 id|sender|sender_name|subject|received|status|flagged|mailbox|attachments；消息 ID 是 Apple Mail 内部 ROWID 整数。.partial.emlx 仅含头部（正文未下载），read 会给出警告。附件复制到 /tmp/ 下的临时目录，用完需自行清理。body 搜索查询的是 summaries 表（Apple Mail 纯文本预览），并非完整邮件正文。邮箱 URL 经过百分号编码，例如 %5BGmail%5D 表示 [Gmail]，%20 表示空格。默认排除已删除邮件。
适用场景：需要在本地快速检索、审阅或导出 Apple Mail 邮件与附件的自动化流程。限制：仅限 macOS 与 Apple Mail 本地数据，只读，不提供发送或修改邮件功能。