@heybox/hb-sdk 0.9.2-alpha.7 → 0.9.2-alpha.9

package/types/index.d.ts

@@ -207,7 +207,7 @@ interface PathRoot {
      * @see [FileHandle](/reference/symbols/root/interfaces/FileHandle) 查看创建、读写、状态与删除方法。
      * @see [文件能力与沙箱](/guide/files-and-sandbox) 路径、权限、Host operation 与配额说明。
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -276,7 +276,7 @@ interface PathRoot {
      * @see [DirectoryHandle](/reference/symbols/root/interfaces/DirectoryHandle) 查看 `create()`、`exists()`、`list()` 与 `remove()`。
      * @see [文件能力与沙箱](/guide/files-and-sandbox) 路径、权限、Host operation 与配额说明。
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -381,7 +381,7 @@ interface FileHandle {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -514,7 +514,7 @@ interface FileHandle {
      * @see [files.pickFiles()](/reference/sdk/files/pickFiles) 取得当前 session 的精确外部文件授权。
      * @see [文件能力与沙箱](/guide/files-and-sandbox) 查看权限、平台与 Host operation 说明。
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -676,7 +676,7 @@ interface FileHandle {
      * @see [files.saveFile()](/reference/sdk/files/saveFile) 让用户指定新的精确可写目标。
      * @see [文件能力与沙箱](/guide/files-and-sandbox) 查看路径、权限、平台与配额边界。
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -920,7 +920,7 @@ interface FileHandle {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -1105,7 +1105,7 @@ interface DirectoryHandle extends PathRoot {
      * @see [files.pickDirectory()](/reference/sdk/files/pickDirectory) 取得不可删除的外部目录授权。
      * @see [文件能力与沙箱](/guide/files-and-sandbox) 查看来源、权限、平台和错误码边界。
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -1386,7 +1386,7 @@ interface FilesModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -1473,7 +1473,7 @@ interface FilesModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -1559,7 +1559,7 @@ interface FilesModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -1894,7 +1894,7 @@ interface MiniProgramNetworkModule {
      * 返回到 SDK，默认触发 {@link HbMiniProgramNetworkError}，只有自定义 `validateStatus`
      * 接受时才 resolve。平台保留的 Runtime auth/OpenAPI 路径始终不能通过该能力访问。
      *
-     * 自 0.8.1-alpha.7 起公开 config 不再支持 `withCredentials`；JavaScript 仍传入时会被 SDK
+     * 自正式版 0.8.1 起公开 config 不再支持 `withCredentials`；JavaScript 仍传入时会被 SDK
      * 忽略且不报错，也不会把凭据开关传给 Host。原生 Cookie 是否随请求发送由 Host 按目标
      * 域名决定，iframe Cookie 不会由 SDK 自动读取；响应中的 `Set-Cookie` 与认证 Header 不会
      * 暴露给页面。应用显式 Header 仍必须遵守敏感信息边界。
@@ -1935,7 +1935,7 @@ interface MiniProgramNetworkModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.2.0-alpha.0
+     * @since 0.3.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -2029,7 +2029,7 @@ interface MiniProgramNetworkModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.0-alpha.2
+     * @since 0.8.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -2055,7 +2055,7 @@ interface MiniProgramNetworkModule {
      * @returns 标准化 HTTP 响应；默认仅 2xx resolve。
      * @throws HbMiniProgramNetworkError HTTP 状态未通过 validateStatus。
      * @throws HbMiniProgramSDKError 文件、参数、权限、传输或 Host 能力错误。
-     * @since 0.9.1-alpha.7
+     * @since 0.9.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -2291,7 +2291,7 @@ interface MiniProgramEnvironmentModule {
      * @see [getHandshakeState()](/reference/sdk/lifecycle/getHandshakeState) 同步检查持久握手状态。
      * @see [onHandshakeStateChange()](/reference/sdk/lifecycle/onHandshakeStateChange) 订阅当前状态及后续唯一一次迁移。
      *
-     * @since 0.8.1-alpha.2
+     * @since 0.8.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -2377,7 +2377,7 @@ interface MiniProgramEnvironmentModule {
      * @see [getHandshakeState()](/reference/sdk/lifecycle/getHandshakeState) 同步读取当前持久握手状态。
      * @see [onHandshakeStateChange()](/reference/sdk/lifecycle/onHandshakeStateChange) 立即接收当前状态并订阅唯一一次迁移。
      *
-     * @since 0.8.1-alpha.2
+     * @since 0.8.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -2497,7 +2497,7 @@ interface MiniProgramAuthModule {
      * 旧 Host 不支持时保留原错误；查询期间收到账号事件时抛 AUTHORIZATION_CONTEXT_CHANGED，
      * 调用方应保留较新的事件状态并按需重新读取。
      *
-     * @since 0.9.2-alpha.6
+     * @since 0.9.2
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -2590,7 +2590,7 @@ interface MiniProgramAuthModule {
      * @see [user.revokeAuthorization](https://docs.xiaoheihe.cn/hb_sdk/reference/sdk/user/revokeAuthorization)
      * @see [network.request](https://docs.xiaoheihe.cn/hb_sdk/reference/sdk/network/request)
      *
-     * @since 0.2.0-alpha.0
+     * @since 0.3.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -2842,7 +2842,7 @@ interface MiniProgramUserModule {
      * @see [用户身份与登录](/guide/auth)
      * @see [权限声明](/guide/permissions)
      *
-     * @since 0.2.0-alpha.0
+     * @since 0.3.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -2913,7 +2913,7 @@ interface MiniProgramUserModule {
      * @see [用户身份与登录](/guide/auth#撤销当前小程序授权)
      * @see [权限声明](/guide/permissions#无需声明的-api)
      *
-     * @since 0.7.0-alpha.1
+     * @since 0.7.0
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -3301,7 +3301,7 @@ interface MiniProgramShareModule {
      * @see {@link MiniProgramShareModule.showShareMenu | share.showShareMenu}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.7.4-alpha.5
+     * @since 0.7.4
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -3357,7 +3357,7 @@ interface MiniProgramShareModule {
      * @see {@link MiniProgramShareModule.screenshot | share.screenshot}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/recipes/community-share | 社区分享预置}
      *
-     * @since 0.7.4-alpha.5
+     * @since 0.7.4
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -3443,7 +3443,7 @@ interface MiniProgramShareModule {
      * @see [社区分享预置](/recipes/community-share)
      * @see [权限声明](/guide/permissions)
      *
-     * @since 0.2.0-alpha.0
+     * @since 0.3.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -3544,7 +3544,7 @@ interface MiniProgramShareModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/recipes/community-share | 社区分享预置}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.2.0-alpha.0
+     * @since 0.3.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -3715,7 +3715,7 @@ interface MiniProgramViewportModule {
      * if (!result.supported) console.log('Host 不支持原生展示设置')
      * ```
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.3
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -3766,7 +3766,7 @@ interface MiniProgramViewportModule {
      * @see {@link MiniProgramViewportModule.setNavigationBarStyle}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/window-size/ | 窗口尺寸与可缩放性}
      *
-     * @since 0.2.0-alpha.0
+     * @since 0.3.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -3855,7 +3855,7 @@ interface WorkspaceCardsModule {
     /**
      * 合并刷新当前小程序活动 Controller，返回进入调度的实例数。
      *
-     * @since 0.9.0-alpha.0
+     * @since 0.9.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -3867,7 +3867,7 @@ interface WorkspaceCardsModule {
     /**
      * 读取最近一次卡片启动上下文；普通启动或账号变化后为空。
      *
-     * @since 0.9.0-alpha.0
+     * @since 0.9.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -3877,7 +3877,7 @@ interface WorkspaceCardsModule {
     /**
      * 立即回放当前上下文，并订阅后续变化。按 launchId 去重业务启动。
      *
-     * @since 0.9.0-alpha.0
+     * @since 0.9.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -4552,7 +4552,7 @@ interface MiniProgramCloudStorageModule {
     /** 读取原始字符串，不存在返回 undefined，空字符串正常返回。key 仅支持 1–128 位字母、数字、下划线和连字符。
      * @throws HbMiniProgramSDKError 参数错误、权限不足、登录失效或请求失败时拒绝 Promise。
      *
-     * @since 0.9.1-alpha.4
+     * @since 0.9.2
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -4570,7 +4570,7 @@ interface MiniProgramCloudStorageModule {
      * 不同 key 独立提交，同 key 请求串行；删除隔开窗口，不跨删除合并写入。
      * 版本由 Runtime 管理；冲突返回 VERSION_CONFLICT。失败时拒绝同 key 已排队操作，需重新读取，不自动覆盖重试。
      *
-     * @since 0.9.1-alpha.4
+     * @since 0.9.2
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -4584,7 +4584,7 @@ interface MiniProgramCloudStorageModule {
      */
     setStorage(key: string, value: string): Promise<void>;
     /** 删除整个键值记录；不存在也视为成功，与同 key 的写入保持调用顺序。
-     * @since 0.9.1-alpha.4
+     * @since 0.9.2
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -4598,7 +4598,7 @@ interface MiniProgramCloudStorageModule {
      */
     removeItem(key: string): Promise<void>;
     /** 返回当前用户在当前小程序下全部 key，不暴露数量、配额和内部版本。
-     * @since 0.9.1-alpha.4
+     * @since 0.9.2
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -4851,7 +4851,7 @@ interface CompanionStdio {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -5021,7 +5021,7 @@ interface CompanionStdio {
      * @see {@link MiniProgramCompanionModule.getActiveSession | companion.getActiveSession} 恢复活动 Session controller。
      * @see [受管桌面程序](/guide/companion) 查看 stdio framing、重放与恢复流程。
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -5232,7 +5232,7 @@ interface CompanionAttachments {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/error-handling | 错误处理}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -5437,7 +5437,7 @@ interface CompanionSession {
      * @see {@link MiniProgramCompanionModule.getActiveSession | companion.getActiveSession} 恢复活动 Session controller。
      * @see [受管桌面程序](/guide/companion) 查看 Session、stdio 与进程树生命周期。
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -5734,7 +5734,7 @@ interface CompanionSession {
      * @see {@link CompanionStdio.write | CompanionStdio.write()} 发送业务协议命令。
      * @see [受管桌面程序](/guide/companion) 查看 ownership、Session 与恢复流程。
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -5801,7 +5801,7 @@ interface MiniProgramCompanionModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/companion | 受管桌面程序}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -5879,7 +5879,7 @@ interface MiniProgramCompanionModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/companion | 受管桌面程序}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -5979,7 +5979,7 @@ interface MiniProgramCompanionModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/companion | 受管桌面程序}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -6039,7 +6039,7 @@ interface MiniProgramCompanionModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/companion | 受管桌面程序}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -6138,7 +6138,7 @@ interface MiniProgramCompanionModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/companion | 受管桌面程序}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -6219,7 +6219,7 @@ interface MiniProgramCompanionModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/companion | 受管桌面程序}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.8.1-alpha.4
+     * @since 0.8.1
      * @hbPlatform windows
      * @hbPlatform macos
      * @hbClient windows none
@@ -6339,7 +6339,7 @@ interface MiniProgramStorageModule {
      * @see {@link MiniProgramStorageModule.setStorage | storage.setStorage}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.2.0-alpha.0
+     * @since 0.3.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -6401,7 +6401,7 @@ interface MiniProgramStorageModule {
      * @see {@link MiniProgramStorageModule.getStorage | storage.getStorage}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      *
-     * @since 0.2.0-alpha.0
+     * @since 0.3.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -6936,7 +6936,7 @@ interface MiniProgramDeviceModule {
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/guide/permissions | 权限声明}
      * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/sdk/navigation/openAppPage | navigation.openAppPage}
      *
-     * @since 0.9.1-alpha.4
+     * @since 0.9.1
      * @hbPlatform android
      * @hbPlatform ios
      * @hbPlatform ohos
@@ -7424,7 +7424,7 @@ interface MiniProgramNavigationModule {
  * @see [on('ready')](/reference/sdk/lifecycle/on) 不可重放的生命周期边沿事件。
  * @see [environment.getInfoSync()](/reference/sdk/environment/getInfoSync) 在 `ready` 后同步读取环境快照。
  *
- * @since 0.7.0-alpha.9
+ * @since 0.7.0
  * @hbPlatform android
  * @hbPlatform ios
  * @hbPlatform ohos
@@ -7517,7 +7517,7 @@ declare function getHandshakeState(): MiniProgramSDKHandshakeState;
  * @see [environment.getInfoSync()](/reference/sdk/environment/getInfoSync) 在 `ready` handler 中同步读取环境。
  * @see [事件与生命周期](/guide/lifecycle) 握手与普通生命周期事件的使用建议。
  *
- * @since 0.7.0-alpha.9
+ * @since 0.7.0
  * @hbPlatform android
  * @hbPlatform ios
  * @hbPlatform ohos
@@ -7610,7 +7610,7 @@ declare function onHandshakeStateChange(handler: MiniProgramSDKHandshakeStateHan
  * @see [onHandshakeStateChange()](/reference/sdk/lifecycle/onHandshakeStateChange) 订阅会立即回放的握手状态。
  * @see [事件与生命周期](/guide/lifecycle) 生命周期时机与清理建议。
  *
- * @since 0.2.0-alpha.0
+ * @since 0.3.1
  * @hbPlatform android
  * @hbPlatform ios
  * @hbPlatform ohos
@@ -7677,7 +7677,7 @@ declare function on<T extends MiniProgramEventName>(eventName: T, handler: MiniP
  * @see [onHandshakeStateChange()](/reference/sdk/lifecycle/onHandshakeStateChange) 订阅会立即回放的握手状态。
  * @see [事件与生命周期](/guide/lifecycle) 生命周期事件列表与清理建议。
  *
- * @since 0.2.0-alpha.0
+ * @since 0.3.1
  * @hbPlatform android
  * @hbPlatform ios
  * @hbPlatform ohos

package/types/miniapp-publish/index.d.ts

@@ -9,6 +9,7 @@ type MiniappCategory = 'tool' | 'game' | 'other';
  * @param sourceLabel - 错误消息中的字段来源，默认 `package.json#heybox.category`。
  * @returns 合法类别原值；输入 `undefined` 时返回 `undefined`，由发布流程另行检查是否必填。
  * @throws `Error` 输入为其他值（包括 null 或空字符串）时抛出带字段来源的错误。
+ * @since 0.8.3
  */
 declare function parseMiniappCategory(value: unknown, sourceLabel?: string): MiniappCategory | undefined;
 
@@ -200,6 +201,7 @@ interface MiniappManifest {
  *
  * @see {@link resolveMiniappManifestPlatforms}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/vite/functions/miniappManifest | miniappManifest}
+ * @since 0.3.1
  */
 declare function isValidMiniappManifestVersion(version: string): boolean;
 /**
@@ -211,6 +213,7 @@ declare function isValidMiniappManifestVersion(version: string): boolean;
  * @remarks
  * 不修改输入对象，不执行文件 I/O；不会验证图片/归档是否存在、内容摘要是否匹配，也不查询远端发布资格。
  * 成功仅表示 Manifest 字段通过校验，不能替代文件检查与服务端发布预检。
+ * @since 0.8.2
  */
 declare function validateMiniappManifestForDeploy(manifest: MiniappManifest): {
     desc?: string | undefined;
@@ -334,6 +337,7 @@ interface MiniappPlatformResolution {
  * @see {@link MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/miniapp-publish/functions/isValidVersion | isValidVersion}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/vite/functions/miniappManifest | miniappManifest}
+ * @since 0.8.1
  */
 declare function resolveMiniappManifestPlatforms(sdkVersion: string | undefined, manifest: unknown): MiniappPlatformResolution;
 
@@ -403,6 +407,7 @@ interface ParseMiniappBindAppIdsOptions {
  * @see [miniappManifest](/reference/symbols/vite/functions/miniappManifest)
  * @see [navigation.openAppPage](/reference/sdk/navigation/openAppPage)
  * @see [CLI 与远端发布](/guide/cli#生产构建)
+ * @since 0.8.1
  */
 declare function parseMiniappBindAppIds(value: unknown, options?: ParseMiniappBindAppIdsOptions): readonly string[];
 
@@ -422,6 +427,7 @@ interface MiniappBasicInfo {
  * @returns NFKC 规范化、去除首尾 Unicode White_Space 后的名称；不折叠规范化后的内部空白。
  * @throws `Error` 输入不是字符串，或规范化后不是 1–40 个 Unicode code point、不含文字或数字，或包含控制字符、
  * 格式字符、行/段分隔符以及 HTML 特殊字符 `<`、`>`、`&`、双引号或单引号时抛出。
+ * @since 0.8.2
  */
 declare function normalizeBasicInfoName(raw: unknown): string;
 /**
@@ -434,6 +440,7 @@ declare function normalizeBasicInfoName(raw: unknown): string;
  * @remarks
  * 图片路径必须使用 `/` 分隔的非空相对路径，扩展名为 JPEG、PNG、GIF 或 WebP；拒绝 URL、点段、
  * 控制字符和构建/缓存等保留目录。此函数只校验声明，不读取文件，也不验证图片字节、尺寸或存在性。
+ * @since 0.8.2
  */
 declare function parseMiniappBasicInfo(value: Record<string, unknown>, sdkVersion?: string): MiniappBasicInfo | undefined;
 
@@ -465,6 +472,7 @@ declare function parseMiniappBasicInfo(value: Record<string, unknown>, sdkVersio
  *   }
  * }
  * ```
+ * @since 0.8.2
  */
 declare function previewMiniappBasicInfo(manifest: Record<string, unknown>, files: readonly {
     relativePath: string;
@@ -481,9 +489,23 @@ declare function previewMiniappBasicInfo(manifest: Record<string, unknown>, file
  * @param html - 待检查的完整 HTML 文本，使用 HTML parser 解析。
  * @returns Gate、隐藏样式及 bootstrap 标记均出现时返回 `true`，否则返回 `false`。
  * @remarks 只识别标记，不验证脚本内容、标记所在节点或宿主握手；不能据此判断页面安全或实际可运行。
+ * @since 0.8.2
  */
 declare function hasMiniappRuntimeGate(html: string): boolean;
 
+/** 小程序资料缺失的非阻断提示；调用方应先完成字段格式校验。 */
+interface MiniappMetadataWarning {
+    code: 'MINIAPP_DESC_MISSING' | 'MINIAPP_TOOL_GAME_BINDING_MISSING';
+    field: 'desc' | 'bindAppIds';
+    message: string;
+}
+/** 根据当前项目声明或实际版本 Manifest 检查资料完整性，不联网、不修改输入。 */
+declare function getMiniappMetadataWarnings(metadata: {
+    desc?: unknown;
+    category?: unknown;
+    bindAppIds?: unknown;
+}): MiniappMetadataWarning[];
+
 /** CDN 上传接口使用的小程序产物业务 scope。 */
 declare const MINIAPP_UPLOAD_SCOPE = "activity";
 /** 完整 CDN 上传 key 的默认长度上限；旧固定版本流程按字符计数，上传会话流程按 UTF-8 bytes 计数。 */
@@ -561,6 +583,7 @@ declare const LIST_USER_MINIPROGRAM_VERSION_API_PATH = "/mall/developer/user_min
  * @see {@link relativePathContainsNodeModulesSegment}
  * @see {@link shouldUploadDistFile}
  * @see {@link https://docs.xiaoheihe.cn/hb_sdk/reference/symbols/protocol/functions/isMiniProgramRelativePath | isMiniProgramRelativePath}
+ * @since 0.3.1
  */
 declare function normalizeRelativePath(relativePath: string): string;
 /**
@@ -586,6 +609,7 @@ declare function normalizeRelativePath(relativePath: string): string;
  * @see [normalizeRelativePath](/reference/symbols/miniapp-publish/functions/normalizeRelativePath)
  * @see [shouldUploadDistFile](/reference/symbols/miniapp-publish/functions/shouldUploadDistFile)
  * @see [miniapp-publish](/reference/miniapp-publish/)
+ * @since 0.3.1
  */
 declare function relativePathContainsNodeModulesSegment(relativePath: string): boolean;
 /**
@@ -601,64 +625,6 @@ declare function relativePathContainsNodeModulesSegment(relativePath: string): b
  * ```
  */
 declare function getMiniProgramUploadAlias(miniProgramId: string): string;
-/** 生成旧版固定版本上传 key 所需的输入。 */
-interface MiniappUploadKeyInput {
-    /** 小程序 ID；函数会将其转换为稳定上传别名。 */
-    miniProgramId: string;
-    /** 要写入上传 key 的版本字符串；调用方应先完成版本合法性校验。 */
-    version: string;
-    /** 构建产物相对路径；生成 key 前会整理路径分隔符。 */
-    relativePath: string;
-}
-/**
- * 生成旧版固定版本 CDN 上传 key。
- *
- * @param input - 小程序 ID、版本和构建产物相对路径。
- * @returns `/u/{alias}/{version}/{relativePath}` 形式的上传 key。
- * @remarks 此函数不会校验版本、路径安全性或 key 长度；批量上传前应调用 {@link validateUploadPaths}。
- * @example
- * ```ts
- * getMiniappUploadKey({
- *   miniProgramId: 'mp_example',
- *   version: '1.2.3',
- *   relativePath: 'assets\\app.js',
- * }); // /u/<alias>/1.2.3/assets/app.js
- * ```
- */
-declare function getMiniappUploadKey(input: MiniappUploadKeyInput): string;
-/** 参与旧版上传路径校验的构建产物条目。 */
-interface UploadPathItem {
-    /** 构建产物相对路径。 */
-    relativePath: string;
-}
-/** 旧版固定版本上传路径的校验选项。 */
-interface ValidateUploadPathsOptions {
-    /** 小程序 ID，用于计算上传 key 中的稳定别名。 */
-    miniProgramId: string;
-    /** 要写入上传 key 的版本字符串。 */
-    version: string;
-    /** 完整上传 key 的最大字符数，默认 {@link ACTIVITY_UPLOAD_KEY_MAX_LENGTH}。 */
-    maxLength?: number;
-}
-/**
- * 校验旧版固定版本上传路径的格式、唯一性和完整 key 长度。
- *
- * @param items - 待上传条目；按数组顺序检查。
- * @param options - 小程序 ID、版本和可选的 key 长度上限。
- * @returns 第一个校验错误的中文提示；全部合法时返回 `undefined`。
- * @remarks
- * 路径会先统一分隔符，因此 `assets\\app.js` 与 `assets/app.js` 视为重复。
- * 长度按 JavaScript 字符串 `length` 计算；上传会话的 UTF-8 字节限制应使用 {@link validateMiniappUploadPathLengths}。
- * @example
- * ```ts
- * const error = validateUploadPaths(
- *   [{ relativePath: 'index.html' }, { relativePath: 'assets/app.js' }],
- *   { miniProgramId: 'mp_example', version: '1.2.3' },
- * );
- * if (error) throw new Error(error);
- * ```
- */
-declare function validateUploadPaths(items: UploadPathItem[], options: ValidateUploadPathsOptions): string | undefined;
 /**
  * 参与上传总大小计算的构建产物条目。
  *
@@ -746,6 +712,7 @@ interface ValidateUploadTotalSizeOptions {
  * @see {@link ValidateUploadTotalSizeOptions}
  * @see [shouldUploadDistFile](/reference/symbols/miniapp-publish/functions/shouldUploadDistFile)
  * @see [miniapp-publish](/reference/miniapp-publish/)
+ * @since 0.4.7
  */
 declare function validateUploadTotalSize(items: UploadSizeItem[], options?: ValidateUploadTotalSizeOptions): "构建产物总大小超过 100MB，请删除未引用资源或压缩图片后重新 deploy" | undefined;
 /**
@@ -820,6 +787,7 @@ declare function validateMiniappUploadSizeBudgets(items: UploadSizeItem[], optio
  * @see [relativePathContainsNodeModulesSegment](/reference/symbols/miniapp-publish/functions/relativePathContainsNodeModulesSegment)
  * @see [validateUploadTotalSize](/reference/symbols/miniapp-publish/functions/validateUploadTotalSize)
  * @see [miniapp-publish](/reference/miniapp-publish/)
+ * @since 0.3.1
  */
 declare function shouldUploadDistFile(relativePath: string): boolean;
 /**
@@ -1006,5 +974,5 @@ declare const LIST_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH = "/mall/dev
 /** 提交不绑定版本的平台权限申请。 */
 declare const SUBMIT_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH = "/mall/developer/user_miniprogram/runtime_permission/application_submit";
 
-export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, CREATE_USER_MINIPROGRAM_API_PATH, CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, CREATE_USER_MINIPROGRAM_LOCAL_DEV_LAUNCH_TOKEN_API_PATH, DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DETAIL_USER_MINIPROGRAM_API_PATH, DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DEVELOPER_ENTITY_LIST_API_PATH, DEVELOPER_ENTITY_SWITCH_API_PATH, LIST_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH, LIST_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH, LIST_USER_MINIPROGRAM_VERSION_API_PATH, MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES, MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES, MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION, MINIAPP_UPLOAD_BATCH_SIZE, MINIAPP_UPLOAD_SCOPE, MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES, PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH, RELEASE_USER_MINIPROGRAM_VERSION_API_PATH, REOPEN_USER_MINIPROGRAM_API_PATH, SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH, SUBMIT_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH, TAKE_DOWN_USER_MINIPROGRAM_API_PATH, UPDATE_SQUARE_DISPLAY_API_PATH, UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_ACCESS_STATUS_API_PATH, USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH, WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH, createMiniappArtifactFileHeader, createMiniappArtifactSignatureHeader, getMiniProgramUploadAlias, getMiniappUploadKey, hasMiniappRuntimeGate, isValidMiniappManifestVersion as isValidVersion, normalizeBasicInfoName, normalizeRelativePath, parseMiniappBasicInfo, parseMiniappBindAppIds, parseMiniappCategory, prepareMiniappArtifactFiles, previewMiniappBasicInfo, relativePathContainsNodeModulesSegment, resolveMiniappManifestPlatforms, resolveMiniappUploadSessionFiles, shouldUploadDistFile, validateMiniappCompanionFileReceipts, validateMiniappManifestForDeploy, validateMiniappUploadPathLengths, validateMiniappUploadSizeBudgets, validateMiniappWorkspaceCardFileReceipts, validateUploadPaths, validateUploadTotalSize };
-export type { MiniappArtifactFile, MiniappArtifactFileReceipt, MiniappBasicInfo, MiniappCategory, MiniappCompanionCapability, MiniappCompanionManifestDeclarations, MiniappCompanionManifestDefinition, MiniappCompanionManifestTarget, MiniappCompanionTarget, MiniappManifest, MiniappPermissionDeclarations, MiniappPlatformPolicy, MiniappPlatformResolution, MiniappReusedCompanionFile, MiniappUploadKeyInput, MiniappUploadSessionFile, MiniappWindowDeclaration, NetworkMiniappPermissionDeclaration, ParseMiniappBindAppIdsOptions, SimpleMiniappPermissionDeclaration, UploadPathItem, UploadSizeItem, ValidateUploadPathsOptions, ValidateUploadTotalSizeOptions };
+export { ACTIVITY_UPLOAD_KEY_MAX_LENGTH, CREATE_USER_MINIPROGRAM_API_PATH, CREATE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, CREATE_USER_MINIPROGRAM_LOCAL_DEV_LAUNCH_TOKEN_API_PATH, DELETE_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DETAIL_USER_MINIPROGRAM_API_PATH, DETAIL_USER_MINIPROGRAM_LEADERBOARD_API_PATH, DEVELOPER_ENTITY_LIST_API_PATH, DEVELOPER_ENTITY_SWITCH_API_PATH, LIST_USER_MINIPROGRAM_API_PATH, LIST_USER_MINIPROGRAM_LEADERBOARD_API_PATH, LIST_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH, LIST_USER_MINIPROGRAM_VERSION_API_PATH, MINIAPP_COMPANION_UPLOAD_TEMPORARY_SIZE_LIMIT_BYTES, MINIAPP_LEGACY_DEFAULT_PLATFORM_VALUES, MINIAPP_LEGACY_MOBILE_PLATFORM_VALUES, MINIAPP_PLATFORM_HARD_CUT_SDK_VERSION, MINIAPP_UPLOAD_BATCH_SIZE, MINIAPP_UPLOAD_SCOPE, MINIAPP_UPLOAD_TOTAL_SIZE_LIMIT_BYTES, PRECHECK_USER_MINIPROGRAM_VERSION_API_PATH, RELEASE_USER_MINIPROGRAM_VERSION_API_PATH, REOPEN_USER_MINIPROGRAM_API_PATH, SUBMIT_USER_MINIPROGRAM_AUDIT_API_PATH, SUBMIT_USER_MINIPROGRAM_PERMISSION_APPLICATION_API_PATH, TAKE_DOWN_USER_MINIPROGRAM_API_PATH, UPDATE_SQUARE_DISPLAY_API_PATH, UPDATE_USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_ACCESS_STATUS_API_PATH, USER_MINIPROGRAM_PREVIEW_ALLOWLIST_API_PATH, USER_MINIPROGRAM_VERSION_PREVIEW_INFO_API_PATH, WITHDRAW_USER_MINIPROGRAM_VERSION_API_PATH, createMiniappArtifactFileHeader, createMiniappArtifactSignatureHeader, getMiniProgramUploadAlias, getMiniappMetadataWarnings, hasMiniappRuntimeGate, isValidMiniappManifestVersion as isValidVersion, normalizeBasicInfoName, normalizeRelativePath, parseMiniappBasicInfo, parseMiniappBindAppIds, parseMiniappCategory, prepareMiniappArtifactFiles, previewMiniappBasicInfo, relativePathContainsNodeModulesSegment, resolveMiniappManifestPlatforms, resolveMiniappUploadSessionFiles, shouldUploadDistFile, validateMiniappCompanionFileReceipts, validateMiniappManifestForDeploy, validateMiniappUploadPathLengths, validateMiniappUploadSizeBudgets, validateMiniappWorkspaceCardFileReceipts, validateUploadTotalSize };
+export type { MiniappArtifactFile, MiniappArtifactFileReceipt, MiniappBasicInfo, MiniappCategory, MiniappCompanionCapability, MiniappCompanionManifestDeclarations, MiniappCompanionManifestDefinition, MiniappCompanionManifestTarget, MiniappCompanionTarget, MiniappManifest, MiniappMetadataWarning, MiniappPermissionDeclarations, MiniappPlatformPolicy, MiniappPlatformResolution, MiniappReusedCompanionFile, MiniappUploadSessionFile, MiniappWindowDeclaration, NetworkMiniappPermissionDeclaration, ParseMiniappBindAppIdsOptions, SimpleMiniappPermissionDeclaration, UploadSizeItem, ValidateUploadTotalSizeOptions };