剑与声（RPG · Sword & Sound）
纯音频回合制武侠 RPG。你是盲剑客沈听澜——眼盲，耳即眼。 黑风寨掳走了你唯一的徒弟，追进迷雾林，把他们连根拔起。
玩法
- 探索：节点式场景图（雾口村 → 林间小路 → 岔路口 → 溪流 → 猎人小屋 → 密林深处 → 黑风寨 → 聚义厅）。每个场景有环境音循环与语音描述， 在选项间切换、确认行动：前进 / 调查 / 商店 / 休息 / 对话 / 强攻或绕行。
- 战斗：明雷回合制。选指令出手；敌方攻击前会响起前摇音 （野狼低吼、山贼拔刀、寨主双刀互击……）——在前摇内双击格挡， 减伤 70%。这是唯一的即时操作，绑双击规避单击延迟。 前摇时长按新手保护分档（见下"难度曲线"），标准档 1.0s。
- 首战教学：第一场战斗（溪流教学狼）是四步强制教学——
认识指令（左右滑 2 次）→ 攻击命中 → 听前摇格挡（受击也算过）→ 防御演示，
每步 8s 无操作重复提示、16s 看门狗兜底推进；教学狼 ATK 2、前摇 1.8s、
玩家 HP 锁底 1 必不死。每场战斗开始还有回合提示音
turn_player， 胜利有号角victory。 - 难度曲线（按已完成战斗场数
battlesWon）：第 1-3 场敌方前摇 1.5s、 伤害 ×0.6；第 4-5 场 1.25s、×0.8；第 6 场起标准；Boss 恒标准。 - 逃跑：Lv<3 普通战必成；Lv≥3 70% 成功，失败则敌方追加一个正常前摇回合 （可格挡）；Boss/剧情战"避无可避"。Lv<3 首次到寨门会听到 boss1_warn 劝退提示。
- 旁白跳过：探索/剧情/状态语音播放中单击=跳过本句（链继续）； 战斗指令名与教学句不可跳。开局插播一次"单击可跳过旁白"。
- 成长：战斗得经验金币 → 升级（maxHp/atk 提升）→ 商店换铁剑/皮甲 → 金疮药回血。战败从章首重生，等级金币装备保留。
- Boss：黑风寨主半血进二阶段（攻击提升、前摇变急促）。讨伐后章结算。
手势
探索态
| 手势 | 作用 |
|---|---|
| 左 / 右滑 | 切换选项（播选项名，循环） |
| 单击 | 确认执行当前选项（语音播放中单击=跳过本句） |
| 双击 | 重听当前场景描述 + 当前选项 |
| 上滑 | 角色状态（等级/血量/金币/装备，分档整句） |
| 下滑 | 菜单：继续旅程 / 保存并回大厅 / 重新听帮助 |
战斗态
| 手势 | 作用 |
|---|---|
| 左 / 右滑 | 切换指令：攻击 → 破空斩（耗内劲 3，双倍伤害）→ 防御（本回合受伤减半）→ 金疮药（回 40% HP） |
| 单击 | 执行当前指令 |
| 双击 | 格挡：仅敌方前摇窗口（教学 1.8s / 保护 1.5s / 过渡 1.25s / 标准 1.0s，听风剑再 +0.3s）内有效，减伤 70%；窗口内其他手势震动报错 |
| 上滑 | 敌我血量档位 |
| 下滑 | 逃跑（Lv<3 必成；Lv≥3 70%，失败吃一个可格挡的前摇回合；Boss/剧情战"避无可避"） |
菜单操作（RPG 豁免，与探索同构）：左右滑切换 + 单击确认；上滑=帮助；下滑=关闭。
战斗数值
maxHp = 20 + 8×(lv-1) atk = 5 + 2×(lv-1) + 武器 def = 护甲
内劲 mp = 3 + lv（破空斩耗 3） 升级所需 exp = lv × 20
伤害 = max(1, round((攻-防) × 0.85~1.15)) × 难度系数（保护 0.6 / 过渡 0.8 / 标准 1.0，向下取整 min 1）
格挡 ×0.3 / 防御 ×0.5（不叠加）
难度档位按 stats.battlesWon 在每场战斗开始时取档：0-2 场保护 / 3-4 场过渡 / ≥5 标准 / Boss 恒标准
状态音乐（docs/design/10-feedback2-state-bgm.md §7）
BGM 层报状态 + sfx 层 amb 报场景：菜单 bgm/menu / 村庄 bgm/village /
探索 bgm/explore（volume 0.35 轻垫 + amb 环境音）/ 战斗 bgm/battle、
Boss bgm/boss（400ms 快切，amb 停）/ 胜利 → 战斗 BGM 淡出 1.5s →
explore 淡入 2s / 章结算 bgm/ending。
无头试玩测试
tools/node/bin/node web/rpg/test/playtest.mjs # 139 条断言，退出码 0=全过
mock 浏览器环境 + 虚拟时钟，覆盖 13 号文档 §6 全部关键路径与边界断言 （四步教学/看门狗/锁血/逃跑分档/格挡防御减伤/战败重生/跳过旁白/存档续玩）
- 资产引用校验（game.js 引用的全部 id 双性别/双格式零缺失）。
存档
- 结构：
{schema, updatedAt, summary, chapter, scene, player, flags, chapters, stats}（见 docs/design/05-rpg-chapter1.md §6 精确定义）。 - 保存时机：场景切换、战斗结算、商店交易、菜单"保存并回大厅"。
- 本地 localStorage（
soundgame.progress.rpg）+ 已登录时同步服务器 （PUT /api/progress {game:'rpg'}），大厅卡片显示summary。 - 有存档进游戏时：单击=继续旅程，右滑=开始新旅程（保留 stats 累计）。
- 战败：章首（雾口村）重生，HP/MP 回满，等级/金币/装备/flags 保留， 本章非 Boss 遭遇重置。
运行
python3 -m http.server 8117 --directory /home/ubuntu/SoundGame/web
# 浏览器打开 http://localhost:8117/rpg/ ，务必戴耳机