@heybox/hb-sdk 0.8.1 → 0.8.2-alpha.2

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。内部集成、实现策略和审查证据不在此维护。
 
+## 0.8.2-alpha.2
+
+### 文档与工具
+
+- 补充公开 SDK API、参数、错误边界和关联文档，合并 `files` 与 `files.sandbox` 的公开参考入口。
+- 更新 AI Agent 开发指南，公测阶段可直接从开放平台创建或管理工坊小程序。
+
+## 0.8.2-alpha.1
+
+- 新增可选用户资料授权 scope `steam_account`；平台为当前版本启用该能力后，联网小程序可通过 `auth.login({ scopes: ['steam_account'] })` 申请当前用户的主绑定 SteamID64。
+- `AuthorizedUserInfo` 新增可选字段 `steam_id`：无网络小程序在能力启用且当前用户已绑定 Steam 时由 `user.getInfo()` 返回，未绑定时省略；联网小程序继续从开发者服务端 OpenAPI 获取用户资料。
+- `UserInfoAuthorization` 新增可选键 `steam_account`；未启用该能力的版本继续保持 `identity` 与 `profile` 两键及既有调用行为。
+
 ## 0.8.1 - 2026-09-18
 
 > 摘要：新增受管桌面程序、窗口尺寸与游戏绑定声明，开放移动端受控文件与流式下载，新增多设备开发日志与平台解析合同，并收敛网络凭据与调试权限边界。

package/README.md

@@ -64,7 +64,7 @@ async function getCurrentUser() {
 }
 ```
 
-`user.getInfo()` 不展示授权弹窗，也不要求可信用户手势。未登录时返回 `isHeyboxAppLoggedIn: false`；已登录时隐式授予当前本地用户 scopes（`identity`、`profile`），返回当前小程序隔离的 `app_user_id` 以及 `profile.nickname`、`profile.avatar`。
+`user.getInfo()` 不展示授权弹窗，也不要求可信用户手势。未登录时返回 `isHeyboxAppLoggedIn: false`；已登录时隐式授予当前本地用户 scopes（`identity`、`profile`），返回当前小程序隔离的 `app_user_id` 以及 `profile.nickname`、`profile.avatar`。平台为当前版本启用 Steam 账号能力且小程序未开通网络权限时，还会授予 `steam_account`，当前用户有主绑定时返回可选 `steam_id`，未绑定时省略。
 
 声明 `userInfo` 后，小程序可在按钮点击等明确的用户操作中调用 `auth.login()`：
 
@@ -80,7 +80,7 @@ async function loginFromUserAction() {
 }
 ```
 
