用途：通过命令行与用户的 Gmail 交互，完成搜索、读取会话、撰写草稿、发送、回复、转发、退订邮件列表、管理标签及访问附件等任务。所有操作以 hatch_gws_cli gmail <command> 形式运行。
主要能力：命令分两类。快捷键（如 +send、+read、+unsubscribe）是首选简单形式；原始 API 调用把点号方法名写成空格分隔的单词，例如 users.messages.list 写成 users messages list，参数用 --params 传 JSON（连接邮箱用 "userId":"me"），写入内容用 --json 作为请求体。原始调用可触达快捷键之外的 drafts、labels、threads、history 等。用 --help 逐层查找方法，hatch_gws_cli schema gmail.<method> 查看参数。
常用流程：搜索用 +triage --query '<query>' --max 50 --format json 列出候选；读取用 +read --id <message_id>。每个 +read 会在 ~/workspace/email/gmail/ 保存 Markdown 副本并返回路径。撰写与发送用 +send、+reply、+reply-all、+forward、+draft，发送前需用户批准确切文本。退订用 +unsubscribe --message-id <id>。整理用 +mark、+archive、+trash。
连接与账号：首次使用先运行 hatch_gws_cli gmail status，未连接时按返回的 connect_url 让用户连接，不要自行编造 URL 或索要凭据。多账号时用 --account <account_id> 指定，默认使用默认账号。权限不足时按 --for-command 流程获取附加访问链接。
限制与注意：不得创建、编辑或删除 Gmail 过滤器，也不得访问或更改 Gmail 设置（休假回复、转发、IMAP、POP、语言、委托、send-as 身份、客户端加密等）。Gmail 有按账号的加权请求预算，命令须顺序执行，合并重复搜索，先用较小 --max。遇到 connector_rate_limited 且 terminal_for_attempt 为 true 时，应停止本次 Gmail 工作并报告进度，不要重试或安排替代任务。持久删除（messages.delete、messages.batchDelete、drafts.delete）不可撤销，应使用可恢复的 +trash。原始 Date 字段与内部时间戳仅为传输时间，不能推断邮件中所述事件的发生时间。对用户输出应使用日常语言，不暴露命令、查询、标签名、字段名或各类 ID。其余平台、收费或价格信息暂未提供。