cabinw
8026e4628d
- 玩法一 数字一笔：规则库、求解器、26 关、竖屏触摸 Web 原型、测试 - 玩法二 连连气球：连消畅玩版核心、Web 原型、Cocos 球槽组件与导出脚本 - 玩法三 六边一笔：规则库、求解器、10 关 + 转墙实验包、Web 原型、测试 - 产品文档、UI 设计规范、各玩法 GDD / HANDOFF - 文档移除全部外部参考作引用；删除玩法二 v0 旧稿
4.0 KiB
4.0 KiB
历史存档：关卡版 v1，已由连消畅玩版替换。当前规则见 GDD。
验证记录
日期：2026-09-15。当前实现的验证范围如下；未将浏览器触摸模拟称为实体手机测试。
自动检查
npm run check 全部通过：
- 两套 TypeScript 检查通过，其中
src/不含 DOM / Node 类型。 - 23 项测试通过：规则、升降序、拒绝非法链、落点、最后一步成功、确定性重试、撤销、快速划线、取消、打乱、死局、失败、存档容错、十关触摸路线、帧率无关动画。
- 10 / 10 关使用固定种子逐步回放通过；验证同时经过
Gesture，避免“规则上合法、实际划线无法选中”的假解。 - 1,225 个稳定盘面通过边界与圆形重叠检查，含 1,046 次随机合成；最大数值穿透 0.772 逻辑像素（验收阈值 2px）。随机自由局自然结束；这批样本中最长连续局为 18 次合成。
- 所有挑战关的开局与补球数字都在 1–4，最终通过正常合成得到 8。
- 生产构建成功，JS 约 33 KB（未 gzip），不包含开发观察端口。
- 独立
release/正式包在端口 8003 实际完成第一关触摸合成（1,200 分，余 2 步），确认无开发观察端口，并已清理测试成绩、恢复第一关开局。见 production.json。
详细关卡逐步数字、球 ID、分数、步数与压力检查统计见 validation.json。搜索给出的是一条可行路线，非唯一解、非最优解证明。
浏览器触摸验收
Ego Chromium，390 × 844 移动视口，使用 CDP Input.dispatchTouchEvent 产生浏览器输入：
- 从 第 1 关实际连续游玩到第 10 关，没有直接修改分数、盘面或过关状态。
- 验证两颗松手不扣步、TOUCH_CANCEL 不提交、滑回上一颗撤回。
- 确认十关依次解锁、最终结果为 10 / 10、存档记录 30 / 30 星。
- 页面错误和未处理 Promise 拒绝记录为 0。
- 后续刷新验证成绩保留；实际点按钮验证撤销和重走完全一致、打乱不扣步且保留数字、撤销恢复打乱库存。
- 自由模式实际完成合成且步数保持无限；帮助面板可用 Escape 关闭。
- 抽取动画为跨平台模块后，再次通过浏览器验证合成、撤销、重走和打乱。
结果见 browser.json、layout.json。tools/browser-*.mjs 是本次验收脚本，使用 GARDEN_SPACE 指定当前已有的 Ego QA 空间、GARDEN_QA_DIR 指定输出目录；应使用独立测试存档，先跑通关脚本再跑布局脚本。
尺寸检查
| 视口 | 结果 |
|---|---|
| 320 × 568 | 无横向溢出；页面高 650px，可纵向滚动触及底栏 |
| 360 × 740 | 完整布局，主要按钮 ≥ 44px |
| 390 × 844 | 完整布局，触摸通关主测试尺寸 |
| 430 × 932 | 完整布局，主要按钮 ≥ 44px |
| 844 × 390 | 横屏仍可操作，可纵向滚动 |
| 1280 × 900 | 居中竖屏游戏面板与桌面背景 |
截图：开局 · 后段关卡 · 帮助 · 选关 · 全通关 · 桌面。
Cocos 迁移检查
npm run cocos:check 通过：
- 生成独立的 Creator 导入目录。
- 使用本机 Cocos Creator 3.8.8 的真实
cc.d.ts检查核心、数据与适配组件，非手写模拟类型。 - 球槽坐标转换、Graphics、Label、触摸 API 均通过类型检查。
仍需后续移植阶段完成：Creator 场景实际运行、Cocos UI 面板搭建、原生 Android/iOS 与目标小游戏平台验收。当前不宣称这些工作已完成。
难度判断的范围
难度梯度由教学目标、解的步数、容错余量、长链和多轮合成要求制定，已验证全部关卡可通关。尚未做多人试玩统计，平均通关耗时、提示使用率、玩家卡关分布需要后续试玩采样。