@heybox/hb-sdk 0.9.0-alpha.10 → 0.9.0-alpha.11

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-BmiQPZvl.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-CHZKVQmQ.js">
+    <script type="module" crossorigin src="/assets/index-BFo1WsAS.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-C5zbtSPU.js">
     <link rel="stylesheet" crossorigin href="/assets/index-B5aFVoao.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -1342,7 +1342,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.0-alpha.10';
+    : '0.9.0-alpha.11';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);

package/dist/index.esm.js

@@ -1338,7 +1338,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.0-alpha.10';
+    : '0.9.0-alpha.11';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);

package/dist/vite.cjs.js

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

package/dist/vite.esm.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.0-alpha.10",
+  "version": "0.9.0-alpha.11",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -65,7 +65,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.9.0-alpha.10"
+    "@heybox/hb-sdk-protocol": "0.9.0-alpha.11"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -117,12 +117,12 @@
     "vite": "^8.0.12",
     "vitest": "^3.2.4",
     "@heybox-domain/heybox-theme": "~0.1.0",
-    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
     "@heybox/hb-api": "~1.28.10",
-    "@heybox/hb-sdk-runtime": "~0.9.0-alpha.10",
+    "@heybox-domain/heybox-vue3-ui": "~0.1.0",
+    "@heybox/hb-sdk-runtime": "~0.9.0-alpha.11",
     "@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.0-alpha.10+skill.aa24d6656331",
+  "skillVersion": "0.9.0-alpha.11+skill.aa24d6656331",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.0-alpha.10",
-    "compatibility": "0.9.0-alpha.10"
+    "version": "0.9.0-alpha.11",
+    "compatibility": "0.9.0-alpha.11"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.0-alpha.10",
+    "version": "0.9.0-alpha.11",
     "path": "skill"
   },
   "integrity": "sha256-aa24d6656331cbad8f6aae7735258a49d7f1a82f6e900415de53a1b93a30ddb8"

package/types/modules/files/types.d.ts

@@ -1315,9 +1315,11 @@ export interface FilesModule {
      * 的 picker / `saveFile()` direct handle 共享 1024 上限，每个返回文件占用一个。
      *
      * `read` File 可调用 `readText()`、`readBytes()`、`exists()` 与 `stat()`；写入、创建及作为
-     * 下载替换目标需要 `readwrite`。外部精确 File 无论 mode 都不能删除。Android `1.3.396+`
-     * 的精确 SAF 文件只支持只读选择，请求 `readwrite` 会返回 `FILE_ACCESS_DENIED`；其他平台也
-     * 以 Host 实际授予结果为准。
+     * 下载替换目标需要 `readwrite`。外部精确 File 无论 mode 都不能删除。Android 已适配客户端
+     * 支持精确 SAF 文件的 `readwrite` 选择，需系统返回写入授权；较早客户端仍会拒绝该模式。
+     * `writeText()` / `writeBytes()` 先暂存完整内容再写入，最终 Provider 写入不是原子替换，
+     * 失败时原文件可能为空或只写入部分内容。该授权不支持 `network.download()` 的原子替换。
+     * 未指定模式时仍为只读；用户或 Provider 未授予写入权限时返回 `FILE_ACCESS_DENIED`。
      *
      * 新 PC Host 支持文件选择；Android/iOS 需要 `1.3.396+`，移动端继续以 `system.describe`
      * 实际声明的 operation 为准；OHOS 同样按 Host 宣告能力启用。Web、Browser Dev Host、旧 Host
@@ -1407,6 +1409,12 @@ export interface FilesModule {
      * {@link FileSystem.directory | files.sandbox.directory} 不打开选择器、无需用户手势、持久按
      * Mini-program 隔离，也不占用该 direct-handle 配额。
      *
+     * 鸿蒙手机和平板的单目录选择需要系统 API 26.0.0 或以上；较早系统需具备
+     * `SystemCapability.FileManagement.UserFileService.FolderSelection` 能力。
+     * 同时要求当前客户端已适配并开放目录选择，不支持时抛出 `METHOD_FORBIDDEN`。
+     * 不具备上述能力的 API 24 鸿蒙手机无法选择外部目录，声明 `filesystem` 或升级编译 SDK
+     * 不会解除限制。单文件读写或导出可分别使用 `pickFiles()`、`saveFile()`，不授予父目录权限。
+     *
      * 新 PC Host 支持目录选择；Android/iOS 需要 `1.3.396+`，移动端继续以 `system.describe`
      * 实际声明的 operation 为准；OHOS 同样按 Host 宣告能力启用。Web、Browser Dev Host、旧 Host
      * 或 operation 集不完整时 fail closed，不提供 Blob/内存 fallback。页面代码不应按操作系统
@@ -1486,7 +1494,12 @@ export interface FilesModule {
      * 创建空文件；同名目标返回 `FILE_ALREADY_EXISTS`。其他 Host 可以展示平台原生保存界面，
      * 但成功结果仍只授权最终精确 File，且不能通过该 API 请求静默覆盖。
      *
-     * 新 PC 与 iOS Host 支持该能力；Android 不提供 `files.saveFile`。OHOS 按 Host 实际宣告的
+     * Android 已适配客户端支持 `files.saveFile`，系统保存器返回精确 SAF 文件授权，不授予
+     * 父目录权限。`writeText()` / `writeBytes()` 先暂存完整内容，再写入该目标；最终 Provider
+     * 写入不是原子替换，失败时目标可能为空或部分写入，原内容不保证保留。该授权不支持
+     * `network.download()` 的原子替换，导出请调用文件代理的写入方法。
+     *
+     * 新 PC、Android 与 iOS Host 支持该能力。OHOS 按 Host 实际宣告的
      * operation 启用。Web、Browser Dev Host、旧 Host 或 operation 集不完整时 fail closed，不
      * 提供 Blob/内存 fallback。页面代码不应仅按操作系统判断，应处理 `METHOD_FORBIDDEN`。
      *
@@ -1520,10 +1533,12 @@ export interface FilesModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
      * @since 0.8.0-alpha.2
+     * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
      * @hbPlatform windows
      * @hbPlatform macos
+     * @hbClient android numeric-dot \>= 1.3.396
      * @hbClient ios numeric-dot \>= 1.3.396
      * @hbClient ohos none
      * @hbClient windows none