Recipe Forward Labeled Emails

核心用法

本技能通过组合三个步骤实现 Gmail 标签邮件的自动化转发：

1. 检索邮件：使用 gws gmail users messages list 配合 label: 搜索语法筛选带指定标签的邮件，支持 needs-review 等自定义标签
2. 获取详情：通过 gws gmail users messages get 提取单封邮件的完整内容（主题、正文、附件元数据）
3. 执行转发：调用 gws gmail +send 构造新邮件，手动拼接原邮件主题与正文内容

显著优点

• 零代码自动化：基于 Google Workspace CLI (gws) 实现，无需编写 Apps Script 或启用复杂 API 权限流
• 灵活标签系统：充分利用 Gmail 原生标签机制，支持多条件组合查询（如 label:urgent label:unread）
• 跨平台兼容：命令行模式可在 CI/CD 管道、crontab 定时任务或本地终端直接调用

潜在缺点与局限性

• 非原子操作：三步分离执行，若步骤 1 返回多封邮件需循环处理，目前示例仅演示单封转发
• 内容格式丢失：+send 子命令需手动重组邮件内容，原邮件的 HTML 格式、附件、内嵌图片可能无法完整保留
• 无去重机制：重复运行可能导致同一邮件多次转发，需外部记录已处理 Message ID
• 权限要求：需预授权 gws-gmail 技能，依赖 Google OAuth 范围 https://www.googleapis.com/auth/gmail.modify

适合人群

• 小型团队需要将会员申请、客户反馈等邮件自动汇总至共享邮箱
• 开发者构建轻量级邮件工作流，替代 Zapier/Make 等 SaaS 自动化工具
• 需审计留痕场景：通过标签标记后再转发，比直接转发更易追踪来源

常规风险

• OAuth 令牌泄露：gws 凭证存储于本地，共享环境需严格管控文件权限
• 邮件内容敏感：自动化转发可能意外暴露含隐私信息的邮件，建议在 list 阶段增加关键词过滤
• API 配额限制：Gmail API 默认 1,000,000,000 配额单位/天，高频调用需监控 gws 的批量处理策略

核心用法

该技能为纯 Markdown 文档形式的自动化配方（Recipe），无需编写代码即可实现 Gmail 邮件的智能筛选与转发。用户只需通过三步 CLI 命令完成操作：首先使用 gws gmail users messages list 命令按标签（如 label:needs-review）检索目标邮件，获取邮件 ID 列表；其次通过 gws gmail users messages get 获取单封邮件的完整内容；最后调用 gws gmail +send 构造转发邮件，指定收件人、主题和正文内容即可完成转发。

技能设计上采用声明式指令风格，所有参数均通过 JSON 格式传递，支持与自动化工作流（如定时任务、Webhook 触发）无缝集成。作为前置条件，用户需先加载 gws-gmail 技能并确保本地已安装 gws CLI 工具及完成 Google Workspace 身份认证。

显著优点

安全性卓越：经 CLS-Certify 六维雷达扫描，该技能获得 S 级安全评级（95 分）。纯文档结构、无可执行代码、零第三方依赖，从根本上杜绝了代码注入、供应链攻击等风险。所有操作均通过官方 gws CLI 工具完成，网络通信采用 TLS 1.3 加密，符合 GDPR 与 CCPA 隐私合规要求。

权威可靠：基于 Google Workspace 官方生态构建，gws 工具为 Google 官方维护的企业级 CLI，API 调用经过严格审计，数据来源可信（T3 级社区项目但依赖 T1 级官方基础设施）。

极简高效：无需编写复杂脚本，三步命令即可完成邮件筛选、内容提取、构造转发的完整流程。特别适合需要批量处理特定标签邮件的场景，如将客户反馈自动转发至客服主管、将待审批邮件推送至管理层等。

灵活可扩展：标签查询支持 Gmail 高级搜索语法（如 label:urgent after:2024/01/01），可组合时间、发件人、关键词等条件；转发内容支持自定义模板，便于企业标准化邮件处理流程。

潜在缺点与局限性

生态依赖较重：必须使用 gws CLI 工具，该工具需单独安装配置，且依赖 Google Workspace 企业版授权。个人 Gmail 用户无法直接使用，限制了普适性。

功能边界明确：仅支持邮件转发操作，无法修改原邮件状态（如标记已读、归档）、无法提取附件自动上传、不支持富文本格式还原，复杂场景需配合其他技能组合使用。

无实时触发机制：当前实现为命令式调用，需外部定时任务（如 cron）或事件系统驱动，不具备原生的事件监听能力（如"新邮件到达即时触发"）。

模板能力有限：转发正文需手动拼接字符串，不支持 HTML 模板引擎或变量插值的高级功能，多场景复用性受限。

适合的目标群体

• 企业行政与运营团队：需要建立标准化邮件分流机制，将客户咨询、投诉、合作请求按标签自动路由至对应负责人
• 项目经理与团队主管：希望聚合分散在成员邮箱中的关键邮件（如带 needs-review 标签的交付物），统一审阅入口
• IT 运维与自动化工程师：寻求零代码、高安全性的 Gmail 自动化方案，替代传统基于 Python/Google Apps Script 的复杂实现
• 小型创业团队：无专职开发资源，依赖现成工具搭建轻量级工作流，降低邮件管理人力成本

使用风险与注意事项

权限配置风险：需授予 Bash 工具执行权限及 gws-gmail 技能依赖，建议遵循最小权限原则，使用 Google Workspace 应用专用密码而非主账户凭证，定期轮换访问令牌。

误转发风险：标签查询条件若配置不当（如标签名拼写错误），可能导致邮件错发或漏发。强烈建议先用 list 命令 dry-run 验证结果集，确认无误后再执行转发。

隐私合规边界：虽技能本身不存储数据，但转发行为涉及邮件内容传输至第三方地址，需确保符合企业内部数据分级策略，避免敏感信息（如含个人身份信息的客户邮件）违规外发。

性能与配额限制：Gmail API 存在每日调用配额（100 万次查询上限/企业用户），批量处理大量邮件时可能触发限流。建议分批执行并添加指数退避重试逻辑。

工具版本漂移：gws CLI 更新可能导致命令参数变更，建议锁定版本或订阅官方变更日志，定期回归测试技能可用性。