AI 驱动的晨间邮件日程管家

基于 Google Gemini AI 的每日邮件与日程智能摘要工具，自动整合 Gmail 重要邮件和 Google Calendar 事件，通过 Telegram 推送结构化晨报，提升信息处理效率。

基本信息

• 技能名称?morning-email-rollup
• 中文名称?AI 驱动的晨间邮件日程管家
• 作者?am-will
• 分类?办公
• 版本?v2.1.0
• 标签?productivity, automation, content-media, api, office

使用方法

使用说明
核心用法
Morning Email Rollup 是一款自动化晨间信息聚合工具，专为需要高效处理大量邮件和日程的职场人士设计。该技能每日定时（默认早8点）执行以下流程：首先通过 gog CLI 查询 Google Calendar 获取当日日程，同时搜索 Gmail 中标记为重要或星标的近24小时邮件；随后利用 Google Gemini AI（ gemini-2.0-flash 模型）为每封邮件生成一句话自然语言摘要；最终将日历事件与邮件摘要格式化为易读的 Telegram 消息，包含红绿圆点标识已读/未读状态。
用户可通过环境变量 GOG_ACCOUNT 配置 Gmail 账户，支持手动运行或设置 cron 定时任务。默认展示10封邮件，可通过 MAX_EMAILS 参数调整数量，搜索条件、摘要风格、AI 模型均可自定义修改。
显著优点

1. AI 驱动的智能摘要 ：不同于简单的内容截取，Gemini 生成的摘要具备语义理解能力，能提炼邮件核心意图，大幅降低信息过载。
2. 多源信息整合 ：首创性地将邮件与日历事件统一呈现，帮助用户在单一界面掌握当日待办与通信重点，避免多应用切换。
3. 优雅的降级机制 ：当 gog 未安装、日历无事件或 Gemini 不可用时，系统静默跳过对应模块而非报错，确保核心功能可用性。
4. 高度可定制 ：从搜索语法（支持 Gmail 高级搜索操作符）、摘要长度到 cron 时区，几乎每个环节都开放给用户调整。
5. 安全编码实践 ：使用 mktemp 管理临时文件、正则验证邮件 ID、限制输入长度、完善的错误处理，体现良好的 Shell 脚本工程素养。
   潜在缺点与局限性
6. Google 生态依赖 ：必须使用 Gmail 和 Google Calendar，对使用 Outlook、企业自建邮箱或注重隐私替代方案的用户不适用。
7. AI 摘要的隐私权衡 ：邮件内容需发送至 Google Gemini API 处理，虽经匿名化处理但仍存在数据出境风险，金融、医疗等敏感行业需谨慎评估。
8. Telegram 推送限制 ：输出渠道绑定 Telegram，若用户偏好邮件、Slack 或企业微信等其他平台，需自行修改脚本适配。
9. 重要性判断依赖 Gmail 算法 ："重要"标签由 Gmail 自动判定，可能存在误判或漏判，需用户手动星标补充。
10. 无多账户支持 ：当前仅支持单一 Google 账户，职场人士常用的多邮箱（工作+个人）场景需部署多个实例。
    适合的目标群体
    高管与管理者 ：需快速掌握团队动态和会议安排，无时间逐封阅读邮件
    销售与客户成功 ：跟进大量客户沟通，需识别高优先级商机邮件
    远程工作者 ：跨时区协作导致邮件堆积，需晨间快速同步状态
    效率工具爱好者 ：追求 Inbox Zero 理念，希望自动化信息筛选流程
    Google Workspace 重度用户 ：已深度使用 Gmail、Calendar 生态，寻求增强体验
    使用风险
    API 配额与成本 ：Gemini API 存在调用限制，超量可能产生费用或降级为无摘要模式
    依赖项维护 ： gog 和 gemini CLI 工具需独立安装更新，版本不兼容可能导致功能异常
    时区配置错误 ：cron 时区设置不当会导致推送时间错位，影响晨间使用习惯
    OAuth 令牌失效 ：Google 账户认证过期后需重新授权，期间服务中断
    日志文件膨胀 ：长期运行后 $HOME/clawd/morning-email-rollup-log.md 可能累积过大，建议定期清理