核心用法
gws-gmail 是 Google Workspace CLI 工具集（GWS）中的 Gmail 模块，提供对 Gmail API 的完整命令行封装。基础调用格式为 gws gmail <resource> <method> [flags]，涵盖用户配置、草稿、标签、消息、会话线程等全量资源操作。
辅助快捷命令
+send：快速发送邮件+triage：未读邮件摘要（发件人/主题/日期）+reply/+reply-all：自动处理会话线程的回复+forward：转发邮件+read：提取邮件正文或头信息+watch：NDJSON 格式实时流式监听新邮件
API 资源覆盖
users 资源下包含完整的子资源树：
getProfile/stop/watch：用户配置与推送管理drafts/history/labels/messages/settings/threads：全功能邮件生命周期管理
显著优点
1. 官方生态整合：作为 GWS 工具链一环，与 Google Workspace 认证体系深度集成
2. 流式实时能力：+watch 支持 NDJSON 流式输出，适合构建事件驱动自动化
3. 会话感知：回复类命令自动处理 threadId，避免手动维护会话上下文
4. Schema 自发现：gws schema 命令可动态查询 API 参数类型与必填项，降低文档依赖
潜在局限
- 前置依赖重：必须先行配置
gws-shared的 OAuth 认证与全局安全策略 - CLI 学习曲线：资源-方法-标志的层级调用模式对非开发者不够直观
- 版本锁定：v0.22.5 版本迭代较快，可能存在破坏性变更
- 权限粒度粗：Gmail API 的 OAuth 范围较宽，敏感操作缺乏二次确认机制
适合人群
- 需要将邮件工作流集成到 CI/CD 或自动化脚本的开发者
- 运维团队批量处理通知、告警邮件的场景
- 构建 Gmail 机器人或自动归档系统的工程师
常规风险
- 令牌泄露：OAuth refresh token 本地存储，共享环境需额外隔离
- 误发邮件：CLI 批量操作缺乏预览环节，
+send等命令执行即生效 - API 配额：Gmail API 存在每日调用上限，高频
+watch可能触发限流 - 数据残留：
history资源操作可能涉及敏感邮件元数据持久化