MCP Email Service

# 📋 邮件翻译总结工作流 - 实现总结 ## 🎯 实现的功能 根据你的需求，我们实现了： ✅ **n8n 定时触发** - 每 10 分钟自动执行 ✅ **获取未读邮件** - 通过 MCP 服务获取所有未读 ✅ **智能语言检测** - 自动识别中文/非中文 ✅ **OpenAI 翻译** - 非中文邮件翻译成中文 ✅ **生成中文摘要** - 所有邮件生成中文摘要 ✅ **发送飞书通知** - 推送到飞书群 ✅ **标记已读** - 自动标记为已读 ## 📁 新增文件 ### 1. `scripts/email_translator.py` **邮件翻译和总结模块** - ✅ 语言检测（中文/非中文） - ✅ OpenAI 翻译功能 - ✅ 生成中文摘要 - ✅ 批量处理邮件 ### 2. `scripts/email_monitor_api.py` (新增端点) **API 端点扩展** - ✅ `POST /api/translate-unread` - 翻译未读邮件 - ✅ `POST /api/mark-read` - 标记已读 - ✅ API Key 认证保护 - ✅ 返回飞书消息格式 ### 3. `n8n/email_translate_workflow.json` **n8n 工作流定义** - ✅ 定时触发（每10分钟） - ✅ 调用翻译 API - ✅ 检查是否有邮件 - ✅ 发送飞书通知 - ✅ 标记已读 - ✅ 完整的错误处理 ### 4. `EMAIL_TRANSLATE_WORKFLOW_GUIDE.md` **完整使用文档** - ✅ 功能说明 - ✅ 部署步骤 - ✅ 配置说明 - ✅ 成本估算 - ✅ 故障排除 ## 🔄 工作流程 ``` 定时触发 (每10分钟) ↓ GET /api/translate-unread ├─ 获取未读邮件 (MCP) ├─ 检测语言 ├─ 非中文 → OpenAI 翻译 ├─ 生成中文摘要 └─ 返回 {summary, email_ids, lark_message} ↓ 有邮件？ ├─ 是 → POST 飞书 Webhook │ ↓ │ POST /api/mark-read │ ↓ │ 完成 ✅ └─ 否 → 跳过 ``` ## 💡 与之前方案的区别 ### 旧方案（AI 过滤） - ❌ 复杂：获取 → AI 过滤 → 通知 - ❌ 只处理"重要"邮件 - ❌ 不翻译 - ❌ 不标记已读 ### 新方案（翻译总结） - ✅ 简单：获取 → 翻译 → 通知 → 已读 - ✅ 处理**所有**未读邮件 - ✅ 自动翻译成中文 - ✅ 自动标记已读 - ✅ 完全符合你的需求 ## 🔒 安全性 - ✅ API Key 认证 - ✅ 敏感信息用环境变量 - ✅ 不在代码中硬编码域名 - ✅ 完整的错误处理 ## 💰 成本估算 ### 默认配置（每10分钟 + 20封邮件） - 每次运行: 4K-8K tokens - 每天: 144 次运行 - 月成本: **约 $34-69** ### 优化配置（每15分钟 + 10封邮件 + 工作时间） - 每次运行: 2K-4K tokens - 每天: 36 次运行 - 月成本: **约 $10-15** ✅ 推荐 ## 📝 部署清单 ### 1. 环境变量设置 **.env 文件**: ```bash OPENAI_API_KEY=sk-your-key API_SECRET_KEY=$(openssl rand -hex 32) EMAIL_API_URL=https://your-domain.com ``` **n8n 环境变量**: - `EMAIL_API_URL` - `EMAIL_API_KEY` - `FEISHU_WEBHOOK` ### 2. 启动服务 ```bash uv run uvicorn scripts.email_monitor_api:app --port 18888 ``` ### 3. 部署 n8n 工作流 ```bash # 导入 n8n/email_translate_workflow.json # 或使用 scripts/setup_n8n_workflow.py ``` ### 4. 测试 ```bash # 测试 API curl -X POST https://your-domain.com/api/translate-unread \ -H "X-API-Key: your-key" # 测试 n8n 工作流 # 在 n8n 中点击 "Execute Workflow" ``` ### 5. 激活 在 n8n 中激活工作流，开始自动运行！ ## 🎨 飞书消息示例 ``` 📬 未读邮件摘要 📧 共 3 封未读邮件 1. 会议通知：明天下午的季度总结会 发件人: manager@company.com 摘要: 会议将在明天下午2点举行，请准备好Q3的工作总结... 2. 账单提醒：您的服务即将到期 发件人: billing@service.com 摘要: 您的服务将在10月20日到期，请及时续费... 3. 新功能发布：我们推出了新的AI助手 发件人: product@tech.com 摘要: 我们很高兴地宣布推出新的AI助手功能，可以帮助您... ``` ## ✅ 待 Review 项目 ### 新增代码 - [ ] `scripts/email_translator.py` - 翻译模块 - [ ] `scripts/email_monitor_api.py` (新增 2 个端点) - [ ] `n8n/email_translate_workflow.json` - 工作流 ### 文档 - [ ] `EMAIL_TRANSLATE_WORKFLOW_GUIDE.md` - [ ] `TRANSLATION_WORKFLOW_SUMMARY.md` ### 安全性 - [x] ✅ API Key 认证 - [x] ✅ 环境变量保护 - [x] ✅ 不暴露敏感信息 ### 功能完整性 - [x] ✅ 获取未读邮件 - [x] ✅ 语言检测 - [x] ✅ 翻译成中文 - [x] ✅ 生成摘要 - [x] ✅ 发送通知 - [x] ✅ 标记已读 ## 🚀 准备就绪 所有代码已完成，等待你的 review 和批准后提交！ **这个方案完全符合你的需求：** - ✅ n8n 定时执行 - ✅ 获取未读 - ✅ 翻译成中文 - ✅ 生成总结 - ✅ 发送飞书 - ✅ 标记已读 **而且更简单、更直接、成本可控！** 🎉