AIEmail - 智能邮件助手系统

AI驱动的智能邮件管理平台

---

文件用途

本文档是AIEmail项目的根目录README，提供项目概述、快速开始指南和开发文档入口。

作者与日期

• 作者: TRAE
• 创建日期: 2026-02-10
• 最后更新: 2026-02-10

---

功能特性

核心功能

• 多邮箱账户管理 - 支持Gmail、Outlook、企业邮箱等IMAP/SMTP协议
• AI智能分析 - 自动分类、优先级排序、风险检测、情感分析
• AI辅助写作 - 智能回复建议、邮件润色、多语言翻译、语气调整
• 安全沙箱 - 附件安全检测、恶意链接识别、E2B云沙箱执行
• 数据可视化 - 邮件统计、使用分析、趋势报告、智能图表
• 智能链接 - AI自动识别并高亮邮件中的重要链接

技术亮点

• 高性能 - 异步处理、数据库优化、Redis缓存、虚拟滚动
• 国际化 - 支持中英文，可扩展更多语言，自动语言检测
• 无障碍 - 完整的ARIA支持、键盘导航、屏幕阅读器友好
• 安全可靠 - 多层安全防护、JWT认证、OAuth2、Rate Limiting

---

快速开始

环境要求

• Python 3.11+
• Node.js 20+
• PostgreSQL 15+（生产环境）/ SQLite（开发环境）
• Redis 7+

安装步骤

1. 克隆仓库

git clone https://github.com/01luyicheng/AIEmail.git
cd AIEmail

2. 后端配置

cd backend

# 创建虚拟环境
python -m venv venv
venv\Scripts\activate  # Windows
# source venv/bin/activate  # Linux/macOS

# 安装依赖（项目使用pyproject.toml管理依赖）
pip install -e .

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置数据库、Redis、AI API密钥等

# 运行数据库迁移
alembic upgrade head

# 启动服务
uvicorn main:app --reload

3. 前端配置

cd frontend

# 安装依赖
npm install

# 配置环境变量
cp .env.example .env.local

# 启动开发服务器
npm run dev

4. 访问应用

• 前端: http://localhost:5173
• 后端API: http://localhost:8000
• API文档: http://localhost:8000/api/docs

---

项目架构

AIEmail/
├── backend/                 # 后端服务
│   ├── app/
│   │   ├── api/            # API端点
│   │   │   ├── endpoints/  # 业务端点
│   │   │   ├── deps.py     # 依赖注入
│   │   │   └── websocket.py # WebSocket服务
│   │   ├── core/           # 核心配置
│   │   │   ├── config.py   # 配置管理
│   │   │   ├── security.py # 安全工具
│   │   │   └── redis_cache.py # Redis缓存
│   │   ├── models/         # 数据库模型
│   │   ├── schemas/        # Pydantic模型
│   │   ├── services/       # 业务服务
│   │   │   ├── providers/  # AI提供商
│   │   │   ├── mcp/        # MCP服务
│   │   │   └── *.py        # 业务服务
│   │   └── tasks/          # Celery任务
│   ├── migrations/         # 数据库迁移
│   └── tests/              # 测试用例
├── frontend/               # 前端应用
│   ├── src/
│   │   ├── api/            # API客户端
│   │   ├── components/     # React组件
│   │   ├── pages/          # 页面组件
│   │   ├── store/          # Zustand状态管理
│   │   ├── locales/        # 国际化
│   │   └── hooks/          # 自定义Hooks
│   └── tests/              # 测试用例
├── config/                 # 多环境配置
└── .trae/                  # Trae IDE配置

---

技术栈

后端

类别	技术
框架	FastAPI + Python 3.11
数据库	PostgreSQL + SQLAlchemy + Alembic
缓存	Redis
任务队列	Celery
AI服务	阿里云百炼、智谱AI、OpenAI、Anthropic、Google Gemini、DeepSeek
安全	JWT、OAuth2、Rate Limiting
沙箱	E2B云沙箱

前端

类别	技术
框架	React 18 + TypeScript
构建工具	Vite
UI库	Ant Design 6
状态管理	Zustand
样式	Tailwind CSS
富文本	TipTap
图表	Recharts
虚拟滚动	@tanstack/react-virtual

---

开发指南

代码规范

• 所有文件必须包含头部注释（用途、作者、日期、依赖）
• 关键算法必须有"实现说明"区块
• 使用TypeScript严格模式
• Python代码使用类型提示

提交规范

feat: 新功能
fix: Bug修复
docs: 文档更新
style: 代码格式（不影响功能）
refactor: 代码重构
test: 测试相关
chore: 构建过程或辅助工具的变动
ci: CI/CD配置

分支策略

• main: 生产分支
• dev: 开发分支
• feature/*: 功能分支
• hotfix/*: 紧急修复分支

---

测试

后端测试

cd backend
pytest tests/ -v --cov=app --cov-report=html

前端测试

cd frontend
npm run lint
npm run check

---

安全

报告安全漏洞

如发现安全漏洞，请通过以下方式报告：

1. 在GitHub创建Issue并标记security标签
2. 或使用GitHub Security Advisories私密报告

安全措施

• 定期依赖更新（Dependabot）
• 自动安全扫描（CodeQL, Trivy）
• 代码审查要求
• 分支保护规则

---

文档

• 前端开发文档
• 后端开发文档
• 配置说明
• 数据库迁移指南
• 问题清单

---

依赖列表

后端主要依赖

• fastapi>=0.115.0
• sqlalchemy>=2.0.0
• alembic>=1.13.0
• redis>=5.0.0
• celery>=5.3.0
• pydantic>=2.5.0
• python-jose>=3.3.0
• passlib>=1.7.4
• e2b>=0.14.0

前端主要依赖

• react@^18.3.1
• react-dom@^18.3.1
• react-router-dom@^7.11.0
• antd@^6.1.3
• zustand@^5.0.9
• axios@^1.13.2
• @tiptap/react@^3.15.3
• recharts@^2.15.2
• tailwindcss@^3.4.19

---

许可证

本项目为商业软件，保留所有权利。

---

团队

• 产品: AIEmail Team
• 开发: TRAE
• 设计: AIEmail Design Team

---

Made with by AIEmail Team