豪华平台跳跃 Knappen/platformer-deluxe

Platformer Deluxe

Platformer Deluxe 是一款无依赖的浏览器平台游戏，用 HTML5 Canvas、原生 JavaScript 和程序化 Web Audio 打造。内含三个手工设计的关卡、固定时间步长物理、键盘与触屏操作、敌人、收集品、检查点、连击计分、持久化最高分，以及实时性能显示。

这款游戏是早期本地平台游戏的独立升级版。原版保留不变；本仓库只包含 Deluxe 版。

本地游玩

环境要求：

- Node.js 20 或更高版本
- 现代桌面或移动浏览器

git clone https://github.com/Knappen/platformer-deluxe.git
cd platformer-deluxe
npm.cmd start

打开 <http://127.0.0.1:1339/deluxe>。服务器默认只监听 127.0.0.1。

在 Windows 上，Start-Platformer.cmd 提供同样的一键启动，双击即可运行。.cmd 入口能避开 npm.ps1 的 PowerShell 执行策略问题。

换一个端口，或显式允许局域网访问：

$env:PORT = "8080"
$env:HOST = "0.0.0.0"
npm.cmd start

暴露 0.0.0.0 后，主机防火墙允许的其他设备就能访问游戏。不需要远程访问的话，保持默认回环地址即可。

无需安装包、打包器、数据库、账号、遥测服务，也不用下载游戏素材。

操作

| 动作 | 键盘 | 触屏 |
| 移动 | 方向键或 A / D | 左右按键 |
| 跳跃 | Space、W 或上方向键 | 跳跃按键 |
| 暂停/继续 | P | — |
| 重新开始 | R | — |
| 静音/取消静音 | M | — |

按住跳跃键跳得更高。引擎还提供 100 ms 的土狼时间窗口和 120 ms 的跳跃缓冲，让平台边缘更宽容。

玩法

- 三个关卡：Verdant Steps、Copper Works 和 Sky Foundry
- 静态与移动平台
- 步行与飞行敌人
- 踩踏攻击与侧面受击伤害
- 金币、宝石、检查点、尖刺和目标旗
- 三条命，受击后短暂无敌
- 最高 5× 连击计分，带三秒衰减计时
- 按时间计算的通关奖励
- 通过浏览器 localStorage 持久化最高分
- 程序化合成音效，不含音频文件
- 窄屏/触屏设备上的响应式屏幕控件
- 浏览器请求减少动态效果时，减少粒子运动

技术设计

游戏渲染到逻辑尺寸 900×540 的画布，并按设备像素比缩放后备缓冲区。模拟采用 120 Hz 固定时间步长，累加器设有上限，让物理与显示器刷新率无关，也避免长时间闲置的标签页产生失控的追帧循环。

index.html
├── src/levels.js level geometry and entities
├── src/game.js state, physics, collision, camera, rendering
├── src/audio.js procedural Web Audio effects
└── src/input-touch.js pointer-based mobile controls
server.js 回环静态主机和 /deluxe 路由适配器

重要实现选择：

- 分轴 AABB 碰撞解算，限制角落穿透。
- 用加速度、空中控制和指数地面摩擦替代瞬时速度变化。
- 移动平台按每步增量带动玩家。
- 相机位置做平滑处理，并限制在关卡边界内。
- 背景层使用不同相机比例实现视差。
- 实时基准测试暴露平滑 FPS、帧时间、实体数量和绘制调用数。
- window.__platformer() 提供小型只读状态快照，供自动化验证使用。
- 静态服务器把解析后的文件路径限制在仓库根目录内。

更多细节见 Architecture。

构建过程

记录的构建在本地 Windows 工作站上的 DeepSeek Harness 中运行。升级请求开始于 2026 年 10 月 7 日下午 5:41:13 CDT，完成的交接记录于 10 月 8 日上午 8:29:16 CDT：墙钟耗时 14 小时 48 分 2.936 秒。构建阶段按请求加权的推导吞吐量为：首个 A3B 模型上 18.89 输出 tok/s，Coder IQ1 模型上 27.06 输出 tok/s。prefill/cache 吞吐量、公式、样本数量以及重要的可比性限制见基准测试文档。

