@applift/core 0.5.0 → 0.7.0

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import { C as readJson, S as findArtifacts, T as subdirs, _ as suggestFramework, a as electronFramework, b as deps, c as knownFrameworkAdapters, d as nativeHarmonyAdapter, f as nativeHarmonyFramework, g as rnFramework, h as rnAdapter, i as electronAdapter, l as nativeAndroidAdapter, m as nativeIosFramework, n as writeProjectVersions, o as flutterAdapter, p as nativeIosAdapter, r as redactText, s as flutterFramework, t as readProjectVersions, u as nativeAndroidFramework, v as tauriAdapter, w as resolveFramework, x as detectBundleIds, y as tauriFramework } from "./project-4_orxby_.mjs";
 import { z } from "zod";
 import fs from "node:fs";
 import path from "node:path";
@@ -41,15 +42,32 @@ profiles: z.record(z.string(), CredentialsProfileSchema) });
 /** 单渠道配置（appId、pkgName 等渠道侧键） */
 const StoreConfigSchema = z.record(z.string(), z.string());
 /**
-* stores 三种等价写法，统一规范化为 record：
+* stores 等价写法，统一规范化为 record：
 * ① 对象：{ huawei: { appId: 'x' } }（原有写法，原样保留）
 * ② 数组：['oppo', 'vivo'] → { oppo: {}, vivo: {} }（无配置渠道）
 * ③ 字符串值：{ huawei: '10xxx' } → { huawei: { appId: '10xxx' } }（appId 简写）
+* ④ 混排数组（README 首例）：['huawei', { yyb: 'appId值' }] → 元素对象须单键 { 渠道: 值 }，
+*    值走 ③ 同款 appId 简写归一
 */
