用途：gws-shared 是 gws CLI 的共享参考文档，用于统一说明该命令行工具在认证、全局标志、输出格式和安全使用方面的通用模式。
主要能力：支持浏览器交互式 OAuth 登录（gws auth login），也支持通过环境变量 GOOGLE_APPLICATION_CREDENTIALS 指定服务账号密钥文件。全局标志包括 --format（json 默认、table、yaml、csv）、--dry-run（本地校验不调用 API）、--sanitize（经 Model Armor 筛查响应）。命令语法为 gws <service> <resource> [sub-resource] <method> [flags]。方法级标志包括 --params、--json、-o/--output、--upload、--page-all、--page-limit（默认 10）、--page-delay（默认 100 毫秒）。
使用方式：需先将 gws 二进制放入 $PATH，安装方式见项目 README。执行写或删除类命令前应先与用户确认，破坏性操作优先使用 --dry-run，涉及 PII 或内容安全时使用 --sanitize。
限制与安全规则：不得直接输出密钥、令牌等敏感信息。社区反馈方面，鼓励为仓库加星，问题或功能请求请提交至仓库 issue，且应先搜索已有 issue，避免重复。