SoundGame Dev
cc0f8c008d
- 新增 web/ 纯音频 HTML5 平台：共享引擎（手势/WebAudio 三层/设置/震动）、 Node 零依赖服务器（静态 + 注册登录 + 进度存档 API） - 游戏：剑与声(RPG 新作)、声命线、暗室(重设计)、音序回响(重设计)、 节拍行者(跟随领奏重构)、盲航(同向闪避重构)；声东击西删除 - 全局功能：男声/女声双套 TTS 资产、三档语速、BGM 音量三档、 震动反馈语言(10 种震型)、服务器进度同步 - 资产：899 ogg + 899 m4a（Qwen3-TTS 双性别语音、Stable Audio 3 音效、 Mureka BGM 4+3 首），终检零缺失 - 文档：docs/design/ 13 篇设计审查文档、docs/audio/ 资产管线、 web/server/README.md API 文档
SoundGame 设计文档（5 轮迭代全记录）
本目录是纯音频游戏合集的设计规范与审查档案。开发 agent 开工前必读对应文档开头的 "给开发者的实现要点摘要"；全局规范（00）对任何游戏改动都生效。 后续路线见 roadmap.md。
设计规范（施工依据）
| 文档 | 内容 | 对应用户反馈 |
|---|---|---|
| 00-global-ux.md | 全局交互规范（终审修订版）：设置系统、haptics 震动语言（10 震型）、旁白整句化、手势约定与模态菜单、用户系统 API | ⑥⑦ + 全局需求 |
| 01-escape-redesign.md | 《暗室》重设计：引导式开场、三级卡关提示、线索音可重听 | ⑤ |
| 02-simon-redesign.md | 《音序回响》重设计：去 BGM、旁白整句化、交互式教学、复活机制（含双击语义裁定） | ⑥⑦ |
| 03-rhythm-rebuild.md + 03-rhythm-voice-ids.md | 《节拍行者》重构施工稿：跟随领奏玩法、三首完整谱面、判定契约、31 句台词表 | ⑧ |
| 04-space-rebuild.md + 04-space-voice-ids.md | 《盲航》重构：交互式演练、同向闪避、60 秒保护期、52 句台词表 | ⑨ |
| 05-rpg.md + 05-rpg-chapter1.md + 05-rpg-ch1-voice-ids.md + 05-rpg-addendum.md | 新 RPG《剑与声》：总设计 + 第一章施工稿（场景图/战斗状态机/数值/存档/资产 prompt）+ 120 句台词表 + 增补（战斗震动配合、无声前摇协议、层叠规则） | ⑩ |
审查档案（各轮落实度与裁定记录）
| 文档 | 内容 |
|---|---|
| round1-review.md | R1 基建审查：6 处出入裁定（haptics 命名、voice 平铺回退、_settings 保留键等） |
| round2-review.md | R2 暗室/音序审查：落实度 ~95%；裁决① simon 双击上下文判定、裁决② 全球模态菜单约定 |
| round3-4-review.md | R3 节拍/R4 盲航审查：4 项裁定（结算末位语音、menu_main 文案、space 难度不回调、震动总量批准）+ 附裁 A（玩法手势优先的菜单折中模式） |
| round5-notes.md | 给 RPG 开发 agent 的返工注意级提示（看门狗/会话令牌/末位语境/震动去抖/层叠实现） |
| roadmap.md | 后续路线：RPG 二三章扩展、storyline 打磨（菜单统一/knowTrap 死标记/角色音色）、真机听测 checklist、商业化前置 |
5 轮迭代计划总表（已执行完毕）
| 轮次 | 主题 | 结果 |
|---|---|---|
| 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 |
横切约束（每轮验收都要查）：
- 旁白：整句预生成、同角色 speaker+instruct 恒定、female/male 双目录、ogg+m4a 双格式（00 §3）。
- 反馈：操作反馈一律震动（
engine/haptics.js10 预定义震型），iOS 静默降级不回退提示音（00 §2）。 - 手势：默认映射 + 豁免表 + 模态菜单约定（00 §5），任何偏离必须在开场交互教学中讲清。
- 教学：禁止"连续旁白讲完就开考"；一切教学交互式，做错不惩罚、当场重教。
- 设置：游戏内只读，改动只在大厅页（00 §1）。
- 进度：data 自由格式 + 必带
summary，localStorage 兜底 + 服务器同步，_settings为保留键（00 §4）。