diff --git a/README.md b/README.md index b064b20..5cc5373 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,58 @@ -# neon-snake +# 霓虹贪吃蛇 · Neon Snake -霓虹贪吃蛇 · Neon Snake —— 单文件 HTML5 霓虹风格贪吃蛇小游戏(键盘 + 触屏) \ No newline at end of file +一个**零依赖、单文件**的 HTML5 霓虹风格贪吃蛇小游戏。打开 `index.html` 就能玩,键盘和手机触屏都支持。 + +![单文件](https://img.shields.io/badge/单文件-index.html-39ffd0) ![依赖](https://img.shields.io/badge/依赖-无-7c5cff) + +## 玩法 + +- 方向键 / `WASD` 控制方向,不能 180° 掉头 +- 🟠 **橙色方块**:+10 分,蛇身 +1 节 +- 🟡 **金色方块**:+30 分,蛇身 +2 节,但 **8 秒内不吃就会变回橙色**(外圈圆环是倒计时) +- 撞墙、咬到自己 → 游戏结束 +- 吃得越多速度越快(135ms/步 → 最快 62ms/步) +- 分数越高越刺激,最高分自动存在浏览器 `localStorage` 里 + +## 操作 + +| 操作 | 键盘 | 触屏 | +| --- | --- | --- | +| 移动 | 方向键 / `WASD` | 滑动屏幕,或点下方方向键 | +| 开始 / 继续 | `空格` `Enter`,或点按钮 | 点击屏幕,或点按钮 | +| 暂停 | `P` / `Esc` | 点击屏幕 | +| 音效开关 | 右上角 🔊 | 右上角 🔊 | + +切到别的标签页会自动暂停。 + +## 运行 + +方式一,直接双击 `index.html`。 + +方式二,起个本地静态服务: + +```bash +python3 -m http.server 8000 +# 然后打开 http://localhost:8000 +``` + +方式三,部署到 Gitea Pages / GitHub Pages / 任意静态托管,把仓库根目录当站点根目录即可(`index.html` 已在根目录)。 + +## 实现要点 + +- Canvas 2D 渲染,逻辑分辨率 `24 × 24` 格、每格 `28px`(672×672),CSS 等比缩放,`devicePixelRatio` 无关,移动端不糊 +- 固定步长 + 累积器的游戏循环,渲染与逻辑解耦,高速时也不会"穿墙" +- 蛇身用**单条 path 多次 stroke**(外发光 / 渐变主体 / 白色高光核心),比逐格画圆角矩形快很多 +- 输入用长度为 2 的**方向缓冲队列**,避免快速连按时的反向自杀 +- 音效用 WebAudio 现场合成,不需要任何音频文件 + +## 文件 + +``` +. +├── index.html # 全部代码:结构 + 样式 + 游戏逻辑(约 15KB) +└── README.md +``` + +## License + +MIT