Files
SoundGame/docs/design
xsl ede522dda1 feat(platform/P0): 无感用户系统 + PC 键盘双端一致(两 agent 并行 + 集成收口)
用户系统(B,游戏零改动):
- POST /api/device 首访 0 交互静默建档(自动玩家一/二…,per-IP 频控);断网降级纯本地照玩
- 大厅档案切换器(切换=flush 上云→快照回灌→倒灌→服务器回拉,profileId 分桶修同设备串档;aria menu 编号可听)
- claim 可选认领(命名+scrypt PIN);旧 users/sessions 单向迁移(PIN 明文即刻哈希,已真实数据验证);login 兼容+claim-merge 桶级 LWW;logout;/server/ 静态封禁
- PUT baseUpdatedAt 守卫(legacy 放行+警告);GET 无参全桶回拉(修 7/8 游戏跨设备只 PUT 不 GET)
- web/profiles.js 分桶纯函数 + api-smoke.mjs 7/7(建档/LWW/claim-merge/迁移/频控/封禁/分桶 H1-H4)

键盘双端(A,游戏代码零改动):
- gesture.js 键盘通道 +137 行:←↑↓→/WASD=滑动、空格=单击(走 300ms 双击窗与触摸共享虚拟指针)、回车=即时 doubletap、按住空格 ≥450ms=长按;repeat 抑制/表单守卫/方向键 preventDefault
- settings.input(auto/touch/key)+ gesture.inputMode();遮罩键盘解锁与文案自适应(按空格开始/轻触开始)
- 8 游戏遮罩改用自适应默认文案;大厅设置面板「操作方式」+页脚键位提示
- live control.mjs 键盘注入通道(CDP dispatchKeyEvent);engine-input.test 61 断言

回归:12 套件全绿(8 playtest + guide + engine-voice + engine-input + api-smoke 7/7);8001 服务器已重启加载新 API,/api/device 端到端验证通过

P1 待排:153 句×双性 TTS 键盘语音变体 / 6 位配对码跨设备 / 认领 UI 打磨(research/platform/00-synthesis.md §3)
2026-09-09 23:39:23 +08:00
..

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.js 10 预定义震型),iOS 静默降级不回退提示音(00 §2)。
  • 手势:默认映射 + 豁免表 + 模态菜单约定(00 §5),任何偏离必须在开场交互教学中讲清。
  • 教学:禁止"连续旁白讲完就开考";一切教学交互式,做错不惩罚、当场重教。
  • 设置:游戏内只读,改动只在大厅页(00 §1)。
  • 进度:data 自由格式 + 必带 summary,localStorage 兜底 + 服务器同步,_settings 为保留键(00 §4)。