Files
NumberSwipe_New/modes/02-connect-1234/README.md
T
cabinw 8026e4628d 初始提交:三玩法 Web 原型与设计文档
- 玩法一 数字一笔:规则库、求解器、26 关、竖屏触摸 Web 原型、测试
- 玩法二 连连气球:连消畅玩版核心、Web 原型、Cocos 球槽组件与导出脚本
- 玩法三 六边一笔:规则库、求解器、10 关 + 转墙实验包、Web 原型、测试
- 产品文档、UI 设计规范、各玩法 GDD / HANDOFF
- 文档移除全部外部参考作引用;删除玩法二 v0 旧稿
2026-09-16 14:30:59 +08:00

58 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 玩法二 · 连连气球
竖屏触摸连消合成游戏。连接顺号或同号气球,松手变大,周围和新掉落的气球自动接力。当前版本以连续合成、造大数、放飞为主循环,无关卡、步数或计时限制。
## 直接玩
```bash
cd modes/02-connect-1234
npm install
npm run dev
```
开发预览 **http://localhost:8002**;当前正式包 **http://localhost:8003**。手机同一 Wi-Fi 访问终端打印的局域网地址。可用 `npm run dev -- --port 8012` 改端口。
```bash
npm run check # 类型、规则、连续游玩抽样、物理、生产构建
npm run cocos:check # 导出核心和组件,检查本机 Creator 真实类型
```
`npm run build` 生成独立 `release/`,可以静态托管或离线打开 `release/index.html`。重新启动正式包预览:`python3 -m http.server 8003 --directory release`。无运行时第三方依赖、网络素材或服务器接口。
## 现在怎么玩
- 连接至少 3 颗相邻气球:`1→2→3`、`3→2→1` 或 `2→2→2`;两种规则不能混在一条里。
- 松手在末端合成最大数 +1。新气球能接上周围或刚掉下来的数字时,自动继续,最多 3 连消。
- 长链与连消攒满彩虹能量,接下来 5 次手势双倍得分,最多 4 连消;不限时间。
- 合成 10 自动放飞,额外 +10,000 分,腾出空间继续。
- 补球按连续数字成袋准备,试算落点后优先选择容易接力的位置;无路可连时自动微风补救。
- 提示、撤销、吹口气均免费。滑回上一颗撤回,取消触摸不会提交。键盘 `H` 提示、`Z` 撤销、`Esc` 关闭面板或取消手势。
- 本地保存最高分、最大气球、最高连消及单局放飞纪录;不保存中途盘面。
## 可移植结构
```text
src/flow.ts 畅玩状态、合成与掉落时间线、能量、完整撤销
src/flow-rules.ts 顺号/同号规则与合法链搜索
src/cascade.ts 自动接力和连消分数
src/supply.ts 成袋配号、落点选择、微风救场
src/flow-animation.ts 合成与物理下落重放
src/physics.ts 固定步长圆形物理
src/input.ts 可注入规则的手势控制器
src/view.ts 气球的跨平台绘制指令
src/record.ts v2 纪录(通过 StoragePort 读写)
web/ Canvas、触摸、声音和 HTML UI
cocos/ Creator 3.8 组件与导出包
```
核心是无 DOM / Node / Cocos 依赖的 TypeScript,`tsconfig.core.json` 持续检查隔离。两端共用规则、数字补给、手势、物理和动画,移植时重建宿主 UI 即可。与玩法一、三互不引用。
## 文档
- [当前玩法设计](docs/GDD.md)
- [Cocos 接入说明](docs/HANDOFF.md)
- [验证记录](docs/QA.md) · [连续游玩原始统计](docs/qa-v2/validation.json)
- [竖屏截图](docs/qa-v2/mobile.png)
旧关卡代码、题库和测试保留为历史实验,不进入当前 Web 入口及 Cocos 导出包。历史文档在 [archive-v1](docs/archive-v1/GDD.md),旧回放可运行 `npm run validate:legacy`。旧存档不会被新纪录覆盖。