用途:在 gws-cli 中转发 Gmail 邮件给新收件人。使用前需先阅读 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则;若缺失可运行 gws generate-skills 生成。
基本用法:gws gmail +forward --message-id <ID> --to <EMAILS>。--message-id 与 --to 为必填,后者为逗号分隔的收件人地址。
主要能力:默认会包含原邮件的发件人、日期、主题和收件人信息,并默认附带原邮件附件(与 Gmail 网页行为一致)。可用 --from 指定发件地址(send-as/别名),--body 添加转发上方的附言,--html 将 --body 视为 HTML(此时内联图片通过 cid: 引用保留,转发块使用 Gmail 的 gmail_quote CSS 类并保留 HTML 格式,使用片段标签即可,无需外层包裹)。--cc、--bcc 添加抄送和密送。--no-original-attachments 可去掉原邮件附件(HTML 模式下内联图片仍保留)。-a/--attach 可多次指定以添加额外附件。--draft 保存为草稿而非立即发送,--dry-run 仅显示将发送的请求而不执行。
限制:原邮件附件与用户附件的合计大小上限为 25MB。纯文本模式下不包含内联图片(与 Gmail 网页一致)。
示例:gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com;加 --body 'FYI see below';加 --cc eve@example.com;加 --body '<p>FYI</p>' --html;加 -a notes.pdf;加 --no-original-attachments;加 --draft。