@applift/core 0.8.2 → 0.9.0

package/dist/index.d.mts

@@ -349,7 +349,6 @@ export declare class AgcHarmonyChannel implements Channel {
     "204144692": string;
   };
   private authHeaders;
-  /** appId 缺省时按 bundleName 查（v1 全链路 step 0，可选） */
   private resolveAppId;
   plan(ctx: ChannelContext): Promise<ReleasePlanEntry>;
   /** stage = 上传+绑定（不提审）：正式 .app 走 v3 绑定；ctx.target.releaseType==='6' 走测试发布（.hap） */
@@ -359,7 +358,15 @@ export declare class AgcHarmonyChannel implements Channel {
   submit(ctx: ChannelContext, stagedRef?: string): Promise<SubmitResult>;
   /** 轮询软件包云端编译：successStatus 0=成功 2=拒绝（终态，多为签名/证书/bundleName 不匹配）其他=编译中 */
   private awaitCompile;
-  status(): Promise<ReviewStatus>;
+  /**
+   * 查询商用版本审核状态：POST /publish/v3/version/brief-info/list。
+   * - 只取商用版本（testType 缺省或 1）；测试版本（3=邀请/4=公开）走 Testing API 链路，不混入
+   *   status 语义——过滤后为空即 unknown（fail-safe，不会误报测试版本状态）
+   * - state 取值同 AppInfo.releaseState 全表（与华为安卓渠道同表，apkgo/hw_query.py 交叉验证）：
+   *   0=已上架 1/8=审核不通过 2=已下架 3=待上架 4/5=审核中 7=草稿 11=撤销上架
+   * - 多个商用版本取 updateTime 最新
+   */
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
   /** v1 releaseHarmonyApp step 1-4：.app 校验 → 上传地址 → PUT 整包 → v3 绑定（releaseType=1）→ 文案（不阻断） */
   private uploadFormal;
   /**
@@ -389,20 +396,50 @@ export declare class AscChannel implements Channel {
   private resolveAuth;
   /**
    * 上传 ipa 到 App Store Connect（TestFlight / 正式皆走此入口）。
+   * 双引擎：iTMSTransporter（JWT 认证，官方推荐 API 用户）优先，未装 Transporter.app 时回退 altool。
+   */
+  stage(ctx: ChannelContext): Promise<StageResult>;
+  /**
+   * iTMSTransporter 路径：凭据 ASC_TRANSPORTER_PATH 显式指定（支持 ~ 前缀，校验存在性），
+   * 缺省探测 Transporter.app 默认安装路径；都不存在返回 undefined（回退 altool）。
+   * public 便于测试注入（spyOn 覆写返回值）。
+   */
+  resolveTransporterPath(ctx: Pick<ChannelContext, "credentials">): string | undefined;
+  /**
+   * 引擎一：iTMSTransporter + JWT 上传（-m upload -jwt -assetFile）。
+   * - JWT 与 ASC REST API 同源（Apple 官方建议：Upload builds），20 分钟有效期覆盖典型上传时长；
+   * - -assetFile 成功后 Apple 侧删除源文件、多字节文件名上传失败 → 复制到临时随机 ASCII 名
+   *   再传（对齐 fastlane deliver 的防御做法），临时文件 finally 清理；
+   * - 成败判定（fastlane itunes_transporter 语义）：exit 0 且 DBG-X: Returning 0（或无该行）为成功；
+   *   Returning 非 0 或 exit 非 0 为失败，错误信息优先取 ERROR 行。
+   */
+  private stageWithTransporter;
+  /**
+   * 引擎二（兜底）：xcrun altool 上传。
    * 来源: v1 tools/publish/lib/asc.mjs 的 uploadIpaToAsc（逻辑不变；v1 经 run 继承 stdio 输出，
    * v2 输出统一走 ctx.emit，故改为捕获后透传，失败语义与 v1 run 一致）
    */
-  stage(ctx: ChannelContext): Promise<StageResult>;
+  private stageWithAltool;
   /**
    * 提审 App Store —— 按 ASC 官方文档新实现，未经真实链路验证。
    * 文档: reviewSubmissions / Create a Review Submission / Submit a Review Submission
    *   https://developer.apple.com/documentation/appstoreconnectapi
    * 链路: 查 app（bundleId → 数字 id）→ 查最新已处理(VALID)构建 → 读取/创建 appStoreVersion
    *   （releaseType 默认 MANUAL，ctx.releaseTime 提供时 SCHEDULED + earliestReleaseDate）
-   *   → 绑定构建到版本 → reviewSubmissions 三步流提交进入审核
+   *   → 提审前预检（本地化描述）→ 绑定构建到版本 → reviewSubmissions 三步流提交进入审核
    */
   submit(ctx: ChannelContext): Promise<SubmitResult>;
-  status(): Promise<ReviewStatus>;
+  /**
+   * 查询审核状态：最新 appStoreVersion 的 appVersionState 映射到 ReviewStatus。
+   * 枚举见 AppVersionState（15 值）：审核中/被拒/已批准未发布/已上架，未识别状态归 unknown。
+   * 跳过 PREPARE_FOR_SUBMISSION / REPLACED_WITH_NEW_VERSION（非活跃提审记录）。
+   */
+  status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
+  /**
+   * 提审前预检（只读）：目标版本的全部本地化必须有商店描述（description）。
+   * Apple 提审硬性要求；缺失时提前报错，避免 reviewSubmissions 最后一步被拒的返工。
+   */
+  private preflightLocalizations;
 }
 //#endregion
 //#region src/channels/googleplay.d.ts

