# 连连气球 · v2 验证记录

日期：2026-09-15。当前版本为无关卡连消畅玩版。历史关卡验收见 [v1 存档](archive-v1/QA.md)。

## 自动检查

- 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](qa-v2/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](qa-v2/browser.json) · [production.json](qa-v2/production.json)。浏览器长局检查在物理平方距离优化前完成；优化后重新完成全部 3,200 次核心抽样、减少动态效果交互及正式包触摸检查。

## 布局

| 视口 | 结果 |
|---|---|
| 320 × 568 | 无横向溢出，页面高 650，可滚动到工具栏 |
| 360 × 740 | 完整布局 |
| 390 × 844 | 完整竖屏，主触摸验收尺寸 |
| 430 × 932 | 完整布局 |
| 844 × 390 | 保持竖屏面板，可纵向滚动 |
| 1280 × 900 | 居中面板与桌面气球插画 |

上述尺寸下主要按钮均至少 44 × 44 CSS 像素。数值见 [layout.json](qa-v2/layout.json)。

截图：[当前开局](qa-v2/mobile.png) · [3 连消](qa-v2/first-merge.png) · [彩虹](qa-v2/rainbow.png) · [放飞后](qa-v2/flight.png) · [帮助](qa-v2/help.png) · [桌面](qa-v2/desktop.png)。

浏览器验收脚本为 `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](HANDOFF.md)。