xsl/SoundGame
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c8843233b0fd364c3cc8bf456b3ce92c226bc35e
SoundGame/docs/design/README.md
T
xsl 005851d01a feat(hunt): 《围猎》2-4人实时联机纯音频协作守卫——纯音频MMORPG第一阶段切片 
- 设计：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端到端冒烟通过
2026-09-13 11:08:01 +08:00

62 lines
6.0 KiB
Markdown
Raw 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 设计文档（5 轮迭代全记录）
本目录是纯音频游戏合集的设计规范与审查档案。开发 agent 开工前必读对应文档开头的
"给开发者的实现要点摘要"；全局规范（00）对任何游戏改动都生效。
后续路线见 [roadmap.md](roadmap.md)。
## 设计规范（施工依据）
| 文档 | 内容 | 对应用户反馈 |
|---|---|---|
| [00-global-ux.md](00-global-ux.md) | 全局交互规范（终审修订版）：设置系统、haptics 震动语言（10 震型）、旁白整句化、手势约定与模态菜单、用户系统 API | ⑥⑦ + 全局需求 |
| [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 喊话） | 长线方向 |
## 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，设计进行中，落地后补登记） |
各 voice-ids 文档的「键盘变体」小节由 KEY_LINES 程序化生成（tools/gen_voice_dual.py 单源），含 PC 键盘措辞（按空格/按回车/按方向键）。
## 审查档案（各轮落实度与裁定记录）
| 文档 | 内容 |
|---|---|
| [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、商业化前置 |
## 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.js` 10 预定义震型），iOS 静默降级不回退提示音（00 §2）。
- 手势：默认映射 + 豁免表 + 模态菜单约定（00 §5），任何偏离必须在开场交互教学中讲清。
- 教学：禁止"连续旁白讲完就开考"；一切教学交互式，做错不惩罚、当场重教。
- 设置：游戏内只读，改动只在大厅页（00 §1）。
- 进度：data 自由格式 + 必带 `summary`，localStorage 兜底 + 服务器同步，`_settings` 为保留键（00 §4）。
Reference in New Issue View Git Blame Copy Permalink