MagicMirror项目日历模块中的重复事件日期偏移问题分析与解决方案

问题背景

在MagicMirror开源智能镜子项目中，用户报告了一个关于日历模块的重要bug：当处理重复性周事件时，系统会将事件日期错误地偏移一天。具体表现为，原本设定在周四17:30的事件，在界面上会显示为周五17:30。这个问题在Raspberry Pi和macOS平台上均能复现，影响版本为2.27.0。

技术分析

经过深入排查，发现问题根源在于calendarfetcherutils.js文件中的RRule处理逻辑。当系统处理带有byweekday规则的重复事件时，会执行一个日期校正算法：

1. 系统会获取当前时区偏移量（以小时为单位）
2. 检查事件时间是否满足特定条件（东/西时区不同条件）
3. 根据条件对日期进行加减一天的操作

在America/Los_Angeles时区下，当事件时间为17:30时，系统错误地满足了"西时区且小时≥(24-时区偏移)"的条件，导致自动为日期增加了一天。

解决方案演进

开发团队经过多次迭代，提出了以下改进方案：

1. 初始修复思路：直接移除日期校正代码，但这会破坏其他测试用例
2. 优化方案：增加时区匹配检查，仅在不同时区间转换时才执行校正
3. 最终方案：重构整个日期处理逻辑，使用本地非时区日期进行RRule.between()计算

最新解决方案(fixcaldates2分支)的关键改进包括：

• 简化日期处理流程
• 移除不必要的时区转换
• 修复过去日期判断逻辑
• 增强调试日志输出

影响范围

该问题主要影响：

• 使用重复性周事件的日历
• 位于西时区（UTC-）的用户
• 下午晚些时候（约17:00后）的事件

用户验证

多位用户验证了修复效果：

• 原始问题中的周四17:30事件现在能正确显示
• 全天事件不再被错误地延长为两天
• 各种边缘情况测试用例均通过验证

技术建议

对于遇到类似问题的开发者，建议：

1. 检查事件原始时区设置
2. 确认系统时区配置
3. 查看调试日志中的日期处理过程
4. 等待即将发布的正式修复版本

该修复预计将包含在MagicMirror的下一个稳定版本中，为用户提供更准确的日历显示功能。