fea: 优化死亡特效

.workbuddy/memory/2026-10-24.md

@@ -71,3 +71,36 @@
 - 用户最初提的"下落惯性叠加"经三次实践证明给不出好手感，放弃；参数保留 DJ_INERTIA（现值 0）供回退。
 - 回归：dj-test/smoke/ice/spike/save/key 全过；未跑 solve（用户禁令）。
 - dj-test 断言已随 INERTIA=0 语义重写（各时机 ≥55px 且与顶点差 ≤3px）。
+
+## 死亡流程改造：手动重生 + 小死亡动画（用户需求）
+- 需求原话：「当角色死亡后不要立马重生，需要用户手动按重生键重生，并且死亡时除了原先的红叉，还要附加一个小的死亡动画」。推翻 2026-10-23 的"立即复活、无动画"旧需求。
+- player.js：kill() 重写（定格 + 粒子爆发 16 个 + shake=6 + deathX/deathY clamp 到关卡内，红叉位置改用 clamp 后坐标）；update() 开头 `if (this.dead) { this.deadT++; return; }` 早退；移除 4 处"kill 后当帧 respawn"（掉坑/刺/update 末尾兜底/假存档）；draw() dead 分支画扩散冲击环（deadT<=14，半径 4→29px 淡出，kid 不画）；reset() 初始化 deathX/deathY。
+- main.js：suicide() 分流（alive→kill；dead→respawn），R 键两段式语义；render 的 playing 分支加死亡提示（"按 R 重生"呼吸闪烁 + "Backspace 整关重来"，触屏文案"按右下角重生键"）。
+- 触屏重生键（touch.js→api.suicide）自动获得死亡中重生能力，无需改。
+- 测试：death-test.mjs 全面重写为 23 断言（定格/输入无效/手动 respawn 回存档点/连续 5 次死亡/红叉常驻+去重+reset 清空/掉坑 clamp/渲染冒烟）全过；key-test（R 自杀→定格、死亡中 R→重生）、save-test（kill 后手动 respawn）、smoke（死亡段改新语义）同步更新；dj/ice/spike/dom-smoke/editor-pick 全过；未跑 solve（禁令）。
+- 踩坑：测试 grid 里 'S' 是出生点、存档点字符是 'G'（level.js:24），写测试地图别搞错。
+
+## 重生键语义简化：任何状态按 R 都直接重生（用户反馈）
+- 用户原话：「如果没死，由玩家手动按了重生键就直接重生」。此前 R 是两段式（活着=kill 定格→再按一次才回存档点），用户嫌按一次没反应。
+- main.js suicide() 改为无条件 `G.player.respawn()`：活着按 = 放弃当前进度秒回存档点（不死亡、不计死亡数——主动重生不是失误）；死亡中按 = 复活。触屏重生键走同一入口自动生效。
+- key-test R 段重写：先站到出生点→按 R→验证回到存档点且 alive/dead/死亡数不变；再 kill→死亡中按 R→验证复活。全过。
+- 回归：key/death/save/smoke/dj/ice/spike/dom-smoke/editor-pick 全过；未跑 solve（禁令）。
+
+## 重生键最终形态：按一次 = 死亡动画 + 自动重生（用户二次反馈）
+- 用户先要求「没死按重生键直接重生」，AI 做成无动画秒回；用户再反馈「不是，直接按重生键有死亡动画的」——要的是**一次按键=播死亡动画→演完自动重生**。
+- 最终语义（main.js suicide）：死亡中按 R = 立即复活；活着按 R = kill({mark:false, count:false, autoRespawn:30})——粒子+轻震+冲击环照播，不留红叉、不计死亡，30 帧（0.5s）后自动回存档点。
+- player.js：kill() 参数化 opts{mark,count,autoRespawn}；update 死亡早退里 autoRespawn 到期自动 respawn；reset/respawn 清理该字段。软重置（softReset 清粒子+shake）会收走动画残余粒子，属预期（爆发与冲击环已看完）。
+- 测试：death-test 新增场景 9（主动重生键 7 断言）全过；key-test 活着按 R 段重写（演出中 dead/零计数/零红叉→33 帧后回存档点）；save/smoke/dj/ice/spike/editor-pick/dom-smoke 全过。
+- 补充（用户三次反馈）：主动重生键演出期间**不显示**「按 R 重生」提示（main.js render 条件改为 `P.dead && !P.autoRespawn`）——演完自动重生，提示多余；真死亡时提示保留。
+- 补充（用户四次反馈）：主动重生键原定 autoRespawn=30 帧，冲击环 14 帧就播完，中间 16 帧只剩稀疏粒子=「空档」。改为 **autoRespawn=15**（冲击环 deadT<=14 播完的下一帧重生，零空档零腰斩）+ kill() 新增 opts.life 覆盖粒子寿命（主动模式 life=15 与冲击环同步收尾，避免被 softReset 腰斩满 alpha 粒子）。shake=6 每帧 ×0.86 衰减，15 帧时≈0.56px 无感，不会被重生清场掐断。
+
+## 主动重生键终版：当帧重生 + 特效留在死亡位置播完（用户五次反馈）
+- 用户原话：「不用等死亡动画结束再重生，直接重生就行了，动画在死亡位置放完」。此前 autoRespawn=15 帧的"演完再重生"方案废弃，autoRespawn 机制整个删除。
+- 架构调整：冲击环从 player.draw 的 dead 分支**搬到 Level 层**（`deathFX` 数组 + addDeathFX + drawDeathRing + update 推进 14 帧移除）——否则玩家一重生环就消失，无法"在死亡位置放完"。
+- player.js：新增 `deathBurst()`（纯演出：粒子+shake+addDeathFX，不进死亡状态）；kill() 改为调 deathBurst + 红叉/计数（opts 仅剩 mark/count）；respawn(opts) 透传 `softReset(opts.keepFX)`；draw() dead 分支简化为不画 kid。
+- level.js：`softReset(keepFX=false)`——keepFX=true 时不清粒子/震屏（主动重生专用，让特效自然播完）；reset(true) 清 deathFX。
+- main.js suicide：活着按 = `deathBurst() + respawn({keepFX:true})` 当帧完成，零等待；死亡中按 = respawn()。
+- 真死亡流程不变（定格+手动+红叉+计数）；粒子 life 34 / 冲击环 14 帧 / shake ×0.86 全部自然播完（重生不清场）。
+- 测试：death-test 场景 8/9 重写（当帧重生、纯演出不进死亡态、粒子/环/震屏全程自然播完断言），key-test 活着按 R 段重写；全套回归过。
+- 补充（用户六次反馈）：「kid 被动死亡的，死亡动画也应该放完，尽管玩家很快按了重生键」。根因：`softReset()` 无脑清 particles+shake——重生即清场，特效被腰斩。修复：softReset 永久不清粒子/震屏（"演出层"语义：重生只重置关卡逻辑状态，不掐断演出；仅 reset(true) 整关重开才清空）。keepFX 参数随之删除，respawn() 恢复无参。踩坑：python 替换时把 `softReset(keepFX=false){` 函数头和 vanish/bullets 清逻辑一起吃进 old 串，文件语法损坏——已修复（补回函数头+4 行清逻辑，node import 验证）。教训：rep() 的 old 串跨函数签名行时，new 必须原样带回签名与后续语句。
+- 测试：death-test 新增场景 10（真死亡 3 帧秒按 R：粒子/环/震屏全程保留并自然播完，7 断言）；key-test 死亡中按 R 段加"残余粒子"断言；全套回归过。

