@heybox/hb-sdk 0.9.2-alpha.8 → 0.9.2

package/CHANGELOG.md

@@ -2,6 +2,47 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 0.9.2 - 2026-10-20
+
+### 必须操作
+
+- [真机调试](https://docs.xiaoheihe.cn/hb_sdk/guide/cli)请将项目中的 `@heybox/hb-sdk` 升级至 `0.9.2`，重新运行 `hb-sdk dev` 并打开调试会话。启动前须完成 CLI 登录、小程序绑定及远端配置校验；校验失败时按提示修复后重试。
+- 移除 `@heybox/hb-sdk/miniapp-publish` 导出的 `getMiniappUploadKey()`、`validateUploadPaths()` 及其类型；升级前请检查项目是否直接引用这些导出。
+
+### 新增能力
+
+- 新增[云端字符串存储](https://docs.xiaoheihe.cn/hb_sdk/guide/cloud-storage) `cloud.storage.getStorage()`、`cloud.storage.setStorage()`、`cloud.storage.getKeys()` 和 `cloud.storage.removeItem()`；须声明 `cloud_storage` 权限并登录，数据按小程序与用户隔离。
+- 新增 [auth.getAccountState()](https://docs.xiaoheihe.cn/hb_sdk/reference/sdk/auth/getAccountState.html)，用于启动和回到前台时静默检查缓存业务会话是否仍属于当前 APP 账号；验证失败时保持待确认。
+- `auth.login()` 返回值与 [`heybox_app_login_change`](https://docs.xiaoheihe.cn/hb_sdk/guide/lifecycle#app-%E8%B4%A6%E5%8F%B7%E5%8F%98%E5%8C%96%E4%B8%8E%E4%B8%9A%E5%8A%A1%E4%BC%9A%E8%AF%9D) 增加可选的本地账号标识 [`accountKey`](https://docs.xiaoheihe.cn/hb_sdk/guide/auth#%E4%B8%9A%E5%8A%A1%E4%BC%9A%E8%AF%9D%E7%9A%84%E8%B4%A6%E5%8F%B7%E4%B8%80%E8%87%B4%E6%80%A7)，用于发现切号并停用旧会话；旧 Host 可能不提供该字段。
+- 新增 [`hb-sdk remote games search "游戏名" --json`](https://docs.xiaoheihe.cn/hb_sdk/guide/project-configuration#%E6%9F%A5%E8%AF%A2%E5%85%B3%E8%81%94%E6%B8%B8%E6%88%8F-id)，查询平台游戏 appid、中英文名称和分页结果，无需先绑定小程序项目；操作过于频繁时提示稍后重试。
+
+### 行为调整
+
+- [云存储限制](https://docs.xiaoheihe.cn/hb_sdk/guide/cloud-storage#%E9%99%90%E5%88%B6%E4%B8%8E%E9%94%99%E8%AF%AF)：key 仅支持英文字母、数字、下划线和连字符，最长 128 字符；value 最大 16 KB，不存在的 key 返回 `undefined`。
+- [手机真机调试](https://docs.xiaoheihe.cn/hb_sdk/guide/cli#%E6%B5%8F%E8%A7%88%E5%99%A8-mock-%E7%9A%84%E8%BE%B9%E7%95%8C)时，`network.request()` 仅对 `localhost` 和 `127.0.0.*` 使用开发机代理，其它域名和 IP 使用手机自身网络。
+- [`hb-sdk dev`](https://docs.xiaoheihe.cn/hb_sdk/guide/cli#_1-%E5%90%AF%E5%8A%A8%E8%B0%83%E8%AF%95%E9%A1%B5) 启动校验失败时退出并提供修复指引，不再自动进入匿名 Browser Mock；启动后真机调试暂不可用时，仍可继续使用浏览器调试。
+- 开发启动、构建和部署时，对简介缺失、工具类未关联游戏给出[非阻断提醒](https://docs.xiaoheihe.cn/hb_sdk/guide/project-configuration#%E8%B5%84%E6%96%99%E5%AE%8C%E5%96%84%E6%8F%90%E9%86%92)。Agent Skill 主动检查分类、简介和游戏绑定，保留已有内容，通用工具可保持不关联游戏。
+
+### 问题修复
+
+- 修复旧版 Android WebView 中[本地存储](https://docs.xiaoheihe.cn/hb_sdk/guide/storage)读写和清理失败的问题。
+- 修复同账号登录态刷新导致云存储误报登录状态变化的问题。
+- 修复部分鸿蒙客户端读取 Steam 游戏库时超时的问题。
+- 修复合法内测版本和历史预览入口读取用户信息失败的问题。
+- 修复 Vite 5/6 开发服务在输出资料或旧模板平台提醒时无法启动的问题。
+
+### 文档与工具
+
+- [API Reference](https://docs.xiaoheihe.cn/hb_sdk/reference/compatibility) 中的 API 可用版本统一展示正式版，并修正部分版本标注。
+
+## 0.9.2-alpha.9 - 2026-10-20
+
+### 文档与工具
+
+- 公开 API Reference、指南与包 README 中的 API 可用版本只展示正式版，不再出现 `-alpha` 等预发布标记；尚未发布的 API 标注目标正式版。
+- 修正 5 处「可用版本早于实际可导入版本」的标注：`viewport.setDisplay` 改为 `0.8.3`，`workspaceCards.requestRefresh` / `getLaunchContext` / `onLaunchContextChange` 改为 `0.9.1`，`cloud.storage` 四个方法改为目标正式版 `0.9.2`，`hasMiniappRuntimeGate` 与 `validateMiniappManifestForDeploy` 改为 `0.8.2`。
+- 移除 `./miniapp-publish` 中已无调用方的 `getMiniappUploadKey()` 与 `validateUploadPaths()` 及其类型；其余发布流程内部工具仍然导出，供 CLI 与运营后台复用，不再作为文档承诺的 API 契约。
+
 ## 0.9.2-alpha.8 - 2026-10-20
 
 ### 新增能力
@@ -1150,4 +1191,5 @@
 
 ## 0.5.6
 
+- 未发布到 npm 的稳定版本候选，不进入公开文档投影。
 - 开始维护公开 Package Changelog。

package/README.md

@@ -294,7 +294,7 @@ const stopDisplay = hbSDK.on('display_change', ({ orientation, fullscreen }) =>
 
 全屏同时收起胶囊和宿主额外顶部栏，不保证原生内容铺满容器；页面应按实际 WebView 窗口和安全区适配；这不代表系统状态栏、手势条被隐藏或设备安全区消失，重要控件仍应按实际窗口信息避让。宿主 Runtime 统一提供小尺寸“退出全屏”浮动按钮：首次出现和点击右侧边缘重新唤出后，均在 1 秒后淡出并收至边缘，保留可点击的唤出入口。展开时点击按钮会调用 `setDisplay({ orientation: 'portrait', fullscreen: false })`，恢复竖屏、非全屏；退出全屏或销毁会话时移除按钮。H5 无需另行提供退出控件，也可按需提供自己的入口。业务也可通过 `navigation.close()` 提供退出入口；窗口变化事件本身不代表设备方向发生变化。
 
-该 API 为实验能力，自 SDK `0.8.1-alpha.4` 提供，Android/iOS 原生能力最低客户端版本为 `1.3.396`，实际以桥接能力为准。SDK 将 `METHOD_FORBIDDEN`、`METHOD_NOT_FOUND` 和 `REQUEST_UNSUPPORTED` 统一转换为 `{ supported: false }`。本地 Web/PC Host 不伪造方向或胶囊支持，请在已接入的移动端真机验收。
+该 API 为实验能力，自 SDK `0.8.3` 提供，Android/iOS/OHOS 原生能力最低客户端版本为 `1.3.396`，实际以桥接能力为准。SDK 将 `METHOD_FORBIDDEN`、`METHOD_NOT_FOUND` 和 `REQUEST_UNSUPPORTED` 统一转换为 `{ supported: false }`。本地 Web/PC Host 不伪造方向或胶囊支持，请在已接入的移动端真机验收。
 
 ## 错误处理
 
@@ -349,7 +349,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 - `user.revokeAuthorization()` 在两种网络模式下都要求可信用户手势；成功后必须停止使用并清理业务缓存的旧身份、资料和服务端会话。
 - `on()` 返回取消监听函数，组件卸载或页面销毁时需要调用。
 - `storage.setStorage()` 每个小程序最多写入 1000 个不同的 key（已写过的 key 可反复更新）；超出时返回 `STORAGE_QUOTA_EXCEEDED`。不要用时间戳、URL 等动态值拼 key，批量或大体积数据请写入 `files` sandbox。支持清理的宿主允许用户从简介页清理本地数据，范围与限制见[本地存储](https://docs.xiaoheihe.cn/hb_sdk/guide/storage)。
-- 现有业务网络请求仍使用 `network.request()`；该 API 仍受支持，但目前没有替代调用入口，不要依赖浏览器原生网络出口。自 `0.8.1-alpha.7` 起 `withCredentials` 配置已移除，传入会被忽略且不报错。
+- 现有业务网络请求仍使用 `network.request()`；该 API 仍受支持，但目前没有替代调用入口，不要依赖浏览器原生网络出口。自 `0.8.1` 起 `withCredentials` 配置已移除，传入会被忽略且不报错。
 - 公开 `network.request()` 与 `network.download()` 均使用 no-follow redirect policy；3xx 不会在 Host 内静默跳转。
 - `network.request()` 不能访问平台保留的 runtime auth 与 OpenAPI 内部路径；页面不得持有或交换服务端应用凭据。
 - `network.request` 不支持 `multipart/form-data`；App Host 仅支持 form（`application/x-www-form-urlencoded`）与 JSON。表单请用 `URLSearchParams#toString()` 作为 `data`，文件上传请走专用上传能力。

package/dist/card-controller.cjs.js

@@ -89,6 +89,11 @@ function viewDocument(regions, options = {}) {
   return compact({ schema: VIEW_SCHEMA_VERSION, regions: [...regions], ...options });
 }
 
+/**
+ * 工作区卡片定义入口。
+ *
+ * @since 0.9.1
+ */
 function defineCard(definition) { return definition; }
 const actionInput = {
     string: (options = {}) => ({ type: 'string', ...options }),
@@ -99,6 +104,11 @@ const actionInput = {
         type: 'object', properties, required: Object.keys(properties), additionalProperties: false,
     }),
 };
+/**
+ * 工作区卡片 action 定义入口。
+ *
+ * @since 0.9.1
+ */
 function defineAction(definition) {
     let actionId;
     const pending = [];
@@ -121,6 +131,11 @@ function defineAction(definition) {
         } });
     return handle;
 }
+/**
+ * 打开小程序 action 定义入口。
+ *
+ * @since 0.9.1
+ */
 function defineOpenMiniProgramAction(options = {}) {
     let actionId;
     const pending = [];
@@ -142,18 +157,35 @@ function defineOpenMiniProgramAction(options = {}) {
         } });
     return handle;
 }
+/**
+ * 工作区卡片控制器定义入口。
+ *
+ * @since 0.9.1
+ */
 function defineWorkspaceCardsController(controller) {
     for (const [id, action] of Object.entries(controller.actions ?? {}))
         action.bindActionId?.(id);
     return controller;
 }
-/** 定义控制器；构建器和 Host 分别验证静态 action 表。 */
+/**
+ * 定义控制器；构建器和 Host 分别验证静态 action 表。
+ *
+ * @since 0.9.1
+ */
 function defineWorkspaceCardController(controller) { return controller; }
-/** 生成固定受管 invoke 入口；身份由 Host 根据真实卡片绑定。 */
+/**
+ * 生成固定受管 invoke 入口；身份由 Host 根据真实卡片绑定。
+ *
+ * @since 0.9.1
+ */
 function invoke(actionId, params) {
     return { commandId: WORKSPACE_CARD_COMMANDS.invoke, input: { actionId, ...(params === undefined ? {} : { params }) } };
 }
-/** 只允许打开当前小程序。 */
+/**
+ * 只允许打开当前小程序。
+ *
+ * @since 0.9.1
+ */
 function openMiniProgram(actionId, params) {
     return { commandId: WORKSPACE_CARD_COMMANDS.openMiniProgram, input: { actionId, ...(params === undefined ? {} : { params }) } };
 }

package/dist/card-controller.esm.js

@@ -87,6 +87,11 @@ function viewDocument(regions, options = {}) {
   return compact({ schema: VIEW_SCHEMA_VERSION, regions: [...regions], ...options });
 }
 
+/**
+ * 工作区卡片定义入口。
+ *
+ * @since 0.9.1
+ */
 function defineCard(definition) { return definition; }
 const actionInput = {
     string: (options = {}) => ({ type: 'string', ...options }),
@@ -97,6 +102,11 @@ const actionInput = {
         type: 'object', properties, required: Object.keys(properties), additionalProperties: false,
     }),
 };
+/**
+ * 工作区卡片 action 定义入口。
+ *
+ * @since 0.9.1
+ */
 function defineAction(definition) {
     let actionId;
     const pending = [];
@@ -119,6 +129,11 @@ function defineAction(definition) {
         } });
     return handle;
 }
+/**
+ * 打开小程序 action 定义入口。
+ *
+ * @since 0.9.1
+ */
 function defineOpenMiniProgramAction(options = {}) {
     let actionId;
     const pending = [];
@@ -140,18 +155,35 @@ function defineOpenMiniProgramAction(options = {}) {
         } });
     return handle;
 }
+/**
+ * 工作区卡片控制器定义入口。
+ *
+ * @since 0.9.1
+ */
 function defineWorkspaceCardsController(controller) {
     for (const [id, action] of Object.entries(controller.actions ?? {}))
         action.bindActionId?.(id);
     return controller;
 }
-/** 定义控制器；构建器和 Host 分别验证静态 action 表。 */
+/**
+ * 定义控制器；构建器和 Host 分别验证静态 action 表。
+ *
+ * @since 0.9.1
+ */
 function defineWorkspaceCardController(controller) { return controller; }
-/** 生成固定受管 invoke 入口；身份由 Host 根据真实卡片绑定。 */
+/**
+ * 生成固定受管 invoke 入口；身份由 Host 根据真实卡片绑定。
+ *
+ * @since 0.9.1
+ */
 function invoke(actionId, params) {
     return { commandId: WORKSPACE_CARD_COMMANDS.invoke, input: { actionId, ...(params === undefined ? {} : { params }) } };
 }
-/** 只允许打开当前小程序。 */
+/**
+ * 只允许打开当前小程序。
+ *
+ * @since 0.9.1
+ */
 function openMiniProgram(actionId, params) {
     return { commandId: WORKSPACE_CARD_COMMANDS.openMiniProgram, input: { actionId, ...(params === undefined ? {} : { params }) } };
 }

package/dist/cli-chunks/{build-BinntZJf.cjs → build-Dw22VIXS.cjs}

@@ -1,14 +1,14 @@
 'use strict';
 
-var runtimeGate = require('./runtime-gate-g3afiufR.cjs');
+var runtimeGate = require('./runtime-gate-DlljPriy.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.cjs');
-var index = require('./index-CY67PpQk.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-BHzCLf1O.cjs');
+var index = require('./index-BbBDiBGu.cjs');
 require('node:crypto');
 require('node:zlib');
-var projectVite = require('./project-vite-Dm128JTE.cjs');
+var projectVite = require('./project-vite-CCK80P0l.cjs');
 require('node:module');
 require('node:url');
 require('./_commonjs-dynamic-modules-DUamuDzp.cjs');
@@ -16,7 +16,7 @@ require('fs');
 require('path');
 require('os');
 require('inspector');
-require('./version-D40WHkF9.cjs');
+require('./version-Cg_M8yWW.cjs');
 require('node:async_hooks');
 require('readline');
 require('tty');

package/dist/cli-chunks/{context-BI3QMxw2.cjs → context-wxnfvTjH.cjs}

@@ -3,10 +3,10 @@
 var node_crypto = require('node:crypto');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-BHzCLf1O.cjs');
 var fs$1 = require('node:fs');
 var sharp = require('sharp');
-var index = require('./index-CY67PpQk.cjs');
+var index = require('./index-BbBDiBGu.cjs');
 
 async function inspectBasicInfoImage(bytes, sourcePath, kind) {
     const inspected = await inspectDecodedBasicInfoImage(bytes, kind);

package/dist/cli-chunks/{create-BK028Mlk.cjs → create-ecaoeTnL.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-CY67PpQk.cjs');
+var index = require('./index-BbBDiBGu.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{deploy-lock-pKDDxTKm.cjs → deploy-lock--NJ7NdXX.cjs}

@@ -3,7 +3,7 @@
 var node_crypto = require('node:crypto');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var index = require('./index-CY67PpQk.cjs');
+var index = require('./index-BbBDiBGu.cjs');
 
 const DEPLOY_LOCKED_MESSAGE = '当前设备已有同版本产物正在上传，请等待完成后重试';
 const DEPLOY_LOCK_DIRECTORY_NAME = 'deploy-locks';

package/dist/cli-chunks/{dev-DeNzUY6g.cjs → dev-Brpzyt0U.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var index = require('./index-CY67PpQk.cjs');
-var context = require('./context-BI3QMxw2.cjs');
+var index = require('./index-BbBDiBGu.cjs');
+var context = require('./context-wxnfvTjH.cjs');
 var node_crypto = require('node:crypto');
 var fs = require('node:fs');
-var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-BHzCLf1O.cjs');
 var os = require('node:os');
 var path = require('node:path');
 var net = require('node:net');
@@ -16,8 +16,8 @@ var fs$1 = require('node:fs/promises');
 var require$$0$1 = require('crypto');
 var require$$0 = require('buffer');
 var browser = require('./browser-RAy8e8cV.cjs');
-var projectVite = require('./project-vite-Dm128JTE.cjs');
-var version = require('./version-D40WHkF9.cjs');
+var projectVite = require('./project-vite-CCK80P0l.cjs');
+var version = require('./version-Cg_M8yWW.cjs');
 require('node:zlib');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -1995,8 +1995,8 @@ 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-DeNzUY6g.cjs', document.baseURI).href)))('ws');
-const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-DeNzUY6g.cjs', document.baseURI).href)))('parse5');
+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-Brpzyt0U.cjs', document.baseURI).href)))('ws');
+const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-Brpzyt0U.cjs', document.baseURI).href)))('parse5');
 const BROWSER_DEV_HOST_ROOT_CANDIDATES = [
     path.resolve(__dirname, 'devtools/browser-dev-host'),
     path.resolve(__dirname, '../devtools/browser-dev-host'),
@@ -11100,7 +11100,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-DQdwzMhB.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-4AAnDlTK.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;

package/dist/cli-chunks/{doctor-BOfbKnN2.cjs → doctor-D9YqT9KQ.cjs}

@@ -3,7 +3,7 @@
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-CY67PpQk.cjs');
+var index = require('./index-BbBDiBGu.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{games-yqu20laX.cjs → games-C1ecYTTz.cjs}

@@ -3,8 +3,8 @@
 var node_crypto = require('node:crypto');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var index = require('./index-CY67PpQk.cjs');
-var deployLock = require('./deploy-lock-pKDDxTKm.cjs');
+var index = require('./index-BbBDiBGu.cjs');
+var deployLock = require('./deploy-lock--NJ7NdXX.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{index-C7nrP0tt.cjs → index-B3Rry_DT.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index$2 = require('./index-CY67PpQk.cjs');
+var index$2 = require('./index-BbBDiBGu.cjs');
 var require$$0$3 = require('fs');
 var require$$0$2 = require('crypto');
 var require$$1$2 = require('path');

package/dist/cli-chunks/{index-CY67PpQk.cjs → index-BbBDiBGu.cjs}

@@ -238,19 +238,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-CY67PpQk.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-BbBDiBGu.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-CY67PpQk.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-BbBDiBGu.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-CY67PpQk.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-BbBDiBGu.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-CY67PpQk.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-BbBDiBGu.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-CY67PpQk.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-BbBDiBGu.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -17249,7 +17249,7 @@ async function inspectFeedbackLog(file, size) {
     return { mimeType: 'text/plain', width: 0, height: 0 };
 }
 async function createFeedbackCosClient(getToken) {
-    const { default: COS } = await Promise.resolve().then(function () { return require('./index-C7nrP0tt.cjs'); }).then(function (n) { return n.index; });
+    const { default: COS } = await Promise.resolve().then(function () { return require('./index-B3Rry_DT.cjs'); }).then(function (n) { return n.index; });
     const cos = new COS({
         getAuthorization(_options, callback) {
             void getToken().then((token) => callback({
@@ -20900,7 +20900,7 @@ function readEnvNameArgFromArgv(argv) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.9.2-alpha.8';
+const BUILT_CLI_VERSION = '0.9.2';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -21284,39 +21284,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-PJdMmFoB.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-e8GwAqrB.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-PJdMmFoB.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-e8GwAqrB.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-PJdMmFoB.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-e8GwAqrB.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-BinntZJf.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-Dw22VIXS.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-BK028Mlk.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-ecaoeTnL.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-DeNzUY6g.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-Brpzyt0U.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-BOfbKnN2.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-D9YqT9KQ.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunSkillInstallCommand = async (...args) => {
-    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-Bdy5Ehue.cjs'); });
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-DzD5EQiw.cjs'); });
     return runSkillInstallCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-CZuy1lmn.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-BrcgN56P.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {
@@ -21408,7 +21408,7 @@ function parseNonNegativeInteger(value) {
     return parsed;
 }
 const defaultRunGameSearchCommand = async (...args) => {
-    const { runGameSearchCommand } = await Promise.resolve().then(function () { return require('./games-yqu20laX.cjs'); });
+    const { runGameSearchCommand } = await Promise.resolve().then(function () { return require('./games-C1ecYTTz.cjs'); });
     return runGameSearchCommand(...args);
 };
 

package/dist/cli-chunks/{index.esm-DQdwzMhB.cjs → index.esm-4AAnDlTK.cjs}

@@ -11,8 +11,8 @@ var require$$0$3 = require('url');
 var require$$5 = require('zlib');
 var require$$0 = require('buffer');
 var require$$1 = require('util');
-var index = require('./index-CY67PpQk.cjs');
-var dev = require('./dev-DeNzUY6g.cjs');
+var index = require('./index-BbBDiBGu.cjs');
+var dev = require('./dev-Brpzyt0U.cjs');
 require('node:module');
 require('readline');
 require('os');
@@ -26,9 +26,9 @@ require('constants');
 require('node:fs');
 require('node:fs/promises');
 require('node:zlib');
-require('./context-BI3QMxw2.cjs');
-require('./runtime-permission-env-CDx5qO-T.cjs');
-require('./version-D40WHkF9.cjs');
+require('./context-wxnfvTjH.cjs');
+require('./runtime-permission-env-BHzCLf1O.cjs');
+require('./version-Cg_M8yWW.cjs');
 require('node:async_hooks');
 require('sharp');
 require('node:os');
@@ -42,7 +42,7 @@ require('node:buffer');
 require('node:url');
 require('node:util');
 require('node:child_process');
-require('./project-vite-Dm128JTE.cjs');
+require('./project-vite-CCK80P0l.cjs');
 
 var bufferUtil = {exports: {}};
 

package/dist/cli-chunks/{login-PJdMmFoB.cjs → login-e8GwAqrB.cjs}

@@ -3,7 +3,7 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var index = require('./index-CY67PpQk.cjs');
+var index = require('./index-BbBDiBGu.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
 require('node:module');
 require('readline');

package/dist/cli-chunks/{project-vite-Dm128JTE.cjs → project-vite-CCK80P0l.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-CY67PpQk.cjs');
+var index = require('./index-BbBDiBGu.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-CZuy1lmn.cjs → remote-BrcgN56P.cjs}

@@ -1,18 +1,18 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.cjs');
-var context = require('./context-BI3QMxw2.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-BHzCLf1O.cjs');
+var context = require('./context-wxnfvTjH.cjs');
 var promises = require('node:readline/promises');
-var index = require('./index-CY67PpQk.cjs');
-var runtimeGate = require('./runtime-gate-g3afiufR.cjs');
+var index = require('./index-BbBDiBGu.cjs');
+var runtimeGate = require('./runtime-gate-DlljPriy.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 node_crypto = require('node:crypto');
 require('node:zlib');
-var deployLock = require('./deploy-lock-pKDDxTKm.cjs');
-require('./version-D40WHkF9.cjs');
+var deployLock = require('./deploy-lock--NJ7NdXX.cjs');
+require('./version-Cg_M8yWW.cjs');
 require('node:async_hooks');
 require('sharp');
 require('node:module');
@@ -308,7 +308,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-C7nrP0tt.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-B3Rry_DT.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {

package/dist/cli-chunks/{runtime-gate-g3afiufR.cjs → runtime-gate-DlljPriy.cjs}

@@ -5,8 +5,8 @@ require('node:module');
 require('node:url');
 var fs = require('node:fs');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.cjs');
-var index = require('./index-CY67PpQk.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-BHzCLf1O.cjs');
+var index = require('./index-BbBDiBGu.cjs');
 var _commonjsDynamicModules = require('./_commonjs-dynamic-modules-DUamuDzp.cjs');
 var require$$0$1 = require('fs');
 var require$$1 = require('path');
@@ -201912,6 +201912,7 @@ const RUNTIME_GATE_BOOTSTRAP_MARKER = 'data-heybox-runtime-gate-bootstrap';
  * @param html - 待检查的完整 HTML 文本，使用 HTML parser 解析。
  * @returns Gate、隐藏样式及 bootstrap 标记均出现时返回 `true`，否则返回 `false`。
  * @remarks 只识别标记，不验证脚本内容、标记所在节点或宿主握手；不能据此判断页面安全或实际可运行。
+ * @since 0.8.2
  */
 function hasMiniappRuntimeGate(html) {
     const document = parse(html);