核心用法
gws-gmail-forward 是 gws 命令行工具套件中的 Gmail 邮件转发模块，允许用户通过 CLI 将指定邮件转发至新收件人。核心命令结构为：
gws gmail +forward --message-id <ID> --to <EMAILS> [选项]
必需参数为 --message-id（Gmail 邮件 ID）和 --to（目标收件人，支持逗号分隔多地址）。可选功能涵盖：自定义发件别名（--from）、添加附注（--body 支持纯文本/HTML）、附件控制（--attach 新增附件 / --no-original-attachments 剔除原附件）、抄送密送（--cc/--bcc）、HTML 模式（--html）以及干运行调试（--dry-run）。
工具完整保留原始邮件头信息（发件人、日期、主题、收件人），默认包含原附件，符合 Gmail 网页版行为；HTML 模式下通过 cid: 保留内嵌图片，并使用 Gmail 原生 gmail_quote CSS 类确保格式兼容。
显著优点
- 自动化集成：CLI 设计便于脚本化、CI/CD 流水线集成，实现批量邮件处理
- 格式完整保留：HTML 转发继承 Gmail 原生样式，内嵌图片通过 CID 机制无损传递
- 灵活附件策略：可独立控制原附件保留/剔除，同时支持追加新文件
- 多身份支持：
--from参数支持发送别名/代理邮箱，适配企业多角色场景 - 安全调试：
--dry-run预览请求内容，避免误操作
潜在缺点与局限性
- 依赖预认证：需提前完成
gws全局 OAuth2 授权，无法独立运行 - 附件大小限制：总附件（原附件+新附件）硬限制 25MB，超大文件需另寻方案
- 纯文本图片丢失：非 HTML 模式下内嵌图片被剔除，与 Gmail 网页行为一致但可能意外
- 消息 ID 依赖：需外部获取 Gmail message ID，无法通过主题/发件人模糊匹配
- 生态锁定：专属于
gws套件，与其他 Gmail CLI 工具（如gmailctl）不兼容
适合人群
- 运维/开发者：需自动化邮件告警转发、工单分发
- 企业管理员：批量处理审计邮件、合规归档转发
- 高级用户：偏好终端效率，厌倦网页版重复操作
常规风险
- 授权泄露：
gws全局凭证若存储不当，可能导致 Gmail 账户被恶意利用 - 误转发敏感信息：
--no-original-attachments使用不当或遗漏，可能导致机密文件意外外泄 - HTML 注入：
--html模式若引入不可信内容，存在 XSS 风险（尽管邮件客户端通常隔离） - 配额消耗：高频 API 调用可能触发 Gmail API 速率限制
> 注：来源为占位文本，未执行实际安全扫描，评估基于功能文档推断。