@applift/core 0.1.3 → 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;
   };
@@ -343,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
@@ -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,
@@ -2223,6 +2320,10 @@ var AgcHarmonyChannel = class {
 		});
 		const { packageId } = await this.uploadFormal(ctx, appId, headers);
 		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"
@@ -2575,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）
@@ -2675,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);
@@ -2714,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: {
@@ -2753,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",
@@ -2767,7 +2884,7 @@ var AscChannel = class {
 		});
 		return {
 			ok: true,
-			ref: submission.data?.id
+			ref: reviewSubmissionId
 		};
 	}
 	async status() {
@@ -2970,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"
@@ -2978,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",
@@ -2998,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.3",
+  "version": "0.2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/hcg1023/applift.git",