@heybox/hb-sdk 0.8.1-alpha.15 → 0.8.1-alpha.16

package/dist/devtools/browser-dev-host/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="theme-color" content="#f4f5f7" />
     <title>小程序工坊调试台</title>
-    <script type="module" crossorigin src="/assets/index-C3EtSrqt.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-BUVHeuGC.js">
+    <script type="module" crossorigin src="/assets/index-BqskekK_.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-CvKi6AqK.js">
     <link rel="stylesheet" crossorigin href="/assets/index-DXd5IZBz.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -835,7 +835,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.1-alpha.15';
+    : '0.8.1-alpha.16';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);

package/dist/index.esm.js

@@ -831,7 +831,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.1-alpha.15';
+    : '0.8.1-alpha.16';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);

package/dist/miniapp-publish.cjs.js

@@ -2814,9 +2814,94 @@ function parseMiniappBindAppIds(value, options = {}) {
     return Object.freeze(appIds);
 }
 
+const MINIAPP_PLATFORM_VALUES = ['android', 'ios', 'ohos', 'windows', 'macos', 'linux'];
+/** 平台声明硬切点：产物 hb-sdk 版本达到该值时，必须显式声明非空 `platforms`。 */
+const MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION = '0.9.0';
+/**
+ * 历史移动端兼容平台集合。
+ *
+ * @remarks
+ * 仅在 `sdkVersion` 缺失或 SemVer precedence 低于 `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION`，
+ * 且 Manifest 完全没有 `platforms` 字段时生效，不是任何非法声明的兜底。
+ */
+const MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES = ['android', 'ios', 'ohos'];
 function isValidMiniappManifestVersion(version) {
     return getMiniappManifestVersionError(version) === undefined;
 }
