用途
gws-gmail-forward 是 gws-claude-plugin 提供的一个 Gmail 相关技能，用于将一封已有的 Gmail 邮件转发给新的收件人。
主要能力
- 按邮件 ID 转发指定邮件。
- 支持指定一个或多个收件人（逗号分隔）。
- 支持抄送（--cc）和密送（--bcc）。
- 支持指定发件地址（--from），用于 send-as/别名场景；省略时使用账户默认地址。
- 支持在转发内容上方附加一段说明文字（--body）。
- 支持以 HTML 方式发送（--html），此时转发块会套用 Gmail 样式，且 --body 按 HTML 处理。
- 支持 --dry-run，仅展示将要发送的请求而不实际执行。
- 转发内容会包含原邮件的发件人、日期、主题和收件人信息。
使用方式
前置条件：需先阅读 ../gws-shared/SKILL.md，了解认证、全局参数和安全规则；若该文件缺失，运行 gws generate-skills 生成。
基本用法：
gws gmail +forward --message-id <ID> --to <EMAILS>
参数说明：
- --message-id（必填）：要转发的 Gmail 邮件 ID。
- --to（必填）：收件人邮箱地址，多个用逗号分隔。
- --from：发件地址（用于 send-as/别名；省略则使用账户默认）。
- --cc：抄送邮箱地址，多个用逗号分隔。
- --bcc：密送邮箱地址，多个用逗号分隔。
- --body：可选说明文字，位于转发内容上方（纯文本，或配合 --html 作为 HTML）。
- --html：以 HTML 发送（转发块套用 Gmail 样式；--body 按 HTML 处理）。
- --dry-run：展示将要发送的请求而不执行。
示例：
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 --bcc secret@example.com gws gmail +forward --message-id 18f1a2b3c4d --to dave@example.com --body '<p>FYI</p>' --html
适用场景
适用于需要将某封 Gmail 邮件转交给其他收件人的场景，例如把邮件转发给同事并附上简短说明，或需要抄送、密送相关方时。
限制
- 使用前必须完成 gws-shared 中所述的认证与安全规则配置。
- 必须提供有效的 Gmail 邮件 ID 和收件人地址。
- 关于认证方式、全局参数、安全规则的具体细节，以及该技能的其他限制，资料中暂未提供。
相关
- gws-shared：全局参数与认证。
- gws-gmail：所有发送、读取和管理邮件的命令。