# 模拟器启动注意事项（2026-08-23 更新至 v2）

## 当前环境（最终状态）

| 实例 | 镜像 | 状态 | 用途 |
|---|---|---|---|
| **DSH_MB6** | HarmonyOS 6.0.0.48 (API 20) Release | ✅ 在用，hdc 127.0.0.1:5555 | **主验证环境**——正好匹配 compatibleSdkVersion 6.0.0(20) 下限验证 |
| MateBook Pro | 指向已不存在的 7.0.0-B1 镜像 | ⚠️ 失效实例（勿启动；如需复用可重指向 6.0.0） | — |
| Mate X7 / MatePad Pro 13 / Pura 90 Pro | 未验证 | 未使用 | — |

## 已验证结论

1. **镜像下载**：Device Manager GUI 触发 `emulator -install` 下载+解压（6.0.0 约 7.5GB，~10MB/s 下 25 分钟）；首次解压可能被判不完整自动重来，等 info.json 有内容才算完成
2. **实例创建**：`Emulator -create` 在 GUI 已登录环境下会挂起（等交互），不要用 CLI 建——在 Device Manager GUI 里建（DSH_MB6 即此法）
3. **启动**：GUI Device Manager 启动成功后，hdc 层一切操作（install/launch/screenshot/ui_dump）AI 全接管可用
4. **完整闭环已验证（2026-08-23 20:0x）**：MCP install 签名 HAP → launch → app_state 前台确认 com.dotouch.dshharmony ✅

## 命令坑记录（勿重复踩）

- `yes | cmd &` 后台管道会挂住 bash 会话（stdin 持有）→ 用 `nohup bash -c "..." &` 完全脱离
- `Emulator -license accept` 不能持久化全部 4 份协议（SDK Agreement 始终 disagree），勿再走此路
- macOS 无 `timeout` 命令；`-create` 交互挂起用 pkill 清理
- 模拟器重启需用户从 Device Manager 操作（账号鉴权），运行期间无需再动