+function validateMiniappPlatforms(platforms, sourceLabel = 'platforms') {
+    if (!Array.isArray(platforms) || platforms.length === 0) {
+        throw new Error(`${sourceLabel} 必须是非空平台数组`);
+    }
+    const allowedPlatforms = new Set(MINIAPP_PLATFORM_VALUES);
+    const seen = new Set();
+    for (const platform of platforms) {
+        if (typeof platform !== 'string' || !allowedPlatforms.has(platform)) {
+            throw new Error(`${sourceLabel} 包含不支持的平台：${String(platform)}`);
+        }
+        if (seen.has(platform)) {
+            throw new Error(`${sourceLabel} 包含重复平台：${platform}`);
+        }
+        seen.add(platform);
+    }
+    return Object.freeze(MINIAPP_PLATFORM_VALUES.filter((platform) => seen.has(platform)));
+}
+const NO_MINIAPP_PLATFORMS = Object.freeze([]);
+/**
+ * 解析 Manifest 平台声明，是 `0.9.0` 硬切规则的唯一实现。
+ *
+ * @remarks
+ * 规则与后端领域层保持一致：
+ * - 无 `platforms` 字段：`sdkVersion` 缺失或 SemVer precedence 低于
+ *   `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION` 时按历史移动端兼容；达到或高于硬切点即非法。
+ * - 有 `platforms` 字段：复用 `validateMiniappPlatforms` 校验并规范化顺序；任何非法值
+ *   （空数组、非数组、未知值、重复值）都不回退到历史兼容，即使 `sdkVersion < 0.9.0`。
+ * - 任何非法的 `sdkVersion` 都会抛出，不做字符串比较。
+ * @param sdkVersion - 产物 hb-sdk 版本；历史产物可能缺失。
+ * @param manifest - 待解析的 Manifest（不可信输入）。
+ * @returns 冻结的平台解析结果。
+ * @throws Manifest 不是对象、`sdkVersion` 不是合法 SemVer、达到硬切点仍缺失 `platforms`，
+ *   或 `platforms` 声明非法时抛出。
+ */
+function resolveMiniappManifestPlatforms(sdkVersion, manifest) {
+    if (!isRecord$1(manifest)) {
+        throw new Error('manifest 必须是 JSON 对象');
+    }
+    // 与后端 ResolvePlatforms 对齐：空串/纯空白按“缺失 SDK 版本”处理（历史产物），不报错。
+    const trimmedSdkVersion = typeof sdkVersion === 'string' ? sdkVersion.trim() : undefined;
+    const normalizedSdkVersion = trimmedSdkVersion ? validateSdkVersion(trimmedSdkVersion) : undefined;
+    if (Object.prototype.hasOwnProperty.call(manifest, 'platforms')) {
+        const platforms = validateMiniappPlatforms(manifest.platforms, 'manifest.platforms');
+        return Object.freeze({
+            declared: platforms,
+            effective: platforms,
+            platformsDeclared: true,
+            policy: 'explicit',
+        });
+    }
+    if (normalizedSdkVersion === undefined || semverExports.lt(normalizedSdkVersion, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION)) {
+        return Object.freeze({
+            declared: NO_MINIAPP_PLATFORMS,
+            effective: MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES,
+            platformsDeclared: false,
+            policy: 'legacy_mobile_default',
+        });
+    }
+    throw new Error(`manifest.platforms 缺失：hb-sdk ${MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION} 起必须显式声明非空 platforms（当前 ${normalizedSdkVersion}）`);
+}
+function validateSdkVersion(version, sourceLabel = 'sdkVersion') {
+    if (typeof version !== 'string' || version.trim() === '') {
+        throw new Error(`${sourceLabel} 必须是合法 SemVer：${String(version)}`);
+    }
+    const normalized = version.trim();
+    const parsed = semverExports.parse(normalized);
+    if (!parsed || parsed.version !== normalized || parsed.build.length > 0) {
+        throw new Error(`${sourceLabel} 必须是合法 SemVer：${normalized}`);
+    }
+    return normalized;
+}
+function isRecord$1(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
 function getMiniappManifestVersionError(version) {
     if (typeof version !== 'string' || version.trim() === '') {
         return `必须是合法 SemVer：${String(version)}`;
@@ -3231,6 +3316,8 @@ exports.LIST_USER_MINIPROGRAM_API_PATH = LIST_USER_MINIPROGRAM_API_PATH;
 exports.LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH = LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH;
 exports.LIST_USER_MINIPROGRAM_VERSION_API_PATH = LIST_USER_MINIPROGRAM_VERSION_API_PATH;
 exports.MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES = MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES;
+exports.MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES = MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES;
+exports.MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION = MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION;
 exports.MINIAPP_UPLOAD_BATCH_SIZE = MINIAPP_UPLOAD_BATCH_SIZE;
 exports.MINIAPP_UPLOAD_SCOPE = MINIAPP_UPLOAD_SCOPE;
 exports.MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES = MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES;
@@ -3254,6 +3341,7 @@ exports.normalizeRelativePath = normalizeRelativePath;
 exports.parseMiniappBindAppIds = parseMiniappBindAppIds;
 exports.prepareMiniappArtifactFiles = prepareMiniappArtifactFiles;
 exports.relativePathContainsNodeModulesSegment = relativePathContainsNodeModulesSegment;
+exports.resolveMiniappManifestPlatforms = resolveMiniappManifestPlatforms;
 exports.resolveMiniappUploadSessionFiles = resolveMiniappUploadSessionFiles;
 exports.shouldUploadDistFile = shouldUploadDistFile;
 exports.validateMiniappCompanionFileReceipts = validateMiniappCompanionFileReceipts;

package/dist/miniapp-publish.esm.js

@@ -2812,9 +2812,94 @@ function parseMiniappBindAppIds(value, options = {}) {
     return Object.freeze(appIds);
 }
 
+const MINIAPP_PLATFORM_VALUES = ['android', 'ios', 'ohos', 'windows', 'macos', 'linux'];
+/** 平台声明硬切点：产物 hb-sdk 版本达到该值时，必须显式声明非空 `platforms`。 */
+const MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION = '0.9.0';
+/**
+ * 历史移动端兼容平台集合。
+ *
+ * @remarks
+ * 仅在 `sdkVersion` 缺失或 SemVer precedence 低于 `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION`，
+ * 且 Manifest 完全没有 `platforms` 字段时生效，不是任何非法声明的兜底。
+ */
+const MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES = ['android', 'ios', 'ohos'];
 function isValidMiniappManifestVersion(version) {
     return getMiniappManifestVersionError(version) === undefined;
 }
+function validateMiniappPlatforms(platforms, sourceLabel = 'platforms') {
+    if (!Array.isArray(platforms) || platforms.length === 0) {
+        throw new Error(`${sourceLabel} 必须是非空平台数组`);
+    }
+    const allowedPlatforms = new Set(MINIAPP_PLATFORM_VALUES);
+    const seen = new Set();
+    for (const platform of platforms) {
+        if (typeof platform !== 'string' || !allowedPlatforms.has(platform)) {
+            throw new Error(`${sourceLabel} 包含不支持的平台：${String(platform)}`);
+        }
+        if (seen.has(platform)) {
+            throw new Error(`${sourceLabel} 包含重复平台：${platform}`);
+        }
+        seen.add(platform);
+    }
+    return Object.freeze(MINIAPP_PLATFORM_VALUES.filter((platform) => seen.has(platform)));
+}
+const NO_MINIAPP_PLATFORMS = Object.freeze([]);
+/**
+ * 解析 Manifest 平台声明，是 `0.9.0` 硬切规则的唯一实现。
+ *
+ * @remarks
+ * 规则与后端领域层保持一致：
+ * - 无 `platforms` 字段：`sdkVersion` 缺失或 SemVer precedence 低于
+ *   `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION` 时按历史移动端兼容；达到或高于硬切点即非法。
+ * - 有 `platforms` 字段：复用 `validateMiniappPlatforms` 校验并规范化顺序；任何非法值
+ *   （空数组、非数组、未知值、重复值）都不回退到历史兼容，即使 `sdkVersion < 0.9.0`。
+ * - 任何非法的 `sdkVersion` 都会抛出，不做字符串比较。
+ * @param sdkVersion - 产物 hb-sdk 版本；历史产物可能缺失。
+ * @param manifest - 待解析的 Manifest（不可信输入）。
+ * @returns 冻结的平台解析结果。
+ * @throws Manifest 不是对象、`sdkVersion` 不是合法 SemVer、达到硬切点仍缺失 `platforms`，
+ *   或 `platforms` 声明非法时抛出。
+ */
+function resolveMiniappManifestPlatforms(sdkVersion, manifest) {
+    if (!isRecord$1(manifest)) {
+        throw new Error('manifest 必须是 JSON 对象');
+    }
+    // 与后端 ResolvePlatforms 对齐：空串/纯空白按“缺失 SDK 版本”处理（历史产物），不报错。
+    const trimmedSdkVersion = typeof sdkVersion === 'string' ? sdkVersion.trim() : undefined;
+    const normalizedSdkVersion = trimmedSdkVersion ? validateSdkVersion(trimmedSdkVersion) : undefined;
+    if (Object.prototype.hasOwnProperty.call(manifest, 'platforms')) {
+        const platforms = validateMiniappPlatforms(manifest.platforms, 'manifest.platforms');
+        return Object.freeze({
+            declared: platforms,
+            effective: platforms,
+            platformsDeclared: true,
+            policy: 'explicit',
+        });
+    }
+    if (normalizedSdkVersion === undefined || semverExports.lt(normalizedSdkVersion, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION)) {
+        return Object.freeze({
+            declared: NO_MINIAPP_PLATFORMS,
+            effective: MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES,
+            platformsDeclared: false,
+            policy: 'legacy_mobile_default',
+        });
+    }
+    throw new Error(`manifest.platforms 缺失：hb-sdk ${MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION} 起必须显式声明非空 platforms（当前 ${normalizedSdkVersion}）`);
+}
+function validateSdkVersion(version, sourceLabel = 'sdkVersion') {
+    if (typeof version !== 'string' || version.trim() === '') {
+        throw new Error(`${sourceLabel} 必须是合法 SemVer：${String(version)}`);
+    }
+    const normalized = version.trim();
+    const parsed = semverExports.parse(normalized);
+    if (!parsed || parsed.version !== normalized || parsed.build.length > 0) {
+        throw new Error(`${sourceLabel} 必须是合法 SemVer：${normalized}`);
+    }
+    return normalized;
+}
+function isRecord$1(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
 function getMiniappManifestVersionError(version) {
     if (typeof version !== 'string' || version.trim() === '') {
         return `必须是合法 SemVer：${String(version)}`;
@@ -3216,4 +3301,4 @@ function compareBytes(left, right) {
     return left.length - right.length;
 }
 
-export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, CREATE_USER_MINIPROGRAM_API_PATH, CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, CREATE_USER_MINIPROGRAM_LOCAL_DEV_LAUNCH_TOKEN_API_PATH, DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DETAIL_USER_MINIPROGRAM_API_PATH, DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DEVELOPER_ENTITY_LIST_API_PATH, DEVELOPER_ENTITY_SWITCH_API_PATH, LIST_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH, LIST_USER_MINIPROGRAM_VERSION_API_PATH, MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES, MINIAPP_UPLOAD_BATCH_SIZE, MINIAPP_UPLOAD_SCOPE, MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES, PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH, RELEASE_USER_MINIPROGRAM_VERSION_API_PATH, REOPEN_USER_MINIPROGRAM_API_PATH, SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH, TAKE_DOWN_USER_MINIPROGRAM_API_PATH, UPDATE_SQUARE_DISPLAY_API_PATH, UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_ACCESS_STATUS_API_PATH, USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH, WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH, createMiniappArtifactFileHeader, createMiniappArtifactSignatureHeader, getMiniProgramUploadAlias, getMiniappUploadKey, isValidMiniappManifestVersion as isValidVersion, normalizeRelativePath, parseMiniappBindAppIds, prepareMiniappArtifactFiles, relativePathContainsNodeModulesSegment, resolveMiniappUploadSessionFiles, shouldUploadDistFile, validateMiniappCompanionFileReceipts, validateMiniappUploadPathLengths, validateMiniappUploadSizeBudgets, validateUploadPaths, validateUploadTotalSize };
+export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, CREATE_USER_MINIPROGRAM_API_PATH, CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, CREATE_USER_MINIPROGRAM_LOCAL_DEV_LAUNCH_TOKEN_API_PATH, DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DETAIL_USER_MINIPROGRAM_API_PATH, DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DEVELOPER_ENTITY_LIST_API_PATH, DEVELOPER_ENTITY_SWITCH_API_PATH, LIST_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH, LIST_USER_MINIPROGRAM_VERSION_API_PATH, MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES, MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION, MINIAPP_UPLOAD_BATCH_SIZE, MINIAPP_UPLOAD_SCOPE, MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES, PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH, RELEASE_USER_MINIPROGRAM_VERSION_API_PATH, REOPEN_USER_MINIPROGRAM_API_PATH, SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH, TAKE_DOWN_USER_MINIPROGRAM_API_PATH, UPDATE_SQUARE_DISPLAY_API_PATH, UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_ACCESS_STATUS_API_PATH, USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH, WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH, createMiniappArtifactFileHeader, createMiniappArtifactSignatureHeader, getMiniProgramUploadAlias, getMiniappUploadKey, isValidMiniappManifestVersion as isValidVersion, normalizeRelativePath, parseMiniappBindAppIds, prepareMiniappArtifactFiles, relativePathContainsNodeModulesSegment, resolveMiniappManifestPlatforms, resolveMiniappUploadSessionFiles, shouldUploadDistFile, validateMiniappCompanionFileReceipts, validateMiniappUploadPathLengths, validateMiniappUploadSizeBudgets, validateUploadPaths, validateUploadTotalSize };

package/dist/vite.cjs.js

@@ -11,7 +11,7 @@ var _documentCurrentScript = typeof document !== 'undefined' ? document.currentS
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.1-alpha.15';
+    : '0.8.1-alpha.16';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/dist/vite.esm.js

@@ -8,7 +8,7 @@ import { AsyncLocalStorage } from 'node:async_hooks';
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.1-alpha.15';
+    : '0.8.1-alpha.16';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.8.1-alpha.15",
+  "version": "0.8.1-alpha.16",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -62,7 +62,7 @@
     "skills": "1.5.23",
     "undici": "^7.28.0",
     "ws": "^8.18.0",
-    "@heybox/hb-sdk-protocol": "0.8.1-alpha.15"
+    "@heybox/hb-sdk-protocol": "0.8.1-alpha.16"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -113,10 +113,10 @@
     "vue-tsc": "^3.3.7",
     "vite": "^8.0.12",
     "vitest": "^3.2.4",
+    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox-domain/heybox-theme": "~0.1.0",
+    "@heybox/hb-sdk-runtime": "~0.8.1-alpha.16",
     "@heybox/hb-api": "~1.28.3",
-    "@heybox/hb-sdk-runtime": "~0.8.1-alpha.15",
-    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox/runtime": "~0.2.0",
     "@heybox/runtime-policy": "~0.2.0",
     "@heybox/runtime-transport-fetch": "~0.2.0"

package/skill/references/api-protocol.md

@@ -301,10 +301,10 @@ Reference 由 `@heybox/hb-sdk` 的公开导出与源码注释自动生成，不
 | --- | ---: | ---: | ---: | ---: | ---: |
 | Root API | 2 | 4 | 75 | 73 | 3 |
 | Protocol API | 0 | 13 | 58 | 90 | 47 |
-| Miniapp Publish API | 0 | 6 | 3 | 0 | 0 |
+| Miniapp Publish API | 0 | 7 | 4 | 1 | 2 |
 | Vite API | 0 | 1 | 5 | 1 | 3 |
 
-<!-- Generated by apps/docs/hb-sdk/scripts/generate-api-docs.ts; schemaVersion=4; fingerprint=1dfd4c6306e8ac3680f60db083aa048395e38ffb49c30e19b49cc5db72249533 -->
+<!-- Generated by apps/docs/hb-sdk/scripts/generate-api-docs.ts; schemaVersion=4; fingerprint=67370783f01088c3ba37e6506e18d075924b7966e0b53aa3ce82b38bac1a33f3 -->
 
 ## SDK API
 

package/skill/references/api-root.md

@@ -27,7 +27,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.8.1-alpha.15`
+- Version at generation time: `0.8.1-alpha.16`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`

package/skill/skill.json

@@ -1,16 +1,16 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.8.1-alpha.15+skill.b220fbc77b56",
+  "skillVersion": "0.8.1-alpha.16+skill.40a9aaafe9bf",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.8.1-alpha.15",
-    "compatibility": "0.8.1-alpha.15"
+    "version": "0.8.1-alpha.16",
+    "compatibility": "0.8.1-alpha.16"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.8.1-alpha.15",
+    "version": "0.8.1-alpha.16",
     "path": "skill"
   },
-  "integrity": "sha256-b220fbc77b56021c0620c086c036ceba404be7a49741ffffb8bee9fce57706a7"
+  "integrity": "sha256-40a9aaafe9bf39ee033c27c149c7bcfff2f5e7c9674796d1b1ac24f7df9ea81c"
 }

package/types/miniapp-manifest/schema.d.ts

@@ -3,6 +3,16 @@ import type { MiniappCompanionManifestDeclarations } from './companion-types';
 export declare const MINIAPP_TEMPLATE_VERSION = "0.0.0";
 export declare const MINIAPP_PLATFORM_VALUES: readonly ["android", "ios", "ohos", "windows", "macos", "linux"];
 export type MiniappPlatform = (typeof MINIAPP_PLATFORM_VALUES)[number];
+/** 平台声明硬切点：产物 hb-sdk 版本达到该值时，必须显式声明非空 `platforms`。 */
+export declare const MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION = "0.9.0";
+/**
+ * 历史移动端兼容平台集合。
+ *
+ * @remarks
+ * 仅在 `sdkVersion` 缺失或 SemVer precedence 低于 `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION`，
+ * 且 Manifest 完全没有 `platforms` 字段时生效，不是任何非法声明的兜底。
+ */
+export declare const MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES: readonly ["android", "ios", "ohos"];
 /** 窗口尺寸字段的脏值兜底上限；真正的上限是宿主侧显示器 workArea。 */
 export declare const MINIAPP_WINDOW_SIZE_MAX = 16384;
 /**
@@ -65,6 +75,42 @@ export declare function validateMiniappManifestForDeploy(manifest: MiniappManife
 };
 export declare function validateMiniappPlatforms(platforms: unknown, sourceLabel?: string): readonly MiniappPlatform[];
 export declare function areMiniappPlatformsEqual(left: readonly MiniappPlatform[], right: readonly MiniappPlatform[]): boolean;
+/** 平台解析策略：显式声明，或历史产物缺少声明时的移动端兼容。 */
+export type MiniappPlatformPolicy = 'explicit' | 'legacy_mobile_default';
+/**
+ * Manifest 平台解析结果，供 CLI、开放平台网页、后端与 Runtime 共用。
+ *
+ * @remarks
+ * `declared` 是规范化后的显式声明，历史兼容场景为空数组；`effective` 是用于展示与运行
+ * 判断的最终平台集合。调用方不得自行比较 `0.9.0` 或补默认值，只能消费该结果。
+ */
+export interface MiniappPlatformResolution {
+    /** 规范化后的显式平台声明；历史兼容场景为空数组。 */
+    readonly declared: readonly MiniappPlatform[];
+    /** 最终生效的平台集合：显式声明原样使用，历史产物为移动端兼容集合。 */
+    readonly effective: readonly MiniappPlatform[];
+    /** 是否显式声明了 `platforms`，用于区分显式移动端声明与历史移动端默认。 */
+    readonly platformsDeclared: boolean;
+    /** 本次解析采用的策略。 */
+    readonly policy: MiniappPlatformPolicy;
+}
+/**
+ * 解析 Manifest 平台声明，是 `0.9.0` 硬切规则的唯一实现。
+ *
+ * @remarks
+ * 规则与后端领域层保持一致：
+ * - 无 `platforms` 字段：`sdkVersion` 缺失或 SemVer precedence 低于
+ *   `MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION` 时按历史移动端兼容；达到或高于硬切点即非法。
+ * - 有 `platforms` 字段：复用 `validateMiniappPlatforms` 校验并规范化顺序；任何非法值
+ *   （空数组、非数组、未知值、重复值）都不回退到历史兼容，即使 `sdkVersion < 0.9.0`。
+ * - 任何非法的 `sdkVersion` 都会抛出，不做字符串比较。
+ * @param sdkVersion - 产物 hb-sdk 版本；历史产物可能缺失。
+ * @param manifest - 待解析的 Manifest（不可信输入）。
+ * @returns 冻结的平台解析结果。
+ * @throws Manifest 不是对象、`sdkVersion` 不是合法 SemVer、达到硬切点仍缺失 `platforms`，
+ *   或 `platforms` 声明非法时抛出。
+ */
+export declare function resolveMiniappManifestPlatforms(sdkVersion: string | undefined, manifest: unknown): MiniappPlatformResolution;
 /**
  * 校验并归一化 `package.json#heybox.window` / `manifest.window` 声明。
  *

package/types/miniapp-publish/index.d.ts

@@ -27,6 +27,7 @@ export declare const REOPEN_USER_MINIPROGRAM_API_PATH = "/mall/developer/user_mi
 export declare const UPDATE_SQUARE_DISPLAY_API_PATH = "/mall/developer/user_miniprogram/square_display/update";
 export declare const LIST_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_miniprogram/version/list";
 export { isValidMiniappManifestVersion as isValidVersion } from '../miniapp-manifest/schema';
+export { MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION, resolveMiniappManifestPlatforms, type MiniappPlatformPolicy, type MiniappPlatformResolution, } from '../miniapp-manifest/schema';
 export { parseMiniappBindAppIds, type ParseMiniappBindAppIdsOptions } from '../miniapp-manifest/bindings';
 export declare function normalizeRelativePath(relativePath: string): string;
 export declare function relativePathContainsNodeModulesSegment(relativePath: string): boolean;