3.4 KiB
3.4 KiB
AI 对话系统
支持网页端和Matrix端实时同步对话的AI聊天系统。
功能特性
- 网页端对话: 通过浏览器与AI进行对话
- Matrix端对话: 配置Matrix Bot，用户可通过Matrix与AI对话
- 实时同步: 同一用户在网页端和Matrix端的对话自动同步
- 后台管理: 用户管理、对话记录、系统配置
系统架构
┌─────────────────────────────────────────────────────────┐
│ AI 对话系统 │
├─────────────────────────────────────────────────────────┤
│ 网页端 (用户A) ←──┐ ┌──→ Matrix端 │
│ │ 同一会话同步 │ (用户A) │
├─────────────────────────────────────────────────────────┤
│ 后端服务 (FastAPI + WebSocket) │
│ - 会话管理 │
│ - 消息存储 │
│ - Matrix Bot 集成 │
│ - AI 模型调用 │
├─────────────────────────────────────────────────────────┤
│ 后台管理 │
│ - 用户管理 │
│ - 对话记录 │
│ - 系统配置 │
└─────────────────────────────────────────────────────────┘
端口分配
- 19020: 主服务（网页端 + API）
- 后台管理: http://localhost:19020/admin
快速启动
# 安装依赖
pip3 install -r requirements.txt
# 启动服务
./start.sh
# 检查状态
./status.sh
# 停止服务
./stop.sh
配置Matrix Bot
在后台管理页面配置以下参数：
| 配置项 | 说明 |
|---|---|
| matrix_homeserver | Matrix服务器地址，如 https://matrix.tphai.com |
| matrix_username | Matrix Bot用户名，如 @ai-bot:matrix.org |
| matrix_password | Matrix Bot密码 |
配置完成后，其他Matrix用户可以直接与Bot对话。
API接口
会话管理
GET /api/conversations- 获取会话列表POST /api/conversations- 创建新会话GET /api/conversations/{id}/messages- 获取会话消息DELETE /api/conversations/{id}- 删除会话
后台管理
GET /api/admin/stats- 获取统计数据GET /api/admin/users- 获取用户列表GET /api/admin/conversations- 获取对话列表GET /api/admin/config- 获取系统配置POST /api/admin/config- 更新系统配置
技术栈
- 后端: FastAPI + WebSocket
- 数据库: SQLite (SQLAlchemy)
- Matrix: matrix-nio
- 前端: HTML + JavaScript (原生)
- AI: 可配置任意LLM API（默认使用本地LLM Proxy）