夜雨聆风
告别繁琐操作!谷歌这款 CLI 神器,一键搞定 Google Workspace 全管理
-
中小企业行政 / IT 岗：批量创建员工邮箱、分配云端硬盘权限、重置账号密码，不用逐个点后台，几分钟搞定原本几小时的工作；
-
高频用谷歌办公套件的职场人：每天和 Gmail、表格、文档打交道，需要批量导出数据、修改共享权限、整理邮件的朋友，告别重复操作；
-
想搞简单自动化的新手：不用学复杂编程，复制粘贴指令就能实现基础自动化，比如自动备份云端文件、汇总日历行程；
-
AI Agent 开发者 / 使用者：工具自带 40+AI 代理技能，输出结构化 JSON 格式，能直接对接 LLM，让 AI 帮你管理办公套件，零定制开发成本。
-
查看最近 10 个文件：
gws drive files list --params '{"pageSize": 10}'-
上传文件并自动加元数据：
gws drive +upload ./报告.pdf --name "Q1工作汇报"-
批量导出文件：结合分页指令，一键下载指定类型 / 时间的所有文件，不用逐个点击保存。
-
快速发邮件：
gws gmail +send --to xxx@xxx.com --subject "工作对接" --body "附件是需要确认的文档"-
回复 / 转发邮件：，自动处理邮件线程，不用打开邮箱页面；
gws gmail +reply --message-id 邮件ID --body "已确认，没问题"-
整理未读邮件：，一键查看未读邮件的发件人、主题、时间，快速筛选重点。
gws gmail +triage-
新建表格：
gws sheets spreadsheets create --json '{"properties": {"title": "Q2预算表"}}'-
给表格追加数据：
gws sheets +append --spreadsheet 表格ID --values "张三,95,优秀"-
给文档追加内容：
gws docs +write --document 文档ID --text "新增：6月10日项目进度"-
查看今日日程：，一键获取所有日历的待办会议；
gws calendar +agenda-
生成晨会报告：，自动汇总今日会议 + 未完成任务，不用手动整理；
gws workflow +standup-report-
会议准备：，一键提取会议议程、参会人、关联文档，提前做好准备。
gws workflow +meeting-prep-
给团队群发消息：
gws chat +send --space 群ID --text "项目已部署完成，大家可以测试"-
批量设置文档权限：不用逐个文档点击，一行指令开放 / 收回部门成员的查看 / 编辑权限。
-
npm 安装（最简单）：打开电脑的命令行（Windows 用 PowerShell，Mac/Linux 用终端），复制以下指令回车即可：
npm install -g @googleworkspace/cli-
手动下载二进制文件：去 GitHub 仓库的 Releases 页面，下载对应电脑系统的文件，直接运行即可。
-
命令行输入：，按提示完成 Google Cloud 项目配置（自动创建，不用手动操作）； gws auth setupgws drive files list --params '{"pageSize": 5}' -
继续输入：，扫码登录你的 Google 账号，选择需要授权的服务（如 drive、gmail），完成后就可以用了。
gws auth login
-
零样板代码，新手友好
不用写复杂的 API 调用代码，谷歌官方的 Discovery Service 会自动生成命令， 每个指令都有 –help 提示 ，不懂就输指令查说明，全程不用查复杂文档。 -
多场景认证，办公 / 服务器都能用
支持本地交互式登录、CI / 无头服务器登录、服务账号登录、已有令牌登录等多种方式，不管是自己电脑用，还是部署在公司服务器做自动化，都能适配，还能加密存储凭证，数据超安全。 -
自带 AI 技能，无缝对接 AI 代理
仓库内置 40+AI Agent 技能，还能一键安装所有技能：，输出的所有结果都是结构化 JSON，AI 能直接识别处理，让 AI 帮你自动管理办公套件，真正实现「解放双手」。npx skills add https://github.com/googleworkspace/cli -
贴心辅助指令，操作更简单
除了基础指令，还自带 + 前缀辅助命令（如 + send、+upload、+agenda），都是针对日常办公的高频操作优化，比原生 API 指令更简洁，不用记复杂参数。 -
跨平台兼容，全系统能用
-
登录提示「Access blocked」：OAuth 应用处于测试模式，需要在 Google Cloud 控制台把自己的账号加入「测试用户」，再重新登录；
-
提示「太多权限 / 授权失败」：测试模式下谷歌限制 25 个权限，登录时指定需要的权限即可：；
gws auth login -s drive,gmail,sheets-
提示「API 未启用」：按命令行提示的链接，在 Google Cloud 控制台启用对应 API（如 Gmail API、Drive API），等待 10 秒再重试即可；
-
找不到 gcloud 命令：不用装 gcloud，直接在 Google Cloud 控制台手动创建 OAuth 客户端，下载 JSON 文件放到指定目录即可。