核心用法
recipe-forward-labeled-emails 是一个基于 Gmail API 的自动化工作流技能，通过组合三条 gws-gmail 命令实现邮件筛选与转发：
1. 标签检索：使用 gws gmail users messages list 配合 label: 查询语法定位目标邮件，支持 needs-review 等自定义标签
2. 内容提取：通过 gws gmail users messages get 获取完整邮件正文与元数据
3. 转发执行：利用 gws gmail +send 构造新邮件，保留原主题并追加转发标识
显著优点
- 工作流整合：将分散的邮件处理步骤封装为可复用 recipe，减少重复操作
- 标签驱动：充分利用 Gmail 标签体系，无需复杂规则配置即可实现分类处理
- 权限复用：依赖已授权的
gws-gmail技能，避免重复 OAuth 流程
潜在局限
- 依赖性强：必须预加载
gws-gmail技能，且需具备 Gmail API 访问权限 - 无原生转发：通过「新建邮件+引用原文」模拟转发，可能丢失原始邮件头信息（如 DKIM 签名、完整收件人列表）
- 单条处理：当前示例为逐条处理模式，批量场景需额外脚本包装
- 格式简化：
--format table输出可能截断长主题或发件人信息
适合人群
- 需将特定类别邮件（如审批请求、监控告警）自动汇总至工作群或上级的团队管理员
- 使用 Gmail 作为工作邮箱、希望建立轻量级自动化流程的开发者/运营人员
- 已部署
gws工具链、寻求减少重复邮件操作的企业用户
常规风险
| 风险项 | 说明 |
|--------|------|
| 权限扩散 | 转发操作需 `gmail.send` 权限，误配置可能导致敏感邮件外泄 |
| 标签误匹配 | Gmail 标签查询支持复杂语法（如 `label:a OR label:b`），逻辑错误会导致漏发或滥发 |
| 内容泄露 | 原始邮件正文未经脱敏直接引用，可能暴露内部信息 |
| 速率限制 | 高频调用 Gmail API 可能触发配额限制（目前 250 quota units/user/second） |
使用建议
建议在转发前增加内容过滤步骤，对含敏感关键词的邮件触发人工确认；生产环境部署时启用 API 调用日志审计。