Morning Email Rollup

核心用法

Morning Email Rollup 是一款自动化信息聚合技能，每日定时（默认早8点 Denver 时区）抓取用户 Gmail 中标记为「重要」或「星标」的邮件，同时同步 Google Calendar 当日日程，整理为结构化摘要推送至 Telegram。

主要功能

• 智能邮件筛选：自动识别 is:important OR is:starred newer_than:1d 的邮件，最多展示 20 封
• 日历联动：通过 gog CLI 获取当日 Google Calendar 事件，12小时制友好展示
• Telegram 推送：格式化输出含未读标记🔴、发件人、主题、时间、预览片段的简报
• 灵活配置：支持调整邮件数量（MAX_EMAILS）、搜索条件、定时规则及时区

显著优点

1. 零配置开箱即用：依赖 gog 工具链，已集成 Gmail/Google Calendar 认证
2. 优雅降级：gog 未安装或日历无事件时静默跳过，不中断流程
3. 高度可定制：搜索语法完全开放，可按发件人、标签、阅读状态等自由组合
4. 完整日志追溯：所有运行记录保存至 morning-email-rollup-log.md

潜在局限

• 依赖外部服务：需 gog CLI 及有效的 Google OAuth 授权，存在令牌过期风险
• Gmail 智能标记依赖：「重要」判定由 Gmail 算法决定，可能漏筛关键邮件
• 单一时区固定：脚本硬编码 Denver 时区，跨区域使用需手动调整
• Telegram 绑定：输出渠道固定，不支持多平台（如 Slack、企业微信）

适合人群

• 每日邮件量大、需快速筛选优先事项的知识工作者
• 习惯晨间规划、希望邮件+日程一站式概览的效率用户
• 已深度使用 Google Workspace 生态的技术从业者

常规风险

• 隐私泄露：邮件摘要通过 Telegram 传输，虽经格式化脱敏，仍存在内容截获可能
• API 配额：高频 gog 调用可能触发 Gmail API 速率限制
• 认证失效：Google 令牌刷新失败将导致服务中断，需定期维护授权

核心功能

Morning Email Rollup 是一款自动化晨间信息聚合工具，每日定时（默认 8:00 AM）扫描用户 Gmail 账户，提取标记为重要或星标的邮件，同时拉取当日 Google Calendar 事件，生成结构化摘要并通过 Telegram 推送。

显著优点

1. 精准信息过滤

• 采用 Gmail 原生重要性标记（Important/Starred）作为筛选条件，避免信息过载
• 24 小时时间窗口确保内容时效性，默认展示 10 封核心邮件（可自定义至 20 封）
• 日历事件自动关联，实现邮件-日程双维度晨间概览

2. 零配置优雅设计

• 仅需设置 GOG_ACCOUNT 环境变量即可运行
• 日历模块具备智能降级：若 gog 未安装或无当日事件，自动静默跳过不报错
• 支持通过 MAX_EMAILS 环境变量临时调整输出数量，无需修改代码

3. 透明可审计

• 所有运行记录写入 morning-email-rollup-log.md，包含时间戳与处理数量
• 日志仅记录元数据（如「处理 15 封邮件」），不含邮件正文内容
• 开源 Bash 脚本架构，用户可完全审查搜索查询逻辑（如修改为 from:boss@company.com 等自定义规则）

潜在局限

1. 依赖链单一风险

• 核心功能完全依赖 gog（Google API CLI 工具），该非标准工具需单独安装
• 若 gog 版本更新导致 API 变更或维护中断，Skill 将失效
• 无内置 fallback 机制替代 gog 的功能

2. 隐私边界需用户自控

• 虽然仅读取重要/星标邮件，但「重要性」由 Gmail 算法判定，可能包含误判
• 邮件预览片段（前 150 字符）可能暴露敏感信息，需确保 Telegram 接收端安全
• 无端到端加密说明，数据经 Google API → gog → Clawdbot → Telegram 多跳传输

3. 定制化门槛

• 修改搜索逻辑需直接编辑 rollup.sh 源文件，对非技术用户不够友好
• 不支持多账户聚合（如同时监控工作邮箱和个人邮箱）
• 时区配置仅支持 cron 层面调整，无内置夏令时自动处理说明

适合人群

• 收件箱焦虑者：希望每日开始前快速掌握「必须处理」的邮件，而非陷入未读洪流
• Telegram 重度用户：已将 Telegram 作为核心信息枢纽，习惯 Bot 推送工作流
• Google Workspace 依赖者：深度使用 Gmail + Google Calendar 的日程驱动型工作者
• 技术可控偏好者：愿意阅读/修改 Bash 脚本，追求工具逻辑完全透明的用户

常规风险提示

| 风险类型 | 说明 | 缓解建议 |

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

| 依赖供应链 | gog 工具来源需人工验证 | 从官方 GitHub 仓库安装，定期校验哈希 |

| OAuth 权限漂移 | gog 可能申请超出只读范围的权限 | 定期审查 Google Account → 安全性 → 第三方应用权限 |

| 日志泄露 | 日志文件存放于本地明文路径 | 确保 `CLAWDBOT_WORKSPACE` 目录权限为 700 |

| 时区误配 | cron 时区字符串错误导致推送时间错乱 | 使用 `timedatectl list-timezones` 确认有效时区名 |

| Telegram 链路 | Clawdbot 作为中间转发方，需信任其数据 handling | 审查 Clawdbot 隐私政策，避免汇总含敏感关键词的邮件 |

安全评级 S（静态/动态分析均通过），来源可信度 T3（个人开发者项目），建议结合代码审计与沙箱测试后投入使用。