核心功能
gws-gmail-triage 是一款 Gmail 收件箱快速预览工具，专为需要高效处理邮件洪流但不愿被打断的用户设计。它通过命令行界面以只读方式提取未读邮件的关键元数据（发件人、主题、接收日期），默认展示最近 20 封未读邮件，支持自定义查询条件和输出格式。
显著优点
1. 零干扰预览：纯只读操作，绝不修改、标记或删除任何邮件，彻底消除误操作风险
2. 灵活筛选：支持原生 Gmail 搜索语法（如 from:boss），可精准定位特定来源或主题的邮件
3. 格式友好：默认表格输出清晰易读，同时支持 JSON 格式便于管道处理（jq 等工具链集成）
4. 轻量高效：命令行交互秒级响应，适合在终端工作流中快速穿插邮件检查
局限性与注意事项
- 功能边界：仅提供元数据摘要，无法阅读邮件正文，需配合其他工具完整处理邮件
- 依赖外部服务：需预先配置
gws认证体系，离线环境下不可用 - 隐私合规：邮件主题可能包含敏感信息，建议在受控终端环境使用，避免输出重定向到共享日志
适合人群
- 终端重度用户与开发者，习惯命令行工作流
- 需要批量监控邮件状态但不立即处理的管理者
- 自动化脚本编写者，需将邮件状态纳入 CI/CD 或监控体系
风险评估
本工具设计为只读最小权限，理论安全风险极低。但需注意：
- OAuth 令牌管理遵循
gws-shared安全规范 - 敏感邮件主题可能在终端历史或进程列表中残留
- 建议定期审查
gws授权范围，遵循最小权限原则