Write project README with gameplay and tech notes

This commit is contained in:
2026-10-13 03:40:54 +00:00
parent 664d503eca
commit 68d2f44aea
+59 -2
View File
@@ -1,3 +1,60 @@
# 2048-game # 2048 · 数字合并
2048 number-merge puzzle game in a single HTML file 一个用纯 HTML + CSS + 原生 JavaScript 写成的 **2048** 小游戏,**单文件、零依赖**,双击 `index.html` 即可开玩。
## 游玩
在线打开:<https://gitea.compute-thinking.cn/class04f19/2048-game/raw/branch/main/index.html>
或克隆到本地:
```bash
git clone https://gitea.compute-thinking.cn/class04f19/2048-game.git
cd 2048-game
# 打开 index.html
```
## 操作
| 操作 | 按键 |
| --- | --- |
| 移动方块 | `↑` `↓` `←` `→` 或 `W` `A` `S` `D` |
| 触摸滑动 | 手机 / 平板在棋盘上滑动 |
| 撤销一步 | `Z` 或点「↩ 撤销」 |
| 重新开始 | `R` 或点「新游戏」 |
## 玩法
- 所有方块朝同一方向滑动,**两个数字相同的方块相撞会合并成它们的和**。
- 每次有效移动后,空白格会随机出现一个 `2`(90%)或 `4`(10%)。
- 目标是拼出 **2048**。达成后可选择「继续挑战」冲击更大数字。
- 棋盘填满且**任意相邻两格都无法合并**时游戏结束。
- 最高分通过 `localStorage` 保存在本地浏览器。
## 功能亮点
- ✅ **丝滑动画**:方块滑动用 `transform` + CSS transition;新方块缩放出现;合并方块「弹一下」
- ✅ **撤销**:内置 20 步历史快照,手滑了也能救回来
- ✅ **最高分持久化**:本地记录,刷新不丢
- ✅ **双端适配**:键盘 + 触摸滑动,棋盘随容器等比缩放
- ✅ **完整状态机**:达成 2048 弹窗、无路可走判定、继续挑战
## 技术实现
- **数据模型**:`grid[4][4]` 存放方块对象 `{ id, value, r, c, el }`,每个方块对应一个 DOM 元素。
- **移动算法**:按移动方向决定遍历顺序(从目标边开始),每个方块先「滑到最远空格」,再判断下一格是否可合并;用 `mergedIds` 集合保证同一回合内一个方块只被合并一次。
- **动画同步**:合并时数据立即更新(保证后续逻辑正确),视觉上让旧方块先滑到目标格,`110ms` 后再移除旧元素并让新数值弹出——这就是经典的 2048 合并手感。
- **尺寸自适应**:`ResizeObserver` 监听棋盘尺寸,用 JS 计算 `gap / cell` 并以 CSS 自定义属性下发,方块用 `translate(var(--x), var(--y))` 绝对定位,任意屏幕下都能精确对齐。
- **零依赖**:没有引入任何框架或库,全部原生实现。
## 项目结构
```
.
├── index.html # 游戏本体(HTML + CSS + JS 全在这一个文件里)
└── README.md
```
## 许可
MIT