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 定时执行
- ✅ 获取未读
- ✅ 翻译成中文
- ✅ 生成总结
- ✅ 发送飞书
- ✅ 标记已读

**而且更简单、更直接、成本可控！** 🎉