offscreen-android 0.0.0-stage → 0.1.1

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.
@@ -0,0 +1,398 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * vdisplayd —— 虚拟屏守护进程。
4
+ *
5
+ * 为什么必须有它:虚拟屏跟"建它的那个进程"同生共死(scrcpy server 一断,
6
+ * DisplayManager 就把屏销毁)。CLI 每次调用都是新进程,进程一退屏就没了,
7
+ * 所以 `vdisplay shot` 这种一次性命令根本没法工作。
8
+ *
9
+ * 做法:常驻一个进程,把屏握在手里,CLI 通过回环 HTTP 发命令进来。
10
+ * 这套东西不依赖 DSH,任何 agent(Claude Code / opencode / Codex)用 bash
11
+ * 调 CLI 就能用。
12
+ *
13
+ * 发现机制:把 {pid, port} 写到 $DSH_HOME/plugin-screen/cli-daemon.json,
14
+ * CLI 读这个文件找到守护进程。
15
+ */
16
+
17
+
18
+ import('./../src/stream.js').then(m => m.reconcileStreamState()).catch(() => {});
19
+ import { createServer } from 'node:http';
20
+ import { readFile, writeFile, mkdir, unlink, rename } from 'node:fs/promises';
21
+ import { homedir } from 'node:os';
22
+ import { join } from 'node:path';
23
+
24
+ import * as vd from '../src/vd.js';
25
+
26
+ const DSH_HOME = process.env.DSH_HOME || join(homedir(), '.dsh');
27
+ const STATE_DIR = join(DSH_HOME, 'plugin-screen');
28
+ const STATE_FILE = join(STATE_DIR, 'cli-daemon.json');
29
+
30
+ // 没屏、也没人调命令时,闲置这么久就自己退掉,不留垃圾进程
31
+ const IDLE_EXIT_MS = 10 * 60 * 1000;
32
+
33
+ let lastActive = Date.now();
34
+ let server = null;
35
+
36
+ async function writeState(port) {
37
+ await mkdir(STATE_DIR, { recursive: true });
38
+ // 原子写:先写临时文件再 rename。直接 writeFile 会留一个"读得到半截 JSON"的窗口,
39
+ // CLI 那边解析失败会当成"没守护进程"而再拉一个 —— 冷启动并发时会雪崩。
40
+ const tmp = `${STATE_FILE}.${process.pid}.tmp`;
41
+ await writeFile(tmp, JSON.stringify({ pid: process.pid, port, startedAt: Date.now() }, null, 2));
42
+ await rename(tmp, STATE_FILE);
43
+ }
44
+
45
+ /**
46
+ * 清状态文件。**只删自己写的那一份**。
47
+ *
48
+ * 不加这个校验的话,两个实例并存时(冷启动竞态真的会发生),
49
+ * 先退出的那个会把另一个的 state 删掉,对方就变成"活着但隐身"的幽灵进程。
50
+ */
51
+ async function clearState() {
52
+ try {
53
+ const cur = JSON.parse(await readFile(STATE_FILE, 'utf8'));
54
+ if (cur?.pid && cur.pid !== process.pid) return; // 不是自己的,别动
55
+ } catch { /* 文件不存在或读不了,那就删 */ }
56
+ try { await unlink(STATE_FILE); } catch { /* 没有就算了 */ }
57
+ }
58
+
59
+ /** 命令分发。每个 action 都是 vd.js 里的一个函数。 */
60
+ let mutexTail = Promise.resolve(); // 全局互斥链,串行化有副作用的命令
61
+
62
+ const ACTIONS = {
63
+ async start(args) {
64
+ const r = await vd.start({
65
+ width: Number(args?.width) || 0, // 0 = 自动按物理屏比例
66
+ height: Number(args?.height) || 0,
67
+ dpi: Number(args?.dpi) || 320,
68
+ systemDecorations: args?.systemDecorations === true,
69
+ orientation: args?.orientation,
70
+ hwc: args?.hwc || 'auto',
71
+ });
72
+ return r;
73
+ },
74
+ async stop(args) {
75
+ return vd.stop({ forceStopApps: args?.forceStopApps === true });
76
+ },
77
+ async status() {
78
+ return vd.status();
79
+ },
80
+ async launch(args) {
81
+ const pkg = String(args?.pkg || '').trim();
82
+ if (!/^[a-z][\w.]*$/i.test(pkg)) return { hint: 'pkg 看起来不是合法包名。' };
83
+ return vd.launch(pkg, args?.activity ? String(args.activity).trim() : '');
84
+ },
85
+ async shot(args) {
86
+ const region = args?.region && typeof args.region === 'object' ? args.region : null;
87
+ const frames = Number(args?.frames) || 0;
88
+
89
+ // frames > 1 走九格连拍(自适应采样)。以前 daemon 只有单帧,导致命令行用不了这个能力。
90
+ if (frames > 1) {
91
+ const st = await vd.status();
92
+ if (!st.running) return { ok: false, hint: '虚拟屏没在运行,先 start。' };
93
+ const tl = await import('../src/timeline.js');
94
+ return tl.capture({
95
+ sfId: st.sfId,
96
+ frames,
97
+ intervalMs: Number(args?.intervalMs) || 300,
98
+ cellWidth: Number(args?.width) || 262,
99
+ dir: args?.dir || '/tmp',
100
+ crop: 'none',
101
+ });
102
+ }
103
+
104
+ return vd.shot(args?.dir || '/tmp', {
105
+ width: Math.min(Math.max(Number(args?.width) || 540, 240), 1080),
106
+ format: args?.format === 'png' ? 'png' : 'jpeg',
107
+ cropPx: 0,
108
+ region,
109
+ });
110
+ },
111
+ async mainShot(args) {
112
+ return vd.mainShot(args?.dir || '/tmp');
113
+ },
114
+ /**
115
+ * 读屏文字。这里加一份是为了 CLI 和 HTTP 也能用 OCR,
116
+ * 顺便让"OCR 到底通不通"可以用真实入口验证 —— 只测模块不算。
117
+ */
118
+ async text(args) {
119
+ const st = await vd.status();
120
+ if (!st.running) return { ok: false, hint: '虚拟屏没在运行,先 start。' };
121
+ const shot = await vd.shot(args?.dir || '/tmp', {
122
+ width: Math.min(1080, Math.max(360, st.width || 720)),
123
+ format: 'png',
124
+ });
125
+ if (!shot.ok) return { ok: false, hint: shot.hint };
126
+ const ocr = await import('../src/ocr.js');
127
+ const r = await ocr.recognize(shot.path, {
128
+ minConf: args?.minConf === undefined ? 0.45 : Number(args.minConf),
129
+ maxLines: Number(args?.maxLines) || 80,
130
+ hash: args?.fresh === true ? null : shot.hash,
131
+ });
132
+ if (!r.ok) return { ok: false, hint: r.hint };
133
+ return { ok: true, ...r, imageWidth: shot.imageWidth || st.width, imageHeight: shot.imageHeight || st.height, path: shot.path };
134
+ },
135
+
136
+ /* ===== 多屏池(pool.js) ===== */
137
+ async poolCreate(args) {
138
+ const pool = await import('../src/pool.js');
139
+ return pool.create(args || {});
140
+ },
141
+ async poolList() {
142
+ const pool = await import('../src/pool.js');
143
+ return pool.list();
144
+ },
145
+ async poolUse(args) {
146
+ const pool = await import('../src/pool.js');
147
+ return pool.use(String(args?.screenId || ''));
148
+ },
149
+ async poolDestroy(args) {
150
+ const pool = await import('../src/pool.js');
151
+ return pool.destroy(String(args?.screenId || ''), args || {});
152
+ },
153
+ /* ===== 租约 ===== */
154
+ async claimApp(args) {
155
+ const lease = await import('../src/lease.js');
156
+ const pool = await import('../src/pool.js');
157
+ const info = pool.info();
158
+ if (!info.active) return { ok: false, code: 'E_NO_SCREEN', hint: '还没有活动屏,先 poolCreate' };
159
+ return lease.claim({
160
+ pkg: String(args?.pkg || ''),
161
+ screenId: args?.screenId ? String(args.screenId) : info.active,
162
+ owner: String(args?.owner || 'unknown'),
163
+ mode: args?.mode, priority: args?.priority,
164
+ preemptible: args?.preemptible,
165
+ nonPreemptibleReason: args?.nonPreemptibleReason,
166
+ onConflict: args?.onConflict || 'fail',
167
+ ttlMs: args?.ttlSec ? Number(args.ttlSec) * 1000 : undefined,
168
+ });
169
+ },
170
+ async releaseApp(args) {
171
+ const lease = await import('../src/lease.js');
172
+ if (args?.leaseId) return lease.release(String(args.leaseId));
173
+ return lease.releaseAll(String(args?.owner || 'unknown'));
174
+ },
175
+ async leasesList() {
176
+ const lease = await import('../src/lease.js');
177
+ return lease.list();
178
+ },
179
+
180
+ async checkApp(args) {
181
+ // 占用检测:主屏谁在用、自家屏上有没有、有没有外来屏
182
+ const occ = await import('../src/occupancy.js');
183
+ const pool = await import('../src/pool.js');
184
+ const info = pool.info();
185
+ const ourScreens = new Map(info.screens.map((s) => [Number(s.displayId), s.screenId]));
186
+ return occ.checkApp(String(args?.pkg || ''), { ourScreens });
187
+ },
188
+
189
+ async poolInfo() {
190
+ const pool = await import('../src/pool.js');
191
+ return pool.info();
192
+ },
193
+
194
+ async apps() {
195
+ // 投屏前查包名。之前没有任何工具能给包名,模型只能猜。
196
+ const r = await vd.adb(['shell', 'pm list packages -3 2>/dev/null']);
197
+ if (!r.ok) return { ok: false, hint: r.err || 'adb 不可用' };
198
+ const pkgs = String(r.out || '').split('\n')
199
+ .map((x) => x.trim().replace(/^package:/, '')).filter(Boolean).sort();
200
+ return { ok: true, count: pkgs.length, packages: pkgs };
201
+ },
202
+
203
+ async focusedApp() {
204
+ return { app: await vd.focusedApp() };
205
+ },
206
+ async mainFocus() {
207
+ return { app: await vd.mainFocus() };
208
+ },
209
+ async input(args) {
210
+ const kind = String(args?.kind || '');
211
+ if (!['tap', 'swipe', 'hold', 'text', 'key', 'paste'].includes(kind)) {
212
+ return { hint: `不认识的输入类型「${kind}」。可选:tap / swipe / hold / text / key / paste` };
213
+ }
214
+ return vd.input(kind, args);
215
+ },
216
+ };
217
+
218
+ function send(res, code, obj) {
219
+ const body = JSON.stringify(obj);
220
+ res.writeHead(code, {
221
+ 'Content-Type': 'application/json; charset=utf-8',
222
+ 'Content-Length': Buffer.byteLength(body),
223
+ });
224
+ res.end(body);
225
+ }
226
+
227
+ async function handle(req, res) {
228
+ lastActive = Date.now();
229
+
230
+ if (req.method === 'GET' && req.url === '/health') {
231
+ return send(res, 200, { ok: true, pid: process.pid });
232
+ }
233
+ if (req.method !== 'POST' || req.url !== '/cmd') {
234
+ return send(res, 404, { error: 'not found' });
235
+ }
236
+
237
+ let raw = '';
238
+ for await (const chunk of req) raw += chunk;
239
+ let payload;
240
+ try { payload = JSON.parse(raw || '{}'); } catch { return send(res, 400, { error: 'body 不是合法 JSON' }); }
241
+
242
+ const fn = ACTIONS[payload.action];
243
+ if (!fn) {
244
+ return send(res, 400, { error: `不认识的 action「${payload.action}」`, available: Object.keys(ACTIONS) });
245
+ }
246
+
247
+ /*
248
+ * **有副作用的命令必须串行。**
249
+ *
250
+ * 为什么:vd.js 的 state 是模块级单例,而 start() 从「判空」到「写 displayId」
251
+ * 中间有好几段 await(推 jar、spawn server、等 socket)。两个 MCP 客户端同时
252
+ * 发 start,两边都看到 displayId 为空,就会各建一块屏 —— 而设备上有多块 scrcpy
253
+ * 屏时 resolveScrcpySfId() 会分不清,之后所有截图都报歧义。
254
+ *
255
+ * 只读命令(status/focusedApp/mainFocus)不加锁,保持并发。
256
+ */
257
+ const MUTATING = new Set(['start', 'stop', 'launch', 'input', 'shot', 'mainShot', 'text',
258
+ // 池操作会切换全局活动上下文,必须串行,否则两个请求会互相切走
259
+ 'poolCreate', 'poolUse', 'poolDestroy',
260
+ // 租约也改全局状态(可能撤销别人的),必须串行
261
+ 'claimApp', 'releaseApp']);
262
+ const run = async () => {
263
+ try {
264
+ const out = await fn(payload.args || {});
265
+ return send(res, 200, { ok: true, result: out });
266
+ } catch (e) {
267
+ return send(res, 500, { ok: false, error: e?.message || String(e) });
268
+ }
269
+ };
270
+
271
+ if (!MUTATING.has(payload.action)) return run();
272
+
273
+ // single-flight:一把全局锁,后来的排队
274
+ const prev = mutexTail;
275
+ let release;
276
+ mutexTail = new Promise((r) => { release = r; });
277
+ try {
278
+ await prev;
279
+ return await run();
280
+ } finally {
281
+ release();
282
+ }
283
+ }
284
+
285
+ async function shutdown(reason) {
286
+ try { await vd.stop({ forceStopApps: false }); } catch { /* 尽力而为 */ }
287
+ // vd.stop() 正常会恢复 HWC,但它可能因为 adb 不通而失败;
288
+ // 这里同步再兜一次,保证全局属性不留残。
289
+ try { vd.restoreHwcSync(); } catch { /* ignore */ }
290
+ await clearState();
291
+ if (server) { try { server.close(); } catch { /* ignore */ } }
292
+ process.exit(0);
293
+ }
294
+
295
+ function startIdleWatch() {
296
+ setInterval(async () => {
297
+ const idle = Date.now() - lastActive;
298
+ if (idle < IDLE_EXIT_MS) return;
299
+ // 屏还开着就别退——用户可能正等着用
300
+ const st = await vd.status().catch(() => null);
301
+ if (st?.running) return;
302
+ await shutdown('idle');
303
+ }, 30_000).unref?.();
304
+
305
+ /* 每 5 秒把当前 App 的风控等级同步给浮窗。
306
+ *
307
+ * 浮窗每 3 秒重读那个文件并重绘,但文件原来只在 input() 时才写 ——
308
+ * 用户在那块屏上切了 App 又没点屏幕,底部 L 等级就一直停在旧值。
309
+ * 等级是用来判断「这一步能不能这么操作」的,过期值比不显示更糟。
310
+ *
311
+ * 5 秒是权衡:一次 dumpsys 约 250ms,太快会拖 CPU;
312
+ * 人切换 App 再看浮窗,5 秒滞后可以接受。没屏在跑就跳过,不空转。
313
+ */
314
+ setInterval(async () => {
315
+ try {
316
+ const st = await vd.status().catch(() => null);
317
+ if (!st?.running) return;
318
+ await vd.syncRiskLevel();
319
+ } catch { /* 同步失败不影响守护进程 */ }
320
+ }, 5_000).unref?.();
321
+ }
322
+
323
+ /**
324
+ * 启动时对账:清理上一次运行留下的残留。
325
+ *
326
+ * 为什么需要:守护进程被 SIGKILL 或被系统 OOM 杀掉时,`process.on('exit')`
327
+ * **不会执行**,于是 `debug.sf.enable_hwc_vds` 会留在 1 —— 那是全局 SurfaceFlinger
328
+ * 属性,整台设备的合成策略都被改变,直到手机重启才恢复。实测确认过这个残留。
329
+ *
330
+ * 判据:属性是 1,但设备上**已经没有任何 scrcpy 虚拟屏** → 说明是上次没清掉的,
331
+ * 不是正在使用中的。这个判据不会误杀"用户自己开着 HWC"的情况,因为那种情况下
332
+ * 属性是 1 且通常也没有我们的虚拟屏……所以只有在我们自己写过状态文件时才做。
333
+ */
334
+ async function reconcileLeftovers() {
335
+ try {
336
+ const hwc = String(await vd.shell('getprop debug.sf.enable_hwc_vds')).trim();
337
+ if (hwc !== '1') return;
338
+
339
+ const n = String(await vd.shell(
340
+ 'dumpsys display 2>/dev/null | grep -c \'DisplayDeviceInfo{"scrcpy"\'',
341
+ )).trim();
342
+ if (Number(n) > 0) return; // 还有虚拟屏在用,别动
343
+
344
+ await vd.shell('setprop debug.sf.enable_hwc_vds 0');
345
+ console.error('[vdisplayd] 对账:清掉了上次异常退出残留的 debug.sf.enable_hwc_vds=1');
346
+ } catch { /* 对账失败不能拖垮启动 */ }
347
+ }
348
+
349
+ async function main() {
350
+ // 已有实例就直接报错退出,避免两个守护进程抢同一台设备的虚拟屏
351
+ try {
352
+ const old = JSON.parse(await readFile(STATE_FILE, 'utf8'));
353
+ if (old?.pid && old.pid !== process.pid) {
354
+ try {
355
+ process.kill(old.pid, 0);
356
+ console.error(`[vdisplayd] 已经有守护进程在跑(pid ${old.pid}, port ${old.port}),不重复启动。`);
357
+ process.exit(0);
358
+ } catch { /* 旧进程已经死了,继续 */ }
359
+ }
360
+ } catch { /* 没有状态文件,正常 */ }
361
+
362
+ await reconcileLeftovers();
363
+
364
+ server = createServer((req, res) => {
365
+ handle(req, res).catch((e) => send(res, 500, { error: e?.message || String(e) }));
366
+ });
367
+
368
+ await new Promise((resolve, reject) => {
369
+ server.once('error', reject);
370
+ server.listen(0, '127.0.0.1', resolve);
371
+ });
372
+
373
+ const port = server.address().port;
374
+ await writeState(port);
375
+ console.log(`[vdisplayd] listening on 127.0.0.1:${port} (pid ${process.pid})`);
376
+
377
+ startIdleWatch();
378
+
379
+ for (const sig of ['SIGTERM', 'SIGINT', 'SIGHUP']) {
380
+ process.on(sig, () => { shutdown(sig).catch(() => process.exit(0)); });
381
+ }
382
+
383
+ // 最后一道保险:不管从哪条路退出,都同步把 HWC 属性恢复原值。
384
+ // 这个属性是全局的 —— 留着 1 会一直影响整台设备的合成策略,直到重启手机。
385
+ // 注意 SIGKILL 抓不到,那种情况下只能靠下次 vd.start() 重新对账。
386
+ process.on('exit', () => {
387
+ try { vd.restoreHwcSync(); } catch { /* 退出中,尽力而为 */ }
388
+ });
389
+ process.on('uncaughtException', (e) => {
390
+ console.error('[vdisplayd] uncaught:', e?.message || e);
391
+ });
392
+ }
393
+
394
+ main().catch(async (e) => {
395
+ console.error('[vdisplayd] 启动失败:', e?.message || e);
396
+ await clearState();
397
+ process.exit(1);
398
+ });
package/bin/vidcap.mjs ADDED
@@ -0,0 +1,82 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * vidcap.mjs —— 从虚拟屏抓视频帧(绕开 scrcpy 视频流的冻结问题)
4
+ *
5
+ * ## 为什么需要它
6
+ *
7
+ * scrcpy 的 H.264 镜像流在播放视频时会冻住(只出第一帧),
8
+ * 但**虚拟屏本身在正常渲染** —— 实测 `screencap -d <SFID>` 连拍 10 帧,
9
+ * 连续 9 对差异 2.26-2.75(静态 UI 会是 0.00)。
10
+ *
11
+ * 所以抓帧不要走 scrcpy 流,走 screencap。
12
+ *
13
+ * ## 关键陷阱:screencap -d 要 SurfaceFlinger ID,不是逻辑 displayId
14
+ *
15
+ * ```
16
+ * $ screencap -p -d 354
17
+ * Failed to take screenshot. Display Id '354' is not valid.
18
+ * $ screencap -p -d 0 # 连主屏的 0 都不认
19
+ * Failed to take screenshot. Display Id '0' is not valid.
20
+ * ```
21
+ *
22
+ * 要的是 19 位大数(如 11529215048879975052),也就是 vd.start() 返回的 `sfId`。
23
+ *
24
+ * ## 用法
25
+ *
26
+ * ```bash
27
+ * node bin/vidcap.mjs --frames 10 --interval 400 # 抓 10 帧,间隔 400ms
28
+ * node bin/vidcap.mjs --seconds 5 --fps 7 # 抓 5 秒,约 7fps
29
+ * ```
30
+ *
31
+ * 产物在 `--out`(默认 /tmp/vidcap):f01.png...,可直接读或 OCR。
32
+ */
33
+
34
+ import { spawnSync } from 'node:child_process';
35
+ import { mkdirSync, writeFileSync } from 'node:fs';
36
+ import * as vd from '../src/vd.js';
37
+
38
+ const argv = process.argv.slice(2);
39
+ const arg = (name, dflt) => {
40
+ const i = argv.indexOf(`--${name}`);
41
+ return i >= 0 ? argv[i + 1] : dflt;
42
+ };
43
+ const outDir = arg('out', '/tmp/vidcap');
44
+ const frames = Number(arg('frames', 0));
45
+ const interval = Number(arg('interval', 400));
46
+ const seconds = Number(arg('seconds', 0));
47
+ const n = frames || (seconds ? Math.round(seconds * 1000 / interval) : 10);
48
+
49
+ const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
50
+
51
+ const cap = (sfid) => spawnSync(
52
+ 'adb',
53
+ ['-s', process.env.ADB_TARGET || '127.0.0.1:5555', 'exec-out', `screencap -p -d ${sfid}`],
54
+ { maxBuffer: 64 << 20 },
55
+ ).stdout;
56
+
57
+ const main = async () => {
58
+ const r = await vd.start({ maxFps: 30 });
59
+ const sfid = r.sfId;
60
+ if (!sfid) {
61
+ console.error('拿不到 SurfaceFlinger id,vidcap 无法工作。');
62
+ process.exit(1);
63
+ }
64
+ console.log(`虚拟屏 displayId=${r.displayId} SFID=${sfid}`);
65
+ console.log(`抓 ${n} 帧,间隔 ${interval}ms → ${outDir}`);
66
+ mkdirSync(outDir, { recursive: true });
67
+ const sizes = [];
68
+ for (let i = 1; i <= n; i += 1) {
69
+ const buf = cap(sfid);
70
+ const p = `${outDir}/f${String(i).padStart(2, '0')}.png`;
71
+ writeFileSync(p, buf);
72
+ sizes.push(buf.length);
73
+ console.log(` f${String(i).padStart(2, '0')}.png ${buf.length} 字节`);
74
+ if (i < n) await sleep(interval);
75
+ }
76
+ const uniq = new Set(sizes).size;
77
+ console.log('');
78
+ console.log(` 不同大小 ${uniq}/${n} —— 变化越多说明画面在动得越厉害`);
79
+ if (uniq === 1) console.log(' ⚠️ 全部一样大小,画面可能是静止的(也可能只是恰好同尺寸)');
80
+ };
81
+
82
+ main().catch((e) => { console.error(e.message); process.exit(1); });
@@ -0,0 +1,172 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * vidgrab —— 从 App 缓存里直接取视频,绕开虚拟屏。
4
+ *
5
+ * ## 为什么存在
6
+ *
7
+ * 视频画面在虚拟屏上抓不到(MediaCodec 只出首帧,四条修法全失败)。
8
+ * 但 `/sdcard/Android/data/<包名>/` 对 shell 可读,App 缓存的视频往往是**标准 MP4**
9
+ * (微信的 `.res` 后缀是骗人的,头部是 `ftypisom`)。
10
+ *
11
+ * 所以:**pull 出来用 ffmpeg 直接读** —— 不用播放、没有 MediaCodec、秒级、有音频。
12
+ *
13
+ * ## 用法
14
+ *
15
+ * node bin/vidgrab.mjs find # 列出候选
16
+ * node bin/vidgrab.mjs find com.tencent.mm # 指定包名
17
+ * node bin/vidgrab.mjs grab <路径> --out /tmp/x # pull + 抽帧 + 抽音频
18
+ * node bin/vidgrab.mjs grab <路径> --frames 6 # 抽 6 帧
19
+ */
20
+
21
+ import { execFileSync } from 'node:child_process';
22
+ import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
23
+ import { basename } from 'node:path';
24
+
25
+ const ADB = process.env.ADB_BIN || 'adb';
26
+ const TARGET = process.env.ADB_TARGET || '127.0.0.1:5555';
27
+
28
+ const adb = (args, opts = {}) => execFileSync(ADB, ['-s', TARGET, ...args], {
29
+ encoding: 'buffer', maxBuffer: 64 << 20, ...opts,
30
+ }).toString();
31
+
32
+ /** 这些包名的缓存里最可能有视频 */
33
+ const KNOWN = {
34
+ 'com.tencent.mm': ['cache/ThumbVideoCache', 'cache/wxacache', 'MicroMsg', 'files'],
35
+ 'tv.danmaku.bili': ['download', 'cache', 'files'],
36
+ // 短视频类:播放缓存多数落在 OkHttp 磁盘缓存(`.1` 是响应体原文)
37
+ 'com.ss.android.ugc.aweme': ['cache', 'files'],
38
+ 'com.ss.android.ugc.aweme.lite': ['cache', 'files'],
39
+ 'com.smile.gifmaker': ['cache', 'files'],
40
+ 'com.kuaishou.nebula': ['cache', 'files'],
41
+ 'com.xingin.xhs': ['cache', 'files'],
42
+ 'com.sina.weibo': ['cache', 'files'],
43
+ 'com.google.android.youtube': ['cache', 'files'],
44
+ };
45
+
46
+ /** App 可选的外置目录(Android 11+,对 shell 同样可读) */
47
+ const EXTRA_ROOTS = ['/sdcard/Android/media', '/sdcard/Android/obb'];
48
+
49
+ /** 媒体文件头(不看后缀,看内容) */
50
+ function sniff(buf) {
51
+ if (buf.length < 12) return null;
52
+ const a = buf.toString('ascii', 0, 12);
53
+ // MP4/MOV: 4 字节 size + "ftyp"
54
+ if (buf.toString('ascii', 4, 8) === 'ftyp') return 'mp4';
55
+ // **fMP4/DASH 分片**:开头是 styp/moof/sidx,不是 ftyp
56
+ if (a.slice(4, 8) === 'styp' || a.slice(4, 8) === 'moof' || a.slice(4, 8) === 'sidx') return 'fmp4';
57
+ // Matroska
58
+ if (buf[0] === 0x1a && buf[1] === 0x45 && buf[2] === 0xdf && buf[3] === 0xa3) return 'mkv';
59
+ // AVI
60
+ if (a.slice(0, 4) === 'RIFF' && a.slice(8, 12) === 'AVI ') return 'avi';
61
+ // FLV
62
+ if (a.slice(0, 3) === 'FLV') return 'flv';
63
+ // Ogg
64
+ if (a.slice(0, 4) === 'OggS') return 'ogg';
65
+ // MPEG-PS
66
+ if (buf[0] === 0x00 && buf[1] === 0x00 && buf[2] === 0x01 && buf[3] === 0xba) return 'mpg';
67
+ // TS:0x47 每隔 188 字节
68
+ if (buf[0] === 0x47 && (buf.length < 189 || buf[188] === 0x47)) return 'ts';
69
+ // WebM
70
+ if (buf[0] === 0x1a && buf[1] === 0x45 && buf[2] === 0xdf && buf[3] === 0xa3) return 'webm';
71
+ return null;
72
+ }
73
+
74
+ /** 加密检测:命中这些 box 就是 DRM/AES,ffmpeg 解不了,别浪费时间 */
75
+ function isEncrypted(buf) {
76
+ const a = buf.toString('ascii');
77
+ return /pssh|senc|saiz|tenc|sinf/.test(a);
78
+ }
79
+
80
+ function cmdFind(pkgFilter) {
81
+ const pkgs = pkgFilter ? [pkgFilter] : Object.keys(KNOWN);
82
+ const found = [];
83
+ for (const pkg of pkgs) {
84
+ const roots = KNOWN[pkg] || ['.'];
85
+ for (const rel of roots) {
86
+ const base = `/sdcard/Android/data/${pkg}/${rel}`;
87
+ let list;
88
+ try {
89
+ list = adb(['shell', `find '${base}' -type f -size +200k 2>/dev/null | head -30`]).trim();
90
+ } catch { continue; }
91
+ if (!list) continue;
92
+ for (const p of list.split('\n').filter(Boolean)) {
93
+ // 只读头部 12 字节判断是不是媒体
94
+ let head;
95
+ try {
96
+ head = execFileSync(ADB, ['-s', TARGET, 'shell', `dd if='${p}' bs=1 count=12 2>/dev/null`], { maxBuffer: 1 << 16 });
97
+ } catch { continue; }
98
+ const kind = sniff(head);
99
+ if (!kind) continue;
100
+ let size = 0;
101
+ try { size = Number(adb(['shell', `stat -c%s '${p}' 2>/dev/null`]).trim()) || 0; } catch {}
102
+ found.push({ pkg, path: p, kind, size });
103
+ }
104
+ }
105
+ }
106
+ if (!found.length) {
107
+ console.log('没找到缓存的视频。');
108
+ console.log('已知位置:' + Object.entries(KNOWN).map(([k, v]) => `${k} → ${v.join('/')}`).join(';'));
109
+ console.log('别的 App:先 `adb shell ls /sdcard/Android/data/` 找它的目录,再指定包名。');
110
+ return;
111
+ }
112
+ console.log(`找到 ${found.length} 个候选(按大小排序):`);
113
+ for (const f of found.sort((a, b) => b.size - a.size)) {
114
+ console.log(` ${(f.size / 1048576).toFixed(1)}MB ${f.kind} ${f.pkg} ${f.path}`);
115
+ }
116
+ }
117
+
118
+ function cmdGrab(remote, opts) {
119
+ if (!existsSync('/tmp')) mkdirSync('/tmp');
120
+ const outDir = opts.out || '/tmp/vidgrab';
121
+ mkdirSync(outDir, { recursive: true });
122
+ const local = `${outDir}/${basename(remote)}`;
123
+ console.log(`pull ${remote}`);
124
+ adb(['pull', remote, local]);
125
+ // 补一个 .mp4 后缀,ffmpeg 靠内容嗅探也能认,但有些工具认后缀
126
+ const asMp4 = local.endsWith('.mp4') ? local : `${local}.mp4`;
127
+ if (!local.endsWith('.mp4')) {
128
+ try { execFileSync('cp', [local, asMp4]); } catch {}
129
+ }
130
+ // 探一下元信息
131
+ try {
132
+ const meta = execFileSync('ffprobe', ['-v', 'error', '-show_entries',
133
+ 'format=duration,size:stream=codec_name,codec_type,width,height',
134
+ '-of', 'default=noprint_wrappers=1', asMp4], { encoding: 'utf-8' });
135
+ console.log('--- 元信息 ---');
136
+ console.log(meta.trim().split('\n').map((l) => ` ${l}`).join('\n'));
137
+ } catch (e) {
138
+ console.log('ffprobe 读不了,可能不是标准容器');
139
+ }
140
+ const n = Number(opts.frames) || 4;
141
+ const fpsExp = `fps=${n}/max(1\\,floor(metadata:format=duration))`;
142
+ console.log(`--- 抽 ${n} 帧 ---`);
143
+ try {
144
+ execFileSync('ffmpeg', ['-v', 'error', '-i', asMp4,
145
+ '-vf', `fps=${n}/10`, '-frames:v', String(n), '-y', `${outDir}/f%02d.jpg`]);
146
+ } catch {}
147
+ try {
148
+ execFileSync('ffmpeg', ['-v', 'error', '-i', asMp4, '-vn', '-ar', '16000', '-ac', '1',
149
+ '-y', `${outDir}/audio.wav`]);
150
+ } catch {}
151
+ console.log(`产物在 ${outDir}`);
152
+ console.log(' f01.jpg... 抽出来的画面(可直接读)');
153
+ console.log(' audio.wav 16kHz 单声道,可喂 ASR');
154
+ }
155
+
156
+ // ---- 入口 ----
157
+ const [, , sub, ...rest] = process.argv;
158
+ const opts = {};
159
+ const pos = [];
160
+ for (let i = 0; i < rest.length; i += 1) {
161
+ if (rest[i] === '--out') { opts.out = rest[i + 1]; i += 1; }
162
+ else if (rest[i] === '--frames') { opts.frames = rest[i + 1]; i += 1; }
163
+ else pos.push(rest[i]);
164
+ }
165
+ if (sub === 'find') cmdFind(pos[0]);
166
+ else if (sub === 'grab' && pos[0]) cmdGrab(pos[0], opts);
167
+ else {
168
+ console.log('用法:');
169
+ console.log(' node bin/vidgrab.mjs find [包名]');
170
+ console.log(' node bin/vidgrab.mjs grab <远程路径> [--out 目录] [--frames 4]');
171
+ process.exit(1);
172
+ }