dsh-jiuling-remote-mobile 1.0.13 → 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';
 
@@ -214,20 +216,155 @@ function saveRemoteSessions(set, logger) {
  */
 async function remoteFetch(url, init) {
 	const pool = await remotePool();
-	if (pool === null) {
-		// 退到全局 fetch 是**故障态**，不是正常路径 —— 必须留下痕迹，
-		// 否则又变成上面那种「看不出根因」的间歇性失败。
-		if (!remoteFallbackWarned) {
-			remoteFallbackWarned = true;
-			console.warn(
-				'[dsh-remote-mobile] 拿不到 undici，已退回全局 fetch：Android 上可能因 ' +
-					'Happy Eyeballs 卡死（见 remoteFetch 注释）。配对/远程调用若报 ' +
-					'"fetch failed"，根因在这里。',
-			);
+	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);
+			});
 		}
-		return fetch(url, init);
+		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(' | '),
+		);
 	}
-	return pool.undici.fetch(url, { ...init, dispatcher: pool.agent });
+	parts.push(usedGlobalFetch ? '走的是全局 fetch（undici 没加载到）' : '走的是专用 undici 池');
+	return parts.join(' ← ');
 }
 
 /** 解析 undici 失败时的告警只打一次（否则每条 RPC 刷一行）。 */

package/package.json

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