-const StoresSchema = z.union([z.record(z.string(), z.union([StoreConfigSchema, z.string()])), z.array(z.string())]).transform((stores) => {
-	if (Array.isArray(stores)) return Object.fromEntries(stores.map((id) => [id, {}]));
+const storesNormalize = (stores) => {
+	if (Array.isArray(stores)) return Object.fromEntries(stores.flatMap((el) => {
+		if (typeof el === "string") return [[el, {}]];
+		const [id, cfg] = Object.entries(el)[0] ?? [];
+		if (id === void 0 || cfg === void 0) return [];
+		return [[id, typeof cfg === "string" ? { appId: cfg } : cfg]];
+	}));
 	return Object.fromEntries(Object.entries(stores).map(([id, cfg]) => [id, typeof cfg === "string" ? { appId: cfg } : cfg]));
-}).default({});
+};
+const StoresSchema = z.union([z.record(z.string(), z.union([StoreConfigSchema, z.string()])), z.array(z.union([z.string(), StoreConfigSchema]))]).superRefine((val, ctx) => {
+	if (!Array.isArray(val)) return;
+	for (const el of val) {
+		if (typeof el === "string") continue;
+		if (Object.keys(el).length !== 1) ctx.addIssue({
+			code: "custom",
+			message: `stores 数组内的对象元素必须形如 { 渠道id: appId简写 }（单键），收到: ${JSON.stringify(el)}`
+		});
+	}
+}).transform(storesNormalize).default({});
 /** 项目级配置（applift.config.ts 的形状）；beta 段见上方 BetaConfigSchema */
 /**
 * 内测分发配置（applift beta 无平台参数时并行发布的渠道开关）：
@@ -58,8 +76,6 @@ const StoresSchema = z.union([z.record(z.string(), z.union([StoreConfigSchema, z
 * - testflight: App Store Connect 上传（ipa 进 TestFlight）
 */
 const BetaConfigSchema = z.object({
-	/** 自动 version：true(走推断)| major/minor/patch/prerelease | <semver>；CLI --bump/--no-bump 覆盖 */
-	bump: z.union([z.boolean(), z.string()]).optional(),
 	pgyer: z.object({
 		platforms: z.array(z.enum([
 			"android",
@@ -86,35 +102,29 @@ const VersionCodeConfigSchema = z.union([z.literal("increment"), z.object({
 	platforms: z.array(z.string()).optional()
 })]);
 const VersionConfigSchema = z.object({ versionCode: VersionCodeConfigSchema.default("increment") });
-/** 正式发版段的自动 version 开关（语义同 beta.bump） */
-const ReleaseConfigSchema = z.object({ bump: z.union([z.boolean(), z.string()]).optional() });
 const ProjectConfigSchema = z.object({
 	/** 项目显示名 */
 	name: z.string().optional(),
 	/** 团队默认凭据 profile（个人用 applift use / --profile 覆盖），缺省 default */
 	profile: z.string().default("default"),
 	android: z.object({
-		pkgName: z.string(),
+		/** 缺省经 detectBundleIds 从工程文件自动推导（README 首例即只有 stores 的最小配置） */
+		pkgName: z.string().optional(),
 		/** 渠道 → 渠道侧配置（appId 等）；stores 里列出的渠道才发 */
 		stores: StoresSchema
 	}).optional(),
 	harmony: z.object({
-		bundleName: z.string(),
+		/** 缺省自动推导（AppScope/app.json5） */
+		bundleName: z.string().optional(),
 		appId: z.string().optional()
 	}).optional(),
 	ios: z.object({
-		scheme: z.string(),
+		/** 缺省自动推导（工程 scheme 探测） */
+		scheme: z.string().optional(),
 		workspace: z.string().optional(),
 		/** App Store Connect 按 bundleId 定位 App（asc 渠道 submit 用） */
 		bundleId: z.string().optional()
 	}).optional(),
-	/** 构建命令（缺省用项目自带 npm scripts，见 pipeline 约定） */
-	build: z.object({
-		android: z.string().optional(),
-		harmony: z.string().optional(),
-		harmonyApp: z.string().optional(),
-		ios: z.string().optional()
-	}).optional(),
 	/** 产物目录覆盖（非标准工程）：每平台 glob 数组，优先于框架内置 pattern（桌面平台 + 插件自报平台经 catchall 收） */
 	artifacts: z.object({
 		android: z.array(z.string()).optional(),
@@ -126,8 +136,6 @@ const ProjectConfigSchema = z.object({
 	}).catchall(z.array(z.string()).optional()).optional(),
 	/** 版本管理（versionCode 策略等） */
 	version: VersionConfigSchema.optional(),
-	/** 正式发版自动 version 开关 */
-	release: ReleaseConfigSchema.optional(),
 	/** 内测分发（beta 无平台参数时的多渠道并行配置） */
 	beta: BetaConfigSchema.optional()
 });
@@ -208,14 +216,16 @@ function resolveProfile(creds, profile, knownKeys) {
 	for (const [envName, value] of Object.entries(process.env)) if (envName.startsWith("APPLIFT_") && value) merged[envName.slice(8)] = value;
 	return merged;
 }
-/** 全局配置装载（缺失/损坏降级默认值并警告，不阻断） */
+/** 全局配置装载（缺失/损坏降级默认值；警告经返回值交给调用方，不阻断） */
 function loadGlobalConfig(filePath = GLOBAL_CONFIG_PATH) {
-	if (!fs.existsSync(filePath)) return GlobalConfigSchema.parse({});
+	if (!fs.existsSync(filePath)) return { config: GlobalConfigSchema.parse({}) };
 	try {
-		return GlobalConfigSchema.parse(parse(fs.readFileSync(filePath, "utf8")));
+		return { config: GlobalConfigSchema.parse(parse(fs.readFileSync(filePath, "utf8"))) };
 	} catch (e) {
-		process.stderr.write?.(`[applift] 全局配置解析失败，使用默认值: ${e.message}\n`);
-		return GlobalConfigSchema.parse({});
+		return {
+			config: GlobalConfigSchema.parse({}),
+			warning: `全局配置解析失败，使用默认值: ${e.message}`
+		};
 	}
 }
 /** 写凭据（目录自动创建，文件强制 0600） */
@@ -240,10 +250,19 @@ function appliftAlias() {
 		const distEntry = fileURLToPath(import.meta.resolve("@applift/core"));
 		const coreEntry = fs.existsSync(distEntry) ? distEntry : path.join(path.dirname(path.dirname(distEntry)), "src", "index.ts");
 		if (!fs.existsSync(coreEntry)) return {};
-		return {
+		const alias = {
 			"@applift/core": coreEntry,
 			"@applift/cli": coreEntry
 		};
+		try {
+			const distPlugins = fileURLToPath(import.meta.resolve("@applift/core/plugins"));
+			const pluginsEntry = fs.existsSync(distPlugins) ? distPlugins : path.join(path.dirname(coreEntry), "plugins", "index.ts");
+			if (fs.existsSync(pluginsEntry)) {
+				alias["@applift/core/plugins"] = pluginsEntry;
+				alias["@applift/cli/plugins"] = pluginsEntry;
+			}
+		} catch {}
+		return alias;
 	} catch {
 		return {};
 	}
@@ -266,8 +285,32 @@ async function loadProjectConfig(cwd) {
 		packageJson: false,
 		defaults: ProjectConfigSchema.parse({})
 	});
+	const parsed = ProjectConfigSchema.safeParse(result.config ?? {});
+	if (!parsed.success) {
+		const details = parsed.error.issues.map((i) => `${i.path.join(".") || "(根)"}: ${i.message}`).join("；");
+		throw new Error(`applift.config.ts 字段校验失败 → ${details}`);
+	}
+	const config = parsed.data;
+	const rawRec = result.config ?? {};
+	const deprecated = [];
+	if ("build" in rawRec) deprecated.push({
+		key: "build",
+		hint: "构建已回归项目自身（applift 不接管构建），请删除该键"
+	});
+	if ("bump" in (rawRec.beta ?? {})) deprecated.push({
+		key: "beta.bump",
+		hint: "改用 applift version bump 显式升版本（applift 不再代构建）"
+	});
+	if ("release" in rawRec && "bump" in (rawRec.release ?? {})) deprecated.push({
+		key: "release.bump",
+		hint: "改用 applift version bump 显式升版本（applift 不再代构建）"
+	});
+	if (deprecated.length > 0) {
+		const lines = deprecated.map((d) => `  - ${d.key}: ${d.hint}`).join("\n");
+		process.stderr.write(`⚠ applift.config.ts 含已废弃配置键（将被忽略）：\n${lines}\n`);
+	}
 	return {
-		config: ProjectConfigSchema.parse(result.config ?? {}),
+		config,
 		raw: result.config ?? {},
 		cwd: result.cwd ?? cwd
 	};
@@ -305,13 +348,27 @@ function setProjectProfile(cwd, profile, filePath = PROJECTS_MAP_PATH) {
 	saveProjectProfileMap(map, filePath);
 }
 /**
-* 解析项目生效 profile：projects.json 个人选择 > 项目配置 profile（团队默认）> 'default' 全局默认。
-* CLI 的 --profile 旗标在调用方以 `opts.profile ?? resolveProfileFor(...)` 再盖一层（最高优先级）。
+* 解析项目生效 profile 及其来源：projects.json 个人选择 > 项目配置 profile（团队默认）> 'default'。
+* CLI 的 --profile 旗标在调用方以 `opts.profile ?? ...` 再盖一层（最高优先级，来源即"旗标"）。
 */
-function resolveProfileFor(cwd, projectCfgProfile, filePath = PROJECTS_MAP_PATH) {
+function resolveProfileSource(cwd, projectCfgProfile, filePath = PROJECTS_MAP_PATH) {
 	const mapped = loadProjectProfileMap(filePath)[path.resolve(cwd)];
-	if (mapped) return mapped;
-	return projectCfgProfile || "default";
+	if (mapped) return {
+		profile: mapped,
+		source: "applift use（个人）"
+	};
+	if (projectCfgProfile) return {
+		profile: projectCfgProfile,
+		source: "项目配置 profile（团队默认）"
+	};
+	return {
+		profile: "default",
+		source: "默认 default"
+	};
+}
+/** 解析项目生效 profile（只取名不问来源；来源用 resolveProfileSource） */
+function resolveProfileFor(cwd, projectCfgProfile, filePath = PROJECTS_MAP_PATH) {
+	return resolveProfileSource(cwd, projectCfgProfile, filePath).profile;
 }
 //#endregion
 //#region src/channels/shared/sign.ts
@@ -370,8 +427,24 @@ async function formPost(url, params, { timeout = 6e4 } = {}) {
 	}
 }
 //#endregion
+//#region src/channels/shared/file-blob.ts
+/**
+* 惰性文件 Blob：FormData multipart 上传的文件部件。
+* 优先 fs.openAsBlob（Node ≥19.8，按需分片读，零整读内存）；
+* 能力检测不存在时回退整读（旧运行时兜底）。
+*/
+async function fileBlob(p) {
+	if (typeof fs.openAsBlob === "function") try {
+		return await fs.openAsBlob(p);
+	} catch (e) {
+		const cause = e instanceof Error ? e.message : String(e);
+		throw new Error(`打开上传文件失败 ${p}: ${cause}`);
+	}
+	return new Blob([await fs.promises.readFile(p)]);
+}
+//#endregion
 //#region src/util.ts
-/** core 内部共用小工具（不进公共 API） */
+/** core 内部共用小工具（sleep/formatSize 仅内部使用；sha256File 经 index 导出，CLI 历史指纹用） */
 const sleep = (ms) => new Promise((res) => setTimeout(res, ms));
 /** 分块计算文件 SHA256（产物可达上百 MB，8MB 分块避免整读内存，同 sign.ts md5File 先例） */
 function sha256File(filePath) {
@@ -413,7 +486,8 @@ async function pgyerPost(host, apiPath, form) {
 	const res = await fetch(`https://${host}${apiPath}`, {
 		method: "POST",
 		headers: { "Content-Type": "application/x-www-form-urlencoded" },
-		body
+		body,
+		signal: AbortSignal.timeout(3e4)
 	});
 	const text = await res.text();
 	try {
@@ -422,6 +496,20 @@ async function pgyerPost(host, apiPath, form) {
 		throw new Error(`蒲公英 ${apiPath} 返回非 JSON（HTTP ${res.status}）: ${text.slice(0, 200)}`);
 	}
 }
+/** 按 HOSTS 序尝试的 POST（任一域名成功即返回；全挂抛最后一个错误）——状态查询等幂等接口用 */
+async function pgyerPostFailover(ctx, apiPath, form) {
+	let lastErr;
+	for (const host of HOSTS) try {
+		return await pgyerPost(host, apiPath, form);
+	} catch (e) {
+		lastErr = e;
+		ctx.emit({
+			type: "warn",
+			message: `${host} 不可用，尝试备用域名`
+		});
+	}
+	throw lastErr instanceof Error ? lastErr : /* @__PURE__ */ new Error(`蒲公英 ${apiPath} 请求失败`);
+}
 var PgyerChannel = class {
 	id = "pgyer";
 	label = "蒲公英";
@@ -431,6 +519,8 @@ var PgyerChannel = class {
 		scheduled: false,
 		status: false
 	};
+	/** 平台错误码 → 人话（1247：源码注释已证 = buildKey 尚未就绪/COS 仍在入库） */
+	errorHints = { "1247": "buildKey 尚未就绪（COS 上传仍在入库），属处理中状态，稍候即可" };
 	async plan(ctx) {
 		return {
 			channel: this.id,
@@ -487,7 +577,7 @@ var PgyerChannel = class {
 		form.append("x-cos-security-token", params["x-cos-security-token"]);
 		form.append("key", params.key);
 		form.append("x-cos-meta-file-name", path.basename(ctx.artifactPath));
-		form.append("file", new Blob([fs.readFileSync(ctx.artifactPath)]), path.basename(ctx.artifactPath));
+		form.append("file", await fileBlob(ctx.artifactPath), path.basename(ctx.artifactPath));
 		const upRes = await fetch(endpoint, {
 			method: "POST",
 			body: form,
@@ -500,12 +590,29 @@ var PgyerChannel = class {
 			message: "等待蒲公英处理"
 		});
 		const deadline = Date.now() + 9e5;
+		let consecutiveErrors = 0;
 		while (Date.now() < deadline) {
 			await sleep(3e3);
-			const info = await pgyerPost(HOSTS[0], "/apiv2/app/buildInfo", {
-				_api_key: apiKey,
-				buildKey
-			});
+			let info;
+			try {
+				info = await pgyerPostFailover(ctx, "/apiv2/app/buildInfo", {
+					_api_key: apiKey,
+					buildKey
+				});
+				consecutiveErrors = 0;
+			} catch (e) {
+				consecutiveErrors++;
+				const lastErr = e instanceof Error ? e.message : String(e);
+				ctx.emit({
+					type: "warn",
+					message: `buildInfo 状态查询失败（连续 ${consecutiveErrors}/10）: ${lastErr}`
+				});
+				if (consecutiveErrors >= 10) return {
+					ok: false,
+					error: `蒲公英状态查询持续失败（包已上传，可到控制台确认）: ${lastErr}`
+				};
+				continue;
+			}
 			if (info.code === 0 && info.data?.buildShortcutUrl) {
 				ctx.emit({
 					type: "phase",
@@ -556,9 +663,8 @@ function platformOf(artifactPath) {
 }
 //#endregion
 //#region src/channels/shared/agc-token.ts
-/** 华为 AGC token（安卓/鸿蒙同源）——自 v1 lib/agc.mjs 迁移 */
 async function getAgcToken({ clientId, clientSecret }) {
-	const json = await (await fetch("https://connect-api.cloud.huawei.com/api/oauth2/v1/token", {
+	const res = await fetch("https://connect-api.cloud.huawei.com/api/oauth2/v1/token", {
 		method: "POST",
 		headers: { "Content-Type": "application/json" },
 		body: JSON.stringify({
@@ -567,7 +673,14 @@ async function getAgcToken({ clientId, clientSecret }) {
 			client_secret: clientSecret
 		}),
 		signal: AbortSignal.timeout(3e4)
-	})).json();
+	});
+	const text = await res.text();
+	let json;
+	try {
+		json = JSON.parse(text);
+	} catch {
+		throw new Error(`AGC token 接口返回非 JSON（HTTP ${res.status}）: ${text.slice(0, 200)}`);
+	}
 	if (!json.access_token) {
 		const desc = json.error_description ?? json.ret?.msg ?? json.error ?? JSON.stringify(json).slice(0, 200);
 		throw new Error(`AGC 获取 token 失败: ${desc}（检查 client_id/client_secret）`);
@@ -752,6 +865,7 @@ var HuaweiAndroidChannel = class {
 			if (remarkLen < 10 || remarkLen > 300) throw new Error(`华为提审备注（remark）长度需在 10-300 字之间，当前 ${remarkLen} 字`);
 		}
 		if (ctx.updateDescription !== void 0 && [...ctx.updateDescription].length > 500) throw new Error(`华为更新说明（newFeatures）不能超过 500 字符，当前 ${[...ctx.updateDescription].length} 字符`);
+		if (ctx.releaseTime && !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/.test(ctx.releaseTime)) throw new Error(`华为 releaseTime 格式异常（需 RFC3339 带时区，如 2026-06-20T10:00:00+08:00）: ${ctx.releaseTime}`);
 		const { headers } = await this.authHeaders(ctx);
 		if (ctx.updateDescription) try {
 			await hwJson(`${BASE$1}/publish/v2/app-language-info?appId=${encodeURIComponent(appId)}`, {
@@ -970,6 +1084,11 @@ var XiaomiChannel = class {
 		scheduled: false,
 		status: true
 	};
+	/** 平台错误码 → 人话（result 码：依据为本仓测试已固化的真实失败路径文案） */
+	errorHints = {
+		"401": "签名无效或账号无该包名权限（检查 MI_CLIENT_SECRET 与 /dev/query 权限）",
+		"1005": "push SIG 校验失败（检查证书公钥与密码是否匹配）"
+	};
 	async plan(_ctx) {
 		return {
 			channel: this.id,
@@ -1051,8 +1170,8 @@ var XiaomiChannel = class {
 		const form = new FormData();
 		form.append("RequestData", requestJson);
 		form.append("SIG", sig);
-		form.append("apk", new Blob([fs.readFileSync(ctx.artifactPath)]), fileName);
-		form.append("icon", new Blob([fs.readFileSync(iconPath)]), path.basename(iconPath));
+		form.append("apk", await fileBlob(ctx.artifactPath), fileName);
+		form.append("icon", await fileBlob(iconPath), path.basename(iconPath));
 		const res = await fetch(`${MI_API_BASE}/dev/push`, {
 			method: "POST",
 			body: form,
@@ -1375,7 +1494,7 @@ var OppoChannel = class {
 		const form = new FormData();
 		form.append("type", "apk");
 		form.append("sign", sign);
-		form.append("file", new Blob([fs.readFileSync(ctx.artifactPath)]), fileName);
+		form.append("file", await fileBlob(ctx.artifactPath), fileName);
 		const upRes = await fetch(uploadUrl, {
 			method: "POST",
 			body: form,
@@ -1444,7 +1563,7 @@ var OppoChannel = class {
 		ctx.emit({
 			type: "phase",
 			phase: "done",
-			message: `已提交（${JSON.stringify(upd.data ?? {}).slice(0, 120)}）`
+			message: `已提交（versionCode=${versionCode}）`
 		});
 		return {
 			ok: true,
@@ -1670,7 +1789,7 @@ var VivoChannel = class {
 		params.sign = hmacSign(accessSecret, params);
 		const form = new FormData();
 		for (const [k, v] of Object.entries(params)) form.append(k, v);
-		form.append("file", new Blob([fs.readFileSync(ctx.artifactPath)]), fileName);
+		form.append("file", await fileBlob(ctx.artifactPath), fileName);
 		const upRes = await fetch(API_BASE$2, {
 			method: "POST",
 			body: form,
@@ -1925,7 +2044,7 @@ var HonorChannel = class {
 			message: `上传 ${fileName}（${formatSize(fileSize)}）`
 		});
 		const form = new FormData();
-		form.append("file", new Blob([fs.readFileSync(ctx.artifactPath)]), fileName);
+		form.append("file", await fileBlob(ctx.artifactPath), fileName);
 		const upRes = await fetch(uploadUrl, {
 			method: "POST",
 			headers: { Authorization: `Bearer ${token}` },
@@ -2117,6 +2236,8 @@ var YybChannel = class {
 		scheduled: true,
 		status: true
 	};
+	/** 平台错误码 → 人话（ret 码：依据为本仓测试已固化的真实失败路径） */
+	errorHints = { "10010": "应用不存在（检查 YYB_APP_ID 与 user_id 是否匹配该应用）" };
 	/** stage 产物暂存（serial_number + md5），submit 按 appId 取回 */
 	staged = /* @__PURE__ */ new Map();
 	required(ctx, key, where) {
@@ -2205,8 +2326,17 @@ var YybChannel = class {
 	}
 	async submit(ctx) {
 		const { userId, accessSecret, appId, pkgName } = this.creds(ctx);
-		const stagedInfo = this.staged.get(appId);
-		if (!stagedInfo) throw new Error("应用宝渠道缺少上传流水号（stage 未执行，serial_number/md5 不可用）");
+		let stagedInfo = this.staged.get(appId);
+		if (!stagedInfo) {
+			ctx.emit({
+				type: "warn",
+				message: "无本进程 stage 记录（--skip-stage 跨进程），重新上传当前包后提审"
+			});
+			const r = await this.stage(ctx);
+			if (!r.ok) throw new Error(`应用宝重新上传失败: ${r.error ?? "未知错误"}`);
+			stagedInfo = this.staged.get(appId);
+			if (!stagedInfo) throw new Error("应用宝重新上传后仍缺少流水号（内部状态异常）");
+		}
 		ctx.emit({
 			type: "phase",
 			phase: "submit"
@@ -2232,14 +2362,14 @@ var YybChannel = class {
 			businessParams["deploy_type"] = "2";
 			businessParams["deploy_time"] = String(deployTime);
 		} else businessParams["deploy_type"] = "1";
-		const submit = await yybApi("/update_app", {
+		await yybApi("/update_app", {
 			userId,
 			accessSecret
 		}, businessParams);
 		ctx.emit({
 			type: "phase",
 			phase: "done",
-			message: `已提交审核（${JSON.stringify(submit).slice(0, 120)}）`
+			message: `已提交审核（流水号 ${stagedInfo.serialNumber}）`
 		});
 		return {
 			ok: true,
@@ -2319,7 +2449,10 @@ const COMPILE_POLL_MS = 15e3;
 const APP_TEST_BASE = "https://connect-api.cloud.huawei.com/api/app-test/v1";
 /** AGC JSON API 封装：判 ret.code !== 0 抛错 —— v1 agc.mjs agcJson 原样 */
 async function agcJson(url, init, context) {
-	const res = await fetch(url, init);
+	const res = await fetch(url, {
+		...init,
+		signal: init.signal ?? AbortSignal.timeout(6e4)
+	});
 	let json;
 	try {
 		json = await res.json();
@@ -2443,8 +2576,9 @@ var AgcHarmonyChannel = class {
 			ref: packageId || objectId
 		};
 	}
-	/** submit = v1 releaseHarmonyApp 完整链路：上传+绑定+文案 → 等编译轮询 → 提审（带重试） */
-	async submit(ctx) {
+	/** submit = v1 releaseHarmonyApp 完整链路：上传+绑定+文案 → 等编译轮询 → 提审（带重试）。
+	*  stagedRef = stage() 返回的 packageId：包已在草稿区，跳过重传直接等编译+提审（.app 常为数百 MB~GB，双倍上传不可接受） */
+	async submit(ctx, stagedRef) {
 		if (ctx.target.releaseType === "6") return {
 			ok: false,
 			error: "AGC 测试发布（releaseType=6）的自动提审走 beta 配置 test['agc'].submit=true（上传绑定后自动提交测试版本审核）"
@@ -2456,7 +2590,13 @@ var AgcHarmonyChannel = class {
 			phase: "auth",
 			message: "token 获取成功"
 		});
-		const { packageId } = await this.uploadFormal(ctx, appId, headers);
+		let packageId = stagedRef;
+		if (packageId) ctx.emit({
+			type: "phase",
+			phase: "upload",
+			message: `复用 stage 已上传的软件包（pkgId: ${packageId}，跳过重传）`
+		});
+		else ({packageId} = await this.uploadFormal(ctx, appId, headers));
 		if (packageId) await this.awaitCompile(ctx, appId, packageId, headers);
 		if (!ctx.updateDescription) ctx.emit({
 			type: "warn",
@@ -2567,7 +2707,8 @@ var AgcHarmonyChannel = class {
 		const upRes = await fetch(urlInfo.url, {
 			method,
 			headers: upHeaders,
-			body: fs.readFileSync(ctx.artifactPath),
+			body: Readable.toWeb(fs.createReadStream(ctx.artifactPath)),
+			duplex: "half",
 			signal: AbortSignal.timeout(18e5)
 		});
 		if (![
@@ -2779,10 +2920,13 @@ var AgcHarmonyChannel = class {
 				current: String(current),
 				pageSize: "50"
 			});
-			const res = await fetch(`${APP_TEST_BASE}/test-group/list?${qs}`, { headers: {
-				...headers,
-				appId
-			} });
+			const res = await fetch(`${APP_TEST_BASE}/test-group/list?${qs}`, {
+				headers: {
+					...headers,
+					appId
+				},
+				signal: AbortSignal.timeout(6e4)
+			});
 			if (!res.ok) throw new Error(`AGC 查询测试群组失败 HTTP ${res.status}`);
 			const json = await res.json();
 			if (Number(json.rtnCode) !== 0) throw new Error(`AGC 查询测试群组失败: rtnCode=${json.rtnCode ?? "?"}${json.rtnDesc ? ` ${json.rtnDesc}` : ""}`);
@@ -2870,7 +3014,13 @@ async function ascGet(jwt, apiPath) {
 		headers: { Authorization: `Bearer ${jwt}` },
 		signal: AbortSignal.timeout(3e4)
 	});
-	const json = await res.json();
+	const text = await res.text();
+	let json;
+	try {
+		json = JSON.parse(text);
+	} catch {
+		throw new Error(`ASC API ${apiPath} 返回非 JSON（HTTP ${res.status}）: ${text.slice(0, 300)}`);
+	}
 	if (!res.ok) throw new Error(`ASC API ${apiPath} 失败 HTTP ${res.status}: ${JSON.stringify(json.errors ?? json).slice(0, 300)}`);
 	return json;
 }
@@ -2970,9 +3120,13 @@ var AscChannel = class {
 				issuerId
 			], {
 				cwd,
-				encoding: "utf8"
+				encoding: "utf8",
+				timeout: 18e5
 			});
-			if (r.error) throw new Error(`无法执行 xcrun: ${r.error.message}（altool 需 macOS + Xcode）`);
+			if (r.error) {
+				if ("code" in r.error && r.error.code === "ETIMEDOUT") throw new Error("xcrun altool 超时（30min）——检查网络/钥匙串/CI 无 TTY 弹窗");
+				throw new Error(`无法执行 xcrun: ${r.error.message}（altool 需 macOS + Xcode）`);
+			}
 			const output = `${r.stdout ?? ""}${r.stderr ?? ""}`.trim().slice(-2e3);
 			if (r.status !== 0) throw new Error(`altool 上传失败（exit ${r.status}）: ${output || "无输出"}`);
 			if (output) ctx.emit({
@@ -3247,6 +3401,8 @@ var GooglePlayChannel = class {
 		scheduled: false,
 		status: true
 	};
+	/** 平台错误码 → 人话（HTTP 状态：依据为本仓测试已固化的失败路径） */
+	errorHints = { "403": "权限不足（检查 Service Account 是否已关联 Play Console 且有发布权限）" };
 	async plan(_ctx) {
 		return {
 			channel: this.id,
@@ -3263,12 +3419,40 @@ var GooglePlayChannel = class {
 			ref: await this.uploadAndAssign(ctx, "internal", void 0)
 		};
 	}
-	async submit(ctx) {
+	async submit(ctx, stagedRef) {
+		const reusedVc = stagedRef?.split(":")[1];
+		if (reusedVc !== void 0 && reusedVc !== "") return {
+			ok: true,
+			ref: await this.assignExisting(ctx, "production", Number(reusedVc))
+		};
 		return {
 			ok: true,
 			ref: await this.uploadAndAssign(ctx, "production", ctx.updateDescription)
 		};
 	}
+	/** 复用 stage 已上传的 versionCode：开新 edit（仍需 auth）→ 部署 production → commit，跳过上传 */
+	async assignExisting(ctx, track, versionCode) {
+		const pkgName = this.requirePkgName(ctx);
+		const token = await getAccessToken(ctx.credentials);
+		ctx.emit({
+			type: "phase",
+			phase: "auth",
+			message: "OAuth2 token 获取成功"
+		});
+		const edit = await apiFetch(`${API_BASE}/${pkgName}/edits`, token, {
+			method: "POST",
+			body: "{}"
+		}, "创建 edit");
+		if (!edit.id) throw new Error(`Google Play 创建 edit 响应缺少 id: ${JSON.stringify(edit).slice(0, 300)}`);
+		const editId = edit.id;
+		ctx.emit({
+			type: "phase",
+			phase: "upload",
+			message: `复用 stage 上传的 versionCode ${versionCode}（跳过重复上传）`
+		});
+		await this.deployAndCommit(ctx, pkgName, token, editId, track, versionCode, ctx.updateDescription);
+		return `${editId}:${versionCode}`;
+	}
 	/** 上传 + 部署到指定轨道 + commit，返回 `editId:versionCode` */
 	async uploadAndAssign(ctx, track, releaseNotes) {
 		const pkgName = this.requirePkgName(ctx);
@@ -3307,6 +3491,15 @@ var GooglePlayChannel = class {
 			type: "progress",
 			detail: `上传成功（versionCode: ${versionCode}）`
 		});
+		return this.deployAndCommit(ctx, pkgName, token, editId, track, versionCode, releaseNotes);
+	}
+	/**
+	* 部署 versionCode 到指定轨道并 commit：
+	* 先 GET 轨道现有 releases 再合并 PUT——目标 release（同 status=completed 配置）追加新 versionCode，
+	* 其余 releases 原样保留（status/userFraction 不变），避免整轨覆盖把旧版本从轨道剔除；
+	* :commit 冒号语法（对拍 apkgo googleplay.go 权威；对 production 含提交审核语义，internal 即生效）
+	*/
+	async deployAndCommit(ctx, pkgName, token, editId, track, versionCode, releaseNotes) {
 		const releases = [...(await apiFetch(`${API_BASE}/${pkgName}/edits/${editId}/tracks/${track}`, token, { method: "GET" }, `读取 ${track} 轨道现有 releases`)).releases ?? []];
 		const release = {
 			versionCodes: [versionCode],
@@ -3374,6 +3567,11 @@ var GooglePlayChannel = class {
 };
 //#endregion
 //#region src/pipeline.ts
+/**
+* 发布编排引擎：构建计划 → 确认协议 → 并发执行 → 汇总。
+* headless：确认通过注入的 confirm 回调完成（CLI 用 clack/弹窗），core 不碰终端。
+* 插件：可选 PluginHost，在 plan/stage/submit 生命周期触发钩子（可拦截可修改）。
+*/
 async function runLimited(items, limit, fn) {
 	const queue = [...items];
 	const workers = Array.from({ length: Math.min(limit, items.length) }, async () => {
@@ -3381,6 +3579,14 @@ async function runLimited(items, limit, fn) {
 	});
 	await Promise.all(workers);
 }
+/** 错误消息（带一层 cause 解包：fetch 网络层的真实原因如 NotReadableError 藏在 cause 里） */
+function errText(e) {
+	if (e instanceof Error) {
+		const cause = e.cause instanceof Error ? `（${e.cause.message}）` : "";
+		return `${e.message}${cause}`;
+	}
+	return String(e);
+}
 /** stage 阶段：并发传包到各渠道草稿（不提审）；'stage:before' 返回 false 跳过该渠道 */
 async function runStage(input) {
 	const plugins = input.plugins;
@@ -3415,7 +3621,8 @@ async function runStage(input) {
 				channel: channel.id,
 				ok: r.ok,
 				ref: r.ref,
-				error: r.error
+				error: r.error,
+				artifactPath: effectiveCtx.artifactPath
 			});
 			const plan = await safePlan(channel, effectiveCtx);
 			summary.push({
@@ -3438,7 +3645,7 @@ async function runStage(input) {
 				channel: channel.id,
 				label: channel.label,
 				ok: false,
-				stageError: e.message,
+				stageError: errText(e),
 				plan
 			});
 			input.historySink?.({
@@ -3497,12 +3704,13 @@ async function runSubmit(input, options) {
 						label: channel.label,
 						ok: false,
 						submitError: "被插件跳过",
-						plan: planFor(plans, basePlans, channel.id)
+						plan: planFor(plans, basePlans, channel.id, ctx.artifactPath)
 					});
 					return;
 				}
 				effectiveCtx = r.value;
 			}
+			let stagedRef;
 			if (!options.skipStage && channel.capabilities.stage) {
 				const stageResult = await channel.stage(effectiveCtx);
 				if (!stageResult.ok) {
@@ -3511,7 +3719,7 @@ async function runSubmit(input, options) {
 						label: channel.label,
 						ok: false,
 						stageError: stageResult.error,
-						plan: planFor(plans, basePlans, channel.id)
+						plan: planFor(plans, basePlans, channel.id, ctx.artifactPath)
 					});
 					input.historySink?.({
 						channel: channel.id,
@@ -3521,6 +3729,7 @@ async function runSubmit(input, options) {
 					});
 					return;
 				}
+				stagedRef = stageResult.ref;
 				input.historySink?.({
 					channel: channel.id,
 					action: "stage",
@@ -3528,14 +3737,23 @@ async function runSubmit(input, options) {
 					ref: stageResult.ref,
 					artifactVersion: plans.find((p) => p.channel === channel.id)?.artifactVersion || void 0
 				});
+				if (plugins) await plugins.broadcast("stage:after", {
+					channel: channel.id,
+					cwd: input.cwd
+				}, {
+					channel: channel.id,
+					ok: true,
+					ref: stageResult.ref,
+					artifactPath: effectiveCtx.artifactPath
+				});
 			}
-			const r = await channel.submit(effectiveCtx);
+			const r = await channel.submit(effectiveCtx, stagedRef);
 			summary.push({
 				channel: channel.id,
 				label: channel.label,
 				ok: r.ok,
 				submitError: r.error,
-				plan: planFor(plans, basePlans, channel.id)
+				plan: planFor(plans, basePlans, channel.id, ctx.artifactPath)
 			});
 			input.historySink?.({
 				channel: channel.id,
@@ -3549,8 +3767,8 @@ async function runSubmit(input, options) {
 				channel: channel.id,
 				label: channel.label,
 				ok: false,
-				submitError: e.message,
-				plan: planFor(plans, basePlans, channel.id)
+				submitError: errText(e),
+				plan: planFor(plans, basePlans, channel.id, ctx.artifactPath)
 			});
 			input.historySink?.({
 				channel: channel.id,
@@ -3573,22 +3791,189 @@ async function safePlan(channel, ctx) {
 	try {
 		return await channel.plan(ctx);
 	} catch {
-		return fallbackPlan(channel.id);
+		return fallbackPlan(channel.id, ctx.artifactPath);
 	}
 }
-/** plan 失败/被插件删除时的兜底条目（保 summary.plan 非可选契约） */
-function fallbackPlan(channelId) {
+/** 按产物扩展名推断平台（兜底条目用）：.ipa→ios，.hap→harmony，.apk/.aab 及其余→android */
+function platformOfArtifact(artifactPath) {
+	const ext = path.extname(artifactPath).toLowerCase();
+	if (ext === ".ipa") return "ios";
+	if (ext === ".hap") return "harmony";
+	return "android";
+}
+/** plan 失败/被插件删除时的兜底条目（保 summary.plan 非可选契约；平台按产物推断不再硬编码 android） */
+function fallbackPlan(channelId, artifactPath) {
 	return {
 		channel: channelId,
-		platform: "android",
+		platform: platformOfArtifact(artifactPath),
 		artifactVersion: "",
 		action: "stage+submit",
 		afterApproval: "auto-publish"
 	};
 }
 /** 汇总条目取计划：plan:before 改写后的 plans 优先，被插件删除时回退改写前快照，永不返回 undefined */
-function planFor(plans, base, id) {
-	return plans.find((p) => p.channel === id) ?? base.get(id) ?? fallbackPlan(id);
+function planFor(plans, base, id, artifactPath) {
+	return plans.find((p) => p.channel === id) ?? base.get(id) ?? fallbackPlan(id, artifactPath);
+}
+//#endregion
+//#region src/version/git.ts
+/**
+* git 只读/写小助手（bump 编排与推断共用）。
+* spawnSync + 超时；失败返回 ok:false 由调用方决定语义，不在此抛。
+*/
+function git(cwd, args) {
+	const r = spawnSync("git", args, {
+		cwd,
+		encoding: "utf8",
+		timeout: 6e4
+	});
+	return {
+		ok: !r.error && r.status === 0,
+		stdout: (r.stdout ?? "").trim(),
+		stderr: (r.stderr ?? "").trim()
+	};
+}
+function isGitRepo(cwd) {
+	return git(cwd, ["rev-parse", "--is-inside-work-tree"]).stdout === "true";
+}
+/** 宽松 semver 解析（可选 v/前缀，如 v4.1.0 / 4.1.0-beta.3 / release-4.1.0 里取 semver 部分） */
+function looseSemver(tag) {
+	const direct = semver.valid(tag);
+	if (direct) return direct;
+	const m = /(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)/.exec(tag);
+	return m ? semver.valid(m[1]) ?? void 0 : void 0;
+}
+/**
+* 最新 semver tag（按版本序取最大，非创建时间——修复补打旧版本 tag 的场景更稳）。
+* 无 tag / 非 git 仓库返回 undefined。
+*/
+function latestSemverTag(cwd) {
+	const r = git(cwd, ["tag", "-l"]);
+	if (!r.ok) return void 0;
+	let best;
+	for (const raw of r.stdout.split("\n")) {
+		const t = raw.trim();
+		if (!t) continue;
+		const v = looseSemver(t);
+		if (!v) continue;
+		if (!best || semver.gt(v, best.v)) best = {
+			raw: t,
+			v
+		};
+	}
+	return best?.raw;
+}
+/** 锚点 tag..HEAD 的完整 commit messages（%B 含 footer，NUL 分隔——body 内建换行安全） */
+function commitsSince(cwd, ref) {
+	const r = git(cwd, [
+		"log",
+		ref ? `${ref}..HEAD` : "HEAD",
+		"--format=%B%x00",
+		"--no-merges"
+	]);
+	if (!r.ok) return [];
+	return r.stdout.split("\0").map((m) => m.trim()).filter(Boolean);
+}
+/** 工作区状态（--porcelain）。注意：不走通用 git()——其 stdout.trim() 会剥掉首行前导空格，
+*  破坏 porcelain 的两列状态位（" M file" → "M file"），此处保留原始行仅去行尾。 */
+function statusShort(cwd) {
+	const r = spawnSync("git", ["status", "--porcelain"], {
+		cwd,
+		encoding: "utf8",
+		timeout: 3e4
+	});
+	if (r.error || r.status !== 0) return [];
+	return (r.stdout ?? "").split("\n").map((l) => l.trimEnd()).filter(Boolean);
+}
+/**
+* release 分发成功后补 tag（tag = 实际已发布的正式版本；beta 不打 tag，追溯走 history）。
+* - tag 已存在（多端发布，前一端已打）→ 跳过
+* - dryRun / 无版本 / 非 git 仓库 → 不动、不炸（tag 失败不阻断发布主流程）
+*/
+function tagReleaseVersion(cwd, version, opts = {}) {
+	if (!version) return {
+		tagged: false,
+		reason: "无版本"
+	};
+	if (opts.dryRun) return {
+		tagged: false,
+		reason: "dry-run"
+	};
+	const tag = `v${version}`;
+	if (spawnSync("git", [
+		"rev-parse",
+		"-q",
+		"--verify",
+		`refs/tags/${tag}`
+	], {
+		cwd,
+		encoding: "utf8"
+	}).status === 0) return {
+		tagged: false,
+		reason: `tag ${tag} 已存在（前一端已发布）`
+	};
+	const r = spawnSync("git", ["tag", tag], {
+		cwd,
+		encoding: "utf8"
+	});
+	if (r.status !== 0) return {
+		tagged: false,
+		reason: `tag ${tag} 创建失败：${r.stderr.trim()}`
+	};
+	return { tagged: true };
+}
+//#endregion
+//#region src/update.ts
+/**
+* 热更能力契约：applift 的第三维扩展（framework × channel 之外的 update 维度）。
+*
+* provider 与 framework 绑定（如 react-native-update 只服务 RN 工程），由插件经
+* 'update:register' 注册；beta/release 管线的投递路由（热更 vs 原生包）消费 judge 结果，
+* 只做推荐与证据展示，最终投递方式由用户在确认界面拍板（CI 非交互时 uncertain 即中止）。
+*/
+/**
+* 投递路由：按当前 framework 匹配 provider 并执行判定。
+* - 无 provider / 无匹配 → null（走原生包路径，原始行为不受影响）
+* - 多个 provider 匹配同一 framework → 配置错误（一个框架一个热更实现）
+* 结论是推荐值：最终投递方式由用户在确认界面拍板，CI 非交互时 uncertain 中止
+*/
+async function routeDelivery(providers, ctx, diff, platform) {
+	const matched = providers.filter((p) => p.frameworks.includes(ctx.framework.id) && (!platform || !p.platforms || p.platforms.includes(platform)));
+	if (matched.length === 0) return null;
+	if (matched.length > 1) throw new Error(`多个热更 provider 匹配 framework「${ctx.framework.id}」：${matched.map((p) => p.id).join(", ")}——一个框架只应有一个热更实现`);
+	const provider = matched[0];
+	return {
+		provider,
+		judgement: await provider.judge(diff, ctx)
+	};
+}
+/**
+* 收集上个发版锚点（最新 semver tag）到工作区的变更文件列表。
+* 含未提交改动与未跟踪文件（pushy bundle 打包的是工作区内容，判定口径必须一致）。
+* 无锚点 / 非 git 仓库 → null（调用方按 uncertain 处理，不猜）。
+*/
+async function collectReleaseDiff(cwd) {
+	const anchor = latestSemverTag(cwd);
+	if (!anchor) return null;
+	const r = spawnSync("git", [
+		"diff",
+		"--name-only",
+		anchor
+	], {
+		cwd,
+		encoding: "utf8"
+	});
+	const untracked = spawnSync("git", [
+		"ls-files",
+		"--others",
+		"--exclude-standard"
+	], {
+		cwd,
+		encoding: "utf8"
+	});
+	if (r.status !== 0 || untracked.status !== 0) return null;
+	const files = [...r.stdout.split("\n"), ...untracked.stdout.split("\n")].map((l) => l.trim());
+	return [...new Set(files)].filter(Boolean);
 }
 //#endregion
 //#region src/plugin.ts
@@ -3599,6 +3984,8 @@ var PluginHost = class {
 	}
 	/**
 	* 顺序执行某钩子；支持「链式替换」（返回对象则替换后继续传给下一插件）与「拦截」（返回 false 立即中止）。
+	* 信任边界：返回值按 T 强转、不做形状校验（vite 同款取舍）——插件作者自负其责，
+	* 坏形状会在后续消费点显式抛错，宿主不代为静默兜底。
 	* @returns {[被拦截?, 最终值]} false 表示被某插件拦截
 	*/
 	async apply(hook, value, ctx) {
@@ -3635,403 +4022,6 @@ function resolvePlugins(userConfig) {
 	return (userConfig.plugins ?? []).map((p) => typeof p === "function" ? p() : p);
 }
 //#endregion
-//#region src/framework.ts
-/**
-* 框架适配器：让 applift 框架无关（RN / Flutter / 原生安卓 / 原生 iOS / 原生鸿蒙）。
-* 探测规则 + 产物 pattern + 缺省构建命令；插件可用 'channel:register' 旁路注册自定义 FrameworkAdapter。
-*/
-/** 一层子目录列表（探测用，跳过隐藏目录与 node_modules/Pods） */
-function subdirs(cwd, depth) {
-	if (depth <= 0) return [];
-	const out = [];
-	let names;
-	try {
-		names = fs.readdirSync(cwd, { withFileTypes: true });
-	} catch {
-		return [];
-	}
-	for (const name of names) {
-		if (!name.isDirectory() || name.name.startsWith(".") || name.name === "node_modules" || name.name === "Pods") continue;
-		const p = path.join(cwd, name.name);
-		out.push(p, ...subdirs(p, depth - 1));
-	}
-	return out;
-}
-/** package.json 读取（容错） */
-function readJson(filePath) {
-	try {
-		return JSON.parse(fs.readFileSync(filePath, "utf8"));
-	} catch {
-		return null;
-	}
-}
-function deps(pkg) {
-	if (!pkg) return {};
-	return {
-		...pkg.dependencies,
-		...pkg.devDependencies
-	};
-}
-const rnAdapter = {
-	id: "rn",
-	label: "React Native",
-	detect(cwd) {
-		return "react-native" in deps(readJson(path.join(cwd, "package.json")));
-	},
-	/** Expo 项目（依赖 expo 包）：同走 RN 产物路径（prebuild 生成原生工程），label 区分展示 */
-	expoAwareLabel(cwd) {
-		return "expo" in deps(readJson(path.join(cwd, "package.json"))) ? "Expo (React Native)" : "React Native";
-	},
-	artifactPatterns(platform) {
-		if (platform === "android") return ["android/app/build/outputs/apk/release/*-release.apk"];
-		if (platform === "ios") return ["build/ios/ipa/*.ipa"];
-		return [
-			"harmony/entry/build/default/outputs/**/entry-*-signed.hap",
-			"harmony/entry/build/default/outputs/**/entry-*.app",
-			"harmony/build/outputs/**/*.app",
-			"build/outputs/**/*.app"
-		];
-	},
-	buildCommand(platform) {
-		if (platform === "android") return [
-			"npm",
-			"run",
-			"build:test",
-			"--",
-			"--platform",
-			"android"
-		];
-		if (platform === "ios") return null;
-		return [
-			"npm",
-			"run",
-			"build:test",
-			"--",
-			"--platform",
-			"harmony"
-		];
-	}
-};
-const flutterAdapter = {
-	id: "flutter",
-	label: "Flutter",
-	detect(cwd) {
-		if (readJson(path.join(cwd, "pubspec.yaml"))) return true;
-		try {
-			const text = fs.readFileSync(path.join(cwd, "pubspec.yaml"), "utf8");
-			return /^sdk:\s*flutter$/m.test(text) || /^name:/m.test(text);
-		} catch {
-			return false;
-		}
-	},
-	artifactPatterns(platform) {
-		if (platform === "android") return ["build/app/outputs/flutter-apk/app-release.apk"];
-		if (platform === "ios") return ["build/ios/ipa/*.ipa"];
-		return [
-			"build/**/outputs/**/*-signed.hap",
-			"harmony/entry/build/**/outputs/**/*-signed.hap",
-			"ohos/entry/build/**/outputs/**/*-signed.hap",
-			"build/**/outputs/**/*.app"
-		];
-	},
-	buildCommand(platform) {
-		if (platform === "android") return [
-			"flutter",
-			"build",
-			"apk",
-			"--release"
-		];
-		if (platform === "ios") return [
-			"flutter",
-			"build",
-			"ipa",
-			"--release"
-		];
-		return [
-			"flutter",
-			"build",
-			"hap",
-			"--release"
-		];
-	}
-};
-const nativeAndroidAdapter = {
-	id: "native-android",
-	label: "原生 Android",
-	detect(cwd) {
-		if (rnAdapter.detect(cwd)) return false;
-		return fs.existsSync(path.join(cwd, "settings.gradle")) || fs.existsSync(path.join(cwd, "settings.gradle.kts"));
-	},
-	artifactPatterns() {
-		return ["app/build/outputs/apk/release/*-release.apk"];
-	},
-	buildCommand() {
-		return ["./gradlew", "assembleRelease"];
-	}
-};
-const nativeIosAdapter = {
-	id: "native-ios",
-	label: "原生 iOS",
-	detect(cwd) {
-		if (rnAdapter.detect(cwd)) return false;
-		for (const dir of [cwd, ...subdirs(cwd, 1)]) {
-			let entries;
-			try {
-				entries = fs.readdirSync(dir);
-			} catch {
-				continue;
-			}
-			if (entries.some((f) => String(f).endsWith(".xcodeproj") || String(f).endsWith(".xcworkspace"))) return true;
-		}
-		return false;
-	},
-	artifactPatterns() {
-		return ["build/**/*.ipa"];
-	},
-	buildCommand() {
-		return null;
-	}
-};
-const nativeHarmonyAdapter = {
-	id: "native-harmony",
-	label: "原生鸿蒙 (ArkTS)",
-	detect(cwd) {
-		return fs.existsSync(path.join(cwd, "oh-package.json5")) || fs.existsSync(path.join(cwd, "harmony/oh-package.json5"));
-	},
-	artifactPatterns() {
-		return [
-			"entry/build/default/outputs/**/entry-*-signed.hap",
-			"entry/build/default/outputs/**/entry-*.app",
-			"harmony/entry/build/default/outputs/**/*-signed.hap",
-			"build/outputs/**/*.app",
-			"harmony/build/outputs/**/*.app",
-			"ohos/build/outputs/**/*.app"
-		];
-	},
-	buildCommand() {
-		return [
-			"hvigorw",
-			"--mode",
-			"module",
-			"-p",
-			"module=entry@default",
-			"-p",
-			"product=default",
-			"-p",
-			"buildMode=release",
-			"assembleHap",
-			"--no-daemon"
-		];
-	}
-};
-const electronAdapter = {
-	id: "electron",
-	label: "Electron",
-	detect(cwd) {
-		return "electron" in deps(readJson(path.join(cwd, "package.json")));
-	},
-	artifactPatterns(platform) {
-		if (platform === "windows") return [
-			"dist/*.exe",
-			"dist/**/*.exe",
-			"out/make/*.exe"
-		];
-		if (platform === "macos") return [
-			"dist/*.dmg",
-			"dist/**/*.dmg",
-			"out/make/*.dmg"
-		];
-		if (platform === "linux") return [
-			"dist/*.AppImage",
-			"dist/**/*.AppImage",
-			"out/make/*.AppImage"
-		];
-		return [];
-	},
-	buildCommand(platform) {
-		if (platform === "windows") return [
-			"npx",
-			"electron-forge",
-			"make",
-			"--platform",
-			"win32"
-		];
-		if (platform === "macos") return [
-			"npx",
-			"electron-forge",
-			"make",
-			"--platform",
-			"darwin"
-		];
-		return [
-			"npx",
-			"electron-forge",
-			"make",
-			"--platform",
-			"linux"
-		];
-	}
-};
-const tauriAdapter = {
-	id: "tauri",
-	label: "Tauri",
-	detect(cwd) {
-		return "@tauri-apps/cli" in deps(readJson(path.join(cwd, "package.json"))) || fs.existsSync(path.join(cwd, "src-tauri"));
-	},
-	artifactPatterns(platform) {
-		if (platform === "windows") return ["src-tauri/target/release/bundle/nsis/*.exe", "src-tauri/target/release/bundle/msi/*.msi"];
-		if (platform === "macos") return ["src-tauri/target/release/bundle/dmg/*.dmg", "src-tauri/target/release/bundle/macos/*.app"];
-		if (platform === "linux") return ["src-tauri/target/release/bundle/deb/*.deb", "src-tauri/target/release/bundle/appimage/*.AppImage"];
-		return [];
-	},
-	buildCommand(platform) {
-		if (platform === "macos") return [
-			"npx",
-			"tauri",
-			"build"
-		];
-		return [
-			"npx",
-			"tauri",
-			"build"
-		];
-	}
-};
-const BUILTIN_ADAPTERS = [
-	rnAdapter,
-	flutterAdapter,
-	electronAdapter,
-	tauriAdapter,
-	nativeAndroidAdapter,
-	nativeIosAdapter,
-	nativeHarmonyAdapter
-];
-/** 探测项目框架（可注入额外适配器，插件自定义框架的扩展点） */
-function detectFramework(cwd, extra = []) {
-	for (const adapter of [...extra, ...BUILTIN_ADAPTERS]) try {
-		if (adapter.detect(cwd)) return adapter;
-	} catch {}
-	return null;
-}
-/** 按 pattern 扫描产物（支持 ** 与 * 简单通配，返回绝对路径，多产物按 mtime 新者在前） */
-function findArtifacts(cwd, patterns) {
-	const byPath = /* @__PURE__ */ new Map();
-	for (const pattern of patterns) for (const p of globWalk(path.resolve(cwd), pattern.split("/"))) {
-		if (byPath.has(p)) continue;
-		try {
-			byPath.set(p, fs.statSync(p).mtimeMs);
-		} catch {}
-	}
-	return [...byPath].sort((a, b) => b[1] - a[1]).map(([p]) => p);
-}
-/** 文本读取（容错：不存在/不可读返回 null，绝不抛；detectBundleIds 各源共用） */
-function readText$1(filePath) {
-	try {
-		return fs.readFileSync(filePath, "utf8");
-	} catch {
-		return null;
-	}
-}
-/** 从 JSON 对象按路径取非空字符串（任一层缺失/非字符串返回 undefined） */
-function pickString(obj, ...keys) {
-	let cur = obj;
-	for (const k of keys) {
-		if (cur === null || typeof cur !== "object") return void 0;
-		cur = cur[k];
-	}
-	return typeof cur === "string" && cur.trim() ? cur.trim() : void 0;
-}
-/** 原生安卓 applicationId（groovy/kts 两种赋值语法；app/ 与 android/app/ 两处布局；不中返回 undefined） */
-function gradleApplicationId(cwd) {
-	const candidates = [
-		path.join(cwd, "app", "build.gradle"),
-		path.join(cwd, "app", "build.gradle.kts"),
-		path.join(cwd, "android", "app", "build.gradle"),
-		path.join(cwd, "android", "app", "build.gradle.kts")
-	];
-	for (const file of candidates) {
-		const text = readText$1(file);
-		if (!text) continue;
-		const m = /(?:^|\s)applicationId\s*[=:]?\s*["']([^"'\s]+)["']/.exec(text);
-		if (m?.[1]) return m[1];
-	}
-}
-/** 鸿蒙 AppScope/app.json5 的 bundleName（json5 允许注释/尾逗号，正则取值而非 JSON 解析） */
-function appJson5BundleName(file) {
-	const text = readText$1(file);
-	return (text && /"bundleName"\s*:\s*"([^"]+)"/.exec(text))?.[1];
-}
-/** 两层子目录内找首个 *.xcodeproj：pbxproj 第一个非变量（含 $ 的 $(...) 与 ${...}）的 PRODUCT_BUNDLE_IDENTIFIER + 工程名（Pods 已被 subdirs 排除） */
-function findPbxproj(cwd) {
-	for (const dir of [cwd, ...subdirs(cwd, 2)]) {
-		let entries;
-		try {
-			entries = fs.readdirSync(dir, { withFileTypes: true });
-		} catch {
-			continue;
-		}
-		const projects = entries.filter((e) => e.isDirectory() && e.name.endsWith(".xcodeproj")).map((e) => e.name).sort();
-		for (const name of projects) {
-			const pbx = readText$1(path.join(dir, name, "project.pbxproj"));
-			if (!pbx) continue;
-			for (const m of pbx.matchAll(/PRODUCT_BUNDLE_IDENTIFIER\s*=\s*([^;]+);/g)) {
-				const value = m[1].trim().replace(/^["']|["']$/g, "");
-				if (value && !value.includes("$")) return {
-					bundleId: value,
-					scheme: name.slice(0, -10)
-				};
-			}
-		}
-	}
-	return null;
-}
-/**
-* 自动推导三端应用标识（项目配置缺省时的兜底，配置可全空）：
-* android：RN app.json android.applicationId > 原生 gradle applicationId；
-* harmony：AppScope/app.json5（根或 harmony/ 下）> RN app.json harmony.bundleName；
-* ios：RN app.json ios.bundleIdentifier > 两层内 xcodeproj 的 PRODUCT_BUNDLE_IDENTIFIER（scheme=工程名）。
-* 容错：文件不存在/正则不中只置 undefined，绝不抛。
-*/
-function detectBundleIds(cwd) {
-	const appJson = readJson(path.join(cwd, "app.json"));
-	const pbx = findPbxproj(cwd);
-	const expo = appJson?.expo ?? null;
-	const expoAndroid = expo ? pickString(expo, "android", "package") : void 0;
-	const expoIos = expo ? pickString(expo, "ios", "bundleIdentifier") : void 0;
-	const expoName = expo && typeof expo.name === "string" ? expo.name : void 0;
-	return {
-		androidPkgName: expoAndroid ?? pickString(appJson, "android", "applicationId") ?? gradleApplicationId(cwd),
-		harmonyBundleName: appJson5BundleName(path.join(cwd, "AppScope", "app.json5")) ?? appJson5BundleName(path.join(cwd, "harmony", "AppScope", "app.json5")) ?? pickString(appJson, "harmony", "bundleName"),
-		iosBundleId: expoIos ?? pickString(appJson, "ios", "bundleIdentifier") ?? pbx?.bundleId,
-		iosScheme: pbx?.scheme ?? expoName
-	};
-}
-/** 极简 glob 目录游走（** 跨层，* 单段），避免引入 minimatch 依赖 */
-function globWalk(dir, segments) {
-	const [head, ...rest] = segments;
-	if (!head) return [dir];
-	if (!fs.existsSync(dir)) return [];
-	if (head === "**") {
-		const out = [];
-		const walkAll = (d) => {
-			out.push(...globWalk(d, rest));
-			for (const name of fs.readdirSync(d, { withFileTypes: true })) {
-				if (!name.isDirectory() || name.name.startsWith(".") || name.name === "node_modules") continue;
-				walkAll(path.join(d, name.name));
-			}
-		};
-		walkAll(dir);
-		return [...new Set(out)];
-	}
-	if (head.includes("*")) {
-		const re = new RegExp(`^${head.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*")}$`);
-		const out = [];
-		for (const name of fs.readdirSync(dir)) if (re.test(name)) out.push(...globWalk(path.join(dir, name), rest));
-		return out;
-	}
-	return globWalk(path.join(dir, head), rest);
-}
-//#endregion
 //#region src/history.ts
 /**
 * 发版历史：~/.applift/history.jsonl，每行一条 JSON（HistoryEntry）。
@@ -4073,438 +4063,26 @@ function readEntries(query = {}, filePath = HISTORY_PATH) {
 //#region src/channels/shared/error-codes.ts
 /**
 * 错误码人话化：消费各渠道自带 errorHints（平台内聚——表与渠道实现同文件）。
+* 网络类故障（AbortSignal 超时/断连/DNS）渠道层不转译，统一在此兜底提示。
 */
+/** 网络故障特征 → 人话提示（命中即返回，按序优先：文件可读性 > 超时 > 网络故障） */
+const NETWORK_HINTS = [
+	[/NotReadableError/i, "产物/图标文件在上传期间被修改或不可读（惰性 Blob 读盘中途失败）：确认构建已完成、无并发进程改动产物，重跑"],
+	[/aborted due to timeout|TimeoutError/i, "请求超时（服务端无响应或网络不稳）：可重跑；大包上传建议在稳定网络环境执行"],
+	[/\b(?:ECONNRESET|ECONNREFUSED|ENOTFOUND|EAI_AGAIN|EPIPE)\b|socket hang up|fetch failed/i, "网络故障（连接被重置/DNS 解析失败等）：检查网络或代理后重跑"]
+];
+/** 码匹配：纯数字码加数字边界（防 1003 误中 11003/10031）；其余按包含匹配 */
+function matchesCode(message, code) {
+	if (/^\d+$/.test(code)) return new RegExp(`(?<!\\d)${code}(?!\\d)`).test(message);
+	return message.includes(code);
+}
 function humanizeError(hints, message) {
+	for (const [re, hint] of NETWORK_HINTS) if (re.test(message)) return `${message}\n  提示: ${hint}`;
 	if (!hints) return message;
-	for (const [code, hint] of Object.entries(hints)) if (message.includes(code)) return `${message}\n  提示: ${hint}`;
+	for (const [code, hint] of Object.entries(hints)) if (matchesCode(message, code)) return `${message}\n  提示: ${hint}`;
 	return message;
 }
 //#endregion
-//#region src/version/project.ts
-/**
-* 工程文件版本读写（可接管模式：版本事实源永远是工程文件，applift 只代读代写）。
-* 只认标准模板形态（AGP/Xcode/DevEco/pubspec/package.json/tauri.conf）；行级改写、
-* 幂等（字段定位 + 写死目标值，不依赖旧值，跑 N 次 diff 不变——qy-driver sync-app-identity 同款模式）。
-* version catalog 引用形态（libs.versions.xxx.get()）读侧识别并标注 problem，不代写。
-*/
-function readText(p) {
-	try {
-		return fs.readFileSync(p, "utf8");
-	} catch {
-		return null;
-	}
-}
-function firstExisting(...paths) {
-	return paths.find((p) => fs.existsSync(p));
-}
-function locateIosProject(dir) {
-	const find = (d) => {
-		try {
-			return fs.readdirSync(d, { withFileTypes: true }).find((e) => e.isDirectory() && e.name.endsWith(".xcodeproj") && !e.name.startsWith(".") && e.name !== "Pods.xcodeproj");
-		} catch {
-			return;
-		}
-	};
-	let xcodeproj = find(dir);
-	let base = dir;
-	if (!xcodeproj) try {
-		const subs = fs.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules" && e.name !== "Pods");
-		for (const s of subs) {
-			xcodeproj = find(path.join(dir, s.name));
-			if (xcodeproj) {
-				base = path.join(dir, s.name);
-				break;
-			}
-		}
-	} catch {}
-	const pbxproj = xcodeproj ? path.join(base, xcodeproj.name, "project.pbxproj") : void 0;
-	const projDir = xcodeproj?.name.replace(/\.xcodeproj$/, "");
-	const plist = projDir && fs.existsSync(path.join(base, projDir, "Info.plist")) ? path.join(base, projDir, "Info.plist") : void 0;
-	return {
-		pbxproj: pbxproj && fs.existsSync(pbxproj) ? pbxproj : void 0,
-		plist
-	};
-}
-function locateVersionFiles(cwd, framework) {
-	const loc = {};
-	const id = framework?.id ?? "";
-	const tryAll = framework === null;
-	if (tryAll || id === "rn" || id === "native-android" || id === "flutter") loc.android = firstExisting(path.join(cwd, "android", "app", "build.gradle.kts"), path.join(cwd, "android", "app", "build.gradle"), path.join(cwd, "app", "build.gradle.kts"), path.join(cwd, "app", "build.gradle"));
-	if (tryAll || id === "rn" || id === "native-ios" || id === "flutter") {
-		const sub = locateIosProject(path.join(cwd, "ios"));
-		const root = sub.pbxproj ? sub : locateIosProject(cwd);
-		loc.ios = root.pbxproj;
-		loc.plist = root.plist;
-	}
-	if (tryAll || id === "rn" || id === "native-harmony" || id === "flutter") loc.harmony = firstExisting(path.join(cwd, "harmony", "AppScope", "app.json5"), path.join(cwd, "AppScope", "app.json5"));
-	if (tryAll || id === "flutter") loc.pubspec = fs.existsSync(path.join(cwd, "pubspec.yaml")) ? path.join(cwd, "pubspec.yaml") : void 0;
-	if (tryAll || id === "rn" || id === "electron") loc.packageJson = fs.existsSync(path.join(cwd, "package.json")) ? path.join(cwd, "package.json") : void 0;
-	if (tryAll || id === "tauri") {
-		loc.tauri = firstExisting(path.join(cwd, "src-tauri", "tauri.conf.json"), path.join(cwd, "src-tauri", "tauri.conf.json5"));
-		loc.packageJson = fs.existsSync(path.join(cwd, "package.json")) ? path.join(cwd, "package.json") : void 0;
-	}
-	if (id === "rn") {
-		const appJson = readText(path.join(cwd, "app.json"));
-		if (appJson && /"expo"\s*:/.test(appJson)) loc.expoAppJson = path.join(cwd, "app.json");
-	}
-	return loc;
-}
-function readGradle(file) {
-	const text = readText(file);
-	if (!text) return {};
-	const out = {};
-	const codeM = /(versionCode(?!Suffix)\s*=?\s*)(\d+)/.exec(text);
-	const nameM = /(versionName(?!Suffix)\s*=?\s*)("[^"]*"|'[^']*'|[\w.+-]+)/.exec(text);
-	if (codeM) out.versionCode = codeM[2];
-	if (nameM) {
-		const nameVal = nameM[2].replace(/^["']|["']$/g, "");
-		if (nameVal.startsWith("libs.versions.")) out.problem = "versionName 走 version catalog 引用（libs.versions.*）：非标准形态，请把版本字段搬回 app/build.gradle(.kts) 字面量";
-		else out.versionName = nameVal;
-	}
-	if (/(versionCode|versionName)\s*=?\s*libs\.versions\./.test(text) && !out.problem) out.problem = "版本字段走 version catalog 引用（libs.versions.*）：非标准形态，请把版本字段搬回 app/build.gradle(.kts) 字面量";
-	return out;
-}
-function readPbxproj(file) {
-	const text = readText(file);
-	if (!text) return {};
-	const names = [...text.matchAll(/MARKETING_VERSION\s*=\s*([^;]+);/g)].map((m) => m[1].trim());
-	return {
-		versionName: names[0],
-		versionCode: /CURRENT_PROJECT_VERSION\s*=\s*([^;]+);/.exec(text)?.[1]?.trim(),
-		problem: new Set(names).size > 1 ? `多 target MARKETING_VERSION 不一致（${[...new Set(names)].join(" / ")}）：读第一个，bump 时将全部同步` : void 0
-	};
-}
-function readPlist(file) {
-	const text = readText(file);
-	if (!text) return {};
-	const name = /<key>CFBundleShortVersionString<\/key>\s*<string>([^<]+)<\/string>/.exec(text)?.[1];
-	const code = /<key>CFBundleVersion<\/key>\s*<string>([^<]+)<\/string>/.exec(text)?.[1];
-	if (name && !name.startsWith("$")) return {
-		versionName: name,
-		versionCode: code
-	};
-	return {};
-}
-function readAppJson5(file) {
-	const text = readText(file);
-	if (!text) return {};
-	return {
-		versionName: /"versionName"\s*:\s*"([^"]+)"/.exec(text)?.[1],
-		versionCode: /"versionCode"\s*:\s*(\d+)/.exec(text)?.[1]
-	};
-}
-function readPubspec(file) {
-	const text = readText(file);
-	if (!text) return {};
-	const m = /^version:\s*(\S+)(?:\s*#.*)?$/m.exec(text);
-	if (!m) return {};
-	const [name, code] = m[1].split("+");
-	return {
-		versionName: name,
-		versionCode: code
-	};
-}
-function readJsonVersionKey(file) {
-	const text = readText(file);
-	if (!text) return {};
-	let best;
-	for (const m of text.matchAll(/^(\s*)"version"\s*:\s*"([^"]+)"\s*,?\s*$/gm)) {
-		const indent = m[1].length;
-		if (!best || indent < best.indent) best = {
-			indent,
-			value: m[2]
-		};
-	}
-	if (best) return { versionName: best.value };
-	try {
-		const obj = JSON.parse(text);
-		if (typeof obj.version === "string") return { versionName: obj.version };
-	} catch {}
-	const flat = /"version"\s*:\s*"([^"]+)"/.exec(text)?.[1];
-	return flat ? { versionName: flat } : {};
-}
-function readExpoAppJson(file) {
-	const text = readText(file);
-	if (!text) return {};
-	return {
-		versionName: /"version"\s*:\s*"([^"]+)"/.exec(text)?.[1],
-		versionCode: /"versionCode"\s*:\s*(\d+)/.exec(text)?.[1] ?? /"buildNumber"\s*:\s*"([^"]+)"/.exec(text)?.[1]
-	};
-}
-/** 各端版本实况（按框架布局；未识别框架时尝试全部标准位置） */
-function readProjectVersions(cwd, framework) {
-	const loc = locateVersionFiles(cwd, framework);
-	const out = [];
-	if (loc.android) out.push({
-		platform: "android",
-		file: loc.android,
-		kind: "gradle",
-		...readGradle(loc.android)
-	});
-	if (loc.ios) out.push({
-		platform: "ios",
-		file: loc.ios,
-		kind: "pbxproj",
-		...readPbxproj(loc.ios)
-	});
-	else if (loc.plist) {
-		const plist = readPlist(loc.plist);
-		if (plist.versionName) out.push({
-			platform: "ios",
-			file: loc.plist,
-			kind: "pbxproj",
-			...plist,
-			problem: "未找到 pbxproj，读 Info.plist 字面量"
-		});
-	}
-	if (loc.harmony) out.push({
-		platform: "harmony",
-		file: loc.harmony,
-		kind: "app-json5",
-		...readAppJson5(loc.harmony)
-	});
-	if (loc.pubspec) out.push({
-		platform: "flutter",
-		file: loc.pubspec,
-		kind: "pubspec",
-		...readPubspec(loc.pubspec)
-	});
-	if (loc.packageJson) out.push({
-		platform: "js",
-		file: loc.packageJson,
-		kind: "package-json",
-		...readJsonVersionKey(loc.packageJson)
-	});
-	if (loc.tauri) out.push({
-		platform: "tauri",
-		file: loc.tauri,
-		kind: "tauri",
-		...readJsonVersionKey(loc.tauri)
-	});
-	if (loc.expoAppJson) out.push({
-		platform: "expo",
-		file: loc.expoAppJson,
-		kind: "expo-app-json",
-		...readExpoAppJson(loc.expoAppJson)
-	});
-	return out;
-}
-/** 指定捕获组替换为 value（其余组原样保留；约定各正则组外无字面量） */
-function replaceGroup(re, text, group, value) {
-	let count = 0;
-	return {
-		text: text.replace(re, (_m, ...groups) => {
-			count++;
-			const g = groups.slice(0, -2);
-			g[group - 1] = value;
-			return g.join("");
-		}),
-		count
-	};
-}
-function writeIfChanged(file, next) {
-	if (readText(file) === next) return false;
-	fs.writeFileSync(file, next, "utf8");
-	return true;
-}
-function writeGradle(file, w) {
-	const text = readText(file);
-	if (!text) throw new Error(`无法读取 ${file}`);
-	if (/version(Code|Name)\s*=?\s*libs\.versions\./.test(text)) throw new Error(`${file} 的版本字段是 version catalog 引用形态：请先改造为字面量（applift 只写标准形态）`);
-	let next = text;
-	const code = replaceGroup(/(versionCode(?!Suffix)\s*=?\s*)(\d+)/g, next, 2, String(w.versionCode));
-	next = code.text;
-	const name = replaceGroup(/(versionName(?!Suffix)\s*=?\s*)("[^"]*"|'[^']*'|[\w.+-]+)/g, next, 2, `"${w.versionName}"`);
-	next = name.text;
-	if (code.count === 0 && name.count === 0) throw new Error(`${file} 未找到 versionCode/versionName 字面量`);
-	return writeIfChanged(file, next);
-}
-function writePbxproj(file, w) {
-	const text = readText(file);
-	if (!text) throw new Error(`无法读取 ${file}`);
-	let next = text;
-	const name = replaceGroup(/(MARKETING_VERSION\s*=\s*)([^;]+)(;)/g, next, 2, w.versionName);
-	next = name.text;
-	const code = replaceGroup(/(CURRENT_PROJECT_VERSION\s*=\s*)([^;]+)(;)/g, next, 2, String(w.versionCode));
-	next = code.text;
-	if (name.count === 0 && code.count === 0) throw new Error(`${file} 未找到 MARKETING_VERSION/CURRENT_PROJECT_VERSION`);
-	return writeIfChanged(file, next);
-}
-function writeAppJson5(file, w) {
-	const text = readText(file);
-	if (!text) throw new Error(`无法读取 ${file}`);
-	let next = text;
-	const name = replaceGroup(/("versionName"\s*:\s*")([^"]+)(")/g, next, 2, w.versionName);
-	next = name.text;
-	const code = replaceGroup(/("versionCode"\s*:\s*)(\d+)/g, next, 2, String(w.versionCode));
-	next = code.text;
-	if (name.count === 0 && code.count === 0) throw new Error(`${file} 未找到 versionName/versionCode`);
-	return writeIfChanged(file, next);
-}
-function writePubspec(file, w) {
-	const text = readText(file);
-	if (!text) throw new Error(`无法读取 ${file}`);
-	if (!/^version:\s*\S+/m.test(text)) throw new Error(`${file} 未找到 version: 行`);
-	return writeIfChanged(file, text.replace(/^version:[^\n#]*?(\s*)(#.*)?$/m, (_m, gap, comment) => `version: ${w.versionName}+${w.versionCode}${comment ? gap ?? " " : ""}${comment ?? ""}`));
-}
-/** JSON 顶层 version 键改写（两遍：先定位最小缩进行，再只改该行——单遍回调在嵌套键
-*  先出现时会把它一并改写，篡改依赖声明）。单行 JSON 回退首个匹配。 */
-function writeJsonVersionKey(file, versionName) {
-	const text = readText(file);
-	if (!text) throw new Error(`无法读取 ${file}`);
-	const lines = text.split("\n");
-	const re = /^(\s*)"version"\s*:\s*"([^"]+)"(\s*,?\s*)$/;
-	let target = -1;
-	let bestIndent = Number.POSITIVE_INFINITY;
-	for (let i = 0; i < lines.length; i++) {
-		const m = re.exec(lines[i]);
-		if (!m) continue;
-		const ind = m[1].length;
-		if (ind < bestIndent) {
-			bestIndent = ind;
-			target = i;
-		}
-	}
-	let next;
-	if (target >= 0) {
-		const m = re.exec(lines[target]);
-		lines[target] = `${m[1]}"version": "${versionName}"${m[3]}`;
-		next = lines.join("\n");
-	} else {
-		let topVersion;
-		try {
-			const obj = JSON.parse(text);
-			if (typeof obj.version === "string") topVersion = obj.version;
-		} catch {}
-		const esc = (topVersion ?? "").replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-		const re1 = topVersion ? new RegExp(`"version"\\s*:\\s*"${esc}"`) : /"version"\s*:\s*"([^"]+)"/;
-		if (!re1.test(text)) throw new Error(`${file} 未找到 "version" 键`);
-		next = text.replace(re1, `"version": "${versionName}"`);
-	}
-	return writeIfChanged(file, next);
-}
-function writeExpoAppJson(file, w) {
-	const text = readText(file);
-	if (!text) throw new Error(`无法读取 ${file}`);
-	const v = replaceGroup(/("version"\s*:\s*")([^"]+)(")/g, text, 2, w.versionName);
-	if (v.count === 0) throw new Error(`${file} 未找到 expo "version" 键`);
-	let next = v.text;
-	next = replaceGroup(/("versionCode"\s*:\s*)(\d+)/g, next, 2, String(w.versionCode)).text;
-	next = replaceGroup(/("buildNumber"\s*:\s*")([^"]+)(")/g, next, 2, String(w.versionCode)).text;
-	return writeIfChanged(file, next);
-}
-/**
-* 写回各端版本（多端 versionName 同步、versionCode 各端独立）。
-* 返回实际改动的文件列表（commit 范围）。problem 端跳过并在返回中列出（不阻断其他端）。
-*/
-function writeProjectVersions(cwd, framework, writes) {
-	const loc = locateVersionFiles(cwd, framework);
-	const changed = [];
-	const skipped = [];
-	const plat = new Map(writes.map((w) => [w.platform, w]));
-	const apply = (file, fn, key) => {
-		if (!file) {
-			const w = plat.get(key);
-			if (w) skipped.push({
-				platform: w.platform,
-				reason: `未找到版本文件（${key}）`
-			});
-			return;
-		}
-		try {
-			if (fn(file)) changed.push(file);
-		} catch (e) {
-			const code = e.code;
-			if (code === "EACCES" || code === "EPERM") throw e;
-			skipped.push({
-				platform: key,
-				reason: e.message
-			});
-		}
-	};
-	if (plat.has("android")) apply(loc.android, (f) => writeGradle(f, plat.get("android")), "android");
-	if (plat.has("ios")) apply(loc.ios, (f) => writePbxproj(f, plat.get("ios")), "ios");
-	if (plat.has("harmony")) apply(loc.harmony, (f) => writeAppJson5(f, plat.get("harmony")), "harmony");
-	if (plat.has("flutter")) apply(loc.pubspec, (f) => writePubspec(f, plat.get("flutter")), "flutter");
-	if (plat.has("js")) apply(loc.packageJson, (f) => writeJsonVersionKey(f, plat.get("js").versionName), "js");
-	if (plat.has("tauri")) apply(loc.tauri, (f) => writeJsonVersionKey(f, plat.get("tauri").versionName), "tauri");
-	if (plat.has("expo")) apply(loc.expoAppJson, (f) => writeExpoAppJson(f, plat.get("expo")), "expo");
-	return {
-		changed: [...new Set(changed)],
-		skipped
-	};
-}
-//#endregion
-//#region src/version/git.ts
-/**
-* git 只读/写小助手（bump 编排与推断共用）。
-* spawnSync + 超时；失败返回 ok:false 由调用方决定语义，不在此抛。
-*/
-function git(cwd, args) {
-	const r = spawnSync("git", args, {
-		cwd,
-		encoding: "utf8",
-		timeout: 6e4
-	});
-	return {
-		ok: !r.error && r.status === 0,
-		stdout: (r.stdout ?? "").trim(),
-		stderr: (r.stderr ?? "").trim()
-	};
-}
-function isGitRepo(cwd) {
-	return git(cwd, ["rev-parse", "--is-inside-work-tree"]).stdout === "true";
-}
-/** 宽松 semver 解析（可选 v/前缀，如 v4.1.0 / 4.1.0-beta.3 / release-4.1.0 里取 semver 部分） */
-function looseSemver(tag) {
-	const direct = semver.valid(tag);
-	if (direct) return direct;
-	const m = /(\d+\.\d+\.\d+(?:[-+][\w.-]+)?)/.exec(tag);
-	return m ? semver.valid(m[1]) ?? void 0 : void 0;
-}
-/**
-* 最新 semver tag（按版本序取最大，非创建时间——修复补打旧版本 tag 的场景更稳）。
-* 无 tag / 非 git 仓库返回 undefined。
-*/
-function latestSemverTag(cwd) {
-	const r = git(cwd, ["tag", "-l"]);
-	if (!r.ok) return void 0;
-	let best;
-	for (const raw of r.stdout.split("\n")) {
-		const t = raw.trim();
-		if (!t) continue;
-		const v = looseSemver(t);
-		if (!v) continue;
-		if (!best || semver.gt(v, best.v)) best = {
-			raw: t,
-			v
-		};
-	}
-	return best?.raw;
-}
-/** 锚点 tag..HEAD 的完整 commit messages（%B 含 footer，NUL 分隔——body 内建换行安全） */
-function commitsSince(cwd, ref) {
-	const r = git(cwd, [
-		"log",
-		ref ? `${ref}..HEAD` : "HEAD",
-		"--format=%B%x00",
-		"--no-merges"
-	]);
-	if (!r.ok) return [];
-	return r.stdout.split("\0").map((m) => m.trim()).filter(Boolean);
-}
-/** 工作区状态（--porcelain）。注意：不走通用 git()——其 stdout.trim() 会剥掉首行前导空格，
-*  破坏 porcelain 的两列状态位（" M file" → "M file"），此处保留原始行仅去行尾。 */
-function statusShort(cwd) {
-	const r = spawnSync("git", ["status", "--porcelain"], {
-		cwd,
-		encoding: "utf8",
-		timeout: 3e4
-	});
-	if (r.error || r.status !== 0) return [];
-	return (r.stdout ?? "").split("\n").map((l) => l.trimEnd()).filter(Boolean);
-}
-//#endregion
 //#region src/version/infer.ts
 /**
 * 版本推断与决定：锚点 tag..HEAD 的 conventional commits → bump level（纯函数），
@@ -5039,4 +4617,4 @@ function fromAapt(artifactPath) {
 	}
 }
 //#endregion
-export { APPLIFT_HOME, AgcHarmonyChannel, AscChannel, BetaConfigSchema, CREDENTIALS_PATH, CredentialsFileSchema, CredentialsProfileSchema, DefaultChannelRegistry, GLOBAL_CONFIG_PATH, GlobalConfigSchema, GooglePlayChannel, HISTORY_PATH, HonorChannel, HuaweiAndroidChannel, OppoChannel, PROJECTS_MAP_PATH, PgyerChannel, PluginHost, ProjectConfigSchema, ReleaseConfigSchema, StoreConfigSchema, StoresSchema, VersionCodeConfigSchema, VersionConfigSchema, VivoChannel, WAIT_BEFORE_SUBMIT_MS, XiaomiChannel, YybChannel, appendEntry, applyBump, assertListingFiles, commitsSince, decideNextVersion, defineConfig, detectBundleIds, detectFramework, electronAdapter, evalVersionCodeFormula, findArtifacts, findUp, flutterAdapter, formPost, getAgcToken, getHarmonyAppId, git, hmacSign, humanizeError, inferBumpLevel, isGitRepo, latestSemverTag, loadCredentials, loadCredentialsLayered, loadGlobalConfig, loadListingFile, loadProjectConfig, loadProjectProfileMap, looseSemver, md5File, md5String, nativeAndroidAdapter, nativeHarmonyAdapter, nativeIosAdapter, nextVersionCode, planBump, projectCredentialsPath, readArtifactVersion, readEntries, readProjectVersions, registry, renderChangelogSection, resolveListing, resolvePlugins, resolveProfile, resolveProfileFor, rnAdapter, runStage, runSubmit, saveCredentials, saveProjectProfileMap, setProjectProfile, sha256File, sortedQueryString, statusShort, storeVersionName, tauriAdapter, toChangelogEntries, tsMillis, tsSeconds, upsertChangelog, writeProjectVersions };
+export { APPLIFT_HOME, AgcHarmonyChannel, AscChannel, BetaConfigSchema, CREDENTIALS_PATH, CredentialsFileSchema, CredentialsProfileSchema, DefaultChannelRegistry, GLOBAL_CONFIG_PATH, GlobalConfigSchema, GooglePlayChannel, HISTORY_PATH, HonorChannel, HuaweiAndroidChannel, OppoChannel, PROJECTS_MAP_PATH, PgyerChannel, PluginHost, ProjectConfigSchema, StoreConfigSchema, StoresSchema, VersionCodeConfigSchema, VersionConfigSchema, VivoChannel, WAIT_BEFORE_SUBMIT_MS, XiaomiChannel, YybChannel, appendEntry, applyBump, assertListingFiles, collectReleaseDiff, commitsSince, decideNextVersion, defineConfig, deps, detectBundleIds, electronAdapter, electronFramework, evalVersionCodeFormula, findArtifacts, findUp, flutterAdapter, flutterFramework, formPost, getAgcToken, getHarmonyAppId, git, hmacSign, humanizeError, inferBumpLevel, isGitRepo, knownFrameworkAdapters, latestSemverTag, loadCredentials, loadCredentialsLayered, loadGlobalConfig, loadListingFile, loadProjectConfig, loadProjectProfileMap, looseSemver, md5File, md5String, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, nextVersionCode, planBump, projectCredentialsPath, readArtifactVersion, readEntries, readJson, readProjectVersions, redactText, registry, renderChangelogSection, resolveFramework, resolveListing, resolvePlugins, resolveProfile, resolveProfileFor, resolveProfileSource, rnAdapter, rnFramework, routeDelivery, runStage, runSubmit, saveCredentials, saveProjectProfileMap, setProjectProfile, sha256File, sortedQueryString, statusShort, storeVersionName, subdirs, suggestFramework, tagReleaseVersion, tauriAdapter, tauriFramework, toChangelogEntries, tsMillis, tsSeconds, upsertChangelog, writeProjectVersions };