核心用法
Mail Skill 提供两套互补的邮件操作方案:
macOS 原生模式:直接读取 ~/Library/Mail/ 下的 Apple Mail SQLite 数据库,查询速度比 AppleScript 快 100 倍,适合本地邮件检索与批量分析。使用前需执行 osascript 强制同步以确保数据新鲜度。
跨平台 CLI 模式:基于 Rust 编写的 himalaya 工具,通过 IMAP/SMTP 协议与邮件服务器交互,支持完整的收发、搜索、文件夹管理功能,适用于 Linux 与 macOS 双环境。
发送邮件遵循草稿-审核-发送三步协议:先展示完整邮件内容供用户确认,获得明确许可后才执行投递,杜绝误发风险。
显著优点
- 性能优势:SQLite 直接查询绕过 Apple Mail 应用层,大型邮箱检索效率极高
- 凭证安全:强制使用 Gmail App Password(非主密码),存储于 macOS 系统钥匙串,不接触明文凭证
- 协议合规:完整的
In-Reply-To/References头处理,确保邮件线程正确衔接 - 输出标准化:所有 himalaya 命令强制
--output json,便于结构化解析
潜在局限
- 平台割裂:两种模式不可混用,同一任务需预先选定方案,否则可能产生状态冲突
- 依赖外部工具:需单独安装 himalaya 二进制并手动配置 TOML 文件,上手门槛高于纯脚本方案
- 实时性限制:SQLite 模式依赖手动触发同步,默认轮询间隔建议 15-30 分钟,非真正实时
- OAuth 支持有限:虽支持 XOAUTH2,但需通过
token_cmd外部脚本注入,配置复杂度较高
适合人群
- 需要批量处理本地邮件的 macOS 高级用户
- 追求跨平台一致性的开发者与运维人员
- 对邮件线程完整性有要求的商务沟通场景
常规风险
- 数据陈旧风险:SQLite 读取前未强制同步将导致漏读新邮件
- 凭证泄露风险:config.toml 若权限配置不当可能暴露 IMAP 服务器地址
- SMTP 投递失败:From 头与认证账户不匹配时会被服务器拒信
- 误删防护:Skill 明确禁止无确认删除与自动发送,但用户仍需警惕第三方脚本覆盖行为