@heybox/hb-sdk 0.7.4 → 0.8.0-alpha

package/CHANGELOG.md

@@ -1,5 +1,66 @@
 # Changelog
 
+## 0.8.0-alpha
+
+### Breaking Changes
+
+- `miniappManifest({ platforms })` 要求新构建的本地小程序产物显式声明目标平台；通过 `--from-version` 复用的历史产物允许缺失并保持“平台声明未分类”。
+
+### SDK
+
+- 公开运行时 API 使用严格 TSDoc 记录加入版本、支持平台、最低客户端版本、稳定性和废弃信息。
+
+### Docs / Agent Skill
+
+- API Reference 按模块和调用路径生成独立方法页、可跳转类型、反向引用、兼容性矩阵及统一搜索数据。
+- 新项目模板显式预填 `android`、`ios`、`ohos` 三个平台；该初始值不是 Runtime fallback 或真机验收证明。
+- canonical Docs 增加独立阻断 CI 门禁，校验 TSDoc、Manifest、API 图、生成物 freshness、链接和桌面/移动端阅读体验。
+
+## 0.7.6-alpha.0
+
+### Runtime
+
+- 修复完整文档返回合法页面后误报 `UNEXPECTED_DOCUMENT_LOAD`；Host 发起 history traversal 时在遍历前隐藏 iframe，并在同一 2 秒截止时间内支持晚到 SDK 重发 probe。
+- 修复 v2 bridge ready 早于首个 iframe load 时吞掉真实导航的问题，并保持普通 heartbeat、hide/show 与终态清理语义。
+- 锁定 v2 handshake 后的 envelope 版本，继续校验精确 origin、nonce、SDK 版本和当前 Mini-program/version 路径。
+
+### Tooling
+
+- Android、iOS 与 OHOS Host 支持按弹层、iframe history、关闭 Mini-program 的顺序返回；Android 保留 `only_capture=1`。
+- 修复结构化协议失败、关闭与卸载竞态、动态 Playwright 端口，并为用户小程序 Host 增加阻塞双浏览器回归。
+
+## 0.7.5
+
+### SDK
+
+- 修复分享编码的旧浏览器兼容 (@heybox/hb-sdk).
+- 增加渐进式本地调试双栈 (@heybox/hb-sdk).
+- 支持分享扩展数据与链接复制 (@heybox/hb-sdk).
+- 恢复无网络用户全量 scope (hb-sdk).
+- 修复小程序宿主存储对象读取.
+
+### Runtime
+
+- 本地读取无网络用户身份 (@heybox/hb-sdk-runtime).
+- 补齐授权弹窗展示资料 (@heybox/hb-sdk-runtime).
+- 兼容旧版 iOS 用户手势判断 (@heybox/hb-sdk-runtime).
+- 完成 Runtime Host 分层硬切 (@heybox/hb-sdk-runtime).
+
+### Tooling
+
+- 发布 0.7.4 正式版 (@heybox/hb-sdk).
+- 发布 0.7.3 正式版 (@heybox/hb-sdk).
+
+## 0.7.5-alpha.0
+
+### SDK / Runtime
+
+- 将 `@msgpack/msgpack` 精确锁定到 `2.8.0`，保持分享 `extra` 编码兼容，同时避免用户小程序 Host 产物引入旧版浏览器不支持的 BigInt 能力。
+
+### Tooling
+
+- SDK release family 变化时增加用户小程序详情 Host 的无副作用生产构建，提前拦截最终浏览器产物兼容性回归。
+
 ## 0.7.4
 
 ### Breaking Changes

package/README.md

