SoundGame/docs/design/24-rhythm-drummer.md

24 · 《节拍行者》鼓手模式（26 号对齐）

给开发者的实现要点摘要

1. 玩法保留：3×2 分区鼓组、跟随领奏、PERFECT ±0.15 / GOOD ±0.35、S～C 评级、B 级解锁下一首、无鼓伴奏、BPM 网格。本文取代 03 号作为施工依据。语音表仍见 24-rhythm-voice-ids.md。
2. 演奏期 = Floor ACTION：不起等待声；点按即敲。Miss = 不按「敲对」计、该音符无领奏应答感 + 闷镲/回执 + 真话归因。禁止只震。
3. 新手期无双击手势（doubleTapWindow: 0）。同区两记连续点按是两下敲击，不是「双击手势」。菜单禁止双击确认。双击手势直至阶段 3 才存在，且不绑音符类型。
4. 分区点按是核心；选曲/结算/暂停说明的帮助=长按（上半屏点按是鼓，上滑易混）。暂停恢复必须 count-in。
5. 第一句就摸鼓或跟打；第一次成功 ≤10s。

---

0. 设计单（26 号附录 C）

0.1 一句话核心动作

屏幕是一面 3×2 鼓组。领奏敲一小节，你在下一小节同一拍点敲同一面鼓。

0.2 玩家可感知的状态（3 个）

状态	Floor	听感	第一次教
演奏 / 教学跟打	ACTION	无鼓伴奏 + 鼓声音色（声像+音高）	「敲屏幕。摸到哪是哪。」
选曲	YOUR_TURN	bgm/menu + 等待声	「左右滑选歌。单击开始。」
结算	YOUR_TURN	menu pad + 评级句	「单击，再来一遍。」

暂停：音乐停，不叠 menu pad。恢复先 count-in，再进窗。

0.3 新手手势与解锁

手势	演奏 ACTION	选曲 / 结算	解锁
单击（含分区坐标）	敲该区	开始 / 再来	阶段 0；演奏期 immediateTap
左 / 右滑	不作为音符（可 invalid 或忽略为非敲）	切曲 / 右滑下一首	阶段 0
长按	死输入：invalid 或闷镲，不判定	帮助一句	阶段 1
下滑	阶段 2 前=invalid「现在只要敲。」；阶段 2 后无条件暂停菜单	菜单	阶段 2（第一局结束）
双击手势	不存在；300ms 内两下=两次 tap	当单击	阶段 3 仅重听选曲说明/评级，禁止绑重开

键盘：Digit1–6 = 六区，按下即发。空格落 BC（家区）。选曲态数字键无效。

0.4 状态 × 手势矩阵（新手期）

状态 \ 手势	分区单击	左右滑	长按	下滑（未解锁菜单）	双击	连点
intro/tut 讲解 SPEAKING	跳句 或 摸鼓（T0 探索）	打断	帮助	invalid+解释	当单击	400ms busy（讲解）；T0 每下都出声
教学跟打 ACTION	敲区判定	invalid	死输入	invalid	当两次单击	两下两击
演奏 ACTION	敲区判定	非音符	死输入	未解锁=invalid	两次单击	合法连击
选曲	开始当前曲	切曲报名	帮助	阶段 2 菜单	当单击	busy
暂停菜单	确认当前项	左右切换	重听说明	关闭菜单	当单击	busy
结算	同曲再来	右=下一首	重听评级	菜单	当单击	只处理第一下

0.5 等待点

id	期待	_full	_short	静默	L2 / L3
tut_probe	任意敲 ≥1	「随便摸，听鼓在哪。」	「摸一下。」	8s 自动进 T1	—
tut_kick	应答敲 BC	「家区在下中。点一下。」	「点下中。」	Miss	降速重演 → 演示
tut_sides	BL 然后 BR	「左下，再右下。」	「左右下。」	Miss	同上
select	单击	「单击，开始。」	「单击。」	18s	—
settle	单击	「单击，再来一遍。」	「单击。」	20s	—

演奏 ACTION 不挂等待声、应答小节内零语音。

0.6 首 3 分钟逐秒脚本

