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/CHANGELOG.md +64 -4
- package/DEMO.md +9 -6
- package/README.md +71 -13
- package/SECURITY.md +19 -2
- package/client.js +740 -16
- package/cordis.patch.yml +22 -0
- package/docs/PRIVACY.md +11 -0
- package/docs/README.md +17 -9
- package/docs/SUBMISSION.md +2 -1
- package/docs/screenshot-activity.png +0 -0
- package/docs/screenshot-apk-files.png +0 -0
- package/docs/screenshot-debug.png +0 -0
- package/docs/screenshot-device.png +0 -0
- package/docs/screenshot-environment.png +0 -0
- package/docs/screenshot-panel.png +0 -0
- package/icon.svg +18 -7
- package/index.js +505 -44
- package/lib/android.js +48 -1
- package/lib/emulator-inventory.js +1526 -0
- package/lib/instances.js +97 -1
- package/lib/media.js +820 -0
- package/lib/remote-instance.js +608 -0
- package/lib/remote.js +1180 -0
- package/package.json +20 -4
- package/scripts/check-version.mjs +30 -0
- package/docs/screenshot-sidebar.png +0 -0
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
|
-
|
|
6
|
-
|
|
7
|
-
- `screenshot-
|
|
8
|
-
the
|
|
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
|
|
14
|
-
|
|
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
|
-
|
package/docs/SUBMISSION.md
CHANGED
|
@@ -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
|
-
-
|
|
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="
|
|
2
|
-
<
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
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>
|