v0.9.7 道主功能测试方案

v0.9.7 道主功能测试方案

文档类型:评审汇报型测试方案

版本范围:游戏项目 v0.9.7;需求基线:主角境界工作表

编写日期:2026-08-09

状态:模拟项目基线,待产品、程序和运营确认配置项

0. 文档说明

本方案按照课件中的测试方案作业架构编写,目标是把道主功能从零散测试点整理为一张可评审、可执行、可追踪的质量作战地图。文档给出代表性场景和验收口径,不替代完整测试用例集。

0.1 需求与模板来源

0.2 术语约定

术语 说明
道主境界 玩家在遮天世界中的主角成长等级,按大境界、中境界、小境界分层;每个小境界视为 1 级。
灵气 用于提升境界的成长资源,来源包括主殿挂机、建筑升级和灵气珠。
突破 小境界提升,满足灵气和主殿等级条件后立即完成。
破境 中境界提升,需要进入渡劫流程;本版本只验证入口和版本交接。
淬体 每个世界的四阶段成长功能,需要满足灵气和玩法条件后手动激活。
P0/P1/P2 P0 为阻断上线的关键路径,P1 为高风险核心体验,P2 为一般体验或显示问题。

1. 项目概述

1.1 业务介绍

业务背景

v0.9.7 用“道主境界”替代原有灵气等级概念,为玩家建立统一的修仙成长主线。道主境界不只是一个展示等级,还会驱动道友属性、道友等级上限、道器强化上限、道主技解锁以及其他功能开启条件。

业务目标

  • 让玩家从创建账号开始拥有清晰的道主成长身份,初始境界为“凡人”。
  • 通过主殿挂机、建筑升级和道具使用形成稳定的灵气获取闭环。
  • 通过突破、破境、淬体和成仙路把长期成长转化为可感知的战力和功能收益。
  • 保证服务端权威计算,避免灵气、奖励、境界和排行数据被重复领取或篡改。

用户目标

  • 进入仙府或大地图即可找到道主入口,并理解当前境界、灵气和下一目标。
  • 能够稳定收取灵气、提升境界、查看效率说明和解锁奖励。
  • 在不同境界下获得正确的道友、道器和战斗收益,不因切服、断线或跨世界而丢失进度。

关键质量指标

指标 v0.9.7 建议基线 验证方式
P0 关键链路 100% 通过 主殿解锁→道主入口→灵气收取→突破/奖励回归
P1 场景 通过率不低于 95% 功能、接口、兼容性回归报告
数据正确性 灵气、境界、奖励不丢失、不重复 服务端日志、数据库快照、重试和并发数据对账
体验稳定性 目标机型无崩溃、严重花屏、遮挡、输入失效 真机矩阵、云真机和崩溃平台
接口体验 正常网络下读取 P95 ≤ 500ms,写入 P95 ≤ 800ms PB 接口压测和服务监控

核心用户场景

  1. 新玩家升级主殿后看到道主入口,进入境界页领取挂机灵气。
  2. 玩家在灵气达到阈值、主殿等级满足时完成小境界突破。
  3. 玩家在中境界满足条件后进入破境入口,交接至 v0.98 渡劫模块。
  4. 玩家解锁并装配道主技,在队伍战斗中手动释放并等待冷却。
  5. 玩家达到世界条件后激活灵气淬体,获得战斗或挂机收益。
  6. 玩家在成仙路查看功能详情并领取已解锁功能奖励。

1.2 系统架构假设

本项目未提供完整生产架构,以下为与当前技术栈匹配的测试模拟架构。最终接口名、字段、错误码和服务部署以开发联调结果为准。

