@heybox/hb-sdk 0.8.4 → 0.9.0-alpha.0

package/CHANGELOG.md

@@ -2,6 +2,48 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 0.9.0-alpha.0 - 2026-10-06
+
+> 影响级别：常规
+> 开发者动作：升级至 `0.9.0-alpha.0` 并重新运行 `hb-sdk dev`；运行期间在后台调整权限后，请重启 CLI 同步。
+> 兼容范围：公开 SDK API 不变；调整本地真实客户端调试的详情读取与启动票可用条件。
+
+### 行为调整
+
+- `hb-sdk dev` 只在启动、绑定或权限声明变化时读取远端详情；手机重连复用成功快照，票据续签不再触发详情轮询。
+- 权限校验期间或失败后，真实客户端启动票暂停提供；更新声明并校验成功或重启 CLI 后恢复。
+
+### 问题修复
+
+- 修复仅修改小程序绑定时未触发详情校验的问题。
+- 修复声明连续变化时，旧详情、产物摘要或启动票覆盖最新调试状态的问题。
+- 修复详情校验失败后仍能通过本地启动入口获取续签票据的问题。
+
+## 0.8.5 - 2026-10-02
+
+> 影响级别：必须操作
+> 开发者动作：使用手机真机调试时升级至 `0.8.5` 并重新运行 `hb-sdk dev`；小程序代码中依赖旧错误码的失败分支需按新的 `RATE_LIMITED` / `RATE_LIMITED_BY_RUNTIME` 调整。
+> 兼容范围：公开 SDK API 形状与权限模型不变；小程序接口遇到平台限流时的错误码由 `REQUEST_FAILED` / `UNAUTHORIZED` 统一为 `RATE_LIMITED`，属有意的行为变更。Runtime 私有接口以外的公开网络能力不受影响。
+
+### 必须操作
+
+- 小程序接口遇到平台限流（HTTP 403/429）时返回的错误码统一为 `RATE_LIMITED`：错误数据里的 `status` 为上游状态码，`retryAfterMs`（可能缺失）为建议退避时长。此前分别返回 `REQUEST_FAILED`（auth / user / home_v2）或 `UNAUTHORIZED`（cloud.leaderboard，401 仍为 `UNAUTHORIZED`）。
+- 新增本地拒绝错误码 `RATE_LIMITED_BY_RUNTIME`：Runtime 自身的每 session 配额与同一接口的循环检测触发时返回，错误数据里的 `origin` 为 `budget` 或 `loop`，请求不会到达上游。遇到上述两个错误码时请停止立即重试，避免把用户 IP 打成被封。
+
+### 行为调整
+
+- `user.getInfo()` / `auth.login()` / 排行榜接口 的同一份结果会在短时间内复用（身份 30s、资料 60s、榜单沿用既有 5 分钟）。账号切换与授权撤销会立即失效；Steam 换绑 / 解绑最多 30s 后生效。
+- `hb-sdk dev` 会短暂复用已读取的调试信息，并在读取失败后逐步延长重试间隔，不再持续请求远端。
+- 被平台限流时会暂停刷新并给出预计恢复时间，提示不要反复重启。
+
+### 问题修复
+
+- 修复手机真机调试反复重连时持续请求远端调试信息、进而触发平台限流的问题。
+
+### 文档与工具
+
+- 被平台限流时提示升级到最新版本。
+
 ## 0.8.4 - 2026-09-25
 
 > 影响级别：常规

package/dist/cli-chunks/{build-DgV-or9j.cjs → build-Dv5vWsBh.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-9GWrfOTi.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DR89buKQ.cjs');
 require('node:crypto');
 require('node:zlib');
-var runtimeGate = require('./runtime-gate-PxUnfrPH.cjs');
-var index = require('./index-CO8AEaXW.cjs');
-var projectVite = require('./project-vite-Dw04aEsD.cjs');
-require('./version-Bk5ehprU.cjs');
+var runtimeGate = require('./runtime-gate-DkTbgx4d.cjs');
+var index = require('./index-Dd_eGaDz.cjs');
+var projectVite = require('./project-vite-ckDtbYtt.cjs');
+require('./version-CJ7rfbl-.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');

package/dist/cli-chunks/{context-DlcETCGM.cjs → context-B15FzPf9.cjs}

@@ -3,10 +3,10 @@
 var node_crypto = require('node:crypto');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var runtimePermissionEnv = require('./runtime-permission-env-9GWrfOTi.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-DR89buKQ.cjs');
 var fs$1 = require('node:fs');
 var sharp = require('sharp');
-var session = require('./session-CRiCQkg-.cjs');
+var session = require('./session-BiT-5VHK.cjs');
 
 async function inspectBasicInfoImage(bytes, sourcePath, kind) {
     const inspected = await inspectDecodedBasicInfoImage(bytes, kind);

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