Obsidian Day Planner插件中Google日历事件同步问题解析

问题现象

在Obsidian Day Planner插件使用过程中，用户反馈当从Google Calendar删除特定事件后，插件界面未能及时同步更新，导致已删除事件仍然显示。类似问题也出现在Outlook日历的周期性事件场景中，当仅删除系列中的单个事件而非整个系列时，插件同样无法正确反映变更。

技术背景

日历同步功能通常依赖于ICS协议或API接口实现数据交换。Obsidian Day Planner作为生产力工具插件，其日历集成模块需要处理以下关键技术点：

1. 增量同步机制 - 通过时间戳或变更标记识别数据变动
2. 事件状态解析 - 正确处理"CANCELLED"等状态标志
3. 缓存策略 - 平衡实时性和性能的本地存储方案
4. 周期性事件处理 - 对RRULE规则和例外项(EXDATE)的解析

根因分析

经过技术验证，问题核心在于：

1. 周期性事件异常处理缺失
   当用户仅删除系列中的单个事件时，日历服务通常通过两种方式记录：

   • 在母事件中添加EXDATE例外日期
   • 生成状态为"CANCELLED"的子事件 当前插件版本未完整实现这两种情况的处理逻辑

2. 缓存更新策略缺陷
   即使用户重新安装插件，问题仍然存在，表明：

   • 可能过度依赖服务端缓存而非本地校验
   • 未正确处理HTTP 304(Not Modified)响应
   • 增量同步时遗漏了删除操作的传播

3. 跨平台兼容性问题
   虽然主流日历客户端能正确显示，但插件：

   • 可能未完整实现RFC5545规范
   • 对Google/Outlook的私有扩展支持不足

解决方案建议

1. 增强事件解析器

   function parseEvent(event: CalendarEvent) {
     if (event.status === 'CANCELLED') return null;
     if (event.recurringEventId && event.originalStartTime) {
       // 处理周期性事件例外
     }
   }
   

2. 改进同步机制

   • 实现双向同步校验
   • 添加强制刷新按钮
   • 采用Webhook替代轮询(如Google Push Notifications)

3. 缓存优化

   graph TD
     A[同步请求] --> B{本地缓存有效?}
     B -->|是| C[校验ETag]
     B -->|否| D[全量同步]
     C --> E{304响应?}
     E -->|是| F[使用缓存]
     E -->|否| G[增量更新]
   

用户临时解决方案

1. 对于简单事件：手动执行插件刷新命令
2. 对于周期性事件：建议暂时删除整个系列后重建
3. 检查日历导出设置，确保包含"已取消事件"选项

版本演进

该问题已在最新提交中通过以下改进解决：

• 完善了事件状态机处理
• 增加了同步有效性验证
• 优化了缓存过期策略

建议用户更新至v0.6.2+版本获取完整修复。对于企业用户，建议先在测试环境验证周期性事件的处理效果。