用途
gws-gmail-send 是 gws-claude-plugin 提供的一个 Gmail 技能,用于通过命令行发送邮件。命令形式为 gws gmail +send。
前置条件
使用前需阅读 ../gws-shared/SKILL.md,了解认证方式、全局参数以及安全规则。如果该文件缺失,可运行 gws generate-skills 生成。
使用方式
基本用法:
gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT>
参数说明:
- --to(必填):收件人邮箱地址,多个地址用逗号分隔。
- --subject(必填):邮件主题。
- --body(必填):邮件正文,默认为纯文本;若使用 --html 则视为 HTML 内容。
- --cc:抄送邮箱地址,多个用逗号分隔。
- --bcc:密送邮箱地址,多个用逗号分隔。
- --html:将 --body 作为 HTML 内容处理(默认是纯文本)。
- --dry-run:仅展示将要发送的请求而不实际执行。
示例:
gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!' gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --cc bob@example.com gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi!' --bcc secret@example.com gws gmail +send --to alice@example.com --subject 'Hello' --body '<b>Bold</b> text' --html
主要能力与说明
该命令会自动处理 RFC 2822 格式化与 base64 编码。若需要发送附件,则使用原始 API:gws gmail users messages send --json '...'。
注意事项
这是写操作命令,执行前需与用户确认。
相关技能
- gws-shared:全局参数与认证。
- gws-gmail:所有发送、读取和管理邮件的命令。