那不是连续编码时间。该区间包含用户暂停、一次模型配置错误、一次模型切换、输出上限续写、一次传输中断、恢复检查点以及上下文压缩。Harness 记录整个会话共 386 个模型步骤、121,092 个解码 token、约 3 小时 10 分钟累计模型时间、约 5 小时 40 分钟累计工具时间。这些指标可能重叠，不能相加当作劳动时间。

记录的工作站配置为：

- Windows 10 Pro，build 19045
- Intel Xeon E5-2680 v4，28 个逻辑处理器
- 128 GB RAM
- NVIDIA Tesla P40（24 GB）加 Quadro P400（2 GB），驱动 582.53
- Node.js 24.21.0
- DeepSeek Harness 0.2.0-rc.2
- 两个本地 Qwen 模型：初始发现/规划阶段用 A3B Qwen 模型（记录的 Harness 标识符 qwen3.8-flash-next-iq3_s），随后用 Qwen 3.8 Flash Next Coder IQ1（qwen3.8-flash-next-coder-iq1_m）继续实现、修补、验证和收尾

私人对话记录、机器主机名、用户名、绝对私有路径和账户信息有意不包含在内。文档中的数字来自本地会话元数据，随后对照文件时间戳和运行中的应用独立核验。

工程时间线见 Build history，模型、工作负载、工具使用、输出、性能和方法论的详细数据见 Benchmark record。

验证

运行仓库冒烟测试： powershell npm.cmd test

Windows 用户也可以运行 Test-Platformer.cmd。

它会检查 JavaScript 语法，在隔离的回环端口上启动服务器，验证根路由和 /deluxe 路由，抓取每个浏览器资源，检查公开验证钩子，然后停掉子服务器。

最初的实时浏览器验收测试还验证了：

- /deluxe 返回 HTTP 200
- 视口内可见一块 900×540 的画布
- FPS 循环正常运行，约 60 FPS
- 按 Space 从标题状态进入游戏
- 没有浏览器页面错误、控制台错误或资源请求失败
- 本地门户里的项目卡片可正常工作

每次 push 和 pull request，GitHub Actions 都会在 Windows 和 Linux 上重复这套可移植冒烟测试。

托管在其他应用下

自带的服务器同时接受 / 和 /deluxe；页面自身请求的资源位于 /deluxe/src/ 下。因此反向代理或父应用应把这个目录挂载到 /deluxe，并从 /deluxe/src/* 提供 JavaScript 文件。

游戏没有后端状态。浏览器里的最高分只保存在浏览器源本地，绝不会发送到服务器。

仓库结构

| 路径 | 用途 |
| index.html | 响应式页面外壳、画布、基准测试显示和触摸控制 |
| src/game.js | 主引擎、模拟、游戏状态、渲染和键盘输入 |
| src/levels.js | 三个关卡定义 |
| src/audio.js | 程序化音效 |
| src/input-touch.js | 指针事件触摸控制 |
| server.js | 极简的防目录穿越 Node 静态服务器 |
| tests/smoke.mjs | 可移植的语法、HTTP 和源码完整性测试 |
| docs/ | 架构与基于证据的构建历史 |

隐私与安全

- 仓库不包含聊天记录或 Harness 会话存档。
- 仓库不包含凭据、token、私有账户数据、个人邮箱地址、邮箱数据、机器用户名或工作站的绝对路径。
- 游戏不发送任何分析或遥测数据。
- 默认服务器只绑定回环地址。
- 服务器刻意做得很小，适合本地开发；面向公网托管请使用持续维护的生产级 Web 服务器。

报告安全问题请使用 GitHub 的私密漏洞报告功能，不要开公开 issue。

许可证

基于 MIT License 发布。