1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | google-calendar-openai-plugins |
| 项目自述名称 | google-calendar（.codex-plugin/plugin.json 内 name 字段原值；author.name 为 “OpenAI”，即插件由 OpenAI 官方编写并维护） |
| 作者/维护者 | OpenAI 官方团队，托管于官方仓库 openai/plugins |
| 来源链接 | https://github.com/openai/plugins/tree/main/plugins/google-calendar |
| 许可证 | MIT（plugin.json 明确声明） |
| GitHub Stars/Forks | 所属合集仓库（openai/plugins）4,619 / 671（GitHub API 实测 2026-07-16；仓库为 180+ 插件合集，星数不直接归属本插件，独立佐证见第 6 章） |
| 最新版本 | plugin.json 声明 1.2.3；该子目录提交历史 API 实测共 17 次提交，最近一次 2026-06-17，内容为“更新插件图标” |
| 安装方式 | Codex App/CLI/VS Code 扩展的 Connected Apps 中启用 Google Calendar 连接器（见第 10 章） |
2. 功能介绍与亮点
google-calendar-openai-plugins 是 OpenAI 官方为 Codex 编写的日历技能包，捆绑 5 个独立 SKILL.md 技能：
- google-calendar（基础技能）：读取日历状态、把相对时间表达规范化为带时区的精确时间窗、比对多日程冲突，写操作前先展示“当前事件 vs 拟修改内容”的对比
- google-calendar-daily-brief：生成当日日程简报，附带专门的
render_day_brief.py本地渲染脚本 - google-calendar-free-up-time：在指定窗口内寻找可挪动的会议以腾出空闲
- google-calendar-group-scheduler：跨多人比对空闲时段，给出候选会议时间
- google-calendar-meeting-prep：读取事件备注、附件与历史记录，产出会前简报
亮点：SKILL.md 明确写有“Write Safety”（写前安全）章节，要求在创建、更新、改期、取消事件前，先展示确切的时间、时区与差异供确认；对循环事件的“仅本次/整个系列/本次及之后”修改范围也有专门处理逻辑，避免误改整个系列。
3. 适用场景
固定分类：集成与工作流自动化。适合已在 Codex 中连接 Google 账号、需要频繁处理日程安排的初中级用户，尤其是需要跨多人协调会议时间、每天早上想要一份日程简报、或需要在大量事件中快速找到空闲时段与潜在冲突的场景。
4. 跨 Agent 兼容性
- Codex：✅ 原生支持——
.codex-plugin/plugin.json为标准 Codex 插件清单，托管于 OpenAI 官方插件仓库（已抓取核实） - Claude Code：⚠️ 需适配——SKILL.md 的读写逻辑绑定 Codex 专属 Connected App（
.app.json声明的 OAuth 连接器与search_events/update_event等工具函数名），需自行搭建等效的日历 MCP 连接方案后才能复用其中的提示词逻辑 - OpenClaw：❓ 未验证——公开材料未提及
- Hermes Agent：❓ 未验证——公开材料未提及
5. 推荐理由
日程协调是最容易“看着简单、做起来烦”的事：时区换算、循环会议改期范围、多人凑空闲，稍不注意就会算错或改错事件。这个技能由 OpenAI 官方编写、直接嵌入 Codex 的 Connected Apps 生态，把“查日程、比空闲、判冲突、拟修改”整理成一套结构化对话流程，且在真正写入日历前会先展示确切的时间差异供用户确认，而不是静默执行。5 个子技能覆盖日常简报、腾挪时间、多人排期、会前准备等高频场景，对刚开始用 Agent 处理日程的用户尤其友好。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9.0 | OpenAI 官方出品；不采用合集仓库 4,619 星归属单个插件，改以子目录自身提交历史（17 次提交，持续迭代到版本 1.2.3）与 openai/codex 主仓库中两条独立用户提交的真实 Issue（#23995、#27844，均已抓取核实，专门讨论该连接器）作为独立佐证 |
| 可用性 | 8.0 | Connected Apps 一键启用；5 份 SKILL.md 文档详尽、含明确工作流步骤；子目录最近更新 2026-06-17；依赖用户已有 Google 账号，无强制付费 |
| 安全性 | 8.0 | 见下方安全检查清单 |
| 综合 | 8.3 | 三项均值，超过 7.0 达标线，安全性远超一票否决线 |
安全检查清单：
- Shell/权限范围：仅 daily-brief 子技能含一个本地
render_day_brief.py渲染脚本，用于格式化输出，未见联网或系统调用代码 - 联网外发：仅通过官方 Connected App 连接用户自己的 Google Calendar 数据，目标透明且为完成日程读写所必需
- API Key/凭据：无裸 API Key，走 Codex 平台统一管理的 OAuth Connector；但 openai/codex 官方 Issue #23995（2026-05-22，用户 kfallah 提出）指出连接器目前没有真正的只读模式——即便用户只想读日程，连接器仍具备写权限，SKILL.md 里的“写前确认”是提示词层面的约束，并非平台强制的权限边界，属实际存在的风险敞口
- 可疑指令/注入迹象：完整抓取 5 份 SKILL.md 全文核实，未发现要求执行流程外操作的可疑指令，反而显式写有写入前必须展示差异确认的安全设计
- 作者/组织信誉：OpenAI 官方仓库直接维护
- License：MIT，标准开源协议，条款清晰
- 维护时间：该子目录最近提交 2026-06-17，近 3 个月内持续维护；另有 Issue #27844（2026-06-12，用户 chechuset 提出）反映连接器在 MCP 启动阶段偶发失败，尚未见官方修复提交
7. 跟同类 Skills 相比的优势
openai/plugins 合集仓库内的其他官方连接器还包括 gmail（同为 OpenAI 编写，但版本仅 0.1.3，仍处早期迭代阶段）、hubspot（HubSpot 官方编写，面向企业 CRM 场景，受众更偏 B2B）、zoom（Zoom 官方经 zoom/zoom-plugin-codex 分发，偏开发者向的会议 SDK/Webhook 集成而非日常日程管理）。相比之下，google-calendar 定位更贴近“每天都要用”的通用日程场景：
| 产品 | 定位 | 核心差异 |
|---|---|---|
| google-calendar-openai-plugins（本推荐） | 日程查询、冲突排查、多人排期、会前简报 | OpenAI 官方出品，版本最成熟（1.2.3），5 个子技能覆盖高频日常场景，写操作有明确确认机制 |
| gmail-openai-plugins | 收件箱分诊、回复起草 | 同为 OpenAI 官方出品，但版本 0.1.3 仍属早期阶段，子技能数量（2 个）少于日历 |
| hubspot-openai-plugins | CRM 数据分析、管道健康度 | HubSpot 官方出品，面向销售/客服团队，非通用日程场景 |
| zoom-openai-plugins | 会议 SDK、Webhook、机器人开发 | Zoom 官方出品，偏“用 Codex 开发 Zoom 集成”而非日常排期 |
| n8n-workflow-lifecycle-official-n8n-io-skills | 通用工作流自动化编排 | 面向搭建跨应用自动化流程，不专注日历这一垂直场景 |
8. 用户评价
- kfallah，openai/codex 仓库 Issue #23995（2026-05-22，已抓取核实）：认可“chief-of-staff 式自动化”场景下需要读取邮件/日历上下文，但明确指出“目前连接器没有真正的只读模式”，希望官方补上权限粒度控制
- chechuset，openai/codex 仓库 Issue #27844（2026-06-12，已抓取核实，Codex App 版本 26.608.12217）：反映 Gmail/Google Calendar 连接器在 MCP 启动阶段会在真正访问 API 之前先报错失败
以上为官方仓库中可验证的具名 Issue 反馈，而非评测博客式的使用评价；该插件目前在公开评测渠道尚无可访问的一手评价原文。
9. 其他补充
openai/plugins 仓库同时收录 180+ 个插件（gmail、notion、slack、hubspot、zoom 等），覆盖邮件、CRM、会议、项目管理等多类第三方服务，日历只是其中一个垂直场景。安装与连接统一走 Codex 平台的 Connected Apps 体系，无需用户单独申请 Google API Key。
10. 安装使用方式
- Codex CLI/App/VS Code 扩展内打开 Connected Apps（或
/plugins），搜索并启用 “Google Calendar” - 首次触发日历相关请求时，Codex 会引导完成 Google 账号的 OAuth 授权
- 触发方式：直接用自然语言提问，如“总结我今天的日程”“帮我和王工找一个都有空的时间”“这场会有冲突吗，帮我改到下午”
- 授权后无需重启，按提示描述需求即可直接使用
11. 注意事项
- 连接器目前不支持真正的只读模式（见 Issue #23995），“写前确认”是提示词层面约束而非平台强制边界，对权限敏感的用户应留意
- 连接器在 MCP 启动阶段偶发失败（见 Issue #27844），遇到报错可重试或检查 Codex 版本
- 仅验证 Codex 生态原生支持；Claude Code 需自行搭建等效连接器方案，OpenClaw、Hermes Agent 未见官方支持声明
- 循环会议的修改范围（本次/整个系列/本次及之后）依赖用户明确表达，描述模糊时技能会先展示候选范围而非直接执行