邮件分类（Email Triage）

扫描您的 IMAP 收件箱，将邮件按优先级分类，并突出显示需要您关注的邮件。默认使用本地大语言模型（Ollama）进行智能分类；当 Ollama 不可用时，自动回退至基于规则的启发式分类器。

前提条件

• Python 3.10+
• 支持 IMAP 访问的邮箱账户（如 Gmail、Fastmail、自托管邮箱等）
• Ollama （可选） — 用于 AI 驱动的分类。若未安装 Ollama，脚本将启用基于关键词的启发式分类器，该方式对常见模式仍具备良好效果。

分类类别

配置方式

所有配置均通过环境变量完成：

写入的目录

• EMAIL_TRIAGE_STATE（默认：./data/email-triage.json）— 持久化状态文件，记录已分类邮件及其“是否已突出显示”状态

命令列表

# 扫描收件箱并分类新收到的未读邮件
python3 scripts/email/email-triage.py scan

# 启用详细输出模式（显示每封邮件的分类结果）
python3 scripts/email/email-triage.py scan --verbose

# 试运行：执行扫描与分类，但不保存状态
python3 scripts/email/email-triage.py scan --dry-run

# 显示尚未被突出显示的重要邮件（urgent + needs-response）
python3 scripts/email/email-triage.py report

# 同上，但以 JSON 格式输出（适用于程序化调用）
python3 scripts/email/email-triage.py report --json

# 将已报告的邮件标记为“已突出显示”，使其不再出现在后续报告中
python3 scripts/email/email-triage.py mark-surfaced

# 显示分类统计信息
python3 scripts/email/email-triage.py stats

工作原理

1. 连接 IMAP：通过 SSL 连接 IMAP 服务器，获取最多 20 封未读邮件。
2. 去重处理：依据邮件 Message-ID 去重；若不可用，则使用“主题 + 发件人”的哈希值作为备选标识符，确保每封邮件仅被分类一次。
3. 邮件分类：优先调用 Ollama 进行语义理解分类；若 Ollama 不可用，则自动切换至关键词启发式分类器。
4. 状态存储：将每封邮件的分类结果、判定依据及“是否已突出显示”状态持久化保存至本地 JSON 文件。
5. report：仅列出尚未被突出显示的 urgent 和 needs-response 类邮件，并按优先级排序。
6. mark-surfaced：将已在报告中列出的邮件标记为“已突出显示”，避免其重复出现在后续报告中。
7. 自动清理：状态文件最多保留最近 200 条记录，防止无限增长。

集成建议

• 心跳 / 定时任务（cron）：周期性执行 scan，随后调用 report --json 检查是否存在需处理的邮件。
• 智能体工作流（Agent workflow）：典型流程为 scan → report --json → 根据结果执行操作 → mark-surfaced。
• 不使用 Ollama 的场景：启发式分类器已能良好识别常见模式（如自动化通知、营销邮件、“urgent”“ASAP”等关键词），Ollama 主要提升对语义模糊邮件的判断精度。
• 应用专用密码（App passwords）：若您所用邮箱服务商启用了双重验证（2FA），请为其生成专用的 IMAP 应用密码。