核心用法
Apple Mail (macOS) 是一款面向 macOS 用户的本地命令行邮件管理工具，通过调用 AppleScript (osascript)、Shortcuts 自动化或 SQLite3 只读查询，直接操控 Mail.app 中已配置的各类邮箱账户（Gmail、Outlook、iCloud、Yahoo、Fastmail、Proton Bridge 等）。核心能力覆盖：
- 读取与搜索：邮件列表检索、关键词搜索、发件人/日期筛选
- 邮件处理：草稿创建、回复、转发、移动、归档、删除
- 批量操作：支持线程级批量归档/删除，附带干运行预览
- 安全管控：发送、删除、批量操作均需显式确认，高风险操作双重确认
显著优点
1. 零 API 依赖：完全基于本地 Mail.app 数据层，无需管理 OAuth 令牌或第三方 API 密钥，规避云服务商 API 限制与隐私政策变更风险
2. 多账户统一：天然支持多提供商账户的本地统一视图，跨账户操作无需切换上下文
3. 确定性命令路径：预定义 osascript → shortcuts → sqlite3 的探测优先级，失败时精确报告阻断点而非静默降级
4. 操作可审计：每项写操作生成唯一 Operation ID，本地记录操作日志与回滚注释，支持幂等性校验
5. 最小暴露原则：默认仅提取任务必需的元数据，禁止未声明的外部端点传输
潜在缺点与局限性
- 平台锁定：仅限 macOS，依赖 Mail.app 账户预配置，Windows/Linux 用户无法使用
- 功能边界：无法替代原生 Mail.app 的富文本编辑、附件预览、邮件签名可视化等 UI 功能
- 同步延迟：依赖 Mail.app 的 IMAP 同步周期，实时性弱于直接调用 Provider API
- 脚本稳定性：AppleScript/Shortcuts 可能受 macOS 版本更新影响，需持续关注兼容性
- 复杂查询受限：SQLite3 只读模式适合索引查找，复杂多条件搜索性能不及专用邮件数据库
适合人群
- 习惯终端工作流的 macOS 高级用户
- 对云 API 持谨慎态度、偏好本地优先架构的隐私敏感型用户
- 需要跨多邮箱账户自动化批量处理（如归档、标签管理）的效率优化者
- 开发/运维人员需要将邮件工作流集成到 Shell 脚本或 CI 流水线
常规风险
| 风险场景 | 缓解机制 |
|---------|---------|
| 误发给错误收件人 | 发送前强制预览收件人列表，外部地址新增时二次确认 |
| 批量删除不可逆 | 干运行预览影响范围 + 显式确认门 |
| 主题匹配误操作 | 强制双字段身份校验（Message ID + 发件人/日期） |
| 操作失败未感知 | 写后强制读回验证，报告最终邮箱状态 |
| 本地数据泄露 | 敏感配置与日志隔离于 `~/apple-mail-macos/`，禁止向外传输 |
该工具在「本地控制」与「安全边界」之间取得平衡，适合作为 Mail.app 的命令行增强层而非替代品。