dsh-apk-vm 0.6.1 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,71 @@
 # Changelog
 
+## 0.8.0
+
+Sidebar workspace, APK debugging, network and regression tools.
+
+### Added
+
+- **Collapsible tools aside**, **expand/full-window**, **in-app floating VM window**, remembered
+  expand state, double-click expand, keyboard `Esc` restore and a dedicated close button.
+- **Multi-instance grid** with frame thumbnails and one-click instance switching.
+- **Stream quality presets** (540p/30, 720p/60, 960p/60) that restart only the scrcpy session,
+  a quick rotate control, first-boot hint, and stale-client/version warning.
+- **One-click environment setup** for SDK tools, system image and AVD creation with explicit
+  download confirmation; single-step setup actions remain available.
+- **APK quick actions**: launch installed app, validated deep links, grant/revoke permissions,
+  plus existing stop/clear-data/uninstall. `.aab` uploads convert through bundletool when available.
+- **Named VM snapshots**: save, restore and delete per-AVD snapshots.
+- **Passive clipboard**: explicit “copy device clipboard to host” and “paste host clipboard to
+  device” actions; no polling, listeners or background sync.
+- **HAR network panel**: load a HAR exported by an external proxy/DevTools, summarize status
+  classes/bytes/domains and inspect up to 500 requests with bounded fields.
+- **UI check/visual baseline**: run UIAutomator assertions and SHA-256 screenshot baselines,
+  return a JSON/Markdown report, and copy a `curl` for HAR entries.
+- **Remote adb host:port input** for attached network devices.
+
+### Notes
+
+- AAB conversion requires `bundletool` (executable, `BUNDLETOOL_JAR`, or a jar in the repo/tools dir).
+- Visual regression is exact-byte baseline comparison; it does not ship a pixel-diff image library.
+- Clipboard remains passive by design; there is no automatic sync.
+
+## 0.7.0
+
+Sidebar usability and streaming controls.
+
+### Added
+
+- **Expand / restore button** in the VM panel header. It turns the panel into a
+  full-window overlay so a narrow `dsh-better-sidebar` tab can show a large phone screen;
+  press Escape or click the button again to restore the sidebar layout. The last state is
+  remembered, double-clicking the phone toggles it, and the overlay has a dedicated close button.
+- **Collapsible tools aside** in the embedded sidebar: APK/debug cards are hidden by default
+  so the phone gets the available height; a Tools button reveals them.
+- **Stream quality presets** — Low 540p/30, Balanced 720p/60, High 960p/60. Changing the
+  preset restarts only the scrcpy session and lets the panel reconnect.
+- Quick **rotate** and **first-boot hint** in the stage controls.
+- **Version and stale-UI warning** — the header shows the client version, and a
+  client/host version mismatch offers a Reload UI action.
+- **APK quick actions** — launch an installed app, open a validated deep link, grant/revoke a
+  permission, plus the existing stop/clear/uninstall controls.
+- **One-click environment setup** — an explicit button chains SDK tools, system image,
+  AVD creation and VM start; the click confirms downloads even when global auto-download is off.
+- **Passive clipboard** — host clipboard is read/written only when the user clicks
+  “paste host clipboard” or “copy device clipboard”. No polling or background sync.
+
+## 0.6.2
+
+Sidebar usability.
+
+### Added
+
+- **Expand / restore button** in the VM panel header. It turns the panel into a
+  full-window overlay so a narrow `dsh-better-sidebar` tab can show a large phone screen;
+  press Escape or click the button again to restore the sidebar layout.
+- The overlay hides the APK/debug aside, keeps the H.264 stream and input controls, and
+  reuses the existing canvas/WebSocket session (no second stream).
+
 ## 0.6.1
 
 Network panel completeness.

package/README.md

@@ -8,6 +8,27 @@
 
 **Run a real Android APK inside a local, rooted, open-source Android VM and preview it in the DeepSeek Harness sidebar — streamed as H.264/WebCodecs video at up to 60 fps.**
 
