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

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 本文件随 `@heybox/hb-sdk` npm 包公开分发，只记录外部小程序开发者可观察到的变化。
 
+## 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
+
+> 影响级别：常规
+> 开发者动作：使用手机真机调试时升级至 `0.8.4` 并重新运行 `hb-sdk dev`。
+> 兼容范围：只修复本地真机调试的启动信息和 Dev Context 读取；公开 SDK API、线上版本与权限模型保持不变。
+
+### 问题修复
+
+- 修复手机真机调试时详情页无法读取本地启动信息和 Dev Context，导致调试页反复重连或刷新的问题。
+
 ## 0.8.4-alpha.0 - 2026-09-24
 
 > 影响级别：常规

package/dist/cli-chunks/{build-B1EpaBX8.cjs → build-zYnPSPFa.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-6Vtqki6F.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-Bs_JqpTM.cjs');
 require('node:crypto');
 require('node:zlib');
-var runtimeGate = require('./runtime-gate-YxmVuwbW.cjs');
-var index = require('./index-BHMHVtD3.cjs');
-var projectVite = require('./project-vite-CossJ4nB.cjs');
-require('./version-D9DtIjAK.cjs');
+var runtimeGate = require('./runtime-gate-DikSEEtm.cjs');
+var index = require('./index-Brq_-WV3.cjs');
+var projectVite = require('./project-vite-TFEwLzYM.cjs');
+require('./version-UEmqQ6A-.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');

package/dist/cli-chunks/{context-B_fkAKCx.cjs → context-DWoKsM_O.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-6Vtqki6F.cjs');
+var runtimePermissionEnv = require('./runtime-permission-env-Bs_JqpTM.cjs');
 var fs$1 = require('node:fs');
 var sharp = require('sharp');
-var session = require('./session-BH6zBMTi.cjs');
+var session = require('./session-CbisOcE4.cjs');
 
 async function inspectBasicInfoImage(bytes, sourcePath, kind) {
     const inspected = await inspectDecodedBasicInfoImage(bytes, kind);

package/dist/cli-chunks/{create-B4-C6RHp.cjs → create-C9FcEn9Y.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-BHMHVtD3.cjs');
+var index = require('./index-Brq_-WV3.cjs');
 require('node:module');
 require('os');
 require('node:crypto');