暗室

一个纯静态的休闲游戏站。原生 HTML/CSS/JS + Canvas，零依赖、零构建 —— 把仓库直接丢到 GitHub Pages / Cloudflare Pages 就能跑。

《光与影》

双人同屏的合作解谜游戏，目前 18 关。

光灵离开光就会消散，影灵被光照到就会消散。灯可以推着走 —— 推动一盏灯，就同时改变了两个人的路。两人必须同时站在各自的门里才算过关。

	移动	跳跃
光灵	← →	↑
影灵	A D	W

R 重来，F 全屏，M 静音。手机和平板横屏时可使用画面下方的双人触控按钮，支持多指同时操作。

每关的设计意图写在 levels.js 的 hint 字段里，鼠标悬停选关按钮可以看到。

关卡

#	名称	教的东西
1	分道	两种角色的生存规则
2	借光	灯可以推，推灯就是在改路
3	互锁	压力板 / 机关门，谁先动的顺序
4	垫脚石	灯也是能站上去的箱子
5	追光	光柱跟着灯扫动，跟在光后面走
6	压住	常压板：松开就关，得拿灯当配重
7	深井	灯掉下去就捞不回来，顺序不可逆
8	双灯	两盏灯两个用途，别弄反
9	回环	先把灯送过去，再推回来
10	三重	三层楼，灯掉到底层就上不来了
11	四层	四层楼，灯要往下丢两次
12	独灯	两块常压板一盏灯，一次只能开一扇门
13	双灯井	两盏灯两个去处，一盏压板一盏照井底
14	留守	常压板得有人一直压着，轮流当按门的人
15	天窗	光灵没有灯，踩着头顶漏下的光斑走
16	错身	两人反向走，光柱跟着灯一路扫过来
17	逆锁	单灯双常压板与三门互锁，考验留守顺序
18	终夜	四层收官：一盏灯必须永久填进坑里，另一盏既当光源又当垫脚石

目录结构

index.html          游戏本体（放在根目录，GitHub Pages 直接就能发布）
game.css
src/levels.js       关卡数据（字符网格）
src/engine.js       引擎
art/README.md       美术源图、游戏导出图与重新导出说明

加关卡

关卡就是一段字符网格，改 src/levels.js 即可，不用碰引擎：

#   墙                    .   空气
L   光灵出生点            l   光灵的门
U   影灵出生点            u   影灵的门
*   固定灯（挂墙上）      o   可推动的灯
1-4 压力板（踩一次永久开门）
a-d 常压板（压住才开，松开就关；灯可以当配重）
A-D 机关门（A 对应压力板 1 或常压板 a）

每关的所有行必须等长。

设计约束

这些数字由引擎常量决定，改关卡时要守住：

• 最大跳跃高度 80px = 2.5 格 → 2 格台阶跳得上，3 格跳不上
• 站在灯上可达 110px = 3.4 格 → 3 格墙必须借灯才能翻
• 最大水平跳跃 124px = 3.9 格 → 缺口最多 3 格
• 护盾 0.28 秒耗尽 → 光柱缝隙要有 3 格宽。这个值不能放宽：角色跳跃穿过光柱的暴露时间约 0.34 秒，护盾一旦超过它，会跳的玩家就能硬闯光柱
• 靠「光斑」赶路时，两块光斑之间的黑暗不能超过 53px（0.28 秒护盾 × 190px/s 移速）。留 20% 余量比较稳，即 ≤44px
• 影灵走廊至少 4 格高。只有 3 格时跳跃会撞顶、上升速度归零，滞空时间从 0.65 秒缩到 0.52 秒，水平距离只剩 98px —— 而跨 3 格缝需要 100px
• 固定灯不能放在光柱缝隙的正下方。对「站立」判定是安全的（缝里本来就站不了人），但影灵必须飞越那段空域，会被正射的光柱烤死
• 固定灯是实心的，不能放在地板行上，否则会堵死通路
• 门必须放在角色真正站立的那一行（脚下有地），否则判定区够不着
• 压力板要放在角色走得到的地方 —— 从高处跳下来是抛物线，单格板会被整个越过，落点附近的板至少铺 2 格

实现要点

• 光影：每盏灯把面向自己的墙面边缘沿光线方向挤出成阴影多边形，用 destination-out 从光照图里挖掉。相邻同向墙面会先合并成长边，减少多边形数量；光照图只在灯移动或机关门开合时重算。
• 光暗判定：与渲染分开，用灯到角色的视线检测 + 距离衰减累加光强。判定阈值对应半径的 55%；渲染的亮度曲线必须在这个边界之后迅速收掉，否则会出现「看着危险其实安全」的光晕，玩家读不准哪里能站。
• 手感：coyote time（离地后 0.09s 仍可起跳）、跳跃缓冲（落地前 0.1s 按跳生效）、松键断跳、跳跃时的挤压拉伸与落地接触阴影。
• 画面：墙体按坐标哈希做逐格明暗抖动并加受光顶面与背光底边，避免大片纯色；门画成暗内腔 + 发光门框（门是墙上的洞，内部暗才能在明亮区域里也看得见）；机关门用流动的能量条表示「还关着」；光照区内飘浮尘埃，每帧只抽样更新五分之一以控制视线检测的开销；全局叠一层暗角。
• 音效：WebAudio 现场合成，不需要素材文件。脚步用带通滤波的白噪声（纯振荡器出不来踩踏的质感），并按位移而非时间触发 —— 按时间触发的话，推灯减速时步频不变会很假。所有音效都带 14ms 起音坡和低通，直接起振会有爆音，听着一惊一乍。音效事件要铺满常见操作（开场、落地、推灯、开门、进门、开关反馈），否则玩家可能整关听不到任何声音 —— 第 1 关根本不需要跳，而跳跃一度是唯一的发声点。
• 音频解锁：AudioContext 必须等到首次用户手势才创建，页面载入时创建会得到一个挂起的上下文，之前排的声音全部丢失。

第 18 关的设计要点

四层楼、四组机关、两盏灯，两人从头到尾轮流为对方开路：

1. A 层：常压板在一个两格深的坑底。坑底本身是黑的，光灵站进去会消散，所以只能把一盏灯推下去 —— 灯掉进坑就再也推不上来，这一盏等于永久报废。灯压住板子，影灵才过得了 A 门。
2. B 层：光灵落在左房间，被 B 门锁住；影灵在右房间踩下永久压力板才放得开他。中间的立柱同时挡光，两人各自的房间才不会互相致命。
3. C 层：高台比地面高三格，跳不上去 —— 得先把剩下那盏灯推到台脚当垫脚石，踩上去才够得着 3 号板。顺序不能反：先把灯推下通往 D 层的井，就再也上不了高台。
4. D 层：光灵的门被 D 门锁死，只有影灵一直踩住常压板才开着；影灵得等光灵穿过去以后才能离开去自己的门。

可解性不是靠肉眼看截图确认的 —— 门开在够不着的那一行、光柱宽到跳不过去、灯推下井之后再也捞不回来， 这些在图上都看不出来。仓库里有两个验证脚本：

python3 -m http.server 8810      # 指向仓库根目录
node tools/lightmap.js 18        # 打印每一格对谁安全的明暗图
node tools/playthrough.js        # 用真实键盘事件把 18 关全部走一遍