gmail-skill

核心用法

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，若误配置可能导致邮件统计信息泄露至错误接收者。