dsh-apk-vm 0.12.0 → 0.12.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/cordis.patch.yml CHANGED
@@ -77,6 +77,28 @@
77
77
  # non-loopback clients by default even if the DSH web UI is exposed to
78
78
  # the LAN. Set true only behind your own authenticated reverse proxy.
79
79
  allowRemote: false
80
+ # Remote VM sessions over SSH (opt-in feature): each session forwards a
81
+ # remote emulator's adb port to a loopback port, attaches it as an
82
+ # external device and streams H.264 back through the same SSH tunnel.
83
+ # remoteMaxSessions caps how many remote sessions stay open at once.
84
+ remoteMaxSessions: 4
85
+ # Virtual camera defaults (local VM and new remote sessions).
86
+ # back/front: none | emulated | virtualscene | webcam0..N
87
+ # posters: PNG/JPEG files drawn inside the virtualscene (name=path).
88
+ # camera:
89
+ # back: emulated
90
+ # front: none
91
+ # posters:
92
+ # - name: poster1
93
+ # path: 'D:/media/poster.png'
94
+ # Virtual microphone defaults: off | host | file. Linux/remote hosts
95
+ # use a PulseAudio virtual source; Windows supports host passthrough
96
+ # (or an OBS/VB-Audio virtual device) and cannot loop a file without a
97
+ # system audio driver.
98
+ # mic:
99
+ # mode: off
100
+ # backend: ''
101
+ # filePath: ''
80
102
  # APK discovery roots. The current workspace is always included; add
81
103
  # platform-specific directories here (omit for a portable default).
82
104
  # roots:
package/docs/PRIVACY.md CHANGED
@@ -36,6 +36,10 @@ reporting, advertising or a remote backend.
36
36
  used only to re-install a package that the guest lost (quick-boot reset, recreated AVD, plugin
37
37
  upgrade). Delete the files or set `autoReinstall: false` to opt out.
38
38
 
39
+ - **Media settings** are local: camera modes, poster paths and microphone mode live in
40
+ `<profile>/.apk-vm/media.json`. Remote sessions upload the selected poster/audio file to
41
+ `/tmp/apk-vm-media/<id>` on the remote host over the same SSH connection; nothing else is
42
+ sent.
39
43
  ## Network activity
40
44
 
41
45
  - The plugin talks to the local DSH Web server and local `adb`/emulator processes.
@@ -51,6 +55,13 @@ reporting, advertising or a remote backend.
51
55
  Environment card then offers the manual actions as before). No analytics, telemetry,
52
56
  advertising or remote backend is involved, and no third-party endpoint other than the ones
53
57
  listed above is contacted by the plugin itself.
58
+ - **Remote VM host (opt-in).** If you configure a remote VM in the panel, the plugin opens an SSH
59
+ connection to that host (`BatchMode=yes`, no password prompt) and forwards a loopback port to
60
+ the remote emulator's adb port. Only when you tick "start a headless emulator" does it also run
61
+ a fixed `emulator -avd … -no-window …` command there over the same connection. The SSH key
62
+ path stays on this host and is passed only to the local `ssh` process;
63
+ `<profile>/.apk-vm/remote-profile.json` stores host/user/port/AVD (no key material), and
64
+ nothing is sent anywhere else.
54
65
 
55
66
  ## Public repository hygiene
56
67
 
package/docs/README.md CHANGED
@@ -1,17 +1,26 @@
1
1
  # Demo and screenshot assets
2
2
 
3
- Real assets captured from the reference host:
4
-
5
- - `screenshot-panel.png` — the main APK VM panel: Environment card, Android guest (H.264
6
- 11.7 fps in this capture), input controls and debug surface.
7
- - `screenshot-sidebar.png` — the plugin open in the DSH right sidebar next to a session, with
8
- the host's APK paths redacted.
3
+ Real assets captured from the reference host (0.12.0 panel UI, demo APK only). Private host
4
+ details — the Windows user name, real APK names/paths and the assistant avatar — are masked with
5
+ Gaussian blur:
6
+
7
+ - `screenshot-panel.png` — the main APK VM panel: Environment card, APK files, VM ownership,
8
+ Activity card, rooted debug surface and the live H.264 Android guest with its control bar.
9
+ - `screenshot-activity.png` — the Activity card: agent + user operations, newest first, with action
10
+ badges, source badges (Agent/User/System), durations and screenshot thumbnails.
11
+ - `screenshot-device.png` — the Android 14 guest running the sample APK on the H.264 canvas.
12
+ - `screenshot-environment.png` — the Environment self-check card on a provisioned host (SDK, JDK,
13
+ hardware acceleration, system image, AVD all green).
14
+ - `screenshot-apk-files.png` — the APK files card with remembered installs.
15
+ - `screenshot-debug.png` — the Rooted debug toolbox (adb shell, logs, UI tree, perf, record,
16
+ rotate, clipboard, appops).
9
17
  - `demo.gif` — 28 s loop (720×1280, 3.1 MiB): home screen → sample APK installed and driven
