教学代码、构建与验证记录
本页记录本项目实际检查的对象和口径。教材中的验收清单描述应该怎样检查,本页与仓库 VALIDATION.md 记录实际执行结果。源码改变后,对应结果需要重新验证,不能沿用旧产物证明新实现。
三组教学材料
| 材料 | 代码位置 | 验证对象 |
|---|---|---|
| 十个站内实验 | src/lab/Laboratory.tsx、src/lab/rules.ts | Canvas表现、参数变化、重置与交互 |
| 共享战斗规则 | src/lab/arenaRules.ts、tests/rules.test.ts | 状态、时间、伤害、波次和暂停 |
| Cocos竖屏试炼 | examples/arena/ | 场景入口、引擎表现与Web/微信构建 |
站内实验是浏览器教学实现。网络和离线权益使用可解释的模拟模型,不连接真实业务服务;无真实广告和支付。生产实现需要接入权威服务、平台能力、失败恢复与相应验收。
可复现命令
npm ci
npm run typecheck
npm test
npm run check:content
npm run build
npm run serve -- --port 3028
# 本机具备Cocos Creator3.8.8时
npm run cocos:web
npm run cocos:wechat
Cocos可执行路径通过 COCOS_CREATOR 覆盖。Web构建脚本将发布材料同步到站点 static/cocos-arena/。微信产物保存在 examples/arena/build/wechatgame/,默认游客AppID用于教学构建;正式预览、上传和平台能力验证须使用自己的小游戏项目与权限。
行为检查覆盖面
规则测试覆盖帧率差异、高速跨墙、A*路径约束、消除去重、离线收益边界、对象池容量、预测确认收敛、暂停与攻击命中去重。实验界面还需要核对Canvas、按钮、参数和可见状态的一致性。文本状态由 render_game_to_text() 导出,时间推进钩子 advanceTime(ms) 便于重现操作。
竖屏试炼的输入是WASD/方向键、空格攻击;触摸提供方向按钮和攻击按钮。完整测试路径包括开始、移动、攻击、受击、敌人死亡、波次推进、胜利/失败、暂停/继续、重试和记录恢复。它使用程序化几何美术,重点是能看清规则与表现的连接。
环境边界
本次已通过12项纯规则测试、站点类型与内容检查、84篇静态构建、十项浏览器实验,以及Cocos三波胜利/失败/重试完整路径。Creator3.8.8的Web与微信双目标均构建成功;Web版已在隔离Chrome中真实运行。源码仓库的VALIDATION.md记录命令、覆盖与限制。微信开发者工具和真机未执行。
浏览器通过只说明Web环境;微信包生成只说明构建链路。开发者工具服务端口、账号登录和AppID权限,以及手机扫码与真实设备反馈,属于独立验收条件。没有实际执行的检查不能记为通过。
涉及设备性能时,记录设备型号、系统、微信、基础库、引擎、构建SHA、负载和采样窗口。涉及平台权益时,还需要确认回调、业务请求、幂等记录和真实账户结果。模拟值不能作为生产收益或安全方案。
怎样添加自己的证据
检查对象:功能/实验名称
版本:提交SHA、构建目标、引擎与工具版本
环境:浏览器或设备/系统/微信/基础库
步骤:从重置状态开始的精确操作
预期:状态、位置、次数、时序与画面
实际:观察结果、日志和截图路径
结论:通过/失败/未执行,及覆盖边界
对于失败,保留第一条相关异常和最小复现。对于修复,记录重新运行原失败路径和受影响相邻场景的结果。把验证记录与源码版本关联,才能在AI继续开发、工具升级或新设备上线后判断是否需要复验。
来源
本页命令对应本项目实现,完整实际执行记录保存在仓库验证文档。核查基线:2026-11-17。