email-triage

📧 本地 AI 驱动的隐私优先邮件管家

基于本地 Ollama LLM 的 IMAP 邮件智能分类工具,支持紧急/待回复/信息/垃圾四级分类,零第三方依赖,为个人和团队提供隐私优先的收件箱自动化管理方案。

收藏
1k
安装
474
版本
127.0.0
CLS 安全性认证2026-05-20
点击查看完整报告 >

使用说明

核心用法

Email Triage 是一款面向 IMAP 邮箱的智能分类工具,通过本地部署的 Ollama 大语言模型或启发式规则,自动将未读邮件划分为四个优先级类别:紧急(urgent)、需回复(needs-response)、信息类(informational)和垃圾邮件(spam)。用户通过命令行执行 scan 扫描收件箱、、report 查看待处理邮件、、mark-surfaced 标记已处理,形成完整的邮件处理工作流。工具采用状态持久化机制,通过 JSON 文件跟踪邮件分类历史和已读状态,避免重复处理。

显著优点

隐私优先架构:所有邮件内容仅在本地处理,Ollama 运行在 127.0.0.1,无需将敏感信息上传至云端 API,适合对数据主权要求严格的用户。

零依赖设计:仅使用 Python 标准库(imaplib、urllib、json 等),彻底消除供应链攻击风险,部署简单且长期可维护。

智能降级机制:当 Ollama 不可用时自动切换至关键词启发式分类,确保服务连续性;同时支持只读 IMAP 模式,降低误操作风险。

状态精细化管理:基于 Message-ID 的去重机制、200 条记录的自动修剪、以及 surfaced 标记系统,使工具能够无缝融入自动化工作流(如 cron 定时任务或 Agent 流水线)。

潜在缺点与局限性

分类精度依赖本地算力:7B 参数模型(默认 qwen2.5:7b)对复杂语境的理解有限,可能出现误判;启发式规则对非英语邮件或高度个性化的邮件格式效果欠佳。

IMAP 协议限制:仅支持标准 IMAP 访问,无法处理需要 OAuth2 的现代邮箱(如部分企业 Microsoft 365 配置),且每次扫描最多处理 20 封邮件,大规模收件箱需要频繁轮询。

单用户设计:状态文件为本地 JSON,不支持多设备同步或团队协作场景下的状态共享。

无主动通知能力:工具本身不集成推送或邮件提醒,需要外部系统轮询 report --json 输出才能触发后续动作。

适合的目标群体

  • 技术型个人用户:开发者、研究员、自由职业者等需要管理多个邮箱且重视隐私的人群
  • 小型团队运维:需要监控基础设施告警邮箱(urgent 类别)的 DevOps 工程师
  • 本地优先的自动化工作流:将邮件处理集成到自托管的 Agent 系统或 HomeLab 环境
  • 离线或受限网络环境:无法使用云端邮件服务 API 的内网或边缘计算场景

使用风险

凭据管理风险:IMAP 密码需通过环境变量配置,若部署环境日志记录不完善,存在敏感信息泄露可能;建议强制使用应用专用密码并限制环境变量访问权限。

状态文件膨胀:虽然自动修剪至 200 条,但高频扫描场景下 JSON 文件仍可能产生 I/O 瓶颈,建议定期归档或监控磁盘使用。

Ollama 服务可用性:本地 LLM 服务崩溃或模型加载失败将导致分类质量下降,生产环境需配置健康检查和告警。

邮件内容本地存储:分类后的邮件主题、发件人等信息持久化在状态文件中,共享设备或备份场景需注意数据残留风险。

安全解读

核心用法

email-triage 是一款基于Python标准库的IMAP邮件智能分类工具,通过本地Ollama大模型或启发式规则,自动将未读邮件划分为四级优先级:🔴紧急( outages/安全警报)、🟡需回复(业务询盘)、🔵信息类(收据/通知)、⚫垃圾营销。核心工作流为:scan抓取→report筛选→mark-surfaced归档,支持--dry-run预演与--json程序化输出。

显著优点

极致轻量:纯标准库实现(imaplib/json/urllib),零第三方依赖,消除供应链风险;单文件466行,结构清晰易审计。

智能与鲁棒并存:优先调用本地Ollama(默认qwen2.5:7b)进行语义分类,离线时自动回退至关键词启发式,确保服务连续性。

隐私优先:邮件数据仅流经本地IMAP连接与Ollama,状态文件本地JSON存储(自动限制200条),零云端上报。

运维友好:Message-ID去重、自动裁剪历史记录、cron集成友好、2FA场景支持应用专用密码。

潜在局限

T3来源风险:个人开发者(briancolinger)维护,无企业SLA,建议生产环境锁定版本或fork自维护。

Ollama无认证:本地服务默认无API密钥,若Ollama暴露于非本地网络存在未授权调用风险。

启发式覆盖有限:离线模式下对复杂语义(如讽刺、隐含紧急性)识别能力弱于LLM。

凭证管理责任:IMAP密码依赖用户环境变量安全,无内置密钥托管或轮换机制。

适合人群

  • 隐私敏感用户:拒绝云端邮件分析服务(如Gmail智能分类)的个人或小型团队
  • 本地AI爱好者:已部署Ollama,希望扩展LLM至工作流自动化
  • 运维/开发者:需将邮件 urgency 集成至监控告警或自动化脚本(通过report --json
  • 离线/隔离环境:无外网或受限网络下的邮件管理需求

常规风险

  • 凭证泄露:环境变量误提交至版本控制或日志
  • 状态文件权限:默认权限可能允许多用户读取邮件元数据(建议手动设为600)
  • IMAP供应商限制:频繁扫描可能触发速率限制或账户锁定
  • LLM幻觉:Ollama分类可能产生错误优先级标签,关键邮件建议人工复核

安全认证摘要

CLS-2026-0520评级A级(85分):静态分析90分(无危险函数)、依赖审计95分(零第三方)、网络分析80分(仅限本地+用户IMAP)、隐私合规80分(数据本地存储)。两项低风险项:环境变量凭证管理(用户责任)、T3来源信任级别。

email-triage 内容

scripts文件夹
手动下载zip · 7.5 kB
email-triage.pytext/plain
请选择文件