SoundGame/docs/design/05-rpg-chapter1.md

05a · 《剑与声》第一章施工稿（26 号对齐）

给开发者的实现要点摘要

1. 场景图 JSON、遭遇战表、数值、存档字段、BGM/sfx 清单 以本文为准（与 05 号总设计冲突时，数据以本文、交互以 26 号+05 号 §0）。
2. 战斗仍是定时器驱动的 10 状态机。格挡 = 前摇窗口内再单击（或朝来招方向滑）。禁止要求新手双击。
3. 探索：左右滑切选项、单击确认、上滑状态。doubleTapWindow: 0。
4. 第一章 8 场景、5 场明雷、商店/宝箱/支线获取不变。
5. 语音仍只引用 05-rpg-ch1-voice-ids.md 表内 id；须停用「双击格挡」教学句或改录为「点一下挡住」（改词在实现时登记，本文不改 voice-ids 文件）。

---

0. 设计单（第一章范围）

一句话、三状态、手势、矩阵、失败表、首 3 分钟、台词类别、断点复述：见 05-rpg.md §0。本章等待点补：

id	场景	期待	_short
village_opt	village	左右/单击	「滑一下。」
path_go	path	前进	「单击。」
fork_pick	fork	左右选路	「左右滑。」
stream_teach	stream	教学战四步	见 11 号
gate_pick	gate	强攻/绕行	「左右滑。」

Floor：探索 YOUR_TURN（amb 常驻可作床）；战斗选指令 YOUR_TURN（turn_player）；前摇 ACTION；演出 BUSY/SPEAKING。

---

1. 第一章场景图（数据表，直接转 JSON）

const CH1 = {
  start: 'village',
  scenes: {
    village:  { name: '雾口村',   amb: 'amb_village',  options: ['go_path', 'shop', 'rest', 'status'] },
    path:     { name: '林间小路', amb: 'amb_path',     options: ['go_fork', 'investigate', 'back'] },
    fork:     { name: '岔路口',   amb: 'amb_fork',     options: ['go_chest', 'go_stream', 'back'] },
    chest:    { name: '枯树洞',   amb: 'amb_chest',    options: ['open_chest', 'back'] },
    stream:   { name: '溪流',     amb: 'amb_stream',   options: ['drink', 'go_hunter', 'back'],
                encounter: 'enc_teach_wolf' },
    hunter:   { name: '猎人小屋', amb: 'amb_hunter',   options: ['talk_hunter', 'go_deepwood', 'back'] },
    deepwood: { name: '密林深处', amb: 'amb_deepwood', options: ['go_gate', 'back'],
                encounter: 'enc_bandits' },
    gate:     { name: '黑风寨门前', amb: 'amb_gate',   options: ['assault', 'sneak', 'back'] },
    boss1:    { name: '聚义厅',   amb: 'amb_hall',     options: [],
                encounter: 'enc_boss1' },
  },
};

选项语义（不变）：

选项 id	播报语音	行为
go_*	opt_go_<场景>	切换场景（脚步 + 新场景 desc）
back	opt_back	回上一场景
shop	opt_shop	商店子菜单
rest	opt_rest	HP/MP 回满，sys_rest；仅 village
status	opt_status	与上滑相同
investigate	opt_investigate	一次性 +15 金（chest_path）
go_chest	opt_go_chest	岔路左
open_chest	opt_open_chest	金疮药×2（chest_fork）
drink	opt_drink	HP 回满
talk_hunter	opt_talk_hunter	药×1 + 九折 shop_discount
assault	opt_assault	enc_elite → 胜后 boss1
sneak	opt_sneak	enc_sneak → 进 boss1 且 HP/MP 回满

---

2. 遭遇战表（不变）

遭遇 id	敌人	触发	特殊
enc_teach_wolf	教学野狼 ×1	stream 首次	HP 锁底 1；四步教学（格挡=窗口单击）
enc_wolf	野狼 ×1	教学后再入 50%	可逃
enc_bandits	山贼 ×2	deepwood 首次	不可逃；间不回血
enc_elite	寨丁头目 ×1	assault	不可逃
enc_sneak	山贼 + 毒蛛	sneak	不可逃；胜后回满
enc_boss1	黑风寨主	boss1	不可逃；半血二阶段

