# 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` 必填；退出存档；重进一句复述。