macOS Calendar Assistant 是一个专为 macOS 设计的自动化日历管理工具，旨在将即时通讯工具（如 Telegram、Discord、飞书、iMessage 和 Slack）中的日程信息无缝同步到系统日历中。它通过一系列可靠的脚本操作 Calendar.app，实现从聊天截图中提取日程意图、智能解析时间窗口、检测冲突并幂等写入事件等功能。该工具特别适合那些在日常沟通中频繁提及会议、活动安排的用户，能够将原本零散在聊天中的日程信息自动整理并录入系统，减少手动操作的繁琐。其核心设计理念是‘幂等性’，即多次执行同一操作不会产生重复事件，确保日历数据的整洁与准确。
核心功能特点
- 支持从聊天截图中提取标题、起止时间、时区、日历分类、地点和备注等完整事件信息
- 提供幂等同步机制，使用 upsert_event.py 可创建、更新或跳过重复事件，避免数据冗余
- 内置智能日历路由规则，根据关键词自动分配事件到 Training/Work/Product/Life 等预设日历
- 具备冲突检测功能，在执行写入前检查时间重叠，并提供 override 策略处理显式覆盖需求
- 支持设置提醒闹钟，可通过事件 UID 精准添加提前 n 分钟的提醒通知
适用场景
该工具最适用于高度依赖即时通讯进行日程协调的工作流环境。例如，在远程团队或跨部门协作中，成员经常在 Slack 或飞书中快速敲定会议时间，此时通过截屏识别并结合本工具可实现‘所见即所得’的日程录入。对于健身爱好者而言，若在 Telegram 群组中约定训练计划，工具能自动将其归类至 Training 日历而非混杂在其他事务中。此外，当用户需要在多个日历间灵活调度时——比如将原定于工作日的可选课程调整至周末——upsert 模式允许安全地移动非关键事件而不影响优先级高的 P0 任务。日常维护场景下，calendar_clean.py 脚本可扫描指定周期内的重复项并生成清理方案，配合 –apply 参数一键归档或删除冗余条目，保持日历清爽高效。