时间	游戏说 / 播	期待	没做	做错
0～3s	「点一下屏幕。」或直接「随便摸。」	任意敲	8s 自动进 T1	—
3～10s	区音色 + 区名（第一次成功）→ T1 数拍 → 领奏 BC	应答敲家区	「这拍没接。」	错区：报名实际区 +「敲家区。」
10～30s	T2 左右下排	跟打	短句；2 败降速	真话归因
30～60s	T3 上排三音或进曲目一句 1	跟打	接管	Miss 无「假成功」乐器归属
60～180s	曲目一前句（无双击手势、反拍仅加花）	敲对区	连 2 Miss 才 gd_miss 一次	早/晚/没接/错鼓分档

0.7 失败表

类型	判定	归因	回到	新手代价
没出手	expected+GOOD+0.10s 无应答	「这拍没接。」	教学重来；正片歌继续	不中断
早 / 晚	同区超 Perfect 但仍在 Good	教学事后「早了/晚了」；正片 Good 出声	教学重来	无
错鼓	异分区音符半窗内被敲	教学：区名+「敲错鼓了」；正片：错区音色本身（配额不叠语音）	同上	combo 清零
教学 2 败	同一步	「我放慢一些。」×0.75	该步	再败跳过不卡死
长按演奏期	按下≥450ms	闷镲 + invalid	不归属	无

0.8 台词类别

• critical：开场动手句 ≤3s。
• content：曲名、评级、解锁、tut_map 拆句后非关键段。
• hint：gd_answer、gd_count、区名、短教学。
• feedback：gd_miss_none / early / late / retry_wrong。

应答小节内：hint/feedback 播不出则丢。曲尾 3s 内不插 gd_miss。

0.9 断点复述

暂停：泵停、BGM 记 offset。恢复：cue.expected / _bgmT0 平移 = 暂停时长 + count-in 小节；guide full 先播 gd_count（每曲 1 次）。退出写进度 schema 1。

0.10 测试

§12 断言清单（已按新手无双击、菜单单击确认、ACTION、count-in 修订）。乱点：无声操作 0；被动原句重复 0。

---

1. 可行性决策（保留）

引擎 onGesture(g, info?: {x,y}) 后向兼容扩展；键盘 keyCenter 免费得坐标。打击乐 numpy 合成。BGM 硬性 no drums。回归义务见 research/rhythm-drummer/round0/。

---

2. 屏幕分区与音色（保留）

┌─────────┬─────────┬─────────┐
│ TL 左上 │ TC 上中 │ TR 右上 │   上排：清亮  pan -0.6 / 0 / +0.6
│  踩镲   │  高嗵   │  吊镲   │
├─────────┼─────────┼─────────┤
│ BL 左下 │ BC 下中 │ BR 右下 │   下排：低沉
│  军鼓   │  底鼓   │  低嗵   │
└─────────┴─────────┴─────────┘

区	乐器	sfx	pan	合成要点
TL	闭合踩镲	dm_hat	-0.6	6–10kHz 噪声，0.06s
TC	高音嗵	dm_tomhi	0	200→140Hz，0.25s
TR	吊镲	dm_crash	+0.6	长尾 ≤1.2s
BL	军鼓	dm_snare	-0.6	鼓皮+带通噪声，0.2s
BC	底鼓	inst_kick	0	130→45Hz，0.25s
BR	低音嗵	dm_tomlo	+0.6	120→75Hz，0.3s

Perfect 叠 dm_accent。zoneOf(x,y) 以 #game-root 为界；缺 payload 落 BC。领奏与玩家同一批 sfx。

同区连击：谱面上 1:BC, 2:BC 是两记点按。新手 doubleTapWindow: 0 时两下都是 tap，各自判定。不要再走「双击改判 / 序曲撤销账簿」——只保留 immediateTap 的 tapcancel（转滑动/长按时撤销这一下的认领，ghost 音收不回，统计必须回滚且不计 Miss）。

---

3. 循环与状态机（保留）

选曲 → 数拍（1 小节底鼓×4 + 每拍轻震）→ 逐乐句 → 过门/加花 → 终句吊镲 → 结算
idle → intro → tut → select → countin → main → end

• 正片数拍：inst_kick×4（guide.test G3 _sched 锚点保留）。
• 教学数拍：木鱼 dm_accent（G2：教学 _sched 里 kick=领奏音）。
• 每曲第一个应答窗前 1 小节：gd_answer + turn。
• 模态菜单（阶段 2）：下滑呼出；左右滑切换、单击确认；长按=重听菜单说明；再下滑关闭。暂停真冻结。恢复全网格平移 + 4 拍 count-in。

