@heybox/hb-sdk 0.6.4 → 0.6.6-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -59,7 +59,11 @@ npm run dev
59
59
 
60
60
  调试页会通过 iframe 加载本地页面并补齐小程序 bridge 环境。`hb-sdk dev` 的基础启动只依赖本地页面地址:即使项目未绑定、CLI 未登录或远端暂时不可用,浏览器 Mock、Mac 启动协议和手机二维码也会继续生成,真机 dev shell 以匿名本地沙箱加载 `mini_url`,不会把公开 `detail` 查询作为启动门禁。项目已绑定时会限时 3 秒读取远端 dev context;成功后 Mock Host 用真实 Runtime 权限快照初始化本地模拟,失败或超时则显示脱敏警告,并默认拒绝 `network.request` 等受管能力。需要定位降级原因时可使用 `hb-sdk dev --verbose`;详细错误只写入本地调试日志,其中 URL 用户名、密码和敏感 query/hash 会被遮蔽,不会进入 LAN bootstrap。
61
61
 
62
- Mock Host 可以在内存中切换 devtools-only 的 `network.request` 权限,不会重建 iframe,因此不影响 Vite HMR;官方域名权限只读取线上快照,本地设置不会修改线上权限。调试页会对比已读取的线上快照,提示本地放开但上线后会返回 `PERMISSION_DENIED` 的差异。权限快照只通过 mock host 的同源只读 bootstrap 接口传递,URL query 不能提供或覆盖权限。真实容器加载开发 `mini_url` 前会提示“即将打开未经验证的开发网页。该页面可能由本机或局域网服务提供,请确认来源可信后继续。”,用户确认后才继续加载。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP;遇到这种情况时,请在系统浏览器中打开同一个调试页后重试。
62
+ Mock Host 可以切换开发会话的 `network.request` 权限,不会重建 iframe,因此不影响 Vite HMR。权限覆盖会持久化到 `hb-sdk` 的用户级本地缓存,并按项目真实路径与启动时绑定的 `miniProgramId` 隔离;即使远端权限暂时读取失败,也会继续使用已知绑定 scope。刷新调试页或重启 `hb-sdk dev` 后仍会恢复,直到点击“恢复初始权限”。未绑定项目使用独立匿名 scope,之后绑定小程序时不会继承匿名覆盖。调试页会分别展示远端基线与本地覆盖;多个调试页或进程写入同一 scope 时以最后成功写入的完整配置为准,不提供冲突合并。缓存写入失败时当前页面仍立即生效,同时明确提示刷新或重启后会丢失。已绑定项目重置时会先重新读取远端权限,读取失败则保留当前覆盖并显示错误;匿名项目直接清除本地覆盖。
63
+
64
+ 切换或恢复权限时,Mobile App 二维码会同步重生成,重新扫码后的局域网页面使用同一开发权限。二维码不会携带权限内容,只携带指向本机 Mock Host 的 `dev_context_url`;该 URL 使用 256-bit 随机 token,5 分钟后失效,调试页会在会话到期时自动生成新二维码。Runtime Host 会在创建小程序 Runtime 前拉取 token 对应的不可变权限快照,并校验开发页面 origin、会话期限和快照结构。
65
+
66
+ Dev Session 中的 `network.request` 通过同一 token 绑定的本地代理转发,不会调用黑盒原生凭据 adapter,也不会携带 Cookie、pkey 等宿主凭据;`useOfficialDomain` 固定为 `false`。旧 `dev_network_request` query 不再提供授权,不能作为 Dev Session 快照的降级或覆盖入口。此链路只调整 Web 侧 CLI、Mock Host 和 Runtime Host,Android/iOS 客户端继续透传 URL,无需修改。官方域名权限只读取线上快照,本地设置不会修改线上权限;调试页会对比已读取的线上快照,提示本地放开但上线后会返回 `PERMISSION_DENIED` 的差异。真实容器加载开发 `mini_url` 前会提示“即将打开未经验证的开发网页。该页面可能由本机或局域网服务提供,请确认来源可信后继续。”,用户确认后才继续加载。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP;遇到这种情况时,请在系统浏览器中打开同一个调试页后重试。
63
67
 
64
68
  在未使用脚手架的 Vite 项目中,可以把命令加到 `package.json`:
65
69
 
@@ -1,6 +1,6 @@
1
1
  'use strict';
2
2
 
3
- var session = require('./session-D7nmqMiy.cjs');
3
+ var session = require('./session-DUM4KQHQ.cjs');
4
4
  var fs$1 = require('node:fs');
5
5
  var fs = require('node:fs/promises');
6
6
  var path = require('node:path');
@@ -5,7 +5,7 @@ var fs = require('node:fs/promises');
5
5
  var path = require('node:path');
6
6
  var require$$0 = require('fs');
7
7
  var require$$1 = require('path');
8
- var index = require('./index-B0zGksOA.cjs');
8
+ var index = require('./index-Ck6a9STO.cjs');
9
9
  require('node:module');
10
10
  require('os');
11
11
  require('readline');