Gmail Checker 📧

获取未读 Gmail 邮件，过滤干扰信息，提供优先级排序的摘要。

为什么需要它

你的收件箱充斥着自动化邮件、促销信息和系统通知。本技能仅提取真正重要的内容——安全告警、个人通信，以及你手动标记为“重要”的任何邮件。

适用场景

• “检查我的邮件”
• “有新邮件吗？”
• “给我一份邮件摘要”
• “我收件箱里有什么？”
• “邮件汇总”

配置方法

首次使用的用户需配置 Google OAuth 凭据。若脚本因“文件缺失”错误退出，请查阅 references/setup.md，并引导用户完成配置流程。

pip install google-api-python-client google-auth-oauthlib

运行方式

python3 scripts/check_gmail.py [hours]          # 默认：过去 24 小时
python3 scripts/check_gmail.py --json [hours]   # 输出结构化 JSON 格式

配置说明：将 config.example.json 复制为 /gmail-config.json 并按需修改。当凭据缺失时，脚本会打印当前解析出的 路径。

数据目录

凭据与配置文件路径解析规则如下：

1. $SKILL_DATA_DIR（由 agent 平台设置）
2. ~/.config/gmail-checker/（默认回退路径）

任意平台均可通过设置环境变量 $SKILL_DATA_DIR 指定其偏好的凭据存储位置。若未设置，则自动使用 ~/.config/gmail-checker/。该机制兼容 OpenClaw、Claude Code、Codex，以及任何支持运行 Python 脚本的 agent。

优先级规则

🔴 高优先级 → 发件人域名或邮件主题匹配你在配置中定义的规则
🟡 中优先级 → Gmail 自动标记为“个人”的邮件
🟢 低优先级 → 其余所有邮件（仍在收件箱中且未读）

完全过滤掉的类别：
• CATEGORY_PROMOTIONS
• CATEGORY_UPDATES
• CATEGORY_FORUMS
• CATEGORY_SOCIAL

可在 gmail-config.json 中自定义优先级规则：

high_priority_domains:   ["stripe.com", "github.com"]
high_priority_keywords:  ["security", "urgent", "billing"]

输出示例

未读收件箱（过去 24 小时）

🔴 高优先级
  安全告警：来自未知设备的新登录
  发件人：Google 

🟡 中优先级
  回复：周五一起吃饭？
  发件人：Sarah 

🟢 低优先级
  你的 GitHub 周度摘要
  发件人：GitHub 

共 3 封未读邮件

请根据当前通信渠道适配输出格式（例如加粗、项目符号等）。

推荐集成方式

cron: 0 8 * * * → python3 scripts/check_gmail.py