cabinw
8026e4628d
- 玩法一 数字一笔：规则库、求解器、26 关、竖屏触摸 Web 原型、测试 - 玩法二 连连气球：连消畅玩版核心、Web 原型、Cocos 球槽组件与导出脚本 - 玩法三 六边一笔：规则库、求解器、10 关 + 转墙实验包、Web 原型、测试 - 产品文档、UI 设计规范、各玩法 GDD / HANDOFF - 文档移除全部外部参考作引用；删除玩法二 v0 旧稿
4.5 KiB
连连气球 · v2 验证记录
日期：2026-09-15。当前版本为无关卡连消畅玩版。历史关卡验收见 v1 存档。
自动检查
- TypeScript Web 和纯核心检查通过；核心检查不加载 DOM / Node 类型。
- 37 项测试通过：14 项覆盖当前顺号/同号、连消分数、补球接力、彩虹五次、放飞、预告、撤销与随机确定性、微风救场、动画跳帧、存档和拥挤物理回归；23 项保留 v1 及共用代码回归。
- 3,200 次操作、3,232 个稳定盘面通过：唯一 ID、合法数字、边界、圆形重叠和至少一条可连路线。
- 最大数值穿透 1.174 逻辑像素，阈值为 2px；气球外观比碰撞圆略窄。针对种子 6559 的拥挤盘面保留回归数据，补球稳定阶段增加了约束迭代。
- 物理先判断平方距离，仅对接触球开方，降低补球试算成本。
- 生产包构建成功，JS 29,024 字节（未 gzip），没有开发观察接口。
连续游玩抽样
每局连续操作 100 次；不调用免费工具跳过难盘。无路时由核心自动微风处理，次数列在表内。
| 策略 | 局数 / 操作数 | 触发连消 | 每局放飞 | 自动微风 | 本机提交耗时中位数 / P95 |
|---|---|---|---|---|---|
| 从合法链随机抽取 | 24 / 2,400 | 812，33.8% | 3–5 颗 | 161 | 8.5 / 16.7 ms |
| 沿提示路线 | 8 / 800 | 499，62.4% | 5–8 颗 | 46 | 8.5 / 15.3 ms |
32 局都玩满 100 次，全部至少合成过 10。提示策略每次还通过 Gesture 实际路线采样，验证链条确实能按球心滑出。
这是固定种子算法抽样，不是玩家行为统计，也不是无死局的数学证明。随机策略对搜索出的合法链抽样；提示策略更偏向长链和即时连消。耗时来自当前开发机，手机端需另测。
完整种子、分数、放飞和性能数据见 validation.json。复现：npm run validate。
浏览器与正式包
使用 ego-browser Chromium，390 × 844 移动视口，CDP Input.dispatchTouchEvent 输入：
- 实际连续完成 24 次触摸合成，达到 317,500 分，最高数字 10，放飞 1 颗；触发彩虹双倍及多连消，过程未弹出关卡/失败面板。
- 验证不足三颗、触摸取消、划回上一颗均不提交。
- 合成后撤销并重走，完整盘面、队列、随机数、分数与能量相同。
- 微风不扣分或能量，撤销恢复原局面。
- 页面错误和未处理 Promise 拒绝为 0。
- 帮助、纪录、重开和 Escape 关闭面板可用。
- 系统减少动态效果时，手势可正常提交，立即显示最终状态；横幅不依赖动画才能可见。
- 正式包 http://localhost:8003 使用真实触摸完成首轮合成，得到 10,000 分；刷新后纪录保留，开发观察接口不存在。验收后恢复验收前的 v2 纪录，旧 v1 存档保持原样。
结果：browser.json · production.json。浏览器长局检查在物理平方距离优化前完成；优化后重新完成全部 3,200 次核心抽样、减少动态效果交互及正式包触摸检查。
布局
| 视口 | 结果 |
|---|---|
| 320 × 568 | 无横向溢出，页面高 650，可滚动到工具栏 |
| 360 × 740 | 完整布局 |
| 390 × 844 | 完整竖屏，主触摸验收尺寸 |
| 430 × 932 | 完整布局 |
| 844 × 390 | 保持竖屏面板，可纵向滚动 |
| 1280 × 900 | 居中面板与桌面气球插画 |
上述尺寸下主要按钮均至少 44 × 44 CSS 像素。数值见 layout.json。
截图：当前开局 · 3 连消 · 彩虹 · 放飞后 · 帮助 · 桌面。
浏览器验收脚本为 tools/browser-flow*.mjs。其中空间 ID 4 是本次已有 QA 空间；重新验收时应先创建自己的一个 QA 空间并替换 ID，再通过 ego-browser nodejs < 脚本 执行，不能接管已交还用户的空间。正式包脚本只恢复它自己产生的测试纪录。
Cocos
npm run cocos:check 通过：导出当前核心与 Connect1234Board，使用本机 Creator 3.8.8 的真实 cc.d.ts 检查触摸、坐标转换、Graphics、Label 描边、事件和状态接口。导出目录不含旧关卡模块或题库。
尚未验收：Creator 场景运行、实体手机触摸与性能、Android/iOS 和小游戏平台原生包。接入步骤及宿主 UI 工作见 HANDOFF。