跳到主要内容

案例验收:从需求矩阵到故障证据

这是一份验收方法,不是通过报告​

本页说明竖屏试炼应该怎样验证。实际执行时间、环境、结果和证据统一记录在教学代码、构建与验证报告及仓库验证文档。源代码存在、测试文件存在、命令能够启动,都不等于对应行为已经通过。修改源码后,旧截图和旧构建也不能自动证明新版本正确;每份证据要能关联到明确版本。

验证分成领域规则、浏览器表现、Cocos 构建、微信开发者工具和真机几个层次。规则测试适合确认状态与时序,浏览器适合检查输入和画面,构建适合发现资源与脚本集成问题,微信与真机适合验证平台生命周期、触摸、音频、存储和设备性能。它们互相补充,不用一个绿色结果替代所有层次。

先从干净初态开始,记录版本、配置、运行目标和操作。确定性规则要保存输入序列,画面问题要保留截图或录屏与对应文本状态。失败时先抓第一条相关异常,后续报错可能只是连锁反应。修复后重新运行原失败路径,再检查直接受影响的邻近场景,不必无目的重复全部性能测试。

需求到证据的最小矩阵​

需求操作或注入可观察预期主要层次
开始与重试从准备、胜、负状态开始生命 5、波次 1、击杀 0规则与界面
方向归一化同时按横纵方向斜向总速度不额外增大规则
移动边界持续向各边移动坐标停在规定界限内规则与画面
动作阶段开始攻击并小步推进依次前摇、有效、后摇、空闲规则与画面
命中去重有效期内持续重叠同攻击只扣同目标一次规则
受击无敌多敌人同时接触无敌期内不重复掉血规则与画面
暂停恢复各阶段暂停并等待计时与位置保持,继续后推进全链路
波次推进清空当前有效敌人等待后下一波,三波结束获胜规则与界面
失败优先注入同帧致命条件只产生失败结果规则
本地最高分结算、重载、存储失败最高击杀不下降,失败仍可玩适配层

表格描述预期,不表示已经执行。自动测试可以直接构造一个敌人在范围内的状态,避免必须手动游玩数分钟才能检查一次命中。界面检查则从普通入口进入,不跳过导航和输入,因为这些恰好是模型测试没有覆盖的部分。两种方法都保留,才能知道异常来自规则还是适配。

怎样重放规则​

共享规则在 src/lab/arenaRules.ts,行为测试入口是 tests/rules.test.ts。从 createArena、startArena 开始,以固定小步调用 stepArena,检查状态和计数。单次 dt 会被限制,不能传入一秒就期待推进整秒。范围与时间边界分别取边界前、恰好边界和边界后,验证比较符号与离散步语义。

已有测试源码包含暂停冻结、移动边界、重开初态、同次攻击去重和击杀计数的检查。这个描述只说明测试覆盖意图,运行结果仍以实际报告为准。扩展无敌、波次与存储测试时,优先验证业务性质,不逐行复刻实现。比如“同次攻击最多扣一血”比“某个私有函数被调用一次”更能保护未来重构。

用文本钩子核对画面​

Cocos 适配层提供 render_game_to_text(),导出坐标说明、规则状态与最高记录;advanceTime(ms) 便于按小步手动推进。它会进入手动模式,后续普通帧不再自动推进,因此完成自动化后应重新加载恢复正常玩法。测试工具若忽略这个边界,可能把预期的手动暂停误报为游戏卡死。

每次截图同时记录文本状态,核对玩家位置、攻击阶段、生命与敌人数是否一致。攻击扇形应与方向和范围匹配,覆盖层只在非运行状态出现,文字不能挡住必要操作。正式美术替换后重新检查几何与视觉关系,不沿用几何角色的截图证明新素材可读。桌面站点的排版验收也与手机游戏的触摸验收分开。

故障注入比理想演示更重要​

先在每个动作阶段隐藏窗口,再恢复,确认不会跳过前摇、继续掉血或残留方向。快速暂停与继续、连续点击开始和重试,检查是否创建重复局或重复监听。触摸方向按住后取消、切后台、再返回,确认输入被清理。点击场地移动的目标会持续生效,这是当前规则,应与按住按钮移动分别检查。

存储注入读失败、写失败、无效文本与旧数值,确认游戏仍可开始,本地记录按既定策略处理。当前最高分不承担商业价值,容错可相对简单;若扩展可信资产,失败不能只吞掉异常。长时间运行检查实体、监听和资源趋势,少量重试没有增长只能作为抽样证据,不能证明所有泄漏不存在。

构建与设备怎样记录​

站点命令包括 typecheck、test、check:content 和 build;Cocos 对应 cocos:web 与 cocos:wechat。使用具体引擎路径和目标配置,记录退出结果及产物位置。微信包生成后,开发者工具是否登录、项目 AppID 与权限是否有效、预览是否能启动,都要独立检查。游客示例配置不是正式发布资格,构建通过也不证明可以上传或上线。

真机报告记录设备型号、系统、微信与基础库版本、构建版本、负载和采样窗口。检查触摸同时移动攻击、前后台、长宽比、存储恢复和持续运行性能。没有设备执行时就标记未执行,不用桌面截图填补。性能指标还要给采样方法和边界,平均帧率无法代表所有卡顿,启动、资源加载和峰值也可能是独立问题。

给 AI 的验证任务​

任务示例:“按本页矩阵检查当前竖屏试炼,先读取统一验证报告,避免重复已完成的同版本检查。补充本次改动影响的规则边界,运行可用命令并保留原始结果。浏览器、构建、开发者工具和真机分别报告,通过、失败、未执行不能混写。不得把模拟奖励或本地最高分描述成可信服务端。”

最终交付应能回答改了什么、依据哪条规格、在哪个环境验证、证据在哪里、还剩什么限制。失败项附最小复现与当前影响,未执行项附环境条件,不用笼统“基本通过”。这样的报告让后续 AI 能从可信状态继续工作,也让读者知道哪些知识来自原理、哪些来自本项目实际观察。

通过结论需要附覆盖边界​

“暂停通过”应该具体到前摇、有效期、后摇、波次等待和隐藏恢复中的哪些场景;“存档通过”应该说明读写了哪个键,是否包含重新启动与失败注入。过于宽泛的结论会让下一位开发者误以为无需再查。对当前小案例,检查记录可以很短,但需要足够让另一个人从相同初态重复操作并看到相同结果。证据不必华丽,准确的状态快照、命令退出结果和一张对应截图往往更有用。

把异常分成实现缺陷、需求歧义、环境限制和未执行,不要统一写成失败或统一忽略。需求歧义先明确期望,环境限制记录所缺条件,真正缺陷则给出最小复现。这样验证报告不仅说明质量,也能成为下一次 AI 任务的可靠输入,避免它为一个从未承诺的行为大范围重构。

来源与核查范围​

  • 本仓库规则、适配层、测试与验证记录,核查日期:2026-11-17。本页定义验收口径,不替代实际记录。
  • Cocos 3.8 生命周期回调,核查日期:2026-11-17。用于前后台与组件责任的理解,设备结果必须实测。