dsh-jiuling-remote-mobile 1.0.12 → 1.0.14

package/lib/index.js

@@ -49,6 +49,8 @@
 
 import { createHash, randomUUID } from 'node:crypto';
 import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { request as httpRequest } from 'node:http';
+import { request as httpsRequest } from 'node:https';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 
@@ -208,21 +210,229 @@ function saveRemoteSessions(set, logger) {
  * 所以本插件**不复用全局 dispatcher**，自己建一个关掉 `autoSelectFamily` 的池。
  * 只影响本插件发出的请求，不碰进程全局状态。
  *
- * @returns `{ dispatcher, fetch }`；拿不到 undici 时 `dispatcher` 为 `undefined`。
+ * @param url - 完整 URL。
+ * @param init - `fetch` 的第二参数。
+ * @returns 响应。
  */
-let remoteAgent;
 async function remoteFetch(url, init) {
-	if (remoteAgent === undefined) {
+	const pool = await remotePool();
+	try {
+		if (pool === null) {
+			// 拿不到 undici ⇒ 走自带的 node:https 兜底（见 nodeHttpsFetch）。
+			// ⚠️ **不要退回全局 fetch**：它在 Android 上会因 Happy Eyeballs 卡死，
+			// 且失败时只给一句 `fetch failed`（真因藏在 cause 里），实测导致
+			// 「一台手机能配对、另一台报 fetch failed」这种无从下手的现象。
+			if (!remoteFallbackWarned) {
+				remoteFallbackWarned = true;
+				console.warn(
+					'[dsh-remote-mobile] 拿不到 undici，改用 node:https 兜底通道（强制 IPv4）。',
+				);
+			}
+			return await nodeHttpsFetch(url, init);
+		}
+		return await pool.undici.fetch(url, { ...init, dispatcher: pool.agent });
+	} catch (error) {
+		// 主动中止（SSE 断开重连）不是故障，原样抛给调用方，否则重连逻辑会失效。
+		if (error?.name === 'AbortError' || error?.name === 'TimeoutError') throw error;
+		throw new Error(describeFetchError(error, pool === null));
+	}
+}
+
+/**
+ * 不依赖 undici 的 HTTPS 兜底通道（只用 Node 内置的 `node:https`）。
+ *
+ * ## 为什么需要它
+ *
+ * `undici` 是**引擎**的依赖（`<engine>/node_modules/undici`），不在插件的解析链上。
+ * 一旦解析不到，退回全局 `fetch` 在 Android 上会因 **Happy Eyeballs** 卡死
+ * （真机实测 12018 ms 超时，而关掉 `autoSelectFamily` 的池 2658 ms 就通）。
+ * 症状是配对时一句 `fetch failed`，配对服务器日志里**根本没有这次请求**。
+ *
+ * `node:https` 是 Node 内置模块，**解析零风险**，且它天然按 DNS 返回顺序逐个尝试
+ * 地址（不做 Happy Eyeballs 竞速），实测在真机上 2125 ms 就通。
+ *
+ * 这里刻意**只强制 IPv4**：Android 上运营商给 AAAA 记录、但 IPv6 实际不通是常态，
+ * 而 `node:https` 遇到连不通的地址要等超时才换下一个 —— 直接锁 IPv4 最稳。
+ *
+ * ## 能力取舍（调用方按需使用）
+ *
+ * 只实现本插件真正用到的部分：POST/GET + 自定义头 + 文本/流式响应体。
+ * 返回对象形状对齐 `fetch`：`{ ok, status, headers: {get}, text(), json(), body }`，
+ * 其中 `body` 是**异步可迭代**的（SSE 消费方 `for await (const chunk of res.body)` 照常工作）。
+ *
+ * @param url - 完整 URL（https 走 TLS，http 走明文，便于本机调试）。
+ * @param init - `{ method, headers, body, signal }`。
+ * @returns 类 `fetch` 响应对象。
+ */
+function nodeHttpsFetch(url, init = {}) {
+	const target = new URL(url);
+	const isTls = target.protocol === 'https:';
+	const send = isTls ? httpsRequest : httpRequest;
+	const method = init.method ?? 'GET';
+	const headers = { ...(init.headers ?? {}) };
+	// 强制 IPv4：见上面的注释（IPv6 不通时能省掉一整个超时窗口）。
+	const options = {
+		protocol: target.protocol,
+		hostname: target.hostname,
+		port: target.port === '' ? (isTls ? 443 : 80) : target.port,
+		path: `${target.pathname}${target.search}`,
+		method,
+		headers,
+		family: 4,
+	};
+
+	return new Promise((resolve, reject) => {
+		const req = send(options, (res) => {
+			const body = res[Symbol.asyncIterator]
+				? res
+				: (async function* empty() {})();
+			resolve({
+				ok: res.statusCode >= 200 && res.statusCode < 300,
+				status: res.statusCode,
+				headers: {
+					get: (name) => res.headers[String(name).toLowerCase()] ?? null,
+				},
+				body,
+				text: () =>
+					new Promise((done, fail) => {
+						const chunks = [];
+						res.on('data', (chunk) => chunks.push(chunk));
+						res.on('end', () => done(Buffer.concat(chunks).toString('utf8')));
+						res.on('error', fail);
+					}),
+				json() {
+					return this.text().then((text) => JSON.parse(text));
+				},
+			});
+		});
+		req.on('error', reject);
+		if (init.signal) {
+			if (init.signal.aborted) {
+				req.destroy();
+				const abort = new Error('The operation was aborted');
+				abort.name = 'AbortError';
+				reject(abort);
+				return;
+			}
+			init.signal.addEventListener('abort', () => {
+				req.destroy();
+				const abort = new Error('The operation was aborted');
+				abort.name = 'AbortError';
+				reject(abort);
+			});
+		}
+		if (init.body !== undefined && init.body !== null) req.write(init.body);
+		req.end();
+	});
+}
+
+/**
+ * 把 fetch 的失败原因展开成可读文字。
+ *
+ * ⚠️ **`fetch failed` 本身不含任何可诊断信息** —— 真正的 errno 藏在 `error.cause`
+ * （有时还要再深一层 `cause.cause`）里。不展开的话，界面上只能看到「fetch failed」，
+ * 而下面这些完全不同的故障会给出**一模一样**的文案，导致无法判断该改代码还是换通道：
+ *
+ * | 真因（在 cause 里） | 含义 | 对策 |
+ * |---|---|---|
+ * | `ENOTFOUND` | DNS 解析不了（运营商 DNS 污染/无网络） | 换 DNS 或换通道 |
+ * | `ETIMEDOUT` / `UND_ERR_CONNECT_TIMEOUT` | 连得上 DNS、连不上 IP（被阻断） | 换通道 |
+ * | `ECONNRESET` / `UND_ERR_SOCKET` | 建连后被重置（中间设备干扰 TLS） | 换通道 |
+ * | `CERT_*` | 证书校验失败（手机时间不对也会这样） | 校时 |
+ *
+ * @param error - `fetch` 抛出的错误。
+ * @param usedGlobalFetch - 是否走了降级路径（用于区分「网络问题」与「undici 没加载到」）。
+ * @returns 形如 `fetch failed ← ENOTFOUND getaddrinfo ENOTFOUND pair… ← 走的是专用 undici 池`。
+ */
+function describeFetchError(error, usedGlobalFetch) {
+	const parts = [];
+	if (error?.message) parts.push(String(error.message));
+	let cause = error?.cause;
+	for (let depth = 0; cause && depth < 3; depth += 1) {
+		const code = cause.code ? String(cause.code) : '';
+		const message = cause.message ? String(cause.message) : '';
+		const text = code !== '' && message !== '' ? `${code} ${message}` : code || message;
+		if (text !== '') parts.push(text);
+		cause = cause.cause;
+	}
+	// 同时连多个地址时抛的是 AggregateError，每个子错误的 errno 都要看到。
+	if (Array.isArray(error?.errors) && error.errors.length > 0) {
+		parts.push(
+			error.errors
+				.map((item) => `${item?.code ?? ''} ${item?.message ?? ''}`.trim())
+				.join(' | '),
+		);
+	}
+	parts.push(usedGlobalFetch ? '走的是全局 fetch（undici 没加载到）' : '走的是专用 undici 池');
+	return parts.join(' ← ');
+}
+
+/** 解析 undici 失败时的告警只打一次（否则每条 RPC 刷一行）。 */
+let remoteFallbackWarned = false;
+
+/** 专用连接池的初始化 Promise（并发首调只初始化一次）。 */
+let remotePoolPromise;
+
+/**
+ * 建（或取）专用连接池。
+ *
+ * @returns `{ undici, agent }`；拿不到 undici 时 `null`。
+ */
+function remotePool() {
+	if (remotePoolPromise === undefined) {
+		remotePoolPromise = (async () => {
+			const undici = await loadUndici();
+			if (undici === null) return null;
+			return { undici, agent: new undici.Agent({ connect: { autoSelectFamily: false } }) };
+		})();
+	}
+	return remotePoolPromise;
+}
+
+/**
+ * 解析 undici 模块。
+ *
+ * ## ⚠️ 为什么不能只写 `await import('undici')`（配对报 `fetch failed` 的根因）
+ *
+ * 本插件装在 `<DSH_HOME>/profiles/<profile>/node_modules/`，而 undici 是
+ * **引擎**的依赖，装在 `<engine>/node_modules/undici` —— 它在插件的解析链
+ * **之外**，于是 `import('undici')` 抛 `ERR_MODULE_NOT_FOUND`，`remoteFetch`
+ * 静默退回全局 `fetch`（即上面那张表里 12018 ms 超时的那个）。
+ *
+ * 真机实测（CDY_TN90 / Android 10 / 插件 1.0.12，2026-10-16）：
+ *
+ * | 写法 | 结果 |
+ * |---|---|
+ * | `await import('undici')`（插件目录内） | **ERR_MODULE_NOT_FOUND** ❌ |
+ * | `createRequire(process.argv[1]).resolve('undici')` | ✅ → `<engine>/node_modules/undici/index.js` |
+ *
+ * 这个故障是**间歇性**的：网络恰好在 Happy Eyeballs 回退窗口内时全局 fetch
+ * 也能通，所以会看到「同一个版本、一台手机能配对、另一台报 fetch failed」——
+ * 而**配对服务器日志里根本没有那次请求**（请求没出网），这是最快的判据。
+ *
+ * @returns undici 模块；都失败时 `null`。
+ */
+async function loadUndici() {
+	// ① 首选：以**引擎入口**为锚点解析。插件由引擎加载，`process.argv[1]` 就是
+	//    引擎的 bin.js（实测 …/engine/node_modules/@deepseek-ai/dsh/lib/bin.js），
+	//    它的 node_modules 里就有 undici。
+	const entry = process.argv[1];
+	if (typeof entry === 'string' && entry !== '') {
 		try {
-			const undici = await import('undici');
-			remoteAgent = new undici.Agent({ connect: { autoSelectFamily: false } });
+			const { createRequire } = await import('node:module');
+			const { pathToFileURL } = await import('node:url');
+			const resolved = createRequire(pathToFileURL(entry).href).resolve('undici');
+			return await import(pathToFileURL(resolved).href);
 		} catch {
-			remoteAgent = null; // 没有 undici：退回全局 fetch
+			/* 换下一个锚点 */
 		}
 	}
-	if (remoteAgent === null || remoteAgent === undefined) return fetch(url, init);
-	const undici = await import('undici');
-	return undici.fetch(url, { ...init, dispatcher: remoteAgent });
+	// ② 兜底：本插件自己的解析链（将来若把 undici 声明成依赖，这里会命中）。
+	try {
+		return await import('undici');
+	} catch {
+		return null;
+	}
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-jiuling-remote-mobile",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "DSH 远程目录（手机端）：在选文件夹流程里多出「电脑」页签，进入电脑目录、在电脑上发起对话，并把电脑的实时消息流同步到手机本地界面（只传文本，不映射桌面）。",
   "type": "module",
   "main": "./lib/index.js",