核心用法
Gmail Inbox Zero Triage 是一款面向 Telegram 的交互式邮件管理工具，旨在帮助用户高效清空 Gmail 收件箱。该技能通过 gog CLI 实现 OAuth 安全认证，无需存储用户密码。核心工作流包括：
1. 批量获取：一次性拉取收件箱中全部邮件（每次最多 20 封）
2. AI 摘要：为每封邮件生成一行关键信息摘要
3. 交互式决策：通过 Telegram 内联按钮提供四种操作——归档、创建过滤器、退订、查看全文
4. 批量执行：用户决策先进入本地队列，点击「完成」后一次性执行，避免逐封等待 API 响应
脚本体系由 gog_processor.py（Gmail 操作）、queue_manager.py（队列管理）、execute_queue.py（批量执行）三层组成，队列数据以 JSON 临时存储于本地。
显著优点
- 零密码设计：纯 OAuth 认证，凭据由系统钥匙串托管，安全性优于密码方案
- 效率优化：批量队列机制将多次 API 调用压缩为单次执行，处理 10-20 封邮件可在 1 分钟内完成
- 决策辅助：AI 摘要有效降低认知负荷，尤其适用于大量促销邮件、通知类邮件的快速分类
- 灵活操作：过滤器创建与退订功能直指「收件箱泛滥」根源，长期维护成本低
潜在局限
- 依赖外部 CLI：必须预装并配置
gog工具，增加前置门槛 - 环境变量配置：需手动设置
GOG_KEYRING_PASSWORD，在部分系统上可能遇到钥匙串兼容性问题 - 摘要质量边界：AI 对复杂法律文件、多主题混合邮件的一行概括可能丢失关键细节
- 无撤回机制：批量执行后若误操作，需手动登录 Gmail 恢复
- 20 封批次限制：超大容量收件箱需多次交互，无法一次性处理
适合人群
- 日均收件量 50-200 封、追求「收件箱零」效率的商务用户
- 已使用 Telegram 作为主力通讯工具的技术爱好者
- 愿意接受 OAuth 授权模式、具备基础命令行操作能力的用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 权限范围 | `gog` 默认请求 Gmail 读写权限，用户应确认授权范围最小化 |
| 令牌安全 | OAuth token 存储于系统钥匙串，若主机失守则邮件数据暴露 |
| 队列持久化 | `action_queue.json` 明文存储于本地，多用户系统存在读取风险 |
| API 配额 | 频繁批量操作可能触发 Gmail API 速率限制 |
| 误操作成本 | 批量归档与过滤器创建影响不可逆，建议首次使用先小批量测试 |