docs: 补充 README(规则、计分、操作、实现要点)

This commit is contained in:
2026-09-24 03:41:45 +00:00
parent e49bb4212f
commit fb807dbd3d
+81 -2
View File
@@ -1,3 +1,82 @@
# neon-tetris
# 霓虹俄罗斯方块 · Neon Tetris
霓虹俄罗斯方块 · Neon Tetris —— 单文件 HTML5 俄罗斯方块(SRS 旋转 / 7-bag / Hold / 幽灵块 / 连消)
一个**零依赖、单文件**的 HTML5 俄罗斯方块。打开 `index.html` 就能玩,键盘和手机触屏都支持。
用的是**现代俄罗斯方块(Guideline / SRS)**那一套规则,不是简化版:SRS 旋转 + 踢墙、7-bag 随机器、Hold 暂存、幽灵块、锁定延迟、连消加成。
## 玩法与规则
| 机制 | 说明 |
| --- | --- |
| **SRS 旋转** | 采用标准 Super Rotation System 出生朝向与踢墙表,贴墙、贴地的旋转都能转进去;I 块有独立的踢墙表 |
| **7-bag 随机器** | 每 7 个方块为一袋随机排列,保证不会出现长时间不出 I 块、也不会长时间重复同一种 |
| **Hold 暂存** | `C` 或点击 HOLD 框,把当前方块存起来 / 取出,每个方块落地前只能用一次 |
| **幽灵块** | 半透明轮廓显示方块会落在哪里 |
| **锁定延迟** | 落地后有 500ms 缓冲,期间移动/旋转会重置计时(最多 15 次),可以放心做最后调整 |
| **7 种方块** | I / J / L / O / S / T / Z,各有独立霓虹配色 |
| **等级** | 每消 10 行升一级,共 20 级,下落速度从 700ms/格加快到 50ms/格 |
## 计分
| 行为 | 分数 |
| --- | --- |
| 消 1 / 2 / 3 行 | 100 / 300 / 500 × 等级 |
| **Tetris(消 4 行)** | 800 × 等级 |
| 连消(连续几次落子都消行) | 额外 50 × 连击数 × 等级 |
| 软降 | +1 / 格 |
| 硬降 | +2 / 格 |
最高分存在浏览器 `localStorage` 里。
## 操作
| 操作 | 键盘 | 触屏 |
| --- | --- | --- |
| 左右移动 | `←` `→` / `A` `D` | 下方 ← → |
| 软降 / 硬降 | `↓` / `空格` | ↓ / ⤓ |
| 顺时针 / 逆时针 | `↑` `X` / `Z` | ↻ / ↺ |
| 暂存 | `C` | 点击 HOLD 框 |
| 开始 / 暂停 | `空格` `Enter` / `P` `Esc` | 点按钮 |
切到别的标签页会自动暂停;右上角可以关音效。
## 运行
方式一,直接双击 `index.html`。
方式二,起个本地静态服务:
```bash
python3 -m http.server 8000
# 然后打开 http://localhost:8000
```
方式三,部署到 Gitea Pages / GitHub Pages / 任意静态托管,仓库根目录当站点根目录即可。
## 实现要点
- **Canvas 2D + 分层缓存**:棋盘(已固定的方块)画在一张离屏 canvas 上,只在方块落地/消行时重绘;每帧只 `drawImage` + 画当前方块和幽灵块。这样即使每个方块都带 `shadowBlur` 霓虹发光,也不会每帧重算 200 次阴影,低端手机也能跑满帧。
- **帧率无关的更新循环**:用 `requestAnimationFrame` 的 `dt` 驱动重力累积器、锁定延迟计时、消行动画和震屏衰减,切标签页回来不会瞬移。
- **状态机**:`ready → playing ⇄ paused`、`playing → clearing → playing`、`→ over`。消行时进入 `clearing` 状态播 190ms 的闪白动画,之后再压缩棋盘并生成新方块,逻辑与表现分离。
- **踢墙表用屏幕坐标**:SRS 官方表的 y 轴向上为正,代码里 y 向下为正,所以表里的 y 全部取反后直接写进代码,避免运行时反复换算出错。
- **旋转矩阵**:`new[y][x] = old[n-1-x][y]`;逆时针就把顺时针做三次(矩阵只有 3×3 / 4×4,够快且不易写错)。
- **音效全部 WebAudio 现场合成**,整个游戏没有一个外部资源文件。
- **响应式布局**:棋盘宽度用 `min(94vw, 320px, (100dvh - 预留高度)/2)` 计算,保证 10×20 的棋盘在任何屏幕上都不被裁切;只有触屏设备才显示虚拟按键。
## 文件
```
.
├── index.html # 全部代码:结构 + 样式 + 游戏逻辑
└── README.md
```
## 可以继续加的东西
- T-spin 判定与加分、Back-to-Back 连击
- 前 40 行竞速(Sprint)与限时(Ultra)模式
- 回放录制 / 在线排行榜
## License
MIT