Files
xyzw_web_helper/MD说明文件夹/测试指南.md
2025-10-17 20:56:50 +08:00

418 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 游戏功能重构测试指南
## 测试准备
### 1. 启动应用
```bash
npm run dev
# 或
npm run start
```
### 2. 登录并选择Token
- 进入Token管理页面
- 选择一个有效的Token
- 等待WebSocket连接成功显示"已连接"
### 3. 进入游戏功能页面
- 导航栏点击"游戏功能"
- 确认看到身份牌和三个标签页
---
## 详细测试步骤
### 一、基础UI测试
#### 1.1 标签页布局
- [ ] 确认看到三个标签页:每日、俱乐部、活动
- [ ] 确认身份牌在标签页上方常驻显示
- [ ] 点击每个标签页,确认能正常切换
- [ ] 确认切换时有平滑动画效果
#### 1.2 响应式测试
- [ ] 桌面端(>1024px卡片以网格形式展示每行2-3个
- [ ] 平板端768-1024px卡片以网格形式展示每行1-2个
- [ ] 移动端(<768px卡片单列垂直排列
- [ ] 调整浏览器窗口大小确认布局自适应
#### 1.3 主题测试
- [ ] 切换到深色主题确认所有卡片正常显示
- [ ] 切换回浅色主题确认所有卡片正常显示
- [ ] 确认按钮和文字在两种主题下都清晰可读
---
### 二、【每日】标签页功能测试
#### 2.1 队伍阵容TeamStatus
**测试步骤**:
1. 点击"每日"标签页
2. 找到"队伍阵容"卡片
3. 查看当前阵容显示是否正确
4. 点击阵容切换按钮1234
5. 点击刷新按钮
**预期结果**:
- [ ] 当前阵容编号正确显示
- [ ] 英雄头像和名称正确显示
- [ ] 切换阵容后英雄列表更新
- [ ] 刷新按钮有旋转动画
#### 2.2 每日任务DailyTaskStatus
**测试步骤**:
1. 查看每日任务卡片
2. 检查任务列表显示
3. 查看完成状态标识
**预期结果**:
- [ ] 任务列表正确显示
- [ ] 完成/未完成状态正确
- [ ] 进度条准确反映进度
#### 2.3 咸将塔TowerStatus
**测试步骤**:
1. 查看咸将塔卡片
2. 检查当前层数显示5-3
3. 检查剩余体力显示
4. 点击"开始爬塔"按钮
**预期结果**:
- [ ] 当前层数格式正确floor-layer
- [ ] 剩余体力数值正确
- [ ] 体力不足时按钮禁用
- [ ] 点击后显示"爬塔中..."
- [ ] 爬塔完成后层数更新
#### 2.4 挂机时间HangUpStatus★新组件
**测试步骤**:
1. 查看挂机时间卡片
2. 检查剩余时间倒计时格式HH:MM:SS
3. 检查已挂机时间显示
4. 点击"加钟"按钮
5. 点击"领取奖励"按钮
**预期结果**:
- [ ] 倒计时每秒更新
- [ ] 时间格式正确00:00:00
- [ ] 加钟按钮点击后显示"加钟中..."
- [ ] 加钟完成后剩余时间增加
- [ ] 领取按钮点击后显示"领取中..."
- [ ] 领取完成后显示成功消息
#### 2.5 咸鱼大冲关StudyStatus★新组件
**测试步骤**:
1. 查看咸鱼大冲关卡片
2. 检查完成状态已完成/待完成
3. 点击"🎯 一键答题"按钮
4. 观察答题进度显示
**预期结果**:
- [ ] 状态标识正确每周任务
- [ ] 已完成时显示"✅ 已完成无需作答"
- [ ] 未完成时显示"🎯 一键答题"
- [ ] 答题中显示进度答题中 5/10
- [ ] 答题完成后状态更新为已完成
#### 2.6 盐罐机器人BottleHelperStatus★新组件
**测试步骤**:
1. 查看盐罐机器人卡片
2. 检查运行状态运行中/已停止
3. 检查剩余时间倒计时
4. 点击"启动服务""重启服务"按钮
**预期结果**:
- [ ] 运行状态正确显示
- [ ] 倒计时每秒更新
- [ ] 点击按钮后显示操作消息
- [ ] 操作完成后状态更新
---
### 三、【俱乐部】标签页功能测试
#### 3.1 俱乐部签到LegionSigninStatus★新组件
**测试步骤**:
1. 点击"俱乐部"标签页
2. 查看俱乐部签到卡片
3. 检查签到状态已签到/待签到
4. 查看当前俱乐部名称
5. 点击"立即签到"按钮
**预期结果**:
- [ ] 签到状态正确显示
- [ ] 俱乐部名称正确显示
- [ ] 已签到时按钮禁用
- [ ] 点击签到后显示操作消息
- [ ] 签到完成后状态更新为"已签到"
#### 3.2 俱乐部赛车CarManagement
**测试步骤**:
1. 查看俱乐部赛车卡片
2. 测试赛车相关功能
**预期结果**:
- [ ] 赛车信息正确显示
- [ ] 相关操作按钮正常工作
#### 3.3 俱乐部信息ClubInfo
**测试步骤**:
1. 查看俱乐部信息卡片
2. 切换子标签页概览成员盐场战绩
3. 点击刷新按钮
**预期结果**:
- [ ] 俱乐部概览信息正确战力段位成员数等
- [ ] 成员列表正确显示按战力排序
- [ ] 盐场战绩正常显示
- [ ] 刷新按钮正常工作
#### 3.4 俱乐部排位LegionMatchStatus★新组件
**测试步骤**:
1. 查看俱乐部排位卡片
2. 检查报名状态已报名/未报名
3. 阅读赛事说明
4. 点击"立即报名"按钮
**预期结果**:
- [ ] 报名状态正确显示
- [ ] 赛事说明清晰周三周四周五
- [ ] 已报名时按钮禁用
- [ ] 点击报名后显示操作消息
- [ ] 报名完成后状态更新
---
### 四、【活动】标签页功能测试
#### 4.1 月度任务MonthlyTaskStatus★新组件
**测试步骤**:
1. 点击"活动"标签页
2. 查看月度任务卡片
3. 检查剩余天数显示
4. 查看钓鱼进度和百分比
5. 查看竞技场进度和百分比
6. 点击"刷新进度"按钮
7. 点击"钓鱼补齐"按钮
8. 点击"钓鱼补齐"右侧下拉菜单选择"一键完成"
9. 点击"竞技场补齐"按钮
10. 点击"竞技场补齐"右侧下拉菜单选择"一键完成"
**预期结果**:
- [ ] 剩余天数正确显示
- [ ] 钓鱼进度格式正确100/320 (31%)
- [ ] 竞技场进度格式正确50/240 (20%)
- [ ] 刷新按钮点击后显示"刷新中..."
- [ ] 刷新完成后进度更新
- [ ] 补齐按钮点击后显示"补齐中..."
- [ ] 补齐过程中显示提示消息检测到免费次数开始付费补齐等
- [ ] 补齐完成后显示成功消息
- [ ] 一键完成功能正常工作
- [ ] 补齐规则说明清晰易懂
#### 4.2 咸将升级模块UpgradeModule
**测试步骤**:
1. 查看咸将升级模块卡片
2. 设置升星次数
3. 设置图鉴升级次数
4. 勾选/取消"领取图鉴奖励"
5. 设置领取奖励次数
6. 点击"开始升级"按钮
7. 观察进度条和当前操作提示
**预期结果**:
- [ ] 配置项输入正常
- [ ] 进度条实时更新
- [ ] 当前操作提示准确咸将升星中/图鉴升级中/领取奖励中
- [ ] 升级完成后显示成功消息
---
### 五、WebSocket 通信测试
#### 5.1 命令发送
- [ ] 每个按钮点击后都能正常发送命令
- [ ] 浏览器控制台无错误信息
- [ ] 命令参数正确
#### 5.2 响应处理
- [ ] 服务器响应正常接收
- [ ] 数据正确更新到界面
- [ ] 状态实时刷新
#### 5.3 连接状态
- [ ] 连接断开时功能被禁用
- [ ] 重新连接后功能恢复
- [ ] 连接状态显示准确
---
### 六、错误处理测试
#### 6.1 无Token情况
- [ ] 未选择Token时显示警告消息
- [ ] 提示用户选择Token
#### 6.2 WebSocket未连接
- [ ] 未连接时显示错误消息
- [ ] 提示用户等待连接
#### 6.3 请求超时
- [ ] 请求超时时显示友好提示
- [ ] 不影响其他功能使用
#### 6.4 服务器错误
- [ ] 服务器返回错误时显示错误消息
- [ ] 用户可以重试操作
---
### 七、性能测试
#### 7.1 首屏加载
- [ ] 页面加载速度正常<3秒
- [ ] 无明显卡顿
#### 7.2 标签页切换
- [ ] 标签页切换流畅
- [ ] 切换动画不卡顿
#### 7.3 数据更新
- [ ] 倒计时流畅1秒间隔准确
- [ ] 进度条更新流畅
- [ ] 批量操作不阻塞UI
---
### 八、浏览器兼容性测试
测试浏览器
- [ ] Chrome/Edge (最新版)
- [ ] Firefox (最新版)
- [ ] Safari (最新版Mac/iOS)
- [ ] 移动浏览器Chrome/Safari
---
### 九、常见问题排查
#### 问题1标签页无法切换
**可能原因**:
- Naive UI 未正确安装
- n-tabs 组件导入错误
**解决方案**:
```bash
npm install naive-ui
```
#### 问题2新组件不显示
**可能原因**:
- 组件未正确导入
- 组件路径错误
**解决方案**:
检查 GameStatus.vue 中的 import 语句
#### 问题3倒计时不更新
**可能原因**:
- 定时器未启动
- 组件未挂载
**解决方案**:
检查组件的 onMounted startTimer 方法
#### 问题4WebSocket命令无响应
**可能原因**:
- Token无效
- WebSocket连接断开
- 服务器未响应
**解决方案**:
1. 检查Token是否有效
2. 检查WebSocket连接状态
3. 查看浏览器控制台Network标签
#### 问题5月度任务补齐失败
**可能原因**:
- 资源不足钓鱼券竞技场次数
- 网络超时
- 服务器限制
**解决方案**:
1. 检查游戏内资源是否充足
2. 增加超时时间
3. 分批执行
---
### 十、测试报告模板
测试完成后请填写以下报告
#### 测试基本信息
- 测试时间____年__月__日
- 测试人员________
- 测试环境________(浏览器/操作系统)
- 测试版本________
#### 测试结果汇总
- 总测试项____
- 通过项____
- 失败项____
- 阻塞项____
#### 发现的问题
| 序号 | 问题描述 | 严重级别 | 复现步骤 | 预期结果 | 实际结果 | 状态 |
|-----|---------|---------|---------|---------|---------|------|
| 1 | | // | | | | 待修复/已修复 |
| 2 | | | | | | |
#### 改进建议
1.
2.
3.
#### 测试结论
- [ ] 通过可以发布
- [ ] 有问题需要修复
- [ ] 阻塞暂不能发布
---
## 自动化测试(可选)
如果需要编写自动化测试可以使用以下框架
### 单元测试Vitest
```bash
npm install -D vitest @vue/test-utils
```
### E2E测试Playwright
```bash
npm install -D @playwright/test
```
---
## 测试通过标准
满足以下所有条件即视为测试通过
1. 所有功能正常工作无明显bug
2. UI显示正常无布局错乱
3. 响应式布局在所有设备上正常
4. WebSocket通信正常
5. 错误处理完善有友好提示
6. 性能流畅无明显卡顿
7. 浏览器兼容性良好
8. 深色主题支持正常
---
## 结论
本测试指南涵盖了游戏功能重构后的所有测试场景建议按照以上步骤逐项测试确保所有功能在新布局下正常工作测试过程中发现的问题应及时记录并修复