邮件分类处理

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

先决条件

• Python 3.10+
• 可访问IMAP的电子邮件账户（Gmail、Fastmail、自托管等）
• Ollama （可选）——用于基于AI的分类。若未安装，脚本将使用基于关键词的启发式方法，该方法对常见模式依然有效。

分类

配置

所有配置均通过环境变量进行：

写入的目录

• EMAIL_TRIAGE_STATE（默认：./data/email-triage.json）— 用于跟踪已分类邮件和浮出状态的持久状态文件

命令

# Scan inbox and classify new unread emails
python3 scripts/email/email-triage.py scan

# Scan with verbose output (shows each classification)
python3 scripts/email/email-triage.py scan --verbose

# Dry run — scan and classify but don't save state
python3 scripts/email/email-triage.py scan --dry-run

# Show unsurfaced important emails (urgent + needs-response)
python3 scripts/email/email-triage.py report

# Same as report but JSON output (for programmatic use)
python3 scripts/email/email-triage.py report --json

# Mark reported emails as surfaced (so they don't appear again)
python3 scripts/email/email-triage.py mark-surfaced

# Show triage statistics
python3 scripts/email/email-triage.py stats

工作原理

1. 连接至IMAP通过SSL并获取未读邮件（每次扫描最多20封）。
2. 通过Message-ID进行去重（或使用主题+发件人的哈希值作为后备方案），确保邮件不会被重复分类。
3. 分类每封邮件，如果Ollama可用则使用它，否则回退到关键词启发式方法。
4. 存储状态在本地JSON文件中——跟踪类别、原因以及邮件是否已被呈现。
5. 报告仅呈现未被呈现过的紧急和需要回复的邮件，并按优先级排序。
6. 标记为已呈现标记已报告的邮件，使其不会出现在未来的报告中。
7. 自动清理状态，仅保留最近的200条记录，以防止无限增长。

集成提示

• 心跳/定时任务：定期运行扫描，然后报告 --json以检查需要关注的项目。
• 代理工作流： 扫描→报告 --json→ 根据结果采取行动 →标记已浮出水面。
• 没有Ollama的情况：启发式分类器能很好地处理常见模式（自动通知、营销邮件、紧急关键词）。对于模棱两可的邮件，Ollama能增加细微差别的判断。
• 应用密码：如果您的服务提供商使用双重认证，请为IMAP访问生成一个特定于应用的密码。