Mail

📬 极速邮件自动化 · 安全发送守护

自动化邮件操作工具,支持 macOS Apple Mail 原生 SQLite 查询与跨平台 IMAP/SMTP 协议,提供高性能邮件检索与安全发送能力。

收藏
10.8k
安装
2.9k
版本
1.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Mail 技能综合评估

核心用法

Mail 技能是一套双模式邮件自动化方案,针对 macOS 和跨平台环境分别优化:

macOS 原生模式:直接读取 Apple Mail 的 SQLite 数据库(~/Library/Mail/V*/MailData/Envelope Index),通过 SQL 查询实现 100 倍于 AppleScript 的性能。支持消息检索、发件人关联查询、附件检测等操作。关键步骤包括强制同步(osascript -e 'tell app "Mail" to check for new mail')以避免读取陈旧数据。

跨平台模式:基于 himalaya CLI 实现完整 IMAP/SMTP 协议栈,支持 envelope 列表、邮件移动、实时监听等功能。强制使用 --output json 确保程序化解析可靠性。

显著优点

1. 性能极致:SQLite 直连模式避免 AppleScript 开销,适合高频批量操作
2. 协议完整:himalaya 提供 RFC 2822 标准支持,含完整线程头部处理

3. 安全设计:强制草稿-审核-发送工作流,要求用户显式确认后再执行发送

4. 凭证管理规范:原生支持 macOS Keychain,明确区分 Gmail App Password 与普通密码

潜在局限

  • 平台互斥限制:同一任务禁止混用两种模式,需预先承诺选择
  • 状态同步依赖:SQLite 模式必须手动触发邮件检查,否则数据滞后
  • OAuth 配置复杂:需额外配置 token_cmdconfig.toml
  • SMTP 兼容性:部分服务器对 From 头部与认证用户一致性要求严格

适合人群

  • 需要批量处理本地邮件归档的高级 macOS 用户
  • 追求自动化工作流但不愿牺牲安全确认的开发者
  • 跨平台运维人员(Linux/Windows + macOS 混合环境)

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 误发送 | 自动化脚本直接发送邮件 | 强制草稿审核流程 |
| 凭证泄露 | 脚本硬编码密码 | 强制使用 Keychain / App Password |
| 线程断裂 | In-Reply-To 头部缺失 | 技能内置头部模板 |
| 数据不一致 | SQLite 未同步即查询 | 文档强制前置同步命令 |

技术可信度

文档作者显然具备邮件协议深度知识(RFC 2822、XOAUTH2、IMAP 状态机),且对 Apple Mail 内部实现(SQLite 结构、V* 版本目录)有逆向工程级理解。模式隔离("Never mix approaches")和显式确认机制体现生产环境防御性编程思维。

安全解读

核心用法

本 Skill 提供两套邮件操作方案,严禁混用以避免状态冲突:

macOS 极速方案:直接查询 Apple Mail 的 SQLite 数据库(~/Library/Mail/V*/MailData/Envelope Index),比 AppleScript 快 100 倍。关键操作包括:强制同步后查询 messages/addresses/mailboxes 三表、7 天内邮件过滤、附件检测。需先用 osascript 触发 check for new mail 避免读取旧数据。

跨平台标准方案:使用 Rust 编写的 himalaya CLI 处理完整 IMAP/SMTP 协议。核心命令包括:himalaya envelope list -o json 获取邮件列表(注意用 envelopemessage)、大小写敏感的文件夹操作、message send 读取 RFC 2822 格式内容。

发送协议:强制采用「起草→展示→确认」三步 workflow,必须包含 In-Reply-ToReferences 头信息维持线程,SMTP 发送需确保 From 头与认证用户一致。

显著优点

  • 性能极致:SQLite 直连绕过 Mail.app 渲染层,大数据量查询优势显著
  • 协议完整:himalaya 支持 XOAUTH2、App Password 等现代认证,覆盖 Gmail/Google Workspace 企业场景
  • 零供应链风险:纯 Markdown 文档,无代码、无依赖、无网络行为
  • 线程安全:明确区分 envelope(元数据)与 message(完整内容)概念,API 设计清晰

潜在局限

  • 平台锁定:SQLite 方案仅限 macOS,且随系统升级可能面临数据库结构变更风险
  • 凭证复杂度:Gmail 强制 2FA+App Password,企业 OAuth 需额外配置 token_cmd
  • 实时性缺失:himalaya 无内置长连接,需 15-30 分钟轮询或依赖实验性 watch 功能
  • 无错误恢复:文档未涵盖网络中断、SMTP 拒绝、SQLite 锁冲突等异常处理

适合人群

  • 开发者/运维工程师:需要批量处理邮件、构建自动化工作流
  • macOS 高级用户:追求本地邮件数据透明可控
  • 隐私敏感场景:避免使用云端邮件客户端 API

常规风险

  • 凭证泄露:命令行历史可能残留密码,建议优先使用 macOS Keychain 或环境变量
  • 数据误操作:直接操作 SQLite 无撤销机制,DELETE/UPDATE 风险极高(文档未涉及写入操作但需警惕)
  • 线程断裂:手动构造邮件头时 In-Reply-To 格式错误会导致对话分裂
  • IMAP 限流:高频 envelope list 可能触发 Gmail 429 限制

Mail 内容

手动下载zip · 1.5 kB
SKILL.mdtext/markdown
请选择文件