@napuketto/loader 0.0.34 → 0.0.36

package/dist/index.cjs

@@ -479,6 +479,99 @@ function loaderVersion() {
 	return "0.0.0";
 }
 //#endregion
+//#region src/qq-releases.ts
+/**
+* qq-releases.ts：版本清单读取（P1）。
+*
+* 运行时从包根 qq-releases.json 读取（发布时 files 含它，安装后位于
+* node_modules/@napuketto/loader/qq-releases.json）。
+*
+* 维护机制（真实存在，非「声称」）：清单由 CI 自动维护——
+* .github/workflows/update-qq-releases.yml（每日 cron + 手动触发）调用
+* tooling/qq-releases/update-qq-releases.ts（纯 Node，与本地共用），抓取 QQ 官方下载配置
+* 解析最新版 + 下载安装包计算 sha256 + 解析安装包内部版本目录后更新本清单
+* （保留历史条目、known 按版本递增）。社区 PR 仍可手动补充。NAPUTO_QQ_URL
+* 可运行时覆盖下载地址（用户拿到新链接时用）。
+*
+* ⚠️ 下载 URL 必须经 normalizeDownloadUrl 归一化后再请求（2026-10-07 定位）：
+* 腾讯 CDN 边缘 WAF 对字面量 `/QQNTV2/` 路径段区分大小写地拦截，官方
+* rainbow 配置给出的 URL 直接请求必得 403。详见该函数注释。
+*/
+/** 清单解析失败。 */
+var QqReleasesError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "QqReleasesError";
+	}
+};
+/** 包根路径（dist 与包根同层：dist/index.mjs → ../qq-releases.json）。 */
+function packageRoot() {
+	return (0, node_path.dirname)((0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href)));
+}
+/** 读版本清单（同步，启动期调用一次即可）。 */
+function loadQqReleases() {
+	const file = (0, node_path.join)(packageRoot(), "qq-releases.json");
+	let raw;
+	try {
+		raw = (0, node_fs.readFileSync)(file, "utf8");
+	} catch {
+		throw new QqReleasesError(`版本清单缺失: ${file}（@napuketto/loader 包安装不完整？）`);
+	}
+	try {
+		const parsed = JSON.parse(raw);
+		if (parsed.schema !== 1 || !Array.isArray(parsed.known) || parsed.known.length === 0) throw new Error("结构不合法");
+		return parsed;
+	} catch {
+		throw new QqReleasesError(`版本清单解析失败: ${file}`);
+	}
+}
+/** 取最新已知可用版本（known 数组按录入顺序，取最后一项 = 最新）。 */
+function latestRelease(releases) {
+	const [latest] = [...releases.known].reverse();
+	if (latest === void 0) throw new QqReleasesError("版本清单为空");
+	return latest;
+}
+/**
+* 解析实际下载 URL：NAPUTO_QQ_URL 环境变量覆盖 > 清单 URL。
+* 供 downloadFile 使用（也支持按版本查询，当前固定取最新）。
+*/
+function resolveDownloadUrl(release) {
+	const override = node_process.default.env["NAPUTO_QQ_URL"];
+	return override !== void 0 && override !== "" ? override : release.url;
+}
+/**
+* 被 CDN 边缘 WAF 大小写敏感拦截的路径段（全局匹配，仅用于 String.replace——
+* replace 会复位 lastIndex，无跨调用状态残留）。语义见 normalizeDownloadUrl。
+*/
+const QQNTV2_SEGMENT_RE = /\/QQNTV2\//gi;
+/**
+* 归一化 QQ 官方安装包下载 URL：把 `/QQNTV2/` 路径段降为小写。
+*
+* **为什么需要**（2026-10-07 实测定位，issue #6 的真正根因）：
+* 腾讯 CDN 边缘 WAF 约 2026-08-25 起加了一条 **区分大小写** 的规则，匹配
+* 字面量 `/QQNTV2/` 路径段。命中即由边缘直接拒绝，**不回源**：
+*
+* ```text
+* HTTP/1.1 403 Forbidden
+* Content-Length: 0
+* Server: Lego Server
+* X-Cache-Lookup: Return Directly
+* ```
+*
+* 而 qqdl.gtimg.cn 的缓存/源站对路径大小写 **不敏感**：同一 URL 仅把路径段
+* 写成 `/qqntv2/`（以及 `/Qqntv2/`）即正常返回（实测 x64 安装包
+* `HTTP/1.1 200 OK` + `Content-Length: 330446512`，Range 请求返回 `206` 且首字节
+* 为 PE 头 `MZ`）。同一出口 IP、同一时刻的两次请求只有路径大小写不同 → 403 的
+* 成因是 **路径匹配规则**，不是「数据中心 IP 被封」。
+*
+* 归一化只改请求用的 URL，**清单里仍保留官方原样 URL**（可追溯、来源即官方
+* 配置字段 `ntDownloadX64Url`）；若腾讯哪天修掉这条规则，小写路径依旧等价可用
+* （源站大小写不敏感），因此不必回改清单。
+*/
+function normalizeDownloadUrl(url) {
+	return url.replace(QQNTV2_SEGMENT_RE, "/qqntv2/");
+}
+//#endregion
 //#region src/qq-download.ts
 /**
 * qq-download.ts：QQ 官方安装包下载器（P1）。
@@ -488,6 +581,8 @@ function loaderVersion() {
 *  - 下载同时流式累加 sha256，完成后与清单比对（防链接漂移劫持 / 下载不完整）
 *  - 支持 302 重定向（QQ CDN 可能跳转）
 *  - NAPUTO_QQ_URL 环境变量可覆盖下载地址（用户拿到新链接时用）
+*  - 出站 URL 统一经 normalizeDownloadUrl 归一化（绕过 CDN 边缘对 `/QQNTV2/`
+*    路径段的大小写敏感拦截，见 qq-releases.ts；否则清单里的官方 URL 必 403）
 */
 /** 下载请求 User-Agent（运行时读本包版本，失败兜底 0.0.0）。 */
 const USER_AGENT = `napuketto-loader/${loaderVersion()}`;
