- name
- email-schedule
- description
- 从 macOS 邮件应用检索邮件，并根据邮件中的事件信息创建提醒事项。支持按时间范围（今天、昨天到今天、未读）检索邮件，自动提取会议、活动等时间信息，在事件发生前2小时设置提醒。Use when: (1) 用户要求查看指定范围的邮件并创建提醒, (2) 需要从邮件中提取日程并设置提醒, (3) 自动识别邮件中的会议时间并添加到提醒事项。
邮件日程 (Email Schedule)
从 macOS 邮件应用检索邮件，并根据邮件内容自动创建提醒事项。
功能
- 邮件检索 - 从 macOS 邮件应用数据库读取邮件
- 智能识别 - 从邮件主题和内容中提取会议/活动时间
- 自动提醒 - 在事件发生前 2 小时设置提醒事项
支持的时间范围
today- 今天收到的邮件yesterday- 昨天到今天收到的邮件unread- 所有未读邮件all- 最近 50 封邮件
使用流程
当用户要求处理邮件时：
1. 确认检索范围
询问或确认用户要查看的邮件范围：
- "今天的邮件"
- "昨天到今天的邮件"
- "未读邮件"
- "最近邮件"
2. 执行邮件检索
./scripts/fetch_emails.sh <范围>范围参数：today | yesterday | unread | all
3. 创建提醒事项
将邮件 JSON 传递给创建脚本：
./scripts/fetch_emails.sh <范围> | ./scripts/create_reminders.py4. 返回结果
格式：
📧 邮件检索完成
查看邮件数量: X
创建提醒数量: Y
提醒详情:
• [事件名称] - [时间]
• ...时间识别规则
脚本会自动识别以下格式的时间：
2026年3月31日 14:303月31日 下午2点明天 上午10点下周一 14:003/31 14:30
依赖
- macOS 自带邮件应用
- Python 3
- sqlite3
- remindctl (
brew install steipete/tap/remindctl)
手动查询示例
直接在终端查询今日邮件：
# 查询今天的邮件（正确的 SQL）
sqlite3 ~/Library/Mail/V10/MailData/Envelope\ Index \
"SELECT datetime(m.date_received, 'unixepoch', 'localtime') as date,
a.address as sender,
s.subject
FROM messages m
LEFT JOIN addresses a ON m.sender = a.ROWID
LEFT JOIN subjects s ON m.subject = s.ROWID
WHERE date(m.date_received, 'unixepoch') = date('now')
ORDER BY m.date_received DESC"技术说明
时间戳处理
macOS 邮件数据库中的 date_received 和 date_sent 字段存储的是 Unix 时间戳（相对于1970年1月1日的秒数）。
正确的 SQL 查询方式：
-- 正确：直接使用 unixepoch 转换
SELECT datetime(date_received, 'unixepoch', 'localtime') as date
FROM messages
-- 错误：不需要添加偏移量（这是旧版 Mac CFAbsoluteTime 的方式）
-- SELECT datetime(date_received + 978307200, 'unixepoch') -- 会导致日期错误（显示为2057年）限制说明
- 仅支持 macOS 系统自带的邮件应用
- 需要邮件应用数据库位于默认路径：
~/Library/Mail/V10/MailData/Envelope Index - 提醒事项会创建在默认的"提醒事项"列表中
- 仅对识别出未来时间的邮件创建提醒
脚本说明
fetch_emails.sh
查询邮件数据库，关联 subjects、addresses、summaries 表获取实际文本内容，返回 JSON 格式的邮件列表。
create_reminders.py
解析邮件内容，提取时间信息，使用 remindctl CLI 创建提醒事项。