初始提交：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/android.md

@@ -0,0 +1,69 @@
+# SoundGame — Android 开发环境使用说明
+
+全部软件安装在用户目录，无需 sudo。`source` 环境变量文件后即可使用：
+
+```bash
+source /home/ubuntu/SoundGame/env.d/android.sh
+```
+
+## 已安装组件
+
+| 组件 | 版本 | 位置 |
+|---|---|---|
+| JDK (OpenJDK) | 17.0.2 | `tools/jdk17` |
+| Android cmdline-tools | latest (15859902) | `tools/android-sdk/cmdline-tools/latest` |
+| platform-tools (adb) | 37.0.1 | `tools/android-sdk/platform-tools` |
+| Android SDK Platform | android-36 | `tools/android-sdk/platforms/android-36` |
+| build-tools | 36.0.0 | `tools/android-sdk/build-tools/36.0.0` |
+| ffmpeg / ffprobe（静态） | N-126303 (2026-08-27) | `tools/bin/` |
+
+## 常用命令
+
+```bash
+adb devices                          # 查看已连接设备
+sdkmanager --list_installed          # 查看已安装 SDK 组件
+sdkmanager "platforms;android-36"    # 安装其他组件
+ffmpeg -i in.mp3 -c:a aac out.m4a    # 音频转码
+```
+
+Gradle 项目可在 `local.properties` 中写：
+```
+sdk.dir=/home/ubuntu/SoundGame/tools/android-sdk
+```
+
+## 真机调试（WSL2 无法直接访问 USB，推荐以下两种方式）
+
+### 方式一：无线调试（推荐，Android 11+）
+
+手机和电脑连同一 Wi-Fi。手机上：开发者选项 → 无线调试。
+
+```bash
+# 1. 配对（手机“无线调试”→“使用配对码配对”，会显示 IP:端口 和 6 位配对码）
+adb pair 192.168.x.x:37027
+# 输入配对码
+
+# 2. 连接（用无线调试首页显示的 IP:端口，注意与配对端口不同）
+adb connect 192.168.x.x:43215
+
+# 3. 验证
+adb devices
+```
+
+Android 10 及以下可先在有 root/电脑的机器上执行 `adb tcpip 5555`，再 `adb connect <手机IP>:5555`。
+
+### 方式二：Windows 侧 adb server（备选）
+
+WSL2 默认看不到 USB 设备。可让 adb server 跑在 Windows 侧：
+
+1. Windows 安装 platform-tools，手机开 USB 调试并连上 Windows，确认 Windows 的 `adb devices` 能看到手机。
+2. Windows 上执行：`adb -a -P 5037 nodaemon server`（监听所有网卡）。
+3. WSL2 中获取 Windows 主机 IP（`ip route show | awk '/default/ {print $3}'`），然后：
+   ```bash
+   export ADB_SERVER_SOCKET=tcp:<Windows主机IP>:5037
+   adb devices   # 现在走的是 Windows 的 server
+   ```
+
+## 备注
+
+- JDK 实际用的是华为云镜像的 Oracle OpenJDK 17.0.2（Adoptium 官方源在本机过慢），对 Gradle/Android 构建完全够用。
+- 未修改 `~/.bashrc`；每次新开 shell 需重新 `source env.d/android.sh`。