@applift/core 0.1.2 → 0.2.0

package/dist/index.d.mts

@@ -13,17 +13,17 @@ export declare const registry: DefaultChannelRegistry;
 export declare const APPLIFT_HOME: string;
 export declare const CREDENTIALS_PATH: string;
 export declare const GLOBAL_CONFIG_PATH: string;
-/** 项目级凭据目录（<project>/.applift/credentials.toml；gitignore 由用户决定：私有仓可提交，公开仓 ignore） */
+/** 项目级凭据目录（<project>/.applift/credentials.json；gitignore 由用户决定：私有仓可提交，公开仓 ignore） */
 export declare function projectCredentialsPath(projectRoot: string): string;
 /** 从 startDir 逐层向上找第一个存在的路径（monorepo 子包向上借用根配置/凭据）；找不到返回 null */
 export declare function findUp(startDir: string, relative: string): string | null;
 /**
- * 逐级凭据加载：项目 <root>/.applift/credentials.toml（就近，逐键优先）→ 全局 ~/.applift/（逐键回退）。
+ * 逐级凭据加载：项目 <root>/.applift/credentials.json（就近，逐键优先）→ 全局 ~/.applift/（逐键回退）。
  * 场景：私有仓提交凭据进仓库；或公开仓 .applift/ 进 gitignore 由成员各自维护。
  * profile 合并：项目同名 profile 逐键覆盖全局；仅全局有则用全局。
  */
 export declare function loadCredentialsLayered(projectRoot?: string, globalPath?: string): CredentialsFile;
-/** 读取并校验 credentials.toml；不存在返回空 profiles；强制 0600 */
+/** 读取并校验 credentials.json；不存在返回空 profiles；强制 0600 */
 export declare function loadCredentials(filePath?: string): CredentialsFile;
 /** 按项目 profile 取凭据；profile 不存在时报错并列出可用 profiles。
  * 环境变量覆盖（CI 场景）：APPLIFT_<KEY> 前缀优先（如 APPLIFT_PGYER_API_KEY）；
@@ -144,8 +144,9 @@ export declare class HuaweiAndroidChannel implements Channel, ListingCapableChan
   stage(ctx: ChannelContext): Promise<StageResult>;
   submit(ctx: ChannelContext): Promise<SubmitResult>;
   /**
-   * 更新商店应用信息：简介/描述走 v3 app-language-info（briefInfo/appDesc）。
-   * 图标/截图：华为 v3 app-file-info 的 fileType 取值未在官方文档确证（软件包=5 已验证，图标清单值不确定），
+   * 更新商店应用信息：简介/描述走 v2 app-language-info（briefInfo/appDesc）。
+   * 注：v3 app-language-info 为鸿蒙（HarmonyOS）专属接口族，安卓现行文档只有 v2。
+   * 图标/截图：华为 app-file-info 的 fileType 取值未在官方文档确证（软件包=5 已验证，图标清单值不确定），
    * 未经真机验证前只上传 OBS 不做 file-info 绑定（skip 并在结果中标注），避免误写损坏草稿。
    */
   updateListing(ctx: Pick<ChannelContext, "credentials" | "target" | "emit">, listing: ListingInput): Promise<ListingResult>;
@@ -191,6 +192,9 @@ export declare class OppoChannel implements Channel {
     "911215": string;
     "911216": string;
     "800002": string;
+    "910003": string;
+    "911045": string;
+    "300002": string;
   };
   /** stage 产物暂存（apkUrl/md5），submit 按 pkgName 取回 */
   private readonly staged;
@@ -204,9 +208,19 @@ export declare class OppoChannel implements Channel {
    */
   private uploadApk;
   submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /**
+   * app/upd 异步任务结果轮询: POST /resource/v1/app/task-state（业务参数 pkg_name+version_code，
+   * 现行文档「获取任务状态」）。task_state: 1=待处理（继续等）、2=处理成功、3=处理失败（err_msg 透出）；
+   * 间隔 10s × 最多 5 次，超时视为已受理但异步结果未知（warn 提示，稍后可用 status 查询审核状态）。
+   */
+  private pollTaskState;
   /**
    * 审核状态查询: GET /resource/v1/app/info（公共参数 + api_sign，同 stage）
-   * → data.audit_status（android-publish oppo_query.py: 1=待提审 2=审核中 3=通过 4=驳回）。
+   * → data.audit_status 按现行「审核状态对照表」映射（id=10998）:
+   *   1=审核中、4=运营审核中 → reviewing；2=审核通过、6=运营通过 → approved；111=上线 → approved+live；
+   *   3=测试不通过、5=运营打回、444=审核不通过 → rejected（原因读 refuse_reason，原样透出不解析）；
+   *   0=未发布、7=定时发布、22=已冻结 → unknown+raw；其余编号（00/11/-11 资质类、222 下架等）→ unknown。
+   * 旧映射（1=待提审 2=审核中 3=通过 4=驳回，出自 python oppo_query.py）与现行对照表整体错位，已重写。
    */
   status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
 }
