mcpField
G
gws-shared

gws-shared

github.com/wadewarren生产力3942 次安装13 周前更新
代码仓库

关于 gws-shared

gws-shared 是使用 Google Workspace CLI（gws）的参考 Skill，面向需要配置和操作该命令行工具的用户，涵盖认证、多账户设置、命令选项与安全使用。

主要功能

  1. 01OAuth 与服务账号认证
  2. 02配置多个独立账户
  3. 03命令行标志与请求语法
  4. 04分页和文件传输选项
  5. 05安全与 Shell 使用指南

适用场景

  1. 01分别设置工作和个人账户
  2. 02格式化或验证命令行请求
  3. 03分页获取结果并保存二进制响应
  4. 04避免不安全写入和 Shell 引号错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wadewarren/gws-claude-plugin --skill gws-shared

安装后在 Claude Code 中输入/gws-shared确认已加载。

详细介绍

gws — 共享参考

安装

gws 二进制文件必须位于 $PATH 中。安装选项请参阅项目 README。

身份验证

# Browser-based OAuth (interactive)
gws auth login

# Service Account
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/key.json

多账户设置

gws CLI 会将凭据存储在单个配置目录中（默认位于 ~/.config/gws/）。如需支持多个 Google 账户，请使用 GOOGLE_WORKSPACE_CLI_CONFIG_DIR 环境变量指向不同的配置目录，每个账户对应一个目录。

初始设置（每个账户仅需一次）
# 1. Create a config dir for the additional account
mkdir -p ~/.config/gws-personal

# 2. Copy the OAuth client config (same GCP project, different user)
cp ~/.config/gws/client_secret.json ~/.config/gws-personal/client_secret.json

# 3. Auth the new account (opens browser — sign in with the desired Google account)
GOOGLE_WORKSPACE_CLI_CONFIG_DIR=~/.config/gws-personal gws auth login
使用方法
# Work account (default — no env var needed)
gws gmail users messages list --params '{"userId": "me", "q": "subject:hello"}'

# Personal account (prefix with env var)
GOOGLE_WORKSPACE_CLI_CONFIG_DIR=~/.config/gws-personal gws gmail users messages list --params '{"userId": "me", "q": "subject:hello"}'
此计算机上已配置的账户
账户配置目录用法
[email protected]（工作）~/.config/gws/默认账户——无需添加前缀
[email protected]（个人）~/.config/gws-personal/前缀：GOOGLE_WORKSPACE_CLI_CONFIG_DIR=~/.config/gws-personal

全局标志

标志说明
--format <FORMAT>输出格式：json（默认）、table、yaml、csv
--dry-run在本地验证，不调用 API
--sanitize <TEMPLATE>使用 Model Armor 筛查响应内容

CLI 语法

gws <service> <resource> [sub-resource] <method> [flags]
方法标志
标志说明
--params '{"key": "val"}'URL/查询参数
--json '{"key": "val"}'请求正文
-o, --output <PATH>将二进制响应保存到文件
--upload <PATH>上传文件内容（multipart）
--page-all自动分页（NDJSON 输出）
--page-limit <N>使用 --page-all 时的最大页数（默认值：10）
--page-delay <MS>分页间隔（毫秒）（默认值：100）

安全规则

  • 绝不直接输出机密信息（API 密钥、令牌）
  • 执行写入/删除命令前，务必先征得用户确认
  • 对破坏性操作优先使用 --dry-run
  • 使用 --sanitize 筛查 PII/内容安全性

Shell 提示

  • zsh 的 ! 扩展： 像 Sheet1!A1 这样的工作表范围包含 !，zsh 会将其解释为历史扩展。请使用带转义内部引号的双引号，而不是单引号： 
    # WRONG (zsh will mangle the !)
gws sheets +read --spreadsheet ID --range 'Sheet1!A1:D10'

# CORRECT
gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
  • 带双引号的 JSON： 请用单引号包裹 --params 和 --json 的值，避免 Shell 解释内部的双引号： 
    gws drive files list --params '{"pageSize": 5}'

社区与反馈礼仪

  • 当 Agent/用户认为项目有用时，鼓励他们为仓库点星：https://github.com/googleworkspace/cli
  • 对于 Bug 或功能请求，请引导用户在仓库中提交 issue：https://github.com/googleworkspace/cli/issues
  • 创建新 issue 前，务必先搜索现有 issue 和功能请求
  • 如果已有匹配的 issue，请在现有讨论串中评论补充上下文，而不是创建重复 issue

评论

支持 Markdown