dsh-apk-vm：在 DeepSeek Harness 侧边栏里运行安卓虚拟机的 DSH plugin

它是做什么的？

APK Virtual Machine 是 DeepSeek Harness（DSH）的 Android 虚拟机插件，把本地开源 AOSP 安卓虚拟机搬进侧边栏。它解决 APK 预览与调试需要切换模拟器窗口、手动装包、无法让 Agent 直接操作设备的问题。插件启动 Android 14（API 34）的 userdebug 镜像并默认 root，安装 APK 后以 H.264/WebCodecs 把画面串流到面板（最高 60 fps），同时把点击、滑动、按键、文本输入回送到虚拟机，并对外提供 root 调试 API 与 apk_vm Agent 工具。项目由 yuxiaole-bili 维护，采用 Apache-2.0 协议，无 npm 运行时依赖、无构建步骤。

核心功能

• 侧边栏实时预览：在 DSH 面板内串流安卓画面，最高 60 fps，参考机冷启动约 29.5 秒、快照启动约 8.4–10.5 秒。
• 拖拽安装 APK：把安装包拖进面板即可装入虚拟机，并支持应用安装、卸载与启动。
• 输入回送：面板内的点击、滑动、按键与文本输入直接注入虚拟机，操作体验接近真机。
• root 调试能力：guest 为 userdebug 镜像，每次启动执行 adb root，向 Agent 暴露 root shell 与 UIAutomator 自动化接口。
• 多 Agent 隔离：每个 Agent 可使用独立的虚拟机实例，默认最多额外开启 3 台，每台约占 2.5 GB 内存。
• 环境自检：Environment 卡片检查 Android SDK、adb、emulator、系统镜像与 AVD 是否齐备，SDK 初始化需手动开启。

怎么使用这个插件？

在 DSH 中启用后，侧边栏会出现「APK Virtual Machine / APK 虚拟机」入口，打开主面板即可启动虚拟机。首次使用先看环境自检卡片，确认 SDK、模拟器、系统镜像与 AVD 就绪，并确保已开启硬件虚拟化（Windows 用 AEHD/WHPX、Linux 用 KVM、macOS 用 HVF）。随后把 APK 拖入面板完成安装，在画面里直接点按操作；需要自动化时，让 Agent 调用 apk_vm 工具执行安装、UIAutomator 与输入注入。调试 HTTP 路由与 WebSocket 默认仅限本机回环访问，如需经可信代理远程使用，需显式开启 allowRemote。当前 Windows x64 是端到端验证平台，macOS/Linux 仅有探测与 CI 覆盖。

报错怎么排查？

虚拟机起不来时，先看环境自检卡片：缺 adb、emulator、sdkmanager/avdmanager、系统镜像或 AVD 都会导致启动失败，按官方说明补齐对应组件。启动报虚拟化错误，说明宿主未启用 AEHD/WHPX、KVM 或 HVF，需在系统层面开启硬件虚拟化。面板黑屏或串流中断，多为 H.264/WebCodecs 解码或回环连接问题，按官方说明检查浏览器解码支持与本地端口占用。内存不足导致多开失败时，减少同时运行的实例数量。