Files
xsl ee5d4d2544 feat(playbook): 26 号交互手册全量落地——剩余 12 款深度重构 + 语音全量重制
storyline/escape/simon 首批之后的推广收官:15 款全部按 26 号模式运行
(发言权/回执/三档提示/迷茫接管/手势阶梯/断点复述),旧「双击重听/格挡/
菜单确认」等反模式口径全线废除,开场零规则念白(首句即动手)。

游戏层(12 款):rpg(格挡=前摇窗口内再单击)/ rhythm / space / radio /
dungeon / abyss / detective / cipher / teahouse / keeper / bridge /
hunt(联机切片):
- 每款 game.js 接引擎六模块 + makeInputPipeline(doubleTapWindow:0);
  四向玩法类 swipeCore + 长按帮助;双击是玩法的(space 护盾 / hunt
  旋风斩)按手势阶梯阶段 3 分档恢复双击窗口(doubletapCore)
- 每款 playtest 重写:玩法断言 + §6.2 乱点机器人(无声操作 / 被动
  原句重复 / 打断失败 = 0);15 款 3900+ 断言全绿
- 12 份 docs/design/26-apply-*.md 施工单 + tools/voice_lines_26/
  台词清单 + voice-ids 文档同步 + 转写会话剧本按新口径重写

引擎层(web/engine/,6 处修复):pipeline 增 doubletapCore;novice
teachLine 带 voice/ 前缀(此前教学句被静默丢弃);confusion.record
前置到新手门(锁定手势的乱点也计信号);InvalidHints 播完恢复解释前
状态(根治孤儿 BUSY);WaitPoint takeover(2) 台账去重;台账只在
speak 真正播出时登记。遗留引擎债登记 roadmap §3.1。

语音资产:台词表合并(新增 ~250 系统句 / 改 ~50 旧口径 / 删 ~110
废止句;合并器 tools/merge_voice_lines_26.py + 引用校验器
tools/validate_voice_refs.py),GPU 重录 1536 wav → 4204 ogg/m4a
落地,check_all_assets + validate_voice_refs 双绿;键盘变体同步扩表。

大厅/文档:15 款统一新交互口径(「新交互」徽标退役);README /
HANDOVER / rpg README 旧口径修正;roadmap P0-P3 置完成。
2026-10-02 12:33:20 +08:00

