用途：读取指定 Gmail 邮件并提取其正文或头部信息，属于 gws-cli 的 Gmail 命令集。
主要能力：通过消息 ID 读取邮件；可用 --headers 在输出中包含 From、To、Subject、Date 等头部；--format 支持 text（默认）与 json；--html 返回 HTML 正文而非纯文本；--dry-run 仅展示将发送的请求而不执行。会自动把仅含 HTML 的邮件转换为纯文本，并处理 multipart/alternative 与 base64 解码。
使用方式：命令为 gws gmail +read --id <ID>，其中 --id 为必填的 Gmail 消息 ID。示例：gws gmail +read --id 18f1a2b3c4d；加 --headers 输出头部；配合 --format json 可管道给 jq 提取字段。
前置条件：需先阅读 ../gws-shared/SKILL.md 了解认证、全局标志与安全规则；若缺失，运行 gws generate-skills 生成。
适用场景：需要按 ID 获取邮件内容、做脚本化处理或查看邮件头部的场合。
限制：资料未提供认证细节、配额、权限范围及错误处理等信息。