dsh-apk-vm 0.4.1 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## 0.6.0
+
+Network controls.
+
+### Added
+
+- Port forwarding management (`forward-add` / `forward-remove`) over adb, with a host-port →
+  guest-port list and optional `shared` rules.
+- Custom DNS servers via the emulator `-dns-server` launch flag (restart required) and guest
+  `/etc/hosts` injection through a root bind mount, reapplied after boot.
+- Proxy connectivity test from inside the guest (`ping` + toybox `nc`), and current proxy
+  display in the Network card.
+- Per-instance network mode:
+  - `isolated` (default QEMU-NAT isolation)
+  - `shared` (host-mediated TCP sharing through shared port forwards)
+- Optional emulator pcap capture (`-tcpdump`) with `GET /apk-vm/network/pcap` download.
+- Network card UI for forwards, DNS, hosts, mode, test, and pcap; `apk_vm` action `network`.
+- Per-instance network route: `/apk-vm/instances/<id>/network`.
+
+### Notes
+
+- Shared mode is host-mediated TCP sharing, not L2 bridging; instances keep their own QEMU NAT.
+- DNS changes take effect on the next emulator start; hosts changes apply live and survive a
+  restart while the plugin keeps the configured entries.
+- pcap export is opt-in and only writes traffic from the emulator's user-mode network.
+
+## 0.5.0
+
+Storage management.
+
+### Added
+
+- Storage panel: AVD / snapshot / SDK / plugin temp / free-disk footprint, with guarded
+  cleanup actions (two-click confirmation for destructive actions).
+- `GET /apk-vm/storage` and `POST /apk-vm/storage` (`temp`, `snapshots`, `orphan-avds`).
+- `apk_vm` actions `storage` and `clean_storage`.
+- `lib/storage.js` with dependency-free size accounting and cleanup helpers; unit coverage for
+  temp cleanup, orphan AVD detection and snapshot-aware accounting.
+
+### Notes
+
+- Snapshot cleanup only targets a stopped plugin-managed AVD; the active VM is never deleted.
+- Orphan cleanup only matches `dsh_apk_*` AVDs that are not registered to an instance.
+
 ## 0.4.1
 
 Privacy cleanup for the published proof assets.

package/README.md

@@ -24,7 +24,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.4.1` · Apache-2.0 · no npm runtime dependencies · no build step.
+**Status:** `0.6.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).
@@ -170,10 +170,15 @@ key {"text":"HOME"}       -> returned to launcher
   then save the tap / swipe / key / text sequence as a JSON flow under the OS temp directory.
   Flows can be listed, replayed with their original relative timing, downloaded or deleted.
   Agents get `flow_start`, `flow_stop`, `flow_list` and `flow_replay`.
-- **Network debugging: proxy + CA.** The Network card sets/clears the guest global HTTP proxy
-  (`settings put global http_proxy`) and installs a local `.pem`/`.crt` CA into the rooted
-  Android user CA store with the correct OpenSSL subject-hash filename; the system CA store is
-  updated when the guest allows a remount.
+- **Network debugging and port forwarding.** The Network card manages host→guest port
+  forwards, custom DNS (next emulator start), guest `/etc/hosts` via a root bind mount,
+  HTTP proxy + CA installation, isolated/shared instance modes, and a guest-side connectivity
+  test. Optional pcap capture can be downloaded from the panel. See
+  [Network controls](#network-controls).
+- **Storage panel + guarded cleanup.** A Storage card reports the AVD, snapshot, SDK, temp-file
+  and free-disk footprint and offers explicit cleanups: plugin temp files, quick-boot
+  snapshots for a stopped AVD, and orphan `dsh_apk_*` AVDs. Destructive actions need a second
+  click and never touch the active VM.
 - **Installed-app management.** The panel's **Installed apps** card lists third-party packages
   for the active instance and offers force-stop, clear-data and uninstall; it uses the same
   rooted `debug/packages` + `debug/action` API as the Agent tool.
@@ -237,7 +242,52 @@ key {"text":"HOME"}       -> returned to launcher
 - `POST /apk-vm/debug/ca` accepts a host `.pem`/`.crt` path and installs it under the guest's
   user CA directory with the correct subject hash.
 
-## Reproducible demo
+## Storage management
+
+`GET /apk-vm/storage` reports the logical size of every AVD, its quick-boot snapshots, the
+Android SDK, plugin temp files and the free space on the AVD volume. The panel's **Storage**
+card uses the same endpoint.
+
+`POST /apk-vm/storage` accepts:
+
+```json
+{ "action": "temp" }
+{ "action": "snapshots", "avdName": "dsh_apk", "confirm": true }
+{ "action": "orphan-avds", "confirm": true }
+```
+
+- `temp` removes only screenshots, MP4 recordings, uploaded APKs and flow JSON created by this
+  plugin.
+- `snapshots` deletes the quick-boot snapshots of a **stopped** plugin-managed AVD; the next
+  boot is a cold boot.
+- `orphan-avds` removes only `dsh_apk_*` AVDs that are not registered to any instance and are
+  not active.
+- `apk_vm` tool actions: `storage`, `clean_storage` (`storageAction`, `avdName`, `confirm`).
+
+## Network controls
+
+`GET /apk-vm/network` returns the guest addresses, current proxy, DNS, hosts count, mode,
+port forwards and pcap status. `POST /apk-vm/network` accepts `action`:
+
+```json
+{ "action": "mode", "mode": "isolated|shared" }
+{ "action": "forward-add", "localPort": 18080, "remotePort": 8080, "shared": false }
+{ "action": "forward-remove", "localPort": 18080 }
+{ "action": "dns", "servers": ["1.1.1.1"] }
+{ "action": "hosts", "entries": ["198.51.100.10 api.example.test"] }
+{ "action": "test", "host": "198.51.100.10", "port": 8080 }
+{ "action": "pcap", "path": "D:\\apk-vm-capture.pcap" }
+```
+
+- Port forwards use `adb forward tcp:<hostPort> tcp:<guestPort>`.
+- DNS is applied by the emulator `-dns-server` flag on the next start.
+- Hosts entries are bind-mounted over the guest `/etc/hosts` (root required) and reapplied
+  after a plugin-managed boot.
+- `shared` forwards are reachable from other VMs through the emulator's host alias; the
+  QEMU NAT itself remains isolated.
+- pcap capture is passed to the emulator as `-tcpdump` and starts on the next emulator start;
+  download via `GET /apk-vm/network/pcap`.
+
 
 A public, dependency-free demo lives in [examples](examples/README.md):