Mail

核心用法

Mail 技能提供两套互补方案：macOS 平台通过直接读取 Apple Mail SQLite 数据库实现毫秒级邮件检索（比 AppleScript 快 100 倍），跨平台场景则使用 Rust 编写的 himalaya CLI 完成完整 IMAP/SMTP 生命周期管理。关键操作包括：

• 查询加速：直接访问 ~/Library/Mail/V*/MailData/Envelope Index，通过 messages/addresses 表 JOIN 获取发件人信息
• 协议合规：发送时必须包含 In-Reply-To 和 References 头字段以维持邮件线程，使用 RFC 2822 格式通过 stdin 提交
• 安全认证：支持 macOS Keychain 凭据存储、Gmail App Password（强制 2FA）及 XOAUTH2 令牌机制

显著优点

1. 性能极致：SQLite 方案绕过 Apple Mail 应用层，查询速度提升两个数量级
2. 零依赖部署：himalaya 单二进制文件，通过 cargo/brew 一键安装
3. 输出结构化：--output json 原生支持程序化解析，避免文本正则脆弱性
4. 线程正确性：基于 In-Reply-To 链而非主题匹配，避免 "Re:" 前缀误判

潜在局限

• 平台互斥：同一任务禁止混用 SQLite 与 himalaya 方案，需预先决策
• 数据新鲜度：SQLite 读取前必须触发 check for new mail 强制同步，否则获取 stale 数据
• SMTP 严格性：部分服务器校验 From 头与认证用户一致性，配置错误即遭拒信
• 实时性瓶颈：轮询间隔限制 15-30 分钟，实时推送依赖 envelope watch 实验性功能

适合人群

• macOS 重度用户需批量处理本地邮件历史
• 自动化工作流开发者需跨平台 IMAP 操作
• 隐私敏感用户倾向本地 SQLite 而非云端 API

常规风险

| 风险点 | 缓解措施 |

|--------|----------|

| SQLite 锁冲突 | 避免邮件应用运行时写入操作 |

| 凭据泄露 | 强制 Keychain/App Password，禁用明文存储 |

| 线程断裂 | 严格校验邮件头字段再发送 |

| 误发邮件 | 遵循 draft-review-send 强制确认流程 |

核心功能

该 Skill 为邮件操作提供双平台优化方案：macOS 端通过直接查询 Apple Mail SQLite 数据库（~/Library/Mail/V*/MailData/Envelope\ Index）实现 100 倍速查；跨平台场景使用 himalaya CLI 完成 IMAP/SMTP 全功能操作。强制要求单任务内采用统一方案，避免状态冲突。

显著优点

性能极致：绕过 AppleScript 直接操作 SQLite，毫秒级查询万封邮件；工程规范：明确区分 envelope list 与 message list 语义，强制 --output json 保证可解析性；安全细节：完整覆盖 Gmail App Password、OAuth XOAUTH2、macOS Keychain 凭证管理；线程正确性：强调 In-Reply-To/References 头而非主题匹配，避免回复断链。

潜在局限

平台割裂：macOS 与跨平台方案互斥，需提前预判环境；外部依赖重：himalaya 需 Rust 工具链或 Homebrew，Apple Mail SQLite 需强制同步（osascript -e 'tell app "Mail" to check for new mail'）否则数据陈旧；无错误处理：文档未提供常见失败场景（如 SMTP 认证拒绝、文件夹大小写敏感错误）的恢复策略；T3 来源：个人开发者维护，无企业级 SLA 保障。

适合人群

熟悉命令行的开发者、需要批量邮件自动化运维的技术团队、追求 Apple Mail 查询效率的 macOS 重度用户。

常规风险

• 凭证泄露：SQLite 路径可能暴露邮件元数据，共享环境需设权限隔离
• SMTP 封禁：From 头与认证用户不匹配时服务器拒发，需严格校验
• IMAP 限流：高频轮询（文档建议 15-30 分钟）可能触发服务商速率限制
• 线程断裂：手动构造头字段时遗漏 References 导致邮件客户端显示异常