Apple Mail (MacOS) 是一款专为 macOS 用户设计的本地命令行工具，旨在通过终端高效管理 Apple Mail 应用中已配置的邮件账户。该工具无需依赖第三方 API 或 OAuth 授权，直接利用系统内置的自动化能力与本地数据库进行操作，确保数据始终保留在用户设备内。其核心设计原则是将 Apple Mail 视为统一的邮箱层，所有操作均基于 Mail.app 中已同步的 Gmail、Outlook、iCloud、Yahoo、Fastmail 等账户进行，从而避免重复配置并保持账户状态的一致性。 该工具适用于希望在保持 Apple Mail 原生同步机制不变的前提下，通过脚本或自动化流程批量处理邮件的场景。它支持读取、搜索、分类、撰写草稿、发送、移动、归档和删除等常见邮件工作流，尤其适合需要快速响应大量邮件或对效率有较高要求的用户。由于所有操作均在本地执行，并强制要求关键动作（如发送、删除）前进行二次确认，因此既保证了功能的强大性，又最大限度地降低了误操作风险。 工具的运行依赖于 macOS 系统上已启用的 Mail.app 账户访问权限，以及至少一种可用的命令路径：`osascript`、`shortcuts` 或 `sqlite3`（仅用于只读索引查询）。首次使用时需遵循 `setup.md` 完成初始配置，包括定义服务提供商范围、设置命令路径偏好和安全默认值。整个系统的状态、操作日志和安全记录均存储在 `~/apple-mail-macos/` 目录下，便于用户审查与回溯。
核心功能特点
- 无需 API 或 OAuth，直接调用 macOS 系统级自动化接口操作 Apple Mail
- 支持对 Gmail、Outlook、iCloud、Yahoo、Fastmail 等主流邮箱账户的统一管理
- 所有操作以本地文件形式存储于 `~/apple-mail-macos/`，保障隐私与安全
- 强制实施高风险操作确认机制，如发送、删除前必须用户二次确认
- 采用干运行（Dry-Run）模式预览变更内容，防止误删或错发
- 每次写操作生成唯一 ID 并记录日志，支持操作追踪与状态验证
适用场景
对于经常使用 Apple Mail 处理多账户邮件的专业人士而言，这款 CLI 工具能显著提升工作效率。例如，市场营销人员每日需从多个企业邮箱收件并归档客户咨询，可通过脚本自动筛选特定主题关键词的邮件，并将其移动到对应项目文件夹中，而无需手动切换界面。研发工程师若收到大量来自不同团队的测试反馈邮件，也可利用该工具批量标记为已读、归类至统一标签，甚至提取其中的任务项并关联到项目管理工具。 另一个典型应用场景是自动化日常维护任务。比如设定定时脚本每周清理一次“垃圾箱”中的过期邮件，或在节假日自动归档非紧急通知类邮件。由于所有操作均在本地完成且具备完整日志记录，用户可以随时审计执行历史，必要时进行回滚或排查问题。此外，该工具特别适合集成进个人自动化工作流系统，与其他 macOS 自动化技能（如 `macos`、`events`、`schedule`）协同使用，实现从邮件接收、分析到后续行动触发的全链路自动化。