Gmail自动化管理工具，支持后台清理、标签归档与批量整理，配备双重确认机制，显著提升收件箱管理效率。
说明：
## 核心用法
Gmail Skill 提供七项核心能力构建完整的邮件自动化工作流。**收件箱摘要**支持默认收件箱或全量未读查询，以TSV格式返回邮件元数据并智能分组展示；**标签结构分析**通过后台任务生成树状视图，展示层级关系与未读统计；**垃圾与废纸篓清理**采用后台守护进程执行，结合WhatsApp每30秒推送进度直至完成；**邮件归档**严格遵循”仅操作收件箱”原则，通过四步交互流程（搜索标签→列出邮件→确认移动→提供撤销）确保精准归档；**标签删除**与**旧邮件清理**作为破坏性操作，强制要求用户输入`DELETE`确认，并区分”移至垃圾箱”与”永久删除”两种模式；**全范围授权**为可选步骤，一次性配置后即可启用永久删除能力。
## 显著优点
该技能采用**后台任务架构**，利用`nohup`与`disown`实现守护进程化，彻底规避AI助手超时中断风险，特别适合处理大批量邮件清理；**渐进式权限设计**体现安全最佳实践，默认仅申请`gmail.modify`范围（读取、修改、删除至垃圾箱），永久删除需额外运行授权脚本获取`https://mail.google.com/`权限，降低误操作不可逆风险；**交互安全机制**极为严格，所有批量移动、标签删除、日期筛选删除均需用户明确选择对象并输入确认指令，且支持撤销操作；**可视化反馈**通过WhatsApp推送实时进度，解决后台任务”黑盒”焦虑；**参数验证**覆盖日期格式、消息ID、标签存在性等边界条件，杜绝无效操作。
## 潜在缺点与局限性
**依赖栈复杂**，需预装`gog` CLI工具（npm）、Python 3、jq及Google API客户端库，增加了部署门槛；**来源可信度限制**，作为T3级个人开发者作品，虽通过A级安全认证，但仍需用户自行审查代码，不适合对供应链安全有极致要求的企业环境；**交互模式局限**，后台任务虽解决超时问题，但导致用户无法实时干预或查看中间结果，仅能通过WhatsApp接收异步通知；**日期格式僵化**，仅支持MM/DD/YYYY美式日期格式，对国际用户不够友好；**平台锁定**，仅支持Gmail，不兼容Outlook等其他邮件服务。
## 适合的目标群体
适用于**Gmail重度依赖者**（日均接收50+邮件的商务人士）、**合规归档需求者**（需定期清理历史邮件以满足GDPR或公司政策）、**运营与客服团队**（管理大量通知类邮件与工单标签）、**个人数字整理爱好者**（追求Inbox Zero效率方法论）。尤其适合需要定期执行重复性清理任务（如每周清理促销邮件、每月归档项目文件）的用户，通过后台自动化显著降低手动管理的时间成本。
## 使用风险
**授权范围风险**：全范围OAuth令牌存储于本地`~/.gmail-skill/`，虽采用标准文件权限保护，但仍需防范本地权限提升攻击；**误操作残余风险**：尽管有双重确认，用户仍可能在疲劳状态下确认删除重要邮件，且永久删除模式下无回收站恢复可能；**依赖项失效风险**：`gog`工具为第三方npm包，若维护者停止更新或API变更，可能导致技能部分功能失效；**后台任务隐蔽故障**：若`gmail-background-task.sh`因系统资源不足崩溃，可能留下僵尸进程或状态不一致，需定期使用`gmail-bg-status.sh`检查；**隐私侧信道**：WhatsApp通知功能需配置`WHATSAPP_NOTIFY_TARGET`，若误配置可能导致邮件统计信息泄露至错误接收者。
会员专属
