用途：通过命令行与用户 Gmail 交互，完成搜索、阅读会话、撰写草稿、发送、回复、转发、退订邮件列表、管理标签及下载附件等任务，所有操作以 hatch_gws_cli gmail <command> 执行。
主要能力：命令分两类。快捷命令如 +send、+read、+unsubscribe，是首选简单形式；原始 API 调用把带点方法名写作空格分隔单词，参数放 --params（含 "userId":"me"），写入内容放 --json。原始调用可覆盖草稿、标签、会话、历史及休假回复、转发、send-as 等设置，可用 --help 逐层查看资源与方法，再用 hatch_gws_cli schema gmail.<method> 查参数。
连接与账号：需一次性连接，先运行 hatch_gws_cli gmail status，未连接时按其返回的 connect_url 让用户连接；新增账号用 add_account_url，断开用 disconnect_url。多账号可用 hatch_gws_cli gmail accounts 列出并加 --account <account_id>。
常用流程：+triage 搜索候选（+search 不存在），+read 读单条，users threads get 读整个会话，users messages attachments get 下载附件并自行解码 base64url 到输出路径（--output 不写文件）。统计数量优先读标签计数器，注意 resultSizeEstimate 仅为估算。写发邮件先写完整邮件文件并用 --upload 传绝对路径；+send、+reply、+forward、+draft 支持 --to/--cc/--bcc、--html、--attach，主题正文建议单引号包裹。
限制与规则：请勿创建、编辑或删除 Gmail 过滤器；发送、回复、转发必须展示准确收件人、主题与正文并获明确许可；退订仅支持特定 RFC 8058 与对齐 DKIM/DMARC 条件，不用浏览器或 mailto 等回退，也不自动重试。存在按账号加权请求预算，命令应串行、先小 --max、只取相关正文，遇 connector_rate_limited 且 terminal_for_attempt 为真即停止并报告。回复用户时用平实语言，不暴露命令、查询、标签名、API 字段或各类 id。