ARCANADA
← 生态系统 / Email Agent
已上线 L2 · 目标 L3

Email Agent

结合 Gemini 与 Telegram 摘要的个人 IMAP 邮件分拣。

每天 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 以防环境漂移

尚未说明状态

  • 按错误类别重试,并使用幂等键

当前自主性等级

L2
等级说明(英文)→

当前限制

过去曾发生事故:过于宽泛的 `except:` 吞掉 PermissionError,导致 54 封邮件无声丢失。修复已落地,结构化异常层次现在是强制要求。仍无外部心跳——如果定时任务停止运行,只能通过缺失的摘要发现。

达到以下目标等级的路线图:L3

  1. 提升至 L2——更新存活标记文件,并由 Ops Bot 监测 mtime;通过 ImapErrorClass 枚举分类错误(已完成)。
  2. 提升至 L3——将 pino 风格的结构化日志写入文件;运行结束后向 Ops Bot POST 摘要数量;通过 Pydantic 验证每个 Gemini 分类输出的模式。
  3. 验证门槛——混沌测试在运行中撤销 IMAP 令牌,并断言 60 秒内出现 Ops Bot 致命事件。

下一步

了解已上线产品及其当前限制

“已上线”表示项目目前可用;上方的当前限制和路线图说明了该版本的能力边界。

查看达到目标等级的路径