---

4. 谱面与难度（保留；新手无「双击手势」需求）

记号 拍:区码。加花尾音恒 TR。

4.1 曲目一《启程》90 BPM（8 句 + 终曲加花，≈65s）

句	领奏节奏型	音符数
1	1:BC, 3:BC	2
2	1:BL, 3:BR	2
3	1:BC, 2:BC, 3:BL	3（同区两记点按，不是双击手势）
4	1:BL, 2:BR, 3:BC	3
5	1:BC, 2:BL, 3:BC, 4:BR	4
6	1:TL, 3:BL, 4:BC	3
7	1:BC, 2:TL, 3:BC, 4:TR	4
8	1:BL, 2:BR, 3:TL, 4:BC	4
终曲加花	1:BC, 1.5:BC, 2:BC, 2.5:BL, 3:BL, 3.5:BC, 4:TR	7

前 4 句应答后各休 1 小节。曲目一普通句无反拍；反拍仅加花。

4.2 曲目二《追风》105 BPM

句	领奏节奏型	音符数
1	1:BC, 3:BR	2
2	1:BL, 2:BL, 3:BC	3
3	1:TL, 3:BL, 4:BR	3
4	1:BC, 2:BL, 3:BC, 4:TL	4
5	1:BC, 2.5:BR, 3:BC	3（首个反拍）
中途加花	1:BL, 1.5:BL, 2:BC, 2.5:BC, 3:BR, 3.5:BR, 4:TR	7
6	1:BL, 2:TL, 3.5:BR, 4:BC	4
7	1:BC, 2:BL, 3:BR, 3.5:TL	4
8	1:BR, 1.5:BL, 3:BC, 4:TR	4
9	1:BC, 2.5:TL, 3:BC, 4:BL	4
10	1:BL, 2:BR, 3:TL, 4:BC	4
终曲加花	1:BC, 1.5:BL, 2:BC, 2.5:BL, 3:BC, 3.5:BR, 4:TR	7

前 2 句应答后各休 1 小节。

4.3 曲目三《星爆》120 BPM

句	领奏节奏型	音符数
1	1:BC, 2:BL, 3:BC, 4:BL	4
2	1:TL, 2:BL, 3:TL, 4:BC	4
3	1:BR, 2:TR, 3:BR, 4:BL	4
4	1:BC, 2.5:TL, 3:BC, 4:BR	4
5	1:BL, 1.5:BR, 2.5:BL, 3:BC	4
6	1:BC, 2:TL, 2.5:BL, 3:BC, 4:TR	5
中途加花	1:TL, 1.5:TL, 2:BL, 2.5:BL, 3:BC, 3.5:BC, 4:TR	7
7	1:BR, 2:BC, 3:BL, 3.5:BR, 4:TL	5
8	1:BC, 1.5:BC, 2.5:BL, 3:BC, 3.5:TL, 4:TR	6
9	1:BL, 2:BC, 2.5:BR, 3:TL, 4:BL	5
10	1:BC, 2:BR, 3:BC, 3.5:TL, 4:BL	5
终曲加花	1:BC, 1.5:BL, 2:BC, 2.5:BL, 3:BC, 3.5:BC, 4:TR	7

全曲不休。

4.4 改谱规则

1. 曲目一 2→4 音、曲目二 2→4、曲目三 4→6；加花不计。
2. 反拍：曲目一只允许加花；曲目二第 5 句起普通句每句 ≤1；曲目三不限。
3. 同一分区连续 ≤2（两连合法，三连禁止）。
4. 乐句内分区种类 ≥2（仅曲目一句 1 允许纯底鼓）。
5. 相邻反拍禁止左列↔右列大跳（仅曲目三允许 BL↔BR）。
6. 加花尾音恒 TR。
7. 谱面不得要求「双击手势」；只需连续 tap。

---

5. 判定与计分（数字保留）

const PERFECT = 0.15;
const GOOD = 0.35;
const LOOKAHEAD = 0.6;
const PUMP_MS = 40;