@@ -535,8 +630,9 @@ function httpsGet(url, timeoutMs) {
 * 返回实际 sha256（无论是否校验），便于调用方回填清单。
 */
 async function downloadFile(options) {
-	const url = options.url ?? node_process.default.env["NAPUTO_QQ_URL"];
-	if (url === void 0 || url === "") throw new DownloadError("下载地址为空：请设置 NAPUTO_QQ_URL 或提供清单 URL");
+	const requested = options.url ?? node_process.default.env["NAPUTO_QQ_URL"];
+	if (requested === void 0 || requested === "") throw new DownloadError("下载地址为空：请设置 NAPUTO_QQ_URL 或提供清单 URL");
+	const url = normalizeDownloadUrl(requested);
 	const timeoutMs = options.timeoutMs ?? 6e4;
 	(0, node_fs.mkdirSync)((0, node_path.dirname)(options.dest), { recursive: true });
 	const hash = (0, node_crypto.createHash)("sha256");
@@ -1057,63 +1153,6 @@ const ENV = {
 	IPC: "NAPUTO_IPC"
 };
 //#endregion
-//#region src/qq-releases.ts
-/**
-* qq-releases.ts：版本清单读取（P1）。
-*
-* 运行时从包根 qq-releases.json 读取（发布时 files 含它，安装后位于
-* node_modules/@napuketto/loader/qq-releases.json）。
-*
-* 维护机制（真实存在，非「声称」）：清单由 CI 自动维护——
-* .github/workflows/update-qq-releases.yml（每日 cron + 手动触发）调用
-* scripts/qq-releases/update-qq-releases.ts（纯 Node，与本地共用），抓取 QQ 官方下载配置
-* 解析最新版 + 下载安装包计算 sha256 + 解析安装包内部版本目录后更新本清单
-* （保留历史条目、known 按版本递增）。社区 PR 仍可手动补充。NAPUTO_QQ_URL
-* 可运行时覆盖下载地址（用户拿到新链接时用）。
-*/
-/** 清单解析失败。 */
-var QqReleasesError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "QqReleasesError";
-	}
-};
-/** 包根路径（dist 与包根同层：dist/index.mjs → ../qq-releases.json）。 */
-function packageRoot() {
-	return (0, node_path.dirname)((0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href)));
-}
-/** 读版本清单（同步，启动期调用一次即可）。 */
-function loadQqReleases() {
-	const file = (0, node_path.join)(packageRoot(), "qq-releases.json");
-	let raw;
-	try {
-		raw = (0, node_fs.readFileSync)(file, "utf8");
-	} catch {
-		throw new QqReleasesError(`版本清单缺失: ${file}（@napuketto/loader 包安装不完整？）`);
-	}
-	try {
-		const parsed = JSON.parse(raw);
-		if (parsed.schema !== 1 || !Array.isArray(parsed.known) || parsed.known.length === 0) throw new Error("结构不合法");
-		return parsed;
-	} catch {
-		throw new QqReleasesError(`版本清单解析失败: ${file}`);
-	}
-}
-/** 取最新已知可用版本（known 数组按录入顺序，取最后一项 = 最新）。 */
-function latestRelease(releases) {
-	const [latest] = [...releases.known].reverse();
-	if (latest === void 0) throw new QqReleasesError("版本清单为空");
-	return latest;
-}
-/**
-* 解析实际下载 URL：NAPUTO_QQ_URL 环境变量覆盖 > 清单 URL。
-* 供 downloadFile 使用（也支持按版本查询，当前固定取最新）。
-*/
-function resolveDownloadUrl(release) {
-	const override = node_process.default.env["NAPUTO_QQ_URL"];
-	return override !== void 0 && override !== "" ? override : release.url;
-}
-//#endregion
 //#region src/locate-qq.ts
 /**
 * 定位 QQ 原生文件（wrapper.node）来源（P0：多级来源纯定位，不下载）。

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/host/ipc/ipc-types.ts","../src/host/ipc/native-noise.ts","../src/instance-lock.ts","../src/locate-qq.ts","../src/win-node.ts","../src/launcher.ts","../src/pid-cmdline.ts","../src/qq-download.ts","../src/qq-extract.ts","../src/qq-releases.ts","../src/wine.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/host/ipc/ipc-types.ts","../src/host/ipc/native-noise.ts","../src/instance-lock.ts","../src/locate-qq.ts","../src/win-node.ts","../src/launcher.ts","../src/pid-cmdline.ts","../src/qq-download.ts","../src/qq-extract.ts","../src/qq-releases.ts","../src/wine.ts"],"mappings":"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"}

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/host/ipc/ipc-types.ts","../src/host/ipc/native-noise.ts","../src/instance-lock.ts","../src/locate-qq.ts","../src/win-node.ts","../src/launcher.ts","../src/pid-cmdline.ts","../src/qq-download.ts","../src/qq-extract.ts","../src/qq-releases.ts","../src/wine.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/host/ipc/ipc-types.ts","../src/host/ipc/native-noise.ts","../src/instance-lock.ts","../src/locate-qq.ts","../src/win-node.ts","../src/launcher.ts","../src/pid-cmdline.ts","../src/qq-download.ts","../src/qq-extract.ts","../src/qq-releases.ts","../src/wine.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -455,6 +455,99 @@ function loaderVersion() {
 	return "0.0.0";
 }
 //#endregion
+//#region src/qq-releases.ts
+/**
+* qq-releases.ts：版本清单读取（P1）。
+*
+* 运行时从包根 qq-releases.json 读取（发布时 files 含它，安装后位于
+* node_modules/@napuketto/loader/qq-releases.json）。
+*
+* 维护机制（真实存在，非「声称」）：清单由 CI 自动维护——
+* .github/workflows/update-qq-releases.yml（每日 cron + 手动触发）调用
+* tooling/qq-releases/update-qq-releases.ts（纯 Node，与本地共用），抓取 QQ 官方下载配置
+* 解析最新版 + 下载安装包计算 sha256 + 解析安装包内部版本目录后更新本清单
+* （保留历史条目、known 按版本递增）。社区 PR 仍可手动补充。NAPUTO_QQ_URL
+* 可运行时覆盖下载地址（用户拿到新链接时用）。
+*
+* ⚠️ 下载 URL 必须经 normalizeDownloadUrl 归一化后再请求（2026-10-07 定位）：
+* 腾讯 CDN 边缘 WAF 对字面量 `/QQNTV2/` 路径段区分大小写地拦截，官方
+* rainbow 配置给出的 URL 直接请求必得 403。详见该函数注释。
+*/
+/** 清单解析失败。 */
+var QqReleasesError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "QqReleasesError";
+	}
+};
+/** 包根路径（dist 与包根同层：dist/index.mjs → ../qq-releases.json）。 */
+function packageRoot() {
+	return dirname(dirname(fileURLToPath(import.meta.url)));
+}
+/** 读版本清单（同步，启动期调用一次即可）。 */
+function loadQqReleases() {
+	const file = join(packageRoot(), "qq-releases.json");
+	let raw;
+	try {
+		raw = readFileSync(file, "utf8");
+	} catch {
+		throw new QqReleasesError(`版本清单缺失: ${file}（@napuketto/loader 包安装不完整？）`);
+	}
+	try {
+		const parsed = JSON.parse(raw);
+		if (parsed.schema !== 1 || !Array.isArray(parsed.known) || parsed.known.length === 0) throw new Error("结构不合法");
+		return parsed;
+	} catch {
+		throw new QqReleasesError(`版本清单解析失败: ${file}`);
+	}
+}
+/** 取最新已知可用版本（known 数组按录入顺序，取最后一项 = 最新）。 */
+function latestRelease(releases) {
+	const [latest] = [...releases.known].reverse();
+	if (latest === void 0) throw new QqReleasesError("版本清单为空");
+	return latest;
+}
+/**
+* 解析实际下载 URL：NAPUTO_QQ_URL 环境变量覆盖 > 清单 URL。
+* 供 downloadFile 使用（也支持按版本查询，当前固定取最新）。
+*/
+function resolveDownloadUrl(release) {
+	const override = process$1.env["NAPUTO_QQ_URL"];
+	return override !== void 0 && override !== "" ? override : release.url;
+}
+/**
+* 被 CDN 边缘 WAF 大小写敏感拦截的路径段（全局匹配，仅用于 String.replace——
+* replace 会复位 lastIndex，无跨调用状态残留）。语义见 normalizeDownloadUrl。
+*/
+const QQNTV2_SEGMENT_RE = /\/QQNTV2\//gi;
+/**
+* 归一化 QQ 官方安装包下载 URL：把 `/QQNTV2/` 路径段降为小写。
+*
+* **为什么需要**（2026-10-07 实测定位，issue #6 的真正根因）：
+* 腾讯 CDN 边缘 WAF 约 2026-08-25 起加了一条 **区分大小写** 的规则，匹配
+* 字面量 `/QQNTV2/` 路径段。命中即由边缘直接拒绝，**不回源**：
+*
+* ```text
+* HTTP/1.1 403 Forbidden
+* Content-Length: 0
+* Server: Lego Server
+* X-Cache-Lookup: Return Directly
+* ```
+*
+* 而 qqdl.gtimg.cn 的缓存/源站对路径大小写 **不敏感**：同一 URL 仅把路径段
+* 写成 `/qqntv2/`（以及 `/Qqntv2/`）即正常返回（实测 x64 安装包
+* `HTTP/1.1 200 OK` + `Content-Length: 330446512`，Range 请求返回 `206` 且首字节
+* 为 PE 头 `MZ`）。同一出口 IP、同一时刻的两次请求只有路径大小写不同 → 403 的
+* 成因是 **路径匹配规则**，不是「数据中心 IP 被封」。
+*
+* 归一化只改请求用的 URL，**清单里仍保留官方原样 URL**（可追溯、来源即官方
+* 配置字段 `ntDownloadX64Url`）；若腾讯哪天修掉这条规则，小写路径依旧等价可用
+* （源站大小写不敏感），因此不必回改清单。
+*/
+function normalizeDownloadUrl(url) {
+	return url.replace(QQNTV2_SEGMENT_RE, "/qqntv2/");
+}
+//#endregion
 //#region src/qq-download.ts
 /**
 * qq-download.ts：QQ 官方安装包下载器（P1）。
@@ -464,6 +557,8 @@ function loaderVersion() {
 *  - 下载同时流式累加 sha256，完成后与清单比对（防链接漂移劫持 / 下载不完整）
 *  - 支持 302 重定向（QQ CDN 可能跳转）
 *  - NAPUTO_QQ_URL 环境变量可覆盖下载地址（用户拿到新链接时用）
+*  - 出站 URL 统一经 normalizeDownloadUrl 归一化（绕过 CDN 边缘对 `/QQNTV2/`
+*    路径段的大小写敏感拦截，见 qq-releases.ts；否则清单里的官方 URL 必 403）
 */
 /** 下载请求 User-Agent（运行时读本包版本，失败兜底 0.0.0）。 */
 const USER_AGENT = `napuketto-loader/${loaderVersion()}`;
