该技能用于在玩家真实接触游戏的方式下验证 Three.js 浏览器游戏,并准备可发布构建及已知风险记录。
用途与检查流程:完整游戏走完整 QA 流程,局部修改只选覆盖受影响行为、状态和目标视口的检查,可复用同一代码版本的专项证据。步骤包括安装依赖、运行构建与类型检查、启动 dev 或 preview 服务器;打开浏览器目标并捕获控制台、页面与网络错误;确认画布像素非空白且视觉有变化;在目标视口(默认桌面与移动端)捕获实际游玩画面而非标题页;操作主要输入、目标推进、失败与重试及最近改动;检查 HUD 文本适配、安全区、触摸目标与响应式布局;若音频变化则检查用户手势解锁、音效触发、环境音起停、暂停重启清理、静音与音量、解码错误。
画布检查命令示例:node <this-skill-dir>/scripts/inspect-threejs-canvas.mjs --manifest artifacts/evidence.json --url http://127.0.0.1:5188 --seed 42。需先在 artifacts/evidence.json 声明视口/状态对并使用新 run ID;单次检查可用 --state <name> [--mobile]。
发布流程:检查 package scripts、Vite 配置、base path 与公共资源;屏蔽 debug UI、日志与测试辅助;运行生产构建并在静态服务器上预览;在目标视口检查构建产物;审查包体与大型资源;记录部署命令、托管假设与剩余风险。
适用场景为发布前 QA、移动端验证、性能证据与视觉回归保护。限制:截图本身不足以覆盖玩法变化;空白画布或错误条件会以非零退出;通过像素与状态钩子不代表审美质量或玩法成功。详情需参考技能目录下的说明文件。