核心用法
gws gmail +triage 是一款命令行邮件速览工具，专为高效处理 Gmail 收件箱设计。执行后自动抓取未读邮件，默认以表格形式输出发件人、主题和日期三列关键信息，帮助用户在终端快速掌握邮件动态。
显著优点
- 零配置开箱即用：默认读取未读邮件，无需记忆复杂查询语法
- 灵活筛选能力：支持
--query参数接入完整 Gmail 搜索语法（如from:boss、is:important），可按发件人、标签、时间范围精准定位 - 输出可控：
--max限制返回数量避免信息过载，--format json便于管道化处理（如配合jq二次筛选） - 只读安全设计：明确声明 read-only 特性，调用 Google API 时仅限读取权限，从机制上杜绝误删/误发风险
- 标签可视化：
--labels开关可在输出中展示邮件标签，辅助快速分类判断
潜在局限
- 功能边界清晰：仅提供摘要浏览，不支持邮件内容预览、附件查看或批量操作，重度用户需配合其他工具
- 依赖外部生态：需预先安装
gws主程序并完成 OAuth 授权，首次配置存在门槛 - 终端体验限制：纯文本输出在邮件量大时阅读效率低于图形界面，且不支持 HTML 邮件渲染
- 网络依赖：实时调用 Gmail API，离线场景不可用
适合人群
- 命令行重度用户、开发者、运维人员
- 需要快速扫描邮件标题判断是否紧急的「收件箱零清理」实践者
- 希望将邮件处理纳入自动化脚本（如定时日报生成）的技术用户
常规风险
- OAuth 令牌管理：需遵循
gws-shared的安全规范存储凭据，避免令牌泄露导致邮箱被爬取 - API 配额限制：高频调用可能触发 Gmail API 速率限制，大规模批量操作建议添加延迟
- 隐私数据暴露：终端输出可能包含敏感邮件主题，共享屏幕或日志收集时需注意脱敏