@heybox/hb-sdk 0.9.4-alpha.4 → 0.9.4-alpha.6

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 0.9.4-alpha.6 - 2026-10-28
+
+### 行为调整
+
+- [游戏存档 API](https://docs.xiaoheihe.cn/hb_sdk/guide/game-saves) 不再弹出独立的用户授权确认；仍需声明 `gameSaves`、登录小黑盒并使用正式发布版本，需要 Host 与后端配套更新。
+
+### 新增能力
+
+- 新增 `gameSaves.list()`、`gameSaves.sync()`，以及列表文件对象的 `downloadFile()`，用于查询、同步和读取当前用户的 Steam 游戏存档；`list(gameId)` 直接返回存档数组，`sync(gameId, { signal? })` 等待同步完成；游戏 ID 直接传字符串，账号由 Runtime 内部处理；`sync()` 无需先查询，等待成功后正常完成 `Promise<void>`，支持取消等待，不暴露内部任务阶段，文件通过受控沙箱读取；使用前须声明 `gameSaves` 权限，需要 Host 配套更新。
+- 列表文件对象的 `downloadFile()` 自动沿用查询时的游戏、账号和文件，无需重复传入 ID，返回只读 ZIP 文件，解压及游戏数据解析由开发者负责；切换账号或运行资格变化后，已有存档文件句柄失效。
+- 宿主持久存储可用时，取消等待或退出小程序后再次调用 [gameSaves.sync()](https://docs.xiaoheihe.cn/hb_sdk/guide/game-saves)，可恢复上次同步任务的等待并获取结果；不包含文件下载断点续传，需要 Host 配套更新。
+
+- 独立接口 `gameSaves.getLatestStructuredData(gameId)` 读取悟空和任务栏英雄的完整结构化业务数据，成功返回 `{ status: 'ready', data: {...} }`；不触发解析，解析数据暂不可用时仍可使用文件清单，需要 Host 与后端配套更新。
+
+### 文档与工具
+
+- 新增[游戏存档接入指南](https://docs.xiaoheihe.cn/hb_sdk/guide/game-saves)，说明错误处理、单文件大小和会话累计额度限制。
+
+## 0.9.4-alpha.5 - 2026-10-28
+
+### 问题修复
+
+- 修复部分 Android WebView 中小程序截图的品牌引导标记被横向压缩的问题；需要宿主配套更新，小程序无需修改截图调用。
+
 ## 0.9.4-alpha.4 - 2026-10-28
 
 ### 问题修复

package/README.md

@@ -187,6 +187,8 @@ console.log(info.sdk.version);
 
 ## 文件与传输
 
+`gameSaves.list / sync` 只需传入 `gameId` 即可查询与同步当前绑定 Steam 账号的存档；列表文件对象通过 `downloadFile({ signal? })` 下载，无需重复传入游戏、账号、存档或文件 ID；`sync` 返回 `Promise<void>`，等待成功并支持取消，Host 私有存储可用时再次调用可恢复上次未结束的同步等待，仍以服务端状态为准。需声明 `gameSaves`，无需单独的用户确认弹窗；返回只读 ZIP 文件，开发者调用 `readBytes()` 后自行解压、解析。首期为新版 Steam 云同步结果，单文件上限 8 MiB、会话上限 32 MiB；需要配套后端和受信 Host。详见[游戏存档](https://docs.xiaoheihe.cn/hb_sdk/guide/game-saves)。
+
 `network.upload()` 接收一个可读 `FileHandle`，由 Host 直接流式上传到开发者指定 URL。raw 支持 PUT（默认）/POST，multipart 固定 POST 并可携带字符串字段；支持进度、取消、空闲超时、可选大小限制和标准 HTTP 响应。文件字节不经过 iframe，上传期间应保持源文件不变；首版不自动重试、分片、续传或复制快照。PC、Android、iOS、OHOS 按真实 Host primitive 启用，旧 Host 明确拒绝。完整示例见[文件能力与沙箱](https://docs.xiaoheihe.cn/hb_sdk/guide/files-and-sandbox)。
 
 `files` 提供当前小程序私有 sandbox 和由用户选择授予的外部 File/Directory；
@@ -229,6 +231,8 @@ console.log(await downloaded.readText());
 
 `remove()` 只允许删除 sandbox 对象；外部 picker、`saveFile()` 及其派生项即使是 `readwrite` 也返回 `FILE_ACCESS_DENIED`。单个 Runtime session 最多保留 1024 个外部 direct handle，超限返回 `FILE_QUOTA_EXCEEDED`。Host 文件错误只向 SDK 暴露稳定 code 与 canonical 安全文案，业务不要依赖平台原始 message 或附加 data。
 
+`const result = await gameSaves.list(gameId)` 只查询文件清单；独立调用 `await gameSaves.getLatestStructuredData(gameId)` 读取悟空、任务栏英雄的完整结构化业务数据；成功返回 `{ status: 'ready', data: {...} }`，其余情况通过 `status` 区分，不会触发解析或预下载文件。详见[游戏存档指南](https://docs.xiaoheihe.cn/hb_sdk/guide/game-saves)。
+
 ## 受管桌面程序
 
 真实 PC 的本地临时 Companion 还要求 Host 支持私有 local-dev lease；该 lease 由 Host 原子记录 prepare、Session 与进程树 provenance，并在 H5/CLI 失联后自行清理。缺少该 capability 的旧 PC Host 会安全拒绝真实临时 Companion，Browser Fake 和普通 network 调试仍可用。
@@ -288,8 +292,8 @@ const stopViewport = hbSDK.on('viewport_change', (windowInfo) => {
 
 ```ts
 const stopDisplay = hbSDK.on('display_change', ({ orientation, fullscreen }) => {
-  console.log('当前方向', orientation, '当前全屏状态', fullscreen)
-})
+  console.log('当前方向', orientation, '当前全屏状态', fullscreen);
+});
 
 // 页面销毁时调用 stopDisplay()。
 ```
@@ -320,9 +324,9 @@ window.addEventListener('unload', stopHandshakeState, { once: true });
 
 SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握手状态，并通过 `on()` / `off()` 处理前后台、登录态等生命周期事件。
 
-| 模块         | 用途                                            |
-| ------------ | ----------------------------------------------- |
-| `auth`       | 获取交给开发者服务端交换的短期授权码            |
+| 模块          | 用途                                            |
+| ------------- | ----------------------------------------------- |
+| `auth`        | 获取交给开发者服务端交换的短期授权码            |
 | `environment` | 读取当前实例的冻结环境快照                      |
 | `user`       | 读取 Host 当前用户资料、隔离身份或撤销授权      |
 | `share`      | 打开分享、复制链接或截图分享流程                |
@@ -336,6 +340,7 @@ SDK 还提供 `getHandshakeState()` / `onHandshakeStateChange()` 管理持久握
 | `cloud`      | 使用小程序云端排行榜与用户私有云端存储          |
 | `network`    | 发起经过平台授权的网络请求及受控文件传输  |
 | `companion`  | 准备、启动并控制当前版本审核过的桌面辅助应用    |
+| `gameSaves`   | 查询、同步并读取当前用户的 Steam 游戏存档       |
 
 `share.screenshot()` 每次调用都会在 SDK 侧输出行为变更 warning，提醒升级后的布局与配色要求；日志失败不阻断调用。截图从正式 SDK `0.9.1` 起默认添加水印。新 Runtime 对低于 `0.9.1` 的 SDK（包含 `0.9.1-alpha.*`）或缺少 SDK 版本记录的兼容模式静默保持无水印截图；升级前需同步调整布局。启用水印时，会在截图区域底部添加当前小程序名称的品牌搜索胶囊及灰色「小黑盒工坊小程序」。请在目标区域底部预留至少 57 个逻辑像素的空白背景，避免遮挡重要内容，并保证背景与水印有足够对比度。`watermarkTheme: 'light'` 适合浅色背景（黑色水印），`'dark'` 适合深色背景（白色水印，默认）；不自动跟随系统主题。水印仅在 SDK 截图期间展示，不增加图片尺寸；系统按键截图暂不支持。截图等待不受 SDK 普通请求超时限制；排队和延迟期间会响应会话终止，Mobile Host 从投递原生截图起最多等待 15 秒成图回调。详见 [截图分享布局要求](https://docs.xiaoheihe.cn/hb_sdk/recipes/community-share#截图分享)。
 

package/dist/cli-chunks/{artifact-B--9XAIs.cjs → artifact-D5nba0ma.cjs}

@@ -3,9 +3,9 @@
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-DiefxH9S.cjs');
-require('./version-D_8aSq1N.cjs');
-var index = require('./index-BGczaZen.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-G4lQMcP7.cjs');
+require('./version-Bn3O0RsH.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 var node_crypto = require('node:crypto');
 require('node:zlib');
 require('node:module');

package/dist/cli-chunks/{build-CAfDVJee.cjs → build-DQc32VJQ.cjs}

@@ -2,14 +2,14 @@
 
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-DiefxH9S.cjs');
-var index = require('./index-BGczaZen.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-G4lQMcP7.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 require('node:crypto');
 require('node:fs');
 require('node:zlib');
-var artifact = require('./artifact-B--9XAIs.cjs');
-var projectVite = require('./project-vite-ZnlUOO53.cjs');
-require('./version-D_8aSq1N.cjs');
+var artifact = require('./artifact-D5nba0ma.cjs');
+var projectVite = require('./project-vite-C25k1a7K.cjs');
+require('./version-Bn3O0RsH.cjs');
 require('node:async_hooks');
 require('node:module');
 require('readline');

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

package/dist/cli-chunks/{deploy-lock-Bw3DtFVd.cjs → deploy-lock-hFiYSm4l.cjs}

@@ -3,7 +3,7 @@
 var node_crypto = require('node:crypto');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var index = require('./index-BGczaZen.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 
 const DEPLOY_LOCKED_MESSAGE = '当前设备已有同版本产物正在上传，请等待完成后重试';
 const DEPLOY_LOCK_DIRECTORY_NAME = 'deploy-locks';

package/dist/cli-chunks/{dev-7b8mHN_k.cjs → dev--vpWNxvZ.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index = require('./index-BGczaZen.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 var node_crypto = require('node:crypto');
 var fs = require('node:fs');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-DiefxH9S.cjs');
-var version = require('./version-D_8aSq1N.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-G4lQMcP7.cjs');
+var version = require('./version-Bn3O0RsH.cjs');
 require('node:zlib');
-var devContext = require('./dev-context-CUoKTolJ.cjs');
+var devContext = require('./dev-context-Bo54XJVn.cjs');
 var os = require('node:os');
 var net = require('node:net');
 var promises = require('node:dns/promises');
@@ -18,7 +18,7 @@ var fs$1 = require('node:fs/promises');
 var require$$0$1 = require('crypto');
 var require$$0 = require('buffer');
 var browser = require('./browser-RAy8e8cV.cjs');
-var projectVite = require('./project-vite-ZnlUOO53.cjs');
+var projectVite = require('./project-vite-C25k1a7K.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 const DEFAULT_DEV_CONTEXT_TIMEOUT_MS = 3000;
@@ -3056,8 +3056,8 @@ const DEFAULT_CHANNEL_TRANSPORT = {
 };
 const IPV4_LOOPBACK_ADDRESSES = new net.BlockList();
 IPV4_LOOPBACK_ADDRESSES.addSubnet('127.0.0.0', 8, 'ipv4');
-const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-7b8mHN_k.cjs', document.baseURI).href)))('ws');
-const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-7b8mHN_k.cjs', document.baseURI).href)))('parse5');
+const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev--vpWNxvZ.cjs', document.baseURI).href)))('ws');
+const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev--vpWNxvZ.cjs', document.baseURI).href)))('parse5');
 const BROWSER_DEV_HOST_ROOT_CANDIDATES = [
     path.resolve(__dirname, 'devtools/browser-dev-host'),
     path.resolve(__dirname, '../devtools/browser-dev-host'),
@@ -12183,7 +12183,7 @@ function assertNodeRuntimeCapabilities(ctx, settings) {
 function createNodeRealtimeDriverRegistry() {
     const registry = createRuntimeRealtimeDriverRegistry();
     registry.registerLazy('node-websocket', async () => {
-        const mod = await Promise.resolve().then(function () { return require('./index.esm-BCZUlOrb.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-DnWSYrc7.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;

package/dist/cli-chunks/{dev-context-CUoKTolJ.cjs → dev-context-Bo54XJVn.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var index = require('./index-BGczaZen.cjs');
-var runtimePermissionEnv = require('./runtime-permission-env-DiefxH9S.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-G4lQMcP7.cjs');
 var node_crypto = require('node:crypto');
 var fs = require('node:fs/promises');
 var path = require('node:path');

package/dist/cli-chunks/{doctor-PqYtjWlp.cjs → doctor-ljmHE-Eu.cjs}

@@ -3,7 +3,7 @@
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-BGczaZen.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{games-Dwk0LnWJ.cjs → games-DBa_MNAm.cjs}

@@ -3,8 +3,8 @@
 var node_crypto = require('node:crypto');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var index = require('./index-BGczaZen.cjs');
-var deployLock = require('./deploy-lock-Bw3DtFVd.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
+var deployLock = require('./deploy-lock-hFiYSm4l.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{index-CODS_-j0.cjs → index-CD-u4YfP.cjs}

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

package/dist/cli-chunks/{index-BGczaZen.cjs → index-DyDrs_NZ.cjs}

@@ -238,19 +238,19 @@ function requireArgument () {
 
 var command = {};
 
-const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-BGczaZen.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-DyDrs_NZ.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-BGczaZen.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-DyDrs_NZ.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-BGczaZen.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-DyDrs_NZ.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-BGczaZen.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-DyDrs_NZ.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-BGczaZen.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-DyDrs_NZ.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -17249,7 +17249,7 @@ async function inspectFeedbackLog(file, size) {
     return { mimeType: 'text/plain', width: 0, height: 0 };
 }
 async function createFeedbackCosClient(getToken) {
-    const { default: COS } = await Promise.resolve().then(function () { return require('./index-CODS_-j0.cjs'); }).then(function (n) { return n.index; });
+    const { default: COS } = await Promise.resolve().then(function () { return require('./index-CD-u4YfP.cjs'); }).then(function (n) { return n.index; });
     const cos = new COS({
         getAuthorization(_options, callback) {
             void getToken().then((token) => callback({
@@ -20900,7 +20900,7 @@ function readEnvNameArgFromArgv(argv) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.9.4-alpha.4';
+const BUILT_CLI_VERSION = '0.9.4-alpha.6';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -21284,39 +21284,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-CCFzWeNC.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-BEBMdi8r.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-CCFzWeNC.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-BEBMdi8r.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-CCFzWeNC.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-BEBMdi8r.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-CAfDVJee.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-DQc32VJQ.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-vb9O6sKj.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-ffrMHEIA.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-7b8mHN_k.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev--vpWNxvZ.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-PqYtjWlp.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-ljmHE-Eu.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunSkillInstallCommand = async (...args) => {
-    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-Dq2_U9GQ.cjs'); });
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-Cv69hni4.cjs'); });
     return runSkillInstallCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-B_IBeqPj.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-BsZbVhxa.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {
@@ -21408,14 +21408,13 @@ function parseNonNegativeInteger(value) {
     return parsed;
 }
 const defaultRunGameSearchCommand = async (...args) => {
-    const { runGameSearchCommand } = await Promise.resolve().then(function () { return require('./games-Dwk0LnWJ.cjs'); });
+    const { runGameSearchCommand } = await Promise.resolve().then(function () { return require('./games-DBa_MNAm.cjs'); });
     return runGameSearchCommand(...args);
 };
 
 exports.CliError = CliError;
 exports.HB_SDK_PACKAGE_NAME = HB_SDK_PACKAGE_NAME;
 exports.HB_SDK_SKILL_NAME = HB_SDK_SKILL_NAME;
-exports.HEYBOX_API_BASE_URL = HEYBOX_API_BASE_URL;
 exports.applyMiniProgramServiceTagIfNeeded = applyMiniProgramServiceTagIfNeeded;
 exports.clearHeyboxAuthSession = clearHeyboxAuthSession;
 exports.commonjsGlobal = commonjsGlobal;

package/dist/cli-chunks/{index.esm-BCZUlOrb.cjs → index.esm-DnWSYrc7.cjs}

@@ -11,8 +11,8 @@ var require$$0$3 = require('url');
 var require$$5 = require('zlib');
 var require$$0 = require('buffer');
 var require$$1 = require('util');
-var index = require('./index-BGczaZen.cjs');
-var dev = require('./dev-7b8mHN_k.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
+var dev = require('./dev--vpWNxvZ.cjs');
 require('node:module');
 require('readline');
 require('os');
@@ -26,10 +26,10 @@ require('constants');
 require('node:fs');
 require('node:fs/promises');
 require('node:zlib');
-require('./runtime-permission-env-DiefxH9S.cjs');
-require('./version-D_8aSq1N.cjs');
+require('./runtime-permission-env-G4lQMcP7.cjs');
+require('./version-Bn3O0RsH.cjs');
 require('node:async_hooks');
-require('./dev-context-CUoKTolJ.cjs');
+require('./dev-context-Bo54XJVn.cjs');
 require('sharp');
 require('node:os');
 require('node:net');
@@ -42,7 +42,7 @@ require('node:buffer');
 require('node:url');
 require('node:util');
 require('node:child_process');
-require('./project-vite-ZnlUOO53.cjs');
+require('./project-vite-C25k1a7K.cjs');
 
 var bufferUtil = {exports: {}};
 

package/dist/cli-chunks/{login-CCFzWeNC.cjs → login-BEBMdi8r.cjs}

@@ -3,7 +3,7 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var index = require('./index-BGczaZen.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
 require('node:module');
 require('readline');

package/dist/cli-chunks/{project-vite-ZnlUOO53.cjs → project-vite-C25k1a7K.cjs}

@@ -5,7 +5,7 @@ var fs$1 = require('node:fs/promises');
 var node_module = require('node:module');
 var path = require('node:path');
 var node_url = require('node:url');
-var index = require('./index-BGczaZen.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-B_IBeqPj.cjs → remote-BsZbVhxa.cjs}

@@ -1,18 +1,18 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-DiefxH9S.cjs');
-var devContext = require('./dev-context-CUoKTolJ.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-G4lQMcP7.cjs');
+var devContext = require('./dev-context-Bo54XJVn.cjs');
 var promises = require('node:readline/promises');
-var index = require('./index-BGczaZen.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
 var path = require('node:path');
 var node_crypto = require('node:crypto');
 require('node:zlib');
-var artifact = require('./artifact-B--9XAIs.cjs');
-var deployLock = require('./deploy-lock-Bw3DtFVd.cjs');
-require('./version-D_8aSq1N.cjs');
+var artifact = require('./artifact-D5nba0ma.cjs');
+var deployLock = require('./deploy-lock-hFiYSm4l.cjs');
+require('./version-Bn3O0RsH.cjs');
 require('node:async_hooks');
 require('sharp');
 require('node:module');
@@ -308,7 +308,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-CODS_-j0.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-CD-u4YfP.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {
@@ -640,7 +640,9 @@ async function runDeployCommand(options, runtime = {}) {
                         miniProgramId,
                         version,
                         uploadSessionId,
-                    }, { baseUrl: apiBaseUrl, cdnBaseUrl: index.HEYBOX_API_BASE_URL, fetchImpl: runtime.fetchImpl, logger });
+                    }, 
+                    // 上传鉴权必须与当前 API / 登录环境一致；个人服务 tag 仍由 CDN adapter 移除。
+                    { baseUrl: apiBaseUrl, cdnBaseUrl: apiBaseUrl, fetchImpl: runtime.fetchImpl, logger });
                 }
             }
             catch (error) {

package/dist/cli-chunks/{runtime-permission-env-DiefxH9S.cjs → runtime-permission-env-G4lQMcP7.cjs}

@@ -2,9 +2,9 @@
 
 var fs = require('node:fs');
 var path = require('node:path');
-var version$1 = require('./version-D_8aSq1N.cjs');
+var version$1 = require('./version-Bn3O0RsH.cjs');
 require('node:crypto');
-var index = require('./index-BGczaZen.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 var node_async_hooks = require('node:async_hooks');
 
 /**
@@ -20,6 +20,7 @@ const MINI_PROGRAM_PERMISSION_KEYS = [
     'share',
     'storage',
     'cloud_storage',
+    'gameSaves',
     'filesystem',
     'media',
     'clipboard',
@@ -30,6 +31,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: '用户信息',
@@ -195,9 +206,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/cli-chunks/{skill-Dq2_U9GQ.cjs → skill-Cv69hni4.cjs}

@@ -1,10 +1,10 @@
 'use strict';
 
-var version = require('./version-D_8aSq1N.cjs');
+var version = require('./version-Bn3O0RsH.cjs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
 var childProcess = require('node:child_process');
-var index = require('./index-BGczaZen.cjs');
+var index = require('./index-DyDrs_NZ.cjs');
 require('node:module');
 require('readline');
 require('os');

package/dist/cli-chunks/{version-D_8aSq1N.cjs → version-Bn3O0RsH.cjs}

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

package/dist/cli.cjs

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