@heybox/hb-sdk 0.9.1-alpha.10 → 0.9.1-alpha.12

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 0.9.1-alpha.12 - 2026-10-16
+
+### 行为调整
+
+- 新宿主仅对正式 SDK `0.9.1` 及以上启用默认截图水印；较旧版本（含 `0.9.1-alpha.*`）或缺少版本记录的兼容模式静默保留无水印截图。
+- SDK 每次调用 `share.screenshot()` 时输出行为变更提醒，说明水印版本门槛、底部至少预留 57 个逻辑像素及明暗配色；日志输出失败不影响截图。
+
+### 文档与工具
+
+- Agent Skill 强制检查截图升级影响，提醒同步核对页面布局、版本兼容和主题选择。
+
+## 0.9.1-alpha.11 - 2026-10-16
+
+### 新增能力
+
+- 支持通过 `package.json#heybox.desc` 配置小程序简介，并在构建产物中保留 `manifest.desc`。
+
+### 问题修复
+
+- 本地存储写入时维护当前小程序的独立索引，便于宿主页统计和清理数据；历史空值读取为未设置。
+
 ## 0.9.1-alpha.10 - 2026-10-16
 
 > 影响级别：必须操作

package/README.md

@@ -332,7 +332,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 | `network`    | 发起经过平台授权的网络请求及受控文件传输  |
 | `companion`  | 准备、启动并控制当前版本审核过的桌面辅助应用    |
 
