Files

T

xsl ee9d7efe57 feat(playbook): 26 号交互手册首批落地——storyline/escape/simon 全面重构 + 引擎六模块

按 docs/design/26-audio-interaction-playbook.md 重构三款游戏（对白重写 + 双性别语音重生成 580 文件）。

引擎层（web/engine/，其余 12 款游戏零改动）：
- floor.js 发言权管理器：SPEAKING/YOUR_TURN/BUSY/ACTION 四态、交接提示音、
  等待声（220/330Hz 嘟-嘟，20s 后放缓）、跨链音乐压低（audio.js holdDuck）
- receipts.js 输入回执三件套（ok/invalid/busy，100ms 内，原则 4）
- confusion.js 迷茫检测（乱点/无效/静默信号 → 三级接管，§4.5）
- hints.js 等待点 + 三档提示（full→short→提示音，30s 台账跨点去重，原则 9）
- novice.js 手势解锁阶梯（up/down/doubletap 跨局持久，§4.3）
- pipeline.js 输入管道（回执收口、防连点 400ms、双击折算、explainOnce）

游戏层：
- storyline R3：开场 71.7s 规则念白 → 3 秒内动手；双击=重播（反模式5）废除；
  抉择点三档提示+主动重听；断点存档复述（§4.12）
- escape R3：单击=检查+使用合并（双击用法废除）；长按=我在哪（四向玩法裁定）；
  撞墙归因每方向一次（原则 7）；迷茫 L2 缩小/L3 演示；坐标存档续玩
- simon R3：新手三音色，按实力渐进解锁（+up/down/dt）；失败表替代机会账
  （归因 2s 内→免费重听→放慢→结算，原则 15）；播放期手势=busy 回执

测试：三款 playtest 重写（含 §6.2 乱点机器人：无声操作/被动重复/打断失败全 0，
首操作 ~2s）；guide.test 改为 Guide 层单测+rhythm/space 段。全部通过
（38+33+22+72+19+35 断言）。设计单见 docs/design/26-apply-*.md。

2026-10-01 08:11:12 +08:00

6.8 KiB

Raw Blame History

SoundGame 设计文档（5 轮迭代全记录）

本目录是纯音频游戏合集的设计规范与审查档案。开发 agent 开工前必读对应文档开头的 "给开发者的实现要点摘要"；全局规范（00）对任何游戏改动都生效。后续路线见 roadmap.md。

设计规范（施工依据）

文档	内容	对应用户反馈
00-global-ux.md	全局交互规范（终审修订版）：设置系统、haptics 震动语言（10 震型）、旁白整句化、手势约定与模态菜单、用户系统 API	⑥⑦ + 全局需求
26-audio-interaction-playbook.md	纯音频交互第一性原理与落地手册：对话模型、16 原则、发言权管理器/输入回执/新手手势/三档提示/迷茫检测/语音优先级、三张设计单模板、P0-P3 改造顺序、乱点机器人与真人冷启动验证	真人试玩「搞不清状态、点两下就重复、不知道怎么玩」
26-apply-storyline.md / 26-apply-escape.md / 26-apply-simon.md	26 号手册首批落地（R3）：三款游戏的设计单（附录 C：状态×手势矩阵/等待点/逐秒脚本/失败表/台词类别）+ 引擎新模块（floor/receipts/confusion/hints/novice/pipeline）	同上
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.js 10 预定义震型），iOS 静默降级不回退提示音（00 §2）。
手势：默认映射 + 豁免表 + 模态菜单约定（00 §5），任何偏离必须在开场交互教学中讲清。
教学：禁止"连续旁白讲完就开考"；一切教学交互式，做错不惩罚、当场重教。
设置：游戏内只读，改动只在大厅页（00 §1）。
进度：data 自由格式 + 必带 summary，localStorage 兜底 + 服务器同步，_settings 为保留键（00 §4）。

6.8 KiB Raw Blame History Unescape Escape