1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | google-drive-openai-plugins |
| 项目自述名称 | google-drive（.codex-plugin/plugin.json 内 name 字段原值；author.name 为 “OpenAI”，插件由 OpenAI 官方编写并维护） |
| 作者/维护者 | OpenAI 官方团队，托管于官方仓库 openai/plugins |
| 来源链接 | https://github.com/openai/plugins/tree/main/plugins/google-drive |
| 许可证 | MIT（plugin.json 明确声明） |
| GitHub Stars/Forks | 所属合集仓库（openai/plugins）4,838 / 651（GitHub API 实测 2026-07-31；仓库为 180+ 插件合集，星数不直接归属本插件，独立佐证见第 6 章） |
| 最新版本 | plugin.json 声明 0.1.7；该子目录提交历史 API 实测共 38 次提交、10 位不同作者，最近一次 2026-06-17 |
| 安装方式 | Codex App/CLI/VS Code 扩展的 Connected Apps（插件市场）中启用 Google Drive 连接器（见第 10 章） |
2. 功能介绍与亮点
google-drive-openai-plugins 是 OpenAI 官方为 Codex 编写的 Google 文档全家桶技能包，以 google-drive 为统一入口，捆绑 5 个独立 SKILL.md 技能：
- google-drive（路由/基础技能）：文件发现、检索、分享、复制、删除、导出、版本历史查看与还原，并作为其余四个技能的路由中枢——明确要求“不要把用户导向单独的 Docs/Sheets/Slides 插件”，统一从这里进入
- google-docs：新建/编辑 Google 文档，支持本地
.docx原生导入转换、目标文档结构核验、“智能芯片”与内置组件重建 - google-sheets：按精确区间读写表格，支持公式设计与修复、图表创建与修复、表格清洗与重构
- google-slides：幻灯片查找、摘要、创建、本地
.pptx导入、模板迁移、结构修复 - google-drive-comments：在 Docs/Sheets/Slides/Drive 文件上撰写、回复、解决评论，且要求评论必须带有可验证的文档定位依据
亮点：SKILL.md 中的“Write Safety”章节要求任何写操作完成后必须通过连接器回读校验，“绝不凭空构造或预测 URL”；对导入/转换场景（如新建 Google 文档时是否要求先做 .docx 原生转换）也有明确的路由规则，避免创建出无法编辑的纯文本占位文件。
3. 适用场景
固定分类：文档与办公自动化。适合已在 Codex 中连接 Google 账号、日常处理 Google 文档/表格/幻灯片的初中级用户，尤其是需要在自然语言对话中查找并汇总文件、清洗和重构表格数据、维护演示文稿模板一致性、或在协作文档中留评论走审阅流程的场景。
4. 跨 Agent 兼容性
- Codex：✅ 原生支持——
.codex-plugin/plugin.json为标准 Codex 插件清单，托管于 OpenAI 官方插件仓库（已抓取核实） - Claude Code：⚠️ 需适配——SKILL.md 的读写逻辑绑定 Codex 专属 Connected App（
.app.json声明的 OAuth 连接器与export_file/update_file/list_file_revisions等工具函数名），需自行搭建等效的 Google Workspace MCP 连接方案后才能复用其中的提示词逻辑 - OpenClaw：❓ 未验证——公开材料未提及
- Hermes Agent：❓ 未验证——公开材料未提及
5. 推荐理由
Google 文档全家桶几乎是知识工作者每天都要碰的场景，但“找对文件、区分只读总结与真正编辑、导入本地文件时保留格式、写完还要验证是否真的改对了”这类细节最容易被随手实现的技能忽略。这个技能包由 OpenAI 官方编写、直接嵌入 Codex 官方插件目录，用统一入口路由到 Docs/Sheets/Slides/评论四个专精技能，并在写操作后强制通过连接器回读验证结果、明令不得凭空生成文件链接，工程严谨度在同类连接器中较突出。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | OpenAI 官方出品，收录于官方插件目录；不采用合集仓库 4,838 星归属单个插件，改以子目录自身提交历史（38 次提交、10 位不同作者，持续迭代近 3 个月）与 openai/codex 主仓库中 64 条提及“google-drive”的真实 Issue（已抽样核实内容确为讨论本插件而非泛泛提及）作为独立佐证——真实用户参与度在同类 OpenAI 官方连接器插件中处于明显较高的水平 |
| 可用性 | 8.0 | Connected Apps 一键启用；5 份 SKILL.md 文档详尽、含明确工作流与路由规则；子目录最近更新 2026-06-17，近 3 个月内有维护；无强制付费依赖。但抽样核实的多条 Issue 反映真实磨合问题（表格连接器偶发 AttributeError 崩溃、部分会话未注入可调用工具、图片旁车文件批量更新失败），故不给满分 |
| 安全性 | 8.0 | 见下方安全检查清单 |
| 综合 | 7.7 | 三项均值，超过 7.0 达标线，安全性远超一票否决线 |
安全检查清单：
- Shell/权限范围：未见本地 shell/subprocess 执行，全部操作通过官方 Connected App 的连接器工具函数（
search/fetch/export_file/update_file等）完成 - 联网外发：仅通过官方连接器访问用户自己的 Google Drive/Docs/Sheets/Slides 数据，目标透明且为完成读写所必需；但 openai/codex 官方 Issue #34671（2026-07-22，用户 cutterdojo 提出，已抓取核实）指出：即便任务只是“读取一份用户提供链接的 Google 文档”，安装授权时仍要求整个 Drive 的广泛读/写/下载权限，缺少最小权限的授权路径——这是真实存在的权限粒度过粗问题
- API Key/凭据：无裸 API Key，走 Codex 平台统一管理的 OAuth Connector
- 可疑指令/注入迹象：抓取 5 份 SKILL.md 全文核实，未发现要求执行流程外操作的可疑指令，反而显式写有“写操作后必须连接器回读校验、不得凭空构造文件 URL”的安全设计
- 作者/组织信誉：OpenAI 官方仓库直接维护
- License：MIT，标准开源协议，条款清晰
- 维护时间：该子目录最近提交 2026-06-17，近 3 个月内持续维护；同时存在多条尚未关闭的功能性 Issue（见第 11 章），维护活跃但未完全清空积压
7. 跟同类 Skills 相比的优势
openai/plugins 合集仓库内的其他官方连接器还包括 google-calendar（同为 OpenAI 编写，聚焦日程排期而非文档编辑）、gmail（收件箱分诊与回复起草）、notion（知识库对话与任务转化）、figma（设计稿转代码）。对比来看：
| 产品 | 定位 | 核心差异 |
|---|---|---|
| google-drive-openai-plugins（本推荐） | Drive 文件管理 + Docs/Sheets/Slides 编辑 + 评论协作 | OpenAI 官方出品，5 个子技能覆盖完整 Google 办公套件，写操作强制连接器回读验证 |
| google-calendar-openai-plugins | 日程查询、冲突排查、多人排期 | 同为 OpenAI 官方出品，聚焦时间协调而非文档内容本身 |
| notion-openai-plugins | 知识库对话、任务转化、会议纪要归档 | 底层走 Notion 官方远程 MCP 服务器，偏结构化知识管理而非通用文档格式编辑 |
| gmail-openai-plugins | 收件箱分诊、回复起草 | 面向邮件场景，版本仍处早期迭代阶段 |
| figma-openai-plugins | 设计稿转代码、Code Connect 映射 | Figma 官方出品，面向前端开发者而非文档办公场景 |
8. 用户评价
- cutterdojo，openai/codex 仓库 Issue #34671（2026-07-22，已抓取核实）：反映即便只想读取单份 Google 文档，安装授权时仍被要求整个 Drive 的广泛读写权限，指出这是“意外过宽的权限边界”，希望官方提供最小权限的授权路径
- khurshhh1999，openai/codex 仓库 Issue #33619（2026-07-16，已抓取核实，Codex Desktop 版本 26.707.91948）：反映部分会话中 Google Drive 插件显示已启用，但对应的可调用工具未被真正注入到任务中，导致实际无法操作
以上为官方仓库中可验证的具名 Issue 反馈，而非评测博客式的使用评价；该插件目前在公开评测渠道尚无可访问的一手评价原文。
9. 其他补充
openai/plugins 仓库同时收录 180+ 个插件，覆盖邮件、日历、CRM、设计、开发工具等多类第三方服务，Google Drive 全家桶只是其中面向文档办公的一个分支。安装与连接统一走 Codex 平台的 Connected Apps 体系，无需用户单独申请 Google API Key。
10. 安装使用方式
- Codex CLI/App/VS Code 扩展内打开 Connected Apps（或插件市场），搜索并启用 “Google Drive”
- 首次触发文件相关请求时，Codex 会引导完成 Google 账号的 OAuth 授权（注意授权范围覆盖整个 Drive，见第 11 章）
- 触发方式：直接用自然语言提问，如“帮我找到上周的项目周报并总结要点”“把这份本地 Excel 导入成 Google 表格并修好第 3 列的公式”“在这份幻灯片的第 5 页留个评论”
- 授权后无需重启，按提示描述需求即可直接使用
11. 注意事项
- 授权范围目前覆盖整个 Google Drive 而非按需的最小权限（见 Issue #34671），对权限敏感的用户应留意，写操作前建议先确认具体目标文件
- 少数会话曾出现插件显示已启用但工具未被实际注入的情况（见 Issue #33619），遇到“能看到插件但调用不到”时可重新触发一次连接或重启会话
- 仅验证 Codex 生态原生支持；Claude Code 需自行搭建等效连接器方案，OpenClaw、Hermes Agent 未见官方支持声明
- 富格式文件（如保留样式的
.docx/.pptx）的整体覆盖写入偶有二进制传输失败的情况，SKILL.md 本身已建议遇到此类失败时收窄范围而非反复重试