@@ -78,7 +78,7 @@ import { defineConfig } from 'vite';
 
 export default defineConfig({
   base: './',
-  plugins: [miniappManifest()],
+  plugins: [miniappManifest({ platforms: ['android', 'ios', 'ohos'] })],
 });
 ```
 
@@ -106,18 +106,18 @@ window.addEventListener('unload', stopHandshakeState, { once: true });
 
 SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握手状态，并通过 `on()` / `off()` 处理前后台、登录态等生命周期事件。
 
-| 模块         | 用途                                                         |
-| ------------ | ------------------------------------------------------------ |
-| `auth`       | 获取交给开发者服务端交换的短期授权码                         |
-| `user`       | 读取 Host 当前用户资料、隔离身份或撤销授权                   |
-| `share`      | 打开分享、复制链接或截图分享流程                             |
-| `ui`         | 展示 Toast 和 Loading                                        |
-| `device`     | 调用振动和剪贴板能力                                         |
-| `navigation` | 关闭、刷新页面或打开小黑盒页面                               |
-| `viewport`   | 读取窗口信息和设置导航栏样式                                 |
-| `storage`    | 读写当前小程序的隔离存储                                     |
-| `cloud`      | 使用小程序云端排行榜                                         |
-| `network`    | 发起经过平台授权的网络请求                                   |
+| 模块         | 用途                                       |
+| ------------ | ------------------------------------------ |
+| `auth`       | 获取交给开发者服务端交换的短期授权码       |
+| `user`       | 读取 Host 当前用户资料、隔离身份或撤销授权 |
+| `share`      | 打开分享、复制链接或截图分享流程           |
+| `ui`         | 展示 Toast 和 Loading                      |
+| `device`     | 调用振动和剪贴板能力                       |
+| `navigation` | 关闭、刷新页面或打开小黑盒页面             |
+| `viewport`   | 读取窗口信息和设置导航栏样式               |
+| `storage`    | 读写当前小程序的隔离存储                   |
+| `cloud`      | 使用小程序云端排行榜                       |
+| `network`    | 发起经过平台授权的网络请求                 |
 
 具体方法、参数和返回值以 [API Reference](https://docs.xiaoheihe.cn/hb_sdk/reference/) 为准，常见组合写法见 [Recipes](https://docs.xiaoheihe.cn/hb_sdk/recipes/)。
 
@@ -137,7 +137,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 - `network.request()` 不能访问平台保留的 runtime auth 与 OpenAPI 内部路径；页面不得持有或交换服务端应用凭据。
 - `network.request` 不支持 `multipart/form-data`；App Host 仅支持 form（`application/x-www-form-urlencoded`）与 JSON。表单请用 `URLSearchParams#toString()` 作为 `data`，文件上传请走专用上传能力。
 - 仅当远端已启用 `network.request` 时，`hb-sdk dev` 与 `hb-sdk remote deploy` 构建才会跳过平台 CSP；其他构建继续注入平台 CSP。`useOfficialDomain` 不参与 CSP 跳过判定。
-- 构建必须启用 `miniappManifest()`，推荐统一使用 `hb-sdk build`。
+- 构建必须启用 `miniappManifest({ platforms })` 并显式声明实际承诺适配的平台，推荐统一使用 `hb-sdk build`。新项目模板中的 `['android', 'ios', 'ohos']` 只是初始配置，不代表已经完成真机验收。
 
 ## 分享扩展数据
 

package/dist/cli-chunks/{build-CVPqGQY3.cjs → build-DJWFSM1B.cjs}

