Files
TinyWaste/docs/11-QA测试用例与验收清单.md
T
virtheart 2e1b58bada docs: 添加项目文档和图表文件
添加游戏设计文档、技术架构文档、数值经济文档等内容
新增Mermaid图表文件描述系统架构和流程
包含README说明文档结构和阅读顺序
2026-04-28 19:19:20 +08:00

156 lines
4.9 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.
# 11 QA 测试用例与验收清单
本文档面向 QA 与开发,覆盖核心链路的测试用例、回归点与验收清单。该项目是系统驱动游戏,测试重点是“时间推进与状态结算一致性”“配置驱动内容正确性”“随机可重放”。
## 11.1 测试范围
- 核心循环:基地→准备→移动→探索/事件→战斗→回收→发展
- 系统:时间推进、状态、Buff、资源刷新、制作、事件、战斗、任务、灾害、交易、存档
- 非功能:性能、可用性、异常恢复、兼容性(PC/Mobile)
## 11.2 通用测试要求
- 随机可重放:
- 每个测试用例记录 seed
- 复现 bug 必须能通过 replay 或 seed+操作序列重放
- 日志可观测:
- 每次状态变化、事件结果、战斗结算都可在日志中看到结构化信息
- 配置校验:
- 引用完整性(itemId/placeId/eventId
- 权重表合法(权重>0、总权重合理、不会空抽)
- 条件表达式合法(不会运行时报错)
## 11.3 Smoke(冒烟)用例(每次发布必测)
### 11.3.1 启动与基础交互
- 启动进入主界面,显示时间/地点/状态条/行动入口
- 打开背包与详情,无崩溃
- 打开地图与任务面板,无崩溃
- 暂停/继续功能正常
### 11.3.2 核心循环可闭环
- 从基地移动到一个邻近地点
- 执行一次采集或翻找,时间推进与状态消耗正确
- 触发一次事件并选择选项,结果生效
- 回基地,自动存档触发
## 11.4 系统测试用例(详细)
### 11.4.1 时间推进管线
- 用例:执行 `advanceTime(10min)`
- 期望:饥饿/口渴/精力按配置曲线变化
- 期望:Buff tick 按 interval 结算
- 期望:资源节点按刷新规则增长且不超过上限
- 期望:灾害倒计时/持续时间正确更新
边界:
- Δt = 0(不应产生变化)
- 超大 Δt(例如 24h)仍应按相同规则分段/累计结算,避免溢出
### 11.4.2 状态阈值与 Buff
- 触发阈值(例如口渴<阈值)应自动添加 debuff
- 从阈值恢复应自动移除 debuff
- Buff 堆叠规则:
- 刷新时长 vs 增加层数
- 到期移除是否正确
### 11.4.3 背包与容量
- 堆叠上限:超过上限应拆分或拒绝
- 容量上限:超过容量应拒绝拾取或强制丢弃(按设计)
- 装备槽互斥:同槽位只能装备一件
- 耐久为 0:装备失效逻辑正确
### 11.4.4 制作与科技
- 缺材料:按钮置灰并提示缺少项
- 缺条件:提示缺科技/缺设施/缺工具
- 制作完成:
- 扣除输入
- 增加产出
- 推进时间与消耗正确
- 科技解锁:
- 新配方可见
- 新地点服务解锁
- 永久修正生效
### 11.4.5 事件系统
- 事件抽取:
- 事件池为空时降级到全局池或给出提示(按设计)
- 条件过滤正确
- 权重抽取符合统计(抽样 1000 次)
- 选项:
- 不满足条件应置灰并说明原因
- 检定成功/失败结果正确执行
- 效果链:
- 顺序正确(先扣资源后给奖励等)
- 任一效果失败时的处理符合设计(允许部分成功或事务回滚)
### 11.4.6 战斗系统
- 初始化:
- 双方属性正确
- 距离与射程正确
- 回合动作:
- 攻击:命中率受距离/状态影响
- 防御:降低被命中或降低伤害
- 前进/后退:距离变化正确
- 逃跑:概率正确,逃跑后果正确(掉落/受伤/时间损失)
- 结束:
- 胜利掉落正确
- 失败进入死亡/失败流程
- 战斗日志完整可读
### 11.4.7 任务系统
- 任务触发:满足条件应进入 Active
- 任务步骤推进:到达地点/交付物品/击败敌人等正确推进
- 完成奖励:效果链正确执行
- 失败(如有):失败条件触发后状态正确
### 11.4.8 灾害系统
- 预警期提示与倒计时正确
- 爆发期规则改变正确(消耗倍率、遭遇权重、资源刷新)
- 结束后恢复默认规则
- 灾害与事件/任务交互不冲突(优先级一致)
### 11.4.9 存档
- 自动存档触发点:回基地/战斗结束/重要事件后
- 快速保存:不阻塞主线程,保存成功提示
- 读档:
- 所有状态恢复一致
- 地点资源存量一致
- 任务进度一致
- 内容版本不一致时提示并迁移
## 11.5 兼容性测试
- PC
- Chrome/Edge/SafarimacOS
- Mobile
- iOS Safari
- Android Chrome
## 11.6 性能与稳定性
- 长时间运行(模拟 3 小时游戏内循环)不出现内存持续增长
- 连续时间加速不出现卡死
- 大背包(200+物品条目)滚动与操作流畅
## 11.7 发布验收清单(Gate
- 核心循环可闭环(可从基地出发并持续发展)
- 主要系统无阻塞性 bug(卡死/坏档/无法推进)
- 内容校验全通过(Schema + 引用)
- 随机可重放(seed + 操作序列可复现)
- 关键数据埋点与错误上报可用(如项目需要)