.workbuddy/memory/MEMORY.md

@@ -9,6 +9,14 @@
 - 刺碰撞是**三角×AABB（SAT）**：`js/level.js` 的 `spikeTri(t,x,y)` 顶点与 `drawSpike` 一致（上刺尖在格顶 y、左右刺尖在格缘中点），`triRectOverlap` 做精确判定；`deadlyRect` 网格刺+掉落刺都走它。旧的 `spikeBox` 矩形盒已删除。`T.KILLER` 必须有兜底 return。
 - **kid 绘制零形变**：起跳/落地 squash 已全部删除（`player.js` 无 `squash` 字段，`sprites.js` 的 `drawKid` 直接按原始 11×21 画）。用户明确要求跳跃/落地都不要身体晃动。
 
+## 死亡与重生流程（2026-10-24 新语义，推翻早期"立即复活"需求）
+- **死亡后不自动重生**：`kill()` 后玩家定格在死亡点，世界继续运转（敌人/子弹/粒子/相机照走）但玩家不响应输入（`player.js` update 开头 `if (this.dead) { this.deadT++; return; }`）。等玩家手动按重生键。
+- **重生键 = R**（复用 IWBT 标准自杀键）：活着按 R = 自杀回最近存档点；死亡中按 R = 手动重生（`main.js` 的 `suicide()` 按 `G.player.dead` 分流）。触屏重生键走同一入口（`touch.js` → `api.suicide`）。Backspace 仍是整关重来。
+- **死亡动画（"小"三件套，红叉之外附加）**：① `kill()` 时 16 个红白粒子爆发（`L.particles.spawn`，life 34）；② `L.shake=6` 屏幕轻震（camera 原生支持，0.86/帧衰减）；③ 死亡点扩散冲击环（`player.draw` 里 `dead` 分支，`deadT<=14` 帧内半径 4→29px 淡出，kid 本体不画）。
+- **死亡坐标 clamp**：`deathX/deathY` 记录时 clamp 到关卡内（掉坑死亡时玩家已在屏幕外），红叉/粒子/圆环都落在可见区域；红叉（deathMarks）仍常驻保留、多次死亡只留最后一次、`reset(true)` 清空。
+- **render 死亡提示**：`main.js` render 的 playing 分支画居中"按 R 重生"（呼吸闪烁，`Math.sin(t/12)`）+ 副行"Backspace 整关重来"；触屏文案"按右下角重生键"。
+- 历史：早期用户曾要求"死亡立即复活、无任何动画"（旧 `death-test.mjs` 首行注释为证），2026-10-24 明确推翻。回归：`tools/death-test.mjs`（23 断言：定格/输入无效/manual respawn/连续死亡/红叉/clamp/渲染冒烟）；`key-test`（R 两段式语义）、`save-test`、`smoke` 的死亡段已同步改。
+
 ## 冰面滑行惯性（易反复踩坑）
 - 冰面物理只在 `js/player.js` 的水平输入段，`sliding` 是唯一惯性开关：冰上 `|vx|>SLIDE_MIN` 置位，离冰后仍按 `sliding` 走惯性分支，撞墙/归零/交还控制时才清位。
 - **空中与地面必须分开摩擦**：`SLIDE_AIR 0.02`（几乎无损，能滑出冰块边缘飞出去）vs `SLIDE_FRIC 0.12`（地面约 34 帧/70px 收住）。曾经两者都用 0.25，导致「滑出冰块掉下去 7 帧就没速度」——玩家最直观的「没惯性」就来自这里。