-`auth.login()` 返回 `{ code, expiresIn: 300, scopes }`，其中 `identity` 隐式强制包含；它不返回 user、profile、`app_user_id` 或 token。页面只能把 code 交给开发者服务端，再由服务端按后端 OpenAPI 文档换取 token。它内部使用 Host 受信请求，不依赖公开 `network` 权限；示例中的 `network.request()` 本身仍需声明并获得 `network` 平台批准。完整边界见[用户身份与登录](https://docs.xiaoheihe.cn/hb_sdk/guide/auth)。
+`auth.login()` 返回 `{ code, expiresIn: 300, scopes }`，其中 `identity` 隐式强制包含；平台为当前版本启用 Steam 账号能力后，联网小程序可按需申请 `steam_account`。该调用不返回 user、profile、`steam_id`、`app_user_id` 或 token。页面只能把 code 交给开发者服务端，再由服务端按后端 OpenAPI 文档换取 token。它内部使用 Host 受信请求，不依赖公开 `network` 权限；示例中的 `network.request()` 本身仍需声明并获得 `network` 平台批准。完整边界见[用户身份与登录](https://docs.xiaoheihe.cn/hb_sdk/guide/auth)。
 
 用户可以在明确的按钮点击和二次确认后撤销当前小程序的授权：
 

package/dist/cli-chunks/{build-DPe1Ycjd.cjs → build-bVThH3Z5.cjs}

@@ -3,13 +3,13 @@
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-C2S34ldj.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DiTeD75Q.cjs');
 require('node:crypto');
 require('node:zlib');
 var runtimeGate = require('./runtime-gate-BWb8QIcX.cjs');
-var index = require('./index-CKIyipP9.cjs');
-var projectVite = require('./project-vite-Bd0WzAqQ.cjs');
-require('./version-0qwlEyZC.cjs');
+var index = require('./index-CDtcZVWv.cjs');
+var projectVite = require('./project-vite-CXgdzIYw.cjs');
+require('./version-QiVEs76a.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');

package/dist/cli-chunks/{context-BSUhAv3Z.cjs → context-DpKqGnjp.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var runtimePermissionEnv = require('./runtime-permission-env-C2S34ldj.cjs');
-var session = require('./session-zXVkHuhY.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DiTeD75Q.cjs');
+var session = require('./session-CIoBspg-.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');

package/dist/cli-chunks/{create-CaiKrGnb.cjs → create-BWC2343y.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-CKIyipP9.cjs');
+var index = require('./index-CDtcZVWv.cjs');
 require('node:module');
 require('os');
 require('node:crypto');

package/dist/cli-chunks/{dev-BG1o8Q-0.cjs → dev-t14YpHHY.cjs}

@@ -8,17 +8,17 @@ var net = require('node:net');
 var promises = require('node:dns/promises');
 var node_http = require('node:http');
 var node_module = require('node:module');
-var context = require('./context-BSUhAv3Z.cjs');
-var runtimePermissionEnv = require('./runtime-permission-env-C2S34ldj.cjs');
+var context = require('./context-DpKqGnjp.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DiTeD75Q.cjs');
 var undici = require('undici');
 var fs$1 = require('node:fs/promises');
-var index = require('./index-CKIyipP9.cjs');
+var index = require('./index-CDtcZVWv.cjs');
 var require$$0$1 = require('crypto');
 var require$$0 = require('buffer');
-var session = require('./session-zXVkHuhY.cjs');
+var session = require('./session-CIoBspg-.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var projectVite = require('./project-vite-Bd0WzAqQ.cjs');
-var version = require('./version-0qwlEyZC.cjs');
+var projectVite = require('./project-vite-CXgdzIYw.cjs');
+var version = require('./version-QiVEs76a.cjs');
 require('node:zlib');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -1950,8 +1950,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-BG1o8Q-0.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-BG1o8Q-0.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-t14YpHHY.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-t14YpHHY.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'),
@@ -11049,7 +11049,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-BPlpP-O0.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-BrJBaJWS.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;

package/dist/cli-chunks/{doctor-DutO2P5H.cjs → doctor-BWkrE0Hj.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-CKIyipP9.cjs');
+var index = require('./index-CDtcZVWv.cjs');
 require('node:module');
 require('node:fs');
 require('path');

package/dist/cli-chunks/{index-CKIyipP9.cjs → index-CDtcZVWv.cjs}

@@ -235,19 +235,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-CKIyipP9.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-CDtcZVWv.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-CKIyipP9.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-CDtcZVWv.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-CKIyipP9.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-CDtcZVWv.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-CKIyipP9.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-CDtcZVWv.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-CKIyipP9.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-CDtcZVWv.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13467,7 +13467,7 @@ function getPathname(pathWithQuery) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.8.1';
+const BUILT_CLI_VERSION = '0.8.2-alpha.2';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13828,39 +13828,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-C1JlLEza.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DRMl7nFH.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-C1JlLEza.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DRMl7nFH.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-C1JlLEza.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DRMl7nFH.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-DPe1Ycjd.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-bVThH3Z5.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-CaiKrGnb.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-BWC2343y.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-BG1o8Q-0.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-t14YpHHY.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-DutO2P5H.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-BWkrE0Hj.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunSkillInstallCommand = async (...args) => {
-    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-CCB3DyXk.cjs'); });
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-5labzuWk.cjs'); });
     return runSkillInstallCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-DTFEf3Dj.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-ibQybNiM.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{index-Bur0U2z1.cjs → index-D3FMcOZq.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index$2 = require('./index-CKIyipP9.cjs');
+var index$2 = require('./index-CDtcZVWv.cjs');
 var require$$0$3 = require('fs');
 var require$$0$2 = require('crypto');
 var require$$1$2 = require('path');
 var require$$0$5 = require('assert');
 var require$$0$4 = require('events');
 var require$$1$1 = require('util');
-var runtimePermissionEnv = require('./runtime-permission-env-C2S34ldj.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DiTeD75Q.cjs');
 var require$$0$7 = require('net');
 var require$$0$6 = require('url');
 var require$$2$1 = require('http');

package/dist/cli-chunks/{index.esm-BPlpP-O0.cjs → index.esm-BrJBaJWS.cjs}

@@ -11,8 +11,8 @@ var require$$0$4 = require('url');
 var require$$0 = require('zlib');
 var require$$0$1 = require('buffer');
 var require$$1 = require('util');
-var index = require('./index-CKIyipP9.cjs');
-var dev = require('./dev-BG1o8Q-0.cjs');
+var index = require('./index-CDtcZVWv.cjs');
+var dev = require('./dev-t14YpHHY.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');
@@ -27,11 +27,11 @@ require('node:os');
 require('node:net');
 require('node:dns/promises');
 require('node:http');
-require('./context-BSUhAv3Z.cjs');
-require('./runtime-permission-env-C2S34ldj.cjs');
-require('./version-0qwlEyZC.cjs');
+require('./context-DpKqGnjp.cjs');
+require('./runtime-permission-env-DiTeD75Q.cjs');
+require('./version-QiVEs76a.cjs');
 require('node:async_hooks');
-require('./session-zXVkHuhY.cjs');
+require('./session-CIoBspg-.cjs');
 require('fs');
 require('constants');
 require('undici');
@@ -41,7 +41,7 @@ require('node:buffer');
 require('node:url');
 require('node:util');
 require('node:child_process');
-require('./project-vite-Bd0WzAqQ.cjs');
+require('./project-vite-CXgdzIYw.cjs');
 require('node:zlib');
 
 var bufferUtil = {exports: {}};

package/dist/cli-chunks/{login-C1JlLEza.cjs → login-DRMl7nFH.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-zXVkHuhY.cjs');
+var session = require('./session-CIoBspg-.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-CKIyipP9.cjs');
+var index = require('./index-CDtcZVWv.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{project-vite-Bd0WzAqQ.cjs → project-vite-CXgdzIYw.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-CKIyipP9.cjs');
+var index = require('./index-CDtcZVWv.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-DTFEf3Dj.cjs → remote-ibQybNiM.cjs}

@@ -1,17 +1,17 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var index = require('./index-CKIyipP9.cjs');
-var session = require('./session-zXVkHuhY.cjs');
+var index = require('./index-CDtcZVWv.cjs');
+var session = require('./session-CIoBspg-.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 runtimePermissionEnv = require('./runtime-permission-env-C2S34ldj.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DiTeD75Q.cjs');
 var node_crypto = require('node:crypto');
 require('node:zlib');
 var runtimeGate = require('./runtime-gate-BWb8QIcX.cjs');
-var context = require('./context-BSUhAv3Z.cjs');
+var context = require('./context-DpKqGnjp.cjs');
 require('node:module');
 require('path');
 require('os');
@@ -24,7 +24,7 @@ require('buffer');
 require('util');
 require('fs');
 require('constants');
-require('./version-0qwlEyZC.cjs');
+require('./version-QiVEs76a.cjs');
 require('node:async_hooks');
 
 async function getCDNUploadInfo(options, runtime = {}) {
@@ -275,7 +275,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-Bur0U2z1.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-D3FMcOZq.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {