Gmail智能收件箱自动化管家

Gmail自动化管理工具，支持后台清理、标签归档与批量整理，配备双重确认机制，显著提升收件箱管理效率。

基本信息

• 技能名称?gmail-skill
• 中文名称?Gmail智能收件箱自动化管家
• 作者?r39132
• 分类?专业技能
• 版本?v1.2.0
• 标签?productivity, office, automation, operations

使用方法

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