谷歌日历同步冲突解决器

要解决的问题

多人协作排期时，日历往往是分散的：个人 Google 日历、团队共享日历、外部合作方的日程之间缺少实时一致性。只看某一个日历，无法确认某个时段在其他日历上是否已被占用。逐个手动核对既枯燥又容易漏掉冲突，尤其当一个人同时维护多个日历时，跨日历重复预约几乎是必然发生的事。

核心能力与工作流程

这个技能基于 Google Calendar API v3 与 OAuth 2.0 实现双向同步，工作方式可拆成三个环节：

• 双向同步：OAuth 2.0 授权后，源日历与目标日历两侧的日程变更都会互相写入，而不是单方向的镜像复制。
• 冲突检测：写入之前先查询相关日历的占用情况，找出时间段重叠的日程，而不是事后才发现冲突。
• 空闲时间建议：通过 FreeBusy API 查询多个日历的忙闲状态，在候选时间窗口中选出对所有人干扰最小的时段并给出建议。

典型流程是：授权后指定源日历与目标日历 → 拉取两侧现有日程 → 比对时间段找出重叠项 → 标记冲突 → 用 FreeBusy 查询可替代时段并输出建议。

适用边界与注意点

• 需自备 Google 账号、Google Cloud 项目，在项目中启用 Google Calendar API 并生成 OAuth 2.0 凭据；凭据作用域决定能访问哪些日历，建议只授权必要的最小范围。
• 运行环境需要 Node.js 与 Python。
• 冲突检测针对的是时间段重叠这一情形，不涉及日程内容的语义级去重：同一时间下的「项目评审」和「团队周会」仍会被视为两条独立日程。
• FreeBusy 查询只返回忙闲状态，不含日程详情；要解释"为什么这个时间不合适"，还需额外读取事件内容。
• 时区与时间处理遵循 Google Calendar 自身规则，跨时区会议需额外留意夏令时等边界情况。