Smart Email

AI智能邮件管理助手，支持多邮箱 IMAP 收取、本地归档、自动发送到用户指定渠道。

架构

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  smart-email    │     │  smart-email    │     │  smart-email    │
│     check       │     │    digest       │     │   dispatch      │
│  (每30分钟)      │     │ (11:00, 17:00)  │     │  (每5分钟)       │
└────────┬────────┘     └────────┬────────┘     └────────┬────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  下载邮件        │     │  汇总邮件        │     │  读取 outbox    │
│  AI分析紧急程度  │     │  生成摘要        │     │  发送到用户渠道  │
│  生成urgent消息  │     │  生成digest消息  │     │  移动到sent     │
└────────┬────────┘     └────────┬────────┘     └─────────────────┘
         │                       │
         └───────────┬───────────┘
                     ▼
         ┌─────────────────────┐
         │   outbox/pending/   │
         │   (消息队列)         │
         └─────────────────────┘

核心功能

初次使用引导

当用户表示要开始使用 Smart Email 但尚未完成配置时，Agent 应主动引导用户完成以下步骤：

1. 阅读安装指南：Agent 自行阅读 references/USER_GUIDE.md 获取完整的安装配置流程
2. 协助配置环境变量：引导用户获取邮箱授权码、填写 .env 配置
3. 引导初始化测试：指导用户运行 init 和 4 步测试流程
4. 协助部署 Cron：帮助用户执行 setup-cron --apply 完成定时任务配置

Agent 应主动推进流程，不要只是告诉用户"请阅读 xxx"，而是自己读完后逐步引导用户操作。

核心配置

# 邮箱配置（使用授权码）
[email protected]
SMART_EMAIL_QQ_AUTH_CODE=xxx

# AI 配置（必填）
SMART_EMAIL_LLM_PROVIDER=openai  # openai | anthropic | subagent

# OpenAI 配置
SMART_EMAIL_OPENAI_API_URL=https://api.example.com/v1
SMART_EMAIL_OPENAI_API_KEY=xxx
SMART_EMAIL_OPENAI_MODEL=gpt-4o-mini

# Anthropic 配置
SMART_EMAIL_ANTHROPIC_API_KEY=xxx
SMART_EMAIL_ANTHROPIC_MODEL=claude-sonnet-4-20250514

# 发送渠道配置（必填）
SMART_EMAIL_DELIVERY_CHANNEL=telegram  # telegram | dingtalk | wecom | feishu
SMART_EMAIL_DELIVERY_TARGET=@username

完整配置见 references/USER_GUIDE.md。

CLI 命令

# 初始化
python3 -m smart_email init

# 检查并分析邮件
python3 -m smart_email check
python3 -m smart_email check --test        # 测试模式

# 生成汇总
python3 -m smart_email digest
python3 -m smart_email digest --test       # 测试模式

# 分发消息
python3 -m smart_email dispatch
python3 -m smart_email dispatch --test      # 测试模式

# 设置定时任务
python3 -m smart_email setup-cron --apply

# 查询邮件
python3 -m smart_email get-email <email_id>

# 清理
python3 -m smart_email clean
python3 -m smart_email clean-test

目录结构