核心用法
gws gmail +watch 是一款面向开发者的Gmail实时监听工具，通过Google Cloud Pub/Sub实现推送式邮件监控，将新邮件以NDJSON格式流式输出，便于与下游数据处理管道集成。
显著优点
1. 实时推送架构：基于GCP Pub/Sub原生支持Gmail push notifications，相比轮询大幅降低延迟与API配额消耗
2. 灵活的过滤机制：支持通过--label-ids按标签精准过滤（如INBOX、UNREAD），减少无效数据处理
3. 多格式输出：提供full/metadata/minimal/raw四种邮件格式，适应从简单通知到完整归档的不同场景
4. 资源生命周期管理：--cleanup标志可自动清理临时创建的Pub/Sub资源，避免云资源残留
5. 本地文件备份：--output-dir支持将每封邮件写入独立JSON文件，便于审计与离线分析
潜在局限
- 7天令牌过期：Gmail watch授权需每7天手动续期，生产环境需配合cron定时任务
- GCP依赖强制：必须使用GCP项目，产生额外云平台成本与配置复杂度
- 无内置持久化：流式NDJSON需自行对接下游存储，单机故障可能丢数据
- 权限配置繁琐：需预先配置Gmail API权限、Pub/Sub IAM角色及服务账号密钥
适合人群
- 需构建邮件驱动自动化工作流的SRE/DevOps工程师
- 处理客户支持邮件、订单通知等实时业务系统的后端开发者
- 需将Gmail数据接入数据湖/BI系统的数据工程师
常规风险
- 权限泄露：服务账号JSON密钥若泄露可导致整邮箱数据被拖取，需严格管控密钥分发
- 订阅残留：未使用
--cleanup时Pub/Sub订阅持续计费，可能产生意外云成本 - 消息重复消费：Pub/Sub at-least-once投递语义需消费端实现幂等处理
- 隐私合规：自动归档邮件可能触及GDPR/CCPA数据留存规定，需评估法律风险
---
版本：0.21.2
许可证：遵循gws项目开源协议