@@ -3,10 +3,10 @@
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
-var runtimeGate = require('./runtime-gate-CtV7rWyX.cjs');
-var index = require('./index-DLrcC_ij.cjs');
-var projectVite = require('./project-vite-c13CKUUl.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
+var runtimeGate = require('./runtime-gate-DFjw66kF.cjs');
+var index = require('./index-D62ANeBv.cjs');
+var projectVite = require('./project-vite-CcE-HMmd.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');
@@ -91,7 +91,7 @@ async function validateBuildOutput(projectRoot, logger) {
     if (hadBom) {
         logger.warn('dist/manifest.json 包含 BOM，已自动剥离');
     }
-    const { sdkVersion, version } = runtimeGate.validateMiniappManifestForDeploy(manifest);
+    const { platforms, sdkVersion, version } = runtimeGate.validateMiniappManifestForDeploy(manifest);
     const allFiles = await walkDistFiles(distDir);
     const uploadFiles = allFiles.filter((file) => runtimePermissionEnv.shouldUploadDistFile(file.relativePath));
     const sizeError = runtimePermissionEnv.validateUploadTotalSize(uploadFiles);
@@ -102,6 +102,7 @@ async function validateBuildOutput(projectRoot, logger) {
         distDir,
         fileCount: uploadFiles.length,
         sdkVersion,
+        platforms,
         totalBytes: uploadFiles.reduce((total, file) => total + file.size, 0),
         version,
     };

package/dist/cli-chunks/{context-C1nTGr-R.cjs → context-DV2UK1Nz.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var session = require('./session-ySUU0fVq.cjs');
-var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
+var session = require('./session-BDi_AZSv.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');

package/dist/cli-chunks/{create-C5qrLLvv.cjs → create-2HfoB48V.cjs}

@@ -5,7 +5,7 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var require$$0 = require('fs');
 var require$$1 = require('path');
-var index = require('./index-DLrcC_ij.cjs');
+var index = require('./index-D62ANeBv.cjs');
 require('node:module');
 require('os');
 require('readline');

package/dist/cli-chunks/{dev-U5BlN4ei.cjs → dev-Dgt2zS9k.cjs}

@@ -8,16 +8,16 @@ var node_crypto = require('node:crypto');
 var promises = require('node:dns/promises');
 var node_http = require('node:http');
 var node_module = require('node:module');
-var context = require('./context-C1nTGr-R.cjs');
+var context = require('./context-DV2UK1Nz.cjs');
 var undici = require('undici');
 var fs$1 = require('node:fs/promises');
-var index = require('./index-DLrcC_ij.cjs');
+var index = require('./index-D62ANeBv.cjs');
 var require$$0$1 = require('crypto');
 var require$$0 = require('buffer');
-var session = require('./session-ySUU0fVq.cjs');
+var session = require('./session-BDi_AZSv.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var projectVite = require('./project-vite-c13CKUUl.cjs');
-var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
+var projectVite = require('./project-vite-CcE-HMmd.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 class Locked extends Error {
@@ -1741,7 +1741,7 @@ const DEFAULT_CHANNEL_TRANSPORT = {
 };
 const IPV4_LOOPBACK_ADDRESSES = new net.BlockList();
 IPV4_LOOPBACK_ADDRESSES.addSubnet('127.0.0.0', 8, 'ipv4');
-const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-U5BlN4ei.cjs', document.baseURI).href)))('ws');
+const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-Dgt2zS9k.cjs', document.baseURI).href)))('ws');
 const BROWSER_DEV_HOST_ROOT_CANDIDATES = [
     path.resolve(__dirname, 'devtools/browser-dev-host'),
     path.resolve(__dirname, '../devtools/browser-dev-host'),
@@ -10741,7 +10741,7 @@ function assertNodeRuntimeCapabilities(ctx, settings) {
 function createNodeRealtimeDriverRegistry() {
     const registry = createRuntimeRealtimeDriverRegistry();
     registry.registerLazy('node-websocket', async () => {
-        const mod = await Promise.resolve().then(function () { return require('./index.esm-DbbyeU1z.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-CigcxJ2B.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;
@@ -14908,7 +14908,7 @@ function writeLaunchResponse(response, status, body) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.7.4';
+    : '0.8.0-alpha';
 
 class DevPermissionOverrideStoreError extends Error {
     code;

package/dist/cli-chunks/{doctor-DxqHMTbm.cjs → doctor-C95gIao_.cjs}

@@ -4,7 +4,7 @@ var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-DLrcC_ij.cjs');
+var index = require('./index-D62ANeBv.cjs');
 require('node:module');
 require('path');
 require('os');

package/dist/cli-chunks/{index-BfR6OZeU.cjs → index-BjoSXl8C.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index$2 = require('./index-DLrcC_ij.cjs');
+var index$2 = require('./index-D62ANeBv.cjs');
 var require$$0$3 = require('fs');
 var require$$0$2 = require('crypto');
 var require$$1$2 = require('path');
 var require$$0$5 = require('assert');
 var require$$0$4 = require('events');
 var require$$1$1 = require('util');
-var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 var require$$0$7 = require('net');
 var require$$0$6 = require('url');
 var require$$2$1 = require('http');

package/dist/cli-chunks/{index-DLrcC_ij.cjs → index-D62ANeBv.cjs}

@@ -234,19 +234,19 @@ function requireArgument () {
 
 var command = {};
 
-const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DLrcC_ij.cjs', document.baseURI).href)));
+const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
 function __require$4() { return require$5("node:events"); }
 
-const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DLrcC_ij.cjs', document.baseURI).href)));
+const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
 function __require$3() { return require$4("node:child_process"); }
 
-const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DLrcC_ij.cjs', document.baseURI).href)));
+const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
 function __require$2() { return require$3("node:path"); }
 
-const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DLrcC_ij.cjs', document.baseURI).href)));
+const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
 function __require$1() { return require$2("node:fs"); }
 
-const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DLrcC_ij.cjs', document.baseURI).href)));
+const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-D62ANeBv.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13347,7 +13347,7 @@ function getPathname(pathWithQuery) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.7.4';
+const BUILT_CLI_VERSION = '0.8.0-alpha';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13682,35 +13682,35 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DQkArK14.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-Cumknwdx.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DQkArK14.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-Cumknwdx.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DQkArK14.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-Cumknwdx.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-CVPqGQY3.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-DJWFSM1B.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-C5qrLLvv.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-2HfoB48V.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-U5BlN4ei.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-Dgt2zS9k.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-DxqHMTbm.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-C95gIao_.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-816SyJyA.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-DDdP3xcE.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{index.esm-DbbyeU1z.cjs → index.esm-CigcxJ2B.cjs}

@@ -11,8 +11,8 @@ var require$$0$4 = require('url');
 var require$$0 = require('zlib');
 var require$$0$1 = require('buffer');
 var require$$1 = require('util');
-var index = require('./index-DLrcC_ij.cjs');
-var dev = require('./dev-U5BlN4ei.cjs');
+var index = require('./index-D62ANeBv.cjs');
+var dev = require('./dev-Dgt2zS9k.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');
@@ -27,11 +27,11 @@ require('node:net');
 require('node:crypto');
 require('node:dns/promises');
 require('node:http');
-require('./context-C1nTGr-R.cjs');
-require('./session-ySUU0fVq.cjs');
+require('./context-DV2UK1Nz.cjs');
+require('./session-BDi_AZSv.cjs');
 require('fs');
 require('constants');
-require('./runtime-permission-env-D-8_jPG3.cjs');
+require('./runtime-permission-env-CjsCe5bp.cjs');
 require('node:async_hooks');
 require('undici');
 require('./browser-RAy8e8cV.cjs');
@@ -40,7 +40,7 @@ require('node:buffer');
 require('node:url');
 require('node:util');
 require('node:child_process');
-require('./project-vite-c13CKUUl.cjs');
+require('./project-vite-CcE-HMmd.cjs');
 
 var bufferUtil = {exports: {}};
 

package/dist/cli-chunks/{login-DQkArK14.cjs → login-Cumknwdx.cjs}

@@ -3,9 +3,9 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var session = require('./session-ySUU0fVq.cjs');
+var session = require('./session-BDi_AZSv.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-DLrcC_ij.cjs');
+var index = require('./index-D62ANeBv.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{project-vite-c13CKUUl.cjs → project-vite-CcE-HMmd.cjs}

@@ -5,7 +5,7 @@ var fs$1 = require('node:fs/promises');
 var node_module = require('node:module');
 var path = require('node:path');
 var node_url = require('node:url');
-var index = require('./index-DLrcC_ij.cjs');
+var index = require('./index-D62ANeBv.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-816SyJyA.cjs → remote-DDdP3xcE.cjs}

@@ -1,16 +1,16 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var index = require('./index-DLrcC_ij.cjs');
-var session = require('./session-ySUU0fVq.cjs');
+var index = require('./index-D62ANeBv.cjs');
+var session = require('./session-BDi_AZSv.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
-var runtimeGate = require('./runtime-gate-CtV7rWyX.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
+var runtimeGate = require('./runtime-gate-DFjw66kF.cjs');
 var node_crypto = require('node:crypto');
-var context = require('./context-C1nTGr-R.cjs');
+var context = require('./context-DV2UK1Nz.cjs');
 require('node:module');
 require('path');
 require('os');
@@ -271,7 +271,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-BfR6OZeU.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-BjoSXl8C.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {
@@ -677,6 +677,7 @@ async function runDeployCommand(options, runtime = {}) {
         };
     };
     if (fromVersion) {
+        logger.info('平台声明：未分类（复用历史产物）');
         return deploy();
     }
     return (runtime.withDeployLock ?? withDeployLock)({ apiBaseUrl, miniProgramId, version: uploadVersion }, deploy);
@@ -735,9 +736,10 @@ async function readDeployManifest(projectRoot, logger) {
     }
     const validated = runtimeGate.validateMiniappManifestForDeploy(manifest);
     return {
-        manifest,
+        manifest: { ...manifest, platforms: validated.platforms },
         sdkVersion: validated.sdkVersion,
         version: validated.version,
+        platforms: validated.platforms,
     };
 }
 function validateVersionForDeploy(version, sourceLabel) {
@@ -877,7 +879,7 @@ function inferMimeType(fileName) {
 }
 async function assertDeployUploadFilesStillMatchSignature(options) {
     const currentFiles = runtimePermissionEnv.prepareMiniappArtifactFiles((await walkDistFiles(options.distDir)).filter((entry) => runtimePermissionEnv.shouldUploadDistFile(entry.relativePath)));
-    const currentByPath = new Map(currentFiles.map(file => [file.relativePath, file]));
+    const currentByPath = new Map(currentFiles.map((file) => [file.relativePath, file]));
     if (currentFiles.length !== options.expectedFiles.length) {
         throw new Error('dist 构建产物在签名后发生变化，请重新执行 deploy');
     }

package/dist/cli-chunks/{runtime-gate-CtV7rWyX.cjs → runtime-gate-DFjw66kF.cjs}

@@ -1,7 +1,8 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-D-8_jPG3.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 
+const MINIAPP_PLATFORM_VALUES = ['android', 'ios', 'ohos', 'windows', 'macos', 'linux'];
 function isValidMiniappManifestVersion(version) {
     return getMiniappManifestVersionError(version) === undefined;
 }
@@ -34,8 +35,26 @@ function validateMiniappManifestForDeploy(manifest) {
     return {
         version: validateMiniappManifestVersion(manifest.version, 'manifest.version'),
         sdkVersion: validateSdkVersion(manifest.sdkVersion, 'manifest.sdkVersion'),
+        platforms: validateMiniappPlatforms(manifest.platforms, 'manifest.platforms'),
     };
 }
+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)));
+}
 function validateSdkVersion(version, sourceLabel = 'sdkVersion') {
     if (typeof version !== 'string' || version.trim() === '') {
         throw new Error(`${sourceLabel} 必须是合法 SemVer：${String(version)}`);

package/dist/cli-chunks/{runtime-permission-env-D-8_jPG3.cjs → runtime-permission-env-CjsCe5bp.cjs}

@@ -2869,7 +2869,7 @@ function shouldUploadDistFile(relativePath) {
 /**
  * 校验构建产物路径和大小，并按路径 UTF-8 字节序排序。
  *
- * @param files 待处理的构建产物文件。
+ * @param files - 待处理的构建产物文件。
  * @returns 保留输入附加字段的有序文件列表。
  * @throws 路径不规范、路径重复或文件大小非法时抛出错误。
  */
@@ -2878,7 +2878,7 @@ function prepareMiniappArtifactFiles(files) {
         throw new Error('构建产物文件数量超出签名协议上限');
     }
     const usedPaths = new Set();
-    const prepared = files.map(file => {
+    const prepared = files.map((file) => {
         const relativePath = normalizeMiniappArtifactRelativePath(file.relativePath);
         if (usedPaths.has(relativePath)) {
             throw new Error(`构建产物包含重复文件路径：${relativePath}`);
@@ -2892,15 +2892,15 @@ function prepareMiniappArtifactFiles(files) {
 /**
  * 按服务端 session key 前缀校验最终上传路径的 UTF-8 字节长度。
  *
- * @param files 待上传的构建产物文件。
- * @param options 小程序和长度限制配置。
+ * @param files - 待上传的构建产物文件。
+ * @param options - 小程序和长度限制配置。
  * @returns 第一个超长路径的错误提示；全部合法时返回 `undefined`。
  */
 function validateMiniappUploadPathLengths(files, options) {
     const maxLength = options.maxLength ?? ACTIVITY_UPLOAD_KEY_MAX_LENGTH;
     const prefix = `/u/${getMiniProgramUploadAlias(options.miniProgramId)}/${'x'.repeat(MINIAPP_UPLOAD_SESSION_REF_LENGTH)}/`;
     const prefixLength = textEncoder.encode(prefix).length;
-    const tooLongFile = files.find(file => {
+    const tooLongFile = files.find((file) => {
         const relativePath = normalizeMiniappArtifactRelativePath(file.relativePath);
         return prefixLength + textEncoder.encode(relativePath).length > maxLength;
     });
@@ -2909,7 +2909,7 @@ function validateMiniappUploadPathLengths(files, options) {
 /**
  * 创建 v1 整包签名头。
  *
- * @param fileCount 参与签名的文件数量。
+ * @param fileCount - 参与签名的文件数量。
  * @returns 包含协议标识和文件数量的字节数组。
  * @throws 文件数量超出协议范围时抛出错误。
  */
@@ -2922,7 +2922,7 @@ function createMiniappArtifactSignatureHeader(fileCount) {
 /**
  * 创建单个文件的 v1 framing header。
  *
- * @param file 已规范化或待校验的构建产物文件。
+ * @param file - 已规范化或待校验的构建产物文件。
  * @returns 包含路径长度、路径和文件大小的字节数组。
  * @throws 文件路径或大小非法时抛出错误。
  */
@@ -2935,9 +2935,9 @@ function createMiniappArtifactFileHeader(file) {
 /**
  * 校验服务端 session 文件映射，并计算仍需上传的文件。
  *
- * @param localFiles 本地构建产物文件。
- * @param serverFiles 服务端签发的文件映射。
- * @param uploadedKeys 服务端已确认上传成功的 key。
+ * @param localFiles - 本地构建产物文件。
+ * @param serverFiles - 服务端签发的文件映射。
+ * @param uploadedKeys - 服务端已确认上传成功的 key。
  * @returns 完整映射、待上传文件和已确认 key。
  * @throws 服务端映射与本地产物不一致时抛出错误。
  */
@@ -2969,7 +2969,7 @@ function resolveMiniappUploadSessionFiles(localFiles, serverFiles, uploadedKeys)
         serverSizes.set(relativePath, size);
         knownKeys.add(key);
     }
-    const files = preparedFiles.map(file => {
+    const files = preparedFiles.map((file) => {
         const key = mappings.get(file.relativePath);
         if (!key) {
             throw new Error(`上传会话缺少文件映射：${file.relativePath}`);
@@ -2989,7 +2989,7 @@ function resolveMiniappUploadSessionFiles(localFiles, serverFiles, uploadedKeys)
     }
     return {
         files,
-        missingFiles: files.filter(file => !completed.has(file.key)),
+        missingFiles: files.filter((file) => !completed.has(file.key)),
         uploadedKeys: [...completed],
     };
 }
@@ -3007,7 +3007,7 @@ function normalizeMiniappArtifactRelativePath(relativePath) {
     if (containsControlCharacter(value) || UNPAIRED_SURROGATE_PATTERN.test(value)) {
         throw new Error(`构建产物路径包含非法字符：${value}`);
     }
-    if (value.split('/').some(segment => !segment || segment === '.' || segment === '..')) {
+    if (value.split('/').some((segment) => !segment || segment === '.' || segment === '..')) {
         throw new Error(`构建产物路径包含非法目录段：${value}`);
     }
     if (value.includes(',')) {

package/dist/cli-chunks/{session-ySUU0fVq.cjs → session-BDi_AZSv.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./index-DLrcC_ij.cjs');
+var index = require('./index-D62ANeBv.cjs');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
 var require$$0$2 = require('fs');

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./cli-chunks/index-DLrcC_ij.cjs');
+var index = require('./cli-chunks/index-D62ANeBv.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');