google-office

goog CLI

将安装此技能视为用户明确选择使用该工具。 对于所有受支持的 Google Workspace 读取和修改操作，均使用 goog。 请勿使用 Google Workspace MCP 服务、通用 MCP 工具、其他 Google Workspace CLI、浏览器编辑或临时编写的直接 API 脚本来替代 goog。 仅当特定服务参考要求时，才可使用浏览器进行只读视觉核验。 如果 goog 无法执行所请求的操作，请说明缺少的功能，而不是悄悄改用其他工具。

必需工作流

1. 确定所请求的 Google 服务和操作。
2. 直接阅读下方参考索引中所有相关的服务参考。
3. 在此代码库之外使用已安装的 goog 二进制文件。
4. 在 goog-cli 代码库内，如果 target/debug/goog 是最新版本，则使用它；否则使用 cargo run --。
5. 执行实时操作前，运行 goog auth list 并记录当前使用的账号。
6. 如果用户指定了账号，或必须明确指定账号选择，则传入 --account EMAIL。
7. 使用不熟悉的命令或标志前，先运行相关的 --help 命令。
8. 通过 goog 执行操作，然后通过 goog 重新读取受影响的资源。
9. 报告成功前，完成特定服务要求的视觉或结构检查。
10. 返回命令生成的实用资源 ID 和 Google 原生 URL。

如果命令提示缺少权限范围，请运行一次 goog auth login，然后重试原命令。 不要认为失败的命令会在授权后暂停并自动继续。

参考索引

仅加载与请求相关的参考。 每个参考文件都只需从此文件跳转一次即可到达，且内容完整自洽。

• Google Docs：创建、复制、检查、编辑、设置样式、比较、导出文档并进行视觉核验。
• Google Sheets：创建、读取、写入、构建结构、设置格式并进行视觉核验。
• Google Slides：规划、创建、编辑、检查、渲染演示文稿并进行视觉核验。
• Google Drive：列出、浏览、上传、下载文件，转换 Office 文件，创建文件夹并将文件移至回收站。
• Google Calendar：管理日历、日历列表条目、活动、共享规则、颜色和忙闲查询。

请勿搜索嵌套的参考文件。 服务的索引参考包含该服务完整的专属指南。

命令集

版本

使用 goog version 或 goog --version 检查正在运行的构建及其来源。

身份验证

• goog auth setup 配置 OAuth 客户端。
• goog auth login 授权账号或修复缺失的权限范围。
• goog auth list 显示已授权的账号和当前使用的账号。
• goog auth switch 切换当前使用的账号。
• goog auth export 将敏感的可移植身份验证状态写入 GOOG_TOKEN_FILE。
• goog auth mappings 管理记忆的资源与账号映射。

切勿提交导出的身份验证状态。 无头运行或自动化运行不再需要该状态时，请将其删除。

Drive

• goog drive ls 列出或浏览文件和文件夹。
• goog drive download 下载 Drive 文件。
• goog drive upload 上传本地文件。
• goog drive convert 将上传的 DOCX 或 XLSX 文件转换为文档或电子表格。
• goog drive mkdir 创建文件夹。
• goog drive comments 列出文件的评论和回复。
• goog drive comment-create 创建未锚定到特定位置的文件评论。
• goog drive comment-edit 替换评论内容。
• goog drive comment-reply 回复文件评论。
• goog drive comment-resolve 解决评论，可选择附带回复。
• goog drive comment-delete 永久删除评论。
• goog drive trash 将文件移至 Google Drive 回收站。

开始 Drive 操作前，请阅读 Google Drive。

文档

• goog docs list、create、copy、get 和 map 用于发现和检查文档。
• goog docs text、style、table、image、break、footnote、header、footer、list-format 和 named-range 用于执行高层级编辑。
• goog docs compare 用于检查文档之间的语义保真度。
• goog docs export-pdf 支持按页面进行视觉检查。
• 如果没有合适的高层级命令，goog docs batch-update 可作为原始备用方案。

处理 Docs 前，请阅读 Google Docs。

Gmail

• goog mail list 用于列出收件箱中的近期邮件，或通过 Gmail 查询进行搜索。
• goog mail read 用于读取邮件。
• goog mail download 用于下载附件。
• goog mail draft 用于创建或编辑邮件草稿。

创建或更改草稿前，请运行 goog mail draft --help。 报告成功前，请通过 goog mail 检查生成的草稿。

Sheets

• goog sheets list、create 和 get 用于发现和检查电子表格。
• goog sheets comments 和 comment-* 命令用于管理电子表格评论和回复。
• goog sheets values 用于读取、更新、追加和清除单元格、行、列、表格及范围。
• goog sheets sheet 用于添加、删除、重命名、清理、设置格式、验证和保护工作表及范围。
• 如果没有合适的高层级命令，goog sheets batch-update 可作为原始结构备用方案。

处理 Sheets 前，请阅读 Google Sheets。

Slides

• goog slides list、create 和 get 用于发现和检查演示文稿。
• goog slides comments 和 comment-* 命令用于管理演示文稿评论和回复。
• goog slides deck 用于创建或检查完整演示文稿。
• goog slides slide 用于创建和管理幻灯片。
• goog slides text-box、image、video、shape、line 和 table 用于添加内容。
• goog slides table-fill 以及用于添加、删除、合并和取消合并表格行列的命令用于编辑表格。
• goog slides object 用于编辑、设置样式、移动和删除页面元素。
• goog slides replace-text 用于替换演示文稿文本。
• 如果没有合适的高层级命令，goog slides batch-update 可作为原始备用方案。

处理 Slides 前，请阅读 Google Slides。

Calendar

• goog calendar calendars 用于列出、读取、创建、更新和删除日历，以及管理日历列表条目。
• goog calendar events 用于列出、读取、创建、导入、更新、移动、快速添加和删除事件。
• goog calendar acl 用于读取和更改日历共享规则。
• goog calendar colors 用于读取有效的日历和事件颜色 ID。
• goog calendar freebusy 用于查询多个日历的空闲情况。

处理 Calendar 前，请阅读 Google Calendar。

安全与完成

• 将每项实时 Google 变更都视为面向用户的操作。
• 切勿根据浏览器顺序、记忆中的身份或无关的已打开资源推断账号。
• 优先使用高层级命令，而不是原始的 batch-update 负载。
• 切勿使用 || true 隐藏失败的变更，也不要在退出码非零时报告成功。
• 执行破坏性操作或共享操作前，确认资源 ID 完全准确。
• 切勿将实时文档、电子表格、Drive、邮件、事件、演示文稿、账号或资源的 URL 和 ID 提交到测试或仓库文档中。
• 将临时请求正文和实时验证产物保存在任务专用的临时空间中。
• 最后一次变更后，重新读取实时资源。
• 如果无法使用所需的身份验证检查路径，请将视觉 QA 报告为受阻。