@@ -511,8 +606,9 @@ function httpsGet(url, timeoutMs) {
 * 返回实际 sha256（无论是否校验），便于调用方回填清单。
 */
 async function downloadFile(options) {
-	const url = options.url ?? process$1.env["NAPUTO_QQ_URL"];
-	if (url === void 0 || url === "") throw new DownloadError("下载地址为空：请设置 NAPUTO_QQ_URL 或提供清单 URL");
+	const requested = options.url ?? process$1.env["NAPUTO_QQ_URL"];
+	if (requested === void 0 || requested === "") throw new DownloadError("下载地址为空：请设置 NAPUTO_QQ_URL 或提供清单 URL");
+	const url = normalizeDownloadUrl(requested);
 	const timeoutMs = options.timeoutMs ?? 6e4;
 	mkdirSync(dirname(options.dest), { recursive: true });
 	const hash = createHash("sha256");
@@ -1033,63 +1129,6 @@ const ENV = {
 	IPC: "NAPUTO_IPC"
 };
 //#endregion
-//#region src/qq-releases.ts
-/**
-* qq-releases.ts：版本清单读取（P1）。
-*
-* 运行时从包根 qq-releases.json 读取（发布时 files 含它，安装后位于
-* node_modules/@napuketto/loader/qq-releases.json）。
-*
-* 维护机制（真实存在，非「声称」）：清单由 CI 自动维护——
-* .github/workflows/update-qq-releases.yml（每日 cron + 手动触发）调用
-* scripts/qq-releases/update-qq-releases.ts（纯 Node，与本地共用），抓取 QQ 官方下载配置
-* 解析最新版 + 下载安装包计算 sha256 + 解析安装包内部版本目录后更新本清单
-* （保留历史条目、known 按版本递增）。社区 PR 仍可手动补充。NAPUTO_QQ_URL
-* 可运行时覆盖下载地址（用户拿到新链接时用）。
-*/
-/** 清单解析失败。 */
-var QqReleasesError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "QqReleasesError";
-	}
-};
-/** 包根路径（dist 与包根同层：dist/index.mjs → ../qq-releases.json）。 */
-function packageRoot() {
-	return dirname(dirname(fileURLToPath(import.meta.url)));
-}
-/** 读版本清单（同步，启动期调用一次即可）。 */
-function loadQqReleases() {
-	const file = join(packageRoot(), "qq-releases.json");
-	let raw;
-	try {
-		raw = readFileSync(file, "utf8");
-	} catch {
-		throw new QqReleasesError(`版本清单缺失: ${file}（@napuketto/loader 包安装不完整？）`);
-	}
-	try {
-		const parsed = JSON.parse(raw);
-		if (parsed.schema !== 1 || !Array.isArray(parsed.known) || parsed.known.length === 0) throw new Error("结构不合法");
-		return parsed;
-	} catch {
-		throw new QqReleasesError(`版本清单解析失败: ${file}`);
-	}
-}
-/** 取最新已知可用版本（known 数组按录入顺序，取最后一项 = 最新）。 */
-function latestRelease(releases) {
-	const [latest] = [...releases.known].reverse();
-	if (latest === void 0) throw new QqReleasesError("版本清单为空");
-	return latest;
-}
-/**
-* 解析实际下载 URL：NAPUTO_QQ_URL 环境变量覆盖 > 清单 URL。
-* 供 downloadFile 使用（也支持按版本查询，当前固定取最新）。
-*/
-function resolveDownloadUrl(release) {
-	const override = process$1.env["NAPUTO_QQ_URL"];
-	return override !== void 0 && override !== "" ? override : release.url;
-}
-//#endregion
 //#region src/locate-qq.ts
 /**
 * 定位 QQ 原生文件（wrapper.node）来源（P0：多级来源纯定位，不下载）。