@heybox/hb-sdk 0.9.4-alpha.5 → 0.9.4

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-DiXCkImS.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-TmPyZOfN.js">
+    <script type="module" crossorigin src="/assets/index-zZH5iNv_.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-BElRBLGR.js">
     <link rel="stylesheet" crossorigin href="/assets/index-h-fYisyX.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -415,6 +415,10 @@ 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 GAME_SAVES_LIST_METHOD = 'gameSaves.list';
+const GAME_SAVES_SYNC_METHOD = 'gameSaves.sync';
+const GAME_SAVES_GET_FILE_METHOD = 'gameSaves.getFile';
+const GAME_SAVES_READ_PARSED_DATA_METHOD = 'gameSaves.readParsedData';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
 const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
@@ -840,7 +844,9 @@ function isMiniProgramDirectoryRef(value) {
     if (isNonEmptyString$1(value.handleId)) {
         return hasOnlyKeys(value, ['kind', 'handleId']);
     }
-    return (isMiniProgramPathRootRef(value.root) && (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) && hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
+    return (isMiniProgramPathRootRef(value.root) &&
+        (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) &&
+        hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
 }
 /**
  * 判断未知值是否具有文件 descriptor 的最低 wire 结构。
@@ -1258,6 +1264,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',
@@ -7485,7 +7492,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.4-alpha.5';
+    : '0.9.4';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -8474,6 +8481,61 @@ function isMiniProgramFileSystemValue(value) {
     return !!value && typeof value === 'object' && brandedFileSystemValues.has(value);
 }
 
+function createGameSavesModule(requester) {
+    return {
+        async list(gameId) {
+            const payload = { gameId };
+            const result = await requester.request(GAME_SAVES_LIST_METHOD, payload);
+            const accountId = result.accountId;
+            return result.saves.map((save) => {
+                const saveId = save.saveId;
+                return {
+                    ...save,
+                    files: save.files.map((file) => {
+                        const fileId = file.fileId;
+                        return Object.freeze({
+                            ...file,
+                            async downloadFile({ signal } = {}) {
+                                const descriptor = await requester.requestOperation(GAME_SAVES_GET_FILE_METHOD, { gameId, accountId, saveId, fileId }, {
+                                    ...(signal ? { signal } : {}),
+                                    createAbortError: () => createSDKError('DOWNLOAD_CANCELLED', '存档下载已取消'),
+                                });
+                                if (!descriptor || descriptor.mode !== 'read')
+                                    throw createSDKError('INVALID_RESPONSE', '存档必须为只读文件');
+                                return getFileHandleRegistry(requester).createFile(descriptor);
+                            },
+                        });
+                    }),
+                };
+            });
+        },
+        async getLatestStructuredData(gameId) {
+            const result = await requester.request(GAME_SAVES_READ_PARSED_DATA_METHOD, { gameId });
+            // 旧宿主的 overview 不能作为完整数据交付；只返回公开字段。
+            if (result?.status === 'ready' && result.data && typeof result.data === 'object' && !Array.isArray(result.data)) {
+                return { status: 'ready', data: result.data };
+            }
+            if (result?.status === 'empty' || result?.status === 'unsupported')
+                return { status: result.status };
+            if (result?.status === 'failed' && typeof result.error?.code === 'string' && typeof result.error?.message === 'string') {
+                return { status: 'failed', error: { code: result.error.code, message: result.error.message } };
+            }
+            throw createSDKError('INVALID_RESPONSE', '结构化数据响应不合法');
+        },
+        async sync(gameId, options = {}) {
+            const { signal } = options;
+            const payload = { gameId };
+            const result = await requester.requestOperation(GAME_SAVES_SYNC_METHOD, payload, {
+                ...(signal ? { signal } : {}),
+                createAbortError: () => createSDKError('REQUEST_CANCELLED', '已停止等待存档同步'),
+            });
+            if (result?.state !== 'succeeded')
+                throw createSDKError('INVALID_RESPONSE', '同步完成响应不合法');
+            // 成功不返回内部任务阶段；旧宿主的完成响应仍需校验。
+        },
+    };
+}
+
 function normalizeAlias(alias) {
     if (typeof alias !== 'string' || !COMPANION_ALIAS_PATTERN.test(alias)) {
         throw createSDKError('INVALID_PARAMS', 'alias 必须是规范的 Companion alias');
@@ -11640,6 +11702,8 @@ class MiniProgramSDK {
     navigation;
     /** 云端数据相关开放能力。 */
     cloud;
+    /** 查询、同步并读取当前用户的 Steam 游戏存档。 */
+    gameSaves;
     /** 受管桌面程序能力。 */
     companion;
     /** 当前实例的环境信息。 */
@@ -11662,6 +11726,7 @@ class MiniProgramSDK {
         this.device = createDeviceModule(this.client);
         this.navigation = createNavigationModule(this.client);
         this.cloud = createCloudModule(this.client);
+        this.gameSaves = createGameSavesModule(this.client);
         this.companion = createCompanionModule(this.client);
         this.environment = createEnvironmentModule(this.client);
     }
@@ -12224,6 +12289,12 @@ const navigation = {
     openAppPage: (options) => getDefaultSDK().navigation.openAppPage(options),
 };
 /** 默认 SDK 实例的 cloud 模块。 */
+/** 当前用户的游戏存档能力。 */
+const gameSaves = {
+    list: (gameId) => getDefaultSDK().gameSaves.list(gameId),
+    getLatestStructuredData: (gameId) => getDefaultSDK().gameSaves.getLatestStructuredData(gameId),
+    sync: (gameId, options) => getDefaultSDK().gameSaves.sync(gameId, options),
+};
 const cloud = {
     leaderboard: {
         submit: (options) => getDefaultSDK().cloud.leaderboard.submit(options),
@@ -12255,9 +12326,9 @@ const environment = {
 };
 /** 默认 SDK 的工作区卡片模块。 */
 const workspaceCards = {
-    requestRefresh: options => getDefaultSDK().workspaceCards.requestRefresh(options),
+    requestRefresh: (options) => getDefaultSDK().workspaceCards.requestRefresh(options),
     getLaunchContext: () => getDefaultSDK().workspaceCards.getLaunchContext(),
-    onLaunchContextChange: listener => getDefaultSDK().workspaceCards.onLaunchContextChange(listener),
+    onLaunchContextChange: (listener) => getDefaultSDK().workspaceCards.onLaunchContextChange(listener),
 };
 
 const hbSDK = {
@@ -12278,6 +12349,7 @@ const hbSDK = {
     environment,
     navigation,
     cloud,
+    gameSaves,
     companion,
     workspaceCards,
 };
@@ -12292,6 +12364,7 @@ exports.default = hbSDK;
 exports.device = device;
 exports.environment = environment;
 exports.files = files;
+exports.gameSaves = gameSaves;
 exports.getHandshakeState = getHandshakeState;
 exports.media = media;
 exports.navigation = navigation;

package/dist/index.esm.js

@@ -411,6 +411,10 @@ 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 GAME_SAVES_LIST_METHOD = 'gameSaves.list';
+const GAME_SAVES_SYNC_METHOD = 'gameSaves.sync';
+const GAME_SAVES_GET_FILE_METHOD = 'gameSaves.getFile';
+const GAME_SAVES_READ_PARSED_DATA_METHOD = 'gameSaves.readParsedData';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
 const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
@@ -836,7 +840,9 @@ function isMiniProgramDirectoryRef(value) {
     if (isNonEmptyString$1(value.handleId)) {
         return hasOnlyKeys(value, ['kind', 'handleId']);
     }
-    return (isMiniProgramPathRootRef(value.root) && (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) && hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
+    return (isMiniProgramPathRootRef(value.root) &&
+        (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) &&
+        hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
 }
 /**
  * 判断未知值是否具有文件 descriptor 的最低 wire 结构。
@@ -1254,6 +1260,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',
@@ -7481,7 +7488,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.4-alpha.5';
+    : '0.9.4';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -8470,6 +8477,61 @@ function isMiniProgramFileSystemValue(value) {
     return !!value && typeof value === 'object' && brandedFileSystemValues.has(value);
 }
 
+function createGameSavesModule(requester) {
+    return {
+        async list(gameId) {
+            const payload = { gameId };
+            const result = await requester.request(GAME_SAVES_LIST_METHOD, payload);
+            const accountId = result.accountId;
+            return result.saves.map((save) => {
+                const saveId = save.saveId;
+                return {
+                    ...save,
+                    files: save.files.map((file) => {
+                        const fileId = file.fileId;
+                        return Object.freeze({
+                            ...file,
+                            async downloadFile({ signal } = {}) {
+                                const descriptor = await requester.requestOperation(GAME_SAVES_GET_FILE_METHOD, { gameId, accountId, saveId, fileId }, {
+                                    ...(signal ? { signal } : {}),
+                                    createAbortError: () => createSDKError('DOWNLOAD_CANCELLED', '存档下载已取消'),
+                                });
+                                if (!descriptor || descriptor.mode !== 'read')
+                                    throw createSDKError('INVALID_RESPONSE', '存档必须为只读文件');
+                                return getFileHandleRegistry(requester).createFile(descriptor);
+                            },
+                        });
+                    }),
+                };
+            });
+        },
+        async getLatestStructuredData(gameId) {
+            const result = await requester.request(GAME_SAVES_READ_PARSED_DATA_METHOD, { gameId });
+            // 旧宿主的 overview 不能作为完整数据交付；只返回公开字段。
+            if (result?.status === 'ready' && result.data && typeof result.data === 'object' && !Array.isArray(result.data)) {
+                return { status: 'ready', data: result.data };
+            }
+            if (result?.status === 'empty' || result?.status === 'unsupported')
+                return { status: result.status };
+            if (result?.status === 'failed' && typeof result.error?.code === 'string' && typeof result.error?.message === 'string') {
+                return { status: 'failed', error: { code: result.error.code, message: result.error.message } };
+            }
+            throw createSDKError('INVALID_RESPONSE', '结构化数据响应不合法');
+        },
+        async sync(gameId, options = {}) {
+            const { signal } = options;
+            const payload = { gameId };
+            const result = await requester.requestOperation(GAME_SAVES_SYNC_METHOD, payload, {
+                ...(signal ? { signal } : {}),
+                createAbortError: () => createSDKError('REQUEST_CANCELLED', '已停止等待存档同步'),
+            });
+            if (result?.state !== 'succeeded')
+                throw createSDKError('INVALID_RESPONSE', '同步完成响应不合法');
+            // 成功不返回内部任务阶段；旧宿主的完成响应仍需校验。
+        },
+    };
+}
+
 function normalizeAlias(alias) {
     if (typeof alias !== 'string' || !COMPANION_ALIAS_PATTERN.test(alias)) {
         throw createSDKError('INVALID_PARAMS', 'alias 必须是规范的 Companion alias');
@@ -11636,6 +11698,8 @@ class MiniProgramSDK {
     navigation;
     /** 云端数据相关开放能力。 */
     cloud;
+    /** 查询、同步并读取当前用户的 Steam 游戏存档。 */
+    gameSaves;
     /** 受管桌面程序能力。 */
     companion;
     /** 当前实例的环境信息。 */
@@ -11658,6 +11722,7 @@ class MiniProgramSDK {
         this.device = createDeviceModule(this.client);
         this.navigation = createNavigationModule(this.client);
         this.cloud = createCloudModule(this.client);
+        this.gameSaves = createGameSavesModule(this.client);
         this.companion = createCompanionModule(this.client);
         this.environment = createEnvironmentModule(this.client);
     }
@@ -12220,6 +12285,12 @@ const navigation = {
     openAppPage: (options) => getDefaultSDK().navigation.openAppPage(options),
 };
 /** 默认 SDK 实例的 cloud 模块。 */
+/** 当前用户的游戏存档能力。 */
+const gameSaves = {
+    list: (gameId) => getDefaultSDK().gameSaves.list(gameId),
+    getLatestStructuredData: (gameId) => getDefaultSDK().gameSaves.getLatestStructuredData(gameId),
+    sync: (gameId, options) => getDefaultSDK().gameSaves.sync(gameId, options),
+};
 const cloud = {
     leaderboard: {
         submit: (options) => getDefaultSDK().cloud.leaderboard.submit(options),
@@ -12251,9 +12322,9 @@ const environment = {
 };
 /** 默认 SDK 的工作区卡片模块。 */
 const workspaceCards = {
-    requestRefresh: options => getDefaultSDK().workspaceCards.requestRefresh(options),
+    requestRefresh: (options) => getDefaultSDK().workspaceCards.requestRefresh(options),
     getLaunchContext: () => getDefaultSDK().workspaceCards.getLaunchContext(),
-    onLaunchContextChange: listener => getDefaultSDK().workspaceCards.onLaunchContextChange(listener),
+    onLaunchContextChange: (listener) => getDefaultSDK().workspaceCards.onLaunchContextChange(listener),
 };
 
 const hbSDK = {
@@ -12274,8 +12345,9 @@ const hbSDK = {
     environment,
     navigation,
     cloud,
+    gameSaves,
     companion,
     workspaceCards,
 };
 
-export { HbMiniProgramNetworkError, HbMiniProgramSDKError, USER_INFO_AUTHORIZATION_SCOPES, auth, cloud, companion, hbSDK as default, device, environment, files, getHandshakeState, media, navigation, network, off, on, onHandshakeStateChange, share, storage, ui, user, viewport, workspaceCards };
+export { HbMiniProgramNetworkError, HbMiniProgramSDKError, USER_INFO_AUTHORIZATION_SCOPES, auth, cloud, companion, hbSDK as default, device, environment, files, gameSaves, getHandshakeState, media, navigation, network, off, on, onHandshakeStateChange, share, storage, ui, user, viewport, workspaceCards };

package/dist/miniapp-publish.cjs.js

@@ -13,6 +13,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',
@@ -23,6 +24,16 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'workspaceCards',
 ];
 const MINI_PROGRAM_PERMISSION_CATALOG = [
+    {
+        key: 'gameSaves',
+        name: '游戏存档',
+        description: '获取和同步当前用户指定游戏的 Steam 云存档，并读取存档文件，无需单独弹窗确认。',
+        access: 'declaration',
+        risk: 'high',
+        config: {},
+        methods: ['gameSaves.list', 'gameSaves.sync', 'gameSaves.getFile', 'gameSaves.readParsedData'],
+        conditions: ['需要用户明确授权、有效 Steam 登录和支持文件读取的宿主；可按需读取受支持游戏的已有解析概览，不触发解析。'],
+    },
     {
         key: 'userInfo',
         name: '用户信息',
@@ -188,9 +199,12 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
         conditions: ['最高危险权限：批准后该入口可执行任意协议，并绕过其他 SDK 能力权限及专用授权流程。'],
     },
     {
-        key: 'workspaceCards', name: '工作区卡片',
+        key: 'workspaceCards',
+        name: '工作区卡片',
         description: '在已绑定游戏的桌面工作区展示受审核卡片。',
-        access: 'platform-approval', risk: 'high', config: {},
+        access: 'platform-approval',
+        risk: 'high',
+        config: {},
         methods: ['workspaceCards.requestRefresh'],
         conditions: ['需平台批准、Host 支持与有效执行租约；不隐式授予网络或存储权限。'],
     },

package/dist/miniapp-publish.esm.js

@@ -11,6 +11,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',
@@ -21,6 +22,16 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'workspaceCards',
 ];
 const MINI_PROGRAM_PERMISSION_CATALOG = [
+    {
+        key: 'gameSaves',
+        name: '游戏存档',
+        description: '获取和同步当前用户指定游戏的 Steam 云存档，并读取存档文件，无需单独弹窗确认。',
+        access: 'declaration',
+        risk: 'high',
+        config: {},
+        methods: ['gameSaves.list', 'gameSaves.sync', 'gameSaves.getFile', 'gameSaves.readParsedData'],
+        conditions: ['需要用户明确授权、有效 Steam 登录和支持文件读取的宿主；可按需读取受支持游戏的已有解析概览，不触发解析。'],
+    },
     {
         key: 'userInfo',
         name: '用户信息',
@@ -186,9 +197,12 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
         conditions: ['最高危险权限：批准后该入口可执行任意协议，并绕过其他 SDK 能力权限及专用授权流程。'],
     },
     {
-        key: 'workspaceCards', name: '工作区卡片',
+        key: 'workspaceCards',
+        name: '工作区卡片',
         description: '在已绑定游戏的桌面工作区展示受审核卡片。',
-        access: 'platform-approval', risk: 'high', config: {},
+        access: 'platform-approval',
+        risk: 'high',
+        config: {},
         methods: ['workspaceCards.requestRefresh'],
         conditions: ['需平台批准、Host 支持与有效执行租约；不隐式授予网络或存储权限。'],
     },

package/dist/protocol.cjs.js

@@ -34,6 +34,10 @@ 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 GAME_SAVES_LIST_METHOD = 'gameSaves.list';
+const GAME_SAVES_SYNC_METHOD = 'gameSaves.sync';
+const GAME_SAVES_GET_FILE_METHOD = 'gameSaves.getFile';
+const GAME_SAVES_READ_PARSED_DATA_METHOD = 'gameSaves.readParsedData';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
 const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
@@ -108,10 +112,19 @@ const COMPANION_SHOW_NOTIFICATION_METHOD = 'companion.showNotification';
  * 仅表示无需 Manifest 权限声明，不表示绕过参数校验、Host 能力、可信手势或业务策略。
  */
 const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
+    ...[GAME_SAVES_LIST_METHOD, GAME_SAVES_SYNC_METHOD, GAME_SAVES_GET_FILE_METHOD, GAME_SAVES_READ_PARSED_DATA_METHOD].map((method) => ({
+        method,
+        module: 'gameSaves',
+        capability: method,
+        requirement: { kind: 'all', permissions: ['gameSaves'] },
+        risk: 'high',
+    })),
     {
-        method: WORKSPACE_CARDS_REQUEST_REFRESH_METHOD, module: 'workspaceCards',
+        method: WORKSPACE_CARDS_REQUEST_REFRESH_METHOD,
+        module: 'workspaceCards',
         capability: WORKSPACE_CARDS_REQUEST_REFRESH_METHOD,
-        requirement: { kind: 'all', permissions: ['workspaceCards'] }, risk: 'high',
+        requirement: { kind: 'all', permissions: ['workspaceCards'] },
+        risk: 'high',
     },
     {
         method: AUTH_GET_ACCOUNT_STATE_METHOD,
@@ -807,7 +820,9 @@ function isMiniProgramDirectoryRef(value) {
     if (isNonEmptyString$1(value.handleId)) {
         return hasOnlyKeys(value, ['kind', 'handleId']);
     }
-    return (isMiniProgramPathRootRef(value.root) && (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) && hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
+    return (isMiniProgramPathRootRef(value.root) &&
+        (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) &&
+        hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
 }
 /**
  * 判断未知值是否具有文件 descriptor 的最低 wire 结构。
@@ -1410,6 +1425,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',

package/dist/protocol.esm.js

@@ -32,6 +32,10 @@ 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 GAME_SAVES_LIST_METHOD = 'gameSaves.list';
+const GAME_SAVES_SYNC_METHOD = 'gameSaves.sync';
+const GAME_SAVES_GET_FILE_METHOD = 'gameSaves.getFile';
+const GAME_SAVES_READ_PARSED_DATA_METHOD = 'gameSaves.readParsedData';
 const USER_GET_INFO_METHOD = 'user.getInfo';
 const USER_REVOKE_AUTHORIZATION_METHOD = 'user.revokeAuthorization';
 const USER_GET_STEAM_GAME_LIST_METHOD = 'user.getSteamGameList';
@@ -106,10 +110,19 @@ const COMPANION_SHOW_NOTIFICATION_METHOD = 'companion.showNotification';
  * 仅表示无需 Manifest 权限声明，不表示绕过参数校验、Host 能力、可信手势或业务策略。
  */
 const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
+    ...[GAME_SAVES_LIST_METHOD, GAME_SAVES_SYNC_METHOD, GAME_SAVES_GET_FILE_METHOD, GAME_SAVES_READ_PARSED_DATA_METHOD].map((method) => ({
+        method,
+        module: 'gameSaves',
+        capability: method,
+        requirement: { kind: 'all', permissions: ['gameSaves'] },
+        risk: 'high',
+    })),
     {
-        method: WORKSPACE_CARDS_REQUEST_REFRESH_METHOD, module: 'workspaceCards',
+        method: WORKSPACE_CARDS_REQUEST_REFRESH_METHOD,
+        module: 'workspaceCards',
         capability: WORKSPACE_CARDS_REQUEST_REFRESH_METHOD,
-        requirement: { kind: 'all', permissions: ['workspaceCards'] }, risk: 'high',
+        requirement: { kind: 'all', permissions: ['workspaceCards'] },
+        risk: 'high',
     },
     {
         method: AUTH_GET_ACCOUNT_STATE_METHOD,
@@ -805,7 +818,9 @@ function isMiniProgramDirectoryRef(value) {
     if (isNonEmptyString$1(value.handleId)) {
         return hasOnlyKeys(value, ['kind', 'handleId']);
     }
-    return (isMiniProgramPathRootRef(value.root) && (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) && hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
+    return (isMiniProgramPathRootRef(value.root) &&
+        (value.relativePath === '.' || isMiniProgramRelativePath(value.relativePath)) &&
+        hasOnlyKeys(value, ['kind', 'root', 'relativePath']));
 }
 /**
  * 判断未知值是否具有文件 descriptor 的最低 wire 结构。
@@ -1408,6 +1423,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',

package/dist/vite.cjs.js

@@ -63,6 +63,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',
@@ -73,6 +74,16 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'workspaceCards',
 ];
 const MINI_PROGRAM_PERMISSION_CATALOG = [
+    {
+        key: 'gameSaves',
+        name: '游戏存档',
+        description: '获取和同步当前用户指定游戏的 Steam 云存档，并读取存档文件，无需单独弹窗确认。',
+        access: 'declaration',
+        risk: 'high',
+        config: {},
+        methods: ['gameSaves.list', 'gameSaves.sync', 'gameSaves.getFile', 'gameSaves.readParsedData'],
+        conditions: ['需要用户明确授权、有效 Steam 登录和支持文件读取的宿主；可按需读取受支持游戏的已有解析概览，不触发解析。'],
+    },
     {
         key: 'userInfo',
         name: '用户信息',
@@ -238,9 +249,12 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
         conditions: ['最高危险权限：批准后该入口可执行任意协议，并绕过其他 SDK 能力权限及专用授权流程。'],
     },
     {
-        key: 'workspaceCards', name: '工作区卡片',
+        key: 'workspaceCards',
+        name: '工作区卡片',
         description: '在已绑定游戏的桌面工作区展示受审核卡片。',
-        access: 'platform-approval', risk: 'high', config: {},
+        access: 'platform-approval',
+        risk: 'high',
+        config: {},
         methods: ['workspaceCards.requestRefresh'],
         conditions: ['需平台批准、Host 支持与有效执行租约；不隐式授予网络或存储权限。'],
     },
@@ -10315,7 +10329,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.4-alpha.5';
+    : '0.9.4';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/dist/vite.esm.js

@@ -60,6 +60,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',
@@ -70,6 +71,16 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'workspaceCards',
 ];
 const MINI_PROGRAM_PERMISSION_CATALOG = [
+    {
+        key: 'gameSaves',
+        name: '游戏存档',
+        description: '获取和同步当前用户指定游戏的 Steam 云存档，并读取存档文件，无需单独弹窗确认。',
+        access: 'declaration',
+        risk: 'high',
+        config: {},
+        methods: ['gameSaves.list', 'gameSaves.sync', 'gameSaves.getFile', 'gameSaves.readParsedData'],
+        conditions: ['需要用户明确授权、有效 Steam 登录和支持文件读取的宿主；可按需读取受支持游戏的已有解析概览，不触发解析。'],
+    },
     {
         key: 'userInfo',
         name: '用户信息',
@@ -235,9 +246,12 @@ const MINI_PROGRAM_PERMISSION_CATALOG = [
         conditions: ['最高危险权限：批准后该入口可执行任意协议，并绕过其他 SDK 能力权限及专用授权流程。'],
     },
     {
-        key: 'workspaceCards', name: '工作区卡片',
+        key: 'workspaceCards',
+        name: '工作区卡片',
         description: '在已绑定游戏的桌面工作区展示受审核卡片。',
-        access: 'platform-approval', risk: 'high', config: {},
+        access: 'platform-approval',
+        risk: 'high',
+        config: {},
         methods: ['workspaceCards.requestRefresh'],
         conditions: ['需平台批准、Host 支持与有效执行租约；不隐式授予网络或存储权限。'],
     },
@@ -10312,7 +10326,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.4-alpha.5';
+    : '0.9.4';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.4-alpha.5",
+  "version": "0.9.4",
   "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.4-alpha.5"
+    "@heybox/hb-sdk-protocol": "0.9.4"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -128,13 +128,13 @@
     "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-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox-domain/heybox-theme": "~0.1.0",
+    "@heybox/hb-sdk-runtime": "~0.9.4",
+    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox/hb-api": "~1.28.19",
-    "@heybox/hb-sdk-runtime": "~0.9.4-alpha.5",
     "@heybox/runtime": "~0.2.1",
-    "@heybox/runtime-policy": "~0.2.1",
-    "@heybox/runtime-transport-fetch": "~0.2.1"
+    "@heybox/runtime-transport-fetch": "~0.2.1",
+    "@heybox/runtime-policy": "~0.2.1"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",

package/skill/skill.json

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