@ponydev/dsh-phone 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.4.1 — 2026-10-26
+
+### 修复
+- 鸿蒙模拟器名称规则与 CLI 对齐：只允许字母、数字、空格、下划线 `_`、加号 `+`（之前允许连字符/中文，`-create` 会直接失败）；创建表单占位符改为 `dsh_phone_hos`
+- 鸿蒙模拟器 `start` 改为 detached 启动 + 截图 warm-up：`Emulator -start` 是常驻进程，之前前台等待导致 90s 超时；现在启动后等显示服务就绪再返回
+
+### 验证（0.4.1 发布前实测）
+- iOS 模拟器：create → boot → 截图 → H.264 流（idb，100 帧/3s）→ tap / Home 通过；像素→point（density=3）用真实弹窗按钮验证
+- HarmonyOS 模拟器：create → start（45s 含 warm-up）→ 截图 → tap / swipe → stop → delete 全链路通过
+- HarmonyOS 真机（Mate 60 Pro）：截图 / keyEvent / tap / text 通过
+
 ## 0.4.0 — 2026-10-26
 
 ### 新增

package/README.md

@@ -120,9 +120,19 @@ DSH 右侧栏第一次打开是**视口宽度的 45%**（1440 屏 ≈ 648px）
 | HarmonyOS 真机 | hdc | 截图轮询 1–2fps | tap / swipe / 按键 / 文字 | — |
 
 - iOS 依赖 macOS + Xcode；实时画面/输入需要 `idb`（`brew install facebook/fb/idb-companion` + `pip install fb-idb`），未装时只读预览。
+  - 如果 Homebrew 报 "Xcode alone is not sufficient on Tahoe"（需要 Command Line Tools），可改用官方 release 手工安装：
+    `gh release download v1.7.7 --repo facebook/idb --pattern 'idb-companion.macos-arm64.tar.gz'`，解压到 `~/.local/lib/idb-companion`，
+    再把 `idb_companion` / `idb-repl` 软链到 `~/.local/bin`；客户端 `python3 -m venv ~/.local/venvs/fb-idb && ~/.local/venvs/fb-idb/bin/pip install fb-idb`。
 - HarmonyOS 依赖 DevEco Studio（`Emulator` CLI）与 `hdc`；hdc 没有 screenrecord，只能截图轮询。
 - 物理 iPhone / iPad 不支持（Apple 未公开投屏/注入 API，Claude Code Desktop 也只支持模拟器）。
 
+## 验证状态
+
+- **iOS 模拟器**（iPhone Air / iOS 26.5）：create / boot / 截图 / idb H.264 流 / tap / Home 实测通过；像素→point 坐标换算用真实弹窗验证。
+- **HarmonyOS 模拟器**（HarmonyOS 7.0.0）：create / start / 截图 / tap / swipe / rotate / stop / delete 全链路实测通过。
+- **HarmonyOS 真机**（Mate 60 Pro，hdc）：截图 / keyEvent / tap / text 实测通过。
+- **Android**：真机与云手机的 tap / swipe / back / home / 截图 / H.264 流实测通过。
+
 ## 已知限制
 
 - Android 画面默认走 H.264 流（约 20–30fps）；没有 WebCodecs 的浏览器会回退到 1–2fps 轮询截图。

package/lib/client.js

@@ -1848,7 +1848,7 @@ window.__ModuleLoader__.load({
               h('input', {
                 className: 'dph-input',
                 value: hosForm.name,
-                placeholder: 'dsh-phone-hos',
+                placeholder: 'dsh_phone_hos',
                 onChange: (event) => setHosForm((prev) => ({ ...prev, name: event.target.value })),
                 spellCheck: false,
               }),

package/lib/hos.js

@@ -8,7 +8,7 @@
 //                    按键和文字没有 CLI 能力，内部转给 hdc uitest。
 //   HarmonyHdc       真机 / 云手机：hdc list targets，截图走 snapshot_display + file recv（JPEG），
 //                    输入走 uitest uiInput。默认从列表里过滤 model=emulator 的本地模拟器。
-import { execFile } from 'node:child_process'
+import { execFile, spawn } from 'node:child_process'
 import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync } from 'node:fs'
 import { homedir, tmpdir } from 'node:os'
 import { join } from 'node:path'
@@ -16,7 +16,7 @@ import { join } from 'node:path'
 /** hdc serial 白名单：字母数字开头，允许 . _ : -，最长 128 */
 export const HDC_SERIAL_RE = /^[A-Za-z0-9][A-Za-z0-9._:\-]{0,127}$/
 /** 模拟器实例名：字母/数字/中文开头，允许空格 . _ -，最长 64；不允许路径分隔符 */
-export const EMULATOR_NAME_RE = /^[A-Za-z0-9\u4e00-\u9fa5][A-Za-z0-9\u4e00-\u9fa5 ._\-]{0,63}$/
+export const EMULATOR_NAME_RE = /^[A-Za-z0-9_+][A-Za-z0-9 _+]{0,63}$/
 /**
  * uitest 文字白名单：字母、数字、空格和少量安全标点。
  * hdc shell 最终会经过设备 shell，`$` `;` `` ` `` `|` `&` 引号等一律不收。
@@ -449,7 +449,7 @@ export function normalizeDeviceType(value) {
 export function normalizeEmulatorName(value) {
   const name = text(value)
   if (!EMULATOR_NAME_RE.test(name)) {
-    throw fail('bad-emulator-name', '模拟器名称不合法（字母/数字/中文开头，允许空格 . _ -，最长 64）')
+    throw fail('bad-emulator-name', '模拟器名称不合法：只能用字母、数字、空格、下划线 _、加号 +（最长 64，CLI 不允许中文和连字符）')
   }
   return name
 }
@@ -973,12 +973,27 @@ export class HarmonyEmulator {
     const instance = normalizeEmulatorName(name)
     const existing = await this.find(instance)
     if (existing.state === 'device') return existing
-    await this._run(['-start', instance], { timeout: this.startTimeout })
-    const started = await this._poll(instance, (device) => device.state === 'device', this.startTimeout)
-    if (!started) {
-      throw fail('start-timeout', `模拟器 ${instance} 在 ${Math.round(this.startTimeout / 1000)}s 内没有启动完成`)
+    // Emulator -start 是常驻进程（前台阻塞直到模拟器退出），必须 detached 启动再轮询状态。
+    // 状态变成 device 之后显示服务还需要一点时间，所以用一次真实截图做 warm-up。
+    await this.resolve()
+    const child = spawn(this.bin, ['-start', instance, '-noWindow'], { detached: true, stdio: 'ignore' })
+    child.unref()
+    const deadline = Date.now() + this.startTimeout
+    while (Date.now() < deadline) {
+      const list = await this.list()
+      const device = list.find((item) => item.serial === instance)
+      if (device && device.state === 'device') {
+        try {
+          await this.shot(instance)
+          return device
+        } catch {
+          await sleep(2000)
+          continue
+        }
+      }
+      await sleep(1000)
     }
-    return started
+    throw fail('start-timeout', `模拟器 ${instance} 在 ${Math.round(this.startTimeout / 1000)}s 内没有启动完成`)
   }
 
   /** 停止并等到 isRunning=false。已经停止就直接返回。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ponydev/dsh-phone",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "DSH Web 插件：右侧栏预览并控制 Android / iOS 模拟器 / HarmonyOS 设备与模拟器",
   "keywords": [
     "dsh",