Google Workspace CLI (gog)

gog 是一款功能强大的 Google Workspace 命令行工具，旨在通过终端高效管理 Gmail、日历、云端硬盘、通讯录、表格和文档。该技能由知名开发者 Peter Steinberger 维护，其 GitHub 仓库拥有超过 7,200 颗星标，属于高信誉度的社区开源项目（T2 级可信来源）。

核心用法

所有操作均基于 OAuth 2.0 授权，安全地接入用户 Google 账户。主要指令涵盖：

• 邮件管理：在终端搜索（支持 Gmail 高级搜索语法）和发送邮件。
• 日历调度：查看指定日历在特定时间段内的事件。
• 文件与数据操作：支持搜索云端硬盘文件、查阅和修改 Sheets 表格、导出或查看 Docs 文档，以及列出通讯录。

显著优点

1. 统一集成接口：告别网页端切换，在单一的 CLI 环境中即可完成邮件、表格、文档等多任务处理，极大提升效率。
2. 脚本友好：所有命令均支持 --json 和 --no-input 参数，能够无缝嵌入自动化脚本，实现无人值守的数据抓取和批量操作。
3. 高信誉背书：项目星标超 7,200，基于 MIT 开源协议，且为纯指令文档类技能，本身不嵌入恶意代码。

潜在缺点与局限性

1. 非原生编辑能力：虽然能读取和导出 Docs 文件，但对 Google Docs 的“原地编辑”需要额外的 Docs API 客户端支持，gog 本身无法完成。
2. 隐私文档缺失：Skill 涉及邮件、文件等高风险敏感数据，但目前缺少详尽的隐私政策声明和用户数据处理方式说明。
3. 安全边界模糊：现有指引仅提醒发送邮件前需确认，对批量删除文件、未授权分享等高风险操作未作明确禁止性约束。

适合的目标群体

• 需要频繁在 Google 生态内进行自动化处理的 后端开发者和 SRE 运维人员。
• 希望通过脚本定时导出数据、生成报表的 数据分析和业务流程自动化专员。
• 偏爱键盘操作、喜欢在终端管理事务的 高级办公用户和效率爱好者。

使用风险提示

• 数据隐私风险：尽管传输使用 TLS 1.3 加密，但若本地脚本将敏感邮件或联系人信息保存或转发，可能导致泄露。
• 操作校验风险：如果 Agent 在脚本模式下忽略用户确认机制，可能会造成表格数据误清除或邮件误发。
• 外部二进制依赖：安全审查仅针对 Skill 定义文件，未覆盖外部 gog 二进制本身的安全性，用户需确保从官方源获取该工具。

gog 综合评估

gog 是一款专为 Google Workspace 生态打造的命令行工具（CLI），由开发者 steipete 维护，通过 Homebrew 分发安装。它将 Gmail、Google Calendar、Drive、Contacts、Sheets、Docs 六大核心服务统一封装为终端可执行命令，让开发者无需编写代码即可实现邮件搜索发送、日历事件查询、云端文件检索、电子表格读写、文档导出等高频操作。

核心用法

1. OAuth 初始化（一次性）：先通过 gog auth credentials 加载 Google API 客户端密钥，再用 gog auth add 绑定邮箱并勾选所需服务权限，全程遵循标准 OAuth 2.0 授权流程。
2. 日常高频指令：

3. 脚本友好：所有命令支持 --json 输出与 --no-input 静默模式，配合环境变量 GOG_ACCOUNT 可省略重复参数，完美嵌入 CI/CD 或本地自动化脚本。

• Gmail：search 支持完整搜索语法（如 newer_than:7d），send 可快速发信；
• Calendar：events 按时间区间导出日程；
• Drive：search 检索云端文件；
• Sheets：get/update/append/clear/metadata 覆盖单元格读取、批量写入、追加行、清空区域及元数据查询；
• Docs：export 转存为 txt/pdf，cat 直接输出文本内容。

显著优点

• 生态覆盖完整：一站式解决 Workspace 六大服务，无需切换多个工具或 SDK；
• 终端原生体验：纯 CLI 交互，响应速度快，适合键盘流用户；
• 标准 OAuth 安全：不存储用户密码，令牌由 Google 官方授权服务器签发；
• 输出格式灵活：JSON 结构化数据便于与 jq、Python 等工具链集成；
• Homebrew 分发：安装升级便捷，依赖管理透明。

潜在局限

• 功能只读或增量：Docs 模块仅支持导出/查看，无法直接编辑正文；复杂格式修改仍需调用官方 Docs API；
• 外部依赖：Skill 本身为纯文档封装，实际执行依赖用户本地安装的 gog 二进制，若版本不兼容可能导致命令失效；
• OAuth 配置门槛：首次使用需创建 Google Cloud 项目并下载 client_secret.json，对非开发者有一定学习成本；
• 网络要求：所有操作实时调用 Google API，离线场景不可用。

适合人群

• 需要批量处理邮件、表格、日程的开发运维人员；
• 希望用脚本自动化 Workspace 流程的工程师；
• 追求终端效率、厌恶频繁切换浏览器 tab 的重度 Workspace 用户。

常规风险

• OAuth 凭据泄露：client_secret.json 若权限设置不当或被误提交至 Git，可能导致账号被滥用；
• 误操作覆盖数据：Sheets update/clear 等命令无二次确认，脚本中错误范围可能导致数据丢失；
• Google API 配额限制：高频调用可能触发 API 速率限制；
• 第三方工具信任：gog 为个人开发者项目（T3 来源），虽经安全扫描无恶意代码，但长期维护稳定性需持续关注。

综上，gog 是 Workspace 自动化场景的高效利器，建议有脚本能力的用户在做好 OAuth 凭据安全管理的前提下使用。