初始提交：3 款纯音频游戏 + 共享引擎 + 完整文档与资产管线

- 共享引擎（app/src/main）：GestureEngine 6 手势识别、AudioEngine 三层音频
  （ExoPlayer BGM 交叉淡入 / 对白 ducking / SoundPool 低延迟）、Game/GameEngine
  状态机接口、MainActivity 全屏封面 + TalkBack
- 《声命线》storyline：末世互动广播剧，3 幕 8 抉择点 4 结局
- 《声东击西》reflex：听声辨位反应，12 波战斗 + BGM 三档 BPM 变速
- 《暗室》escape：3x3 网格密室逃脱，钥匙→铁柜→保险丝→电箱→大门谜题链
- 文档：setup（从零搭建）/ architecture（架构）/ engine-api（引擎 API）/
  asset-pipeline（资产流水线）/ games/*（三款游戏设计文档）
- 资产管线：Qwen3-TTS 对白 + 程序合成音效/BGM + Mureka BGM 的 gen 脚本与台账，
  全部 ogg 资产入库可复现
- env.d 环境脚本：android/tts 入库；sfx/mureka 含密钥不入库，仅提交 .example.sh 模板

env.d/sfx.example.sh

@@ -0,0 +1,14 @@
+# Stable Audio 3 small-sfx 音效生成环境变量（模板）
+# 用法: cp env.d/sfx.example.sh env.d/sfx.sh，填入真实 HF_TOKEN 后 source env.d/sfx.sh
+# 注意: env.d/sfx.sh 含真实 token，已被 .gitignore 忽略，切勿提交
+export PATH="$HOME/.local/bin:$PATH"
+export HF_HOME=/home/ubuntu/SoundGame/models/hf
+# 注意: hf-mirror 镜像会把 gated 模型 308 重定向回 huggingface.co 导致下载失败。
+# Stable Audio 3 是 gated 模型, 必须直连官方端点。
+# 若以后直连失效且只用公开模型, 可临时改回镜像:
+# export HF_ENDPOINT=https://hf-mirror.com
+# 本机 pypi.org 直连极慢, 重装/更新依赖时走阿里云镜像 (uv sync 用)
+export UV_DEFAULT_INDEX=https://mirrors.aliyun.com/pypi/simple/
+# 接受 https://huggingface.co/stabilityai/stable-audio-3-small-sfx 的许可后,
+# 在 https://huggingface.co/settings/tokens 创建 read 权限 token 填入:
+export HF_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx