@heybox/hb-sdk 0.5.0 → 0.5.2

package/README.md

@@ -185,10 +185,23 @@ import { navigation } from '@heybox/hb-sdk';
 
 await navigation.reload();
 await navigation.close();
+
+await navigation.openAppPage({
+  target: 'game_detail',
+  appId: 578080,
+  gameType: 'pc',
+});
+
+await navigation.openAppPage({
+  target: 'user_detail',
+  userId: '239040',
+});
 ```
 
 `navigation.close()` 请求宿主关闭当前小程序容器，`navigation.reload()` 请求宿主重载当前小程序页面/容器。调用后 JS 上下文可能被宿主销毁，不保证后续代码继续执行；这两个能力不接受 `reason`、`force`、`confirm` 或 `fallbackUrl` 等扩展参数。
 
+`navigation.openAppPage()` 请求宿主打开受 SDK 白名单约束的黑盒 App 页面。当前支持 `target: 'game_detail'`，必填 `appId` 与 `gameType`；`gameType` 支持 `pc`、`console`、`mobile`，可选 `page: 'game' | 'wiki'`、`hSrc`、`skuId`。也支持 `target: 'user_detail'`，必填 `userId`。
+
 ### 窗口信息
 
 ```ts

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

package/dist/cli-chunks/{dev-D4XRqzz1.cjs → dev-BYgFjQRn.cjs}

@@ -9,7 +9,7 @@ var node_url = require('node:url');
 var net = require('node:net');
 var node_http = require('node:http');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-kv8oOmFw.cjs');
+var index = require('./index-JgAMdKYi.cjs');
 require('node:process');
 require('node:buffer');
 require('node:util');

package/dist/cli-chunks/{doctor-CmHZYQ2I.cjs → doctor-BqbJqCW_.cjs}

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

package/dist/cli-chunks/{index-DXS0s9d7.cjs → index-DflbDKpY.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index$2 = require('./index-kv8oOmFw.cjs');
+var index$2 = require('./index-JgAMdKYi.cjs');
 var require$$0$2 = require('fs');
 var require$$2$1 = require('crypto');
 var require$$1$2 = require('path');
 var require$$0$3 = require('assert');
 var require$$4$2 = require('events');
 var require$$1$1 = require('util');
-var remote = require('./remote-BRktlraB.cjs');
+var remote = require('./remote-C8Sr29mG.cjs');
 var require$$0$5 = require('net');
 var require$$0$4 = require('url');
 var require$$2$2 = require('http');

package/dist/cli-chunks/{index-kv8oOmFw.cjs → index-JgAMdKYi.cjs}

@@ -234,19 +234,19 @@ function requireArgument () {
 
 var command = {};
 
-const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-kv8oOmFw.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-JgAMdKYi.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-kv8oOmFw.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-JgAMdKYi.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-kv8oOmFw.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-JgAMdKYi.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-kv8oOmFw.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-JgAMdKYi.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-kv8oOmFw.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-JgAMdKYi.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13094,7 +13094,7 @@ function readErrorMessage(error, options = {}) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.5.0';
+const BUILT_CLI_VERSION = '0.5.2';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13377,31 +13377,31 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-F9AEL3cF.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-BgPUbxW7.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-F9AEL3cF.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-BgPUbxW7.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-F9AEL3cF.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-BgPUbxW7.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-BiCyOEAv.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-Bh4kJDVt.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-D4XRqzz1.cjs'); });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-BYgFjQRn.cjs'); });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-CmHZYQ2I.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-BqbJqCW_.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-BRktlraB.cjs'); }).then(function (n) { return n.remote; });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-C8Sr29mG.cjs'); }).then(function (n) { return n.remote; });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{login-F9AEL3cF.cjs → login-BgPUbxW7.cjs}

