用途:Gmail 邮件监控命令,用于监听新邮件并将其以 NDJSON 格式持续输出,适合需要实时接收或批量拉取 Gmail 邮件的场景。
主要能力:基于 GCP Pub/Sub 资源接收 Gmail 推送,支持标签过滤、批次大小与轮询间隔设置、多种邮件格式(full、metadata、minimal、raw)、单次拉取、退出时清理资源,以及将每封邮件单独写入指定目录的 JSON 文件。
使用方式:命令为 gws gmail +watch。可选参数包括 --project(Pub/Sub 资源的 GCP 项目 ID)、--subscription(已有订阅名称,跳过初始化)、--topic(已授权的已有主题)、--label-ids(逗号分隔的标签 ID,如 INBOX,UNREAD)、--max-messages(默认 10)、--poll-interval(默认 5 秒)、--msg-format(默认 full)、--once(拉取一次后退出)、--cleanup(退出时删除创建的 Pub/Sub 资源)、--output-dir(输出目录)。示例:gws gmail +watch --project my-gcp-project;gws gmail +watch --project my-project --label-ids INBOX --once;gws gmail +watch --subscription projects/p/subscriptions/my-sub;gws gmail +watch --project my-project --cleanup --output-dir ./emails。
限制与注意事项:使用前需阅读 gws-shared 技能文档了解认证、全局参数与安全规则,缺失时可运行 gws generate-skills 生成。Gmail watch 在 7 天后过期,需重新运行以续期。不使用 --cleanup 时 Pub/Sub 资源会保留以便重连。可用 Ctrl-C 优雅停止。具体认证细节与计费信息暂未提供。