核心功能
email-to-calendar 是一款专为 Gmail 用户设计的智能日程管理工具，能够自动扫描邮件内容、提取事件信息并同步至 Google Calendar。该 Skill 支持两种工作模式：直接收件箱监控（扫描所有邮件中的日期、时间关键词）和转发邮件处理（专门处理用户转发至专用地址的邮件）。核心能力包括智能事件提取（自动识别多日期、重复事件、RSVP/购票截止日期）、双重重复检测机制（本地索引 + 语义匹配）、完善的撤销支持（24小时内可撤销变更）以及静默活动日志记录。
显著优点
- 智能提取能力：不仅能识别标准日期时间格式，还能处理日期范围（如"Feb 2-6"）、重复模式，并自动扫描邮件中的注册链接、票务网站 URL
- 双模式灵活适配：既可直接监控整个收件箱，也可通过转发机制精准处理特定邮件，满足不同隐私和效率需求
- 完善的防重复机制：通过
processed_emails索引、事件追踪系统（lookup_event.sh）和 LLM 语义匹配三层防护，有效避免重复创建 - Action-required 智能提醒：对 RSVP、购票、注册等有截止日期的任务，自动创建主事件 + 截止日期提醒事件双重保障，并支持邮件通知
- 运维友好：154个单元测试、详细的日志记录、pending invites 跟踪系统、自动邮件归档（read/archive）
潜在局限
- 依赖外部 CLI 工具：核心功能依赖
gogCLI（作者自维护的 Gmail/Calendar 客户端），若该工具更新或不可用会影响 Skill 功能 - T3 来源可信度：作者 tonimelisma 为个人开发者，虽代码质量良好但非知名组织背书
- 本地时区假设：所有时间处理默认使用本地时区，跨时区场景需用户自行确认
- Gmail 生态锁定：目前仅支持 Google 生态，其他邮件/日历服务商需等待 "provider abstraction" 未来扩展
- subprocess 调用风险：虽经参数转义处理，但仍依赖外部命令执行，超时限制120秒
适合人群
- 日程繁重的专业人士：需要快速将会议邀请、活动通知、报名截止等邮件转化为日历事件
- Gmail + Google Calendar 深度用户：已在 Google 生态中管理邮件和日程
- 追求效率的自动化爱好者：愿意配置 ignore/auto-create 规则实现智能工作流
- 需要 deadline 管理的学生/活动组织者：对 RSVP、早鸟票、报名截止等时间敏感
常规风险
| 风险项 | 等级 | 说明 |
|--------|------|------|
| 数据访问 | 中 | 需读取邮件内容、创建日历事件，但**数据完全本地存储**，无第三方服务器上传 |
| 命令执行 | 低 | 使用 subprocess 调用 gog CLI，参数经数组传递防注入，120秒超时保护 |
| 依赖链 | 极低 | 零第三方 Python 包，纯标准库实现 |
| 来源可信度 | 中 | T3 个人开发者，建议用户审查源码 |
关键使用原则：必须使用 create_event.sh 等包装脚本，严禁直接调用 `gog` 命令，否则会导致重复事件和追踪失效。