用途
gws-gmail-triage 用于展示 Gmail 未读收件箱的汇总信息，输出内容包括发件人、主题和日期，帮助用户快速浏览未读邮件。
主要能力
- 以表格格式展示未读邮件汇总（默认输出格式）。
- 只读操作，永不修改邮箱内容。
- 支持通过 --max 限制显示邮件数量。
- 支持通过 --query 传入 Gmail 搜索查询。
- 支持通过 --labels 在输出中包含标签名称。
- 支持 --format json 输出，便于与其他工具（如 jq）组合处理。
使用方式
前置条件：阅读 ../gws-shared/SKILL.md 以获取认证、全局标志和安全规则。若该文件缺失，运行 gws generate-skills 生成。
基本用法：
gws gmail +triage
标志：
| 标志 | 必填 | 默认值 | 说明 |
|---|---|---|---|
| --max | — | 20 | 显示的最大邮件数量（默认：20） |
| --query | — | — | Gmail 搜索查询（默认：is:unread） |
| --labels | — | — | 在输出中包含标签名称 |
示例：
gws gmail +triage gws gmail +triage --max 5 --query 'from:boss' gws gmail +triage --format json | jq '.[].subject' gws gmail +triage --labels
适用场景
- 快速查看未读邮件概况。
- 按发件人或条件筛选未读邮件（例如 from:boss）。
- 将输出转为 JSON 后提取主题等字段进行进一步处理。
- 需要包含标签信息的未读邮件汇总。
限制
- 只读，不会修改邮箱。
- 默认输出格式为表格。
- 使用前需完成认证与全局配置（见 gws-shared）。
参见
- gws-shared — 全局标志与认证
- gws-gmail — 所有发送、读取和管理邮件命令
暂未提供
关于收费、价格、平台支持范围、具体认证方式与效果指标等信息，资料中暂未提供。