- 设计:docs/design/23-hunt.md + voice-ids(84 id,166条)+ 13号断言登记,§15记录10+1条设计裁决 - 服务器:零依赖WebSocket(ws.js)+ 房间管理/服务端权威战斗/bot AI(hunt-room.js),断线30s宽限resume回槽、超时转bot;修复package.json模块类型误判的既有破坏 - 客户端:web/hunt/ 全套(教学T0-T4/听觉视野裁剪R1-R8/结算排行榜/guide接入),playtest 211断言 - 引擎:audio.js 后向兼容 opts.pan(StereoPannerNode),web-engine-api.md 同步 - 资产:166条TTS语音(QC无离群)+ 13件合成sfx(真峰值≤-3dBFS)+ 2首Mureka BGM,终检全绿 - 平衡:bot调参至挂机局71%失守/C、3bot局71% A/B(hunt-balance-scan.mjs 24种子扫描) - 接线:大厅卡片、profiles.js hunt桶、README/roadmap MMO路线条目 验证:hunt-sim 16/16 + api-smoke 12/12 + hunt playtest 211/211 + 既有10游戏与引擎回归零回退 + 真服务器WS端到端冒烟通过
6.0 KiB
6.0 KiB
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 句台词表 + 增补(战斗震动配合、无声前摇协议、层叠规则) | ⑩ |
| 23-hunt.md + 23-hunt-voice-ids.md | 《围猎》2-4 人实时联机协作守卫(纯音频 MMORPG 路线第一阶段切片):零依赖 WS 协议 + 服务端权威战斗、bot 行为与补位、音频拥挤控制 R1-R8、引擎 opts.pan 改动 + 84 台词 id(60 旁白 ×2 性别 + 24 bot 喊话) | 长线方向 |
new8 系列设计文档(8 款新 RPG,research/new8/00-program.md)
| 文档 | 内容 |
|---|---|
| 15-radio.md + voice-ids | 《不眠频率》深夜电台热线叙事(批次 1 交付,4/4 人设满分档):9 抉择 4 结局、口碑经济、电话滤波资产侧带通 |
| 16-dungeon.md + voice-ids | 《回声地窟》听声辨位 Roguelike(批次 1 交付,0/4→4/4 翻案):脉冲回声、seed 生成、双轨看门狗、元进度遗产 |
| 17-abyss.md + voice-ids | 《深海回音》深海救援叙事(批次 2):声呐双通道仲裁、氧气软失败经济(512 组合穷举验算)、148 句 |
| 18-detective.md + voice-ids | 《雨夜专案》本格推理(批次 2):证词矛盾=数据单源推导、评级 S-C、二周目变体案、158 句 |
| 19-cipher.md + voice-ids | 《暗码》1940 密战叙事(批次 3):摩尔斯运行时合成解码、暴露度经济、三层兜底、139 句 |
| 21-keeper.md + voice-ids | 《守塔人》孤岛灯塔叙事(批次 4):时空双线签名(风暴/老唱片)、回忆插叙三段、信任×真相双标量、148 句 |
| 22-bridge.md + voice-ids | 《星环舰长》舰桥指挥(批次 4):四象限系统状态音+告警仲裁 R1-R8(双危机穷举)、危机事件卡、忠诚账本、评级 S-D、154 句 |
| 20 / 22 | 《深夜茶馆》《星环舰长》(批次 3/4,设计进行中,落地后补登记) |
各 voice-ids 文档的「键盘变体」小节由 KEY_LINES 程序化生成(tools/gen_voice_dual.py 单源),含 PC 键盘措辞(按空格/按回车/按方向键)。
审查档案(各轮落实度与裁定记录)
| 文档 | 内容 |
|---|---|
| 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)。