用途
gws-gmail 是 gws-claude-plugin 提供的 Gmail 技能（版本 v1），用于在命令行环境中发送、阅读和管理电子邮件。它把 Gmail 的常用操作封装为 gws 命令，便于在脚本或自动化流程中调用。
前置条件
使用前需要先阅读 ../gws-shared/SKILL.md，其中包含认证方式、全局参数（global flags）和安全规则。如果该文件缺失，可运行 gws generate-skills 生成。
主要能力
命令基本形式为：
gws gmail <resource> <method> [flags]
辅助命令（Helper Commands）：
- +send：发送一封电子邮件。
- +triage：显示未读收件箱摘要，包含发件人、主题、日期。
- +reply：回复某封邮件，自动处理会话线程（threading）。
- +reply-all：回复全部，自动处理会话线程。
- +forward：将邮件转发给新的收件人。
- +watch：监听新邮件，并以 NDJSON 格式流式输出。
API 资源（API Resources）：
- users：getProfile（获取当前用户的 Gmail 配置信息）、stop（停止接收指定用户邮箱的推送通知）、watch（为指定用户邮箱设置或更新推送通知监听）。
- drafts：对 drafts 资源的操作。
- history：对 history 资源的操作。
- labels：对 labels 资源的操作。
- messages：对 messages 资源的操作。
- settings：对 settings 资源的操作。
- threads：对 threads 资源的操作。
使用方式
在调用任何 API 方法之前，建议先查看其定义：
浏览资源与方法
gws gmail --help
查看某个方法所需的参数、类型和默认值
gws schema gmail.<resource>.<method>
根据 gws schema 的输出，构造 --params 和 --json 参数。
适用场景
适合需要在命令行或自动化流程中处理 Gmail 邮件的场景，例如批量发送邮件、查看未读邮件摘要、按会话线程回复或转发、以及持续监听新邮件并流式处理。
限制
资料未提供关于收费、价格、平台支持范围、速率限制或具体效果的信息，暂未提供。使用前请以 gws-shared/SKILL.md 中的认证与安全规则为准。