194 lines
4.8 KiB
Markdown
194 lines
4.8 KiB
Markdown
# 会会虚拟用户 AI 互动系统
|
||
|
||
基于 AI 大模型的虚拟用户自动化互动系统，支持对接会会平台接口，实现虚拟用户的自动登录、评论、回复、点赞、收藏、转发等功能。
|
||
|
||
## 功能特性
|
||
|
||
### 核心功能
|
||
- ✅ **虚拟用户管理**：批量生成、Excel 导入、人格配置
|
||
- ✅ **AI 内容生成**：支持 OpenAI、智谱、百度文心、阿里通义等大模型
|
||
- ✅ **自动化互动**：定时任务、随机策略、限额控制
|
||
- ✅ **数据可视化**：控制台仪表盘、Token 消耗统计
|
||
- ✅ **Docker 部署**：支持 1Panel 一键部署
|
||
|
||
### 互动类型
|
||
- 评论（AI 生成）
|
||
- 回复（AI 生成）
|
||
- 点赞
|
||
- 收藏
|
||
- 转发
|
||
|
||
### 技术栈
|
||
- **后端**：Python 3.11 + FastAPI
|
||
- **前端**：Vue 3 + Element Plus
|
||
- **数据库**：MySQL 8.0
|
||
- **AI 对接**：OpenAI / 智谱 / 百度 / 阿里
|
||
- **部署**：Docker + Docker Compose
|
||
|
||
## 快速开始
|
||
|
||
### 1. 环境要求
|
||
- Docker 20.10+
|
||
- Docker Compose 2.0+
|
||
- 1Panel 面板（可选）
|
||
|
||
### 2. 配置环境变量
|
||
|
||
```bash
|
||
cd backend
|
||
cp .env.example .env
|
||
```
|
||
|
||
编辑 `.env` 文件，配置必要参数：
|
||
- 数据库配置（默认即可）
|
||
- AI 模型 API Key（至少配置一个）
|
||
- 会会接口地址（默认：http://192.168.1.200:63120）
|
||
|
||
### 3. 启动服务
|
||
|
||
```bash
|
||
# 启动所有服务
|
||
docker-compose up -d
|
||
|
||
# 查看日志
|
||
docker-compose logs -f backend
|
||
|
||
# 停止服务
|
||
docker-compose down
|
||
```
|
||
|
||
### 4. 访问服务
|
||
- 前端界面：http://localhost
|
||
- 后端 API：http://localhost:8000
|
||
- API 文档：http://localhost:8000/docs
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
会会广场机器人/
|
||
├── backend/ # 后端服务
|
||
│ ├── app/
|
||
│ │ ├── api/ # API 路由
|
||
│ │ ├── core/ # 核心配置
|
||
│ │ ├── models/ # 数据库模型
|
||
│ │ ├── schemas/ # Pydantic Schema
|
||
│ │ ├── services/ # 业务服务
|
||
│ │ └── main.py # 应用入口
|
||
│ ├── requirements.txt # Python 依赖
|
||
│ └── Dockerfile
|
||
├── frontend/ # 前端服务
|
||
│ └── src/
|
||
├── docker/ # Docker 配置
|
||
│ ├── mysql/
|
||
│ └── nginx/
|
||
├── data/ # 数据持久化
|
||
│ ├── mysql/
|
||
│ └── logs/
|
||
├── docker-compose.yml
|
||
└── README.md
|
||
```
|
||
|
||
## API 接口
|
||
|
||
### 虚拟用户管理
|
||
- `GET /api/v1/virtual-users` - 获取用户列表
|
||
- `POST /api/v1/virtual-users` - 创建用户
|
||
- `POST /api/v1/virtual-users/generate` - 批量生成用户
|
||
- `POST /api/v1/virtual-users/import` - Excel 导入用户
|
||
- `PUT /api/v1/virtual-users/{id}` - 更新用户
|
||
- `DELETE /api/v1/virtual-users/{id}` - 删除用户
|
||
|
||
### 互动管理
|
||
- `POST /api/v1/interactions/execute` - 执行互动
|
||
- `GET /api/v1/interactions` - 获取互动记录
|
||
|
||
### AI 模型配置
|
||
- `GET /api/v1/ai-models` - 获取模型列表
|
||
- `POST /api/v1/ai-models` - 创建模型配置
|
||
- `POST /api/v1/ai-models/test` - 测试模型
|
||
|
||
### 控制台
|
||
- `GET /api/v1/dashboard` - 获取统计数据
|
||
- `GET /api/v1/dashboard/token/stats` - Token 统计
|
||
- `GET /api/v1/dashboard/token/daily` - 每日 Token 使用
|
||
|
||
## 系统配置
|
||
|
||
### 默认限额
|
||
- 每日 Token 上限：10,000
|
||
- 单用户日评论上限：20
|
||
- 单用户日回复上限：10
|
||
|
||
### 活动时间段
|
||
- 开始时间：09:00
|
||
- 结束时间：22:00
|
||
- 互动间隔：10-30 分钟（随机）
|
||
|
||
### 互动概率
|
||
- 点赞：80%
|
||
- 收藏：50%
|
||
- 转发：30%
|
||
|
||
## 开发指南
|
||
|
||
### 添加新的 AI 模型
|
||
1. 在 `app/services/ai_service.py` 添加对应的调用方法
|
||
2. 在 `app/models/ai_model.py` 添加提供商枚举
|
||
3. 通过 API 配置新模型
|
||
|
||
### 自定义互动策略
|
||
修改 `app/services/interaction_service.py` 中的互动逻辑
|
||
|
||
### 调整定时任务
|
||
修改 `app/services/scheduler_service.py` 中的调度配置
|
||
|
||
## 常见问题
|
||
|
||
### 1. 数据库连接失败
|
||
检查 MySQL 服务是否启动：
|
||
```bash
|
||
docker-compose ps mysql
|
||
```
|
||
|
||
### 2. AI 模型调用失败
|
||
- 检查 API Key 是否正确
|
||
- 检查网络连接
|
||
- 查看后端日志：`docker-compose logs backend`
|
||
|
||
### 3. Token 消耗过快
|
||
- 调整 `MAX_TOKENS_PER_DAY` 配置
|
||
- 降低互动频率
|
||
- 减少虚拟用户数量
|
||
|
||
## 1Panel 部署
|
||
|
||
### 通过 1Panel 部署 Docker Compose
|
||
1. 登录 1Panel 面板
|
||
2. 进入"容器管理" -> "Compose"
|
||
3. 点击"创建"，上传 `docker-compose.yml`
|
||
4. 配置环境变量
|
||
5. 点击"创建"启动服务
|
||
|
||
### 开放端口
|
||
在 1Panel 防火墙中开放：
|
||
- 80 (前端)
|
||
- 8000 (后端 API)
|
||
- 3306 (数据库，可选)
|
||
|
||
## 更新日志
|
||
|
||
### v1.0.0 (2026-03-23)
|
||
- 初始版本发布
|
||
- 支持虚拟用户生成和管理
|
||
- 支持 AI 自动生成评论和回复
|
||
- 支持多种互动类型
|
||
- 完整的 Docker 部署方案
|
||
|
||
## License
|
||
|
||
MIT License
|
||
|
||
## 联系方式
|
||
|
||
如有问题，请提交 Issue 或联系开发团队。
|