用途：读取指定 Gmail 邮件并提取其正文或邮件头，属于 streakyc/googleworkspacecli 下的 gws-gmail 读取命令。
主要能力：根据邮件 ID 读取单封邮件；可用 --headers 在输出中包含 From、To、Subject、Date 等邮件头；--format 可选 text（默认）或 json；--html 返回 HTML 正文而非纯文本；--dry-run 仅显示将发送的请求而不执行。该工具会自动将仅含 HTML 的邮件转换为纯文本，并处理 multipart/alternative 与 base64 解码。
使用方式：基本命令为 gws gmail +read --id <ID>。示例：gws gmail +read --id 18f1a2b3c4d；带邮件头时加 --headers；需要 JSON 时可用 --format json 并通过 jq 取 .body。使用前需先阅读 ../gws-shared/SKILL.md 了解认证、全局标志与安全规则，若该文件缺失，运行 gws generate-skills 生成。
适用场景：需要从 Gmail 中按 ID 提取单封邮件内容、邮件头或将正文用于后续脚本处理时。
限制：必须提供有效的邮件 ID；认证与安全规则依赖 gws-shared 说明，资料未提供具体认证细节；其余未提及的行为、配额或平台限制暂未提供。