@@ -3,9 +3,9 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var session = require('./session-DItg0094.cjs');
+var session = require('./session-DNEf3FBW.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-kv8oOmFw.cjs');
+var index = require('./index-JgAMdKYi.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{remote-BRktlraB.cjs → remote-C8Sr29mG.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var session = require('./session-DItg0094.cjs');
+var session = require('./session-DNEf3FBW.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 index = require('./index-kv8oOmFw.cjs');
+var index = require('./index-JgAMdKYi.cjs');
 
 var re = {exports: {}};
 
@@ -3113,7 +3113,7 @@ async function createDefaultCosClient(uploadToken) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-DXS0s9d7.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-DflbDKpY.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {
@@ -3596,7 +3596,10 @@ async function submitUserMiniprogramAudit(options, runtime) {
     }, runtime);
 }
 async function getVersionPreviewInfo(options, runtime) {
-    return remoteGet(USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH, options, runtime);
+    return remoteGet(USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH, {
+        mini_program_id: options.mini_program_id,
+        preview_version: options.version,
+    }, runtime);
 }
 async function withdrawUserMiniprogramVersion(options, runtime) {
     return remotePostForm(WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH, options, runtime);

package/dist/cli-chunks/{session-DItg0094.cjs → session-DNEf3FBW.cjs}

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

package/dist/cli.cjs

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

package/dist/devtools/mock-host/main.js

@@ -92,6 +92,8 @@ const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
 const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 /** 重载当前小程序容器能力方法名。 */
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
+/** 打开黑盒 App 页面能力方法名。 */
+const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
 /**
  * 小程序开放能力目录。
  *
@@ -246,6 +248,13 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'navigation.reload',
         risk: 'medium',
     },
+    {
+        method: NAVIGATION_OPEN_APP_PAGE_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_OPEN_APP_PAGE_METHOD,
+        permission: 'navigation.openAppPage',
+        risk: 'medium',
+    },
 ];
 
 var browser = {};
@@ -3438,6 +3447,105 @@ function stringifyMiniProgramRuntimeJsonData(data, options) {
     return value;
 }
 
+const GAME_DETAIL_GAME_TYPES = ['pc', 'console', 'mobile'];
+const GAME_DETAIL_PAGES = ['game', 'wiki'];
+function toOpenAppPagePlatformOptions(payload) {
+    const appPagePayload = readOpenAppPagePayload(payload);
+    switch (appPagePayload.target) {
+        case 'game_detail':
+            return {
+                target: appPagePayload.target,
+                protocol: createGameDetailOpenRouterPathProtocol(appPagePayload),
+            };
+        case 'user_detail':
+            return {
+                target: appPagePayload.target,
+                protocol: createUserDetailOpenRouterPathProtocol(appPagePayload),
+            };
+        default:
+            throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'navigation.openAppPage target 不支持');
+    }
+}
+function readOpenAppPagePayload(payload) {
+    if (!isMiniProgramRuntimeRecord(payload)) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'navigation.openAppPage options 必须是对象');
+    }
+    switch (payload.target) {
+        case 'game_detail':
+            return readOpenGameDetailAppPagePayload(payload);
+        case 'user_detail':
+            return readOpenUserDetailAppPagePayload(payload);
+        default:
+            throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', 'navigation.openAppPage target 不支持');
+    }
+}
+function readOpenGameDetailAppPagePayload(payload) {
+    const appId = readRequiredString(payload.appId, 'navigation.openAppPage appId 必须是非空字符串');
+    const gameType = readStringEnum(payload.gameType, GAME_DETAIL_GAME_TYPES, 'navigation.openAppPage gameType 必须是 pc、console 或 mobile');
+    const result = {
+        target: 'game_detail',
+        appId,
+        gameType,
+    };
+    if (payload.page !== undefined) {
+        result.page = readStringEnum(payload.page, GAME_DETAIL_PAGES, 'navigation.openAppPage page 必须是 game 或 wiki');
+    }
+    if (payload.hSrc !== undefined) {
+        result.hSrc = readRequiredString(payload.hSrc, 'navigation.openAppPage hSrc 必须是非空字符串');
+    }
+    if (payload.skuId !== undefined) {
+        result.skuId = readRequiredString(payload.skuId, 'navigation.openAppPage skuId 必须是非空字符串');
+    }
+    return result;
+}
+function readOpenUserDetailAppPagePayload(payload) {
+    return {
+        target: 'user_detail',
+        userId: readRequiredString(payload.userId, 'navigation.openAppPage userId 必须是非空字符串'),
+    };
+}
+function createGameDetailOpenRouterPathProtocol(payload) {
+    const params = {
+        app_id: payload.appId,
+        game_type: payload.gameType,
+    };
+    if (payload.page !== undefined) {
+        params.page = payload.page;
+    }
+    if (payload.hSrc !== undefined) {
+        params.h_src = payload.hSrc;
+    }
+    if (payload.skuId !== undefined) {
+        params.sku_id = payload.skuId;
+    }
+    return {
+        protocol_type: 'openRouterPath',
+        path: '/game/detail',
+        params,
+    };
+}
+function createUserDetailOpenRouterPathProtocol(payload) {
+    return {
+        protocol_type: 'openRouterPath',
+        path: '/user_home',
+        params: {
+            userid: payload.userId,
+        },
+    };
+}
+function readRequiredString(value, message) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', message);
+    }
+    return value.trim();
+}
+function readStringEnum(value, allowedValues, message) {
+    if (typeof value !== 'string' || !allowedValues.includes(value)) {
+        throw createMiniProgramRuntimeBridgeError('INVALID_PARAMS', message);
+    }
+    return value;
+}
+
 const NETWORK_REQUEST_ALLOWED_KEYS = new Set([
     'url',
     'method',
@@ -4581,6 +4689,7 @@ const MINI_PROGRAM_MOCK_RUNTIME_METHOD_HANDLERS = {
     [DEVICE_SET_CLIPBOARD_METHOD]: (runtime, payload) => runtime.setClipboard(payload),
     [NAVIGATION_CLOSE_METHOD]: (runtime, payload) => runtime.close(payload),
     [NAVIGATION_RELOAD_METHOD]: (runtime, payload) => runtime.reload(payload),
+    [NAVIGATION_OPEN_APP_PAGE_METHOD]: (runtime, payload) => runtime.openAppPage(payload),
 };
 function createBrowserMockRuntimePlatformAdapter(options) {
     return {
@@ -4687,6 +4796,9 @@ function createBrowserMockRuntimePlatformAdapter(options) {
             async reload() {
                 return undefined;
             },
+            async openAppPage() {
+                return undefined;
+            },
         },
         storage: {
             getStorage: options.getStorage,
@@ -4710,6 +4822,7 @@ class MiniProgramMockRuntime {
         this.records = [];
         this.toasts = [];
         this.vibrates = [];
+        this.openAppPages = [];
     }
     async runMethod(method, payload) {
         if (!isMiniProgramMockRuntimeMethod(method)) {
@@ -4726,6 +4839,7 @@ class MiniProgramMockRuntime {
             clipboardText: this.clipboardText,
             closed: this.closed,
             loading: { ...this.loading },
+            openAppPages: [...this.openAppPages],
             records: [...this.records],
             toasts: [...this.toasts],
             vibrates: [...this.vibrates],
@@ -4885,6 +4999,22 @@ class MiniProgramMockRuntime {
             reloadMockIframe();
         }
     }
+    async openAppPage(payload) {
+        const options = toOpenAppPagePlatformOptions(payload);
+        await this.adapter.navigation.openAppPage(options);
+        const action = {
+            options,
+            timestamp: Date.now(),
+        };
+        this.openAppPages.unshift(action);
+        this.openAppPages.splice(10);
+        this.record(NAVIGATION_OPEN_APP_PAGE_METHOD, {
+            payload,
+            protocol: options.protocol,
+        });
+        renderMockOpenAppPage(action);
+        await this.options.onOpenAppPage?.(action);
+    }
     record(method, payload) {
         this.records.unshift({
             method,
@@ -5259,6 +5389,37 @@ function renderMockLoading(state) {
         'pointer-events:none',
     ].join(';');
 }
+function renderMockOpenAppPage(action) {
+    const document = readDocument();
+    if (!document) {
+        return;
+    }
+    const element = findOrCreateMockElement(document, 'hb-sdk-mock-runtime-open-app-page');
+    const protocol = action.options.protocol;
+    element.innerHTML = [
+        '<strong>已模拟打开 App 页面</strong>',
+        `<span>${escapeMockHtml(protocol.path)}</span>`,
+        `<pre>${escapeMockHtml(JSON.stringify(protocol.params, null, 2))}</pre>`,
+    ].join('');
+    element.style.cssText = [
+        'position:fixed',
+        'right:16px',
+        'bottom:16px',
+        'z-index:2147483647',
+        'max-width:360px',
+        'padding:12px 14px',
+        'border-radius:8px',
+        'background:rgba(17,24,39,.94)',
+        'color:#fff',
+        'font:13px/1.45 -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif',
+        'box-shadow:0 12px 30px rgba(0,0,0,.24)',
+        'pointer-events:none',
+        'white-space:normal',
+    ].join(';');
+    setTimeout(() => {
+        element.remove();
+    }, 4000);
+}
 function reloadMockIframe() {
     const iframe = readMockIframe();
     if (!iframe) {
@@ -5312,6 +5473,14 @@ function readDocument() {
 function readWindow() {
     return typeof window === 'undefined' ? undefined : window;
 }
+function escapeMockHtml(value) {
+    return String(value)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#039;');
+}
 function isPlainRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
@@ -5453,7 +5622,7 @@ async function handleRequest(message) {
     try {
         const payload = await runtime.runMethod(message.method, message.payload);
         postResponse(message, payload);
-        pushLog(message.method, { payload: message.payload, result: payload });
+        pushLog(message.method, createRequestLogDetail(message.method, message.payload, payload));
     }
     catch (error) {
         const bridgeError = toMockBridgeError(error);
@@ -5462,6 +5631,20 @@ async function handleRequest(message) {
         pushLog(message.method, { payload: message.payload, error: bridgeError });
     }
 }
+function createRequestLogDetail(method, payload, result) {
+    if (method === NAVIGATION_OPEN_APP_PAGE_METHOD) {
+        const latestOpenAppPage = runtime.getState().openAppPages[0];
+        return {
+            payload,
+            result,
+            protocol: latestOpenAppPage?.options.protocol,
+        };
+    }
+    return {
+        payload,
+        result,
+    };
+}
 async function requestNetwork(config) {
     const response = await fetch(NETWORK_PROXY_PATH, {
         method: 'POST',

package/dist/index.cjs.js

@@ -497,6 +497,8 @@ const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
 const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 /** 重载当前小程序容器能力方法名。 */
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
+/** 打开黑盒 App 页面能力方法名。 */
+const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
 
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
@@ -825,6 +827,76 @@ function createDeviceModule(requester) {
     };
 }
 
+const GAME_DETAIL_GAME_TYPES = new Set(['pc', 'console', 'mobile']);
+const GAME_DETAIL_PAGES = new Set(['game', 'wiki']);
+/** 校验并规范化打开黑盒 App 页面参数。 */
+function normalizeOpenAppPageOptions(options) {
+    if (!isRecord(options)) {
+        throw createSDKError('INVALID_PARAMS', 'navigation.openAppPage options 必须是对象');
+    }
+    switch (options.target) {
+        case 'game_detail':
+            return normalizeGameDetailOptions(options);
+        case 'user_detail':
+            return normalizeUserDetailOptions(options);
+        default:
+            throw createSDKError('INVALID_PARAMS', 'navigation.openAppPage target 不支持');
+    }
+}
+function normalizeGameDetailOptions(options) {
+    const appId = readRequiredStringLike(options.appId, 'navigation.openAppPage appId 必须是非空字符串或数字');
+    if (!GAME_DETAIL_GAME_TYPES.has(options.gameType)) {
+        throw createSDKError('INVALID_PARAMS', 'navigation.openAppPage gameType 必须是 pc、console 或 mobile');
+    }
+    const payload = {
+        target: 'game_detail',
+        appId,
+        gameType: options.gameType,
+    };
+    if (options.page !== undefined) {
+        if (!GAME_DETAIL_PAGES.has(options.page)) {
+            throw createSDKError('INVALID_PARAMS', 'navigation.openAppPage page 必须是 game 或 wiki');
+        }
+        payload.page = options.page;
+    }
+    if (options.hSrc !== undefined) {
+        payload.hSrc = readRequiredStringLike(options.hSrc, 'navigation.openAppPage hSrc 必须是非空字符串');
+    }
+    if (options.skuId !== undefined) {
+        payload.skuId = readRequiredStringLike(options.skuId, 'navigation.openAppPage skuId 必须是非空字符串或数字');
+    }
+    return payload;
+}
+function normalizeUserDetailOptions(options) {
+    return {
+        target: 'user_detail',
+        userId: readRequiredString(options.userId, 'navigation.openAppPage userId 必须是非空字符串'),
+    };
+}
+function readRequiredString(value, message) {
+    if (typeof value !== 'string') {
+        throw createSDKError('INVALID_PARAMS', message);
+    }
+    const stringValue = value.trim();
+    if (!stringValue) {
+        throw createSDKError('INVALID_PARAMS', message);
+    }
+    return stringValue;
+}
+function readRequiredStringLike(value, message) {
+    if (typeof value !== 'string' && typeof value !== 'number') {
+        throw createSDKError('INVALID_PARAMS', message);
+    }
+    const stringValue = String(value).trim();
+    if (!stringValue) {
+        throw createSDKError('INVALID_PARAMS', message);
+    }
+    return stringValue;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
 /** 请求宿主关闭当前小程序容器。 */
 function close(requester) {
     return requester.request(NAVIGATION_CLOSE_METHOD);
@@ -833,11 +905,21 @@ function close(requester) {
 function reload(requester) {
     return requester.request(NAVIGATION_RELOAD_METHOD);
 }
+/** 请求宿主打开受 SDK 白名单约束的黑盒 App 页面。 */
+function openAppPage(requester, options) {
+    try {
+        return requester.request(NAVIGATION_OPEN_APP_PAGE_METHOD, normalizeOpenAppPageOptions(options));
+    }
+    catch (error) {
+        return Promise.reject(error);
+    }
+}
 /** 创建导航能力模块。 */
 function createNavigationModule(requester) {
     return {
         close: () => close(requester),
         reload: () => reload(requester),
+        openAppPage: options => openAppPage(requester, options),
     };
 }
 
@@ -1038,6 +1120,7 @@ const device = {
 const navigation = {
     close: () => getDefaultSDK().navigation.close(),
     reload: () => getDefaultSDK().navigation.reload(),
+    openAppPage: options => getDefaultSDK().navigation.openAppPage(options),
 };
 
 const hbSDK = {

package/dist/index.esm.js

@@ -493,6 +493,8 @@ const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
 const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 /** 重载当前小程序容器能力方法名。 */
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
+/** 打开黑盒 App 页面能力方法名。 */
+const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
 
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
@@ -821,6 +823,76 @@ function createDeviceModule(requester) {
     };
 }
 
+const GAME_DETAIL_GAME_TYPES = new Set(['pc', 'console', 'mobile']);
+const GAME_DETAIL_PAGES = new Set(['game', 'wiki']);
+/** 校验并规范化打开黑盒 App 页面参数。 */
+function normalizeOpenAppPageOptions(options) {
+    if (!isRecord(options)) {
+        throw createSDKError('INVALID_PARAMS', 'navigation.openAppPage options 必须是对象');
+    }
+    switch (options.target) {
+        case 'game_detail':
+            return normalizeGameDetailOptions(options);
+        case 'user_detail':
+            return normalizeUserDetailOptions(options);
+        default:
+            throw createSDKError('INVALID_PARAMS', 'navigation.openAppPage target 不支持');
+    }
+}
+function normalizeGameDetailOptions(options) {
+    const appId = readRequiredStringLike(options.appId, 'navigation.openAppPage appId 必须是非空字符串或数字');
+    if (!GAME_DETAIL_GAME_TYPES.has(options.gameType)) {
+        throw createSDKError('INVALID_PARAMS', 'navigation.openAppPage gameType 必须是 pc、console 或 mobile');
+    }
+    const payload = {
+        target: 'game_detail',
+        appId,
+        gameType: options.gameType,
+    };
+    if (options.page !== undefined) {
+        if (!GAME_DETAIL_PAGES.has(options.page)) {
+            throw createSDKError('INVALID_PARAMS', 'navigation.openAppPage page 必须是 game 或 wiki');
+        }
+        payload.page = options.page;
+    }
+    if (options.hSrc !== undefined) {
+        payload.hSrc = readRequiredStringLike(options.hSrc, 'navigation.openAppPage hSrc 必须是非空字符串');
+    }
+    if (options.skuId !== undefined) {
+        payload.skuId = readRequiredStringLike(options.skuId, 'navigation.openAppPage skuId 必须是非空字符串或数字');
+    }
+    return payload;
+}
+function normalizeUserDetailOptions(options) {
+    return {
+        target: 'user_detail',
+        userId: readRequiredString(options.userId, 'navigation.openAppPage userId 必须是非空字符串'),
+    };
+}
+function readRequiredString(value, message) {
+    if (typeof value !== 'string') {
+        throw createSDKError('INVALID_PARAMS', message);
+    }
+    const stringValue = value.trim();
+    if (!stringValue) {
+        throw createSDKError('INVALID_PARAMS', message);
+    }
+    return stringValue;
+}
+function readRequiredStringLike(value, message) {
+    if (typeof value !== 'string' && typeof value !== 'number') {
+        throw createSDKError('INVALID_PARAMS', message);
+    }
+    const stringValue = String(value).trim();
+    if (!stringValue) {
+        throw createSDKError('INVALID_PARAMS', message);
+    }
+    return stringValue;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
 /** 请求宿主关闭当前小程序容器。 */
 function close(requester) {
     return requester.request(NAVIGATION_CLOSE_METHOD);
@@ -829,11 +901,21 @@ function close(requester) {
 function reload(requester) {
     return requester.request(NAVIGATION_RELOAD_METHOD);
 }
+/** 请求宿主打开受 SDK 白名单约束的黑盒 App 页面。 */
+function openAppPage(requester, options) {
+    try {
+        return requester.request(NAVIGATION_OPEN_APP_PAGE_METHOD, normalizeOpenAppPageOptions(options));
+    }
+    catch (error) {
+        return Promise.reject(error);
+    }
+}
 /** 创建导航能力模块。 */
 function createNavigationModule(requester) {
     return {
         close: () => close(requester),
         reload: () => reload(requester),
+        openAppPage: options => openAppPage(requester, options),
     };
 }
 
@@ -1034,6 +1116,7 @@ const device = {
 const navigation = {
     close: () => getDefaultSDK().navigation.close(),
     reload: () => getDefaultSDK().navigation.reload(),
+    openAppPage: options => getDefaultSDK().navigation.openAppPage(options),
 };
 
 const hbSDK = {

package/dist/protocol.cjs.js

@@ -113,6 +113,8 @@ const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
 const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 /** 重载当前小程序容器能力方法名。 */
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
+/** 打开黑盒 App 页面能力方法名。 */
+const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
 /**
  * 小程序开放能力目录。
  *
@@ -267,6 +269,13 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'navigation.reload',
         risk: 'medium',
     },
+    {
+        method: NAVIGATION_OPEN_APP_PAGE_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_OPEN_APP_PAGE_METHOD,
+        permission: 'navigation.openAppPage',
+        risk: 'medium',
+    },
 ];
 
 exports.AUTH_LOGIN_METHOD = AUTH_LOGIN_METHOD;
@@ -277,6 +286,7 @@ exports.MINI_PROGRAM_MESSAGE_NAMESPACE = MINI_PROGRAM_MESSAGE_NAMESPACE;
 exports.MINI_PROGRAM_MESSAGE_VERSION = MINI_PROGRAM_MESSAGE_VERSION;
 exports.MINI_PROGRAM_PROTOCOL_CAPABILITIES = MINI_PROGRAM_PROTOCOL_CAPABILITIES;
 exports.NAVIGATION_CLOSE_METHOD = NAVIGATION_CLOSE_METHOD;
+exports.NAVIGATION_OPEN_APP_PAGE_METHOD = NAVIGATION_OPEN_APP_PAGE_METHOD;
 exports.NAVIGATION_RELOAD_METHOD = NAVIGATION_RELOAD_METHOD;
 exports.NETWORK_REQUEST_METHOD = NETWORK_REQUEST_METHOD;
 exports.SDK_HANDSHAKE_METHOD = SDK_HANDSHAKE_METHOD;

package/dist/protocol.esm.js

@@ -111,6 +111,8 @@ const DEVICE_SET_CLIPBOARD_METHOD = 'device.setClipboard';
 const NAVIGATION_CLOSE_METHOD = 'navigation.close';
 /** 重载当前小程序容器能力方法名。 */
 const NAVIGATION_RELOAD_METHOD = 'navigation.reload';
+/** 打开黑盒 App 页面能力方法名。 */
+const NAVIGATION_OPEN_APP_PAGE_METHOD = 'navigation.openAppPage';
 /**
  * 小程序开放能力目录。
  *
@@ -265,6 +267,13 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         permission: 'navigation.reload',
         risk: 'medium',
     },
+    {
+        method: NAVIGATION_OPEN_APP_PAGE_METHOD,
+        module: 'navigation',
+        capability: NAVIGATION_OPEN_APP_PAGE_METHOD,
+        permission: 'navigation.openAppPage',
+        risk: 'medium',
+    },
 ];
 
-export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_CURRENT_USER_DETAIL_METHOD, USER_GET_CURRENT_USER_PROFILE_METHOD, USER_GET_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };
+export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_CURRENT_USER_DETAIL_METHOD, USER_GET_CURRENT_USER_PROFILE_METHOD, USER_GET_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isMiniProgramBridgeMessage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "",
   "exports": {
     ".": {

package/skill/references/api-protocol.md

@@ -42,6 +42,7 @@ export {
   DEVICE_VIBRATE_METHOD,
   MINI_PROGRAM_PROTOCOL_CAPABILITIES,
   NAVIGATION_CLOSE_METHOD,
+  NAVIGATION_OPEN_APP_PAGE_METHOD,
   NAVIGATION_RELOAD_METHOD,
   NETWORK_REQUEST_METHOD,
   SHARE_SCREENSHOT_METHOD,
@@ -153,6 +154,10 @@ export type {
 export type {
   ClosePayload,
   CloseResult,
+  OpenAppPagePayload,
+  OpenAppPageResult,
+  OpenGameDetailAppPagePayload,
+  OpenUserDetailAppPagePayload,
   ReloadPayload,
   ReloadResult,
 } from './modules/navigation';

package/skill/references/api-root.md

@@ -19,7 +19,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.5.0`
+- Version at generation time: `0.5.2`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`
@@ -140,7 +140,17 @@ export type {
 export type {
   ClosePayload,
   CloseResult,
+  MiniProgramAppPageTarget,
+  MiniProgramGameDetailGameType,
+  MiniProgramGameDetailPage,
   MiniProgramNavigationModule,
+  OpenAppPageOptions,
+  OpenAppPagePayload,
+  OpenAppPageResult,
+  OpenGameDetailAppPagePayload,
+  OpenGameDetailAppPageOptions,
+  OpenUserDetailAppPagePayload,
+  OpenUserDetailAppPageOptions,
   ReloadPayload,
   ReloadResult,
 } from './modules/navigation';
@@ -466,10 +476,23 @@ import { navigation } from '@heybox/hb-sdk';
 
 await navigation.reload();
 await navigation.close();
+
+await navigation.openAppPage({
+  target: 'game_detail',
+  appId: 578080,
+  gameType: 'pc',
+});
+
+await navigation.openAppPage({
+  target: 'user_detail',
+  userId: '239040',
+});
 ```
 
 `navigation.close()` 请求宿主关闭当前小程序容器，`navigation.reload()` 请求宿主重载当前小程序页面/容器。调用后 JS 上下文可能被宿主销毁，不保证后续代码继续执行；这两个能力不接受 `reason`、`force`、`confirm` 或 `fallbackUrl` 等扩展参数。
 
+`navigation.openAppPage()` 请求宿主打开受 SDK 白名单约束的黑盒 App 页面。当前支持 `target: 'game_detail'`，必填 `appId` 与 `gameType`；`gameType` 支持 `pc`、`console`、`mobile`，可选 `page: 'game' | 'wiki'`、`hSrc`、`skuId`。也支持 `target: 'user_detail'`，必填 `userId`。
+
 ### 窗口信息
 
 ```ts

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.5.0+skill.a70b82c55c5b",
+  "skillVersion": "0.5.2+skill.6596fdf246b8",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.5.0",
-    "compatibility": "0.5.0"
+    "version": "0.5.2",
+    "compatibility": "0.5.2"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-a70b82c55c5bab095c92d138f75cec352f9dce0d2cd1cd3fb897a196fa63f09d"
+  "integrity": "sha256-6596fdf246b8e8d17436f5d3ada8fb82c4ddd2be935fe0c923e42b7cbc867437"
 }

package/types/index.d.ts

@@ -11,7 +11,7 @@ export type { GetStoragePayload, GetStorageResult, MiniProgramStorageModule, Set
 export type { MiniProgramNetworkHeaders, MiniProgramNetworkModule, MiniProgramNetworkParams, MiniProgramNetworkRequestConfig, MiniProgramNetworkRequestMethod, MiniProgramNetworkResponse, MiniProgramNetworkValidateStatus, NetworkRequestPayload, NetworkResponsePayload, } from './modules/network';
 export type { HideLoadingPayload, HideLoadingResult, MiniProgramToastStatus, MiniProgramUiModule, ShowLoadingPayload, ShowLoadingResult, ShowToastPayload, ShowToastResult, } from './modules/ui';
 export type { MiniProgramDeviceModule, MiniProgramVibrateIntensity, SetClipboardPayload, SetClipboardResult, VibratePayload, VibrateResult, } from './modules/device';
-export type { ClosePayload, CloseResult, MiniProgramNavigationModule, ReloadPayload, ReloadResult, } from './modules/navigation';
+export type { ClosePayload, CloseResult, MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, MiniProgramNavigationModule, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, ReloadPayload, ReloadResult, } from './modules/navigation';
 import { off, on, ready } from './core/singleton';
 declare const hbSDK: {
     ready: typeof ready;

package/types/modules/navigation/app-pages/index.d.ts

@@ -0,0 +1,4 @@
+import type { OpenAppPageOptions, OpenAppPagePayload } from './types';
+export type { MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, } from './types';
+/** 校验并规范化打开黑盒 App 页面参数。 */
+export declare function normalizeOpenAppPageOptions(options: OpenAppPageOptions): OpenAppPagePayload;

package/types/modules/navigation/app-pages/types.d.ts

@@ -0,0 +1,43 @@
+/** 小程序可请求打开的黑盒 App 页面目标。 */
+export type MiniProgramAppPageTarget = 'game_detail' | 'user_detail';
+/** 游戏详情支持的平台类型，与客户端 openGameDetail / RouterPath 文档保持一致。 */
+export type MiniProgramGameDetailGameType = 'pc' | 'console' | 'mobile';
+/** 游戏详情支持的首屏页面。 */
+export type MiniProgramGameDetailPage = 'game' | 'wiki';
+/** 打开游戏详情页的公共参数。 */
+export interface OpenGameDetailAppPageOptions {
+    /** 目标页面。 */
+    target: 'game_detail';
+    /** 游戏 app id。 */
+    appId: string | number;
+    /** 游戏平台类型。 */
+    gameType: MiniProgramGameDetailGameType;
+    /** 可选，打开的详情页子页面，默认由客户端决定。 */
+    page?: MiniProgramGameDetailPage;
+    /** 可选，追踪来源。 */
+    hSrc?: string;
+    /** 可选，弹出商品购买默认选中的 SKU。 */
+    skuId?: string | number;
+}
+/** 打开用户详情页的公共参数。 */
+export interface OpenUserDetailAppPageOptions {
+    /** 目标页面。 */
+    target: 'user_detail';
+    /** 用户 heybox_id。 */
+    userId: string;
+}
+/** 打开黑盒 App 页面公共参数。 */
+export type OpenAppPageOptions = OpenGameDetailAppPageOptions | OpenUserDetailAppPageOptions;
+/** `navigation.openAppPage` bridge payload。 */
+export type OpenGameDetailAppPagePayload = Omit<OpenGameDetailAppPageOptions, 'appId' | 'skuId'> & {
+    appId: string;
+    skuId?: string;
+};
+/** `navigation.openAppPage` 打开用户详情页的 bridge payload。 */
+export type OpenUserDetailAppPagePayload = Omit<OpenUserDetailAppPageOptions, 'userId'> & {
+    userId: string;
+};
+/** `navigation.openAppPage` bridge payload。 */
+export type OpenAppPagePayload = OpenGameDetailAppPagePayload | OpenUserDetailAppPagePayload;
+/** `navigation.openAppPage` 无稳定返回值。 */
+export type OpenAppPageResult = void;

package/types/modules/navigation/index.d.ts

@@ -1,5 +1,7 @@
 import type { MiniProgramRequester } from '../../core/client';
-export { NAVIGATION_CLOSE_METHOD, NAVIGATION_RELOAD_METHOD, } from '../../protocol/capabilities';
+import { type OpenAppPageOptions } from './app-pages';
+export { NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, } from '../../protocol/capabilities';
+export type { MiniProgramAppPageTarget, MiniProgramGameDetailGameType, MiniProgramGameDetailPage, OpenAppPageOptions, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenGameDetailAppPageOptions, OpenUserDetailAppPagePayload, OpenUserDetailAppPageOptions, } from './app-pages';
 /** `navigation.close` 不需要入参。 */
 export type ClosePayload = void;
 /** `navigation.close` 无稳定返回值。 */
@@ -15,10 +17,14 @@ export interface MiniProgramNavigationModule {
     close(): Promise<void>;
     /** 请求宿主重载当前小程序容器。 */
     reload(): Promise<void>;
+    /** 请求宿主打开受 SDK 白名单约束的黑盒 App 页面。 */
+    openAppPage(options: OpenAppPageOptions): Promise<void>;
 }
 /** 请求宿主关闭当前小程序容器。 */
 export declare function close(requester: MiniProgramRequester): Promise<void>;
 /** 请求宿主重载当前小程序容器。 */
 export declare function reload(requester: MiniProgramRequester): Promise<void>;
+/** 请求宿主打开受 SDK 白名单约束的黑盒 App 页面。 */
+export declare function openAppPage(requester: MiniProgramRequester, options: OpenAppPageOptions): Promise<void>;
 /** 创建导航能力模块。 */
 export declare function createNavigationModule(requester: MiniProgramRequester): MiniProgramNavigationModule;

package/types/protocol/capabilities.d.ts

@@ -1,6 +1,6 @@
 import type { LoginPayload, LoginResult } from '../modules/auth';
 import type { SetClipboardPayload, SetClipboardResult, VibratePayload, VibrateResult } from '../modules/device';
-import type { ClosePayload, CloseResult, ReloadPayload, ReloadResult } from '../modules/navigation';
+import type { ClosePayload, CloseResult, OpenAppPagePayload, OpenAppPageResult, ReloadPayload, ReloadResult } from '../modules/navigation';
 import type { NetworkRequestPayload, NetworkResponsePayload } from '../modules/network';
 import type { ScreenshotPayload, ScreenshotResult, ShowShareMenuPayload, ShowShareMenuResult } from '../modules/share';
 import type { GetStoragePayload, GetStorageResult, SetStoragePayload } from '../modules/storage';
@@ -94,6 +94,8 @@ export declare const DEVICE_SET_CLIPBOARD_METHOD: "device.setClipboard";
 export declare const NAVIGATION_CLOSE_METHOD: "navigation.close";
 /** 重载当前小程序容器能力方法名。 */
 export declare const NAVIGATION_RELOAD_METHOD: "navigation.reload";
+/** 打开黑盒 App 页面能力方法名。 */
+export declare const NAVIGATION_OPEN_APP_PAGE_METHOD: "navigation.openAppPage";
 /** 授权模块开放的方法名。 */
 export type MiniProgramAuthMethod = typeof AUTH_LOGIN_METHOD;
 /** 用户模块开放的方法名。 */
@@ -111,7 +113,7 @@ export type MiniProgramUiMethod = typeof UI_SHOW_TOAST_METHOD | typeof UI_SHOW_L
 /** Device 模块开放的方法名。 */
 export type MiniProgramDeviceMethod = typeof DEVICE_VIBRATE_METHOD | typeof DEVICE_SET_CLIPBOARD_METHOD;
 /** Navigation 模块开放的方法名。 */
-export type MiniProgramNavigationMethod = typeof NAVIGATION_CLOSE_METHOD | typeof NAVIGATION_RELOAD_METHOD;
+export type MiniProgramNavigationMethod = typeof NAVIGATION_CLOSE_METHOD | typeof NAVIGATION_RELOAD_METHOD | typeof NAVIGATION_OPEN_APP_PAGE_METHOD;
 /** 父容器开放给小程序调用的 bridge method。 */
 export type MiniProgramBridgeMethod = MiniProgramAuthMethod | MiniProgramUserMethod | MiniProgramShareMethod | MiniProgramViewportMethod | MiniProgramStorageMethod | MiniProgramNetworkMethod | MiniProgramUiMethod | MiniProgramDeviceMethod | MiniProgramNavigationMethod;
 /** 小程序开放能力所属模块。 */
@@ -269,6 +271,12 @@ export declare const MINI_PROGRAM_PROTOCOL_CAPABILITIES: readonly [{
     readonly capability: "navigation.reload";
     readonly permission: "navigation.reload";
     readonly risk: "medium";
+}, {
+    readonly method: "navigation.openAppPage";
+    readonly module: "navigation";
+    readonly capability: "navigation.openAppPage";
+    readonly permission: "navigation.openAppPage";
+    readonly risk: "medium";
 }];
 /** bridge method 到请求 payload 的映射。 */
 export interface MiniProgramCapabilityPayloadMap {
@@ -293,6 +301,7 @@ export interface MiniProgramCapabilityPayloadMap {
     [DEVICE_SET_CLIPBOARD_METHOD]: SetClipboardPayload;
     [NAVIGATION_CLOSE_METHOD]: ClosePayload;
     [NAVIGATION_RELOAD_METHOD]: ReloadPayload;
+    [NAVIGATION_OPEN_APP_PAGE_METHOD]: OpenAppPagePayload;
 }
 /** bridge method 到标准化响应 payload 的映射。 */
 export interface MiniProgramCapabilityResultMap {
@@ -317,6 +326,7 @@ export interface MiniProgramCapabilityResultMap {
     [DEVICE_SET_CLIPBOARD_METHOD]: SetClipboardResult;
     [NAVIGATION_CLOSE_METHOD]: CloseResult;
     [NAVIGATION_RELOAD_METHOD]: ReloadResult;
+    [NAVIGATION_OPEN_APP_PAGE_METHOD]: OpenAppPageResult;
 }
 /** 指定 bridge method 的请求 payload。 */
 export type MiniProgramCapabilityPayload<T extends MiniProgramBridgeMethod> = MiniProgramCapabilityPayloadMap[T];

package/types/protocol.d.ts

@@ -1,7 +1,7 @@
 export { MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, SDK_HANDSHAKE_METHOD, } from './protocol/constants';
 export { isMiniProgramBridgeMessage } from './protocol/guards';
 export type { MiniProgramBridgeError, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramEventHandler, MiniProgramEventName, MiniProgramEventPayloadMap, } from './protocol/types';
-export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_CURRENT_USER_DETAIL_METHOD, USER_GET_CURRENT_USER_PROFILE_METHOD, USER_GET_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, } from './protocol/capabilities';
+export { AUTH_LOGIN_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_REQUEST_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_CURRENT_USER_DETAIL_METHOD, USER_GET_CURRENT_USER_PROFILE_METHOD, USER_GET_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_INFO_METHOD, USER_GET_PLATFORM_ACCOUNT_OVERVIEW_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, } from './protocol/capabilities';
 export type { MiniProgramDeviceMethod, MiniProgramAuthMethod, MiniProgramBridgeMethod, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramNavigationMethod, MiniProgramNetworkMethod, MiniProgramShareMethod, MiniProgramStorageMethod, MiniProgramUiMethod, MiniProgramUserMethod, MiniProgramViewportMethod, } from './protocol/capabilities';
 export type { LoginPayload, LoginResult } from './modules/auth';
 export type { GetCurrentUserDetailPayload, GetCurrentUserDetailResult, GetCurrentUserProfilePayload, GetCurrentUserProfileResult, GetPlatformAccountInfoPayload, GetPlatformAccountInfoResult, GetPlatformAccountOverviewPayload, GetPlatformAccountOverviewResult, GetSteamGameListOptions, GetSteamGameListPayload, GetSteamGameListResult, GetUserInfoPayload, GetUserInfoResult, MiniProgramUserInfo, MiniProgramUserInfoResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, } from './modules/user';
@@ -13,4 +13,4 @@ export type { GetWindowInfoPayload, GetWindowInfoResult, MiniProgramNavigationBa
 export type { MiniProgramNetworkHeaders, MiniProgramNetworkParams, MiniProgramNetworkRequestConfig, MiniProgramNetworkRequestMethod, MiniProgramNetworkResponse, MiniProgramNetworkValidateStatus, NetworkRequestPayload, NetworkResponsePayload, } from './modules/network';
 export type { HideLoadingPayload, HideLoadingResult, MiniProgramToastStatus, ShowLoadingPayload, ShowLoadingResult, ShowToastPayload, ShowToastResult, } from './modules/ui';
 export type { MiniProgramVibrateIntensity, SetClipboardPayload, SetClipboardResult, VibratePayload, VibrateResult, } from './modules/device';
-export type { ClosePayload, CloseResult, ReloadPayload, ReloadResult, } from './modules/navigation';
+export type { ClosePayload, CloseResult, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenUserDetailAppPagePayload, ReloadPayload, ReloadResult, } from './modules/navigation';