xsl/SoundGame
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

save

Browse Source
This commit is contained in:
xsl
2026-10-01 23:26:47 +08:00
parent e943227136
commit 9e4d67aa84
50 changed files with 3913 additions and 8243 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/design/README.md
+56 -47
View File
@@ -1,63 +1,72 @@
# SoundGame 设计文档（5 轮迭代全记录）
# SoundGame 设计文档
本目录是纯音频游戏合集的设计规范与审查档案。开发 agent 开工前必读对应文档开头的
"给开发者的实现要点摘要"；全局规范（00）对任何游戏改动都生效。
后续路线见 [roadmap.md](roadmap.md)。
本目录是纯音频游戏合集的设计规范与审查档案。
## 设计规范（施工依据）
**交互权威（2026-10 起）**：[26-audio-interaction-playbook.md](26-audio-interaction-playbook.md)。全局施工口径：[00-global-ux.md](00-global-ux.md)。两份与旧豁免表、旧试玩记录冲突时，以 26 号为准。
| 文档 | 内容 | 对应用户反馈 |
|---|---|---|
| [00-global-ux.md](00-global-ux.md) | 全局交互规范（终审修订版）：设置系统、haptics 震动语言（10 震型）、旁白整句化、手势约定与模态菜单、用户系统 API | ⑥⑦ + 全局需求 |
| [26-audio-interaction-playbook.md](26-audio-interaction-playbook.md) | 纯音频交互第一性原理与落地手册：对话模型、16 原则、发言权管理器/输入回执/新手手势/三档提示/迷茫检测/语音优先级、三张设计单模板、P0-P3 改造顺序、乱点机器人与真人冷启动验证 | 真人试玩「搞不清状态、点两下就重复、不知道怎么玩」 |
| [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 号手册首批落地（R3）：三款游戏的设计单（附录 C：状态×手势矩阵/等待点/逐秒脚本/失败表/台词类别）+ 引擎新模块（floor/receipts/confusion/hints/novice/pipeline） | 同上 |
| [01-escape-redesign.md](01-escape-redesign.md) | 《暗室》重设计：引导式开场、三级卡关提示、线索音可重听 | ⑤ |
| [02-simon-redesign.md](02-simon-redesign.md) | 《音序回响》重设计：去 BGM、旁白整句化、交互式教学、复活机制（含双击语义裁定） | ⑥⑦ |
| [03-rhythm-rebuild.md](03-rhythm-rebuild.md) + [03-rhythm-voice-ids.md](03-rhythm-voice-ids.md) | 《节拍行者》重构施工稿：跟随领奏玩法、三首完整谱面、判定契约、31 句台词表 | ⑧ |
| [04-space-rebuild.md](04-space-rebuild.md) + [04-space-voice-ids.md](04-space-voice-ids.md) | 《盲航》重构：交互式演练、同向闪避、60 秒保护期、52 句台词表 | ⑨ |
| [05-rpg.md](05-rpg.md) + [05-rpg-chapter1.md](05-rpg-chapter1.md) + [05-rpg-ch1-voice-ids.md](05-rpg-ch1-voice-ids.md) + [05-rpg-addendum.md](05-rpg-addendum.md) | 新 RPG《剑与声》：总设计 + 第一章施工稿（场景图/战斗状态机/数值/存档/资产 prompt）+ 120 句台词表 + 增补（战斗震动配合、无声前摇协议、层叠规则） | ⑩ |
| [23-hunt.md](23-hunt.md) + [23-hunt-voice-ids.md](23-hunt-voice-ids.md) | 《围猎》2-4 人实时联机协作守卫（纯音频 MMORPG 路线第一阶段切片）：零依赖 WS 协议 + 服务端权威战斗、bot 行为与补位、音频拥挤控制 R1-R8、引擎 opts.pan 改动 + 84 台词 id（60 旁白 ×2 性别 + 24 bot 喊话） | 长线方向 |
开发开工前：读 26 号 + 00 + 该游戏正文开头的「给开发者的实现要点摘要」和「设计单」。路线见 [roadmap.md](roadmap.md)。
## new8 系列设计文档（8 款新 RPG，research/new8/00-program.md）
## 全局规范
| 文档 | 内容 |
|---|---|
| [15-radio.md](15-radio.md) + voice-ids | 《不眠频率》深夜电台热线叙事（批次 1 交付，4/4 人设满分档）：9 抉择 4 结局、口碑经济、电话滤波资产侧带通 |
| [16-dungeon.md](16-dungeon.md) + voice-ids | 《回声地窟》听声辨位 Roguelike（批次 1 交付，0/4→4/4 翻案）：脉冲回声、seed 生成、双轨看门狗、元进度遗产 |
| [17-abyss.md](17-abyss.md) + voice-ids | 《深海回音》深海救援叙事（批次 2）：声呐双通道仲裁、氧气软失败经济（512 组合穷举验算）、148 句 |
| [18-detective.md](18-detective.md) + voice-ids | 《雨夜专案》本格推理（批次 2）：证词矛盾=数据单源推导、评级 S-C、二周目变体案、158 句 |
| [19-cipher.md](19-cipher.md) + voice-ids | 《暗码》1940 密战叙事（批次 3）：摩尔斯运行时合成解码、暴露度经济、三层兜底、139 句 |
| [21-keeper.md](21-keeper.md) + voice-ids | 《守塔人》孤岛灯塔叙事（批次 4）：时空双线签名（风暴/老唱片）、回忆插叙三段、信任×真相双标量、148 句 |
| [22-bridge.md](22-bridge.md) + voice-ids | 《星环舰长》舰桥指挥（批次 4）：四象限系统状态音+告警仲裁 R1-R8（双危机穷举）、危机事件卡、忠诚账本、评级 S-D、154 句 |
| 20 / 22 | 《深夜茶馆》《星环舰长》（批次 3/4，设计进行中，落地后补登记） |
| [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_* 资产对照 |
各 voice-ids 文档的「键盘变体」小节由 KEY_LINES 程序化生成（tools/gen_voice_dual.py 单源），含 PC 键盘措辞（按空格/按回车/按方向键）。
## 首批落地设计单
## 审查档案（各轮落实度与裁定记录）
| 文档 | 游戏 |
|---|---|
| [26-apply-storyline.md](26-apply-storyline.md) | 声命线 |
| [26-apply-escape.md](26-apply-escape.md) | 暗室 |
| [26-apply-simon.md](26-apply-simon.md) | 音序回响 |
各游戏正文已按同一附录 C 重写，与上表重复处以**游戏正文 + 26 号**为准。
## 游戏设计（26 号对齐版）
| 文档 | 内容 |
|---|---|
| [round1-review.md](round1-review.md) | R1 基建审查：6 处出入裁定（haptics 命名、voice 平铺回退、`_settings` 保留键等） |
| [round2-review.md](round2-review.md) | R2 暗室/音序审查：落实度 ~95%；裁决① simon 双击上下文判定、裁决② 全球模态菜单约定 |
| [round3-4-review.md](round3-4-review.md) | R3 节拍/R4 盲航审查：4 项裁定（结算末位语音、menu_main 文案、space 难度不回调、震动总量批准）+ 附裁 A（玩法手势优先的菜单折中模式） |
| [round5-notes.md](round5-notes.md) | 给 RPG 开发 agent 的返工注意级提示（看门狗/会话令牌/末位语境/震动去抖/层叠实现） |
| [roadmap.md](roadmap.md) | 后续路线：RPG 二三章扩展、storyline 打磨（菜单统一/knowTrap 死标记/角色音色）、真机听测 checklist、商业化前置 |
| [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) | 围猎：联机切片 + 新手三手势叠加 |
## 5 轮迭代计划总表（已执行完毕）
### new8
| 轮次 | 主题 | 结果 |
|---|---|---|
| **R1** | 基建 + 设计 | 设计文档集；引擎 settings/haptics/voice 目录；大厅设置+登录；服务器 API；删 reflex |
| **R2** | 暗室 + 音序重设计 | 两游戏重写落地，语音 142 id ×2 性别；审查 round2-review |
| **R3** | 节拍重构 | 跟随领奏落地（3 曲目解锁制）；审查 round3-4-review §1 |
| **R4** | 盲航重构 + RPG 资产 | 盲航重写落地（演练/保护期/同向）；RPG 台词表与资产清单交付；审查 round3-4-review §2 |
| **R5** | RPG 开发 + 总打磨 | 进行中；开发提示 round5-notes；后续路线 roadmap |
| 文档 | 内容 |
|---|---|
| [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 事实源。
- 旁白：整句预生成、同角色 speaker+instruct 恒定、female/male 双目录、ogg+m4a 双格式（00 §3）。
- 反馈：操作反馈一律震动（`engine/haptics.js` 10 预定义震型），iOS 静默降级不回退提示音（00 §2）。
- 手势：默认映射 + 豁免表 + 模态菜单约定（00 §5），任何偏离必须在开场交互教学中讲清。
- 教学：禁止"连续旁白讲完就开考"；一切教学交互式，做错不惩罚、当场重教。
- 设置：游戏内只读，改动只在大厅页（00 §1）。
- 进度：data 自由格式 + 必带 `summary`，localStorage 兜底 + 服务器同步，`_settings` 为保留键（00 §4）。
## 审查档案（历史，交互规则不作依据）
| 文档 | 内容 |
|---|---|
| [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` 必填；退出存档；重进一句复述。