172 lines
4.7 KiB
Markdown
172 lines
4.7 KiB
Markdown
# 彩票数据分析系统使用指南
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 启动系统
|
||
```bash
|
||
# 一键启动（推荐）
|
||
python start_system.py
|
||
|
||
# 或者手动启动
|
||
# 后端：cd backend && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
|
||
# 前端：cd frontend && npm run dev
|
||
```
|
||
|
||
### 2. 访问系统
|
||
- 前端界面：http://localhost:5173
|
||
- 后端API文档：http://localhost:8000/docs
|
||
|
||
## 📊 主要功能
|
||
|
||
### 1. 数据更新功能 ⭐ 新功能
|
||
|
||
#### 位置
|
||
- 在首页顶部可以看到"数据更新"卡片
|
||
- 包含三个按钮：更新双色球、更新大乐透、更新全部
|
||
|
||
#### 使用方法
|
||
1. **更新双色球数据**
|
||
- 点击"更新双色球"按钮
|
||
- 系统会自动从API获取最新开奖数据
|
||
- 只添加数据库中不存在的新记录
|
||
- 更新完成后会显示新增记录数量
|
||
|
||
2. **更新大乐透数据**
|
||
- 点击"更新大乐透"按钮
|
||
- 功能与双色球更新类似
|
||
|
||
3. **更新全部数据**
|
||
- 点击"更新全部"按钮
|
||
- 同时更新双色球和大乐透数据
|
||
- 适合批量更新场景
|
||
|
||
#### 更新逻辑
|
||
- 自动去重：只添加数据库中未存在的开奖日期
|
||
- 数据验证：验证开奖号码的格式和范围
|
||
- 实时反馈：显示更新进度和结果
|
||
- 自动刷新：更新完成后自动刷新首页最新开奖信息
|
||
|
||
### 2. 数据查看功能
|
||
|
||
#### 最新开奖信息
|
||
- 首页显示双色球和大乐透的最新开奖记录
|
||
- 包含期号、开奖时间、开奖号码
|
||
- 支持手动刷新功能
|
||
|
||
#### 历史数据查询
|
||
- 进入"双色球数据"或"大乐透数据"页面
|
||
- 支持按期号、日期范围查询
|
||
- 分页显示，每页20条记录
|
||
|
||
### 3. 统计分析功能
|
||
|
||
#### 基础统计
|
||
- 号码出现频率统计
|
||
- 热门号码和冷门号码分析
|
||
- 数据可视化展示
|
||
|
||
#### 高级分析 ⭐ 新功能
|
||
- **遗漏值分析**：分析各号码的遗漏期数
|
||
- **和值分析**：统计红球和值的分布规律
|
||
- **AC值分析**：邻号差值分析
|
||
- **质合比分析**：质数与合数的比例分析
|
||
- **012路分析**：除3余数分析
|
||
- **跨度分析**：最大最小号码差值分析
|
||
- **综合分析**：多维度数据整合分析
|
||
|
||
### 4. 智能预测功能 ⭐ 新功能
|
||
|
||
#### 预测方法
|
||
- **机器学习预测**：基于AI算法的预测
|
||
- **模式预测**：基于统计模式的预测
|
||
- **集成预测**：多方法综合预测
|
||
|
||
#### 使用步骤
|
||
1. 进入"智能预测"页面
|
||
2. 选择彩票类型（双色球/大乐透）
|
||
3. 设置训练期数（建议100-500期）
|
||
4. 点击"训练模型"按钮
|
||
5. 选择预测方法并查看结果
|
||
|
||
### 5. 智能选号功能
|
||
|
||
#### 选号策略
|
||
- 随机选号
|
||
- 频率选号
|
||
- 热门号码选号
|
||
- 冷门号码选号
|
||
- 自定义选号策略
|
||
|
||
## 🔧 技术特性
|
||
|
||
### 数据管理
|
||
- **自动去重**：避免重复数据导入
|
||
- **数据验证**：确保数据格式正确
|
||
- **批量处理**：支持大量数据的高效处理
|
||
- **事务安全**：数据库操作支持回滚
|
||
|
||
### 性能优化
|
||
- **API缓存**：减少重复请求
|
||
- **分页查询**：提高大数据量查询性能
|
||
- **异步处理**：支持并发请求处理
|
||
- **错误重试**：网络请求自动重试机制
|
||
|
||
### 用户体验
|
||
- **响应式设计**：支持各种屏幕尺寸
|
||
- **实时反馈**：操作状态实时显示
|
||
- **错误提示**：友好的错误信息展示
|
||
- **加载状态**：长时间操作的进度提示
|
||
|
||
## 🛠️ 故障排除
|
||
|
||
### 常见问题
|
||
|
||
#### 1. 系统启动失败
|
||
**问题**：运行 `python start_system.py` 后系统无法启动
|
||
**解决**：
|
||
- 检查Python版本是否为3.8+
|
||
- 检查Node.js版本是否为16+
|
||
- 确保已安装所有依赖包
|
||
|
||
#### 2. 数据更新失败
|
||
**问题**：点击更新按钮后显示错误
|
||
**解决**：
|
||
- 检查网络连接
|
||
- 确认API密钥是否有效
|
||
- 查看后端日志获取详细错误信息
|
||
|
||
#### 3. 前端页面无法访问
|
||
**问题**：浏览器无法打开 http://localhost:5173
|
||
**解决**：
|
||
- 确认前端服务是否正常启动
|
||
- 检查端口5173是否被占用
|
||
- 查看前端控制台错误信息
|
||
|
||
#### 4. 数据库连接失败
|
||
**问题**：后端启动时显示数据库连接错误
|
||
**解决**：
|
||
- 检查数据库服务是否启动
|
||
- 确认数据库连接配置是否正确
|
||
- 验证数据库用户权限
|
||
|
||
### 日志查看
|
||
- 后端日志：查看终端输出或日志文件
|
||
- 前端日志：打开浏览器开发者工具查看控制台
|
||
- 数据库日志：查看数据库服务器日志
|
||
|
||
## 📞 技术支持
|
||
|
||
如果遇到问题，请：
|
||
1. 查看本文档的故障排除部分
|
||
2. 检查系统日志获取详细错误信息
|
||
3. 确认系统环境配置是否正确
|
||
4. 联系技术支持团队
|
||
|
||
## 🔄 更新日志
|
||
|
||
### v1.0.0 (最新版本)
|
||
- ✅ 新增数据更新功能
|
||
- ✅ 新增高级分析功能
|
||
- ✅ 新增智能预测功能
|
||
- ✅ 优化用户界面和用户体验
|
||
- ✅ 提升系统性能和稳定性 |