gws-gmail-forward 是 Google Workspace CLI 中 gws gmail 的一个子命令，用于将一封 Gmail 邮件转发给新的收件人。
一、用途 该命令用于基于已有邮件 ID 创建转发邮件，并把原始邮件内容发送给一组新的收件人。
二、使用方式 命令形式为： gws gmail +forward --message-id <ID> --to <EMAILS>
其中： --message-id（必填）指定要转发的 Gmail 邮件 ID。 --to（必填）指定收件人邮箱地址，多个地址用逗号分隔。
可选参数包括： --from：指定发件地址，用于 send-as/别名场景；省略则使用账户默认地址。 --body：在转发内容上方附加的可选说明，默认按纯文本处理，配合 --html 时按 HTML 处理。 --no-original-attachments：不包含原始邮件的文件附件；在 --html 模式下，内联图片仍会保留。 --attach：附加额外文件，可多次指定。 --cc：抄送地址，多个用逗号分隔。 --bcc：密送地址，多个用逗号分隔。 --html：将 --body 视为 HTML 内容（默认为纯文本）。 --dry-run：仅展示将要发送的请求而不实际执行。 --draft：保存为草稿而非直接发送。
三、前置条件 使用前需阅读 ../gws-shared/SKILL.md，以了解认证、全局标志和安全规则；如果该文件缺失，需运行 gws generate-skills 生成。
四、行为细节与提示 转发内容会包含原始邮件的发件人、日期、主题和收件人。 原始附件默认包含，与 Gmail 网页端行为一致。 在 --html 模式下，内联图片会通过 cid: 引用保留。 在纯文本模式下，内联图片不会被包含，与 Gmail 网页端一致。 可通过 --no-original-attachments 在转发时不带原始邮件的文件。 可通过 -a/--attach 添加额外附件，可多次指定。 原始附件与用户附加文件的合计大小限制为 25MB。 在 --html 模式下，转发块使用 Gmail 的 gmail_quote CSS 类并保留 HTML 格式；可使用片段标签（如 、 、 等），无需 / 包裹。 可使用 --draft 将转发保存为草稿，而不是立即发送。
五、示例 gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body 'FYI see below' gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --cc eve@example.com gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '<p>FYI</p>' --html gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com -a notes.pdf gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --no-original-attachments gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --draft
六、参见 相关命令包括 gws-shared（全局标志与认证）和 gws-gmail（所有发送、阅读和管理邮件的命令）。