package/dist/index.mjs

@@ -7,7 +7,7 @@ import { parse } from "smol-toml";
 import { fileURLToPath } from "node:url";
 import { loadConfig } from "c12";
 import { createJiti } from "jiti";
-import crypto, { X509Certificate, constants, createHash, createHmac, createSign, publicEncrypt } from "node:crypto";
+import crypto, { X509Certificate, constants, createHash, createHmac, createSign, publicEncrypt, randomUUID } from "node:crypto";
 import { Readable } from "node:stream";
 import { spawnSync } from "node:child_process";
 import semver from "semver";
@@ -2434,6 +2434,7 @@ var YybChannel = class {
 *   4. PUT  /api/publish/v3/app-language-info    newFeatures 更新文案（lang 缺省取 defaultLang）
 *   5. GET  /api/publish/v3/package/compile/status  轮询编译（0=成功 2=拒绝终态 其他=编译中）
 *   6. POST /api/publish/v3/app-submit           提审（ret 204144719/204144727 = 编译中可重试）
+* 状态查询: POST /api/publish/v3/version/brief-info/list  查商用版本 state（同 AppInfo.releaseState 全表）
 *
 * 测试发布（ctx.target.releaseType === '6'，2026-10 起走 Testing API；旧 releaseType=6 直绑 app-package-info 链路已下线，枚举仅剩 1/7）:
 *   0. GET  /api/publish/v2/upload-url/for-obs?releaseType=6   .hap 上传地址 → PUT OBS
@@ -2502,7 +2503,7 @@ var AgcHarmonyChannel = class {
 		stage: true,
 		submit: true,
 		scheduled: true,
-		status: false
+		status: true
 	};
 	errorHints = {
 		"204144719": "软件包正在编译中（正常时序，CLI 已自动重试；持续出现请到 AGC 控制台看包状态）",
@@ -2528,12 +2529,11 @@ var AgcHarmonyChannel = class {
 			}
 		};
 	}
