@heybox/hb-sdk 0.5.15 → 0.5.17
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 +5 -3
- package/dist/cli-chunks/{remote-BbJbKVsT.cjs → context-mav2gs13.cjs} +52 -1583
- package/dist/cli-chunks/{create-D6ZrVnxS.cjs → create-CPIjDM-n.cjs} +1 -1
- package/dist/cli-chunks/{dev-QeQVW2rk.cjs → dev-Cr2u9ajy.cjs} +126 -31
- package/dist/cli-chunks/{doctor-C8oAIjua.cjs → doctor-mIgvLfLl.cjs} +1 -1
- package/dist/cli-chunks/{index-Cui92wKP.cjs → index-DHWEoki_.cjs} +3 -3
- package/dist/cli-chunks/{index-ZyZW5yLP.cjs → index-Dor8wa6R.cjs} +16 -14
- package/dist/cli-chunks/{login-4Z2z6QRT.cjs → login-B63QgKed.cjs} +2 -2
- package/dist/cli-chunks/remote-Dksa9s5M.cjs +1603 -0
- package/dist/cli-chunks/{session-D6CnwMrc.cjs → session-BMSThs93.cjs} +12 -4
- package/dist/cli.cjs +1 -1
- package/dist/devtools/mock-host/main.js +145 -46
- package/package.json +1 -1
- package/skill/SKILL.md +1 -1
- package/skill/references/api-root.md +4 -2
- package/skill/references/cli.md +3 -3
- package/skill/skill.json +4 -4
package/README.md
CHANGED
|
@@ -57,7 +57,7 @@ SDK 需要在黑盒小程序 iframe 容器内运行。父容器会为页面注
|
|
|
57
57
|
npm run dev
|
|
58
58
|
```
|
|
59
59
|
|
|
60
|
-
调试页会通过 iframe 加载本地页面并补齐小程序 bridge
|
|
60
|
+
调试页会通过 iframe 加载本地页面并补齐小程序 bridge 环境；浏览器 Mock 从 mock host 的同源只读 bootstrap 接口读取服务端保留的 Runtime 权限快照，URL query 不能提供或覆盖权限。项目已绑定 `heybox.miniProgramId` 时，可以点击调试页里的「在 Mac 版 APP 中启动」按钮，或在「Mobile App」区域选择局域网网卡后用手机小黑盒 APP 扫码；真机 dev shell 只携带绑定的小程序 ID 和本地页面地址，H5 宿主按 ID 从公开详情接口读取可信 Runtime 权限快照。项目未绑定时仍可使用默认拒绝受管能力的浏览器 Mock，但 Mac 和手机真机入口会明确提示先运行 `hb-sdk remote create` 或 `hb-sdk remote bind <mini-program-id>`，并保持不可用。真实容器加载开发 `mini_url` 前会提示“即将打开未经验证的开发网页。该页面可能由本机或局域网服务提供，请确认来源可信后继续。”，用户确认后才继续加载。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP；遇到这种情况时，请在系统浏览器中打开同一个调试页后重试。
|
|
61
61
|
|
|
62
62
|
在未使用脚手架的 Vite 项目中，可以把命令加到 `package.json`：
|
|
63
63
|
|
|
@@ -328,6 +328,8 @@ await network.request({
|
|
|
328
328
|
|
|
329
329
|
支持的 HTTP method 为 `GET`、`POST`、`PUT`、`PATCH`、`DELETE`、`HEAD`、`OPTIONS`。
|
|
330
330
|
|
|
331
|
+
`network.request` 由平台 Runtime 权限控制。未授权时 SDK 会收到 `PERMISSION_DENIED` 和“当前小程序暂不支持网络请求”；即使已开启网络请求，访问黑盒官方域名仍需要运营侧单独开启官方域名配置。业务代码不能自行请求或注入 Cookie、pkey 等官方凭据。
|
|
332
|
+
|
|
331
333
|
## 生命周期事件
|
|
332
334
|
|
|
333
335
|
SDK 实例创建后会自动开始与父容器握手。使用 `on()` 监听父容器派发的小程序事件时，默认单例会被懒创建并自动开始握手；`on()` 会返回取消监听函数，组件卸载或页面销毁时应及时调用。
|
|
@@ -374,7 +376,7 @@ try {
|
|
|
374
376
|
| 命令 | 作用 |
|
|
375
377
|
| -------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
|
376
378
|
| `hb-sdk create <project-name>` | 创建外部小程序模板。 |
|
|
377
|
-
| `hb-sdk dev [--runtime-url <url>]` |
|
|
379
|
+
| `hb-sdk dev [--runtime-url <url>]` | 启动 Vite 和浏览器 mock 宿主；远端权限可用时使用真实快照，否则以缺失快照启动并默认拒绝受管能力。 |
|
|
378
380
|
| `hb-sdk login [--login-base-url <url>] [--no-select-entity]` | 登录 Heybox，并把 CLI 自己需要的登录态和登录入口环境保存在本地缓存中；默认会引导多主体用户选择服务端 current entity。 |
|
|
379
381
|
| `hb-sdk login status` | 查看脱敏后的 CLI 登录态。 |
|
|
380
382
|
| `hb-sdk login clear` | 清理 CLI 登录态。 |
|
|
@@ -386,7 +388,7 @@ try {
|
|
|
386
388
|
| `hb-sdk remote list [--status <status>] [--keyword <text>]` | 列出当前 CLI 用户可管理的远端工坊小程序，用于发现并绑定当前项目。 |
|
|
387
389
|
| `hb-sdk remote create [--yes] [--force-bind]` | 在服务端 current entity 下创建远端工坊小程序并写入当前项目的 `package.json.heybox.miniProgramId`。 |
|
|
388
390
|
| `hb-sdk remote bind <mini-program-id> [--force]` | 校验当前 CLI 用户可管理目标小程序后，再把它绑定到当前项目。 |
|
|
389
|
-
| `hb-sdk remote info` |
|
|
391
|
+
| `hb-sdk remote info` | 查看当前项目绑定的小程序详情及完整只读 Runtime 权限/config。 |
|
|
390
392
|
| `hb-sdk remote allowlist list/add/remove/set ...` | 管理绑定小程序的预览白名单。 |
|
|
391
393
|
| `hb-sdk remote deploy --release-note <text> [--skip-build \| --from-version <version>] [--auto-publish]` | 构建、上传并提交当前小程序版本审核；`--skip-build` 跳过 build 直接上传 `dist/`，`--from-version` 复用指定历史版本产物。 |
|
|
392
394
|
| `hb-sdk remote versions` | 列出绑定小程序的远端版本。 |
|