89 lines
5.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SoundGame 设计文档
本目录是纯音频游戏合集的设计规范与审查档案。
**交互权威(2026-10 起)**:[26-audio-interaction-playbook.md](26-audio-interaction-playbook.md)。全局施工口径:[00-global-ux.md](00-global-ux.md)。两份与旧豁免表、旧试玩记录冲突时,以 26 号为准。
开发开工前:读 26 号 + 00 + 该游戏正文开头的「给开发者的实现要点摘要」和「设计单」。路线见 [roadmap.md](roadmap.md)。
## 全局规范
| 文档 | 内容 |
|---|---|
| [26-audio-interaction-playbook.md](26-audio-interaction-playbook.md) | 第一性原理、16 原则、六个引擎模块、三张设计单模板、P0~P3、验证 |
| [00-global-ux.md](00-global-ux.md) | 设置、回执+震动、旁白写作、用户系统、新手三手势、菜单、键盘、Floor |
| [10-feedback2-state-bgm.md](10-feedback2-state-bgm.md) | 状态 BGM;整链 duck;等待声不走 BGM 层 |
| [12-skip-and-longpress-ux.md](12-skip-and-longpress-ux.md) | 跳句、400ms 防连点、长按加速 vs 长按帮助 |
| [13-playtest-criteria.md](13-playtest-criteria.md) | 乱点机器人、矩阵、真人冷启动、玩法回归 |
| [14-guide-layer.md](14-guide-layer.md) | Floor / 三档提示 / 迷茫接管;旧 gd_* 资产对照 |
## 施工单(26 号落地,15 款全部完成)
首批三款为完整设计单(无独立正文的以施工单为设计正文);其余 12 款为瘦版施工单(实现接线 + 偏差记录 + 台词类别映射 + 测试记录,设计单正文见各游戏号附录 C):
| 文档 | 游戏 |
|---|---|
| [26-apply-storyline.md](26-apply-storyline.md) | 声命线(完整设计单) |
| [26-apply-escape.md](26-apply-escape.md) | 暗室(完整设计单) |
| [26-apply-simon.md](26-apply-simon.md) | 音序回响(完整设计单) |
| [26-apply-rpg.md](26-apply-rpg.md) | 剑与声 |
| [26-apply-rhythm.md](26-apply-rhythm.md) | 节拍行者 |
| [26-apply-space.md](26-apply-space.md) | 盲航 |
| [26-apply-hunt.md](26-apply-hunt.md) | 围猎 |
| [26-apply-radio.md](26-apply-radio.md) | 不眠频率 |
| [26-apply-dungeon.md](26-apply-dungeon.md) | 回声地窟 |
| [26-apply-abyss.md](26-apply-abyss.md) | 深海回音 |
| [26-apply-detective.md](26-apply-detective.md) | 雨夜专案 |
| [26-apply-cipher.md](26-apply-cipher.md) | 暗码 |
| [26-apply-teahouse.md](26-apply-teahouse.md) | 深夜茶馆 |
| [26-apply-keeper.md](26-apply-keeper.md) | 守塔人 |
| [26-apply-bridge.md](26-apply-bridge.md) | 星环舰长 |
台词增量清单(合并进 `tools/gen_voice_dual.py` 的原始记录):`tools/voice_lines_26/<game>.md`;合并工具 `tools/merge_voice_lines_26.py`;引用一致性校验 `tools/validate_voice_refs.py`。
各游戏正文已按同一附录 C 重写,与上表重复处以**游戏正文 + 26 号**为准。
## 游戏设计(26 号对齐版)
| 文档 | 内容 |
|---|---|
| [01-escape-redesign.md](01-escape-redesign.md) + [25-escape-map-flow.md](25-escape-map-flow.md) | 暗室:四向移动,单击检查+使用,长按问路 |
| [02-simon-redesign.md](02-simon-redesign.md) | 音序:音色渐进解锁,失败免费重听,帮助=长按 |
| [03-rhythm-rebuild.md](03-rhythm-rebuild.md) / [24-rhythm-drummer.md](24-rhythm-drummer.md) | 节拍:03 为历史领奏稿;**现行施工以 24 鼓手模式为准** |
| [04-space-rebuild.md](04-space-rebuild.md) | 盲航:同向闪避,高级手势后解锁 |
| [05-rpg.md](05-rpg.md) + chapter1 / addendum / [11-rpg-battle-rebalance.md](11-rpg-battle-rebalance.md) | 剑与声:前摇窗口再单击格挡 |
| [23-hunt.md](23-hunt.md) | 围猎:联机切片 + 新手三手势叠加 |
### new8
| 文档 | 内容 |
|---|---|
| [15-radio.md](15-radio.md) | 不眠频率:叙事,单击继续,左右滑抉择 |
| [16-dungeon.md](16-dungeon.md) | 回声地窟:四向走,单击脉冲,长按问路 |
| [17-abyss.md](17-abyss.md) | 深海回音 |
| [18-detective.md](18-detective.md) | 雨夜专案 |
| [19-cipher.md](19-cipher.md) | 暗码 |
| [20-teahouse.md](20-teahouse.md) | 深夜茶馆 |
| [21-keeper.md](21-keeper.md) | 守塔人 |
| [22-bridge.md](22-bridge.md) | 星环舰长 |
台词表 `*-voice-ids.md` 是**资产清单**(含键盘变体)。文案里的「双击重听」等旧口径已废止,须按各游戏正文重录;生成管线仍以 `tools/gen_voice_dual.py` 为 id 事实源。
## 审查档案(历史,交互规则不作依据)
| 文档 | 内容 |
|---|---|
| [round1-review.md](round1-review.md) | R1 基建出入(haptics 命名、平铺回退、`_settings`) |
| [round2-review.md](round2-review.md) | R2 暗室/音序;其中「双击确认菜单」已废止 |
| [round3-4-review.md](round3-4-review.md) | R3/R4 节拍/盲航工程教训仍可参考 |
| [round5-notes.md](round5-notes.md) | RPG 工程健壮性(会话令牌、语音链兜底);格挡已改为窗口内单击 |
## 横切约束(每轮验收)
- 交互:26 号 16 原则 + 00 手势宪法 + 13 合格指标。
- 旁白:整句、同角色 speaker+instruct、双目录、ogg+m4a;指令 ≤12 字,叙事 ≤25 字。
- 回执:ok/invalid/busy 必须出声;震动只是补充。
- 教学:第一句动手;一次只教一个;成功后不灌补救。
- 设置:游戏内只读。
- 进度:`summary` 必填;退出存档;重进一句复述。