智能邮件日程自动同步助手

由 tonimelisma 开发的开源邮件日历同步工具，智能提取邮件事件自动创建 Google Calendar 条目，支持重复检测、截止提醒与24小时撤销，提升日程管理效率。

基本信息

• 技能名称?email-to-calendar
• 中文名称?智能邮件日程自动同步助手
• 作者?tonimelisma
• 分类?专业技能
• 版本?v1.13.1
• 标签?productivity, automation, office, api, operations

使用方法

使用说明
核心用法
email-to-calendar 是一款智能邮件事件提取与日历同步工具，提供两种工作模式： 直接收件箱监控 （扫描所有未读邮件）和 转发邮件处理 （处理发送至专用地址的转发邮件）。用户通过配置 config.json 设定规则后，Skill 自动读取邮件内容、提取事件信息（标题、日期、时间、地点、URL、截止日期等），经用户确认后创建或更新 Google Calendar 事件。
关键操作流程包括：启动活动日志会话 → 检查邮件处理状态 → 应用忽略/自动创建规则 → 提取结构化事件数据 → 三重重复检测（本地跟踪索引 → 语义匹配 → 日历搜索）→ 用户确认创建 → 自动邮件归档。对于含截止日期的活动（如 RSVP、购票），系统会创建主事件+截止提醒双事件，并可触发邮件通知。
显著优点

1. 智能去重机制 ：三层检测（本地索引、语义匹配、日历搜索）有效避免重复创建，支持事件更新而非重复添加。
2. 完善的撤销与追踪 ：24小时内可撤销任何操作，完整的变更日志和活动日志便于审计。
3. 截止日期感知 ：自动识别 RSVP、注册、购票等截止期限，创建独立提醒事件并发送通知邮件。
4. 灵活的配置规则 ：支持忽略模式（跳过新闻通讯等）和自动创建模式（对特定发件人或主题自动处理）。
5. 模块化架构 ：Python 工具模块 + Bash 包装脚本分离职责，154+ 单元测试保障稳定性。
   潜在缺点与局限性
6. 时区处理简化 ：所有时间假设为本地时区，跨时区场景需手动调整。
7. 依赖外部 CLI ：核心功能依赖 gog 命令行工具，若该工具变更或失效将影响 Skill 运行。
8. LLM 提取不确定性 ：邮件内容解析依赖大语言模型，复杂格式或非标准日期表达可能识别错误。
9. 无实时同步 ：基于轮询或手动触发，非真正的实时邮件监听。
10. Google 生态锁定 ：当前仅支持 Google Calendar/Gmail，虽架构预留扩展性但实际迁移成本存在。
    适合的目标群体
    高频邮件用户 ：每日接收大量活动邀请、会议通知的职场人士
    行政助理/运营人员 ：需要统一管理多人日程的团队协调者
    会议密集型岗位 ：销售、项目经理、咨询顾问等
    自动化爱好者 ：希望减少手动复制粘贴日历事件的效率追求者
    Google Workspace 用户 ：深度使用 Gmail 和 Google Calendar 的群体
    使用风险
    数据持久化风险 ：所有事件跟踪、待处理邀请、活动日志存储于本地 JSON 文件，需关注 ~/.openclaw/workspace/memory// 目录的备份与磁盘空间。
    权限依赖风险 ：Skill 依赖 gog CLI 的 OAuth 授权，授权失效或令牌过期需重新配置。
    误创建风险 ：尽管有确认步骤，但自动创建规则配置不当可能导致不需要的事件进入日历。
    版本兼容性 ： gog CLI 或 Google API 变更可能导致脚本失效，需及时更新 Skill 版本。
    productivity automation office api operations