flowchart LR
    A[Unity 客户端] --> B[Lua UI 与热更新逻辑]
    A --> C[C# 引擎、网络与 PB 桥接]
    C --> D[PB 网关/会话层]
    D --> E[Erlang 道主服务]
    D --> F[Erlang 建筑挂机服务]
    D --> G[Erlang 战斗/排行服务]
    E --> H[配置中心]
    F --> H
    G --> H
    E --> I[(MySQL 持久化)]
    E --> J[(Redis 缓存/排行)]
    F --> I
    G --> J
    E --> K[日志、指标、告警]
    F --> K
    G --> K

分层质量关注点

层级 主要职责 测试重点
Unity/Lua/C# 页面、动画、触控、状态渲染、PB 调用 入口显隐、按钮状态、气泡、浮动、弹窗、断线恢复和内存
PB 网关 登录态、协议路由、超时和错误返回 字段合法性、错误码、重试、幂等、旧客户端兼容和限流
Erlang 道主服务 境界、灵气、技能、淬体和成仙路状态 服务端权威计算、状态机、并发、事务和补偿
建筑挂机服务 主殿产出、浓度加成、每分钟结算和存储上限 离线时间、跨分钟、升级生效、上限截断和断线续算
战斗/排行服务 属性加成、道主技战斗效果、境界排行 战斗力一致性、技能冷却、排行展示和最终一致性
配置/数据层 境界阈值、奖励、技能、淬体、红点配置 配置 diff、默认值、热更新、回滚和客户端/服务端一致性

1.3 功能范围简介

功能域 需求摘要 P0 风险
入口与境界 主殿 1 级开启道主入口,境界分大/中/小三层,世界有上限 入口误显、境界错位、满级仍可提升
灵气闭环 主殿挂机、灵气浓度、建筑升级、灵气珠、储存气泡和收取 离线丢失、重复领取、上限计算错误
突破/破境 小境界立即突破,中境界进入渡劫 按钮状态错、灵气扣除错、版本交接失败
养成联动 道友属性、道友等级上限、道器强化上限、其他功能开启 属性未生效、上限绕过、配置未同步
道主技 境界解锁、队伍装配、主动释放、冷却和资源升级 多队伍重复装配、技能越权、资源重复扣除
灵气淬体 每世界四阶段,条件满足后手动激活,飞升后清零 状态错乱、跨世界残留、效果未生效
成仙路/红点 功能节点、奖励、红点触发与消失 非线性解锁错、奖励重复、红点残留
建筑/排行 建筑升级灵气、境界排行展示 升级收益错、排行数据未刷新或文案错误

1.4 测试背景与目标

测试背景

  • 版本:v0.9.7 新增道主境界体系和相关成长联动。
  • 客户端:Unity;语言:Lua、C#;协议:PB;服务端:Erlang。
  • 需求状态:部分规则注明“可配置”“暂定”或依赖新手引导/战斗策划确认。
  • 计划基线:使用相对工作日,不虚构实际发布日期。

测试目标

  1. 保障道主核心成长闭环在目标机型和正常网络下可完成。
  2. 保障灵气、境界、奖励和跨系统属性数据服务端权威且可恢复。
  3. 保障 v0.9.7 与 v0.98 破境入口交接清晰,不将未交付渡劫玩法误判为本版本完成。
  4. 通过接口、配置和自动化回归降低后续境界扩展的回归成本。

2. 诊断与分析

2.1 5W2H 分析

维度 结论 对测试的影响
What 新增道主境界、灵气闭环、道主技、淬体、成仙路、红点、排行改名 必须覆盖功能与跨系统联动,不仅是 UI 冒烟
Why 建立修仙成长主线,替代灵气等级并控制成长上限和功能开启 境界是多个系统的单一事实来源,数据错误会放大
Who 新玩家、长期养成玩家、不同世界和不同队伍玩家 需要新手态、边界态、满级态、跨世界态和多队伍数据
When v0.9.7 版本上线,破境玩法后续由 v0.98 承接 版本边界、灰度和降级必须可验证
Where 仙府、大地图、道主界面、建筑、战斗、排行和服务端 需要多入口、多场景、前后台和跨服务验证
How Unity/Lua/C# 客户端经 PB 调用 Erlang 服务,配置驱动成长规则 采用分层测试、契约测试和配置 diff
How much 模拟投入 2 周、4 名 QA,开发/运维按需支持 以 P0/P1 风险优先,完整用例在方案后续拆分

2.2 SWOT 分析

类型 分析结论 应对方向
Strengths 成长线统一;主殿、灵气、境界和功能开启可形成可追踪链路 建立主链路回归和统一数据断言
Weaknesses 配置点多;境界状态同时影响道友、道器、技能、淬体和排行 双端配置校验、边界数据集、接口契约冻结
Opportunities 可沉淀境界状态模型、PB 自动化和配置校验能力 建立可复用测试数据工厂和 CI 回归
Threats 离线结算、重试并发、跨世界清理、v0.98 交接和设备适配 重点做幂等、恢复、版本兼容和真机专项

2.3 质量挑战与优先级

挑战 失效后果 优先级
灵气挂机、气泡、收取三种资源形态的分配规则 资源丢失或重复领取,直接破坏成长公平性 P0
小境界/中境界/世界边界状态转换 玩家卡死、越级或错误扣除资源 P0
境界对属性、上限和功能的联动 战斗力和付费成长价值不可信 P0
配置与代码/缓存不一致 同一账号在不同端或不同服务看到不同结果 P0
v0.98 破境依赖未完成 v0.9.7 入口可见但无法完成关键流程 P1
多设备、重试、断线和服务重启 重复领奖、状态回退或无法恢复 P0
低端机、异形屏和前后台切换 入口、按钮、气泡不可用或崩溃 P1

2.4 需求确认项

以下内容来自需求中的“暂定/可配置/待策划确认”,进入测试前必须形成定案记录:

  • 道主入口最终开启条件,当前暂定为主殿 1 级。
  • 每个境界的灵气阈值、主殿等级和道友/道器上限配置。
  • 道主技的具体技能效果、新手引导和战斗释放规则。
  • 灵气淬体四阶段的最终玩法条件、效果和各世界配置。
  • 破境失败后的灵力/坚固值恢复比例及 v0.98 服务接口。
  • 红点样式、奖励内容、错误码和提示文案。

3. 测试策略

3.1 策略总览

flowchart TD
    A[需求与配置静态校验] --> B[客户端 Lua/C# 单元与冒烟]
    B --> C[PB 契约与接口自动化]
    C --> D[Erlang 服务状态与数据一致性]
    D --> E[跨系统端到端场景]
    E --> F[兼容性/性能/安全/稳定性专项]
    F --> G[版本回归与上线准入]

测试原则:服务端权威、风险优先、状态可观测、配置可回滚、关键操作幂等、异常可以恢复。

3.2 功能测试策略

测试设计方法

方法 应用对象 代表性切分
场景法 玩家成长主链路 新账号、挂机、收取、突破、淬体、领奖、排行
状态转换 境界、淬体、奖励、红点 未开启→已开启→可激活→已激活;可突破→不可突破
等价类 资源和配置 灵气不足/刚好/超出;主殿不足/刚好/超出
边界值 气泡、世界、储存和等级 2000、4000、存储上限、世界满级、溢出灵气
判定表 多条件解锁 灵气条件、主殿等级、荒塔/战斗条件、前置阶段
错误推测 异常与攻击 重复点击、重试、断线、篡改请求、旧客户端

P0 功能场景

场景 关键检查项 数据断言
入口开启 主殿未达条件隐藏,达成后仙府/大地图入口一致 账号资格与入口状态一致
境界展示 大/中/小境界名称、等级、世界、上限和提示正确 境界快照与配置映射一致
挂机产出 每分钟结算、主殿效率、灵气浓度加成、离线时长 产出=基础效率×浓度加成;只有挂机灵气受储存上限限制,建筑升级灵气不受该上限限制
气泡生成 以挂机灵气为阈值:挂机灵气≤2000 生成 4 个,2000<挂机灵气≤4000 生成 6 个,>4000 生成 8 个 气泡总和等于可收取的挂机灵气与建筑升级灵气总量;领取时优先扣除挂机灵气,余数只进入一个气泡
气泡领取 单个点击、划动领取、8 个气泡时合并到最低值气泡 每个气泡只消费一次,收取后经验条只增加一次
突破 灵气和主殿满足时显示按钮,否则隐藏;小境界文案为“突破” 资源扣除、境界提升、属性刷新原子完成
破境交接 中境界显示“破境”及不同样式,转入 v0.98 入口 v0.9.7 不提前完成渡劫;失败停留原境界
飞升边界 世界满级不可继续提升;飞升后清理淬体效果和超额灵气 保留突破所需灵气,清理超过部分和旧世界淬体状态
联动收益 道友攻防血、战斗力、道友等级上限、道器等级上限 面板、战斗计算和服务端快照一致

其他功能场景

  • 道主技:境界解锁、只能装配到一个队伍、队伍 1 默认装配、主动释放、冷却无能量消耗、元龙木/星河砂升级和等级上限。
  • 灵气淬体:入口按世界和境界显隐;四阶段按前置、灵气、玩法条件顺序激活;未满足时提示,满足时激活成功;飞升后清零并按新世界规则重现。
  • 成仙路:节点按配置展示,允许后置节点先开启;详情弹框、奖励不可领/可领、领奖后状态和礼物图标变化正确;化龙及以后按版本范围隐藏。
  • 红点:收取灵气、提升境界、升级道主技、领取开启奖励、激活淬体的触发和消失路径完整。
  • 建筑升级/排行:主殿升级效率和建筑升级灵气生效;“灵气排行”改为“境界排行”但排行规则、筛选和分页不变。

3.3 PB 接口与数据测试

契约检查表

检查项 验证内容
请求前置 登录态、角色 ID、世界、境界和客户端版本校验
响应字段 境界快照、灵气来源、气泡列表、按钮状态、奖励状态和错误码完整
服务端权威 客户端提交意图,不提交可直接信任的境界、灵气和奖励结果
幂等 收取、突破、激活、领奖、技能升级重复请求只产生一次业务结果
顺序 旧请求晚到时不能覆盖新境界、灵气或配置版本
重试 超时重试返回同一业务结果,不重复扣费/发奖
兼容 旧客户端读取新字段不崩溃,新客户端对旧服务有明确降级
异常 非法境界、负灵气、越权角色、错误世界和过期配置返回可识别错误
可观测性 请求 ID、角色 ID、配置版本、幂等键和结果码可在日志中关联

数据一致性场景

  • 客户端显示、PB 响应、Redis 缓存和 MySQL 持久化四者对账。
  • 断线发生在扣除前、扣除后、发奖前、发奖后四个时间点分别恢复。
  • 两台设备同时点击同一气泡、奖励或激活按钮。
  • 服务重启、缓存失效、消息重复投递和数据库回滚后的补偿。

3.4 兼容性测试策略

模拟设备矩阵

层级 iOS 示例 Android 示例 重点
低端/小屏 iPhone SE 3 Redmi Note、荣耀 X 系列 内存、字体、触控、低分辨率
主流 iPhone 13/14 小米数字系列、OPPO Reno、vivo S/X、荣耀数字系列 主流程、性能和网络切换
高端 iPhone 15 Pro/16 Pro Max/17 Pro Max 小米 Ultra、华为 Mate、OPPO Find、vivo X Pro、Samsung S 系列 高帧率、特效、后台恢复
异形/折叠 灵动岛机型 华为 Mate X、Samsung Fold、Pixel Fold 安全区、宽高比、旋转和弹窗定位

主覆盖系统:Android 10/12/14/16,iOS 15/17/18/26。最终设备占比需替换为线上 DAU、付费用户和崩溃分布。

重点验证:页面裁切、刘海/灵动岛安全区、气泡 8 点位、滑动轨迹、字体缩放、后台恢复、热更新、弱网、GPU/内存和 16KB 页大小兼容。

3.5 性能与稳定性策略

场景 建议基线 观测指标
道主页面打开 缓存命中 P95 ≤ 2s 首帧、资源加载、PB 往返、Lua GC
境界快照读取 P95 ≤ 500ms Erlang 处理、Redis 命中和网关耗时
收取/突破/激活写请求 P95 ≤ 800ms 锁等待、数据库提交、重复请求比例
批量离线结算 1000 个并发角色可完成且无丢失 CPU、内存、队列、数据库写入和延迟
长稳 连续 30 分钟反复进出道主页和领取气泡 崩溃、卡顿、内存增长、网络重连

专项场景:低端机连续操作、前后台切换、Wi-Fi/4G/5G 切换、弱网丢包、服务重启、配置热更新、排行榜高并发查询。

3.6 安全测试策略

  • 修改 PB 请求中的境界、灵气、奖励、世界和技能等级,服务端必须拒绝。
  • 重放收取、领奖、突破、激活和升级请求,验证幂等和过期校验。
  • 使用其他角色 ID、错误世界和过期登录态访问道主数据,验证鉴权。
  • 对未知字段、超长字段、负数、溢出值和乱序请求做 PB 模糊测试。
  • 检查敏感操作日志、审计字段、限流、封禁和异常告警。

3.7 自动化落地

方向 工具/实现 首批自动化内容
服务与规则 Erlang Common Test/EUnit/PropEr 境界映射、灵气计算、上限、飞升清理、幂等属性
PB 接口 Python/pytest + PB 生成代码 快照、收取、突破、淬体、领奖、技能升级和错误码
客户端 Unity Test Framework C# 状态模型、按钮状态、配置解析和断线恢复
UI 冒烟 Airtest/Poco 或现有 Unity UI 框架 入口→境界→气泡→突破→成仙路→返回
CI Jenkins/GitLab CI 每日 P0 回归、接口契约、配置 diff 和报告归档

4. 测试计划

4.1 范围与边界

In-Scope

  • 主角境界工作表中 v0.9.7 已描述的规则、UI 流程、红点和排行变更。
  • 道主与主殿、建筑、战斗、道友、道器、地图、排行、配置和存储的接入影响。
  • v0.98 破境入口交接、异常提示和失败回退契约。

Out-of-Scope

  • v0.98 渡劫雷劫的阶段玩法、特效规则、多人可见表现和完整失败惩罚。
  • 既有登录、建筑、战斗、地图和排行榜未被道主改动的功能。
  • 化龙及三世界以后尚未提供新图和开发规则的内容。
  • 生产环境真实 DAU、机型占比和最终服务容量结论。

4.2 时间进度与里程碑

阶段 工作日 目标与出口
阶段一:基线与冒烟 D1-D3 需求确认、配置 diff、PB 契约、登录/入口/境界/灵气主链路通过
阶段二:完整功能 D4-D7 突破、淬体、道主技、成仙路、红点、建筑和排行完成首轮测试
阶段三:专项测试 D8-D9 兼容性、性能、安全、断线重连、并发和恢复完成
阶段四:回归与准入 D10 P0/P1 回归、缺陷评审、风险签字、上线/回滚检查清单完成

4.3 资源需求与分配

人力

角色 投入 责任
测试负责人 1 人全周期 方案、风险、进度、准入和复盘
功能测试 1 人 D1-D7 UI、境界、灵气、淬体、成仙路、红点
接口/数据测试 1 人 D1-D9 PB、Erlang、配置、缓存、数据库和并发
专项测试 1 人 D6-D10 兼容性、性能、安全、自动化和稳定性
开发/运维 按需 协议、日志、压测环境、数据恢复和发布开关

环境与数据

  • v0.9.7 客户端包、Lua 热更新包、PB schema、服务端测试包和配置版本。
  • 独立测试服、压测服、可重置数据库、Redis、日志/指标平台和数据快照。
  • 测试账号:新账号、主殿 1 级、各世界初始/中间/满级、灵气刚好/不足/溢出、淬体四阶段、三队伍、旧客户端账号。

4.4 进入与退出标准

进入标准

  • 需求定案项和配置表有版本号;PB schema、错误码和日志字段可用。
  • 测试服、数据库重置、数据构造和回滚能力可用。
  • 客户端主包、Lua 包、服务端包和依赖服务部署成功。

退出标准

  • P0 关键链路 100% 通过,P1 通过率不低于 95%。
  • 无未豁免阻断/严重缺陷;高风险问题有负责人、修复版本或回滚方案。
  • 关键资源、境界、奖励和排行数据通过对账和恢复验证。
  • 目标设备矩阵、PB 契约、性能、稳定性和安全报告齐备。

5. 团队与能力

5.1 模拟能力现状

以下评分仅用于方案演示,不代表真实团队绩效。

维度 现状(5 分制) 目标 主要差距
游戏功能与场景设计 4 5 需要沉淀境界状态模型和跨系统场景
PB/Erlang 接口测试 3 4 缺少契约、重试、幂等和状态属性模板
配置与数据一致性 3 5 缺少配置 diff、快照对账和补偿验证
兼容性专项 3 4 低端机、折叠屏和异形屏覆盖不足
性能与稳定性 2 4 缺少批量离线结算和长稳基线
自动化与 CI 2 4 UI、PB、规则和配置校验未形成门禁

5.2 能力差距与改进路线

  • 短期(本版本):建立 P0 接口回归、配置 diff、关键数据对账和真机截图基线。
  • 中期(1-3 个月):沉淀灵气/境界测试数据工厂、Erlang 属性测试、PB 契约门禁和云真机矩阵。
  • 长期(3-6 个月):接入 CI 自动准入、线上境界异常监控、奖励补偿工具和版本质量趋势看板。

5.3 资源申请

  • 2 台低端 Android、4 台主流/高端 Android、3 台 iPhone 和 1 台折叠屏真机。
  • 可重置的测试服、压测服、PB schema 仓库、配置 diff 工具和数据修复脚本。
  • 现有崩溃平台、Prometheus/Grafana 或等价监控、日志检索和发布开关。

6. 风险评估

6.1 风险矩阵

风险 概率 影响 等级 触发信号
配置与客户端/服务端版本不一致 P0 同一账号不同端境界或灵气不同
离线挂机/气泡领取重复或丢失 P0 对账差异、重复奖励、气泡和经验条不一致
境界跨世界清理错误 P0 飞升后淬体残留、溢出灵气被误清
破境入口与 v0.98 服务交接失败 P1 按钮可见但无法进入或失败后状态异常
道主技多队伍重复装配或越权释放 P0 同一技能出现在多个队伍或非法请求成功
红点、领奖状态无法清除 P1 重进页面红点残留或奖励重复
低端机/异形屏 UI 不可操作 P1 遮挡、裁切、触控区域偏移或崩溃
排行缓存延迟或错误回退 P1 境界已更新但排行长期不刷新

6.2 应对措施

风险类型 预防 缓解 应急
配置错配 双端 schema 和配置 diff 启动时校验配置版本 关闭入口并回滚配置
资源重复/丢失 服务端权威、幂等键、事务 审计日志和定时对账 停止领奖、执行补偿/回滚
版本交接 接口契约冻结、灰度开关 入口降级为不可破境 隐藏破境入口并公告
设备适配 分层真机矩阵和截图基线 降低特效/关闭非核心动画 定向关闭设备或功能开关
服务稳定性 压测、长稳、重启恢复 限流、熔断、队列积压告警 切只读、回滚包、恢复快照

6.3 应急流程

flowchart LR
    A[发现异常] --> B[确认影响范围]
    B --> C{是否影响资源/境界/领奖}
    C -- 是 --> D[停止入口或领奖]
    C -- 否 --> E[记录缺陷并继续观察]
    D --> F[冻结配置/服务开关]
    F --> G[快照对账与数据修复]
    G --> H[回归验证]
    H --> I[恢复功能并发布公告]

应急沟通:测试负责人 5 分钟内通知开发负责人和产品负责人;涉及资源、境界或大面积崩溃时,15 分钟内给出影响范围、临时措施和下一次更新时间。

7. 成功标准与交付物

7.1 测试完成标准

  • P0 关键链路 100% 通过,P1 通过率不低于 95%。
  • 无未豁免阻断/严重缺陷;高风险问题有明确 owner、修复版本和回滚方式。
  • 灵气、境界、技能、淬体、奖励和排行数据通过正常、异常、并发和恢复对账。
  • 目标设备无崩溃、严重花屏、遮挡、触控失效或字体裁切。
  • PB 契约、性能、兼容性、安全、稳定性和回滚检查结果已归档。

7.2 交付物清单

  • 本测试方案 Markdown。
  • 功能范围与风险矩阵。
  • PB 接口/配置契约检查表。
  • 兼容性设备矩阵与 UI 截图基线。
  • 性能、稳定性和安全专项报告。
  • 缺陷趋势、上线准入结论、数据修复和回滚预案。

7.3 版本复盘指标

  • 测试范围完成率、P0/P1 缺陷发现与修复率。
  • 线上境界、灵气、奖励、红点和排行问题数。
  • 自动化回归耗时、人工回归节省时长和配置问题拦截数。
  • 设备覆盖率、崩溃率、性能达标率和环境可用率。
  • 团队在接口、数据一致性、性能和自动化方面的能力提升。

8. 总结

本方案把道主功能视为一条由境界状态驱动的跨系统成长链,而不是若干独立页面。测试重点从“按钮能否点击”提升到“配置、协议、服务、存储、战斗、排行和客户端表现是否在每个状态转换上保持一致”。

本版本的上线结论必须建立在三项证据上:P0 主链路通过、关键数据可对账恢复、目标设备专项无高风险问题。渡劫完整玩法明确由 v0.98 承接,v0.9.7 只对破境交接和降级能力负责。

9. Agent 设计记录与提示词

9.1 材料清点

  1. 阅读测试方案课件 Markdown,提取作业章节、5W2H、SWOT、SMART、策略、计划、团队、风险、复盘和金字塔表达要求。
  2. 阅读作业要求图和示例模板图,确认文档需要项目概述、架构图、测试目标、范围、策略、资源、团队、风险、交付物和总结。
  3. 读取道主需求工作簿的“版本记录”和“主角境界”工作表,识别境界、灵气、UI、红点、淬体、成仙路、建筑和排行榜规则。
  4. 查看工作簿中的界面图,核对入口、气泡、突破/破境、淬体、成仙路、奖励弹框、境界一览和排行展示。
  5. v0.98-破境雷劫作为版本依赖文档,明确其完整玩法不属于 v0.9.7 验收范围。

9.2 方案生成流程

flowchart TD
    A[读取课件与需求材料] --> B[归一化业务规则]
    B --> C[建立境界/灵气/飞升/淬体状态模型]
    C --> D[映射 Unity/PB/Erlang/存储链路]
    D --> E[使用 5W2H 与 SWOT 识别风险]
    E --> F[按风险选择功能与非功能策略]
    F --> G[生成范围、计划、团队、风险与验收标准]
    G --> H[检查版本边界、配置项和数据一致性]
    H --> I[输出评审型 Markdown]

9.3 可复用提示词

以下提示词用于复现方案设计方法,记录的是公开的工作步骤和判断维度,不包含隐含的逐步思维过程。

需求拆解

作为资深手游测试工程师,请把以下功能需求拆解为:用户场景、状态机、配置项、跨系统依赖、接口交互、数据一致性风险和异常恢复点。请区分已定案规则、可配置规则和待确认规则,不要擅自补全未提供的业务结论。

测试方案架构

按照测试方案作业模板输出:项目概述、5W2H、SWOT、质量挑战、功能策略、至少两类非功能策略、测试范围、时间计划、资源分配、团队能力、风险应对、成功标准、交付物和复盘。文档面向评审,但每个模块必须提供代表性测试场景和可验证断言。

技术栈映射

针对 Unity 客户端、Lua/C# 逻辑、Erlang 服务端和 PB API,设计分层测试:客户端交互、协议契约、服务状态机、配置、数据库/缓存、端到端、兼容性、性能、安全和稳定性。接口字段未知时只描述契约类别、校验点、错误码和幂等要求,不虚构字段名。

版本边界审查

检查测试方案是否明确当前版本与后续版本的边界,特别审查入口、状态、资源扣除、失败回退、灰度开关、旧客户端兼容和回滚方案。把依赖后续版本的完整玩法拆成当前版本的交接验证与后续版本的专项验证。

完成前自检

逐项检查方案是否覆盖:边界值、状态转换、异常流、重试幂等、并发、多设备、断线恢复、配置一致性、跨服务对账、目标设备、性能基线、安全校验、验收标准和 Agent 设计记录。输出缺口清单并修正文档结构。

9.4 设计假设

  • 未提供真实团队规模、发布日期、线上机型分布和最终 PB 字段,方案使用模拟基线并显式标注。
  • 工作簿中标注“暂定”“可配置”“具体看新手引导/战斗策划”的内容列为需求确认项。
  • 详细渡劫玩法属于 v0.98,不在 v0.9.7 的完整功能验收范围内。
  • 本文档面向评审与执行拆解,不替代完整测试用例集。

9.5 外部兼容性参考