需要实时监听 Gmail 新邮件并以 NDJSON…

在已配置 gws 与 Gmail/GCP Pub/Sub 的前提下，持续监听新邮件并按 NDJSON 流输出。

适用场景

解决思路

1. 先阅读 ../gws-shared/SKILL.md，获取认证、全局 flags 和安全规则；如果该文件缺失，运行 gws generate-skills 生成。
2. 运行 gws gmail +watch，监听新邮件并流式输出 NDJSON。
3. 用 --project 指定用于 Pub/Sub 资源的 GCP 项目 ID。
4. 用 --subscription 指定现有 Pub/Sub subscription 名称，以跳过设置。
5. 用 --topic 指定已授予 Gmail push 权限的现有 Pub/Sub topic。
6. 用 --label-ids 按逗号分隔的 Gmail 标签 ID 过滤，例如 INBOX,UNREAD。
7. 用 --max-messages 设置每次拉取的最大消息数，默认 10。
8. 用 --poll-interval 设置两次拉取之间的秒数，默认 5。
9. 用 --msg-format 设置 Gmail 消息格式：full、metadata、minimal、raw，默认 full。
10. 用 --once 只拉取一次后退出。
11. 用 --cleanup 在退出时删除创建的 Pub/Sub 资源。
12. 用 --output-dir 将每条消息写入该目录下的单独 JSON 文件。
13. 示例：gws gmail +watch --project my-gcp-project
14. 示例：gws gmail +watch --project my-project --label-ids INBOX --once
15. 示例：gws gmail +watch --subscription projects/p/subscriptions/my-sub
16. 示例：gws gmail +watch --project my-project --cleanup --output-dir ./emails
17. Gmail watch 会在 7 天后过期，需要重新运行以续期。
18. 不使用 --cleanup 时，Pub/Sub 资源会保留，便于重连。
19. 按 Ctrl-C 可优雅停止。
20. 需要全局 flags 和认证时，查看 ../gws-shared/SKILL.md。
21. 需要发送、读取和管理邮件的所有命令时，查看 ../gws-gmail/SKILL.md。

适用边界 · 注意事项

• 未安装 gws CLI，或未完成 Gmail/GCP 认证与 Pub/Sub 权限配置时，不适用。
• 只需要发送、读取或管理已有邮件，而不是持续监听新邮件时，不适用。
• 无法创建或保留 Pub/Sub 资源，或无法每 7 天重新运行续期 Gmail watch 时，不适用。