SuperAPI AI 工具集

gws-gmail-reply-all

办公与效率

查看项目

更新于 10-16 09:38

技能介绍

gws-gmail-reply-all 是 Google Workspace CLI(gws)提供的 Gmail 子命令,用于对一封邮件执行“回复全部”,并自动处理邮件会话线程。

用途 该命令面向需要在命令行中批量或脚本化处理 Gmail 回复的场景,可对指定邮件 ID 回复发件人及所有原始 To/CC 收件人,并自动维护线程关系。

前置条件 使用前需阅读 ../gws-shared/SKILL.md,了解认证方式、全局参数与安全规则。若该文件缺失,可运行 gws generate-skills 生成。

主要能力

  • 回复全部:回复发件人以及所有原始 To/CC 收件人。
  • 线程处理:自动处理邮件会话线程。
  • 收件人调整:通过 --to 增加 To 收件人,通过 --cc 增加抄送,通过 --bcc 添加密送,通过 --remove 排除指定收件人(包括发件人或 Reply-To 目标)。若排除并新增后没有剩余 To 收件人,命令会失败。
  • 发件地址:通过 --from 指定发件地址,用于 send-as/别名;省略则使用账户默认值。
  • 正文格式:--body 原样使用,默认纯文本;配合 --html 时按 HTML 内容处理。使用 --html 时,引用块使用 Gmail 的 gmail_quote CSS 类并保留 HTML 格式,可使用片段标签,无需外层包装;引用消息中的内联图片通过 cid: 引用保留。
  • 附件:通过 -a/--attach 添加文件附件,可多次指定。
  • 草稿与预览:通过 --draft 保存为草稿而不立即发送;通过 --dry-run 显示将要发送的请求而不实际执行。

使用方式 基本用法: gws gmail +reply-all --message-id <ID> --body <TEXT>

参数说明:

  • --message-id(必填):要回复的 Gmail 邮件 ID。
  • --body(必填):回复正文,原样使用(纯文本,或配合 --html 时为 HTML)。注意 \n 不是换行符,需使用 $'...' 或真实换行。
  • --from:发件地址(用于 send-as/别名;省略则使用账户默认)。
  • --to:额外的 To 收件人,逗号分隔。
  • --attach:附件文件,可多次指定。
  • --cc:CC 收件人,逗号分隔。
  • --bcc:BCC 收件人,逗号分隔。
  • --html:将 --body 视为 HTML 内容(默认为纯文本)。
  • --dry-run:显示将要发送的请求而不执行。
  • --draft:保存为草稿而非发送。
  • --remove:从发出的回复中排除收件人(逗号分隔的邮箱)。

示例: gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Sounds good to me!' gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Updated' --remove bob@example.com gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Adding Eve' --cc eve@example.com gws gmail +reply-all --message-id 18f1a2b3c4d --body '<i>Noted</i>' --html gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Notes attached' -a notes.pdf gws gmail +reply-all --message-id 18f1a2b3c4d --body 'Draft reply' --draft 多行正文($'...' 引用将 \n 转为真实换行): gws gmail +reply-all --message-id 18f1a2b3c4d --body $'Hi all,\n\nConfirmed for Tuesday.\n\nBlake' 长正文(从文件读取而非内联引用): gws gmail +reply-all --message-id 18f1a2b3c4d --body "$(cat reply.txt)"

注意事项

  • --body 为原样使用:写成 --body "Hi,\n\nThanks" 会把字面反斜杠 n 发送给收件人,不会产生换行;应使用 $'Hi,\n\nThanks' 或 "$(cat file.txt)"。
  • 回复对象为发件人及所有原始 To/CC 收件人。
  • 使用 --remove 排除收件人后,若没有剩余 To 收件人,命令会失败。
  • 使用 --html 时,引用块使用 Gmail 的 gmail_quote CSS 类并保留 HTML 格式;内联图片通过 cid: 引用保留。

相关命令 gws-shared:全局参数与认证。 gws-gmail:所有发送、读取和管理邮件的命令。