核心用法
gws-gmail 是一个命令行 Gmail 管理工具，基于 gws CLI 框架构建。它提供了两套交互模式：
1. Helper Commands（快捷命令）：封装常用操作，如 +send 发送邮件、+triage 快速浏览未读邮件、+reply/+reply-all 自动处理线程回复、+forward 转发、+read 提取邮件内容、+watch 实时流式监控新邮件。
2. 原生 API Resources：直接映射 Gmail API，涵盖 users 资源下的完整操作：
- 用户配置：
getProfile、watch、stop - 邮件管理：
messages、threads、drafts - 组织分类：
labels - 历史同步：
history - 账户设置：
settings
所有命令支持通过 gws schema gmail.<resource>.<method> 自省参数结构，便于构建精确的 --params 和 --json 调用。
显著优点
- 全功能覆盖：从简单发送到复杂的推送通知设置（Pub/Sub），单一工具满足 Gmail 自动化全场景
- Unix 哲学友好：输出支持 NDJSON 流式格式，便于管道处理
- 线程感知：回复类命令自动处理
threadId，避免手动维护会话上下文 - 实时能力：
+watch支持持续监控，适合 CI/CD 通知、自动工单等场景
潜在局限
- 依赖前置：必须预先阅读
../gws-shared/SKILL.md完成 OAuth 配置，对新手不够友好 - 无交互式界面：纯 CLI 设计，不适合偏好图形化的用户
- 权限风险：Gmail 数据敏感度高，凭证泄露可能导致严重隐私泄露
- 版本碎片化：v0.22.2 处于快速迭代期，API 稳定性需关注
适合人群
- 开发者构建邮件自动化脚本（如备份、归档、告警）
- DevOps/SRE 团队集成邮件通知到监控体系
- 效率极客偏好命令行工作流
常规风险
数据安全：工具需完整 Gmail 访问权限，建议严格限制 OAuth scope，使用独立服务账号，避免个人主账号授权。监控 +watch 的长连接需妥善管理，防止连接泄露导致邮件数据被截流。