Morning Email Rollup

核心用法

morning-email-rollup 是一款自动化日程管理工具，每日定时扫描用户 Gmail 账户中标记为重要或星标的邮件，同时抓取 Google Calendar 当日事件，生成结构化摘要并通过 Telegram 推送。用户可通过环境变量 GOG_ACCOUNT 配置邮箱，支持手动触发或 cron 定时任务（默认 8:00 AM 丹佛时间）。

显著优点

• 零配置即用的智能筛选：自动识别 Gmail 重要标记和星标邮件，无需手动维护规则
• 双源信息整合：邮件与日历事件一站式呈现，减少多应用切换
• 高度可定制：支持修改邮件数量上限（MAX_EMAILS）、搜索语法（如限定发件人、标签）、推送时间和时区
• 优雅降级：gog 未安装或无日历时自动跳过，不中断主流程
• 完整日志追溯：所有运行记录保存至本地 Markdown 文件，便于排查

潜在缺点与局限

• 依赖外部 CLI 工具：核心功能依赖 gog（非标准组件），需单独安装认证
• 仅支持 Gmail：Outlook、企业 Exchange 等邮箱无法直接使用
• Telegram 推送依赖：未内置备用通知渠道，若消息服务中断则无法接收
• 时区硬编码风险：默认丹佛时间，跨时区用户需主动修改 cron 配置
• 隐私集中化：邮件摘要通过 Telegram 传输，对极度敏感场景存在顾虑

适合人群

• 重度 Gmail + Google Calendar 用户
• 希望通过单一渠道（Telegram）快速掌握每日待办与重要信息的效率型用户
• 具备基础 shell 环境配置能力的技术人员

常规风险

• 凭证泄露：GOG_ACCOUNT 环境变量或脚本硬编码邮箱可能被其他进程读取
• Token 过期：gog 的 OAuth Token 需定期刷新，失效后静默失败
• 信息过载：若重要邮件判定规则宽松，可能导致摘要冗长失去价值

核心用法

Morning Email Rollup 是一个自动化日常信息聚合工具，通过 cron 定时任务在每日上午 8 点（丹佛时区，可自定义）执行以下操作：

1. 获取今日日程：通过 gog CLI 查询 Google Calendar，列出当天所有事件
2. 筛选重要邮件：搜索过去 24 小时内被标记为 Important（重要）或 Starred（星标）的邮件
3. 生成格式化摘要：最多展示 20 封邮件，包含发件人、主题、接收时间、未读状态指示（🔴）及 150 字符预览
4. 推送至 Telegram：通过 Clawdbot 消息系统将汇总结果送达用户

支持手动运行测试，可通过 MAX_EMAILS 环境变量临时调整邮件数量，所有执行记录保存至 $HOME/clawd/morning-email-rollup-log.md。

---

显著优点

| 维度 | 优势 |

|------|------|

零代码配置 | 纯 Bash 实现，仅需设置 GOG_ACCOUNT 环境变量即可运行 |
智能筛选 | 利用 Gmail 原生重要性标记，无需手动维护规则 |
优雅降级 | 日历模块在 gog 缺失或无当日事件时静默跳过，不中断主流程 |
高度可定制 | 支持修改搜索语法（如限定发件人、标签组合）、调整时区与时间、变更输出数量 |
安全合规 | 无敏感信息硬编码，依赖 Google 官方 API 通道，日志仅含元数据 |

---

潜在缺点与局限性

外部工具依赖链

• 必须预装 gog（Google API CLI）和 jq（JSON 解析器），且 gog 需独立完成 OAuth 认证流程
• gog 作为非 Google 官方维护的第三方工具，其长期维护状态存在不确定性

功能边界

• 不支持附件内容检索、邮件正文全文搜索、多账户聚合
• 邮件预览固定截断 150 字符，无法折叠展开
• Telegram 为唯一推送渠道，无邮件/Slack/Webhook 替代方案

配置风险

• 默认 GOG_ACCOUNT 占位符 "your-email@gmail.com" 若未被覆盖，脚本不会报错但无法获取数据
• 日志文件默认权限未限制，存在多用户系统下的信息泄露风险

---

适合人群

• Gmail 重度用户：收件箱日均 50+ 封，依赖重要性标记管理优先级的职场人士
• 远程工作者：需要跨时区掌握日程与紧急邮件，早晨快速进入工作状态
• Telegram 生态使用者：已在 Clawdbot 或其他 Telegram 自动化流程中建立工作流
• 隐私敏感型用户：倾向于本地脚本处理邮件元数据，而非 SaaS 服务托管完整内容

---

常规风险

| 风险类别 | 具体描述 | 缓解建议 |

|----------|----------|----------|

依赖可用性 | gog 工具若停止维护或 API 变更，将导致功能失效 | 关注 gog 仓库更新，考虑 fork 或替代方案储备 |
日志泄露 | 日志文件含邮件数量、处理时间等元数据，默认权限宽松 | 手动执行 chmod 600 限制访问，或定期清理 |
OAuth 令牌 | gog 管理的 Google 认证令牌存储位置与权限不透明 | 审计 ~/.config/gog 或等效目录的访问控制 |
时区配置 | cron 时区字符串错误可能导致推送时间偏离预期 | 使用 IANA 标准时区名（如 Asia/Shanghai），验证 cron runs 输出 |

整体而言，该工具适合技术背景用户作为个人效率增强脚本部署，不建议用于企业级多账户场景或处理高度敏感商业通信。