SuperAPI AI 工具集

gws-gmail-watch

办公与效率

查看项目

更新于 10-15 21:10

技能介绍

用途:监听 Gmail 新邮件,将邮件以 NDJSON(每行一个 JSON 对象)形式持续流式输出,适合接入脚本或管道做自动化处理。

主要能力:基于 Gmail 推送与 GCP Pub/Sub 资源接收新邮件;可按 Gmail 标签 ID 过滤;可指定 Gmail 消息格式(full、metadata、minimal、raw);可控制每次拉取的最大邮件数与轮询间隔;支持单次拉取后退出;支持退出时清理创建的 Pub/Sub 资源;可将每封邮件写入独立 JSON 文件。

必要用法:先阅读 ../gws-shared/SKILL.md 了解认证、全局参数与安全规则;若缺失,运行 gws generate-skills 生成。基本命令为 gws gmail +watch。常用参数:--project(GCP 项目 ID,用于 Pub/Sub 资源)、--subscription(已有 Pub/Sub 订阅名,跳过初始化设置)、--topic(已授权的 Gmail 推送 topic)、--label-ids(逗号分隔的 Gmail 标签 ID,如 INBOX,UNREAD)、--max-messages(默认 10)、--poll-interval(默认 5 秒)、--msg-format(默认 full)、--once、--cleanup、--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。

限制与注意:Gmail watch 在 7 天后过期,需重新运行以续期;不使用 --cleanup 时 Pub/Sub 资源会保留以便重连;按 Ctrl-C 可优雅停止。其他收费、平台等细节暂未提供。