---

3. 战斗状态机（格挡输入改写）

状态：B_START → (回合循环) → VICTORY | DEFEAT | FLED

状态	进入时副作用	出口转换
B_START	btl_start_<enemy>；回合=1	第一章 → PLAYER_SELECT（蛊师类先攻除外）
PLAYER_SELECT	sfx/turn_player；Floor=YOUR_TURN；播当前指令名；左右滑循环 攻击→技能→防御→道具；单击执行；上滑战场状态；下滑逃跑	单击 → PLAYER_EXECUTE；下滑 → FLEE_CHECK
PLAYER_EXECUTE	攻击=伤害公式；技能=atk×2 耗 mp3（不足 btl_nomp 留在 SELECT）；防御=halfDamage；道具=金疮药 40%maxHp（无药 btl_noitem）。内容音 = silent-ok	→ CHECK_ENEMY_DEAD
CHECK_ENEMY_DEAD	敌 HP≤0：btl_enemy_die；连战拉下一只回 B_START（不重置玩家）	无下一只 → VICTORY；否则 ENEMY_TELEGRAPH
ENEMY_TELEGRAPH	Floor=ACTION。有声：tel_<enemy> 1.0s（保护档见 11 号）。无声：danger earcon（系统合成，必出声）。窗口内：单击 = 格挡；朝来招方向滑 = 格挡。成功：sfx/parry，标记 true。反向滑 / 上滑 / 下滑：invalid，留在窗口。连点 400ms 内第二下 busy	窗口结束或已格挡 → ENEMY_RESOLVE
ENEMY_RESOLVE	dmg×0.3 格挡 / ×0.5 防御 / 全值。受击 hurt+回执；格挡成功不播 hurt。降档才播 st_hp_*	HP≤0 → DEFEAT；否则 → PLAYER_SELECT
FLEE_CHECK	见 11 号成功率	FLED 或回 SELECT；失败则 ENEMY_TELEGRAPH（可格挡）
VICTORY	btl_win + 分档掉落 + 升级	探索态，写存档
DEFEAT	btl_lose + 归因 → village 重生（等级金币装备 flags 保留，本章非 Boss 遭遇重置）	village，写存档

半血钩子：HP 首次 ≤50% 于结算前插播 btl_half_<enemy>。

来招方向约定（滑动格挡，不单独教学）：

敌人	声像 / 约定方向
野狼、教学狼	中央；滑动任意左右也认，或只认单击
山贼 / 头目	前摇脚步声像侧
毒蛛	高频，中央；认单击
无声	无方向；只认单击（滑=invalid+「点一下。」）

---

4. 数值表（原样保留）

4.1 玩家

maxHp = 20 + 8*(lv-1)
atk   = 5 + 2*(lv-1) + 武器atk
def   = 护甲def
mp    = 3 + lv
expToNext = lv * 20
dmg = max(1, round((atk攻 - def守) * (0.85~1.15)))

4.2 敌人

敌人	章	HP	ATK	DEF	EXP	金币	前摇 sfx	前摇特征	半血句
教学野狼	1	6	3	0	5	0	tel_wolf	扑击低吼	无
野狼	1	10	4	0	8	5	tel_wolf	低吼	无
山贼	1	16	6	1	12	12	tel_bandit	脚步+拔刀	btl_half_bandit
毒蛛	1	12	7	0	12	8	tel_spider	高频肢节	无
寨丁头目	1	24	8	2	20	25	tel_elite	重甲	btl_half_elite
Boss 黑风寨主	1	45	10	2	50	100	tel_boss1	双刀两声	二阶段 ATK→12
沼泽鳄	2	30	11	2	22	18	tel_croc	水花+低吼	无
蛊师	2	22	12	1	26	30	tel_shaman	吟唱（先攻）	有
剑傀	3	38	14	3	40	45	tel_puppet	机括	无
影卫	3	30	16	2	45	50	无（danger earcon）	寂静	有
Boss 腐沼祭主	2	70	14	3	90	200	tel_boss2	哼鸣	二阶段 2 毒蛛
Boss 白无瞳	3	110	18	5	150	500	三阶段无声+earcon	寂静	三次转换

