- 👤 用户认证: 提供完整的用户注册和登录流程，包含邮箱格式验证和密码强度评估。
- 👥 好友管理: 支持添加好友、删除好友、实时接受/拒绝好友请求。
- 🟢 实时状态: 通过 WebSocket 实时更新好友的在线状态。
- 💬 P2P 即时通讯:
- 用户间的聊天消息通过 WebRTC (PeerJS) 直接在客户端之间传输，不经过中心服务器。
- 动态排序: 好友列表会根据最新消息自动排序，将最活跃的对话置顶。
- "正在输入"提示: 可以实时看到对方是否正在输入消息。
- 消息时间戳: 每条消息都会显示具体的发送时间。
- 💾 本地聊天记录: 所有聊天记录都会被安全地存储在用户本地浏览器中，刷新或重启后不会丢失。
- 📂 文件与图片传输: 支持通过端到端加密通道安全地发送图片和各类文件。
- 🤖 AI 智能助手: 集成了 DeepSeek 大语言模型，为用户提供一个可以随时对话、获取信息的智能伙伴。
- 😉 发送表情符号: 在聊天中轻松选择并发送 Emoji，丰富表达方式。
- 🎨 个性化设置与资料管理:
- 用户可以随时更改邮箱、密码，上传和更换个人头像，并编辑个人资料。
- 主题切换: 支持在浅色和深色主题（以紫色和黑色为主调）之间一键切换，并记忆用户的选择。
- ℹ️ 查看好友资料: 在聊天界面方便地查看好友的公开个人信息。
- 🔒 端到端加密 (E2EE): 在建立P2P连接后，客户端之间会通过RSA非对称加密协商一个一次性的AES对称密钥。所有后续的聊天消息（包括文本、文件和图片）都使用此密钥进行加密，确保只有通信双方可以解密消息内容。
- 🔑 公钥管理: 服务器负责托管用户的公钥，以便于进行密钥协商。
- 🖼️ 信息隐藏 (Steganography): 用户可以将文本信息隐藏在图片中发送，接收方可以从图片中提取出隐藏的文本，为通信提供额外的安全层。
- 👑 内置管理员: 系统通过初始化脚本内置
admin账户 (admin/liujialun)。 - 📊 用户看板: 管理员可以查看系统中所有用户的列表及其详细信息（如邮箱、在线状态等）。
- 🔌 强制下线: 管理员可以强制将任何在线用户踢下线。
- 🗑️ 删除用户: 管理员可以从数据库中永久删除任何用户及其所有相关数据（如好友关系、好友请求等），已配置级联删除以保证数据一致性。
- 后端:
- 框架: Python, Flask
- 实时通信: Flask-SocketIO
- 数据库: SQLite3
- AI模型: DeepSeek API
- 前端:
- 框架: Vue.js 3 (Options API)
- P2P通信: PeerJS
- 🏛️ 架构:
系统采用 客户端/服务器 (C/S) 与 P2P 的混合架构。
- 中心服务器: 负责处理用户注册、登录认证、好友关系管理、用户状态维护以及P2P连接建立前的信令交换。
- P2P网络: 一旦好友双方建立连接，后续的聊天消息将直接通过P2P网络传输，不经过服务器，保证了通信的低延迟和私密性。
EasyChat/
├── backend/ # 后端 Flask 应用
│ ├── app/ # 应用核心代码包
│ │ ├── api/ # RESTful API 蓝图
│ │ ├── __init__.py # 应用工厂函数
│ │ ├── models.py # SQLAlchemy 数据库模型
│ │ └── socket_events.py # Socket.IO 事件处理器
│ ├── migrations/ # 数据库迁移脚本
│ ├── venv/ # Python 虚拟环境
│ ├── config.py # 配置文件
│ ├── requirements.txt # Python 依赖
│ └── run.py # 应用启动脚本
│
├── frontend/ # 前端 Vue.js 应用
│ ├── public/ # 公共文件 (如 index.html)
│ ├── src/ # 前端源码
│ │ ├── assets/ # 静态资源 (图片、头像等)
│ │ ├── components/ # 可复用组件 (当前项目暂无)
│ │ ├── router/ # 路由配置
│ │ ├── services/ # 服务层封装
│ │ │ ├── api.js # 后端API接口调用
│ │ │ ├── ai.js # AI助手(DeepSeek)接口调用
│ │ │ ├── peer.js # PeerJS (P2P) 服务
│ │ │ └── socket.js # Socket.IO 服务
│ │ ├── utils/ # 工具函数 (加密、隐写)
│ │ ├── views/ # 页面级组件 (LoginView, ChatView 等)
│ │ ├── App.vue # 根组件
│ │ └── main.js # 应用入口
│ ├── .env.local # 本地环境变量 (用于存放API密钥)
│ ├── package.json # npm 依赖和脚本
│ └── vue.config.js # Vue CLI 配置文件
│
├── img/ # README 文档中使用的图片
├── BACKEND_API_GUIDE.md # 后端 API 详细文档
├── 本地聊天记录持久化实现方法.md # 功能实现文档
└── README.md # 项目说明文档
# 1. 进入后端目录
cd backend
# 2. 创建并激活Python虚拟环境
# Windows
python -m venv venv
venv\\Scripts\\activate
# macOS/Linux
# python3 -m venv venv
# source venv/bin/activate
# 3. 安装依赖
pip install -r requirements.txt
# 4. 初始化/重置数据库并创建管理员账户
# (管理员用户名: admin, 密码: liujialun)
python reset_db.py
# 5. 启动后端服务
python run.py后端服务将运行在
http://localhost:5000，并监听0.0.0.0地址，允许来自局域网的连接。
# 1. 进入前端目录
cd frontend
# 2. 安装依赖
npm install3. 配置环境变量
为了使所有功能（特别是AI助手）正常工作，你需要在 frontend 目录下创建一个名为 .env.local 的文件，并配置以下变量：
-
AI 助手 API 密钥 (必需):
VUE_APP_DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"将
sk-xxx...替换为你的真实 DeepSeek API 密钥。 -
后端服务地址 (可选): 默认情况下，前端连接到本机 (
http://localhost:5000) 的后端。若要连接到网络上另一台计算机的后端，请添加此变量：VUE_APP_API_BASE_URL="http://<后端主机的IP地址>:5000"将
<后端主机的IP地址>替换为后端服务所在机器的真实局域网 IP 地址 (例如:192.168.1.100)。
# 4. 运行开发服务器
# (支持通过环境变量指定端口, 默认为8081)
npm run serve前端开发服务器将运行在
https://localhost:8081(或其他指定端口)。
- 注意：当同一个主机启动多个前端以模拟多用户时，推荐使用不同的浏览器或者打开浏览器的隐私模式。
- 提示：应用内置了主题切换功能，您的主题偏好会被自动保存在本地。
为了方便 Windows 用户，项目根目录提供了两个批处理脚本：
start_backend.bat: 自动进入后端目录，激活虚拟环境，并启动 Flask 服务器。start_frontend.bat: 自动进入前端目录，并启动 Vue 开发服务器。
在完成上述的首次依赖安装后，你只需分别双击运行这两个脚本即可快速启动整个应用。
登陆界面
注册界面
聊天界面
深色主题
我们欢迎各种形式的贡献！如果你有任何想法或建议，请随时提出 Issue 或提交 Pull Request。
- Fork 本仓库
- 创建你的新分支 (
git checkout -b feature/AmazingFeature) - 提交你的更改 (
git commit -m 'Add some AmazingFeature') - 将你的分支推送到远程 (
git push origin feature/AmazingFeature) - 开启一个 Pull Request
本项目采用 MIT 许可证。详情请见 LICENSE 文件。
详细的后端 API 和 WebSocket 事件说明，请参阅项目中的 BACKEND_API_GUIDE和 后端代码声明
本项目得以实现，离不开以下优秀开源项目和社区的支持：
- Vue.js: 构建响应式用户界面的核心前端框架。
- Flask: 轻量而强大的后端 Web 框架。
- Flask-SocketIO: 为应用提供了实时、双向的通信能力。
- PeerJS: 极大地简化了 WebRTC 的实现，使得P2P通信成为可能。
- DeepSeek: 为项目提供了强大的AI对话能力。
- Uiverse: Uiverse 是一个汇集了各种免费 CSS/Tailwind UI 元素的创意平台。
感谢创作者Alayna在Uiverse开源的sour-dog-94 ,这是我制作前端UI时的巨大财富！
同时，也要感谢所有为这些项目以及我们所依赖的其他无数开源库做出贡献的开发者们。你们的工作是巨人肩膀，让我们看得更远。
最后，感谢所有使用 EasyChat 并提供宝贵反馈的用户！
如有问题或建议，欢迎通过以下方式联系：
- 提交Issue：在GitHub项目页面创建问题
- 技术讨论：欢迎参与项目讨论区
⭐ 如果这个项目对你有帮助，请给它一个星标！