Google日历同步代理

解决什么问题

当一个用户或团队同时使用多个 Google 日历（例如工作日历、项目日历、个人日历）时，手动在日历间复制事件、核对时间、处理重复规则，不仅耗时，还容易出现时区换算错误、重复事件漏同步或冲突未被发现的问题。尤其涉及跨时区的会议、周期性任务或多人协作场景，手动同步的效率和准确性都难以保障。

核心能力与工作方式

该代理通过 Google Calendar API v3 和 OAuth 2.0 完成多账户日历的同步，核心流程包含三个步骤：

1. 授权与连接：基于 OAuth 2.0 获取多个 Google 账户的访问凭证，安全连接对应的日历资源，无需手动导出导入数据。
2. 事件同步逻辑：自动处理三类关键情况——recurring events（重复事件）按规则展开并同步到目标日历；timezone conversions（时区转换）将事件时间从源时区正确换算为目标时区，避免时间错位；conflict resolution（冲突解决）检测同一账户或跨账户的时间重叠事件，减少冲突遗漏。
3. 数据一致性保障：同步过程中遵循日历 API 的规范，确保事件的标题、时间、地点、参与者等字段完整迁移，同时保留重复事件的循环规则。

适用边界与注意点

• 需要预先准备 Google 账户、Google Cloud 项目，并启用 Google Calendar API、生成 OAuth 2.0 凭证，缺少这些前置条件无法运行。
• 运行环境依赖 Node.js 和 Python，需确保本地或服务器已安装这两个运行时。
• 适用于个人或团队的多日历同步需求，但不支持修改 Google 日历 API 本身的规则（例如日历的公开权限、共享设置），如需调整需结合日历自身的配置功能。
• 同步逻辑基于 Calendar API v3 的原生能力，复杂的自定义规则（如按特定关键词过滤事件）需通过额外的代码扩展实现。