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

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 0.9.2-alpha.8 - 2026-10-20
+
+### 新增能力
+
+- 新增 `hb-sdk remote games search "游戏名" --json`，查询平台游戏 appid、中英文名称和分页结果，无需先绑定小程序项目。
+- CLI 游戏搜索增加请求频率保护，操作过于频繁时提示稍后重试。
+
+### 行为调整
+
+- 开发启动、构建和部署时，对简介缺失、工具类未关联游戏给出非阻断提醒；部署不重复输出内部构建的资料提示。
+- Agent Skill 主动检查小程序分类、简介和游戏绑定，保留已有内容，通用工具可保持不关联游戏。
+
+### 问题修复
+
+- 修复 Vite 5/6 开发服务在输出资料或旧模板平台提醒时无法启动的问题。
+
 ## 0.9.2-alpha.7 - 2026-10-20
 
 ### 行为调整

package/README.md

@@ -124,6 +124,8 @@ async function revokeAuthorizationFromUserAction() {
 
 小程序类别需在 `package.json#heybox.category` 声明为 `tool`、`game` 或 `other`，构建后写入 Manifest，CLI/Open 提审自动采用，发布后生效。开发者提审页不展示或提供手动选择类别；新上传版本（含已有小程序更新）必须声明，缺少类别的项目须补配置后重新构建上传，详见 [小程序类别](https://docs.xiaoheihe.cn/hb_sdk/guide/cli#小程序类别)。
 
+使用 `hb-sdk remote games search "游戏名" --json` 查询平台游戏候选，无需先绑定项目；核对后将返回的字符串 `appid` 填入 `heybox.bindAppIds`，能否绑定以部署预检为准。简介缺失、工具类未关联游戏时，开发启动、构建和部署会给出非阻断提醒；具体流程见 [CLI 指南](https://docs.xiaoheihe.cn/hb_sdk/guide/cli)。
+
 `bindAppIds` 只接受规范十进制字符串（形如 `/^[1-9]\d*$/`，拒绝前导零、空串与非数字），每项必须是正 int32（最大 `2147483647`），数组内不允许重复，最多 20 项，并按数值升序写入 Manifest。它不是权限，构建不联网；游戏真实性在远端预检和提审时校验。字段缺失或 `[]` 都表示清空绑定。PC 展示仍受 `platforms` 过滤。
 
 再启用构建插件：

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

@@ -1,14 +1,14 @@
 'use strict';
 
-var runtimeGate = require('./runtime-gate-BKc2zPV-.cjs');
+var runtimeGate = require('./runtime-gate-g3afiufR.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 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-CDx5qO-T.cjs');
+var index = require('./index-CY67PpQk.cjs');
 require('node:crypto');
 require('node:zlib');
-var projectVite = require('./project-vite-6eLmb4Em.cjs');
+var projectVite = require('./project-vite-Dm128JTE.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-CwEOrhL1.cjs');
+require('./version-D40WHkF9.cjs');
 require('node:async_hooks');
 require('readline');
 require('tty');

package/dist/cli-chunks/{context-DQhjWa7X.cjs → context-BI3QMxw2.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-B9SqoP85.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.cjs');
 var fs$1 = require('node:fs');
 var sharp = require('sharp');
-var index = require('./index-bZIxID9N.cjs');
+var index = require('./index-CY67PpQk.cjs');
 
 async function inspectBasicInfoImage(bytes, sourcePath, kind) {
     const inspected = await inspectDecodedBasicInfoImage(bytes, kind);

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

package/dist/cli-chunks/deploy-lock-pKDDxTKm.cjs

@@ -0,0 +1,148 @@
+'use strict';
+
+var node_crypto = require('node:crypto');
+var fs = require('node:fs/promises');
+var path = require('node:path');
+var index = require('./index-CY67PpQk.cjs');
+
+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.mkdir(path.dirname(lockDirectory), { recursive: true, mode: 0o700 });
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        let created = false;
+        try {
+            await fs.mkdir(lockDirectory, { mode: 0o700 });
+            created = true;
+            await fs.writeFile(ownerFile, `${JSON.stringify(owner)}\n`, { encoding: 'utf8', mode: 0o600 });
+            return createDeployLock(lockDirectory, ownerFile, owner.token);
+        }
+        catch (error) {
+            if (created) {
+                await fs.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.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.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.rename(lockDirectory, reclaimDirectory);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    await fs.rm(reclaimDirectory, { force: true, recursive: true });
+}
+async function readDeployLockOwner(ownerFile) {
+    try {
+        const value = JSON.parse(await fs.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;
+}
+
+exports.DEPLOY_LOCKED_MESSAGE = DEPLOY_LOCKED_MESSAGE;
+exports.acquireDeployLock = acquireDeployLock;
+exports.withDeployLock = withDeployLock;

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

@@ -1,10 +1,10 @@
 'use strict';
 
-var index = require('./index-bZIxID9N.cjs');
-var context = require('./context-DQhjWa7X.cjs');
+var index = require('./index-CY67PpQk.cjs');
+var context = require('./context-BI3QMxw2.cjs');
 var node_crypto = require('node:crypto');
 var fs = require('node:fs');
-var runtimePermissionEnv = require('./runtime-permission-env-B9SqoP85.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-CDx5qO-T.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-6eLmb4Em.cjs');
-var version = require('./version-CwEOrhL1.cjs');
+var projectVite = require('./project-vite-Dm128JTE.cjs');
+var version = require('./version-D40WHkF9.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-KAhj5UTy.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-KAhj5UTy.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-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 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-EWleN3S5.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-DQdwzMhB.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;

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

package/dist/cli-chunks/games-yqu20laX.cjs

@@ -0,0 +1,140 @@
+'use strict';
+
+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');
+require('node:module');
+require('readline');
+require('os');
+require('tty');
+require('assert');
+require('events');
+require('stream');
+require('buffer');
+require('util');
+require('path');
+require('fs');
+require('constants');
+require('node:fs');
+require('node:zlib');
+
+const WINDOW_MS = 30 * 60 * 1000;
+const MAX_REQUESTS = 50;
+const INTERVAL_MS = 1000;
+/** 仅限制当前设备 CLI 的出站搜索，账号隔离并跨进程、跨项目持久保存。 */
+async function reserveGameSearchRequest(account, apiBaseUrl, options = {}) {
+    const cacheRoot = options.cacheRoot ?? index.envPaths('hb-sdk', { suffix: '' }).cache;
+    const scope = node_crypto.createHash('sha256').update(`${apiBaseUrl}\0${account}`).digest('hex');
+    let lock;
+    try {
+        lock = await deployLock.acquireDeployLock({ apiBaseUrl, miniProgramId: `game-search:${scope}`, version: 'rate-limit-v1' }, { cacheRoot });
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === deployLock.DEPLOY_LOCKED_MESSAGE) {
+            throw new Error('游戏搜索请求正在处理中，请稍后重试');
+        }
+        throw error;
+    }
+    const directory = path.join(cacheRoot, 'game-search-limits');
+    const file = path.join(directory, `${scope}.json`);
+    const temp = `${file}.${node_crypto.randomUUID()}.tmp`;
+    try {
+        const now = (options.now ?? Date.now)();
+        let timestamps = [];
+        try {
+            const raw = await fs.readFile(file, 'utf8');
+            let stored;
+            try {
+                stored = JSON.parse(raw);
+            }
+            catch (error) {
+                if (!(error instanceof SyntaxError))
+                    throw error;
+            }
+            if (Array.isArray(stored) && stored.length <= MAX_REQUESTS && stored.every((value) => Number.isSafeInteger(value) && value >= 0)) {
+                timestamps = stored.filter((value) => value > now - WINDOW_MS).sort((a, b) => a - b);
+            }
+            else {
+                // 在账号锁内清除损坏的辅助缓存，本次按新记录继续，避免永久阻断搜索。
+                await fs.rm(file, { force: true });
+            }
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+        const last = timestamps.at(-1);
+        const intervalWait = last === undefined ? 0 : last + INTERVAL_MS - now;
+        const windowWait = timestamps.length < MAX_REQUESTS ? 0 : timestamps[0] + WINDOW_MS - now;
+        const wait = Math.max(intervalWait, windowWait);
+        if (wait > 0) {
+            throw new Error(`游戏搜索过于频繁，请 ${Math.ceil(wait / 1000)} 秒后重试`);
+        }
+        timestamps.push(now);
+        await fs.mkdir(directory, { recursive: true, mode: 0o700 });
+        await fs.writeFile(temp, JSON.stringify(timestamps), { mode: 0o600, flag: 'wx' });
+        await fs.rename(temp, file);
+    }
+    finally {
+        await fs.rm(temp, { force: true }).finally(() => lock.release());
+    }
+}
+
+const GAME_SEARCH_API_PATH = '/bbs/app/topic/search_game';
+/** 查询平台游戏候选，不依赖项目绑定，也不写入本地配置或远端状态。 */
+async function runGameSearchCommand(query, options = {}, runtime = {}) {
+    const q = query.trim();
+    if (!q || Array.from(q).length > 100)
+        throw new Error('游戏搜索关键词须为 1–100 个字符');
+    const offset = parsePagination(options.offset ?? '0', 'offset', 0, 10_000);
+    const limit = parsePagination(options.limit ?? '10', 'limit', 1, 20);
+    const session = runtime.session ?? (await (runtime.requireAuthSession ?? index.requireHeyboxAuthSession)());
+    const context = index.createHeyboxOpenPlatformRequestContext(session, GAME_SEARCH_API_PATH);
+    await reserveGameSearchRequest(session.heyboxId, context.baseUrl, runtime.rateLimit);
+    const response = await (runtime.fetchImpl ?? fetch)(index.createHeyboxApiUrl(context.baseUrl, GAME_SEARCH_API_PATH, { ...context.platformParams, q, offset, limit: limit + 1 }), { headers: context.headers, redirect: 'error', signal: AbortSignal.timeout(15_000) });
+    const result = await index.readHeyboxApiEnvelope(response, { pathWithQuery: GAME_SEARCH_API_PATH, requireResult: true });
+    if (!Array.isArray(result?.games))
+        throw new Error('游戏搜索返回格式异常：缺少 games 数组');
+    const games = result.games.slice(0, limit).map(normalizeGame);
+    const output = {
+        games,
+        has_more: result.games.length > limit,
+        next_offset: offset + games.length,
+    };
+    const message = options.json
+        ? JSON.stringify(output, null, 2)
+        : [
+            ...(games.length ? games.map((game) => `${game.appid}\t${game.name}${game.name_en ? `（${game.name_en}）` : ''}`) : ['未找到匹配游戏，请尝试中文名或英文名。']),
+            '搜索结果为游戏候选，请核对具体游戏及平台；能否绑定以部署预检为准。',
+            ...(output.has_more ? [`更多结果：--offset ${output.next_offset} --limit ${limit}`] : []),
+        ].join('\n');
+    (runtime.write ?? ((text) => process.stdout.write(`${text}\n`)))(message);
+    return output;
+}
+function parsePagination(value, name, min, max) {
+    if (!/^(0|[1-9]\d*)$/.test(value))
+        throw new Error(`--${name} 必须为 ${min}–${max} 的整数`);
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed < min || parsed > max)
+        throw new Error(`--${name} 必须为 ${min}–${max} 的整数`);
+    return parsed;
+}
+function normalizeGame(value) {
+    if (!value || typeof value !== 'object')
+        throw new Error('游戏搜索返回格式异常');
+    const game = value;
+    const appid = typeof game.appid === 'number' || typeof game.appid === 'string' ? String(game.appid) : '';
+    if (!/^[1-9]\d*$/.test(appid) ||
+        !Number.isSafeInteger(Number(appid)) ||
+        Number(appid) > 2_147_483_647 ||
+        typeof game.name !== 'string' ||
+        !game.name.trim()) {
+        throw new Error('游戏搜索返回无效 appid 或名称');
+    }
+    const icon = typeof game.vertical_image === 'string' && game.vertical_image ? game.vertical_image : game.image;
+    return { appid, name: game.name, ...(typeof game.name_en === 'string' && game.name_en.trim() ? { name_en: game.name_en } : {}), ...(typeof icon === 'string' && icon ? { icon_url: icon } : {}) };
+}
+
+exports.runGameSearchCommand = runGameSearchCommand;

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

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

package/dist/cli-chunks/{index-bZIxID9N.cjs → index-CY67PpQk.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-CY67PpQk.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-CY67PpQk.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-CY67PpQk.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-CY67PpQk.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-CY67PpQk.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-C7nrP0tt.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.8';
 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-PJdMmFoB.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-PJdMmFoB.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-PJdMmFoB.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-BinntZJf.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-BK028Mlk.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-DeNzUY6g.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-BOfbKnN2.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-Bdy5Ehue.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-CZuy1lmn.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-yqu20laX.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-DQdwzMhB.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-CY67PpQk.cjs');
+var dev = require('./dev-DeNzUY6g.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-BI3QMxw2.cjs');
+require('./runtime-permission-env-CDx5qO-T.cjs');
+require('./version-D40WHkF9.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-Dm128JTE.cjs');
 
 var bufferUtil = {exports: {}};
 

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

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