+<p align="center">
+  <a href="docs/screenshot-panel.png">
+    <img src="docs/screenshot-panel.png" alt="APK Virtual Machine panel with a live H.264 Android screen in DeepSeek Harness" width="820">
+  </a>
+</p>
+<p align="center"><sub>Real panel capture: rooted Android 14 guest, live H.264 stream, input controls and installed-app tools — no mockup.</sub></p>
+<p align="center">
+  <code>dsh plugin --profile web add dsh-apk-vm</code>
+  &nbsp;·&nbsp;
+  <a href="examples/README.md">reproducible demo</a>
+</p>
+
+**Why it is useful**
+
+- **Sidebar-first Android** — install and use an APK without opening a separate emulator window.
+- **Real, low-latency stream** — H.264/WebCodecs up to 60 fps with tap, swipe, key and text input.
+- **Agent-native** — `apk_vm` tools, a live UI Inspector, copy-ready selectors and record/replay flows.
+- **Local and inspectable** — open-source AOSP emulator, rooted debug API, network/storage controls, no telemetry.
+- **Expandable viewer** — turn the narrow sidebar panel into a full-window VM with one click; Escape restores it.
+- **Large-screen controls** — collapsible tools, quality presets (540p/30 → 960p/60), double-click expand, quick rotate, and a stale-UI/version warning.
+
 This repository contains the static DSH plugin `dsh-apk-vm`. It adds a first-class sidebar
 entry ("APK Virtual Machine" / "APK 虚拟机") whose main panel boots an AOSP Android Emulator,
 installs an APK into the guest, streams the guest display into the panel, and forwards
@@ -24,7 +45,7 @@ same-origin, loopback-only debug HTTP API and an `apk_vm` Agent tool.
 > 当前 **Windows x64 与 Linux x86_64（headless）为端到端已验证平台**；macOS 仅做探测/CI
 > 覆盖，详见 `docs/LINUX-E2E.md`。
 
-**Status:** `0.6.1` · Apache-2.0 · no npm runtime dependencies · no build step.
+**Status:** `0.8.0` · Apache-2.0 · no npm runtime dependencies · no build step.
 
 This is an open-source DSH plugin published on npm as **`dsh-apk-vm`**. Repository:
 [github.com/yuxiaole-bili/dsh-apk-vm](https://github.com/yuxiaole-bili/dsh-apk-vm).
@@ -581,12 +602,16 @@ JSON bodies are bounded to 64 KiB; the raw APK upload is bounded to 500 MiB.
 | POST | `/apk-vm/device` | `{"serial":"<adb-serial>"}` attach an online physical/network device; `{"serial":""}` detach and restore the managed AVD. |
 | POST | `/apk-vm/vm` | `{"action":"start"\|"stop"\|"restart"\|"snapshot"}`. |
 | POST | `/apk-vm/install` | `{"path":"C:/path/app.apk"}` → install + launch. |
-| POST | `/apk-vm/upload` | Raw APK bytes (≤ 500 MiB) with the file name in the `x-apk-name` header → validate ZIP/APK magic, write to the OS temp dir, install + launch. |
+| POST | `/apk-vm/upload` | Raw APK/APKS/XAPK/AAB bytes (≤ 500 MiB) with the file name in the `x-apk-name` header → validate ZIP/APK magic, write to the OS temp dir, install + launch. |
 | GET | `/apk-vm/frame?t=…` | Latest PNG frame (`409` while the VM is not ready). |
 | POST | `/apk-vm/input` | `tap` / `swipe` / `key` / `text` payloads. |
 | POST | `/apk-vm/touch` | Multi-touch scrcpy control (`{"action":"down\|move\|up\|cancel","pointerId":0,"x":…,"y":…}` in video-frame coordinates) for pinch/zoom. |
-| GET/POST | `/apk-vm/clipboard` | Read the device clipboard (`GET`, scrcpy `GET_CLIPBOARD`) or write text (`POST {"text":…}`). |
+| GET/POST | `/apk-vm/clipboard` | Read the device clipboard (`GET`, scrcpy `GET_CLIPBOARD`) or write text (`POST {"text":…}`). Explicit calls only; no background clipboard sync. |
+| GET/POST | `/apk-vm/snapshots` | List named AVD snapshots; `POST {"action":"save\|load\|delete","name":…}`. |
+| POST | `/apk-vm/ui-test` | `{"name":…,"assertions":[…],"updateBaseline":false}` — UIAutomator assertions + exact-byte screenshot baseline; returns JSON and Markdown. |
+| POST | `/apk-vm/network/har` | `{"path":"…har","method"?,"status"?,"domain"?,"search"?}` — load an external proxy HAR, summarize/filter and include bounded entries + curl. |
 | POST | `/apk-vm/stream` | `{"fps":1–10}` — set the PNG fallback target frame rate. |
+| POST | `/apk-vm/stream/quality` | `{"preset":"low\|balanced\|high"}` — change H.264 resolution/bitrate/fps; the scrcpy session reconnects. |
 | GET (upgrade) | `/apk-vm/ws` | WebSocket H.264 stream (see above). |
 | GET | `/apk-vm/instances` | List default + extra VM instances, including `owner`, `lastUsedAt`, `idleMs`, `idleTimeoutMs`, `videoClients`. |
 | POST | `/apk-vm/instances` | `{"name":"agent-a","start":true}` — create an isolated AVD/VM; every extra instance has its own H.264 stream. |