• 判定时刻 = 触摸/数字键按下（immediateTap 零补偿）。
• 同分区最近未判定音符 |dt|≤GOOD → 出该区音；Perfect 叠 accent。
• 异分区音符 |dt|≤GOOD×0.5 被敲 = Miss（错鼓）。
• 窗外同区 = 自由演奏（出声不判定）。
• Miss 超时：expected+GOOD+0.10s → 闷镲（dm_hat 0.5×）+ invalid 回执 + 可选 error 震。主反馈是声音。
• 计分/评级/16 连击震/全 Perfect 震：数字沿用；震是补充。

退役：TAP_DELAY / SWIPE_DELAY / DOUBLE_DELAY、双击序曲撤销账簿、超时复活窗、滑动音符。

---

6. 教学（分区心智，保留四步）

零惩罚，单步重教 ≤2，第 2 次失败降速 25%，再败跳过。

步	内容
T0 摸鼓	双轴模型一句 → 探索：敲哪区出哪音+区名。摸 ≥3 区进 T1；8s 无触摸自动进 T1
T1 家区	数拍 → 领奏 1:BC → 应答
T2 左右下	1:BL, 3:BR
T3 上排	1:TL, 2:TC, 3:TR → tut_done → 曲目一

教学 Miss 归因真话。下滑跳过教学仅阶段 2 以后；新手回访者用开场「点一下开始」跳过。tut_fill 在曲目一终曲加花前 1 小节，每账号一次。

---

7. 反馈与语音配额（保留数字）

应答小节内零语音。教学失败至多 1 条纠正链。正片连 2 Miss 才 gd_miss，同曲一次。探索区名每区每轮一次。结算链 = grade + [new_best_combo] + [unlock] + restart。引擎 3s/5 次保险丝不得绕过。

---

8. 资产规格（保留）

打击乐 7 件程序合成，QC：去直流、8ms 淡化、真峰值 ≤−3 dBFS。BGM 三首 prompt 仍要求 no drums no percussion，90/105/120 BPM，A minor，bpm_precise.py 误差 >0.5 则 atempo。bgm/menu 保留。旧含鼓 track 删除。

---

9. 进度

key soundgame.rhythm.progress，schema 1：tutorialDone, unlocked, grades, bestCombo, summary（《曲名》X级 · 已解锁N/3首）。B 级解锁下一首。

结算：单击=同曲；右滑=下一首（未解锁播 song_locked；song3 右滑播 restart）；阶段 2 下滑=菜单。

---

10. 断言清单（修订）

A1–A5、A7–A5、A8–A25 原编号保留，交互口径改：

• A6：新手期 300ms 内同区两 tap = 两次独立敲击（可认领两音），不产生 doubletap 手势、无撤销账簿。阶段 3 若引擎仍发 doubletap，游戏层当第二次 tap。
• A10 菜单：main 中阶段 2 后下滑呼菜单；单击确认当前项，不是双击确认；恢复后平移量 = 暂停 + count-in；gd_count 每曲 1 次。
• A21：演奏期单击是演奏；讲解期单击跳句，400ms 内再点=busy。
• 增补 A26：新手谱面/教程不依赖 g==='doubletap'。
• 增补 A27：演奏期 Floor=ACTION，无等待声；选曲 YOUR_TURN 有等待声或 menu pad。
• 增补 A28：无声操作 0；Miss 有闷镲或回执。

其余 A1 分区、A2 窗、A3 错鼓、A4 超时、A5 tapcancel、A9 数拍、A11 加花、A12–A16 评级进度、A17 配额、A18 键盘、A19 guide 签名、A20 资产、A22 全局、A23–A25 R1 修复：保留。

13 号旧 §4 手势模式断言不回改；鼓手验收以本节 + 13 号 §5 为准。

---

11. 预算台账（保留）

语音 49 id×2；打击乐 7 件；BGM 上限见原文工艺。开发零 API 费。

---

12. 废止清单

废止	改为
双击手势=一种音符；双击确认菜单	只有分区点按；菜单左右滑+单击
新手 doubleTapWindow 300ms	0；两下两击
演奏期等待声 / 帮助插播	ACTION；应答内零语音
暂停恢复无 count-in	4 拍 count-in
Miss 只震	闷镲 + 回执 + 真话归因
帮助用上滑（与上排鼓冲突）	非演奏期长按
开场长规则	T0 先摸鼓
03 号手势乐器谱作为现行施工	以本文为准

引擎坐标第二参、分区布局、时值、曲目表、合成与 BGM 工艺：全部保留。