@heybox/hb-sdk 0.9.2-alpha.5 → 0.9.2-alpha.6

package/dist/devtools/browser-dev-host/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="theme-color" content="#f4f5f7" />
     <title>小程序工坊调试台</title>
-    <script type="module" crossorigin src="/assets/index-QNpmomh6.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-CsRZ3HTE.js">
+    <script type="module" crossorigin src="/assets/index-Dn9OFySi.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-CXLBQXPW.js">
     <link rel="stylesheet" crossorigin href="/assets/index-7Cq8iNcD.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -413,6 +413,7 @@ const COMPANION_SESSION_EXIT_EVENT = 'companion.session.exit';
 const COMPANION_SESSION_OWNERSHIP_LOST_EVENT = 'companion.session.ownershipLost';
 
 const WORKSPACE_CARDS_REQUEST_REFRESH_METHOD = 'workspaceCards.requestRefresh';
+const AUTH_GET_ACCOUNT_STATE_METHOD = 'auth.getAccountState';
 const AUTH_LOGIN_METHOD = 'auth.login';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
@@ -7290,7 +7291,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.5';
+    : '0.9.2-alpha.6';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -7364,6 +7365,7 @@ class MiniProgramBridgeClient {
     rejectHandshake;
     handshakeTimer;
     handshakeRetryTimer;
+    accountEventVersion = 0;
     destroyed = false;
     runtimeUnavailable = false;
     runtimeUnavailableError;
@@ -7419,7 +7421,12 @@ class MiniProgramBridgeClient {
     }
     /** 调用父容器开放能力。 */
     async request(method, ...args) {
-        return this.performRequest(method, args[0], !HOST_MANAGED_TIMEOUT_METHODS.has(method));
+        const accountVersion = this.accountEventVersion;
+        const result = await this.performRequest(method, args[0], !HOST_MANAGED_TIMEOUT_METHODS.has(method));
+        if (method === 'auth.getAccountState' && accountVersion !== this.accountEventVersion) {
+            throw createSDKError('AUTHORIZATION_CONTEXT_CHANGED', '读取期间账号状态发生变化，请保留较新的事件状态');
+        }
+        return result;
     }
     /** 发起不使用固定总时长 timer 的长操作。 */
     async requestOperation(method, payload, options = {}) {
@@ -7696,6 +7703,8 @@ class MiniProgramBridgeClient {
         else if (eventName === 'show' && !this.runtimeUnavailable) {
             this.postLocationReport('resume');
         }
+        if (eventName === 'heybox_app_login_change')
+            this.accountEventVersion += 1;
         this.eventBus.emit(eventName, message.payload);
     }
     handleResponse(message) {
@@ -7870,6 +7879,14 @@ function login(requester, options) {
  */
 function createAuthModule(requester) {
     return {
+        async getAccountState() {
+            const state = await requester.request(AUTH_GET_ACCOUNT_STATE_METHOD);
+            if (state &&
+                ((state.isHeyboxAppLoggedIn === false && state.accountKey === null) ||
+                    (state.isHeyboxAppLoggedIn === true && typeof state.accountKey === 'string' && state.accountKey.trim().length > 0)))
+                return state;
+            throw new HbMiniProgramSDKError({ code: 'INVALID_RESPONSE', message: 'Host 未返回有效的账号比较状态' });
+        },
         login: (options) => login(requester, options),
     };
 }
@@ -11708,7 +11725,7 @@ function onHandshakeStateChange(handler) {
  * - `error`：
  *   [MiniProgramBridgeError](/reference/symbols/protocol/interfaces/MiniProgramBridgeError)，包含 `code`、
  *   `message` 与可选 `data`，不是 JavaScript `Error` 实例；
- * - `heybox_app_login_change`：`{ isHeyboxAppLoggedIn }`；
+ * - `heybox_app_login_change`：`{ isHeyboxAppLoggedIn, accountKey? }`（缺失 key 表示待确认）；
  * - `user_info_authorization_change`：
  *   [UserInfoAuthorization](/reference/symbols/root/interfaces/UserInfoAuthorization)，包含 `identity` 与
  *   `profile` 两项授权状态，支持 Steam 账号能力时还可能包含 `steam_account`；
@@ -11854,6 +11871,7 @@ function off(eventName, handler) {
 }
 /** 默认 SDK 实例的授权模块。 */
 const auth = {
+    getAccountState: () => getDefaultSDK().auth.getAccountState(),
     login: (options) => getDefaultSDK().auth.login(options),
 };
 /** 默认 SDK 实例的用户资料模块。 */

package/dist/index.esm.js

@@ -409,6 +409,7 @@ const COMPANION_SESSION_EXIT_EVENT = 'companion.session.exit';
 const COMPANION_SESSION_OWNERSHIP_LOST_EVENT = 'companion.session.ownershipLost';
 
 const WORKSPACE_CARDS_REQUEST_REFRESH_METHOD = 'workspaceCards.requestRefresh';
+const AUTH_GET_ACCOUNT_STATE_METHOD = 'auth.getAccountState';
 const AUTH_LOGIN_METHOD = 'auth.login';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
@@ -7286,7 +7287,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.5';
+    : '0.9.2-alpha.6';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -7360,6 +7361,7 @@ class MiniProgramBridgeClient {
     rejectHandshake;
     handshakeTimer;
     handshakeRetryTimer;
+    accountEventVersion = 0;
     destroyed = false;
     runtimeUnavailable = false;
     runtimeUnavailableError;
@@ -7415,7 +7417,12 @@ class MiniProgramBridgeClient {
     }
     /** 调用父容器开放能力。 */
     async request(method, ...args) {
-        return this.performRequest(method, args[0], !HOST_MANAGED_TIMEOUT_METHODS.has(method));
+        const accountVersion = this.accountEventVersion;
+        const result = await this.performRequest(method, args[0], !HOST_MANAGED_TIMEOUT_METHODS.has(method));
+        if (method === 'auth.getAccountState' && accountVersion !== this.accountEventVersion) {
+            throw createSDKError('AUTHORIZATION_CONTEXT_CHANGED', '读取期间账号状态发生变化，请保留较新的事件状态');
+        }
+        return result;
     }
     /** 发起不使用固定总时长 timer 的长操作。 */
     async requestOperation(method, payload, options = {}) {
@@ -7692,6 +7699,8 @@ class MiniProgramBridgeClient {
         else if (eventName === 'show' && !this.runtimeUnavailable) {
             this.postLocationReport('resume');
         }
+        if (eventName === 'heybox_app_login_change')
+            this.accountEventVersion += 1;
         this.eventBus.emit(eventName, message.payload);
     }
     handleResponse(message) {
@@ -7866,6 +7875,14 @@ function login(requester, options) {
  */
 function createAuthModule(requester) {
     return {
+        async getAccountState() {
+            const state = await requester.request(AUTH_GET_ACCOUNT_STATE_METHOD);
+            if (state &&
+                ((state.isHeyboxAppLoggedIn === false && state.accountKey === null) ||
+                    (state.isHeyboxAppLoggedIn === true && typeof state.accountKey === 'string' && state.accountKey.trim().length > 0)))
+                return state;
+            throw new HbMiniProgramSDKError({ code: 'INVALID_RESPONSE', message: 'Host 未返回有效的账号比较状态' });
+        },
         login: (options) => login(requester, options),
     };
 }
@@ -11704,7 +11721,7 @@ function onHandshakeStateChange(handler) {
  * - `error`：
  *   [MiniProgramBridgeError](/reference/symbols/protocol/interfaces/MiniProgramBridgeError)，包含 `code`、
  *   `message` 与可选 `data`，不是 JavaScript `Error` 实例；
- * - `heybox_app_login_change`：`{ isHeyboxAppLoggedIn }`；
+ * - `heybox_app_login_change`：`{ isHeyboxAppLoggedIn, accountKey? }`（缺失 key 表示待确认）；
  * - `user_info_authorization_change`：
  *   [UserInfoAuthorization](/reference/symbols/root/interfaces/UserInfoAuthorization)，包含 `identity` 与
  *   `profile` 两项授权状态，支持 Steam 账号能力时还可能包含 `steam_account`；
@@ -11850,6 +11867,7 @@ function off(eventName, handler) {
 }
 /** 默认 SDK 实例的授权模块。 */
 const auth = {
+    getAccountState: () => getDefaultSDK().auth.getAccountState(),
     login: (options) => getDefaultSDK().auth.login(options),
 };
 /** 默认 SDK 实例的用户资料模块。 */

package/dist/protocol.cjs.js

@@ -32,6 +32,7 @@ const SDK_CSP_VIOLATION_METHOD = 'sdk.csp.violation';
 const MINI_PROGRAM_OPERATION_PROGRESS_METHOD = 'operation.progress';
 
 const WORKSPACE_CARDS_REQUEST_REFRESH_METHOD = 'workspaceCards.requestRefresh';
+const AUTH_GET_ACCOUNT_STATE_METHOD = 'auth.getAccountState';
 const AUTH_LOGIN_METHOD = 'auth.login';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
@@ -111,6 +112,13 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         capability: WORKSPACE_CARDS_REQUEST_REFRESH_METHOD,
         requirement: { kind: 'all', permissions: ['workspaceCards'] }, risk: 'high',
     },
+    {
+        method: AUTH_GET_ACCOUNT_STATE_METHOD,
+        module: 'auth',
+        capability: AUTH_GET_ACCOUNT_STATE_METHOD,
+        requirement: { kind: 'none' },
+        risk: 'low',
+    },
     {
         method: AUTH_LOGIN_METHOD,
         module: 'auth',
@@ -7221,6 +7229,7 @@ object({
   regions: array(viewRegionSchema).max(VIEW_BUDGET.maxRegions)
 });
 
+exports.AUTH_GET_ACCOUNT_STATE_METHOD = AUTH_GET_ACCOUNT_STATE_METHOD;
 exports.AUTH_LOGIN_METHOD = AUTH_LOGIN_METHOD;
 exports.CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD = CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD;
 exports.CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD = CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD;

package/dist/protocol.esm.js

@@ -30,6 +30,7 @@ const SDK_CSP_VIOLATION_METHOD = 'sdk.csp.violation';
 const MINI_PROGRAM_OPERATION_PROGRESS_METHOD = 'operation.progress';
 
 const WORKSPACE_CARDS_REQUEST_REFRESH_METHOD = 'workspaceCards.requestRefresh';
+const AUTH_GET_ACCOUNT_STATE_METHOD = 'auth.getAccountState';
 const AUTH_LOGIN_METHOD = 'auth.login';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
@@ -109,6 +110,13 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
         capability: WORKSPACE_CARDS_REQUEST_REFRESH_METHOD,
         requirement: { kind: 'all', permissions: ['workspaceCards'] }, risk: 'high',
     },
+    {
+        method: AUTH_GET_ACCOUNT_STATE_METHOD,
+        module: 'auth',
+        capability: AUTH_GET_ACCOUNT_STATE_METHOD,
+        requirement: { kind: 'none' },
+        risk: 'low',
+    },
     {
         method: AUTH_LOGIN_METHOD,
         module: 'auth',
@@ -7219,4 +7227,4 @@ object({
   regions: array(viewRegionSchema).max(VIEW_BUDGET.maxRegions)
 });
 
-export { AUTH_LOGIN_METHOD, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, CLOUD_STORAGE_GET_KEYS_METHOD, CLOUD_STORAGE_GET_STORAGE_METHOD, CLOUD_STORAGE_REMOVE_ITEM_METHOD, CLOUD_STORAGE_SET_STORAGE_METHOD, DEVICE_EXECUTE_PROTOCOL_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_DOWNLOAD_METHOD, NETWORK_REQUEST_METHOD, NETWORK_UPLOAD_METHOD, RUNTIME_LOCATION_PROBE_METHOD, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_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_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions };
+export { AUTH_GET_ACCOUNT_STATE_METHOD, AUTH_LOGIN_METHOD, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, CLOUD_STORAGE_GET_KEYS_METHOD, CLOUD_STORAGE_GET_STORAGE_METHOD, CLOUD_STORAGE_REMOVE_ITEM_METHOD, CLOUD_STORAGE_SET_STORAGE_METHOD, DEVICE_EXECUTE_PROTOCOL_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_DOWNLOAD_METHOD, NETWORK_REQUEST_METHOD, NETWORK_UPLOAD_METHOD, RUNTIME_LOCATION_PROBE_METHOD, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_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_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_REVOKE_AUTHORIZATION_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions };

package/dist/vite.cjs.js

@@ -10281,7 +10281,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.5';
+    : '0.9.2-alpha.6';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/dist/vite.esm.js

@@ -10278,7 +10278,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.2-alpha.5';
+    : '0.9.2-alpha.6';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.2-alpha.5",
+  "version": "0.9.2-alpha.6",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -76,7 +76,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.9.2-alpha.5"
+    "@heybox/hb-sdk-protocol": "0.9.2-alpha.6"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -128,10 +128,10 @@
     "vitest": "^3.2.4",
     "@ai-desktop/view-contract": "file:../hb-sdk-protocol/vendor/view-contract-2.2.2-6ac49bbf6410.tgz",
     "rollup-plugin-dts": "6.4.0",
-    "@heybox/hb-sdk-runtime": "~0.9.2-alpha.5",
+    "@heybox-domain/heybox-theme": "~0.1.0",
     "@heybox-domain/heybox-vue3-ui": "~0.1.0",
+    "@heybox/hb-sdk-runtime": "~0.9.2-alpha.6",
     "@heybox/hb-api": "~1.28.14",
-    "@heybox-domain/heybox-theme": "~0.1.0",
     "@heybox/runtime": "~0.2.1",
     "@heybox/runtime-policy": "~0.2.1",
     "@heybox/runtime-transport-fetch": "~0.2.1"

package/skill/skill.json

@@ -1,15 +1,15 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.9.2-alpha.5+skill.c3a240ca503a",
+  "skillVersion": "0.9.2-alpha.6+skill.c3a240ca503a",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.2-alpha.5",
-    "compatibility": "0.9.2-alpha.5"
+    "version": "0.9.2-alpha.6",
+    "compatibility": "0.9.2-alpha.6"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.2-alpha.5",
+    "version": "0.9.2-alpha.6",
     "path": "skill"
   },
   "integrity": "sha256-c3a240ca503a1e5f3b15033e091f1fa79a8b70585aa0d8d8fa0b332daec60ac5"

package/types/index.d.ts

@@ -1,5 +1,5 @@
-import { MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramBridgeError, MiniProgramRuntimeMode, MiniProgramOperatingSystemName, LoginScope as LoginScope$1, MiniProgramUserInfoResult, SetDisplayPayload, SetDisplayResult, WorkspaceCardsRefreshOptions, WorkspaceCardLaunchContext, CompanionExit, CompanionNotificationCategory, CompanionPrepareProgress, CompanionTarget, CompanionCapability, CompanionInfo, CompanionPreparationStatus, ExecuteProtocolInput } from '@heybox/hb-sdk-protocol';
-export { AuthorizedUserInfo, CompanionCapability, CompanionExit, CompanionInfo, CompanionNotificationCategory, CompanionPreparationStatus, CompanionPrepareProgress, CompanionTarget, ExecuteProtocolInput, ExecuteProtocolObject, ExecuteProtocolResult, MiniProgramDisplayState, MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramOperatingSystemName, MiniProgramOrientationMode, MiniProgramRuntimeMode, MiniProgramUserInfoResult, SetDisplayPayload, SetDisplayResult, USER_INFO_AUTHORIZATION_SCOPES, UserInfoAuthorization, UserInfoAuthorizationScope, UserInfoAuthorizationStatus, WorkspaceCardLaunchContext, WorkspaceCardsRefreshOptions } from '@heybox/hb-sdk-protocol';
+import { MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramBridgeError, MiniProgramRuntimeMode, MiniProgramOperatingSystemName, LoginScope as LoginScope$1, AccountState, MiniProgramUserInfoResult, SetDisplayPayload, SetDisplayResult, WorkspaceCardsRefreshOptions, WorkspaceCardLaunchContext, CompanionExit, CompanionNotificationCategory, CompanionPrepareProgress, CompanionTarget, CompanionCapability, CompanionInfo, CompanionPreparationStatus, ExecuteProtocolInput } from '@heybox/hb-sdk-protocol';
+export { AccountState, AuthorizedUserInfo, CompanionCapability, CompanionExit, CompanionInfo, CompanionNotificationCategory, CompanionPreparationStatus, CompanionPrepareProgress, CompanionTarget, ExecuteProtocolInput, ExecuteProtocolObject, ExecuteProtocolResult, MiniProgramDisplayState, MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramOperatingSystemName, MiniProgramOrientationMode, MiniProgramRuntimeMode, MiniProgramUserInfoResult, SetDisplayPayload, SetDisplayResult, USER_INFO_AUTHORIZATION_SCOPES, UserInfoAuthorization, UserInfoAuthorizationScope, UserInfoAuthorizationStatus, WorkspaceCardLaunchContext, WorkspaceCardsRefreshOptions } from '@heybox/hb-sdk-protocol';
 
 /**
  * 小程序生命周期或业务事件监听函数。
@@ -2454,6 +2454,8 @@ type LoginPayload = LoginOptions | undefined;
  * @see [服务端换票流程](https://docs.xiaoheihe.cn/hb_sdk/guide/auth#后端-openapi)
  */
 interface LoginResult {
+    /** 与 code 对应的本地账号标识。旧 Host 可能缺失；它不是用户 ID 或服务端认证凭据。 */
+    accountKey?: string;
     /**
      * 一次性短期授权码。
      *
@@ -2483,13 +2485,38 @@ interface LoginResult {
 
 /** 外部小程序可调用的授权模块。 */
 interface MiniProgramAuthModule {
+    /**
+     * 静默读取当前 APP 账号的比较标识，不登录、不申请授权，不要求新增后端接口。
+     *
+     * @remarks
+     * 无需 Manifest 权限或用户手势，独立于 user.getInfo/auth.login 的模式限制。
+     * Mobile Host 会复用已有原生登录态验证刷新当前账号；离线或验证失败时返回错误并保持待确认。
+     * 启动和 show 时与业务 token 绑定的 accountKey 比较；不匹配或未登录时停止使用旧会话。
+     * 读取失败表示待确认，不能当作未登录或账号相同。accountKey 只在当前安装和小程序内比较，
+     * 清理 Host 存储后允许变化；不校验业务 token 或用户授权，也不能作为服务端登录凭据。
+     * 旧 Host 不支持时保留原错误；查询期间收到账号事件时抛 AUTHORIZATION_CONTEXT_CHANGED，
+     * 调用方应保留较新的事件状态并按需重新读取。
+     *
+     * @since 0.9.2-alpha.6
+     * @hbPlatform android
+     * @hbPlatform ios
+     * @hbPlatform ohos
+     * @hbPlatform windows
+     * @hbPlatform macos
+     * @hbClient android none
+     * @hbClient ios none
+     * @hbClient ohos none
+     * @hbClient windows none
+     * @hbClient macos none
+     */
+    getAccountState(): Promise<AccountState>;
     /**
      * 为当前小程序获取一次性短期授权码，由开发者服务端建立用户会话。
      *
      * @param options - 可选的授权配置。不传、传 `{}` 或 `scopes: undefined` 时只申请隐式
      * `identity`；需要昵称和头像时传 `{ scopes: ['profile'] }`。
-     * @returns Promise 成功时返回 {@link LoginResult}。它只包含一次性 code、code 有效期和
-     * 实际授权 scope，不包含用户资料、`app_user_id`、access token、cookie 或应用密钥。
+     * @returns Promise 成功时返回 {@link LoginResult}，包含 code、有效期、实际授权 scope 和
+     * 新 Host 提供的本地 accountKey；不包含用户资料、`app_user_id`、token、cookie 或应用密钥。
      * @throws {@link HbMiniProgramSDKError} `INVALID_PARAMS`：`scopes` 不是数组、包含未知值或
      * 重复值，或当前 Host 尚未启用请求的 `steam_account` scope。
      * @throws {@link HbMiniProgramSDKError} `PERMISSION_NOT_IN_SNAPSHOT` 或 `PERMISSION_DENIED`：
@@ -7523,7 +7550,7 @@ declare function onHandshakeStateChange(handler: MiniProgramSDKHandshakeStateHan
  * - `error`：
  *   [MiniProgramBridgeError](/reference/symbols/protocol/interfaces/MiniProgramBridgeError)，包含 `code`、
  *   `message` 与可选 `data`，不是 JavaScript `Error` 实例；
- * - `heybox_app_login_change`：`{ isHeyboxAppLoggedIn }`；
+ * - `heybox_app_login_change`：`{ isHeyboxAppLoggedIn, accountKey? }`（缺失 key 表示待确认）；
  * - `user_info_authorization_change`：
  *   [UserInfoAuthorization](/reference/symbols/root/interfaces/UserInfoAuthorization)，包含 `identity` 与
  *   `profile` 两项授权状态，支持 Steam 账号能力时还可能包含 `steam_account`；

package/types/protocol.d.ts

@@ -1,5 +1,5 @@
 import { MiniProgramEventName, MiniProgramEventPayloadMap, LoginScope as LoginScope$1 } from '@heybox/hb-sdk-protocol';
-export { AUTH_LOGIN_METHOD, AuthorizedUserInfo, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, CLOUD_STORAGE_GET_KEYS_METHOD, CLOUD_STORAGE_GET_STORAGE_METHOD, CLOUD_STORAGE_REMOVE_ITEM_METHOD, CLOUD_STORAGE_SET_STORAGE_METHOD, ClosePayload, CloseResult, CopyLinkPayload, CopyLinkResult, DEVICE_EXECUTE_PROTOCOL_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, DirectoryCreatePayload, DirectoryCreateResult, DirectoryExistsPayload, DirectoryExistsResult, DirectoryListPayload, DirectoryListResult, DirectoryRemovePayload, DirectoryRemoveResult, DownloadProgressPayload, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, FileCreatePayload, FileCreateResult, FileExistsPayload, FileExistsResult, FileReadBytesPayload, FileReadBytesResult, FileReadTextPayload, FileReadTextResult, FileRemovePayload, FileRemoveResult, FileStatPayload, FileStatResult, FileWriteBytesPayload, FileWriteBytesResult, FileWriteTextPayload, FileWriteTextResult, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, GetSteamGameListPayload, GetSteamGameListResult, GetStoragePayload, GetStorageResult, GetUserInfoPayload, GetUserInfoResult, GetWindowInfoPayload, GetWindowInfoResult, HideLoadingPayload, HideLoadingResult, LeaderboardEntry, LeaderboardOrder, LoginPayload, LoginResult, LoginScope, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, MiniProgramAuthMethod, MiniProgramBridgeCancelMessage, MiniProgramBridgeError, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramBridgeMethod, MiniProgramBridgeProgressMessage, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramCloudMethod, MiniProgramDeviceMethod, MiniProgramDirectDirectoryRef, MiniProgramDirectFileRef, MiniProgramDirectoryDescriptor, MiniProgramDirectoryMethod, MiniProgramDirectoryRef, MiniProgramDisplayState, MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramFileDescriptor, MiniProgramFileMethod, MiniProgramFileMode, MiniProgramFileRef, MiniProgramFileStat, MiniProgramFileSystemEntityDescriptor, MiniProgramFileSystemEntityRef, MiniProgramFilesMethod, MiniProgramNavigationBarForegroundStyle, MiniProgramNavigationMethod, MiniProgramNetworkHeaders, MiniProgramNetworkMethod, MiniProgramNetworkParams, MiniProgramNetworkRequestMethod, MiniProgramOperatingSystemName, MiniProgramOrientationMode, MiniProgramPathRootRef, MiniProgramRuntimeEnvironmentInfo, MiniProgramRuntimeMode, MiniProgramRuntimePermissionEntry, MiniProgramRuntimePermissionStatus, MiniProgramRuntimePermissionsSnapshot, MiniProgramSafeArea, MiniProgramSandboxRootRef, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareMethod, MiniProgramSharePostOptions, MiniProgramStorageMethod, MiniProgramToastStatus, MiniProgramUiMethod, MiniProgramUserInfoResult, MiniProgramUserMethod, MiniProgramVibrateIntensity, MiniProgramViewportMethod, MiniProgramWindowInfoResult, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_DOWNLOAD_METHOD, NETWORK_REQUEST_METHOD, NETWORK_UPLOAD_METHOD, NetworkDownloadPayload, NetworkDownloadResult, NetworkRequestPayload, NetworkResponsePayload, NetworkUploadPayload, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenMiniProgramAppPagePayload, OpenPostDetailAppPagePayload, OpenUserDetailAppPagePayload, ParsedMiniProgramRuntimePermissions, PickDirectoryPayload, PickDirectoryResult, PickFilesPayload, PickFilesResult, RUNTIME_LOCATION_PROBE_METHOD, ReloadPayload, ReloadResult, RevokeAuthorizationPayload, RevokeAuthorizationResult, RuntimeLocationProbePayload, SDKCSPBlockedResourceType, SDKCSPViolationPayload, SDKHandshakePayload, SDKHandshakeResult, SDKLocationReportPayload, SDKLocationReportTrigger, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, SaveFilePayload, SaveFileResult, ScreenshotPayload, ScreenshotResult, SetClipboardPayload, SetClipboardResult, SetDisplayPayload, SetDisplayResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, SetStoragePayload, ShowLoadingPayload, ShowLoadingResult, ShowShareMenuPayload, ShowShareMenuResult, ShowToastPayload, ShowToastResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_REVOKE_AUTHORIZATION_METHOD, UploadProgressPayload, UserInfoAuthorization, UserInfoAuthorizationScope, UserInfoAuthorizationStatus, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, VibratePayload, VibrateResult, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions } from '@heybox/hb-sdk-protocol';
+export { AUTH_GET_ACCOUNT_STATE_METHOD, AUTH_LOGIN_METHOD, AccountState, AuthorizedUserInfo, CLOUD_LEADERBOARD_DELETE_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_CURRENT_USER_ENTRY_METHOD, CLOUD_LEADERBOARD_GET_INFO_METHOD, CLOUD_LEADERBOARD_GET_LIST_METHOD, CLOUD_LEADERBOARD_SUBMIT_METHOD, CLOUD_STORAGE_GET_KEYS_METHOD, CLOUD_STORAGE_GET_STORAGE_METHOD, CLOUD_STORAGE_REMOVE_ITEM_METHOD, CLOUD_STORAGE_SET_STORAGE_METHOD, ClosePayload, CloseResult, CopyLinkPayload, CopyLinkResult, DEVICE_EXECUTE_PROTOCOL_METHOD, DEVICE_SET_CLIPBOARD_METHOD, DEVICE_VIBRATE_METHOD, DIRECTORY_CREATE_METHOD, DIRECTORY_EXISTS_METHOD, DIRECTORY_LIST_METHOD, DIRECTORY_REMOVE_METHOD, DeleteCurrentUserLeaderboardEntryPayload, DeleteCurrentUserLeaderboardEntryResult, DirectoryCreatePayload, DirectoryCreateResult, DirectoryExistsPayload, DirectoryExistsResult, DirectoryListPayload, DirectoryListResult, DirectoryRemovePayload, DirectoryRemoveResult, DownloadProgressPayload, FILES_PICK_DIRECTORY_METHOD, FILES_PICK_FILES_METHOD, FILES_SAVE_FILE_METHOD, FILE_CREATE_METHOD, FILE_EXISTS_METHOD, FILE_READ_BYTES_METHOD, FILE_READ_TEXT_METHOD, FILE_REMOVE_METHOD, FILE_STAT_METHOD, FILE_WRITE_BYTES_METHOD, FILE_WRITE_TEXT_METHOD, FileCreatePayload, FileCreateResult, FileExistsPayload, FileExistsResult, FileReadBytesPayload, FileReadBytesResult, FileReadTextPayload, FileReadTextResult, FileRemovePayload, FileRemoveResult, FileStatPayload, FileStatResult, FileWriteBytesPayload, FileWriteBytesResult, FileWriteTextPayload, FileWriteTextResult, GetAccountStatePayload, GetCurrentUserLeaderboardEntryPayload, GetCurrentUserLeaderboardEntryResult, GetLeaderboardInfoPayload, GetLeaderboardInfoResult, GetLeaderboardListPayload, GetLeaderboardListResult, GetSteamGameListPayload, GetSteamGameListResult, GetStoragePayload, GetStorageResult, GetUserInfoPayload, GetUserInfoResult, GetWindowInfoPayload, GetWindowInfoResult, HideLoadingPayload, HideLoadingResult, LeaderboardEntry, LeaderboardOrder, LoginPayload, LoginResult, LoginScope, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_OPERATION_PROGRESS_METHOD, MINI_PROGRAM_PROTOCOL_CAPABILITIES, MiniProgramAuthMethod, MiniProgramBridgeCancelMessage, MiniProgramBridgeError, MiniProgramBridgeMessage, MiniProgramBridgeMessageType, MiniProgramBridgeMethod, MiniProgramBridgeProgressMessage, MiniProgramCapabilityDefinition, MiniProgramCapabilityModule, MiniProgramCapabilityPayload, MiniProgramCapabilityPayloadMap, MiniProgramCapabilityResult, MiniProgramCapabilityResultMap, MiniProgramCapabilityRisk, MiniProgramCloudMethod, MiniProgramDeviceMethod, MiniProgramDirectDirectoryRef, MiniProgramDirectFileRef, MiniProgramDirectoryDescriptor, MiniProgramDirectoryMethod, MiniProgramDirectoryRef, MiniProgramDisplayState, MiniProgramEventName, MiniProgramEventPayloadMap, MiniProgramFileDescriptor, MiniProgramFileMethod, MiniProgramFileMode, MiniProgramFileRef, MiniProgramFileStat, MiniProgramFileSystemEntityDescriptor, MiniProgramFileSystemEntityRef, MiniProgramFilesMethod, MiniProgramNavigationBarForegroundStyle, MiniProgramNavigationMethod, MiniProgramNetworkHeaders, MiniProgramNetworkMethod, MiniProgramNetworkParams, MiniProgramNetworkRequestMethod, MiniProgramOperatingSystemName, MiniProgramOrientationMode, MiniProgramPathRootRef, MiniProgramRuntimeEnvironmentInfo, MiniProgramRuntimeMode, MiniProgramRuntimePermissionEntry, MiniProgramRuntimePermissionStatus, MiniProgramRuntimePermissionsSnapshot, MiniProgramSafeArea, MiniProgramSandboxRootRef, MiniProgramScreenshotRect, MiniProgramShareChannel, MiniProgramShareMethod, MiniProgramSharePostOptions, MiniProgramStorageMethod, MiniProgramToastStatus, MiniProgramUiMethod, MiniProgramUserInfoResult, MiniProgramUserMethod, MiniProgramVibrateIntensity, MiniProgramViewportMethod, MiniProgramWindowInfoResult, NAVIGATION_CLOSE_METHOD, NAVIGATION_OPEN_APP_PAGE_METHOD, NAVIGATION_RELOAD_METHOD, NETWORK_DOWNLOAD_METHOD, NETWORK_REQUEST_METHOD, NETWORK_UPLOAD_METHOD, NetworkDownloadPayload, NetworkDownloadResult, NetworkRequestPayload, NetworkResponsePayload, NetworkUploadPayload, OpenAppPagePayload, OpenAppPageResult, OpenGameDetailAppPagePayload, OpenMiniProgramAppPagePayload, OpenPostDetailAppPagePayload, OpenUserDetailAppPagePayload, ParsedMiniProgramRuntimePermissions, PickDirectoryPayload, PickDirectoryResult, PickFilesPayload, PickFilesResult, RUNTIME_LOCATION_PROBE_METHOD, ReloadPayload, ReloadResult, RevokeAuthorizationPayload, RevokeAuthorizationResult, RuntimeLocationProbePayload, SDKCSPBlockedResourceType, SDKCSPViolationPayload, SDKHandshakePayload, SDKHandshakeResult, SDKLocationReportPayload, SDKLocationReportTrigger, SDK_CSP_VIOLATION_METHOD, SDK_HANDSHAKE_METHOD, SDK_LOCATION_REPORT_METHOD, SHARE_COPY_LINK_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, SaveFilePayload, SaveFileResult, ScreenshotPayload, ScreenshotResult, SetClipboardPayload, SetClipboardResult, SetDisplayPayload, SetDisplayResult, SetNavigationBarStylePayload, SetNavigationBarStyleResult, SetStoragePayload, ShowLoadingPayload, ShowLoadingResult, ShowShareMenuPayload, ShowShareMenuResult, ShowToastPayload, ShowToastResult, SteamGameListData, SteamGameListItem, SteamGameListSort, SteamGamePrice, SubmitLeaderboardEntryPayload, SubmitLeaderboardEntryResult, UI_HIDE_LOADING_METHOD, UI_SHOW_LOADING_METHOD, UI_SHOW_TOAST_METHOD, USER_GET_INFO_METHOD, USER_GET_STEAM_GAME_LIST_METHOD, USER_INFO_AUTHORIZATION_SCOPES, USER_REVOKE_AUTHORIZATION_METHOD, UploadProgressPayload, UserInfoAuthorization, UserInfoAuthorizationScope, UserInfoAuthorizationStatus, VIEWPORT_GET_WINDOW_INFO_METHOD, VIEWPORT_SET_DISPLAY_METHOD, VIEWPORT_SET_NAVIGATION_BAR_STYLE_METHOD, VibratePayload, VibrateResult, isManagedMiniProgramRuntimePermissionKey, isMiniProgramBridgeMessage, isMiniProgramByteArray, isMiniProgramDirectoryDescriptor, isMiniProgramDirectoryRef, isMiniProgramDownloadProgressPayload, isMiniProgramFileDescriptor, isMiniProgramFileRef, isMiniProgramFileStat, isMiniProgramFileSystemEntityDescriptor, isMiniProgramPathRootRef, isMiniProgramRelativePath, parseMiniProgramRuntimePermissions } from '@heybox/hb-sdk-protocol';
 
 /**
  * 小程序生命周期或业务事件监听函数。