@heybox/hb-sdk 0.9.2-alpha.7 → 0.9.2-alpha.9

package/dist/cli-chunks/{index-bZIxID9N.cjs → index-hYvQR19Q.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-bZIxID9N.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-hYvQR19Q.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-bZIxID9N.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-hYvQR19Q.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-bZIxID9N.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-hYvQR19Q.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-bZIxID9N.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-hYvQR19Q.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-bZIxID9N.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-hYvQR19Q.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-DZUYwb3h.cjs'); }).then(function (n) { return n.index; });
+    const { default: COS } = await Promise.resolve().then(function () { return require('./index-CRwNLk5w.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.7';
+const BUILT_CLI_VERSION = '0.9.2-alpha.9';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -20966,6 +20966,7 @@ function createCliProgram(overrides = {}) {
         runDevCommand: defaultRunDevCommand,
         runDoctorCommand: defaultRunDoctorCommand,
         runRemoteCommand: defaultRunRemoteCommand,
+        runGameSearchCommand: defaultRunGameSearchCommand,
         runSkillInstallCommand: defaultRunSkillInstallCommand,
         ...overrides,
     };
@@ -21070,6 +21071,20 @@ function addRemotePublicOptions(command) {
 }
 function installRemoteCommands(program, handlers, resolveLogger) {
     const remote = addRemotePublicOptions(program.command('remote').description('管理当前项目绑定的远程 Heybox 工坊小程序'));
+    const games = addVerboseOption(remote.command('games').description('查询平台游戏信息'));
+    addVerboseOption(games.command('search').description('按名称查找游戏 appid，不修改绑定')
+        .argument('<query>', '中文或英文游戏名')
+        .option('--offset <offset>', '结果偏移量，0–10000', '0')
+        .option('--limit <limit>', '每页数量，1–20', '10')
+        .option('--json', '输出 JSON'))
+        .action(async (query, _options, command) => {
+        const options = readCommandOptionsWithAncestors(command);
+        await handlers.runGameSearchCommand(query, {
+            offset: readStringOption(options.offset),
+            limit: readStringOption(options.limit),
+            json: Boolean(options.json),
+        });
+    });
     addRemotePublicOptions(remote.command('access').description('查看当前账号的小程序工坊访问权限')).action(createRemoteAction(handlers, resolveLogger, 'access'));
     const entity = addRemotePublicOptions(remote.command('entity').description('查看和切换当前开发者主体'));
     addRemotePublicOptions(entity.command('list').description('列出当前账号可切换的开发者主体')).action(createRemoteAction(handlers, resolveLogger, 'entity:list'));
@@ -21269,39 +21284,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-BYM3Nwau.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DMJ45_Bs.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-BYM3Nwau.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DMJ45_Bs.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-BYM3Nwau.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DMJ45_Bs.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-Do22AWbq.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-DvHmPnZZ.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-QuI_mw8x.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-CJ0cyrJG.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-KAhj5UTy.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-DhEZBjd6.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-DNoQWBpo.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-B8q0UuXs.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunSkillInstallCommand = async (...args) => {
-    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-DFXZ0SK_.cjs'); });
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-CtKW2J0U.cjs'); });
     return runSkillInstallCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-dvOjaxJu.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-CSuwqlKA.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {
@@ -21392,6 +21407,10 @@ function parseNonNegativeInteger(value) {
     }
     return parsed;
 }
+const defaultRunGameSearchCommand = async (...args) => {
+    const { runGameSearchCommand } = await Promise.resolve().then(function () { return require('./games-CmO-AKXg.cjs'); });
+    return runGameSearchCommand(...args);
+};
 
 exports.CliError = CliError;
 exports.HB_SDK_PACKAGE_NAME = HB_SDK_PACKAGE_NAME;

package/dist/cli-chunks/{index.esm-EWleN3S5.cjs → index.esm-DU7YhFWI.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-bZIxID9N.cjs');
-var dev = require('./dev-KAhj5UTy.cjs');
+var index = require('./index-hYvQR19Q.cjs');
+var dev = require('./dev-DhEZBjd6.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-DQhjWa7X.cjs');
-require('./runtime-permission-env-B9SqoP85.cjs');
-require('./version-CwEOrhL1.cjs');
+require('./context-DYlZV8UG.cjs');
+require('./runtime-permission-env-CbqmHz0r.cjs');
+require('./version-BQMfLqms.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-6eLmb4Em.cjs');
+require('./project-vite-BGy9w-Bx.cjs');
 
 var bufferUtil = {exports: {}};
 

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

package/dist/cli-chunks/{project-vite-6eLmb4Em.cjs → project-vite-BGy9w-Bx.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-bZIxID9N.cjs');
+var index = require('./index-hYvQR19Q.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-dvOjaxJu.cjs → remote-CSuwqlKA.cjs}

@@ -1,17 +1,18 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-B9SqoP85.cjs');
-var context = require('./context-DQhjWa7X.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CbqmHz0r.cjs');
+var context = require('./context-DYlZV8UG.cjs');
 var promises = require('node:readline/promises');
-var index = require('./index-bZIxID9N.cjs');
-var runtimeGate = require('./runtime-gate-BKc2zPV-.cjs');
+var index = require('./index-hYvQR19Q.cjs');
+var runtimeGate = require('./runtime-gate-BvcLwvzi.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-CwEOrhL1.cjs');
+var deployLock = require('./deploy-lock-CmKl9M1c.cjs');
+require('./version-BQMfLqms.cjs');
 require('node:async_hooks');
 require('sharp');
 require('node:module');
@@ -33,6 +34,27 @@ require('inspector');
 // 脚手架开发占位图；构建可用，提审前必须替换。
 const BASIC_INFO_PLACEHOLDER_SHA256 = 'd14e54b30f5e6d1bcbf51267bc82b06a0af7c333f2945bcc16b4e1adc3b123dd';
 
+/** 根据当前项目声明或实际版本 Manifest 检查资料完整性，不联网、不修改输入。 */
+function getMiniappMetadataWarnings(metadata) {
+    const warnings = [];
+    if (metadata.desc === undefined || (typeof metadata.desc === 'string' && !metadata.desc.trim())) {
+        warnings.push({
+            code: 'MINIAPP_DESC_MISSING',
+            field: 'desc',
+            message: '尚未填写小程序简介。建议在 package.json#heybox.desc 中说明主要功能和适用场景，修改后重新构建。',
+        });
+    }
+    if (metadata.category === 'tool' &&
+        (metadata.bindAppIds === undefined || (Array.isArray(metadata.bindAppIds) && metadata.bindAppIds.length === 0))) {
+        warnings.push({
+            code: 'MINIAPP_TOOL_GAME_BINDING_MISSING',
+            field: 'bindAppIds',
+            message: '当前小程序为工具类，尚未关联游戏。如服务于特定 PC 游戏，可通过 hb-sdk remote games search "游戏名" 查询 appid 并填写 package.json#heybox.bindAppIds，修改后重新构建；通用工具可保持为空。',
+        });
+    }
+    return warnings;
+}
+
 const CREATE_USER_MINIPROGRAM_UPLOAD_SESSION_API_PATH = '/mall/developer/user_miniprogram/version/upload_session/create';
 const RECORD_USER_MINIPROGRAM_UPLOAD_RESULT_API_PATH = '/mall/developer/user_miniprogram/version/upload_session/record';
 const COMPANION_FINALIZATION_TIMEOUT_MS = 30 * 60_000;
@@ -286,7 +308,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-DZUYwb3h.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-CRwNLk5w.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {
@@ -353,144 +375,6 @@ async function computeMiniappArtifactReceipt(files, runtime = {}) {
     return { artifactSignature: hash.digest('hex'), files: preparedFiles };
 }
 
-const DEPLOY_LOCKED_MESSAGE = '当前设备已有同版本产物正在上传，请等待完成后重试';
-const DEPLOY_LOCK_DIRECTORY_NAME = 'deploy-locks';
-const DEPLOY_LOCK_OWNER_FILE = 'owner.json';
-const INCOMPLETE_LOCK_GRACE_MS = 30_000;
-const defaultPaths = index.envPaths('hb-sdk', { suffix: '' });
-class DeployLockConflictError extends Error {
-}
-async function withDeployLock(scope, operation, options = {}) {
-    let lock;
-    try {
-        lock = await acquireDeployLock(scope, options);
-    }
-    catch (error) {
-        if (error instanceof DeployLockConflictError) {
-            throw error;
-        }
-        // 本地文件锁只减少重复操作，文件系统异常不阻断服务端上传流程。
-        return operation();
-    }
-    try {
-        return await operation();
-    }
-    finally {
-        await lock.release().catch(() => undefined);
-    }
-}
-async function acquireDeployLock(scope, options = {}) {
-    const lockDirectory = getDeployLockDirectory(scope, options.cacheRoot);
-    const ownerFile = path.join(lockDirectory, DEPLOY_LOCK_OWNER_FILE);
-    const owner = {
-        version: 1,
-        pid: options.pid ?? process.pid,
-        token: options.token ?? node_crypto.randomBytes(16).toString('hex'),
-    };
-    await fs$1.mkdir(path.dirname(lockDirectory), { recursive: true, mode: 0o700 });
-    for (let attempt = 0; attempt < 2; attempt += 1) {
-        let created = false;
-        try {
-            await fs$1.mkdir(lockDirectory, { mode: 0o700 });
-            created = true;
-            await fs$1.writeFile(ownerFile, `${JSON.stringify(owner)}\n`, { encoding: 'utf8', mode: 0o600 });
-            return createDeployLock(lockDirectory, ownerFile, owner.token);
-        }
-        catch (error) {
-            if (created) {
-                await fs$1.rm(lockDirectory, { force: true, recursive: true });
-                throw error;
-            }
-            if (!isNodeError(error) || error.code !== 'EEXIST') {
-                throw error;
-            }
-            if (!(await canReclaimDeployLock(lockDirectory, ownerFile, options))) {
-                throw new DeployLockConflictError(DEPLOY_LOCKED_MESSAGE);
-            }
-            await reclaimDeployLock(lockDirectory, owner.token);
-        }
-    }
-    throw new DeployLockConflictError(DEPLOY_LOCKED_MESSAGE);
-}
-function getDeployLockDirectory(scope, cacheRoot = defaultPaths.cache) {
-    const scopeHash = node_crypto.createHash('sha256').update(`${scope.apiBaseUrl}\0${scope.miniProgramId}\0${scope.version}`).digest('hex');
-    return path.join(cacheRoot, DEPLOY_LOCK_DIRECTORY_NAME, scopeHash);
-}
-function createDeployLock(lockDirectory, ownerFile, token) {
-    let released = false;
-    return {
-        async release() {
-            if (released)
-                return;
-            released = true;
-            await removeOwnedLock(lockDirectory, ownerFile, token);
-        },
-    };
-}
-async function canReclaimDeployLock(lockDirectory, ownerFile, options) {
-    const owner = await readDeployLockOwner(ownerFile);
-    if (owner) {
-        return !(options.isProcessRunning ?? isProcessRunning)(owner.pid);
-    }
-    try {
-        const lockStat = await fs$1.stat(lockDirectory);
-        return (options.now ?? Date.now)() - lockStat.mtimeMs >= INCOMPLETE_LOCK_GRACE_MS;
-    }
-    catch (error) {
-        return isNodeError(error) && error.code === 'ENOENT';
-    }
-}
-async function removeOwnedLock(lockDirectory, ownerFile, token) {
-    const owner = await readDeployLockOwner(ownerFile);
-    if (owner?.token === token) {
-        await fs$1.rm(lockDirectory, { force: true, recursive: true });
-    }
-}
-async function reclaimDeployLock(lockDirectory, token) {
-    const reclaimDirectory = `${lockDirectory}.reclaim-${node_crypto.createHash('sha256').update(token).digest('hex')}`;
-    try {
-        await fs$1.rename(lockDirectory, reclaimDirectory);
-    }
-    catch (error) {
-        if (isNodeError(error) && error.code === 'ENOENT')
-            return;
-        throw error;
-    }
-    await fs$1.rm(reclaimDirectory, { force: true, recursive: true });
-}
-async function readDeployLockOwner(ownerFile) {
-    try {
-        const value = JSON.parse(await fs$1.readFile(ownerFile, 'utf8'));
-        return isDeployLockOwner(value) ? value : null;
-    }
-    catch (error) {
-        if (isNodeError(error) && error.code === 'ENOENT')
-            return null;
-        if (error instanceof SyntaxError)
-            return null;
-        throw error;
-    }
-}
-function isDeployLockOwner(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        value.version === 1 &&
-        Number.isInteger(value.pid) &&
-        typeof value.token === 'string');
-}
-function isProcessRunning(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return !isNodeError(error) || error.code !== 'ESRCH';
-    }
-}
-function isNodeError(error) {
-    return error instanceof Error && 'code' in error;
-}
-
 /** 发布提示使用显式声明与远端主体批准策略，不消费本地调试授权。 */
 function getUnapprovedPermissionWarning(local, approvals, partyType) {
     if (!local.declared)
@@ -610,7 +494,7 @@ async function runDeployCommand(options, runtime = {}) {
             const buildScript = await readProjectBuildScript(projectRoot);
             logger.info(`开始构建: ${pm} ${createBuildArgs(pm, buildMode, buildScript).join(' ')}`);
             await runBuildScript(pm, projectRoot, runtime.spawn ?? childProcess.spawn, {
-                env: runtimePermissionEnv.createMiniappPlatformCspEnv(env, skipPlatformCsp),
+                env: { ...runtimePermissionEnv.createMiniappPlatformCspEnv(env, skipPlatformCsp), HB_SDK_DEFER_METADATA_WARNINGS: '1' },
                 mode: buildMode,
                 outputMode: options.buildOutputMode ?? 'inherit',
                 platform,
@@ -627,6 +511,9 @@ async function runDeployCommand(options, runtime = {}) {
             const distDir = path.join(projectRoot, 'dist');
             const parsedManifest = await readDeployManifest(projectRoot, logger);
             ({ manifest, version } = parsedManifest);
+            for (const warning of getMiniappMetadataWarnings(manifest)) {
+                logger.warn(`[${warning.code}] ${warning.message}`, { stream: 'stderr' });
+            }
             if (manifest.category !== declaredCategory) {
                 throw new Error('dist/manifest.json.category 与 package.json#heybox.category 不一致，请重新 build 后再 deploy');
             }
@@ -792,7 +679,7 @@ async function runDeployCommand(options, runtime = {}) {
             version,
         };
     };
-    return (runtime.withDeployLock ?? withDeployLock)({ apiBaseUrl, miniProgramId, version: uploadVersion }, deploy);
+    return (runtime.withDeployLock ?? deployLock.withDeployLock)({ apiBaseUrl, miniProgramId, version: uploadVersion }, deploy);
 }
 function printDeploySuccess(options) {
     options.logger.success(`提交审核成功：${options.miniProgramId} ${options.version}`);

package/dist/cli-chunks/{runtime-gate-BKc2zPV-.cjs → runtime-gate-BvcLwvzi.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-B9SqoP85.cjs');
-var index = require('./index-bZIxID9N.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CbqmHz0r.cjs');
+var index = require('./index-hYvQR19Q.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);

package/dist/cli-chunks/{runtime-permission-env-B9SqoP85.cjs → runtime-permission-env-CbqmHz0r.cjs}

@@ -1,9 +1,9 @@
 'use strict';
 
-var index = require('./index-bZIxID9N.cjs');
+var index = require('./index-hYvQR19Q.cjs');
 var fs = require('node:fs');
 var path = require('node:path');
-var version$1 = require('./version-CwEOrhL1.cjs');
+var version$1 = require('./version-BQMfLqms.cjs');
 require('node:crypto');
 var node_async_hooks = require('node:async_hooks');
 
@@ -247,6 +247,7 @@ const MANAGED_RUNTIME_PERMISSION_KEYS = new Set(MINI_PROGRAM_PERMISSION_KEYS);
  * @see [parseMiniProgramRuntimePermissions](/reference/symbols/protocol/functions/parseMiniProgramRuntimePermissions) 完整 snapshot 的 trim、legacy 归一化与 config 校验。
  * @see [MINI_PROGRAM_PROTOCOL_CAPABILITIES](/reference/symbols/protocol/constants/MINI_PROGRAM_PROTOCOL_CAPABILITIES) method 到 permission requirement 的权威映射。
  * @see [权限声明](/guide/permissions) Manifest 声明、平台批准与 Runtime 状态的完整流程。
+ * @since 0.6.4
  */
 function isManagedMiniProgramRuntimePermissionKey(key) {
     return MANAGED_RUNTIME_PERMISSION_KEYS.has(key);
@@ -322,6 +323,7 @@ function isManagedMiniProgramRuntimePermissionKey(key) {
  * @see {@link isManagedMiniProgramRuntimePermissionKey}
  * @see {@link MINI_PROGRAM_PROTOCOL_CAPABILITIES}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
+ * @since 0.6.4
  */
 function parseMiniProgramRuntimePermissions(snapshot) {
     if (!isRecord$2$1(snapshot) || snapshot.schema_version !== 1 || !Array.isArray(snapshot.entries)) {
@@ -6955,6 +6957,7 @@ function serializeMiniProgramDevelopmentSnapshot(snapshot) {
  * @param sourceLabel - 错误消息中的字段来源，默认 `package.json#heybox.category`。
  * @returns 合法类别原值；输入 `undefined` 时返回 `undefined`，由发布流程另行检查是否必填。
  * @throws `Error` 输入为其他值（包括 null 或空字符串）时抛出带字段来源的错误。
+ * @since 0.8.3
  */
 function parseMiniappCategory(value, sourceLabel = 'package.json#heybox.category') {
     if (value === undefined)
@@ -6973,6 +6976,7 @@ const BASIC_INFO_MAX_PIXELS = 40_000_000;
  * @returns NFKC 规范化、去除首尾 Unicode White_Space 后的名称；不折叠规范化后的内部空白。
  * @throws `Error` 输入不是字符串，或规范化后不是 1–40 个 Unicode code point、不含文字或数字，或包含控制字符、
  * 格式字符、行/段分隔符以及 HTML 特殊字符 `<`、`>`、`&`、双引号或单引号时抛出。
+ * @since 0.8.2
  */
 function normalizeBasicInfoName(raw) {
     if (typeof raw !== 'string')
@@ -7004,6 +7008,7 @@ function validateBasicInfoPath(raw) {
  * @remarks
  * 图片路径必须使用 `/` 分隔的非空相对路径，扩展名为 JPEG、PNG、GIF 或 WebP；拒绝 URL、点段、
  * 控制字符和构建/缓存等保留目录。此函数只校验声明，不读取文件，也不验证图片字节、尺寸或存在性。
+ * @since 0.8.2
  */
 function parseMiniappBasicInfo(value, sdkVersion = '0.8.2') {
     sdkVersion = sdkVersion.trim();
@@ -7076,6 +7081,7 @@ const MINIAPP_BIND_APP_IDS_MAX_COUNT = 20;
  * @see [miniappManifest](/reference/symbols/vite/functions/miniappManifest)
  * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
  * @see [CLI 与远端发布](/guide/cli#生产构建)
+ * @since 0.8.1
  */
 function parseMiniappBindAppIds(value, options = {}) {
     const sourceLabel = options.sourceLabel ?? 'package.json#heybox.bindAppIds';
@@ -7312,6 +7318,7 @@ function hasMiniappDesktopPlatform(platforms) {
  *
  * @see {@link resolveMiniappManifestPlatforms}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/vite/functions/miniappManifest | miniappManifest}
+ * @since 0.3.1
  */
 function isValidMiniappManifestVersion(version) {
     return getMiniappManifestVersionError(version) === undefined;
@@ -7350,6 +7357,7 @@ function parseMiniappManifestJson(raw, sourceLabel = 'manifest.json') {
  * @remarks
  * 不修改输入对象，不执行文件 I/O；不会验证图片/归档是否存在、内容摘要是否匹配，也不查询远端发布资格。
  * 成功仅表示 Manifest 字段通过校验，不能替代文件检查与服务端发布预检。
+ * @since 0.8.2
  */
 function validateMiniappManifestForDeploy(manifest) {
     const version = validateMiniappManifestVersion(manifest.version, 'manifest.version');
@@ -15890,6 +15898,7 @@ const textEncoder = new TextEncoder();
  * @see {@link relativePathContainsNodeModulesSegment}
  * @see {@link shouldUploadDistFile}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/protocol/functions/isMiniProgramRelativePath | isMiniProgramRelativePath}
+ * @since 0.3.1
  */
 function normalizeRelativePath(relativePath) {
     return String(relativePath || '')
@@ -15920,6 +15929,7 @@ function normalizeRelativePath(relativePath) {
  * @see [normalizeRelativePath](/reference/symbols/miniapp-publish/functions/normalizeRelativePath)
  * @see [shouldUploadDistFile](/reference/symbols/miniapp-publish/functions/shouldUploadDistFile)
  * @see [miniapp-publish](/reference/miniapp-publish/)
+ * @since 0.3.1
  */
 function relativePathContainsNodeModulesSegment(relativePath) {
     return normalizeRelativePath(relativePath)
@@ -16003,6 +16013,7 @@ function getMiniProgramUploadAlias(miniProgramId) {
  * @see {@link ValidateUploadTotalSizeOptions}
  * @see [shouldUploadDistFile](/reference/symbols/miniapp-publish/functions/shouldUploadDistFile)
  * @see [miniapp-publish](/reference/miniapp-publish/)
+ * @since 0.4.7
  */
 function validateUploadTotalSize(items, options = {}) {
     const limit = options.limitBytes ?? MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES;
@@ -16095,6 +16106,7 @@ function validateMiniappUploadSizeBudgets(items, options = {}) {
  * @see [relativePathContainsNodeModulesSegment](/reference/symbols/miniapp-publish/functions/relativePathContainsNodeModulesSegment)
  * @see [validateUploadTotalSize](/reference/symbols/miniapp-publish/functions/validateUploadTotalSize)
  * @see [miniapp-publish](/reference/miniapp-publish/)
+ * @since 0.3.1
  */
 function shouldUploadDistFile(relativePath) {
     const normalized = normalizeRelativePath(relativePath);

package/dist/cli-chunks/{skill-DFXZ0SK_.cjs → skill-CtKW2J0U.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var version = require('./version-CwEOrhL1.cjs');
+var version = require('./version-BQMfLqms.cjs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
 var childProcess = require('node:child_process');
-var index = require('./index-bZIxID9N.cjs');
+var index = require('./index-hYvQR19Q.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{version-CwEOrhL1.cjs → version-BQMfLqms.cjs}

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

package/dist/cli.cjs

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