@applift/core 0.9.0 → 0.10.0

package/dist/{artifact-B2RCmWw9.mjs → artifact-DFD8C7bE.mjs}

@@ -966,6 +966,101 @@ function writeProjectVersions(cwd, framework, writes) {
 	};
 }
 //#endregion
+//#region src/version/beta-version.ts
+const PLATFORM_VERSION_CAPS = {
+	ios: {
+		maxSegments: 3,
+		prerelease: "reject",
+		note: "TestFlight / App Store 要求 1–3 段非负整数"
+	},
+	android: {
+		maxSegments: 4,
+		prerelease: "allow",
+		note: "Gradle 不校验，商店要求数字点分"
+	},
+	harmony: {
+		maxSegments: 4,
+		prerelease: "warn",
+		note: "官方文档要求仅由数字和点构成（构建期 schema 实测放行）"
+	}
+};
+const DEFAULT_BETA_VERSION_CONFIG = {
+	mode: "offset",
+	segment: "patch",
+	delta: 1e3
+};
+/** 平台能力查表：只认自有键，避免 platform="constructor" 拿到原型上的函数 */
+function capsOf(platform) {
+	return Object.hasOwn(PLATFORM_VERSION_CAPS, platform) ? PLATFORM_VERSION_CAPS[platform] : void 0;
+}
+/** 拆 versionName：数字段数 + prerelease（4.0.0-beta.1 → 3 段 + "beta.1"） */
+function shapeOf(name) {
+	const m = /^(\d+(?:\.\d+)*)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/.exec(name.trim());
+	if (!m) return null;
+	return {
+		segments: m[1].split(".").length,
+		...m[2] ? { prerelease: m[2] } : {}
+	};
+}
+/** 完整检查（段数 + prerelease 政策）；返回问题描述，null = 可用 */
+function checkVersionNameShape(name, platform) {
+	const caps = capsOf(platform);
+	const shape = shapeOf(name);
+	if (!shape) return `versionName「${name}」不是「数字段 + 可选 prerelease」形态`;
+	if (!caps) return null;
+	if (shape.segments > caps.maxSegments) return `${platform} 的 versionName 最多 ${caps.maxSegments} 段数字（${caps.note}）：${name}`;
+	if (shape.prerelease && caps.prerelease === "reject") return `${platform} 的 versionName 不支持 prerelease 后缀（${caps.note}）：${name}`;
+	return null;
+}
+/**
+* 派生测试版本名。
+* 硬约束（段数超限 / iOS prerelease）直接抛错；harmony 的 prerelease 只告警（见 assertBetaVersionSupported）。
+*/
+function betaVersionName(ctx) {
+	const name = deriveName(ctx, ctx.config ?? DEFAULT_BETA_VERSION_CONFIG);
+	const caps = capsOf(ctx.platform);
+	const shape = shapeOf(name);
+	if (!shape) throw new Error(`派生出的 versionName「${name}」不是合法版本号形态`);
+	if (caps) {
+		if (shape.segments > caps.maxSegments) throw new Error(`${ctx.platform} 的 versionName 最多 ${caps.maxSegments} 段数字（${caps.note}）：${name}——改用 version.beta.mode=offset（segment=patch）或 app-id`);
+		if (shape.prerelease && caps.prerelease === "reject") throw new Error(`${ctx.platform} 的 versionName 不支持 prerelease 后缀（${caps.note}）：${name}——改用 version.beta.mode=offset（segment=patch）或 app-id`);
+	}
+	return name;
+}
+function deriveName(ctx, config) {
+	if (config.mode === "app-id") return ctx.base;
+	if (config.mode === "suffix") {
+		const template = config.template ?? "{base}-beta";
+		if (template.includes("{n}")) throw new Error(`version.beta.template 不支持 {n}（需要递增序号请用 mode=offset）：${template}`);
+		return template.replace(/\{base\}/g, ctx.base);
+	}
+	const m = /^(\d+)\.(\d+)\.(\d+)$/.exec(ctx.base);
+	if (!m) throw new Error(`工程 versionName「${ctx.base}」不是 X.Y.Z：version.beta.mode=offset 需要三段数字作为基线`);
+	const major = Number(m[1]);
+	const minor = Number(m[2]);
+	const patch = Number(m[3]);
+	const delta = config.delta ?? 1e3;
+	if (!Number.isInteger(delta) || delta <= 0) throw new Error(`version.beta.delta 必须是正整数（收到 ${String(delta)}）——否则测试包与正式版无法区分`);
+	return (config.segment ?? "patch") === "major" ? `${major + delta}.${minor}.${patch}` : `${major}.${minor}.${patch + delta}`;
+}
+/**
+* 平台支持性校验：返回告警（不阻断）；官方硬拒的组合抛错。
+* 供发布前调用——配置错在发版前暴露，不留到上传被拒。
+*/
+function assertBetaVersionSupported(ctx) {
+	const config = ctx.config ?? DEFAULT_BETA_VERSION_CONFIG;
+	const warnings = [];
+	if (config.mode === "app-id") return warnings;
+	const caps = capsOf(ctx.platform);
+	if (!caps) return warnings;
+	if (config.mode === "suffix" && caps.prerelease !== "allow") {
+		const msg = `${ctx.platform} 的 versionName ${caps.note}：version.beta.mode=suffix 在该平台不可用`;
+		if (caps.prerelease === "reject") throw new Error(`${msg}——改用 mode=offset（segment=patch）或 app-id`);
+		warnings.push(`${msg}（构建期放行，建议改用 offset）`);
+	}
+	return warnings;
+}
+//#endregion
 //#region src/version/artifact.ts
 /**
 * 产物版本读取（只读不写——版本号变更属开发提交，发版工具只负责读版本防回退）。
@@ -1042,4 +1137,4 @@ function fromAapt(artifactPath) {
 	}
 }
 //#endregion
-export { git as A, findArtifacts as C, collectReleaseDiff as D, subdirs as E, tagReleaseVersion as F, latestSemverTag as M, looseSemver as N, routeDelivery as O, statusShort as P, detectBundleIds as S, resolveFramework as T, rnFramework as _, electronAdapter as a, tauriFramework as b, flutterFramework as c, nativeAndroidFramework as d, nativeHarmonyAdapter as f, rnAdapter as g, nativeIosFramework as h, redactText as i, isGitRepo as j, commitsSince as k, knownFrameworkAdapters as l, nativeIosAdapter as m, readProjectVersions as n, electronFramework as o, nativeHarmonyFramework as p, writeProjectVersions as r, flutterAdapter as s, readArtifactVersion as t, nativeAndroidAdapter as u, suggestFramework as v, readJson as w, deps as x, tauriAdapter as y };
+export { resolveFramework as A, tagReleaseVersion as B, suggestFramework as C, detectBundleIds as D, deps as E, git as F, isGitRepo as I, latestSemverTag as L, collectReleaseDiff as M, routeDelivery as N, findArtifacts as O, commitsSince as P, looseSemver as R, rnFramework as S, tauriFramework as T, nativeHarmonyAdapter as _, betaVersionName as a, nativeIosFramework as b, writeProjectVersions as c, electronFramework as d, flutterAdapter as f, nativeAndroidFramework as g, nativeAndroidAdapter as h, assertBetaVersionSupported as i, subdirs as j, readJson as k, redactText as l, knownFrameworkAdapters as m, DEFAULT_BETA_VERSION_CONFIG as n, checkVersionNameShape as o, flutterFramework as p, PLATFORM_VERSION_CAPS as r, readProjectVersions as s, readArtifactVersion as t, electronAdapter as u, nativeHarmonyFramework as v, tauriAdapter as w, rnAdapter as x, nativeIosAdapter as y, statusShort as z };

package/dist/{frameworks-DJIt293o.d.mts → frameworks-B_GxUuWQ.d.mts}

@@ -195,11 +195,48 @@ declare const VersionCodeConfigSchema: z.ZodUnion<readonly [z.ZodLiteral<"increm
   platforms: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>]>;
 type VersionCodeConfig = z.infer<typeof VersionCodeConfigSchema>;
+/**
+ * 测试版本名策略：测试包与正式包的 versionName 必须不同（pushy 只认 packageVersion 字符串）。
+ * - offset：段偏移，默认 patch+1000（4.0.0 → 4.0.1000）——三段纯数字，iOS/Android/鸿蒙全通
+ * - suffix：semver prerelease（4.0.0-beta）——iOS TestFlight/App Store 硬拒，仅侧载可用
+ * - app-id：版本名不变，隔离交给两个 pushy 应用记录
+ */
+declare const BetaVersionConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
+  mode: z.ZodLiteral<"offset">;
+  segment: z.ZodDefault<z.ZodEnum<{
+    major: "major";
+    patch: "patch";
+  }>>;
+  delta: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  mode: z.ZodLiteral<"suffix">;
+  template: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+  mode: z.ZodLiteral<"app-id">;
+}, z.core.$strip>]>;
+/**
+ * 配置侧类型：用 z.input（字段带 .default 即为可选）。
+ * 用户写 `{ mode: 'offset' }` 也应合法——默认值由 schema 在 parse 时补齐。
+ */
+type BetaVersionConfig = z.input<typeof BetaVersionConfigSchema>;
 declare const VersionConfigSchema: z.ZodObject<{
   versionCode: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"increment">, z.ZodObject<{
     formula: z.ZodString;
     platforms: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$strip>]>>;
+  beta: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+    mode: z.ZodLiteral<"offset">;
+    segment: z.ZodDefault<z.ZodEnum<{
+      major: "major";
+      patch: "patch";
+    }>>;
+    delta: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"suffix">;
+    template: z.ZodDefault<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"app-id">;
+  }, z.core.$strip>]>>;
 }, z.core.$strip>;
 type VersionConfig = z.infer<typeof VersionConfigSchema>;
 declare const ProjectConfigSchema: z.ZodObject<{
@@ -231,6 +268,19 @@ declare const ProjectConfigSchema: z.ZodObject<{
       formula: z.ZodString;
       platforms: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>]>>;
+    beta: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
+      mode: z.ZodLiteral<"offset">;
+      segment: z.ZodDefault<z.ZodEnum<{
+        major: "major";
+        patch: "patch";
+      }>>;
+      delta: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+      mode: z.ZodLiteral<"suffix">;
+      template: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+      mode: z.ZodLiteral<"app-id">;
+    }, z.core.$strip>]>>;
   }, z.core.$strip>>;
   beta: z.ZodOptional<z.ZodObject<{
     pgyer: z.ZodOptional<z.ZodObject<{
@@ -426,6 +476,10 @@ interface AppliftPlugin {
     ref?: string;
     error?: string;
     artifactPath?: string;
+    /** 本次发布的平台（pipeline 由渠道计划解析后透传；基线上传类插件据此选对应用记录） */
+    platform?: string;
+    /** 发布阶段：beta=内测（测试包基线进 beta 应用记录）/ prod=正式。缺省由插件自行推断 */
+    target?: "beta" | "prod";
   }, ctx: HookContext): Promise<void> | void;
   "submit:before"?(plans: ReleasePlanEntry[], ctx: HookContext): Promise<ReleasePlanEntry[] | false | void> | ReleasePlanEntry[] | false | void;
   "submit:after"?(summary: PipelineSummary, ctx: HookContext): Promise<void> | void;
@@ -479,4 +533,4 @@ declare const knownFrameworkAdapters: FrameworkAdapter[];
 declare function suggestFramework(cwd: string): FrameworkAdapter | null;
 declare function tauriFramework(): AppliftPlugin;
 //#endregion
-export { StoreConfigSchema as $, routeDelivery as A, appendEntry as B, resolvePlugins as C, subdirs as Ct, PublishContext as D, FrameworkContext as E, runSubmit as F, CredentialsFileSchema as G, BetaConfig as H, HISTORY_PATH as I, GlobalConfig as J, CredentialsProfile as K, HistoryEntry as L, PipelineSummary as M, PipelineSummaryEntry as N, UpdateProvider as O, runStage as P, StoreConfig as Q, HistoryEvent as R, defineConfig as S, resolveFramework as St, DeliveryRoute as T, BetaConfigSchema as U, readEntries as V, CredentialsFile as W, ProjectConfig as X, GlobalConfigSchema as Y, ProjectConfigSchema as Z, AppliftPlugin as _, Platform as _t, knownFrameworkAdapters as a, VersionConfigSchema as at, PluginHookName as b, findArtifacts as bt, nativeHarmonyAdapter as c, ChannelContext as ct, nativeIosFramework as d, ReleasePlanEntry as dt, Stores as et, rnAdapter as f, ReviewStatus as ft, tauriFramework as g, FrameworkAdapter as gt, tauriAdapter as h, BundleIds as ht, flutterFramework as i, VersionConfig as it, PipelineInput as j, collectReleaseDiff as k, nativeHarmonyFramework as l, ChannelEvent as lt, suggestFramework as m, SubmitResult as mt, electronFramework as n, VersionCodeConfig as nt, nativeAndroidAdapter as o, Channel as ot, rnFramework as p, StageResult as pt, CredentialsProfileSchema as q, flutterAdapter as r, VersionCodeConfigSchema as rt, nativeAndroidFramework as s, ChannelCapabilities as st, electronAdapter as t, StoresSchema as tt, nativeIosAdapter as u, ChannelRegistry as ut, AppliftUserConfig as v, deps as vt, DeliveryJudgement as w, PluginHost as x, readJson as xt, HookContext as y, detectBundleIds as yt, HistoryQuery as z };
+export { ProjectConfigSchema as $, routeDelivery as A, appendEntry as B, resolvePlugins as C, readJson as Ct, PublishContext as D, FrameworkContext as E, runSubmit as F, BetaVersionConfigSchema as G, BetaConfig as H, HISTORY_PATH as I, CredentialsProfile as J, CredentialsFile as K, HistoryEntry as L, PipelineSummary as M, PipelineSummaryEntry as N, UpdateProvider as O, runStage as P, ProjectConfig as Q, HistoryEvent as R, defineConfig as S, findArtifacts as St, DeliveryRoute as T, subdirs as Tt, BetaConfigSchema as U, readEntries as V, BetaVersionConfig as W, GlobalConfig as X, CredentialsProfileSchema as Y, GlobalConfigSchema as Z, AppliftPlugin as _, BundleIds as _t, knownFrameworkAdapters as a, VersionCodeConfigSchema as at, PluginHookName as b, deps as bt, nativeHarmonyAdapter as c, Channel as ct, nativeIosFramework as d, ChannelEvent as dt, StoreConfig as et, rnAdapter as f, ChannelRegistry as ft, tauriFramework as g, SubmitResult as gt, tauriAdapter as h, StageResult as ht, flutterFramework as i, VersionCodeConfig as it, PipelineInput as j, collectReleaseDiff as k, nativeHarmonyFramework as l, ChannelCapabilities as lt, suggestFramework as m, ReviewStatus as mt, electronFramework as n, Stores as nt, nativeAndroidAdapter as o, VersionConfig as ot, rnFramework as p, ReleasePlanEntry as pt, CredentialsFileSchema as q, flutterAdapter as r, StoresSchema as rt, nativeAndroidFramework as s, VersionConfigSchema as st, electronAdapter as t, StoreConfigSchema as tt, nativeIosAdapter as u, ChannelContext as ut, AppliftUserConfig as v, FrameworkAdapter as vt, DeliveryJudgement as w, resolveFramework as wt, PluginHost as x, detectBundleIds as xt, HookContext as y, Platform as yt, HistoryQuery as z };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as StoreConfigSchema, A as routeDelivery, B as appendEntry, C as resolvePlugins, Ct as subdirs, D as PublishContext, E as FrameworkContext, F as runSubmit, G as CredentialsFileSchema, H as BetaConfig, I as HISTORY_PATH, J as GlobalConfig, K as CredentialsProfile, L as HistoryEntry, M as PipelineSummary, N as PipelineSummaryEntry, O as UpdateProvider, P as runStage, Q as StoreConfig, R as HistoryEvent, S as defineConfig, St as resolveFramework, T as DeliveryRoute, U as BetaConfigSchema, V as readEntries, W as CredentialsFile, X as ProjectConfig, Y as GlobalConfigSchema, Z as ProjectConfigSchema, _ as AppliftPlugin, _t as Platform, a as knownFrameworkAdapters, at as VersionConfigSchema, b as PluginHookName, bt as findArtifacts, c as nativeHarmonyAdapter, ct as ChannelContext, d as nativeIosFramework, dt as ReleasePlanEntry, et as Stores, f as rnAdapter, ft as ReviewStatus, g as tauriFramework, gt as FrameworkAdapter, h as tauriAdapter, ht as BundleIds, i as flutterFramework, it as VersionConfig, j as PipelineInput, k as collectReleaseDiff, l as nativeHarmonyFramework, lt as ChannelEvent, m as suggestFramework, mt as SubmitResult, n as electronFramework, nt as VersionCodeConfig, o as nativeAndroidAdapter, ot as Channel, p as rnFramework, pt as StageResult, q as CredentialsProfileSchema, r as flutterAdapter, rt as VersionCodeConfigSchema, s as nativeAndroidFramework, st as ChannelCapabilities, t as electronAdapter, tt as StoresSchema, u as nativeIosAdapter, ut as ChannelRegistry, v as AppliftUserConfig, vt as deps, w as DeliveryJudgement, x as PluginHost, xt as readJson, y as HookContext, yt as detectBundleIds, z as HistoryQuery } from "./frameworks-DJIt293o.mjs";
+import { $ as ProjectConfigSchema, A as routeDelivery, B as appendEntry, C as resolvePlugins, Ct as readJson, D as PublishContext, E as FrameworkContext, F as runSubmit, G as BetaVersionConfigSchema, H as BetaConfig, I as HISTORY_PATH, J as CredentialsProfile, K as CredentialsFile, L as HistoryEntry, M as PipelineSummary, N as PipelineSummaryEntry, O as UpdateProvider, P as runStage, Q as ProjectConfig, R as HistoryEvent, S as defineConfig, St as findArtifacts, T as DeliveryRoute, Tt as subdirs, U as BetaConfigSchema, V as readEntries, W as BetaVersionConfig, X as GlobalConfig, Y as CredentialsProfileSchema, Z as GlobalConfigSchema, _ as AppliftPlugin, _t as BundleIds, a as knownFrameworkAdapters, at as VersionCodeConfigSchema, b as PluginHookName, bt as deps, c as nativeHarmonyAdapter, ct as Channel, d as nativeIosFramework, dt as ChannelEvent, et as StoreConfig, f as rnAdapter, ft as ChannelRegistry, g as tauriFramework, gt as SubmitResult, h as tauriAdapter, ht as StageResult, i as flutterFramework, it as VersionCodeConfig, j as PipelineInput, k as collectReleaseDiff, l as nativeHarmonyFramework, lt as ChannelCapabilities, m as suggestFramework, mt as ReviewStatus, n as electronFramework, nt as Stores, o as nativeAndroidAdapter, ot as VersionConfig, p as rnFramework, pt as ReleasePlanEntry, q as CredentialsFileSchema, r as flutterAdapter, rt as StoresSchema, s as nativeAndroidFramework, st as VersionConfigSchema, t as electronAdapter, tt as StoreConfigSchema, u as nativeIosAdapter, ut as ChannelContext, v as AppliftUserConfig, vt as FrameworkAdapter, w as DeliveryJudgement, wt as resolveFramework, x as PluginHost, xt as detectBundleIds, y as HookContext, yt as Platform, z as HistoryQuery } from "./frameworks-B_GxUuWQ.mjs";
 //#region src/registry.d.ts
 export declare class DefaultChannelRegistry implements ChannelRegistry {
   private readonly channels;
@@ -625,6 +625,37 @@ export declare function evalVersionCodeFormula(formula: string, v: {
  */
 export declare function nextVersionCode(current: number | undefined, formulaValue: number | undefined): number;
 //#endregion
+//#region src/version/beta-version.d.ts
+export type PrereleasePolicy = "allow" | "warn" | "reject";
+export interface PlatformVersionCaps {
+  /** versionName 允许的最大数字段数 */
+  maxSegments: number;
+  /** prerelease 后缀（-beta.1）的官方态度 */
+  prerelease: PrereleasePolicy;
+  /** 官方口径说明（进报错/告警文案） */
+  note: string;
+}
+export declare const PLATFORM_VERSION_CAPS: Record<string, PlatformVersionCaps>;
+export declare const DEFAULT_BETA_VERSION_CONFIG: BetaVersionConfig;
+export interface BetaVersionContext {
+  /** 工程 versionName（正式号，如 4.0.0） */
+  base: string;
+  config?: BetaVersionConfig;
+  platform: string;
+}
+/** 完整检查（段数 + prerelease 政策）；返回问题描述，null = 可用 */
+export declare function checkVersionNameShape(name: string, platform: string): string | null;
+/**
+ * 派生测试版本名。
+ * 硬约束（段数超限 / iOS prerelease）直接抛错；harmony 的 prerelease 只告警（见 assertBetaVersionSupported）。
+ */
+export declare function betaVersionName(ctx: BetaVersionContext): string;
+/**
+ * 平台支持性校验：返回告警（不阻断）；官方硬拒的组合抛错。
+ * 供发布前调用——配置错在发版前暴露，不留到上传被拒。
+ */
+export declare function assertBetaVersionSupported(ctx: BetaVersionContext): string[];
+//#endregion
 //#region src/version/changelog.d.ts
 export interface ChangelogEntry {
   type: string;
@@ -687,4 +718,4 @@ export interface ArtifactVersion {
 }
 export declare function readArtifactVersion(artifactPath: string): ArtifactVersion | undefined;
 //#endregion
-export { AppliftPlugin, AppliftUserConfig, BetaConfig, BetaConfigSchema, BundleIds, Channel, ChannelCapabilities, ChannelContext, ChannelEvent, ChannelRegistry, CredentialsFile, CredentialsFileSchema, CredentialsProfile, CredentialsProfileSchema, DeliveryJudgement, DeliveryRoute, FrameworkAdapter, FrameworkContext, GlobalConfig, GlobalConfigSchema, HISTORY_PATH, HistoryEntry, HistoryEvent, HistoryQuery, HookContext, PipelineInput, PipelineSummary, PipelineSummaryEntry, Platform, PluginHookName, PluginHost, ProjectConfig, ProjectConfigSchema, PublishContext, ReleasePlanEntry, ReviewStatus, StageResult, StoreConfig, StoreConfigSchema, Stores, StoresSchema, SubmitResult, UpdateProvider, VersionCodeConfig, VersionCodeConfigSchema, VersionConfig, VersionConfigSchema, appendEntry, collectReleaseDiff, defineConfig, deps, detectBundleIds, electronAdapter, electronFramework, findArtifacts, flutterAdapter, flutterFramework, knownFrameworkAdapters, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, readEntries, readJson, resolveFramework, resolvePlugins, rnAdapter, rnFramework, routeDelivery, runStage, runSubmit, subdirs, suggestFramework, tauriAdapter, tauriFramework };
+export { AppliftPlugin, AppliftUserConfig, BetaConfig, BetaConfigSchema, BetaVersionConfig, BetaVersionConfigSchema, BundleIds, Channel, ChannelCapabilities, ChannelContext, ChannelEvent, ChannelRegistry, CredentialsFile, CredentialsFileSchema, CredentialsProfile, CredentialsProfileSchema, DeliveryJudgement, DeliveryRoute, FrameworkAdapter, FrameworkContext, GlobalConfig, GlobalConfigSchema, HISTORY_PATH, HistoryEntry, HistoryEvent, HistoryQuery, HookContext, PipelineInput, PipelineSummary, PipelineSummaryEntry, Platform, PluginHookName, PluginHost, ProjectConfig, ProjectConfigSchema, PublishContext, ReleasePlanEntry, ReviewStatus, StageResult, StoreConfig, StoreConfigSchema, Stores, StoresSchema, SubmitResult, UpdateProvider, VersionCodeConfig, VersionCodeConfigSchema, VersionConfig, VersionConfigSchema, appendEntry, collectReleaseDiff, defineConfig, deps, detectBundleIds, electronAdapter, electronFramework, findArtifacts, flutterAdapter, flutterFramework, knownFrameworkAdapters, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, readEntries, readJson, resolveFramework, resolvePlugins, rnAdapter, rnFramework, routeDelivery, runStage, runSubmit, subdirs, suggestFramework, tauriAdapter, tauriFramework };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as git, C as findArtifacts, D as collectReleaseDiff, E as subdirs, F as tagReleaseVersion, M as latestSemverTag, N as looseSemver, O as routeDelivery, P as statusShort, S as detectBundleIds, T as resolveFramework, _ as rnFramework, a as electronAdapter, b as tauriFramework, c as flutterFramework, d as nativeAndroidFramework, f as nativeHarmonyAdapter, g as rnAdapter, h as nativeIosFramework, i as redactText, j as isGitRepo, k as commitsSince, l as knownFrameworkAdapters, m as nativeIosAdapter, n as readProjectVersions, o as electronFramework, p as nativeHarmonyFramework, r as writeProjectVersions, s as flutterAdapter, t as readArtifactVersion, u as nativeAndroidAdapter, v as suggestFramework, w as readJson, x as deps, y as tauriAdapter } from "./artifact-B2RCmWw9.mjs";
+import { A as resolveFramework, B as tagReleaseVersion, C as suggestFramework, D as detectBundleIds, E as deps, F as git, I as isGitRepo, L as latestSemverTag, M as collectReleaseDiff, N as routeDelivery, O as findArtifacts, P as commitsSince, R as looseSemver, S as rnFramework, T as tauriFramework, _ as nativeHarmonyAdapter, a as betaVersionName, b as nativeIosFramework, c as writeProjectVersions, d as electronFramework, f as flutterAdapter, g as nativeAndroidFramework, h as nativeAndroidAdapter, i as assertBetaVersionSupported, j as subdirs, k as readJson, l as redactText, m as knownFrameworkAdapters, n as DEFAULT_BETA_VERSION_CONFIG, o as checkVersionNameShape, p as flutterFramework, r as PLATFORM_VERSION_CAPS, s as readProjectVersions, t as readArtifactVersion, u as electronAdapter, v as nativeHarmonyFramework, w as tauriAdapter, x as rnAdapter, y as nativeIosAdapter, z as statusShort } from "./artifact-DFD8C7bE.mjs";
 import { z } from "zod";
 import fs from "node:fs";
 import path from "node:path";
@@ -101,7 +101,33 @@ const VersionCodeConfigSchema = z.union([z.literal("increment"), z.object({
 	/** 仅限平台（缺省全部）；实际写入 = max(公式值, 现值+1) */
 	platforms: z.array(z.string()).optional()
 })]);
-const VersionConfigSchema = z.object({ versionCode: VersionCodeConfigSchema.default("increment") });
+/**
+* 测试版本名策略：测试包与正式包的 versionName 必须不同（pushy 只认 packageVersion 字符串）。
+* - offset：段偏移，默认 patch+1000（4.0.0 → 4.0.1000）——三段纯数字，iOS/Android/鸿蒙全通
+* - suffix：semver prerelease（4.0.0-beta）——iOS TestFlight/App Store 硬拒，仅侧载可用
+* - app-id：版本名不变，隔离交给两个 pushy 应用记录
+*/
+const BetaVersionConfigSchema = z.union([
+	z.object({
+		mode: z.literal("offset"),
+		segment: z.enum(["patch", "major"]).default("patch"),
+		delta: z.number().int().positive().default(1e3)
+	}),
+	z.object({
+		mode: z.literal("suffix"),
+		/** 模板：只支持 {base} 占位（不支持 {n}：序号类模板需要持久化状态） */
+		template: z.string().default("{base}-beta")
+	}),
+	z.object({ mode: z.literal("app-id") })
+]);
+const VersionConfigSchema = z.object({
+	versionCode: VersionCodeConfigSchema.default("increment"),
+	beta: BetaVersionConfigSchema.default({
+		mode: "offset",
+		segment: "patch",
+		delta: 1e3
+	})
+});
 const ProjectConfigSchema = z.object({
 	/** 项目显示名 */
 	name: z.string().optional(),
@@ -3834,6 +3860,7 @@ async function runStage(input) {
 				ok: false,
 				error: "该渠道不支持只传包（上传与提审一体）"
 			};
+			const plan = await safePlan(channel, effectiveCtx);
 			if (plugins) await plugins.broadcast("stage:after", {
 				channel: channel.id,
 				cwd: input.cwd,
@@ -3843,9 +3870,10 @@ async function runStage(input) {
 				ok: r.ok,
 				ref: r.ref,
 				error: r.error,
-				artifactPath: effectiveCtx.artifactPath
+				artifactPath: effectiveCtx.artifactPath,
+				platform: plan.platform,
+				target: "prod"
 			});
-			const plan = await safePlan(channel, effectiveCtx);
 			summary.push({
 				channel: channel.id,
 				label: channel.label,
@@ -3958,16 +3986,21 @@ 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,
-					credentials: effectiveCtx.credentials
-				}, {
-					channel: channel.id,
-					ok: true,
-					ref: stageResult.ref,
-					artifactPath: effectiveCtx.artifactPath
-				});
+				if (plugins) {
+					const stagedPlan = planFor(plans, basePlans, channel.id, ctx.artifactPath);
+					await plugins.broadcast("stage:after", {
+						channel: channel.id,
+						cwd: input.cwd,
+						credentials: effectiveCtx.credentials
+					}, {
+						channel: channel.id,
+						ok: true,
+						ref: stageResult.ref,
+						artifactPath: effectiveCtx.artifactPath,
+						platform: stagedPlan.platform,
+						target: "prod"
+					});
+				}
 			}
 			const r = await channel.submit(effectiveCtx, stagedRef);
 			summary.push({
@@ -4016,11 +4049,13 @@ async function safePlan(channel, ctx) {
 		return fallbackPlan(channel.id, ctx.artifactPath);
 	}
 }
-/** 按产物扩展名推断平台（兜底条目用）：.ipa→ios，.hap→harmony，.apk/.aab 及其余→android */
+/** 按产物扩展名推断平台（兜底条目用）：.ipa→ios，.hap/.app→harmony，.apk/.aab 及其余→android。
+*  `.app` 在 applift 的分发口径里只会是鸿蒙整包（iOS 上架/内测统一用 .ipa）——
+*  历史实现把它归到 android，会让 stage:after 把鸿蒙基线传到 android 应用记录。 */
 function platformOfArtifact(artifactPath) {
 	const ext = path.extname(artifactPath).toLowerCase();
 	if (ext === ".ipa") return "ios";
-	if (ext === ".hap") return "harmony";
+	if (ext === ".hap" || ext === ".app") return "harmony";
 	return "android";
 }
 /** plan 失败/被插件删除时的兜底条目（保 summary.plan 非可选契约；平台按产物推断不再硬编码 android） */
@@ -4603,4 +4638,4 @@ function applyBump(cwd, plan, framework, opts) {
 	}
 }
 //#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, 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 };
+export { APPLIFT_HOME, AgcHarmonyChannel, AscChannel, BetaConfigSchema, BetaVersionConfigSchema, CREDENTIALS_PATH, CredentialsFileSchema, CredentialsProfileSchema, DEFAULT_BETA_VERSION_CONFIG, DefaultChannelRegistry, GLOBAL_CONFIG_PATH, GlobalConfigSchema, GooglePlayChannel, HISTORY_PATH, HonorChannel, HuaweiAndroidChannel, OppoChannel, PLATFORM_VERSION_CAPS, PROJECTS_MAP_PATH, PgyerChannel, PluginHost, ProjectConfigSchema, StoreConfigSchema, StoresSchema, VersionCodeConfigSchema, VersionConfigSchema, VivoChannel, WAIT_BEFORE_SUBMIT_MS, XiaomiChannel, YybChannel, appendEntry, applyBump, assertBetaVersionSupported, assertListingFiles, betaVersionName, checkVersionNameShape, 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 };

package/dist/plugins/index.d.mts

@@ -1,4 +1,4 @@
-import { E as FrameworkContext, O as UpdateProvider, _ as AppliftPlugin, a as knownFrameworkAdapters, c as nativeHarmonyAdapter, d as nativeIosFramework, f as rnAdapter, g as tauriFramework, h as tauriAdapter, i as flutterFramework, l as nativeHarmonyFramework, m as suggestFramework, n as electronFramework, o as nativeAndroidAdapter, p as rnFramework, r as flutterAdapter, s as nativeAndroidFramework, t as electronAdapter, u as nativeIosAdapter, w as DeliveryJudgement } from "../frameworks-DJIt293o.mjs";
+import { E as FrameworkContext, O as UpdateProvider, W as BetaVersionConfig, _ as AppliftPlugin, a as knownFrameworkAdapters, c as nativeHarmonyAdapter, d as nativeIosFramework, f as rnAdapter, g as tauriFramework, h as tauriAdapter, i as flutterFramework, l as nativeHarmonyFramework, m as suggestFramework, n as electronFramework, o as nativeAndroidAdapter, p as rnFramework, r as flutterAdapter, s as nativeAndroidFramework, t as electronAdapter, u as nativeIosAdapter, w as DeliveryJudgement } from "../frameworks-B_GxUuWQ.mjs";
 //#region src/plugins/dingtalk-notify.d.ts
 interface DingtalkNotifyOptions {
   webhook: string;
@@ -80,11 +80,19 @@ export declare function readDepVersions(cwd: string): Record<string, string>;
 export declare function createPushyApi(opts: PushyApiOptions): PushyCli;
 //#endregion
 //#region src/plugins/rn-update.d.ts
+/**
+ * 平台 appId 配置：单 appId（隔离靠版本名）或双 appId（内测/正式各一个 pushy 应用记录）。
+ * 双 appId 时 promoteToProd 无法 rebind（跨 appId 的 versionId 不通用），退化为同一 ppk 重发。
+ */
+type AppIdConfig = number | {
+  prod: number;
+  beta: number;
+};
 interface RnUpdateOptions {
   /** 各平台的 app 记录号（如 harmony: 34166）；未声明的平台不启用热更 */
-  harmony?: number;
-  android?: number;
-  ios?: number;
+  harmony?: AppIdConfig;
+  android?: AppIdConfig;
+  ios?: AppIdConfig;
   /** 补丁目录（patch-package 约定默认 patches/，项目可覆盖） */
   patchDir?: string;
   /** 正式发布默认灰度比例（缺省 100 全量——promote 语义是"验证后发正式"，灰度是显式选择；
@@ -101,12 +109,13 @@ interface RnUpdateOptions {
  * 五形态完备性：新原生实体必现于 原生目录/依赖(原生包)/补丁/构建配置/JS——前四判原生，纯 JS 判热更，其余灰区。
  */
 export declare function judgeDelivery(diff: string[], ctx: FrameworkContext, opts: RnUpdateOptions): DeliveryJudgement;
-/** 生成测试包偏移版本号（major+1000）；非数字开头版本号无法偏移，显式报错 */
-export declare function betaPackageVersion(versionName: string): string;
-/** provider 构造（cli 注入点见 resolvePushyClient） */
-export declare function makeRnUpdateProvider(opts: RnUpdateOptions, cli?: PushyCli): UpdateProvider;
+/** beta 配置读取（插件在 config:resolved 钩子里捕获；缺省走内置默认） */
+type BetaConfigGetter = () => BetaVersionConfig;
+/** provider 构造（cli 注入点见 resolvePushyClient；betaConfig 由插件钩子注入） */
+export declare function makeRnUpdateProvider(opts: RnUpdateOptions, cli?: PushyCli, getBetaConfig?: BetaConfigGetter): UpdateProvider;
 /** rnUpdate 插件工厂：注册完整 provider（判定 + beta 发布 + promote）+ 原生发版自动基线。
- *  cli 注入点：测试 mock / 特殊 transport；缺省 OpenAPI 客户端（token 来自 ctx.credentials）。 */
+ *  cli 注入点：测试 mock / 特殊 transport；缺省 OpenAPI 客户端（token 来自 ctx.credentials）。
+ *  beta 策略由项目配置决定，在 config:resolved 钩子里捕获（不重复声明在插件参数里）。 */
 export declare function rnUpdate(opts?: RnUpdateOptions, cli?: PushyCli): AppliftPlugin;
 //#endregion
-export { type DingtalkNotifyOptions, type FetchImpl, type HttpUploadImpl, type PushyApiOptions, type PushyCli, type RnUpdateOptions, electronAdapter, electronFramework, flutterAdapter, flutterFramework, knownFrameworkAdapters, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, rnAdapter, rnFramework, suggestFramework, tauriAdapter, tauriFramework };
+export { type AppIdConfig, type BetaConfigGetter, type DingtalkNotifyOptions, type FetchImpl, type HttpUploadImpl, type PushyApiOptions, type PushyCli, type RnUpdateOptions, electronAdapter, electronFramework, flutterAdapter, flutterFramework, knownFrameworkAdapters, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, rnAdapter, rnFramework, suggestFramework, tauriAdapter, tauriFramework };

package/dist/plugins/index.mjs

@@ -1,4 +1,4 @@
-import { C as findArtifacts, D as collectReleaseDiff, _ as rnFramework, a as electronAdapter, b as tauriFramework, c as flutterFramework, d as nativeAndroidFramework, f as nativeHarmonyAdapter, g as rnAdapter, h as nativeIosFramework, i as redactText, l as knownFrameworkAdapters, m as nativeIosAdapter, n as readProjectVersions, o as electronFramework, p as nativeHarmonyFramework, s as flutterAdapter, t as readArtifactVersion, u as nativeAndroidAdapter, v as suggestFramework, y as tauriAdapter } from "../artifact-B2RCmWw9.mjs";
+import { C as suggestFramework, M as collectReleaseDiff, O as findArtifacts, S as rnFramework, T as tauriFramework, _ as nativeHarmonyAdapter, a as betaVersionName, b as nativeIosFramework, d as electronFramework, f as flutterAdapter, g as nativeAndroidFramework, h as nativeAndroidAdapter, i as assertBetaVersionSupported, l as redactText, m as knownFrameworkAdapters, n as DEFAULT_BETA_VERSION_CONFIG, p as flutterFramework, s as readProjectVersions, t as readArtifactVersion, u as electronAdapter, v as nativeHarmonyFramework, w as tauriAdapter, x as rnAdapter, y as nativeIosAdapter } from "../artifact-DFD8C7bE.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { createHmac } from "node:crypto";
@@ -491,21 +491,24 @@ function judgeDelivery(diff, ctx, opts) {
 		evidence
 	};
 }
-/** pushy 官方测试包约定：与正式同源码、仅版本号偏移（major+1000，如 1.6.0→1001.6.0） */
-const BETA_VERSION_OFFSET = 1e3;
 /** 正式 promote 的内置默认灰度比例（100 = 全量）。promote 语义是"测试通道已验证、发正式"，
 *  全量是常态、灰度是显式选择（--rollout 或 rnUpdate({ defaultRollout })），不藏在配置后面 */
 const DEFAULT_ROLLOUT = 100;
-/** 生成测试包偏移版本号（major+1000）；非数字开头版本号无法偏移，显式报错 */
-function betaPackageVersion(versionName) {
-	const m = /^(\d+)(\..+)?$/.exec(versionName);
-	if (!m) throw new Error(`versionName「${versionName}」非 X.Y.Z 形态，无法按 major+${BETA_VERSION_OFFSET} 生成测试包偏移版本`);
-	return `${Number(m[1]) + BETA_VERSION_OFFSET}${m[2] ?? ""}`;
+/** 平台 appId（beta 语境优先取双 appId 里的 beta 记录） */
+function platformAppId(opts, platform, channel) {
+	const cfg = opts[platform];
+	if (typeof cfg === "number") return cfg;
+	if (cfg && typeof cfg === "object") {
+		const ids = cfg;
+		if (channel === "beta" && typeof ids.beta === "number") return ids.beta;
+		if (typeof ids.prod === "number") return ids.prod;
+	}
+	throw new Error(`平台 ${platform} 未配置热更 app 记录：rnUpdate({ ${platform}: <appId> }) 或 rnUpdate({ ${platform}: { prod, beta } })（在 applift.config.ts 的插件参数里声明）`);
 }
-function platformAppId(opts, platform) {
-	const id = opts[platform];
-	if (typeof id !== "number") throw new Error(`平台 ${platform} 未配置热更 app 记录：rnUpdate({ ${platform}: <appId> })（在 applift.config.ts 的插件参数里声明）`);
-	return id;
+/** 是否配置了独立的内测 appId（app-id 模式下 promote 无法 rebind） */
+function hasDualAppId(opts, platform) {
+	const cfg = opts[platform];
+	return !!cfg && typeof cfg === "object" && typeof cfg.beta === "number" && cfg.beta !== cfg.prod;
 }
 /** 当前 versionName（readProjectVersions 按 framework 定位工程文件） */
 function currentVersionName(ctx) {
@@ -513,9 +516,13 @@ function currentVersionName(ctx) {
 	if (!v?.versionName) throw new Error(`未读到平台 ${ctx.platform} 的 versionName（readProjectVersions 无该平台版本文件）`);
 	return v.versionName;
 }
+/** 正则转义：基线名可能来自 suffix 模板（`+` 等元字符），只转义点号会生成错误正则 */
+function escapeRegExp(s) {
+	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 /** 服务端取号：该 versionName 下已有热更名 {ver}-patch.N 的最大 N → next = N+1（首版 N=0 → 1） */
 function nextPatchNumber(names, versionName) {
-	const re = new RegExp(`^${versionName.replace(/\./g, "\\.")}-patch\\.(\\d+)$`);
+	const re = new RegExp(`^${escapeRegExp(versionName)}-patch\\.(\\d+)$`);
 	let max = 0;
 	for (const { name } of names) {
 		const m = name.match(re);
@@ -570,21 +577,27 @@ async function assertPpkFresh(cwd, ppk) {
 	} catch {}
 	if (newest > 0 && fs.statSync(ppk).mtimeMs < newest) throw new Error(`ppk（${path.basename(ppk)}）早于最新代码改动（${newestFile}）——疑似忘重新 bundle，请重新产出 ppk 后再发；确认无误可 --artifact 显式指定跳过此护栏`);
 }
-/** 发布新热更的公共骨架：客户端/appId/版本号/ppk 探测 + 服务端取号（publishToBeta/publishToProd 共用） */
-async function preparePublish(opts, cli, ctx) {
+/** 发布新热更的公共骨架：客户端/appId/版本名/ppk 探测 + 服务端取号（publishToBeta/publishToProd 共用） */
+async function preparePublish(opts, cli, ctx, channel, getBetaConfig) {
 	const client = resolvePushyClient(opts, cli, ctx.credentials);
-	const appId = platformAppId(opts, ctx.platform);
-	const versionName = currentVersionName(ctx);
+	const appId = platformAppId(opts, ctx.platform, channel);
+	const base = currentVersionName(ctx);
+	const packageVersion = channel === "beta" ? betaVersionName({
+		base,
+		config: getBetaConfig(),
+		platform: ctx.platform
+	}) : base;
 	return {
 		client,
 		appId,
-		versionName,
+		base,
+		packageVersion,
 		ppk: await resolvePpk(opts, ctx),
-		name: `${versionName}-patch.${nextPatchNumber(await client.versions(appId), versionName)}`
+		name: `${packageVersion}-patch.${nextPatchNumber(await client.versions(appId), packageVersion)}`
 	};
 }
-/** provider 构造（cli 注入点见 resolvePushyClient） */
-function makeRnUpdateProvider(opts, cli) {
+/** provider 构造（cli 注入点见 resolvePushyClient；betaConfig 由插件钩子注入） */
+function makeRnUpdateProvider(opts, cli, getBetaConfig = () => DEFAULT_BETA_VERSION_CONFIG) {
 	return {
 		id: "rn-update",
 		frameworks: ["rn"],
@@ -592,10 +605,17 @@ function makeRnUpdateProvider(opts, cli) {
 			"harmony",
 			"android",
 			"ios"
-		].filter((k) => typeof opts[k] === "number"),
+		].filter((k) => opts[k] !== void 0),
 		judge: (diff, ctx) => judgeDelivery(diff, ctx, opts),
 		async publishToBeta(ctx) {
-			const { client, appId, versionName, ppk, name } = await preparePublish(opts, cli, ctx);
+			platformAppId(opts, ctx.platform, "beta");
+			if (getBetaConfig().mode === "app-id" && !hasDualAppId(opts, ctx.platform)) throw new Error(`app-id 模式必须为 ${ctx.platform} 配置两个推送应用记录：rnUpdate({ ${ctx.platform}: { prod, beta } })——当前只有单 appId，测试热更会绑到正式线（packageVersion 也与正式相同）`);
+			for (const w of assertBetaVersionSupported({
+				base: currentVersionName(ctx),
+				config: getBetaConfig(),
+				platform: ctx.platform
+			})) process.stderr.write(`⚠ ${w}\n`);
+			const { client, appId, packageVersion, ppk, name } = await preparePublish(opts, cli, ctx, "beta", getBetaConfig);
 			return {
 				versionName: name,
 				versionId: (await client.publish({
@@ -604,13 +624,13 @@ function makeRnUpdateProvider(opts, cli) {
 					platform: ctx.platform,
 					name,
 					description: ctx.note,
-					packageVersion: betaPackageVersion(versionName),
+					packageVersion,
 					deps: readDepVersions(ctx.cwd)
 				})).versionId
 			};
 		},
 		async publishToProd(ctx) {
-			const { client, appId, versionName, ppk, name } = await preparePublish(opts, cli, ctx);
+			const { client, appId, packageVersion, ppk, name } = await preparePublish(opts, cli, ctx, "prod", getBetaConfig);
 			const rollout = ctx.rollout ?? opts.defaultRollout ?? DEFAULT_ROLLOUT;
 			return {
 				versionName: name,
@@ -620,7 +640,7 @@ function makeRnUpdateProvider(opts, cli) {
 					platform: ctx.platform,
 					name,
 					description: ctx.note,
-					packageVersion: versionName,
+					packageVersion,
 					rollout,
 					deps: readDepVersions(ctx.cwd)
 				})).versionId,
@@ -628,11 +648,21 @@ function makeRnUpdateProvider(opts, cli) {
 			};
 		},
 		async promoteToProd(ctx) {
+			const config = getBetaConfig();
+			if (config.mode === "app-id" || hasDualAppId(opts, ctx.platform)) {
+				process.stderr.write(`⚠ ${ctx.platform} 无法 promote：跨 appId 的 versionId 不通用（app-id/双 appId 模式）——转为 publishToProd，同一 ppk 直接发正式应用记录\n`);
+				return null;
+			}
 			const client = resolvePushyClient(opts, cli, ctx.credentials);
-			const appId = platformAppId(opts, ctx.platform);
-			const versionName = currentVersionName(ctx);
+			const appId = platformAppId(opts, ctx.platform, "prod");
+			const base = currentVersionName(ctx);
+			const betaName = betaVersionName({
+				base,
+				config,
+				platform: ctx.platform
+			});
 			const latest = (await client.versions(appId)).map((v) => {
-				const m = v.name.match(new RegExp(`^${versionName.replace(/\./g, "\\.")}-patch\\.(\\d+)$`));
+				const m = v.name.match(new RegExp(`^${escapeRegExp(betaName)}-patch\\.(\\d+)$`));
 				return m ? {
 					...v,
 					n: Number(m[1])
@@ -640,12 +670,16 @@ function makeRnUpdateProvider(opts, cli) {
 			}).filter((x) => x !== null).sort((a, b) => b.n - a.n)[0];
 			if (!latest) return null;
 			const rollout = ctx.rollout ?? opts.defaultRollout ?? DEFAULT_ROLLOUT;
-			await client.rebind({
-				appId,
-				versionId: latest.id,
-				packageVersion: versionName,
-				rollout
-			});
+			try {
+				await client.rebind({
+					appId,
+					versionId: latest.id,
+					packageVersion: base,
+					rollout
+				});
+			} catch (e) {
+				throw new Error(`${e.message}\n提示：promote 需要正式版本 ${base} 的原生基线已上传。先执行 applift release ${ctx.platform} --delivery native（只 stage、不含 --submit）生成基线，再重试 promote。`);
+			}
 			return {
 				versionName: latest.name,
 				...rollout !== void 0 ? { rollout } : {}
@@ -653,31 +687,51 @@ function makeRnUpdateProvider(opts, cli) {
 		}
 	};
 }
-/** 渠道 → 平台映射（热更已接入的平台；基线上传按此路由） */
+/** 这条基线属于测试线还是正式线：测试包 versionName 由策略派生，与工程版本名不同。
+*  读不到工程版本时按 prod 处理（保守：宁可少传一条测试基线，也不把测试包灌进正式 app）。 */
+function baselineChannel(versionName, platform, cwd) {
+	try {
+		const base = readProjectVersions(cwd, null).find((v) => v.platform === platform)?.versionName;
+		return base && base !== versionName ? "beta" : "prod";
+	} catch {
+		return "prod";
+	}
+}
+/** 渠道 → 平台兜底映射（新链路优先用 stage:after 透传的 platform；此表仅兼容旧载荷） */
 const CHANNEL_PLATFORM = { agc: "harmony" };
 /** rnUpdate 插件工厂：注册完整 provider（判定 + beta 发布 + promote）+ 原生发版自动基线。
-*  cli 注入点：测试 mock / 特殊 transport；缺省 OpenAPI 客户端（token 来自 ctx.credentials）。 */
+*  cli 注入点：测试 mock / 特殊 transport；缺省 OpenAPI 客户端（token 来自 ctx.credentials）。
+*  beta 策略由项目配置决定，在 config:resolved 钩子里捕获（不重复声明在插件参数里）。 */
 function rnUpdate(opts = {}, cli) {
-	const provider = makeRnUpdateProvider(opts, cli);
+	let betaConfig = DEFAULT_BETA_VERSION_CONFIG;
+	const provider = makeRnUpdateProvider(opts, cli, () => betaConfig);
+	const uploadedBaselines = /* @__PURE__ */ new Set();
 	return {
 		name: "rn-update",
+		"config:resolved"(config) {
+			betaConfig = config.version?.beta ?? DEFAULT_BETA_VERSION_CONFIG;
+		},
 		"update:register"(providers) {
 			providers.push(provider);
 		},
 		async "stage:after"(result, hookCtx) {
-			const platform = CHANNEL_PLATFORM[result.channel];
+			const platform = result.platform ?? CHANNEL_PLATFORM[result.channel];
 			if (!result.ok || !platform || !result.artifactPath) return;
-			const appId = opts[platform];
-			if (typeof appId !== "number") return;
+			if (opts[platform] === void 0) return;
 			try {
 				const versionName = readArtifactVersion(result.artifactPath)?.versionName;
 				if (!versionName) throw new Error(`未能从产物读出 versionName：${result.artifactPath}（readArtifactVersion 不支持该格式？）`);
+				const appId = platformAppId(opts, platform, result.target ?? baselineChannel(versionName, platform, hookCtx.cwd));
+				const key = `${platform}:${versionName}`;
+				if (uploadedBaselines.has(key)) return;
+				uploadedBaselines.add(key);
 				await resolvePushyClient(opts, cli, hookCtx.credentials).uploadApp(appId, result.artifactPath, versionName, readDepVersions(hookCtx.cwd));
 			} catch (e) {
+				uploadedBaselines.delete(`${platform}:${readArtifactVersion(result.artifactPath)?.versionName ?? ""}`);
 				process.stderr.write(`⚠ pushy 基线上传失败（请人工补传）：${e.message}\n`);
 			}
 		}
 	};
 }
 //#endregion
-export { PUSHY_DEFAULT_BASE_URL, PUSHY_TOKEN_KEY, betaPackageVersion, createPushyApi, dingtalkNotify, electronAdapter, electronFramework, flutterAdapter, flutterFramework, judgeDelivery, knownFrameworkAdapters, makeRnUpdateProvider, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, nodeHttpUpload, readDepVersions, rnAdapter, rnFramework, rnUpdate, suggestFramework, tauriAdapter, tauriFramework };
+export { PUSHY_DEFAULT_BASE_URL, PUSHY_TOKEN_KEY, createPushyApi, dingtalkNotify, electronAdapter, electronFramework, flutterAdapter, flutterFramework, judgeDelivery, knownFrameworkAdapters, makeRnUpdateProvider, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, nodeHttpUpload, readDepVersions, rnAdapter, rnFramework, rnUpdate, suggestFramework, tauriAdapter, tauriFramework };

package/package.json

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