@@ -217,8 +231,10 @@ export declare class VivoChannel implements Channel {
   readonly label = "vivo 应用市场";
   readonly capabilities: ChannelCapabilities;
   readonly errorHints: {
-    "1002": string;
-    "46001": string;
+    "10001": string;
+    "10005": string;
+    "10011": string;
+    "12010": string;
   };
   /**
    * stage→submit 之间传递上传结果：Channel 接口不透传 ref，
@@ -239,6 +255,7 @@ export declare class VivoChannel implements Channel {
    * 审核状态查询: 复用 app.query.details 的 data.auditStatus（对拍 python vivo_query.py；
    * 未确证的 app.audit.status method 已删——python/apkgo 均无此调用）。
    * 映射 0=审核通过 1=审核中 2=驳回 沿自 v1，待真机校准；
+   * 注意：该编号映射未在现行中国站文档成文（国际站同型接口字典编号整体错一位），需真机校准；
    * 交叉见证：apkgo vivo.go 读 data.status 且编号不同（1草稿/2待审核/3通过/4不通过/5撤销），冲突以真机为准。
    */
   status(ctx: Pick<ChannelContext, "credentials" | "target">): Promise<ReviewStatus>;
@@ -252,6 +269,10 @@ export declare class HonorChannel implements Channel {
   readonly label = "荣耀应用市场";
   readonly capabilities: ChannelCapabilities;
   readonly errorHints: {
+    "10003": string;
+    "20022": string;
+    "30006": string;
+    "30011": string;
     "100030001": string;
     "100030002": string;
   };
@@ -311,10 +332,17 @@ export declare class AgcHarmonyChannel implements Channel {
   stage(ctx: ChannelContext): Promise<StageResult>;
   /** submit = v1 releaseHarmonyApp 完整链路：上传+绑定+文案 → 等编译轮询 → 提审（带重试） */
   submit(ctx: ChannelContext): Promise<SubmitResult>;
+  /** 轮询软件包云端编译：successStatus 0=成功 2=拒绝（终态，多为签名/证书/bundleName 不匹配）其他=编译中 */
+  private awaitCompile;
   status(): Promise<ReviewStatus>;
   /** v1 releaseHarmonyApp step 1-4：.app 校验 → 上传地址 → PUT 整包 → v3 绑定（releaseType=1）→ 文案（不阻断） */
   private uploadFormal;
-  /** v1 uploadToAgc（releaseType=6 测试发布）：上传 → 绑定（不阻断）→ 文案（不阻断），不提审 */
+  /**
+   * 测试发布（releaseType=6，2026-10 起走 Testing API——旧 app-package-info 直绑链路已被华为下线，
+   * 其 releaseType 枚举仅剩 1=全网 / 7=企业非公开）：
+   * 上传 .hap → 新建测试版本（testType=3 邀请测试）→ 添加测试软件包 → 等云端编译 → 更新测试版本绑定；
+   * 不自动提交审核，测试群组/邀请码由控制台人工完成。
+   */
   private uploadBeta;
   /** v1 更新文案段（releaseHarmonyApp step 4 / uploadToAgc 尾段）：查默认语言 → 写 newFeatures，失败仅警告不阻断 */
   private updateReleaseNotes;
@@ -336,11 +364,11 @@ export declare class AscChannel implements Channel {
   stage(ctx: ChannelContext): Promise<StageResult>;
   /**
    * 提审 App Store —— 按 ASC 官方文档新实现，未经真实链路验证。
-   * 文档: appStoreVersionSubmissions / Create a Version Submission
+   * 文档: 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 + earlyReleaseDate）
-   *   → 绑定构建到版本 → POST appStoreVersionSubmissions 进入审核
+   *   （releaseType 默认 MANUAL，ctx.releaseTime 提供时 SCHEDULED + earliestReleaseDate）
+   *   → 绑定构建到版本 → reviewSubmissions 三步流提交进入审核
    */
   submit(ctx: ChannelContext): Promise<SubmitResult>;
   status(): Promise<ReviewStatus>;

package/dist/index.mjs

@@ -28,8 +28,8 @@ const registry = new DefaultChannelRegistry();
 //#region src/config/schema.ts
 /**
 * 配置三层：项目 applift.config.ts > 内置默认（全局行为配置独立于 ~/.applift/config.toml）。
-* 凭据独立存放 ~/.applift/credentials.toml（0600，按 profile 组织，永不进项目目录/git）。
-* 加载用社区主流 c12（TS 配置执行 + 多层 merge），TOML 用 smol-toml，非自研。
+* 凭据独立存放 ~/.applift/credentials.json（0600，按 profile 组织，永不进项目目录/git）。
+* 加载用社区主流 c12（TS 配置执行 + 多层 merge），config.toml 用 smol-toml 解析，非自研。
 */
 const CredentialsProfileSchema = z.record(z.string(), z.string());
 const CredentialsFileSchema = z.object({ 
@@ -101,11 +101,11 @@ const GlobalConfigSchema = z.object({
 * 凭据与配置装载：文件定位、profile 解析、0600 权限。
 */
 const APPLIFT_HOME = process.env.APPLIFT_HOME || path.join(os.homedir(), ".applift");
-const CREDENTIALS_PATH = path.join(APPLIFT_HOME, "credentials.toml");
+const CREDENTIALS_PATH = path.join(APPLIFT_HOME, "credentials.json");
 const GLOBAL_CONFIG_PATH = path.join(APPLIFT_HOME, "config.toml");
-/** 项目级凭据目录（<project>/.applift/credentials.toml；gitignore 由用户决定：私有仓可提交，公开仓 ignore） */
+/** 项目级凭据目录（<project>/.applift/credentials.json；gitignore 由用户决定：私有仓可提交，公开仓 ignore） */
 function projectCredentialsPath(projectRoot) {
-	return path.join(projectRoot, ".applift", "credentials.toml");
+	return path.join(projectRoot, ".applift", "credentials.json");
 }
 /** 从 startDir 逐层向上找第一个存在的路径（monorepo 子包向上借用根配置/凭据）；找不到返回 null */
 function findUp(startDir, relative) {
@@ -119,14 +119,14 @@ function findUp(startDir, relative) {
 	}
 }
 /**
-* 逐级凭据加载：项目 <root>/.applift/credentials.toml（就近，逐键优先）→ 全局 ~/.applift/（逐键回退）。
+* 逐级凭据加载：项目 <root>/.applift/credentials.json（就近，逐键优先）→ 全局 ~/.applift/（逐键回退）。
 * 场景：私有仓提交凭据进仓库；或公开仓 .applift/ 进 gitignore 由成员各自维护。
 * profile 合并：项目同名 profile 逐键覆盖全局；仅全局有则用全局。
 */
 function loadCredentialsLayered(projectRoot, globalPath = CREDENTIALS_PATH) {
 	const global = loadCredentials(globalPath);
 	if (!projectRoot) return global;
-	const localPath = findUp(projectRoot, path.join(".applift", "credentials.toml"));
+	const localPath = findUp(projectRoot, path.join(".applift", "credentials.json"));
 	if (!localPath) return global;
 	const local = loadCredentials(localPath);
 	const merged = {};
@@ -138,11 +138,11 @@ function loadCredentialsLayered(projectRoot, globalPath = CREDENTIALS_PATH) {
 	return CredentialsFileSchema.parse({ profiles: merged });
 }
 const EMPTY_CREDENTIALS = { profiles: {} };
-/** 读取并校验 credentials.toml；不存在返回空 profiles；强制 0600 */
+/** 读取并校验 credentials.json；不存在返回空 profiles；强制 0600 */
 function loadCredentials(filePath = CREDENTIALS_PATH) {
 	if (!fs.existsSync(filePath)) return EMPTY_CREDENTIALS;
 	if (fs.statSync(filePath).mode & 63) fs.chmodSync(filePath, 384);
-	const raw = parse(fs.readFileSync(filePath, "utf8"));
+	const raw = JSON.parse(fs.readFileSync(filePath, "utf8"));
 	return CredentialsFileSchema.parse(raw);
 }
 /** 按项目 profile 取凭据；profile 不存在时报错并列出可用 profiles。
@@ -172,26 +172,10 @@ function loadGlobalConfig(filePath = GLOBAL_CONFIG_PATH) {
 		return GlobalConfigSchema.parse({});
 	}
 }
-/** TOML 裸键合法字符集（含 - 与 _），超出则产出的 TOML 无法被解析回来 */
-const TOML_BARE_KEY = /^[A-Za-z0-9_-]+$/;
-/** 凭据序列化为 TOML（值经 JSON.stringify 转义，可含引号/反斜杠/#；键名与 profile 名仅允许裸键字符集，非法即抛错防写坏文件） */
-function credentialsToToml(data) {
-	const lines = [];
-	for (const [pname, kv] of Object.entries(data.profiles)) {
-		if (!TOML_BARE_KEY.test(pname)) throw new Error(`凭据 profile 名 "${pname}" 含 TOML 裸键非法字符（仅允许字母/数字/_/-）`);
-		lines.push(`[profiles.${pname}]`);
-		for (const [k, v] of Object.entries(kv)) {
-			if (!TOML_BARE_KEY.test(k)) throw new Error(`profile "${pname}" 的凭据键名 "${k}" 含 TOML 裸键非法字符（仅允许字母/数字/_/-）`);
-			lines.push(`${k} = ${JSON.stringify(String(v))}`);
-		}
-		lines.push("");
-	}
-	return `${lines.join("\n")}\n`;
-}
 /** 写凭据（目录自动创建，文件强制 0600） */
 function saveCredentials(data, filePath = CREDENTIALS_PATH) {
 	fs.mkdirSync(path.dirname(filePath), { recursive: true });
-	fs.writeFileSync(filePath, credentialsToToml(data), { mode: 384 });
+	fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", { mode: 384 });
 	fs.chmodSync(filePath, 384);
 }
 //#endregion
@@ -447,7 +431,7 @@ var PgyerChannel = class {
 			phase: "wait",
 			message: "等待蒲公英处理"
 		});
-		const deadline = Date.now() + 3e5;
+		const deadline = Date.now() + 9e5;
 		while (Date.now() < deadline) {
 			await sleep(3e3);
 			const info = await pgyerPost(HOSTS[0], "/apiv2/app/buildInfo", {
@@ -472,7 +456,7 @@ var PgyerChannel = class {
 		}
 		return {
 			ok: false,
-			error: "蒲公英 5 分钟内未完成处理"
+			error: "蒲公英 15 分钟内未完成处理（大包云端处理慢属正常，可到 pgyer.com 控制台确认实际状态）"
 		};
 	}
 	async submit() {
@@ -677,10 +661,10 @@ var HuaweiAndroidChannel = class {
 			},
 			body: JSON.stringify({
 				fileType: 5,
-				files: {
+				files: [{
 					fileName,
 					fileDestUrl: urlInfo.objectId
-				}
+				}]
 			})
 		}, "登记软件包");
 		ctx.emit({
@@ -695,6 +679,11 @@ var HuaweiAndroidChannel = class {
 	}
 	async submit(ctx) {
 		const appId = required$5(ctx, "appId");
+		if (ctx.remark !== void 0 && ctx.remark !== "") {
+			const remarkLen = [...ctx.remark].length;
+			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} 字符`);
 		const { headers } = await this.authHeaders(ctx);
 		if (ctx.updateDescription) try {
 			await hwJson(`${BASE$1}/publish/v2/app-language-info?appId=${encodeURIComponent(appId)}`, {
@@ -749,8 +738,9 @@ var HuaweiAndroidChannel = class {
 		};
 	}
 	/**
-	* 更新商店应用信息：简介/描述走 v3 app-language-info（briefInfo/appDesc）。
-	* 图标/截图：华为 v3 app-file-info 的 fileType 取值未在官方文档确证（软件包=5 已验证，图标清单值不确定），
+	* 更新商店应用信息：简介/描述走 v2 app-language-info（briefInfo/appDesc）。
+	* 注：v3 app-language-info 为鸿蒙（HarmonyOS）专属接口族，安卓现行文档只有 v2。
+	* 图标/截图：华为 app-file-info 的 fileType 取值未在官方文档确证（软件包=5 已验证，图标清单值不确定），
 	* 未经真机验证前只上传 OBS 不做 file-info 绑定（skip 并在结果中标注），避免误写损坏草稿。
 	*/
 	async updateListing(ctx, listing) {
@@ -763,7 +753,7 @@ var HuaweiAndroidChannel = class {
 			const body = { lang: "zh-CN" };
 			if (effective.brief !== void 0) body.briefInfo = effective.brief;
 			if (effective.description !== void 0) body.appDesc = effective.description;
-			await hwJson(`${BASE$1}/publish/v3/app-language-info?appId=${encodeURIComponent(appId)}`, {
+			await hwJson(`${BASE$1}/publish/v2/app-language-info?appId=${encodeURIComponent(appId)}`, {
 				method: "PUT",
 				headers: {
 					...headers,
@@ -825,7 +815,7 @@ var HuaweiAndroidChannel = class {
 			case 1:
 			case 8: return {
 				state: "rejected",
-				reason: json.appInfo?.auditDesc
+				reason: json.auditInfo?.auditOpinion ?? json.appInfo?.auditDesc
 			};
 			case 2: return {
 				state: "unknown",
@@ -865,9 +855,12 @@ function required$5(ctx, key, where) {
 *   sig = RSA_encrypt(证书公钥, JSON({sig: [{name, hash: MD5}...], password}))
 *   分段: 1024bit key → 每段 117 字节（128 - PKCS1 padding 11）
 * 链路: /dev/query 校验账号对包名权限 + 提审前版本回归预检 → /dev/push 上传即提审（synchroType=1 更新包，
-*       未传字段如 icon/privacyUrl 不覆盖线上值；无法只传包不提审）。
+*       无法只传包不提审）。现行文档（2026-09 更新）文件参数表 icon 标「必选」、appInfo.privacyUrl 标「必选」，
+*       旧版「未传字段如 icon/privacyUrl 不覆盖线上值」表述已不被现行文档支持；synchroType=1 不带素材是否仍被
+*       受理待真机验证，若被拒需补传 icon 文件（其 MD5 追加进 SIG 的 sig 数组）。
+*       另 2026-02-04 起 testAccount 须用新结构化格式（如 {"zh_CN":{"accounts":[...]}}），当前未传暂不受影响。
 * 移植自（MIT）: AngChow/android-publish scripts/_mi_common.py + mi_submit.py
-* 官方文档: https://dev.mi.com/distribute/doc/details?pId=1134
+* 官方文档: https://dev.mi.com/xiaomihyperos/documentation/detail?pId=1134
 */
 const MI_API_BASE = "https://api.developer.xiaomi.com/devupload";
 /**
@@ -1047,7 +1040,11 @@ var XiaomiChannel = class {
 		};
 	}
 };
-/** MI_PASSWORD 为主键名（applift 沿用）；兼容 python 权威键名 MI_PRIVATE_KEY（_mi_common.get_mi_credentials） */
+/**
+* MI_PASSWORD 为主键名（applift 沿用）；兼容 python 权威键名 MI_PRIVATE_KEY（_mi_common.get_mi_credentials）。
+* 值为小米开放平台的「API 私钥」（SIG 加密的 password 材料），非开发者账号登录密码 ——
+* 文档明确：访问密码即私钥，重置私钥后私钥变、小米分配的公钥不变。
+*/
 function miPassword(ctx) {
 	const v = ctx.credentials.MI_PASSWORD ?? ctx.credentials.MI_PRIVATE_KEY;
 	if (!v) throw new Error("小米渠道缺少 MI_PASSWORD（兼容别名 MI_PRIVATE_KEY）");
@@ -1062,10 +1059,14 @@ function required$4(ctx, key, where) {
 //#region src/channels/oppo.ts
 /**
 * OPPO 应用市场（安卓 APK）渠道 —— app/upd 发布字段集/参数名以 python/android-publish oppo_submit.py 为权威对拍。
-* v2 链路: GET token（48h 有效）→ get-upload-url → multipart 上传（stage）→ 查 app/info（复用线上字段）→ app/upd 发布（submit）
+* v2 链路: GET token（48h 有效）→ get-upload-url → multipart 上传（stage）→ 查 app/info（复用线上字段）→ app/upd 发布
+*      → task-state 轮询确认异步任务结果（submit；app/upd 为异步任务，errno=0 仅代表受理）
 * 签名: HmacSHA256（公共参数 access_token + timestamp(秒) + api_sign）
 */
 const API_BASE$3 = "https://oop-openapi-cn.heytapmobi.com";
+/** app/upd 异步任务结果轮询：间隔 10s（现行文档建议等待 ≥10s）× 最多 5 次 */
+const TASK_STATE_POLL_INTERVAL_MS = 1e4;
+const TASK_STATE_MAX_POLLS = 5;
 /** 获取 OPPO access_token（GET，48h 有效）—— 来源: oppo.mjs getOppoToken */
 async function getOppoToken(clientId, clientSecret) {
 	const qs = new URLSearchParams({
@@ -1195,7 +1196,7 @@ function buildUpdParams(appInfo, apkUrl, apkMd5, versionCode, updateDesc) {
 		app_name: infoField(appInfo, "app_name"),
 		second_category_id: infoField(appInfo, "second_category_id"),
 		third_category_id: infoField(appInfo, "third_category_id"),
-		summary: infoField(appInfo, "summary").slice(0, 13),
+		summary: infoField(appInfo, "summary").slice(0, 13).replace(/[\p{P}\p{Z}\s]/gu, ""),
 		detail_desc: infoField(appInfo, "detail_desc"),
 		update_desc: updateDesc,
 		privacy_source_url: infoField(appInfo, "privacy_source_url"),
@@ -1233,7 +1234,10 @@ var OppoChannel = class {
 	errorHints = {
 		"911215": "应用已有版本在审核中（等待审核完成或到控制台撤回后再提）",
 		"911216": "版本更新任务处理中（稍后用 status 查询结果）",
-		"800002": "参数校验失败：常见于简介/截图等商店资料不符合规格"
+		"800002": "参数校验失败：常见于简介/截图等商店资料不符合规格",
+		"910003": "上传 sign 失效（sign 单次有效），重新发起上传即可重试",
+		"911045": "client_id 与包名不匹配（检查 API 客户端与应用的归属关系）",
+		"300002": "api_sign 签名错误（检查 client_secret 与系统时间偏移）"
 	};
 	/** stage 产物暂存（apkUrl/md5），submit 按 pkgName 取回 */
 	staged = /* @__PURE__ */ new Map();
@@ -1327,7 +1331,7 @@ var OppoChannel = class {
 	}
 	async submit(ctx) {
 		const auth = await this.auth(ctx);
-		const appInfo = checkErrno(await oppoApi("/resource/v1/app/info", auth, { pkgName: auth.pkgName }, "GET", "查询应用详情"), "查询应用详情").data ?? {};
+		const appInfo = checkErrno(await oppoApi("/resource/v1/app/info", auth, { pkg_name: auth.pkgName }, "GET", "查询应用详情"), "查询应用详情").data ?? {};
 		let staged = this.staged.get(auth.pkgName);
 		if (!staged) {
 			ctx.emit({
@@ -1363,6 +1367,7 @@ var OppoChannel = class {
 			};
 		}
 		checkErrno(upd, "发布版本");
+		await this.pollTaskState(ctx, auth, versionCode);
 		ctx.emit({
 			type: "phase",
 			phase: "done",
@@ -1374,8 +1379,46 @@ var OppoChannel = class {
 		};
 	}
 	/**
+	* app/upd 异步任务结果轮询: POST /resource/v1/app/task-state（业务参数 pkg_name+version_code，
+	* 现行文档「获取任务状态」）。task_state: 1=待处理（继续等）、2=处理成功、3=处理失败（err_msg 透出）；
+	* 间隔 10s × 最多 5 次，超时视为已受理但异步结果未知（warn 提示，稍后可用 status 查询审核状态）。
+	*/
+	async pollTaskState(ctx, auth, versionCode) {
+		for (let attempt = 1; attempt <= TASK_STATE_MAX_POLLS; attempt++) {
+			await sleep(TASK_STATE_POLL_INTERVAL_MS);
+			const st = checkErrno(await oppoApi("/resource/v1/app/task-state", auth, {
+				pkg_name: auth.pkgName,
+				version_code: versionCode
+			}, "POST", "查询任务状态"), "查询任务状态");
+			const taskState = st.data?.["task_state"];
+			if (taskState === 2) {
+				ctx.emit({
+					type: "progress",
+					detail: `任务处理成功（task_state=2，第 ${attempt} 次轮询确认）`
+				});
+				return;
+			}
+			if (taskState === 3) {
+				const errMsg = st.data?.["err_msg"];
+				throw new Error(`OPPO 发布任务处理失败（task_state=3）: ${typeof errMsg === "string" && errMsg ? errMsg : JSON.stringify(st.data).slice(0, 200)}`);
+			}
+			ctx.emit({
+				type: "progress",
+				detail: `任务处理中（task_state=${String(taskState)}，第 ${attempt}/${TASK_STATE_MAX_POLLS} 次）`
+			});
+		}
+		ctx.emit({
+			type: "warn",
+			message: `任务状态轮询 ${TASK_STATE_MAX_POLLS} 次未到终态：app/upd 已受理但异步处理结果未知，请稍后用 status 查询审核状态`
+		});
+	}
+	/**
 	* 审核状态查询: GET /resource/v1/app/info（公共参数 + api_sign，同 stage）
-	* → data.audit_status（android-publish oppo_query.py: 1=待提审 2=审核中 3=通过 4=驳回）。
+	* → data.audit_status 按现行「审核状态对照表」映射（id=10998）:
+	*   1=审核中、4=运营审核中 → reviewing；2=审核通过、6=运营通过 → approved；111=上线 → approved+live；
+	*   3=测试不通过、5=运营打回、444=审核不通过 → rejected（原因读 refuse_reason，原样透出不解析）；
+	*   0=未发布、7=定时发布、22=已冻结 → unknown+raw；其余编号（00/11/-11 资质类、222 下架等）→ unknown。
+	* 旧映射（1=待提审 2=审核中 3=通过 4=驳回，出自 python oppo_query.py）与现行对照表整体错位，已重写。
 	*/
 	async status(ctx) {
 		const clientId = this.required(ctx, "OPPO_CLIENT_ID");
@@ -1385,7 +1428,7 @@ var OppoChannel = class {
 			clientId,
 			clientSecret,
 			token: await getOppoToken(clientId, clientSecret)
-		}, { pkgName }, "GET", "查询审核状态"), "查询审核状态");
+		}, { pkg_name: pkgName }, "GET", "查询审核状态"), "查询审核状态");
 		const data = info.data ?? {};
 		const auditStatus = data["audit_status"] ?? data["auditStatus"];
 		if (auditStatus === void 0) return {
@@ -1398,21 +1441,37 @@ var OppoChannel = class {
 			raw: `audit_status=${String(auditStatus)}`
 		};
 		switch (num) {
-			case 2: return { state: "reviewing" };
-			case 3: return {
+			case 1:
+			case 4: return { state: "reviewing" };
+			case 2:
+			case 6: return {
+				state: "approved",
+				live: false
+			};
+			case 111: return {
 				state: "approved",
 				live: true
 			};
-			case 4: {
+			case 3:
+			case 5:
+			case 444: {
 				const reason = data["refuse_reason"];
 				return {
 					state: "rejected",
 					reason: typeof reason === "string" && reason ? reason : void 0
 				};
 			}
-			case 1: return {
+			case 0: return {
+				state: "unknown",
+				raw: "未发布（audit_status=0）"
+			};
+			case 7: return {
+				state: "unknown",
+				raw: "定时发布（audit_status=7）"
+			};
+			case 22: return {
 				state: "unknown",
-				raw: "待提审（audit_status=1）"
+				raw: "已冻结（audit_status=22）"
 			};
 			default: return {
 				state: "unknown",
@@ -1463,8 +1522,10 @@ var VivoChannel = class {
 		status: true
 	};
 	errorHints = {
-		"1002": "参数缺失或不合法（常见：更新说明少于 5 字）",
-		"46001": "访问频率超限（正式环境每接口 50 次/天）"
+		"10001": "签名校验失败（检查 VIVO_ACCESS_SECRET 是否正确）",
+		"10005": "时间戳失效（检查系统时间偏差）",
+		"10011": "当天调用次数超限（约 50 次/天）",
+		"12010": "应用审核中，不允许更新"
 	};
 	/**
 	* stage→submit 之间传递上传结果：Channel 接口不透传 ref，
@@ -1574,6 +1635,7 @@ var VivoChannel = class {
 		if (!serialnumber) throw new Error("vivo 提审缺少 serialnumber（上传未返回）");
 		const updateDesc = (ctx.updateDescription ?? "").trim();
 		if (updateDesc.length < 5) throw new Error(`vivo 提审 updateDesc 需 5-200 字（当前 ${updateDesc.length} 字），请提供更新说明`);
+		if (updateDesc.length > 200) throw new Error(`vivo 提审 updateDesc 需 5-200 字（当前 ${updateDesc.length} 字，超出上限），请精简更新说明`);
 		const { accessKey, accessSecret } = this.creds(ctx);
 		ctx.emit({
 			type: "phase",
@@ -1602,6 +1664,7 @@ var VivoChannel = class {
 	* 审核状态查询: 复用 app.query.details 的 data.auditStatus（对拍 python vivo_query.py；
 	* 未确证的 app.audit.status method 已删——python/apkgo 均无此调用）。
 	* 映射 0=审核通过 1=审核中 2=驳回 沿自 v1，待真机校准；
+	* 注意：该编号映射未在现行中国站文档成文（国际站同型接口字典编号整体错一位），需真机校准；
 	* 交叉见证：apkgo vivo.go 读 data.status 且编号不同（1草稿/2待审核/3通过/4不通过/5撤销），冲突以真机为准。
 	*/
 	async status(ctx) {
@@ -1701,6 +1764,24 @@ async function honorPost(apiPath, token, bodyObj, context) {
 async function honorPostQ(apiPath, appId, token, bodyObj, context) {
 	return honorPost(`${apiPath}?${new URLSearchParams({ appId }).toString()}`, token, bodyObj, context);
 }
+/** 带 appId query 的 GET（查询类接口，仅 Bearer 鉴权无 body） */
+async function honorGetQ(apiPath, appId, token, context) {
+	const qs = new URLSearchParams({ appId }).toString();
+	const res = await fetch(`${PUBLISH_BASE}${apiPath}?${qs}`, {
+		method: "GET",
+		headers: { Authorization: `Bearer ${token}` },
+		signal: AbortSignal.timeout(6e4)
+	});
+	const text = await res.text();
+	let json;
+	try {
+		json = JSON.parse(text);
+	} catch {
+		throw new Error(`荣耀 ${context}返回非 JSON（HTTP ${res.status}）: ${text.slice(0, 300)}`);
+	}
+	if (json.code !== 0) throw new Error(`荣耀 ${context}失败 code=${json.code} ${json.msg ?? ""}: ${text.slice(0, 200)}`);
+	return json;
+}
 /** RFC3339 → 荣耀定时发布格式：偏移不带冒号（+08:00→+0800）、Z→+0000，如 2026-06-20T10:00:00+0800（形状参照 apkgo submitAudit） */
 function honorReleaseTime(rfc3339) {
 	const converted = rfc3339.replace(/([+-]\d{2}):(\d{2})$/, "$1$2").replace(/Z$/, "+0000");
@@ -1717,6 +1798,10 @@ var HonorChannel = class {
 		status: true
 	};
 	errorHints = {
+		"10003": "token 过期（CLI 每次现取，若出现请重试）",
+		"20022": "已有审核中的版本，需等待审核完成后再提交",
+		"30006": "版本号必须大于等于已上架版本",
+		"30011": "提交过于频繁，请稍后再试",
 		"100030001": "认证失败：Client ID/Secret 无效或未开通 API 权限",
 		"100030002": "token 过期（CLI 每次现取，若出现请重试）"
 	};
@@ -1791,7 +1876,19 @@ var HonorChannel = class {
 		const appId = required$2(ctx, "appId");
 		const token = await this.fetchToken(ctx);
 		if (ctx.updateDescription) try {
-			await honorPostQ("/openapi/v1/publish/update-language-info", appId, token, { newFeature: ctx.updateDescription }, "更新文案");
+			if (ctx.updateDescription.length > 500) throw new Error(`更新文案超过 500 字（当前 ${ctx.updateDescription.length} 字）`);
+			const detail = await honorPostQ("/openapi/v1/publish/get-app-detail", appId, token, {}, "查询应用详情");
+			const { appName, intro } = detail.data ?? {};
+			if (!appName || !intro) throw new Error(`应用详情缺 appName/intro: ${JSON.stringify(detail.data ?? {}).slice(0, 200)}`);
+			await honorPostQ("/openapi/v1/publish/update-language-info", appId, token, {
+				languageInfoList: [{
+					languageId: "zh-CN",
+					appName,
+					intro,
+					newFeature: ctx.updateDescription
+				}],
+				setAll: 0
+			}, "更新文案");
 		} catch (e) {
 			ctx.emit({
 				type: "warn",
@@ -1817,14 +1914,11 @@ var HonorChannel = class {
 		};
 	}
 	async status(ctx) {
-		const appId = required$2(ctx, "appId", "审核状态查询必需");
-		const appIdNum = Number(appId);
-		if (!Number.isFinite(appIdNum)) throw new Error(`荣耀 appId 非数字: ${appId}（get-audit-result 要求 body 内为数字）`);
-		const json = await honorPost("/openapi/v1/publish/get-audit-result", await this.fetchToken(ctx), { appId: [{ appId: appIdNum }] }, "查询审核结果");
-		const item = json.data?.[0];
+		const json = await honorGetQ("/openapi/v1/publish/get-app-current-release", required$2(ctx, "appId", "审核状态查询必需"), await this.fetchToken(ctx), "查询审核状态");
+		const item = json.data;
 		if (!item || item.auditResult === void 0) return {
 			state: "unknown",
-			raw: `get-audit-result 无数据: ${JSON.stringify(json).slice(0, 200)}`
+			raw: `get-app-current-release 无数据: ${JSON.stringify(json).slice(0, 200)}`
 		};
 		switch (item.auditResult) {
 			case 0: return { state: "reviewing" };
@@ -1838,7 +1932,7 @@ var HonorChannel = class {
 			};
 			case 3: return {
 				state: "unknown",
-				raw: "非审核状态（auditResult=3）"
+				raw: "未提交审核（auditResult=3）"
 			};
 			case 4: return {
 				state: "unknown",
@@ -1863,7 +1957,7 @@ function required$2(ctx, key, where) {
 * 腾讯应用宝（安卓 APK）渠道。
 * 权威: AngChow/android-publish scripts/_yyb_common.py + submit_apk.py + query_status.py（MIT），apkgo pkg/store/tencent 交叉验证
 * 官方文档: https://wikinew.open.qq.com/index.html#/iwiki/4015262492
-* v2 链路: query_app_detail（校验应用 + 取线上版本）→ get_file_upload_info（pkg_name/app_id/file_type=apk/file_name → COS 预签名 URL + serial_number）
+* v2 链路: query_app_detail（校验应用）→ get_file_upload_info（pkg_name/app_id/file_type=apk/file_name → COS 预签名 URL + serial_number）
 *   → PUT 预签名 URL 直传 COS（预签名自带鉴权，无需自签 sign）→ update_app 提审（serial_number + md5）
 * 签名: HmacSHA256（公共参数 user_id + timestamp(秒) + 业务参数，按 key ASCII 升序）——仅 open API 需要，COS 上传不需要
 * 限额: 上传 100 次/天、更新 50 次/天；审核状态 audit_status 1=审核中 2=驳回 3=通过 8=撤销
@@ -1928,13 +2022,16 @@ var YybChannel = class {
 			type: "progress",
 			detail: "查询应用详情"
 		});
-		const appInfo = (await yybApi("/query_app_detail", {
+		const detail = await yybApi("/query_app_detail", {
 			userId,
 			accessSecret
-		}, { app_id: appId })).app_info ?? {};
+		}, {
+			pkg_name: pkgName,
+			app_id: appId
+		});
 		ctx.emit({
 			type: "progress",
-			detail: `${appInfo.app_name ?? ""} 线上版本 ${appInfo.version ?? "?"}`
+			detail: `应用「${detail.app_name ?? appId}」校验通过`
 		});
 		const upInfo = await yybApi("/get_file_upload_info", {
 			userId,
@@ -2072,9 +2169,13 @@ var YybChannel = class {
 *   5. GET  /api/publish/v3/package/compile/status  轮询编译（0=成功 2=拒绝终态 其他=编译中）
 *   6. POST /api/publish/v3/app-submit           提审（ret 204144719/204144727 = 编译中可重试）
 *
-* 内测测试发布（ctx.target.releaseType === '6'，Upload Management API）:
-*   upload-url/for-obs 带 releaseType=6，传 .hap 即可，后续在 AGC 控制台「测试」中指定测试设备（不做自动提审）。
-* 官方文档: https://developer.huawei.com/consumer/cn/doc/app/agc-help-upload-api-guide-0000002271160549
+* 测试发布（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
+*   1. POST /api/publish/v2/test/app/version                   新建测试版本（testType 3=邀请测试）→ versionId
+*   2. POST /api/publish/v2/test/version/pkg                   添加测试软件包（distributeMode=1）→ pkgId
+*   3. GET  /api/publish/v3/package/compile/status             轮询云端编译
+*   4. PUT  /api/publish/v2/test/app/version                   {versionId, pkgId} 绑定；提交审核/测试群组由控制台人工完成。
+* 官方文档: https://developer.huawei.com/consumer/cn/doc/doccenter-connect-api/agc-help-test-api-guide-0000002236015562
 */
 const BASE = "https://connect-api.cloud.huawei.com/api";
 const COMPILE_TIMEOUT_MS = 9e5;
@@ -2100,11 +2201,16 @@ async function agcJson(url, init, context) {
 * appId 缺省时由渠道内部调用，也可独立复用。
 */
 async function getHarmonyAppId(opts) {
-	const qs = new URLSearchParams({ packageTypes: "7" });
+	const qs = new URLSearchParams({
+		packageTypes: "7",
+		packageName: opts.bundleName
+	});
 	const json = await agcJson(`${BASE}/publish/v2/appid-list?${qs}`, { headers: {
 		client_id: opts.clientId,
 		Authorization: `Bearer ${opts.token}`
 	} }, "查询应用列表");
+	const fresh = json.appids?.[0]?.value;
+	if (fresh) return fresh;
 	const list = json.appIds ?? json.appIdList ?? [];
 	const hit = (Array.isArray(list) ? list : []).find((e) => String(e.bundleName ?? e.BundleName ?? "").toLowerCase() === opts.bundleName.toLowerCase());
 	if (!hit) throw new Error(`AGC 未找到 bundleName=${opts.bundleName} 的鸿蒙应用（packageTypes=7）`);
@@ -2172,7 +2278,7 @@ var AgcHarmonyChannel = class {
 			artifactVersion: "",
 			action: "stage-only",
 			afterApproval: "none(beta)",
-			notes: "releaseType=6 测试发布：仅上传+绑定，到 AGC 控制台「测试」指定测试设备，不提审"
+			notes: "Testing API 邀请测试：上传→新建测试版本→绑定软件包；提交审核与测试群组到控制台完成，不自动提审"
 		};
 		return {
 			channel: this.id,
@@ -2203,7 +2309,7 @@ var AgcHarmonyChannel = class {
 	async submit(ctx) {
 		if (ctx.target.releaseType === "6") return {
 			ok: false,
-			error: "AGC 测试发布（releaseType=6）不做自动提审，请到 AGC 控制台「测试」中指定测试设备"
+			error: "AGC 测试发布（releaseType=6）不做自动提审，请到 AGC 控制台「测试」提交测试版本并指定测试群组"
 		};
 		const { clientId, token, headers } = await this.authHeaders(ctx);
 		const appId = await this.resolveAppId(ctx, clientId, token);
@@ -2213,36 +2319,11 @@ var AgcHarmonyChannel = class {
 			message: "token 获取成功"
 		});
 		const { packageId } = await this.uploadFormal(ctx, appId, headers);
-		if (packageId) {
-			ctx.emit({
-				type: "phase",
-				phase: "wait",
-				message: `等待 AGC 云端编译（packageId: ${packageId}）`
-			});
-			const deadline = Date.now() + COMPILE_TIMEOUT_MS;
-			for (;;) {
-				const stQs = new URLSearchParams({
-					appId,
-					pkgIds: packageId
-				});
-				const st = await agcJson(`${BASE}/publish/v3/package/compile/status?${stQs}`, { headers }, "查询编译状态");
-				const s = (st.pkgStateList?.find((p) => p.pkgId === packageId) ?? st.pkgStateList?.[0])?.successStatus;
-				if (s === 0) {
-					ctx.emit({
-						type: "progress",
-						detail: "软件包编译完成"
-					});
-					break;
-				}
-				if (s === 2) throw new Error(`AGC 编译拒绝（packageId ${packageId}）：签名/证书/bundleName 不匹配，到 AGC 控制台核对`);
-				if (Date.now() > deadline) throw new Error(`AGC 编译超时（${COMPILE_TIMEOUT_MS / 6e4} 分钟，packageId ${packageId}）`);
-				ctx.emit({
-					type: "progress",
-					detail: `编译中（successStatus=${s}），${COMPILE_POLL_MS / 1e3}s 后重查…`
-				});
-				await sleep(COMPILE_POLL_MS);
-			}
-		}
+		if (packageId) await this.awaitCompile(ctx, appId, packageId, headers);
+		if (!ctx.updateDescription) ctx.emit({
+			type: "warn",
+			message: "未提供更新说明（--note）：AGC 升级版本要求 newFeatures 必填，提审可能被拒"
+		});
 		ctx.emit({
 			type: "phase",
 			phase: "submit"
@@ -2279,6 +2360,37 @@ var AgcHarmonyChannel = class {
 			return { ok: true };
 		}
 	}
+	/** 轮询软件包云端编译：successStatus 0=成功 2=拒绝（终态，多为签名/证书/bundleName 不匹配）其他=编译中 */
+	async awaitCompile(ctx, appId, pkgId, headers) {
+		ctx.emit({
+			type: "phase",
+			phase: "wait",
+			message: `等待 AGC 云端编译（pkgId: ${pkgId}）`
+		});
+		const deadline = Date.now() + COMPILE_TIMEOUT_MS;
+		for (;;) {
+			const stQs = new URLSearchParams({
+				appId,
+				pkgIds: pkgId
+			});
+			const st = await agcJson(`${BASE}/publish/v3/package/compile/status?${stQs}`, { headers }, "查询编译状态");
+			const s = (st.pkgStateList?.find((p) => p.pkgId === pkgId) ?? st.pkgStateList?.[0])?.successStatus;
+			if (s === 0) {
+				ctx.emit({
+					type: "progress",
+					detail: "软件包编译完成"
+				});
+				return;
+			}
+			if (s === 2) throw new Error(`AGC 编译拒绝（pkgId ${pkgId}）：签名/证书/bundleName 不匹配，到 AGC 控制台核对`);
+			if (Date.now() > deadline) throw new Error(`AGC 编译超时（${COMPILE_TIMEOUT_MS / 6e4} 分钟，pkgId ${pkgId}）`);
+			ctx.emit({
+				type: "progress",
+				detail: `编译中（successStatus=${s}），${COMPILE_POLL_MS / 1e3}s 后重查…`
+			});
+			await sleep(COMPILE_POLL_MS);
+		}
+	}
 	async status() {
 		return {
 			state: "unknown",
@@ -2355,15 +2467,21 @@ var AgcHarmonyChannel = class {
 			packageId
 		};
 	}
-	/** v1 uploadToAgc（releaseType=6 测试发布）：上传 → 绑定（不阻断）→ 文案（不阻断），不提审 */
+	/**
+	* 测试发布（releaseType=6，2026-10 起走 Testing API——旧 app-package-info 直绑链路已被华为下线，
+	* 其 releaseType 枚举仅剩 1=全网 / 7=企业非公开）：
+	* 上传 .hap → 新建测试版本（testType=3 邀请测试）→ 添加测试软件包 → 等云端编译 → 更新测试版本绑定；
+	* 不自动提交审核，测试群组/邀请码由控制台人工完成。
+	*/
 	async uploadBeta(ctx, appId, headers) {
 		const fileName = path.basename(ctx.artifactPath);
 		const contentLength = fs.statSync(ctx.artifactPath).size;
 		const sha256 = sha256File(ctx.artifactPath);
+		if (path.extname(ctx.artifactPath).toLowerCase() !== ".app") throw new Error("AGC 测试发布需要 .app 整包（DevEco「构建 App」产物，发布签名）；Testing API 不再接受 .hap（实测 204144641）");
 		ctx.emit({
 			type: "phase",
 			phase: "upload",
-			message: `AGC 上传 ${fileName}（${formatSize(contentLength)}，releaseType=6 测试发布）`
+			message: `AGC 上传 ${fileName}（${formatSize(contentLength)}，测试发布）`
 		});
 		const qs = new URLSearchParams({
 			appId,
@@ -2376,6 +2494,7 @@ var AgcHarmonyChannel = class {
 		const urlInfo = urlJson.urlInfo ?? urlJson;
 		const objectId = urlInfo.objectId ?? "";
 		if (!urlInfo.url) throw new Error(`AGC 返回的上传地址为空: ${JSON.stringify(urlJson).slice(0, 300)}`);
+		if (!objectId) throw new Error("AGC 上传响应缺 objectId（Testing API 添加软件包必需）");
 		ctx.emit({
 			type: "progress",
 			detail: "上传地址获取成功（5 分钟内有效）"
@@ -2399,46 +2518,59 @@ var AgcHarmonyChannel = class {
 			type: "progress",
 			detail: "文件上传完成"
 		});
-		if (objectId) try {
-			const bindQs = new URLSearchParams({
-				appId,
-				releaseType: "6"
-			});
-			await agcJson(`${BASE}/publish/v3/app-package-info?${bindQs}`, {
-				method: "PUT",
-				headers: {
-					...headers,
-					"Content-Type": "application/json"
-				},
-				body: JSON.stringify({
+		const versionId = (await agcJson(`${BASE}/publish/v2/test/app/version?appId=${encodeURIComponent(appId)}`, {
+			method: "POST",
+			headers: {
+				...headers,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({
+				releaseType: 6,
+				testType: 3,
+				testDesc: (ctx.updateDescription ?? "applift 测试发布").slice(0, 50)
+			})
+		}, "新建测试版本")).versionId ?? "";
+		if (!versionId) throw new Error("AGC 新建测试版本未返回 versionId");
+		ctx.emit({
+			type: "phase",
+			phase: "bind",
+			message: `测试版本已创建（versionId: ${versionId}）`
+		});
+		const pkgId = (await agcJson(`${BASE}/publish/v2/test/version/pkg?appId=${encodeURIComponent(appId)}`, {
+			method: "POST",
+			headers: {
+				...headers,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({
+				distributeMode: 1,
+				file: {
 					fileName,
 					objectId
-				})
-			}, "绑定软件包");
-			ctx.emit({
-				type: "phase",
-				phase: "bind",
-				message: "软件包已绑定到应用"
-			});
-		} catch (e) {
-			ctx.emit({
-				type: "warn",
-				message: `软件包绑定未成功（不阻断，必要时到控制台手动关联）: ${e.message}`
-			});
-		}
-		const langQs = new URLSearchParams({
-			appId,
-			releaseType: "6"
-		});
-		await this.updateReleaseNotes(ctx, appId, headers, langQs);
+				}
+			})
+		}, "添加测试软件包")).pkgVersion?.[0] ?? "";
+		if (!pkgId) throw new Error("AGC 添加测试软件包未返回 pkgVersion");
+		await this.awaitCompile(ctx, appId, pkgId, headers);
+		await agcJson(`${BASE}/publish/v2/test/app/version?appId=${encodeURIComponent(appId)}`, {
+			method: "PUT",
+			headers: {
+				...headers,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({
+				versionId,
+				pkgId
+			})
+		}, "绑定测试软件包");
 		ctx.emit({
 			type: "phase",
 			phase: "done",
-			message: "测试包已上传；后续在 AGC 控制台「我的应用 → 测试」中查看并指定测试设备/人员"
+			message: "测试版本已就绪（未提交审核）；到 AGC 控制台「测试」提交并指定测试群组"
 		});
 		return {
 			ok: true,
-			ref: objectId
+			ref: versionId
 		};
 	}
 	/** v1 更新文案段（releaseHarmonyApp step 4 / uploadToAgc 尾段）：查默认语言 → 写 newFeatures，失败仅警告不阻断 */
@@ -2544,6 +2676,8 @@ async function ascRequest(jwt, apiPath, method, body) {
 *
 * - 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 本身仍可用，暂保留）。
 *   约定 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）
@@ -2644,11 +2778,11 @@ var AscChannel = class {
 	}
 	/**
 	* 提审 App Store —— 按 ASC 官方文档新实现，未经真实链路验证。
-	* 文档: appStoreVersionSubmissions / Create a Version Submission
+	* 文档: 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 + earlyReleaseDate）
-	*   → 绑定构建到版本 → POST appStoreVersionSubmissions 进入审核
+	*   （releaseType 默认 MANUAL，ctx.releaseTime 提供时 SCHEDULED + earliestReleaseDate）
+	*   → 绑定构建到版本 → reviewSubmissions 三步流提交进入审核
 	*/
 	async submit(ctx) {
 		const { keyId, issuerId, p8Path } = this.resolveAuth(ctx);
@@ -2683,9 +2817,9 @@ var AscChannel = class {
 		const releaseType = ctx.releaseTime ? "SCHEDULED" : "MANUAL";
 		const releaseAttrs = ctx.releaseTime ? {
 			releaseType,
-			earlyReleaseDate: ctx.releaseTime
+			earliestReleaseDate: ctx.releaseTime
 		} : { releaseType };
-		const versions = await ascGet(jwt, `/v1/apps/${app.id}/appStoreVersions?filter[platform]=IOS&filter[appStoreState]=PREPARE_FOR_SUBMISSION,READY_FOR_SUBMISSION&limit=5`);
+		const versions = await ascGet(jwt, `/v1/apps/${app.id}/appStoreVersions?filter[platform]=IOS&filter[appVersionState]=PREPARE_FOR_SUBMISSION&limit=5`);
 		let versionId = versions.data[0]?.id;
 		if (versionId) {
 			await ascRequest(jwt, `/v1/appStoreVersions/${versionId}`, "PATCH", { data: {
@@ -2722,13 +2856,27 @@ var AscChannel = class {
 			type: "builds",
 			id: build.id
 		}] });
-		const submission = await ascRequest(jwt, "/v1/appStoreVersionSubmissions", "POST", { data: {
-			type: "appStoreVersionSubmissions",
+		const reviewSubmissionId = (await ascRequest(jwt, "/v1/reviewSubmissions", "POST", { data: {
+			type: "reviewSubmissions",
+			attributes: {},
+			relationships: { app: { data: {
+				type: "apps",
+				id: app.id
+			} } }
+		} })).data?.id;
+		if (!reviewSubmissionId) throw new Error("ASC 创建 reviewSubmission 未返回 id");
+		await ascRequest(jwt, `/v1/reviewSubmissions/${reviewSubmissionId}/items`, "POST", { data: {
+			type: "reviewSubmissionItems",
+			attributes: {},
 			relationships: { appStoreVersion: { data: {
 				type: "appStoreVersions",
 				id: versionId
 			} } }
 		} });
+		await ascRequest(jwt, `/v1/reviewSubmissions/${reviewSubmissionId}`, "PATCH", { data: {
+			type: "reviewSubmissions",
+			attributes: { action: "SUBMIT" }
+		} });
 		ctx.emit({
 			type: "phase",
 			phase: "done",
@@ -2736,7 +2884,7 @@ var AscChannel = class {
 		});
 		return {
 			ok: true,
-			ref: submission.data?.id
+			ref: reviewSubmissionId
 		};
 	}
 	async status() {
@@ -2939,6 +3087,7 @@ var GooglePlayChannel = class {
 			type: "progress",
 			detail: `上传成功（versionCode: ${versionCode}）`
 		});
+		const releases = [...(await apiFetch(`${API_BASE}/${pkgName}/edits/${editId}/tracks/${track}`, token, { method: "GET" }, `读取 ${track} 轨道现有 releases`)).releases ?? []];
 		const release = {
 			versionCodes: [versionCode],
 			status: "completed"
@@ -2947,9 +3096,14 @@ var GooglePlayChannel = class {
 			language: "zh-CN",
 			text: releaseNotes
 		}];
+		const target = releases.find((r) => r.status === "completed");
+		if (target) {
+			target.versionCodes = [...target.versionCodes ?? [], versionCode];
+			if (release.releaseNotes) target.releaseNotes = release.releaseNotes;
+		} else releases.push(release);
 		await apiFetch(`${API_BASE}/${pkgName}/edits/${editId}/tracks/${track}`, token, {
 			method: "PUT",
-			body: JSON.stringify({ releases: [release] })
+			body: JSON.stringify({ releases })
 		}, `部署 ${track} 轨道`);
 		ctx.emit({
 			type: "phase",
@@ -2967,7 +3121,7 @@ var GooglePlayChannel = class {
 	async status(ctx) {
 		const pkgName = this.requirePkgName(ctx);
 		const token = await getAccessToken(ctx.credentials);
-		const release = (await apiFetch(`${API_BASE}/${pkgName}/edits/-/tracks/production`, token, { method: "GET" }, "查询 production 轨道")).releases?.[0];
+		const release = (await apiFetch(`${API_BASE}/${pkgName}/tracks/production`, token, { method: "GET" }, "查询 production 轨道")).releases?.[0];
 		if (!release || !release.status) return {
 			state: "unknown",
 			raw: "production 轨道无 release"

package/package.json

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