-	/** appId 缺省时按 bundleName 查（v1 全链路 step 0，可选） */
 	async resolveAppId(ctx, clientId, token) {
 		const appId = ctx.target.appId;
 		if (appId) return appId;
 		const bundleName = required$1(ctx, "bundleName", "项目配置 appId / bundleName 至少配一个");
-		ctx.emit({
+		ctx.emit?.({
 			type: "progress",
 			detail: `appId 缺省，按 bundleName=${bundleName} 查询 AGC 应用列表…`
 		});
@@ -2670,11 +2670,72 @@ var AgcHarmonyChannel = class {
 			await sleep(COMPILE_POLL_MS);
 		}
 	}
-	async status() {
-		return {
+	/**
+	* 查询商用版本审核状态：POST /publish/v3/version/brief-info/list。
+	* - 只取商用版本（testType 缺省或 1）；测试版本（3=邀请/4=公开）走 Testing API 链路，不混入
+	*   status 语义——过滤后为空即 unknown（fail-safe，不会误报测试版本状态）
+	* - state 取值同 AppInfo.releaseState 全表（与华为安卓渠道同表，apkgo/hw_query.py 交叉验证）：
+	*   0=已上架 1/8=审核不通过 2=已下架 3=待上架 4/5=审核中 7=草稿 11=撤销上架
+	* - 多个商用版本取 updateTime 最新
+	*/
+	async status(ctx) {
+		const { clientId, token, headers } = await this.authHeaders(ctx);
+		const appId = await this.resolveAppId(ctx, clientId, token);
+		const packageName = ctx.target.bundleName;
+		const commercial = ((await agcJson(`${BASE}/publish/v3/version/brief-info/list`, {
+			method: "POST",
+			headers: {
+				...headers,
+				appId,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(packageName ? { packageName } : {})
+		}, "查询版本列表")).versionList ?? []).filter((v) => v.testType === void 0 || v.testType === 1);
+		if (commercial.length === 0) return {
 			state: "unknown",
-			raw: "AGC 鸿蒙审核状态查询未接入（v1 亦无）"
+			raw: "AGC 无商用版本记录（仅测试版本或从未发布）"
 		};
+		const latest = [...commercial].sort((a, b) => (b.updateTime ?? 0) - (a.updateTime ?? 0))[0];
+		const versionName = latest.packageList?.[0]?.versionName ?? "?";
+		const state = latest.state;
+		if (state === void 0) return {
+			state: "unknown",
+			raw: `商用版本 ${versionName} 无 state 字段`
+		};
+		const label = `${versionName}（releaseState=${state}）`;
+		switch (state) {
+			case 0: return {
+				state: "approved",
+				live: true
+			};
+			case 3: return {
+				state: "approved",
+				live: false
+			};
+			case 4:
+			case 5: return { state: "reviewing" };
+			case 1:
+			case 8: return {
+				state: "rejected",
+				reason: label
+			};
+			case 2: return {
+				state: "unknown",
+				raw: `已下架（${label}）`
+			};
+			case 7: return {
+				state: "unknown",
+				raw: `草稿，未提审（${label}）`
+			};
+			case 11: return {
+				state: "unknown",
+				raw: `撤销上架（${label}）`
+			};
+			default: return {
+				state: "unknown",
+				raw: label
+			};
+		}
 	}
 	/** v1 releaseHarmonyApp step 1-4：.app 校验 → 上传地址 → PUT 整包 → v3 绑定（releaseType=1）→ 文案（不阻断） */
 	async uploadFormal(ctx, appId, headers) {
@@ -3045,15 +3106,22 @@ async function ascRequest(jwt, apiPath, method, body) {
 /**
 * App Store Connect（iOS）渠道。
 *
-* - stage: xcrun altool 上传 ipa（免 fastlane/Ruby 依赖，底层即 App Store Connect API）
-*   —— 自 v1 tools/publish/lib/asc.mjs 的 uploadIpaToAsc 迁移（逻辑不变）。
-*   注意：xcrun altool 上传通道已被 Apple 列为弃用（deprecated），后续迁移至
-*   ASC API buildUploads 资源或 Transporter（altool 本身仍可用，暂保留）。
+* - stage 上传双引擎（2026-10-22 重构）：
+*   1) iTMSTransporter（首选）：Xcode 26 起 iTMSTransporter 已从 Xcode 剥离，需从 Mac App Store
+*      安装 Transporter.app（CLI 位于 /Applications/Transporter.app/Contents/itms/bin/）。
+*      JWT 认证与 ASC API 同源——Apple 官方建议 API 用户用同一 JWT 上传二进制
+*      （App Store Connect Help "Upload builds"）。注意两点（fastlane deliver 实证）：
+*      -assetFile 成功后 Apple 侧会删除源文件、多字节文件名上传失败，故复制到临时随机
+*      ASCII 名再传；JWT 20 分钟有效期覆盖典型上传时长（5-15 分钟），超长上传会认证过期。
+*   2) xcrun altool 兜底：Xcode 自带、零额外安装；altool 的 --upload-app 并未弃用
+*      （Apple 官方文档仍列名为四条官方上传路径之一，弃用的是其公证功能），
+*      但 altool 依赖 private_keys 目录查找，Transporter+JWT 是长期方向。
+*   凭据 ASC_TRANSPORTER_PATH 可显式指定 iTMSTransporter 路径（校验存在性）；
+*   缺省探测默认安装路径，不存在则回退 altool。
 *   约定 p8 私钥：凭据 ASC_P8_PATH（支持 ~ 前缀）或 ~/.applift/private_keys/AuthKey_<ASC_KEY_ID>.p8
-*   （v1 放 tools/publish/private_keys/；altool 本身认 <cwd>/private_keys、~/private_keys、
-*    ~/.private_keys、~/.appstoreconnect/private_keys，见 xcrun altool --help）
-* - submit: ASC REST API 提审 —— 按 ASC 官方文档新实现，未经真实链路验证
+* - submit: ASC REST API 提审（含提审前预检：本地化描述完备性），按 ASC 官方文档实现，未经真实链路验证
 *   官方文档: https://developer.apple.com/documentation/appstoreconnectapi
+* - status: 查最新 appStoreVersion 的 appVersionState（AppVersionState 15 枚举 → ReviewStatus）
 */
 var AscChannel = class {
 	id = "asc";
@@ -3062,7 +3130,7 @@ var AscChannel = class {
 		stage: true,
 		submit: true,
 		scheduled: true,
-		status: false
+		status: true
 	};
 	async plan(ctx) {
 		return {
@@ -3071,7 +3139,7 @@ var AscChannel = class {
 			artifactVersion: "",
 			action: "stage+submit",
 			afterApproval: ctx.releaseTime ? "scheduled" : "manual",
-			notes: "stage=xcrun altool 上传构建（TestFlight，约 10 分钟完成处理）；submit=ASC API 提审，默认手动发布"
+			notes: "stage=iTMSTransporter（或 altool 兜底）上传构建（TestFlight，约 10 分钟完成处理）；submit=ASC API 提审（含预检），默认手动发布"
 		};
 	}
 	/** 凭据三元组（Key ID / Issuer ID / p8 路径，缺任一抛错） */
@@ -3088,11 +3156,99 @@ var AscChannel = class {
 	}
 	/**
 	* 上传 ipa 到 App Store Connect（TestFlight / 正式皆走此入口）。
+	* 双引擎：iTMSTransporter（JWT 认证，官方推荐 API 用户）优先，未装 Transporter.app 时回退 altool。
+	*/
+	async stage(ctx) {
+		const auth = this.resolveAuth(ctx);
+		const transporter = this.resolveTransporterPath(ctx);
+		if (transporter) return this.stageWithTransporter(ctx, auth, transporter);
+		return this.stageWithAltool(ctx, auth);
+	}
+	/**
+	* iTMSTransporter 路径：凭据 ASC_TRANSPORTER_PATH 显式指定（支持 ~ 前缀，校验存在性），
+	* 缺省探测 Transporter.app 默认安装路径；都不存在返回 undefined（回退 altool）。
+	* public 便于测试注入（spyOn 覆写返回值）。
+	*/
+	resolveTransporterPath(ctx) {
+		const explicit = ctx.credentials["ASC_TRANSPORTER_PATH"];
+		if (explicit) {
+			const p = explicit.startsWith("~/") ? path.join(os.homedir(), explicit.slice(2)) : path.resolve(explicit);
+			if (!fs.existsSync(p)) throw new Error(`ASC_TRANSPORTER_PATH 指向的 iTMSTransporter 不存在: ${p}（iTMSTransporter 需从 Mac App Store 安装 Transporter.app，或清空该凭据回退 altool）`);
+			return p;
+		}
+		const def = "/Applications/Transporter.app/Contents/itms/bin/iTMSTransporter";
+		return fs.existsSync(def) ? def : void 0;
+	}
+	/**
+	* 引擎一：iTMSTransporter + JWT 上传（-m upload -jwt -assetFile）。
+	* - JWT 与 ASC REST API 同源（Apple 官方建议：Upload builds），20 分钟有效期覆盖典型上传时长；
+	* - -assetFile 成功后 Apple 侧删除源文件、多字节文件名上传失败 → 复制到临时随机 ASCII 名
+	*   再传（对齐 fastlane deliver 的防御做法），临时文件 finally 清理；
+	* - 成败判定（fastlane itunes_transporter 语义）：exit 0 且 DBG-X: Returning 0（或无该行）为成功；
+	*   Returning 非 0 或 exit 非 0 为失败，错误信息优先取 ERROR 行。
+	*/
+	async stageWithTransporter(ctx, auth, transporterPath) {
+		const jwt = makeAscJwt(auth);
+		ctx.emit({
+			type: "phase",
+			phase: "upload",
+			message: `iTMSTransporter 上传 ${path.basename(ctx.artifactPath)}（JWT 认证，约 5-15 分钟）`
+		});
+		const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "applift-asc-itms-"));
+		const tmpIpa = path.join(tmpDir, `${randomUUID()}.ipa`);
+		fs.copyFileSync(ctx.artifactPath, tmpIpa);
+		try {
+			const r = spawnSync(transporterPath, [
+				"-m",
+				"upload",
+				"-jwt",
+				jwt,
+				"-assetFile",
+				tmpIpa,
+				"-k",
+				"100000"
+			], {
+				encoding: "utf8",
+				timeout: 18e5
+			});
+			if (r.error) {
+				if ("code" in r.error && r.error.code === "ETIMEDOUT") throw new Error("iTMSTransporter 超时（30min）——检查网络/上传体积");
+				throw new Error(`无法执行 iTMSTransporter: ${r.error.message}（需 macOS + Transporter.app）`);
+			}
+			const output = `${r.stdout ?? ""}${r.stderr ?? ""}`.trim();
+			const ret = output.match(/DBG-X:\s*Returning\s+(\d+)/);
+			if (r.status !== 0 || ret !== null && ret[1] !== "0") {
+				const errLines = output.split(/\r?\n/).filter((l) => /ERROR:/i.test(l)).slice(-5).join("\n");
+				throw new Error(`iTMSTransporter 上传失败（exit ${r.status ?? "?"}${ret !== null ? `，Returning ${ret[1]}` : ""}）: ` + (errLines || output.slice(-2e3) || "无输出"));
+			}
+			if (output) ctx.emit({
+				type: "progress",
+				detail: output.slice(-2e3)
+			});
+		} finally {
+			fs.rmSync(tmpDir, {
+				recursive: true,
+				force: true
+			});
+		}
+		ctx.emit({
+			type: "phase",
+			phase: "done",
+			message: "ipa 已上传至 App Store Connect（约 10 分钟后出现在 TestFlight）"
+		});
+		ctx.emit({
+			type: "progress",
+			detail: "内部测试员即刻可装；外部测试组首次需在 ASC 后台过 Beta 审核"
+		});
+		return { ok: true };
+	}
+	/**
+	* 引擎二（兜底）：xcrun altool 上传。
 	* 来源: v1 tools/publish/lib/asc.mjs 的 uploadIpaToAsc（逻辑不变；v1 经 run 继承 stdio 输出，
 	* v2 输出统一走 ctx.emit，故改为捕获后透传，失败语义与 v1 run 一致）
 	*/
-	async stage(ctx) {
-		const { keyId, issuerId, p8Path } = this.resolveAuth(ctx);
+	async stageWithAltool(ctx, auth) {
+		const { keyId, issuerId, p8Path } = auth;
 		const ipaPath = ctx.artifactPath;
 		ctx.emit({
 			type: "phase",
@@ -3157,7 +3313,7 @@ var AscChannel = class {
 	*   https://developer.apple.com/documentation/appstoreconnectapi
 	* 链路: 查 app（bundleId → 数字 id）→ 查最新已处理(VALID)构建 → 读取/创建 appStoreVersion
 	*   （releaseType 默认 MANUAL，ctx.releaseTime 提供时 SCHEDULED + earliestReleaseDate）
-	*   → 绑定构建到版本 → reviewSubmissions 三步流提交进入审核
+	*   → 提审前预检（本地化描述）→ 绑定构建到版本 → reviewSubmissions 三步流提交进入审核
 	*/
 	async submit(ctx) {
 		const { keyId, issuerId, p8Path } = this.resolveAuth(ctx);
@@ -3227,6 +3383,7 @@ var AscChannel = class {
 				message: `已创建版本 ${versionString}（releaseType=${releaseType}）`
 			});
 		}
+		await this.preflightLocalizations(jwt, versionId, ctx);
 		await ascRequest(jwt, `/v1/appStoreVersions/${versionId}/relationships/builds`, "PATCH", { data: [{
 			type: "builds",
 			id: build.id
@@ -3262,16 +3419,78 @@ var AscChannel = class {
 			ref: reviewSubmissionId
 		};
 	}
-	async status() {
-		return {
+	/**
+	* 查询审核状态：最新 appStoreVersion 的 appVersionState 映射到 ReviewStatus。
+	* 枚举见 AppVersionState（15 值）：审核中/被拒/已批准未发布/已上架，未识别状态归 unknown。
+	* 跳过 PREPARE_FOR_SUBMISSION / REPLACED_WITH_NEW_VERSION（非活跃提审记录）。
+	*/
+	async status(ctx) {
+		const auth = this.resolveAuth(ctx);
+		const bundleId = ctx.target["bundleId"] ?? ctx.target["bundleName"];
+		if (!bundleId) throw new Error("ASC 渠道缺少 bundleId（项目配置 ios.bundleId）");
+		const jwt = makeAscJwt(auth);
+		const apps = await ascGet(jwt, `/v1/apps?filter[bundleId]=${encodeURIComponent(bundleId)}&limit=5`);
+		const app = apps.data.find((a) => a.attributes?.bundleId === bundleId) ?? apps.data[0];
+		if (!app?.id) throw new Error(`ASC 未找到 bundleId=${bundleId} 对应的 App`);
+		const versions = await ascGet(jwt, `/v1/apps/${app.id}/appStoreVersions?filter[platform]=IOS&limit=10`);
+		const active = versions.data.find((v) => v.attributes?.appVersionState !== "PREPARE_FOR_SUBMISSION" && v.attributes?.appVersionState !== "REPLACED_WITH_NEW_VERSION") ?? versions.data[0];
+		if (!active?.id) return {
 			state: "unknown",
-			raw: "ASC 审核状态查询（appStoreVersions 的 appStoreState）M2 接入"
+			raw: "ASC 无 IOS appStoreVersion 记录"
 		};
+		const state = active.attributes?.appVersionState ?? "UNKNOWN";
+		const label = `${active.attributes?.versionString ?? "?"}（${state}）`;
+		switch (state) {
+			case "WAITING_FOR_REVIEW":
+			case "IN_REVIEW":
+			case "WAITING_FOR_EXPORT_COMPLIANCE":
+			case "READY_FOR_REVIEW": return { state: "reviewing" };
+			case "REJECTED":
+			case "METADATA_REJECTED":
+			case "DEVELOPER_REJECTED":
+			case "INVALID_BINARY": return {
+				state: "rejected",
+				reason: label
+			};
+			case "ACCEPTED":
+			case "PENDING_APPLE_RELEASE":
+			case "PENDING_DEVELOPER_RELEASE":
+			case "PROCESSING_FOR_DISTRIBUTION": return {
+				state: "approved",
+				live: false
+			};
+			case "READY_FOR_DISTRIBUTION": return {
+				state: "approved",
+				live: true
+			};
+			default: return {
+				state: "unknown",
+				raw: label
+			};
+		}
+	}
+	/**
+	* 提审前预检（只读）：目标版本的全部本地化必须有商店描述（description）。
+	* Apple 提审硬性要求；缺失时提前报错，避免 reviewSubmissions 最后一步被拒的返工。
+	*/
+	async preflightLocalizations(jwt, versionId, ctx) {
+		const locs = await ascGet(jwt, `/v1/appStoreVersions/${versionId}/appStoreVersionLocalizations?limit=50`);
+		if (locs.data.length === 0) throw new Error("ASC 版本无任何本地化记录，无法提审——请在 ASC 后台补全商店元数据（描述/关键词/截图）后重试");
+		const missing = locs.data.filter((d) => !(d.attributes?.description ?? "").trim()).map((d) => d.attributes?.locale ?? d.id);
+		if (missing.length > 0) throw new Error(`以下本地化缺少商店描述（description），无法提审: ${missing.join(", ")}——请在 ASC 后台或经 API 补全后重试`);
+		ctx.emit({
+			type: "progress",
+			detail: `提审预检通过：本地化 ${locs.data.map((d) => d.attributes?.locale ?? d.id).join(", ")} 描述齐备`
+		});
+		ctx.emit({
+			type: "progress",
+			detail: "出口合规提示：Info.plist 声明 ITSAppUsesNonExemptEncryption（按实际加密用途取值）可免每次提审被问询"
+		});
 	}
 };
-function required(ctx, key, where) {
+function required(ctx, key) {
 	const v = ctx.credentials[key] ?? ctx.target[key];
-	if (!v) throw new Error(`ASC 渠道缺少 ${key}${where ? `（${where}）` : ""}`);
+	if (!v) throw new Error(`ASC 渠道缺少 ${key}`);
 	return v;
 }
 /** p8 路径：凭据 ASC_P8_PATH（支持 ~ 前缀）优先，否则 ~/.applift/private_keys/AuthKey_<KeyID>.p8 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applift/core",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/hcg1023/applift.git",