SuperAPI AI 工具集

gws-gmail-send

办公与效率

查看项目

更新于 10-14 11:49

技能介绍

gws-gmail-send 是 googleworkspace/cli 下的一个技能,专注于通过命令行发送 Gmail 邮件或保存为草稿。

用途:提供 gws gmail +send 命令,用于发送电子邮件;可通过 --draft 参数改为保存草稿而不立即发送。

主要能力:

  • 必填参数:--to(收件人,逗号分隔)、--subject(主题)、--body(正文,默认纯文本,配合 --html 时作为 HTML)。
  • 可选参数:--from(发件地址,用于 send-as/别名,省略则使用账户默认)、--attach(附件,可多次指定,总大小限制 25MB)、--cc(抄送,逗号分隔)、--bcc(密送,逗号分隔)、--html(将 --body 视为 HTML 内容)、--dry-run(仅显示将要发送的请求而不执行)、--draft(保存为草稿)。
  • 自动处理 RFC 5322 格式、MIME 编码和 base64。
  • 使用 --html 时可使用片段标签(如粗体等),无需 / 包裹。

使用方式: 前置条件:读取 ../gws-shared/SKILL.md 了解认证、全局标志和安全规则;若缺失,运行 gws generate-skills 创建。 命令格式:gws gmail +send --to <EMAILS> --subject <SUBJECT> --body <TEXT> 示例:

  • gws gmail +send --to alice@example.com --subject 'Hello' --body 'Hi Alice!'
  • 添加抄送:--cc bob@example.com
  • 发送 HTML:--body '<b>Bold</b> text' --html
  • 指定发件别名:--from alias@example.com
  • 添加附件:-a report.pdf
  • 多个附件:-a a.pdf -a b.csv
  • 保存草稿:--draft

适用场景:需要通过命令行快速发送邮件、带附件邮件、HTML 邮件,或先存为草稿再确认的场景。

限制与注意事项:

  • 附件总大小限制为 25MB。
  • 这是写命令,执行前需与用户确认。
  • --from 需要已配置的 send-as 别名。
  • 认证和全局标志依赖 gws-shared 文档。

相关:gws-shared 提供全局标志和认证;gws-gmail 涵盖所有发送、读取和管理邮件的命令。