From f14e74c8ce9807f043caf1c5ae140e4051fc1bb8 Mon Sep 17 00:00:00 2001 From: class04f27 Date: Thu, 24 Sep 2026 03:35:01 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=20README=EF=BC=88?= =?UTF-8?q?=E7=8E=A9=E6=B3=95=E3=80=81=E6=93=8D=E4=BD=9C=E3=80=81=E5=AE=9E?= =?UTF-8?q?=E7=8E=B0=E8=A6=81=E7=82=B9=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 57 insertions(+), 2 deletions(-) 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