每天 50–200 封邮件的收件箱,容易掩盖真正重要的少数邮件。Email Agent 是由定时任务驱动的 Python 智能体:通过 IMAP 拉取收件箱,用 Gemini 将每封邮件分类为紧急、知会、垃圾邮件或摘要,并将每日汇总推送到 Telegram。
它用于个人场景。过去几次无声失败事件促成了 L3 路线图——每个缺陷都有明确修复,并在异常分类体系中增加了对应条目。
- 状态
- 已上线,个人使用
- 自主性(AAL)
- L2 → L3
- 处理量
- 约 50–200 封邮件/天
- 技术栈
- Python、IMAP、Gemini、Telegram
01
分拣,而非删除
邮件被分为紧急、知会、垃圾邮件和摘要;垃圾邮件进入隔离区,永不自动删除。
02
定时摘要,无常驻进程
它通过定时任务运行,没有长期驻留的进程,并发送一条包含分类统计的 Telegram 摘要。
03
每类错误都有明确名称
显式的 ImapErrorClass 异常层次结构取代笼统捕获,让每类失败都有名称。
那 54 封丢失的邮件
一次过于宽泛的 `except:` 吞掉了 PermissionError,导致 54 封邮件无声丢失。修复已经落地,目前强制要求使用结构化异常层次。
仍然没有外部心跳:如果定时任务停止运行,只能从未收到摘要发现。这一缺口是 L3 路线图中的下一步。
能力
已实现的能力
- 通过已配置的 Gmail 账户进行 IMAP 扫描
- 使用 Gemini 分类,并明确采用 ImapErrorClass 异常层次
- 每日 Telegram 摘要,包含分类统计
- 垃圾邮件隔离且不自动删除(由操作员审查)
- 定时任务驱动,无长期常驻守护进程
- 强化 venv 以防环境漂移
尚未说明状态
- 按错误类别重试,并使用幂等键
当前自主性等级
当前限制
过去曾发生事故:过于宽泛的 `except:` 吞掉 PermissionError,导致 54 封邮件无声丢失。修复已落地,结构化异常层次现在是强制要求。仍无外部心跳——如果定时任务停止运行,只能通过缺失的摘要发现。
达到以下目标等级的路线图:L3
- 提升至 L2——更新存活标记文件,并由 Ops Bot 监测 mtime;通过 ImapErrorClass 枚举分类错误(已完成)。
- 提升至 L3——将 pino 风格的结构化日志写入文件;运行结束后向 Ops Bot POST 摘要数量;通过 Pydantic 验证每个 Gemini 分类输出的模式。
- 验证门槛——混沌测试在运行中撤销 IMAP 令牌,并断言 60 秒内出现 Ops Bot 致命事件。
下一步
了解已上线产品及其当前限制
“已上线”表示项目目前可用;上方的当前限制和路线图说明了该版本的能力边界。
查看达到目标等级的路径