Mail

✉️ 极速查询 · 安全发送 · 智能线程

专业邮件管理工具,支持 Apple Mail SQLite 高速查询与 himalaya CLI 跨平台操作,含安全协议与线程智能处理

收藏
6.2k
安装
2.9k
版本
1.0.0
CLS 安全性认证2026-07-11
点击查看完整报告 >

使用说明

核心用法

本技能提供两套互补的邮件操作方案:

macOS 原生加速方案:直接读取 Apple Mail 的 SQLite 数据库(~/Library/Mail/V*/MailData/Envelope Index),速度比 AppleScript 快 100 倍。支持查询邮件主题、发件人、接收时间、附件状态等元数据,需先执行 osascript 强制同步避免读取陈旧数据。

跨平台标准方案:基于 himalaya CLI 实现完整 IMAP/SMTP 操作。关键命令包括 himalaya envelope list -o json 获取邮件列表、himalaya message move 管理文件夹、himalaya message send 发送邮件(从 stdin 读取 RFC 2822 格式)。

发送工作流强制采用「草稿-审核-确认」三步机制:完整展示邮件内容,待用户明确批准后方可发送。回复邮件时必须包含 In-Reply-ToReferences 头信息以确保线程完整性。

显著优点

  • 性能极致:SQLite 直连绕过 AppleScript 开销,大数据量查询效率提升百倍
  • 跨平台统一:himalaya 用 Rust 编写,单一工具覆盖 macOS/Linux/Windows
  • 结构化输出--output json 标志确保程序化解析可靠性
  • 安全合规:强制草稿审核流程、App Password 要求、OAuth 令牌支持
  • 线程智能:基于邮件头链而非主题匹配,避免 "Re:" 歧义

潜在缺点与局限

  • 平台互斥:同一任务中不可混用 SQLite 与 himalaya 方案,需预先选定
  • macOS 数据新鲜度依赖:SQLite 读取前必须手动触发同步,否则可能拿到旧数据
  • SMTP 兼容性:部分服务器拒绝 From 头与认证用户不匹配的邮件
  • 文件夹大小写敏感:himalaya 中文件夹名称区分大小写,易因拼写错误操作失败
  • 实时性限制:默认轮询间隔 15-30 分钟,实时推送依赖 himalaya envelope watch 可用性

适合人群

  • 需批量处理或自动化邮件工作流的高级用户
  • 追求 Apple Mail 查询性能的 macOS 开发者/分析师
  • 跨平台团队需要统一邮件工具栈的场景
  • 对邮件线程完整性和发送安全有严格要求的用户

常规风险

| 风险类型 | 说明 |
|---------|------|
| 数据一致性 | SQLite 未同步时读取导致决策基于过期信息 |
| 认证失败 | 未使用 Gmail App Password 或 OAuth 配置错误 |
| 线程断裂 | 遗漏 In-Reply-To/References 头导致对话孤立 |
| 误操作文件夹 | 大小写拼写错误导致邮件移至错误位置 |
| SMTP 被拒 | From 头与认证身份不匹配触发服务器拒绝 |

安全解读

核心用法

该Skill是一份邮件操作最佳实践文档,聚焦于两大技术路径:

macOS Apple Mail 高速查询:直接访问SQLite数据库(~/Library/Mail/V*/MailData/Envelope Index),比AppleScript快100倍。支持messages/addresses/mailboxes表关联查询,可筛选最近7天邮件、检测附件,但必须先执行osascript强制同步以避免读取陈旧数据。

跨平台himalaya CLI:Rust编写的IMAP/SMTP客户端,支持JSON输出便于程序化解析。核心操作包括envelope list(非message list)、文件夹大小写敏感移动、RFC 2822标准发送,以及folder watch实时监听。

发送协议:强制采用"草稿→用户确认→发送"工作流,回复需携带In-Reply-ToReferences头保持线程完整。SMTP发送时需注意From头与认证用户匹配。

凭据管理:macOS Keychain存储、Gmail App Password(需2FA)、himalaya支持XOAUTH2三种方案。

---

显著优点

1. 性能极致:SQLite直接查询 bypass AppleScript 性能瓶颈,适合大批量邮件处理
2. 跨平台统一:himalaya提供一致的CLI体验,替代平台专属方案

3. 安全设计:强制用户确认发送、Keychain凭据隔离、OAuth支持现代认证

4. 线程智能:基于Message-ID链而非主题匹配,可靠性高

---

潜在局限

  • 无实际可执行代码:仅为参考文档,用户需自行实现封装
  • macOS专属优化:SQLite方案无法跨平台,Windows/Linux用户只能依赖himalaya
  • himalaya成熟度:作为相对年轻的Rust项目,长期维护稳定性待观察
  • Apple Mail隐私风险:直接读取私有数据库可能受macOS权限限制,未来系统更新可能中断

---

适合人群

| 场景 | 推荐方案 |
|------|---------|
| macOS开发者/自动化脚本作者 | Apple Mail SQLite |
| 跨平台DevOps/运维工程师 | himalaya CLI |
| 需要实时邮件监听 | himalaya watch模式 |
| 企业合规环境(需审计日志) | 需额外封装,本文档仅基础 |

---

常规风险

  • 命令误执行风险:文档示例可能被直接复制粘贴,缺乏输入验证
  • 数据库锁定:Apple Mail运行时SQLite可能被锁定,需处理并发
  • 凭据泄露:App Password若硬编码于脚本则存在泄露风险(文档已建议使用Keychain)
  • 线程断裂:手动构造头字段错误导致邮件脱离原线程

Mail 内容

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