经验校验原文成立：打完第一章约 lv3。

4.3 装备获取（不变）

物品	效果	获取
铁剑	atk+3	商店 100（九折 90）
皮甲	def+2	商店 80（九折 72）
金疮药	40% maxHp	30 金；宝箱×2；猎人×1；上限 5
青钢剑	atk+6	二章 300
铁鳞甲	def+4	二章 250
听风剑	atk+9，窗口 1.0→1.3s	三章 600

4.4 商店

shop_open → 左右滑：铁剑/皮甲/金疮药/离开 → 单击购买（不再双击）。钱不够 shop_poor；已购 shop_owned。成功 sfx/coin + 回执。写存档。

---

5. 探索态手势（施工口径）

• 左右滑=切选项（报名）=silent-ok 或 ok
• 单击=确认
• 上滑= st_lv_* → st_hp_* → st_gold_* → st_weapon_* → st_armor_*（可打断）
• 下滑=菜单（阶段 2）：继续 / 保存回大厅 / 返回；破坏性二次确认
• 双击新手当单击（不重听整段描述；描述可用单击跳句后的帮助短句）

血量档：>70% / 30–70% / <30% 原句 id 保留。

教学战逐步旁白（替旧「双击格挡」）：

步	意图	玩家
T0	左右滑听指令名	滑 ≥2
T1	攻击单击	出剑一次
T2	前摇内单击格挡	成功或受击都通过
T3	选防御单击	演示减伤
T4	自由击杀	敌亡

完整参数见 11-rpg-battle-rebalance.md。

---

6. 存档 JSON（精确定义，保留）

PUT /api/progress { game: 'rpg', data: ... }：

{
  "schema": 1,
  "updatedAt": "2026-08-29T12:00:00Z",
  "summary": "第一章·溪流 · Lv3 · 金币120",
  "chapter": 1,
  "scene": "stream",
  "player": {
    "lv": 3, "exp": 45,
    "hp": 28, "maxHp": 36, "mp": 6,
    "gold": 120,
    "weapon": "iron_sword",
    "armor": "leather",
    "potions": 2
  },
  "flags": {
    "tutorial_battle_done": false,
    "chest_path": false,
    "chest_fork": false,
    "hunter_quest": false,
    "shop_discount": false,
    "enc_bandits_done": false,
    "enc_elite_done": false,
    "enc_sneak_done": false,
    "boss1_done": false
  },
  "chapters": { "1": "open", "2": "locked", "3": "locked" },
  "stats": { "kills": 0, "deaths": 0, "parries": 0, "playSec": 0, "battlesWon": 0 }
}

字段	默认	说明
schema	1	不匹配可重开，stats 保留
summary	"新的旅程"	第X章·场景名 · LvN · 金币M
chapter/scene	1 / village	落点
player.*	lv1 exp0 hp20 maxHp20 mp4 gold50 weapon null armor null potions 1	开局 50 金
weapon/armor	null	iron_sword/steel_sword/wind_sword；leather/iron_scale
flags.*	false	一次性
chapters	见上	locked/open/cleared
stats.*	0	只增不减；battlesWon 供保护档

保存：场景切换、战斗结算、商店、菜单保存。localStorage soundgame.progress.rpg 与服务器双写。有档：sys_continue_ask 单击继续、右滑新游戏。

---

7. 资产需求清单（保留 prompt）

7.1 BGM（与 10 号对齐）

id	用途	Mureka prompt 草稿
bgm/explore	探索宏观	Atmospheric Chinese wuxia ambient, bamboo forest mist, sparse guzheng plucks over low drone, slow tempo 60 bpm, mysterious but calm, no vocals, seamless loop
bgm/battle	普通战斗	Tense wuxia battle music, driving taiko drums 100 bpm, sharp erhu stabs, urgent but not chaotic, no vocals, seamless loop
bgm/boss	Boss	Epic dark wuxia boss theme, heavy taiko 120 bpm, dissonant strings, dramatic tension, no vocals, seamless loop
bgm/village	村庄	Warm peaceful Chinese village ambiance music, soft dizi flute melody, gentle plucked strings, cozy 70 bpm, no vocals, seamless loop
bgm/ending	章结算	Melancholic wuxia emotional theme, solo erhu over soft pads, bittersweet, slow, no vocals, seamless loop