10
18
  through the HTTP API → 60 fps animation in the guest. Reproducible from the guest-side
11
19
  screencap loop in [`../DEMO.md`](../DEMO.md); `scripts/make-demo-gif.mjs` re-encodes it.
12
20
 
13
- The assets are not fabricated. Before adding a new screenshot, crop out or redact the DSH
14
- sidebar conversation names, local paths and any LAN IPs.
21
+ The assets are not fabricated. Before adding a new screenshot, crop out or mask the DSH sidebar
22
+ conversation names, local paths and any LAN IPs (Gaussian blur is enough; the raw panel already
23
+ hides credentials and APK file paths are blur-friendly demo data).
15
24
 
16
25
  ## Reproducible demo source
17
26
 
@@ -26,4 +35,3 @@ sidebar conversation names, local paths and any LAN IPs.
26
35
 
27
36
  The sample screenshot at [`examples/sample-app.png`](../examples/sample-app.png) is the app
28
37
  running in the VM, not a desktop capture.
29
-
@@ -53,7 +53,8 @@ Apache-2.0
53
53
  ### 截图 / 演示
54
54
 
55
55
  - 主面板 + H.264 预览:<https://github.com/yuxiaole-bili/dsh-apk-vm/blob/main/docs/screenshot-panel.png>
56
- - 右侧栏布局:<https://github.com/yuxiaole-bili/dsh-apk-vm/blob/main/docs/screenshot-sidebar.png>
56
+ - Agent/用户活动时间线:<https://github.com/yuxiaole-bili/dsh-apk-vm/blob/main/docs/screenshot-activity.png>
57
+ - 虚拟机内运行示例 APK:<https://github.com/yuxiaole-bili/dsh-apk-vm/blob/main/docs/screenshot-device.png>
57
58
  - 真实 `apk_vm` 输出见 README 的 Demo/Verification 章节。
58
59
 
59
60
  ### 补充说明
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
package/icon.svg CHANGED
@@ -1,8 +1,19 @@
1
- <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" role="img" aria-label="APK virtual machine">
2
- <rect x="6.25" y="2.25" width="11.5" height="19.5" rx="2.75"/>
3
- <path d="M10.25 4.9h3.5"/>
4
- <circle cx="9.9" cy="9.8" r="0.85" fill="currentColor" stroke="none"/>
5
- <circle cx="14.1" cy="9.8" r="0.85" fill="currentColor" stroke="none"/>
6
- <path d="M9.6 13.1c.55.9 1.4 1.35 2.4 1.35s1.85-.45 2.4-1.35"/>
7
- <path d="M9.4 19.2h5.2"/>
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="36" height="36" viewBox="0 0 36 36" fill="none">
2
+ <defs>
3
+ <linearGradient id="back" x1="7" y1="3" x2="31" y2="31" gradientUnits="userSpaceOnUse">
4
+ <stop stop-color="#A98BFF"/>
5
+ <stop offset="1" stop-color="#5432C9"/>
6
+ </linearGradient>
7
+ <linearGradient id="front" x1="12" y1="6" x2="32" y2="32" gradientUnits="userSpaceOnUse">
8
+ <stop stop-color="#F8FA82"/>
9
+ <stop offset="1" stop-color="#7ED957"/>
10
+ </linearGradient>
11
+ </defs>
12
+ <rect x="7.6" y="4.0" width="21.6" height="26.4" rx="4.8" fill="url(#back)" transform="rotate(-12 18.4 17.2)"/>
13
+ <rect x="12.2" y="6.9" width="19.2" height="24.2" rx="4.2" fill="url(#front)" stroke="#2A1E58" stroke-opacity="0.16" stroke-width="0.8"/>
14
+ <rect x="20.2" y="8.4" width="3.2" height="1.1" rx="0.55" fill="#4A2CB8" opacity="0.55"/>
15
+ <circle cx="18.6" cy="17.8" r="1.55" fill="#3A2384"/>
16
+ <circle cx="25.2" cy="17.8" r="1.55" fill="#3A2384"/>
17
+ <path d="M18.4 21.9c.9 1.5 2.2 2.2 3.5 2.2 1.3 0 2.6-.7 3.5-2.2" stroke="#3A2384" stroke-width="1.7" stroke-linecap="round" fill="none"/>
18
+ <rect x="17.6" y="26.2" width="8.4" height="1.2" rx="0.6" fill="#4A2CB8" opacity="0.35"/>
8
19
  </svg>