-`share.screenshot()` 会在截图区域底部添加当前小程序名称的品牌搜索胶囊及灰色「小黑盒工坊小程序」。请在目标区域底部预留至少 57 个逻辑像素的空白背景，避免遮挡重要内容，并保证背景与水印有足够对比度。`watermarkTheme: 'light'` 适合浅色背景（黑色水印），`'dark'` 适合深色背景（白色水印，默认）；不自动跟随系统主题。水印仅在 SDK 截图期间展示，不增加图片尺寸；系统按键截图暂不支持。截图等待不受 SDK 普通请求超时限制；排队和延迟期间会响应会话终止，Mobile Host 从投递原生截图起最多等待 15 秒成图回调。详见 [截图分享布局要求](https://docs.xiaoheihe.cn/hb_sdk/recipes/community-share#截图分享)。
+`share.screenshot()` 每次调用都会在 SDK 侧输出行为变更 warning，提醒升级后的布局与配色要求；日志失败不阻断调用。截图从正式 SDK `0.9.1` 起默认添加水印。新 Runtime 对低于 `0.9.1` 的 SDK（包含 `0.9.1-alpha.*`）或缺少 SDK 版本记录的兼容模式静默保持无水印截图；升级前需同步调整布局。启用水印时，会在截图区域底部添加当前小程序名称的品牌搜索胶囊及灰色「小黑盒工坊小程序」。请在目标区域底部预留至少 57 个逻辑像素的空白背景，避免遮挡重要内容，并保证背景与水印有足够对比度。`watermarkTheme: 'light'` 适合浅色背景（黑色水印），`'dark'` 适合深色背景（白色水印，默认）；不自动跟随系统主题。水印仅在 SDK 截图期间展示，不增加图片尺寸；系统按键截图暂不支持。截图等待不受 SDK 普通请求超时限制；排队和延迟期间会响应会话终止，Mobile Host 从投递原生截图起最多等待 15 秒成图回调。详见 [截图分享布局要求](https://docs.xiaoheihe.cn/hb_sdk/recipes/community-share#截图分享)。
 
 具体方法、参数和返回值以 [API Reference](https://docs.xiaoheihe.cn/hb_sdk/reference/) 为准，常见组合写法见 [Recipes](https://docs.xiaoheihe.cn/hb_sdk/recipes/)。
 
@@ -346,6 +346,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 - `auth.login()`、`user.getInfo()` 和 `user.getSteamGameList()` 的可用性不由 `network` 决定；它们分别要求 `userInfo` 或 `steamLibrary`，并继续遵循各自的用户授权和数据规则。
 - `user.revokeAuthorization()` 在两种网络模式下都要求可信用户手势；成功后必须停止使用并清理业务缓存的旧身份、资料和服务端会话。
 - `on()` 返回取消监听函数，组件卸载或页面销毁时需要调用。
+- `storage.setStorage()` 每个小程序最多写入 1000 个不同的 key（已写过的 key 可反复更新）；超出时返回 `STORAGE_QUOTA_EXCEEDED`。不要用时间戳、URL 等动态值拼 key，批量或大体积数据请写入 `files` sandbox。用户可在小程序简介页清理全部本地数据。
 - 现有业务网络请求仍使用 `network.request()`；该 API 仍受支持，但目前没有替代调用入口，不要依赖浏览器原生网络出口。自 `0.8.1-alpha.7` 起 `withCredentials` 配置已移除，传入会被忽略且不报错。
 - 公开 `network.request()` 与 `network.download()` 均使用 no-follow redirect policy；3xx 不会在 Host 内静默跳转。
 - `network.request()` 不能访问平台保留的 runtime auth 与 OpenAPI 内部路径；页面不得持有或交换服务端应用凭据。

package/dist/cli-chunks/{build-BK0MOduC.cjs → build-CDvX6mZ_.cjs}

@@ -1,14 +1,14 @@
 'use strict';
 
-var runtimeGate = require('./runtime-gate-wKj1l5xM.cjs');
+var runtimeGate = require('./runtime-gate-C8LOiCNj.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-DBra_0-U.cjs');
-var index = require('./index-BWRDIX1T.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DJh53zIV.cjs');
+var index = require('./index-B7zxtWTI.cjs');
 require('node:crypto');
 require('node:zlib');
-var projectVite = require('./project-vite-DD3bmbqm.cjs');
+var projectVite = require('./project-vite-B4bIN6iT.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-BF4JQQCU.cjs');
+require('./version-DJMVnGTf.cjs');
 require('node:async_hooks');
 require('readline');
 require('tty');

package/dist/cli-chunks/{context-D7AFyc_9.cjs → context-ycfj98q4.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-DBra_0-U.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DJh53zIV.cjs');
 var fs$1 = require('node:fs');
 var sharp = require('sharp');
-var index = require('./index-BWRDIX1T.cjs');
+var index = require('./index-B7zxtWTI.cjs');
 
 async function inspectBasicInfoImage(bytes, sourcePath, kind) {
     const inspected = await inspectDecodedBasicInfoImage(bytes, kind);

package/dist/cli-chunks/{create-C-pAXZR_.cjs → create-TQBnsU6A.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-BWRDIX1T.cjs');
+var index = require('./index-B7zxtWTI.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{dev-CONKtd6c.cjs → dev-DIlr0XsT.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var index = require('./index-BWRDIX1T.cjs');
-var context = require('./context-D7AFyc_9.cjs');
+var index = require('./index-B7zxtWTI.cjs');
+var context = require('./context-ycfj98q4.cjs');
 var node_crypto = require('node:crypto');
 var fs = require('node:fs');
-var runtimePermissionEnv = require('./runtime-permission-env-DBra_0-U.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DJh53zIV.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-DD3bmbqm.cjs');
-var version = require('./version-BF4JQQCU.cjs');
+var projectVite = require('./project-vite-B4bIN6iT.cjs');
+var version = require('./version-DJMVnGTf.cjs');
 require('node:zlib');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -1992,8 +1992,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-CONKtd6c.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-CONKtd6c.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-DIlr0XsT.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-DIlr0XsT.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'),
@@ -11093,7 +11093,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-CtAKePcf.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-CshHset7.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;

package/dist/cli-chunks/{doctor-D18leeH7.cjs → doctor-CNvx5BMQ.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-BWRDIX1T.cjs');
+var index = require('./index-B7zxtWTI.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{index-BWRDIX1T.cjs → index-B7zxtWTI.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-BWRDIX1T.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-B7zxtWTI.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-BWRDIX1T.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-B7zxtWTI.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-BWRDIX1T.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-B7zxtWTI.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-BWRDIX1T.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-B7zxtWTI.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-BWRDIX1T.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-B7zxtWTI.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-DJoBhXcG.cjs'); }).then(function (n) { return n.index; });
+    const { default: COS } = await Promise.resolve().then(function () { return require('./index-CPAecgVy.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.1-alpha.10';
+const BUILT_CLI_VERSION = '0.9.1-alpha.12';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -21269,39 +21269,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-BHq8vDRt.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-D9IsRXmh.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-BHq8vDRt.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-D9IsRXmh.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-BHq8vDRt.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-D9IsRXmh.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-BK0MOduC.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-CDvX6mZ_.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-C-pAXZR_.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-TQBnsU6A.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-CONKtd6c.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-DIlr0XsT.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-D18leeH7.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-CNvx5BMQ.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunSkillInstallCommand = async (...args) => {
-    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-Cq3wjRBj.cjs'); });
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-5dzzu2QT.cjs'); });
     return runSkillInstallCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-DeLLzkXt.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-DeUMkvWX.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{index-DJoBhXcG.cjs → index-CPAecgVy.cjs}

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

package/dist/cli-chunks/{index.esm-CtAKePcf.cjs → index.esm-CshHset7.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-BWRDIX1T.cjs');
-var dev = require('./dev-CONKtd6c.cjs');
+var index = require('./index-B7zxtWTI.cjs');
+var dev = require('./dev-DIlr0XsT.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-D7AFyc_9.cjs');
-require('./runtime-permission-env-DBra_0-U.cjs');
-require('./version-BF4JQQCU.cjs');
+require('./context-ycfj98q4.cjs');
+require('./runtime-permission-env-DJh53zIV.cjs');
+require('./version-DJMVnGTf.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-DD3bmbqm.cjs');
+require('./project-vite-B4bIN6iT.cjs');
 
 var bufferUtil = {exports: {}};
 

package/dist/cli-chunks/{login-BHq8vDRt.cjs → login-D9IsRXmh.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-BWRDIX1T.cjs');
+var index = require('./index-B7zxtWTI.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
 require('node:module');
 require('readline');

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

package/dist/cli-chunks/{remote-DeLLzkXt.cjs → remote-DeUMkvWX.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-DBra_0-U.cjs');
-var context = require('./context-D7AFyc_9.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DJh53zIV.cjs');
+var context = require('./context-ycfj98q4.cjs');
 var promises = require('node:readline/promises');
-var index = require('./index-BWRDIX1T.cjs');
-var runtimeGate = require('./runtime-gate-wKj1l5xM.cjs');
+var index = require('./index-B7zxtWTI.cjs');
+var runtimeGate = require('./runtime-gate-C8LOiCNj.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');
-require('./version-BF4JQQCU.cjs');
+require('./version-DJMVnGTf.cjs');
 require('node:async_hooks');
 require('sharp');
 require('node:module');
@@ -286,7 +286,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-DJoBhXcG.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-CPAecgVy.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {

package/dist/cli-chunks/{runtime-gate-wKj1l5xM.cjs → runtime-gate-C8LOiCNj.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-DBra_0-U.cjs');
-var index = require('./index-BWRDIX1T.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DJh53zIV.cjs');
+var index = require('./index-B7zxtWTI.cjs');
 var _commonjsDynamicModules = require('./_commonjs-dynamic-modules-DUamuDzp.cjs');
 var require$$0$1 = require('fs');
 var require$$1 = require('path');

package/dist/cli-chunks/{runtime-permission-env-DBra_0-U.cjs → runtime-permission-env-DJh53zIV.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var index = require('./index-BWRDIX1T.cjs');
+var index = require('./index-B7zxtWTI.cjs');
 var fs = require('node:fs');
 var path = require('node:path');
-var version$1 = require('./version-BF4JQQCU.cjs');
+var version$1 = require('./version-DJMVnGTf.cjs');
 require('node:crypto');
 var node_async_hooks = require('node:async_hooks');
 
@@ -7061,6 +7061,31 @@ function parseMiniappBindAppIds(value, options = {}) {
     return Object.freeze(appIds);
 }
 
+/** 小程序简介最大长度（Unicode code point），与服务端截断口径一致。 */
+const MINIAPP_DESC_MAX_LENGTH = 200;
+/**
+ * 校验并规范化 `package.json#heybox.desc` / `manifest.desc`。
+ *
+ * @param value - 原始声明；未声明时为 `undefined`。
+ * @param sourceLabel - 错误消息中的字段来源，默认 `package.json#heybox.desc`。
+ * @returns 去除首尾空白后的简介；未声明或为空串时返回 `undefined`。
+ * @throws `Error` 非字符串、超过 200 个字符，或包含除换行外的控制字符时抛出。
+ */
+function parseMiniappDesc(value, sourceLabel = 'package.json#heybox.desc') {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        throw new Error(`${sourceLabel} 必须是字符串`);
+    const desc = value.replace(/^\p{White_Space}+|\p{White_Space}+$/gu, '');
+    if (!desc)
+        return undefined;
+    if (Array.from(desc).length > MINIAPP_DESC_MAX_LENGTH)
+        throw new Error(`${sourceLabel} 不能超过 ${MINIAPP_DESC_MAX_LENGTH} 个字符`);
+    if (/[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/u.test(desc.replace(/\n/g, '')))
+        throw new Error(`${sourceLabel} 不能包含控制字符`);
+    return desc;
+}
+
 const MINIAPP_PERMISSION_KEYS = MINI_PROGRAM_PERMISSION_KEYS;
 function parseMiniappPermissions(value, options) {
     const sourceLabel = options.sourceLabel ?? 'package.json#heybox.permissions';
@@ -7299,6 +7324,7 @@ function validateMiniappManifestForDeploy(manifest) {
         throw new Error('manifest.category 缺失，请在 package.json#heybox.category 声明 tool、game 或 other 后重新构建');
     }
     const bindAppIds = parseMiniappBindAppIds(manifest.bindAppIds, { sourceLabel: 'manifest.bindAppIds' });
+    const desc = parseMiniappDesc(manifest.desc, 'manifest.desc');
     return {
         version,
         sdkVersion,
@@ -7310,6 +7336,7 @@ function validateMiniappManifestForDeploy(manifest) {
         ...(window === undefined ? {} : { window }),
         ...(bindAppIds.length === 0 ? {} : { bindAppIds }),
         ...(category === undefined ? {} : { category }),
+        ...(desc === undefined ? {} : { desc }),
     };
 }
 function validateGeneratedCompanions(value) {

package/dist/cli-chunks/{skill-Cq3wjRBj.cjs → skill-5dzzu2QT.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var version = require('./version-BF4JQQCU.cjs');
+var version = require('./version-DJMVnGTf.cjs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
 var childProcess = require('node:child_process');
-var index = require('./index-BWRDIX1T.cjs');
+var index = require('./index-B7zxtWTI.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{version-BF4JQQCU.cjs → version-DJMVnGTf.cjs}

@@ -3,6 +3,6 @@
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.10';
+    : '0.9.1-alpha.12';
 
 exports.HB_SDK_VERSION = HB_SDK_VERSION;

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./cli-chunks/index-BWRDIX1T.cjs');
+var index = require('./cli-chunks/index-B7zxtWTI.cjs');
 require('node:module');
 require('readline');
 require('os');