amb_* 走 sfx 层 loop（addendum），bgm=0 时 amb 仍在。village 在 bgm=0 时用 amb_village。

7.2 SFX（35；SA3 = Stable Audio 3，SYN = 程序合成）

类别	id	方式	prompt / 说明
敌方前摇	tel_wolf	SA3	wolf growl then lunge, short, dry, close mic
	tel_bandit	SA3	footsteps on dirt then sword unsheathing shing, 1 second
	tel_spider	SA3	insect legs skittering, high frequency chitin clicks, eerie, 1 second
	tel_elite	SA3	heavy armor plates clanking, menacing, 1 second
	tel_boss1	SA3	two metal blades striking each other twice, dramatic ring
	tel_croc	SA3	water splash with low reptile growl
	tel_shaman	SA3	low guttural chant humming, ritualistic, dark
	tel_puppet	SA3	wooden mechanism clicks and winding gears
战斗	atk_swing	SA3	sword whoosh through air, fast, clean
	atk_hit	SA3	sword hitting flesh, dull impact, not gory
	parry	SA3	metal parry clang, bright ring, short
	skill_slash	SA3	powerful sword slash with air rip, dramatic
	hurt	SYN	低频闷击（避免与 atk_hit 混淆）
	enemy_die	SA3	body falling to ground with weapon clatter
	potion	SA3	drinking liquid gulps, glass bottle
	flee	SYN	渐远脚步
	turn_player	SYN	上行双音剑鸣，≤0.4s（11 号）
	victory	SA3	triumphant short brass fanfare, 3 rising notes, wuxia style, under 1.5 seconds
探索/系统	step	SYN	单步脚步
	coin	SYN	硬币叮当
	chest	SA3	old wooden chest creaking open
	drink_water	SA3	scooping and drinking stream water
	rest	SA3	settling down by campfire, fabric rustle
	levelup	SYN	上行钟声琶音
	door_heavy	SA3	heavy wooden gate slowly opening, deep creak
	ui_deny	—	不做（回执走引擎）
场景环境	amb_village	SA3	night village ambience, campfire crackle, distant chatter, crickets, loop
	amb_path	SA3	forest path ambience, wind through leaves, birds distant, loop
	amb_fork	SA3	forest crossroads ambience, wind split feel, crows, loop
	amb_chest	SA3	hollow tree hole ambience, drips, muffled wind, loop
	amb_stream	SA3	flowing stream over rocks, gentle water, loop
	amb_hunter	SA3	wood cabin ambience, firewood crackle, knife sharpening occasionally, loop
	amb_deepwood	SA3	deep forest ambience, insects, distant wolf howl, ominous, loop
	amb_gate	SA3	bandit camp outside gate ambience, torches burning, rowdy distant voices, loop
	amb_hall	SA3	large hall ambience, fire brazier, echoing space, tense, loop

无声敌人（影卫 / 白无瞳三阶段）不占 sfx：窗口用引擎 danger earcon + 回执。amb 走 sfx 层 loop。计数仍约 35 件内容音 + 2 个战斗状态音。

---

8. 与台词表

开发只许引用 05-rpg-ch1-voice-ids.md。教学格挡句若仍写「双击」，运行时改播等价「点一下挡住」或停用旧 id 待重录——不在本次改 voice-ids 文件。

---

9. 废止（本章范围内）

废止	改为
ENEMY_TELEGRAPH 双击格挡	单击；同向滑可选
探索双击重听	新手当单击；阶段 3 再重听当前描述
商店双击购买	单击购买
无声窗口仅震动	danger earcon + 回执
amb 与 explore BGM 抢同一层导致互删	BGM 宏观 + amb 走 sfx loop（addendum）

JSON、数值、获取节点、flags、summary 格式：未改。