八秒拨穗训练营

要解决的问题

毕业季上线一个"八秒拨穗"主题的 H5 互动小游戏，看似只是换个皮的小游戏 demo，真正动手时常见的三个坑：一是单文件游戏里 CSS、DOM id、JS 状态互相咬合，改一个按钮可能让整个状态机崩掉；二是计分、摄像头姿态检测、键盘彩蛋这些机制没有统一入口，散落在几千行里无处下手；三是需求方随时会加"换个学校配色""加个隐藏称号"，没有可复用的改造路径就只能重写。

技能如何工作

• 默认只给文字指导：AI 不自动创建或修改文件，代码一律以代码块展示，由开发者自行粘贴，避免误覆盖现有项目。
• 复制即用：模板 assets/basui-training-v8-template.html 是完整可玩的 v8 版本，cp 到新目录改名即可做主题/换校改造。
• 按改动类型查文档：动作与障碍物看 references/actions-challenges.md，时间窗口评分看 scoring-system.md，徽章与排行榜看 badges-leaderboard.md，隐藏彩蛋（Z/C/V 键）看 hidden-easter-eggs.md，整体状态机看 architecture.md。
• 行号定位表：SKILL.md 给出 ACTS（~1060）、OB_TYPES（~1070）、BADGES（752+）、scoreTiming()（~1239）、initCamera()/poseLoop()（1655+）、bindDodgeKeys()（1097+）、end()/showResult()（1489+）等关键模块的大致行号，打开 index.html 后能直接跳到目标函数。
• 一键分发：python scripts/package.py 把项目目录打成 zip，便于分发给运营或同学测试。

适用边界与注意点

• 不要拆分单文件：当前架构是单 HTML 内联 CSS + JS，拆包会破坏所有 id 引用，二次开发请在单文件内用 Edit 精准改。
• 先读全局状态 S：每个函数都与 S 强耦合，改任何函数前先弄清 S 的结构。
• localStorage key 固定为 sysu8s_v4：改名会导致已有用户数据丢失。
• 键盘事件统一挂载：新增隐藏按键必须放进 bindDodgeKeys() 的统一监听，否则会被吞掉。
• 入场特效要清理：新特效需同时调用 end() 与 retryGame() 的清理逻辑，避免状态残留。
• SVG 保持 viewBox 一致：校长、学生、障碍物都是纯 SVG，替换素材时注意坐标系对齐。
• 摄像头姿态检测依赖设备权限，桌面浏览器无摄像头时只能测键盘躲障分支。