核心用法
gws gmail +triage 是一款命令行 Gmail 收件箱速览工具，专为需要快速掌握未读邮件动态的用户设计。执行后默认以表格形式展示发件人、主题和日期三要素，默认拉取最近 20 封未读邮件。
功能亮点
- 精准筛选：支持
--query参数传入完整 Gmail 搜索语法（如from:boss、subject:urgent），实现按需过滤；--max可限制返回数量，避免信息过载。 - 格式灵活：除默认表格外，可通过
--format json输出结构化数据，便于管道化后续处理（如配合jq提取特定字段）。 - 标签可视：
--labels开关可在输出中附加邮件标签，方便快速识别邮件分类。
显著优点
1. 零侵入只读设计：明确声明“Read-only — never modifies your mailbox”，从根本上杜绝误删、误标记风险，适合高频快速查阅场景。
2. CLI 原生体验：与 gws 生态深度整合，熟悉命令行工具的用户可无缝融入现有工作流，支持管道和脚本自动化。
3. 依赖成熟 OAuth：认证层复用 gws-shared 的统一凭证体系，避免重复授权，降低令牌泄露风险。
潜在局限
- 功能边界清晰：仅提供摘要浏览，不支持直接回复、归档或删除操作，需跳转至 Gmail 网页或客户端完成后续处理。
- 输出格式依赖终端：表格渲染效果受终端宽度限制，超长主题或被截断；JSON 模式需用户具备基础解析能力。
- 网络依赖：实时调用 Gmail API，离线环境不可用，且受 Google API 配额与速率限制影响。
适合人群
- 需要批量快速扫描未读邮件的开发者、运维人员
- 偏好终端工作流、追求效率的 CLI 重度用户
- 希望将邮件监控集成到自动化脚本或定时任务的技术团队
常规风险
- OAuth 令牌管理：凭证由
gws-shared统一托管，需确保~/.config/gws目录权限正确（建议 0700），防止本地凭证泄露。 - 查询语法误用：Gmail 搜索表达式若构造不当（如过度宽泛的
from:*）可能返回大量结果，消耗 API 配额并影响性能。 - 隐私暴露：终端历史或日志可能留存邮件主题等敏感信息，建议在共享环境或 CI/CD 中配合
--format json定向输出至安全位置。