Mail

核心用法

本 skill 提供两套并行的邮件操作方案，根据平台智能路由：

• macOS 方案：直接查询 Apple Mail 的 SQLite 数据库（~/Library/Mail/V*/MailData/Envelope Index），相比 AppleScript 提速 100 倍，支持 messages/addresses/mailboxes 表关联查询、近期邮件过滤、附件检测等精细操作。
• 跨平台方案：使用 Rust 编写的 himalaya CLI 工具，完整支持 IMAP/SMTP 协议，通过 --output json 实现程序化解析，涵盖邮件列表、文件夹管理、发送、移动等全功能。

关键强制规范：单次任务必须锁定一种方案，禁止混用以避免状态冲突；macOS 查询前需强制触发邮件同步，否则读取陈旧数据。

显著优点

1. 极致性能：SQLite 直连绕过 AppleScript 的 IPC 开销，适合批量处理、自动化分析等高频场景。
2. 跨平台一致性：himalaya 单二进制覆盖 Linux/macOS/Windows，配置即迁移。
3. 安全设计：强制 App Password 机制（Gmail）、OAuth XOAUTH2 支持、macOS Keychain 集成，拒绝明文存储凭证。
4. 线程完整性：严格遵循 RFC 2822 的 In-Reply-To/References 头部链，避免"Re:"前缀导致的线程断裂。

潜在缺点与局限性

• 平台耦合风险：SQLite 方案深度依赖 Apple Mail 内部存储结构，macOS 升级可能破坏路径稳定性。
• 实时性缺口：SQLite 读取本地缓存，需显式触发同步；himalaya 默认轮询 15-30 分钟，非真实时。
• SMTP 兼容性：部分服务器强制校验 From 头与认证用户匹配，需人工调整信封地址。
• 学习曲线：himalaya 配置需理解 TOML 格式、IMAP 文件夹大小写敏感性等细节。

适合人群

• 需要批量处理或自动化分析邮件的高级 macOS 用户
• 跨平台开发者/运维人员寻求统一的邮件 CLI 工具
• 对凭证安全有硬性要求的企业环境

常规风险

• 数据陈旧：未执行 check for new mail 即查询 SQLite 导致决策依据过期。
• 线程断裂：回复时遗漏标准头部，破坏邮件链完整性。
• 凭证泄露：误用常规 Gmail 密码而非 App Password 触发账户锁定。
• 文件夹误操作：himalaya 文件夹名大小写敏感，批量移动可能错位归档。

核心用法

本 Skill 为纯文档型最佳实践指南，提供两套邮件操作方案：

macOS 原生方案：直接查询 Apple Mail SQLite 数据库（~/Library/Mail/V*/MailData/Envelope\ Index），速度比 AppleScript 快 100 倍。需先强制同步（osascript -e 'tell app "Mail" to check for new mail'），常用表包括 messages、addresses、mailboxes，支持邮件按时间筛选（7天内）和发件人 JOIN 查询。

跨平台方案：使用 himalaya CLI 进行完整 IMAP/SMTP 操作。关键命令包括 himalaya envelope list -o json（必须用 envelope 而非 message）、himalaya message move <id> <folder>（文件夹名大小写敏感）。支持 RFC 2822 格式邮件发送和实时监听（himalaya envelope watch）。

凭证管理：macOS Keychain 存储、Gmail App Password（需开启 2FA）、OAuth2 XOAUTH2 三种方式。

线程智能：通过 In-Reply-To 和 References 头追踪线程，而非不可靠的 "Re:" 主题匹配。

显著优点

1. 性能极致：SQLite 直连 bypass AppleScript 开销，批量查询效率质变
2. 双轨设计：平台原生与跨平台方案互不干扰，避免状态冲突
3. 工程化细节：强制同步提醒、JSON 输出规范、大小写敏感警告等踩坑经验凝练
4. 安全建议内置：App Password、OAuth、Keychain 等凭证最佳实践

潜在局限

1. 纯文档限制：无封装函数，需用户自行拼装命令
2. macOS 版本锁定：SQLite 路径含 V* 通配，不同 Mail 版本可能结构变化
3. himalaya 生态成熟度：Rust 工具链，社区规模与稳定性不及传统 MUA
4. 无错误处理示例：未提供常见失败场景（如 SMTP 认证拒绝）的排查流程

适合人群

• 开发者/运维人员需要自动化邮件处理（报表生成、监控告警归档）
• macOS 高级用户希望突破 AppleScript 性能瓶颈
• 跨平台邮件工作流搭建者（Linux 服务器 + 本地 Mac）

常规风险

• 凭证泄露风险：Skill 建议存储密码至 Keychain，但用户可能误用明文
• 数据一致性：SQLite 直接读取绕过 Mail app 状态机，极端情况下可能读到半同步数据
• SMTP 封禁：Google/Microsoft 对自动化发送有速率限制，频繁操作可能触发安全锁定
• IMAP 并发：himalaya 与本地 Mail app 同时连接可能触发服务器并发限制