cli 是什么?

Google Workspace CLI(gws)是一个统一的命令行工具,覆盖 Drive、Gmail、Calendar、Sheets、Docs、Chat、Admin 等几乎所有 Google Workspace API,面向人类与 AI 智能体使用:零样板、结构化 JSON 输出,并内置 40+ 个 Agent 技能。它不内置静态命令列表,而是在运行时读取 Google 的 Discovery Service 动态构建整套命令——Google 新增 API/方法时 gws 自动获得。许可为 Apache-2.0,Rust,约 26,522 stars。需明确:README 注明这不是 Google 官方支持的产品,且仍在积极开发、会有破坏性变更。

⭐ 23,887 Stars 🍴 1,196 Forks Rust Apache-2.0 作者: googleworkspace
来源:README.md(首段、Discovery 动态构建、NOTE/IMPORTANT);GitHub 仓库元数据(stars=26522、license=Apache-2.0、language=Rust) 查看 GitHub 仓库 →

为什么值得关注

用脚本或 AI 智能体操作 Google Workspace 通常要逐个 API 写认证与请求样板,繁琐。gws 用一个 CLI、结构化 JSON 输出、动态覆盖全 Workspace API,并自带 40+ Agent 技能,对自动化与让 AI 操作 Workspace 很省事;用 Rust 写、可作为 Gemini CLI 扩展,因而受关注。截至数据采集约 26,522 stars。需提示:它非 Google 官方支持产品、仍在快速演进。

来源:README.md(首段、Why gws、AI Agent Skills);GitHub 仓库元数据(stars=26522)

核心功能

统一覆盖全 Workspace API

一个 CLI 操作 Drive/Gmail/Calendar/Sheets/Docs/Chat/Admin 等所有 Workspace API,零样板。

来源:README.md(首段)
Discovery 动态命令

运行时读取 Google Discovery Service 动态构建命令,Google 新增 API/方法自动可用,无需手动更新。

来源:README.md(Discovery 段落)
结构化 JSON + 40+ Agent 技能

输出结构化 JSON、对 AI 智能体友好,内置 40+ Agent 技能(可作 Gemini CLI 扩展等)。

来源:README.md(首段、AI Agent Skills)
OAuth2 认证

用 OAuth2 与你自己的 Google 账号(需 Google Cloud 项目获取凭证),可用 gws auth setup 配置。

来源:README.md(Authentication、Prerequisites)

技术架构

gws 是 Rust 编写的 CLI,核心特点是「动态命令面」:运行时读取 Google Discovery Service 自动构建对 Drive/Gmail/Calendar/Sheets/Docs/Chat/Admin 等所有 Workspace API 的命令,无需为新增 API 手动更新。输出结构化 JSON、对 AI 友好,并内置 40+ Agent 技能(可作为 Gemini CLI 扩展等)。认证用 OAuth2(需一个 Google Cloud 项目获取凭证,可经 Console/gcloud 或 gws auth setup 配置)与你自己的 Google 账号。安装推荐从 GitHub Releases 下预编译二进制放进 PATH,或用 npm 自动下载。需 Node.js 18+(npm 安装时)。

来源:README.md(Discovery 动态构建、首段、Prerequisites、Authentication、AI Agent Skills)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Google Workspace API + Discovery ServiceGoogle Workspa… OAuth2 + Google Cloud 项目OAuth2 + Googl… Node.js 18+(npm 安装时)Node.js 18+(n… 统一覆盖全 Workspace API统一覆盖全 Workspace… Discovery 动态命令 结构化 JSON + 40+ Agent 技能结构化 JSON + 40+ A… OAuth2 认证 cli 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Rust框架动态构建的 CLI(基于 Google Discovery Service)
Google Workspace API + Discovery Ser…OAuth2 + Google Cloud 项目Node.js 18+(npm 安装时)
预编译二进制(GitHub Releases)或 npm 安装;可作 Gemini CLI 扩展
来源:README.md(首段、Prerequisites、Installation、Authentication);GitHub 仓库元数据(language=Rust)

快速上手

推荐从 GitHub Releases 下对应 OS 的预编译二进制 gws 放进 PATH;也可 npm install -g @googleworkspace/cli(需 Node.js 18+)。需要一个 Google Cloud 项目获取 OAuth 凭证(可经 Console/gcloud 或 gws auth setup 配置),用你自己的 Google 账号认证。之后即可用 gws 对各 Workspace API 发命令、拿结构化 JSON;AI 智能体可用其内置 40+ 技能或作为 Gemini CLI 扩展。注意:它非 Google 官方支持产品、仍在积极开发会有破坏性变更,生产使用需谨慎。
来源:README.md(Installation、Prerequisites、Authentication、IMPORTANT)

使用场景

适合要脚本化或用 AI 智能体操作自己 Google Workspace 的人:自动化 Drive/Gmail/Calendar/Sheets/Docs/Chat/Admin 等任务、用结构化 JSON 接入脚本与 Agent、或把它当 Gemini CLI 扩展让 AI 直接调用 Workspace。动态命令面意味着无需等工具适配新 API。用自己的 Google 账号 + OAuth,按 Google 条款使用;因非官方且快速演进,生产前需评估稳定性。

来源:README.md(首段、AI Agent Skills、Discovery)

优势与局限

优势

  • 一个 CLI 覆盖全 Workspace API,零样板、结构化 JSON、对 AI 友好
  • Discovery 动态构建命令,新 API 自动可用,免等适配
  • 内置 40+ Agent 技能、可作 Gemini CLI 扩展,Rust 实现、Apache-2.0
  • 用自己的 Google 账号 + OAuth,认证标准

局限

  • 非 Google 官方支持产品,仍在积极开发、会有破坏性变更
  • 需自建 Google Cloud 项目配置 OAuth,初次设置有步骤
  • 使用受 Google API 配额与服务条款约束
  • 动态命令面强大但学习/发现命令需熟悉 Workspace API
来源:README.md(NOTE/IMPORTANT、Prerequisites、Authentication)

最新版本

本页未列出具体版本号;项目处于积极开发、迈向 v1.0(会有破坏性变更),通过 GitHub Releases 发布预编译二进制。因采用 Discovery 动态构建,命令面随 Google Workspace API 演进自动更新;技能与 Gemini CLI 扩展等持续完善。

来源:README.md(IMPORTANT、Discovery、Installation)

总结评价

Google Workspace CLI(gws)很巧妙:用一个 Rust CLI、靠 Discovery Service 动态构建命令覆盖全 Workspace API,零样板、结构化 JSON、对 AI 友好,还内置 40+ Agent 技能、可作 Gemini CLI 扩展。对要脚本化或让 AI 操作自己 Google Workspace 的人很省事,且新 API 自动可用。要清楚它非 Google 官方支持产品、仍快速演进有破坏性变更、需自建 Cloud 项目配 OAuth、受 API 配额/条款约束。作为统一的 Workspace 自动化 CLI,它设计聪明、对 Agent 友好,但稳定性需随其迈向 v1.0 再评估。

来源:综合 README.md 的动态命令、AI 技能与非官方/演进状态
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 14:58. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件