@heybox/hb-sdk 0.5.3 → 0.5.4
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 +48 -48
- package/dist/cli-chunks/{create-CIa8XsUa.cjs → create-BE4xNVc4.cjs} +1 -1
- package/dist/cli-chunks/{dev-DrTprWNa.cjs → dev-BzH5dEtr.cjs} +1 -1
- package/dist/cli-chunks/{doctor-duvVSZ1O.cjs → doctor-CUCUIlNm.cjs} +1 -1
- package/dist/cli-chunks/{index-Drc512Vi.cjs → index-DXIW8eBN.cjs} +13 -13
- package/dist/cli-chunks/{index-Y-Y6vH26.cjs → index-iU6ySidw.cjs} +2 -2
- package/dist/cli-chunks/{login-CQwHq3K6.cjs → login-Cmgyjaq2.cjs} +2 -2
- package/dist/cli-chunks/{remote-zxSs0z8Z.cjs → remote-CzlmufT8.cjs} +3 -3
- package/dist/cli-chunks/{session-DJoDsjWF.cjs → session-ChVF_DnI.cjs} +1 -1
- package/dist/cli.cjs +1 -1
- package/dist/devtools/mock-host/main.js +3 -2
- package/package.json +1 -1
- package/skill/references/api-root.md +3 -3
- package/skill/references/cli.md +6 -6
- 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 环境；如果需要真实黑盒小程序容器加载同一页面，可以点击调试页里的「在 Mac 版 APP 中启动」按钮，或在「Mobile App」区域选择局域网网卡后用手机小黑盒 APP
|
|
60
|
+
调试页会通过 iframe 加载本地页面并补齐小程序 bridge 环境；如果需要真实黑盒小程序容器加载同一页面，可以点击调试页里的「在 Mac 版 APP 中启动」按钮，或在「Mobile App」区域选择局域网网卡后用手机小黑盒 APP 扫码。真实容器加载开发 `mini_url` 前会提示“即将打开未经验证的开发网页。该页面可能由本机或局域网服务提供，请确认来源可信后继续。”，用户确认后才继续加载。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP；遇到这种情况时，请在系统浏览器中打开同一个调试页后重试。
|
|
61
61
|
|
|
62
62
|
在未使用脚手架的 Vite 项目中，可以把命令加到 `package.json`：
|
|
63
63
|
|
|
@@ -199,7 +199,7 @@ await navigation.openAppPage({
|
|
|
199
199
|
|
|
200
200
|
await navigation.openAppPage({
|
|
201
201
|
target: 'post_detail',
|
|
202
|
-
linkId:
|
|
202
|
+
linkId: 57670836,
|
|
203
203
|
rootCommentId: 123,
|
|
204
204
|
commentId: 456,
|
|
205
205
|
});
|
|
@@ -328,31 +328,31 @@ try {
|
|
|
328
328
|
|
|
329
329
|
`@heybox/hb-sdk` 随包提供 `hb-sdk` CLI。脚手架项目已在 npm scripts 中接好常用命令；已有项目也可以自行添加 scripts。
|
|
330
330
|
|
|
331
|
-
| 命令
|
|
332
|
-
|
|
|
333
|
-
| `hb-sdk create <project-name>`
|
|
334
|
-
| `hb-sdk dev [--runtime-url <url>]`
|
|
335
|
-
| `hb-sdk login [--login-base-url <url>] [--no-select-entity]`
|
|
336
|
-
| `hb-sdk login status`
|
|
337
|
-
| `hb-sdk login clear`
|
|
338
|
-
| `hb-sdk doctor`
|
|
339
|
-
| `hb-sdk remote access`
|
|
340
|
-
| `hb-sdk remote entity list`
|
|
341
|
-
| `hb-sdk remote entity current`
|
|
342
|
-
| `hb-sdk remote entity switch <entity-id>`
|
|
343
|
-
| `hb-sdk remote list [--status <status>] [--keyword <text>]`
|
|
344
|
-
| `hb-sdk remote create --name <name> [--preview-image-url <url>] [--yes] [--force-bind]` | 在服务端 current entity 下创建远端用户小程序并写入当前项目的 `package.json.heybox.miniProgramId`。
|
|
345
|
-
| `hb-sdk remote bind <mini-program-id> [--force]`
|
|
346
|
-
| `hb-sdk remote info`
|
|
347
|
-
| `hb-sdk remote update [--name <name>] [--preview-image-url <url>]`
|
|
348
|
-
| `hb-sdk remote allowlist list/add/remove/set ...`
|
|
349
|
-
| `hb-sdk remote deploy --release-note <text> [--skip-build] [--auto-publish]`
|
|
350
|
-
| `hb-sdk remote versions`
|
|
351
|
-
| `hb-sdk remote preview <version>`
|
|
352
|
-
| `hb-sdk remote release <version> [--yes]`
|
|
353
|
-
| `hb-sdk remote withdraw <version> [--yes] [--reason <text>]`
|
|
354
|
-
| `hb-sdk remote take-down [--yes]`
|
|
355
|
-
| `hb-sdk remote reopen [--yes]`
|
|
331
|
+
| 命令 | 作用 |
|
|
332
|
+
| --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
|
|
333
|
+
| `hb-sdk create <project-name>` | 创建外部小程序模板。 |
|
|
334
|
+
| `hb-sdk dev [--runtime-url <url>]` | 启动当前项目的 Vite dev server 和浏览器 mock 宿主环境，并默认打开调试页；`--runtime-url` 会传给真实客户端 dev shell。 |
|
|
335
|
+
| `hb-sdk login [--login-base-url <url>] [--no-select-entity]` | 登录 Heybox，并把 CLI 自己需要的登录态和登录入口环境保存在本地缓存中；默认会引导多主体用户选择服务端 current entity。 |
|
|
336
|
+
| `hb-sdk login status` | 查看脱敏后的 CLI 登录态。 |
|
|
337
|
+
| `hb-sdk login clear` | 清理 CLI 登录态。 |
|
|
338
|
+
| `hb-sdk doctor` | 检查本机 `hb-sdk` Agent Skill 是否匹配当前 SDK，并输出手动安装/刷新命令。 |
|
|
339
|
+
| `hb-sdk remote access` | 查看当前 CLI 用户是否具备开发者用户小程序创建和管理资格。 |
|
|
340
|
+
| `hb-sdk remote entity list` | 列出当前 CLI 用户可切换的开发者主体，并标记服务端 current entity。 |
|
|
341
|
+
| `hb-sdk remote entity current` | 查看服务端 current entity，以及该主体的用户小程序权限状态。 |
|
|
342
|
+
| `hb-sdk remote entity switch <entity-id>` | 切换开发者平台服务端 current entity；不会修改项目绑定的小程序 ID。 |
|
|
343
|
+
| `hb-sdk remote list [--status <status>] [--keyword <text>]` | 列出当前 CLI 用户可管理的远端用户小程序，用于发现并绑定当前项目。 |
|
|
344
|
+
| `hb-sdk remote create --name <name> [--preview-image-url <url>] [--yes] [--force-bind]` | 在服务端 current entity 下创建远端用户小程序并写入当前项目的 `package.json.heybox.miniProgramId`。 |
|
|
345
|
+
| `hb-sdk remote bind <mini-program-id> [--force]` | 校验当前 CLI 用户可管理目标小程序后，再把它绑定到当前项目。 |
|
|
346
|
+
| `hb-sdk remote info` | 查看当前项目绑定的小程序详情。 |
|
|
347
|
+
| `hb-sdk remote update [--name <name>] [--preview-image-url <url>]` | 更新绑定小程序的名称或远程预览图 URL。 |
|
|
348
|
+
| `hb-sdk remote allowlist list/add/remove/set ...` | 管理绑定小程序的预览白名单。 |
|
|
349
|
+
| `hb-sdk remote deploy --release-note <text> [--skip-build] [--auto-publish]` | 构建、上传并提交当前小程序版本审核；`--skip-build` 跳过 build 直接上传 `dist/`。 |
|
|
350
|
+
| `hb-sdk remote versions` | 列出绑定小程序的远端版本。 |
|
|
351
|
+
| `hb-sdk remote preview <version>` | 查看指定版本的远端预览入口。 |
|
|
352
|
+
| `hb-sdk remote release <version> [--yes]` | 发布审核通过的版本；非 TTY 环境必须传 `--yes`。 |
|
|
353
|
+
| `hb-sdk remote withdraw <version> [--yes] [--reason <text>]` | 撤回审核中或已通过但未发布的版本；非 TTY 环境必须传 `--yes`。 |
|
|
354
|
+
| `hb-sdk remote take-down [--yes]` | 下架当前线上小程序；非 TTY 环境必须传 `--yes`。 |
|
|
355
|
+
| `hb-sdk remote reopen [--yes]` | 重新上架已下架的小程序；非 TTY 环境必须传 `--yes`。 |
|
|
356
356
|
|
|
357
357
|
远端平台操作统一放在 `hb-sdk remote` 命令组下；顶层 `hb-sdk deploy` 已硬切删除，不再作为兼容别名保留。`hb-sdk login` 仍是顶层命令，因为它管理 CLI 登录态，不绑定到某个具体小程序。开发者主体的事实源是服务端 current entity；CLI 登录缓存中的 `selectedEntity` 只是上次选择时的提示快照，用于 `login status` 展示和漂移排障，不能作为权限或归属判断依据。
|
|
358
358
|
|
|
@@ -419,28 +419,28 @@ HB_SDK_ALLOW_UNSAFE_API_BASE_URL=1 hb-sdk remote deploy --api-base-url http://12
|
|
|
419
419
|
|
|
420
420
|
`hb-sdk remote` 默认作用于当前项目绑定的小程序，即 `package.json.heybox.miniProgramId`。`remote list` 只展示服务端 current entity 下可管理的小程序，用于发现和绑定；会改变远端状态的命令仍然只操作当前绑定的小程序，不接受临时 `mini_program_id` 参数。需要查看或切换开发者主体时，使用 `hb-sdk remote entity ...`；CLI 不会根据本地绑定自动切换主体。
|
|
421
421
|
|
|
422
|
-
| 命令
|
|
423
|
-
|
|
|
424
|
-
| `hb-sdk remote access`
|
|
425
|
-
| `hb-sdk remote entity list`
|
|
426
|
-
| `hb-sdk remote entity current`
|
|
427
|
-
| `hb-sdk remote entity switch <entity-id>`
|
|
428
|
-
| `hb-sdk remote list [--status <status>] [--keyword <text>]`
|
|
422
|
+
| 命令 | 说明 |
|
|
423
|
+
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
424
|
+
| `hb-sdk remote access` | 查询当前 CLI 用户是否具备开发者用户小程序管理资格。 |
|
|
425
|
+
| `hb-sdk remote entity list` | 列出可切换开发者主体，并标记服务端 current entity。 |
|
|
426
|
+
| `hb-sdk remote entity current` | 查看服务端 current entity 和该主体的用户小程序权限状态。 |
|
|
427
|
+
| `hb-sdk remote entity switch <entity-id>` | 切换服务端 current entity；只允许切到 `entity list` 返回的主体。 |
|
|
428
|
+
| `hb-sdk remote list [--status <status>] [--keyword <text>]` | 列出 current entity 下当前 CLI 用户可管理的小程序，并标出当前绑定项。 |
|
|
429
429
|
| `hb-sdk remote create --name <name> [--preview-image-url <url>] [--yes] [--force-bind]` | 在 current entity 下创建远端小程序并绑定当前项目；多主体非 TTY 环境必须传 `--yes` 确认使用当前主体；已有绑定时必须显式传 `--force-bind` 才能覆盖。 |
|
|
430
|
-
| `hb-sdk remote bind <mini-program-id> [--force]`
|
|
431
|
-
| `hb-sdk remote info`
|
|
432
|
-
| `hb-sdk remote update [--name <name>] [--preview-image-url <url>]`
|
|
433
|
-
| `hb-sdk remote allowlist list`
|
|
434
|
-
| `hb-sdk remote allowlist add <heybox-id...>`
|
|
435
|
-
| `hb-sdk remote allowlist remove <heybox-id...>`
|
|
436
|
-
| `hb-sdk remote allowlist set <heybox-id...>`
|
|
437
|
-
| `hb-sdk remote deploy --release-note <text> [--skip-build] [--auto-publish]`
|
|
438
|
-
| `hb-sdk remote versions`
|
|
439
|
-
| `hb-sdk remote preview <version>`
|
|
440
|
-
| `hb-sdk remote release <version> [--yes]`
|
|
441
|
-
| `hb-sdk remote withdraw <version> [--yes] [--reason <text>]`
|
|
442
|
-
| `hb-sdk remote take-down [--yes]`
|
|
443
|
-
| `hb-sdk remote reopen [--yes]`
|
|
430
|
+
| `hb-sdk remote bind <mini-program-id> [--force]` | 先校验 current entity 可管理目标小程序，再写入当前项目绑定；`--force` 只允许覆盖本地绑定，不跳过远端校验或主体一致性校验。 |
|
|
431
|
+
| `hb-sdk remote info` | 查看当前绑定小程序的远端详情。 |
|
|
432
|
+
| `hb-sdk remote update [--name <name>] [--preview-image-url <url>]` | 更新名称或远程预览图 URL，至少传一个变更字段。 |
|
|
433
|
+
| `hb-sdk remote allowlist list` | 查看预览白名单。 |
|
|
434
|
+
| `hb-sdk remote allowlist add <heybox-id...>` | 添加十进制 Heybox ID 到预览白名单。 |
|
|
435
|
+
| `hb-sdk remote allowlist remove <heybox-id...>` | 从预览白名单移除非 owner 条目。 |
|
|
436
|
+
| `hb-sdk remote allowlist set <heybox-id...>` | 替换非 owner 白名单条目，并保留平台返回的 owner 语义。 |
|
|
437
|
+
| `hb-sdk remote deploy --release-note <text> [--skip-build] [--auto-publish]` | 构建、上传并提交当前版本审核。 |
|
|
438
|
+
| `hb-sdk remote versions` | 列出当前绑定小程序的远端版本。 |
|
|
439
|
+
| `hb-sdk remote preview <version>` | 查看指定版本的远端预览入口。 |
|
|
440
|
+
| `hb-sdk remote release <version> [--yes]` | 发布审核通过的版本；交互式终端会确认，非 TTY 必须传 `--yes`。 |
|
|
441
|
+
| `hb-sdk remote withdraw <version> [--yes] [--reason <text>]` | 撤回审核中或已通过但未发布的版本；交互式终端会确认，非 TTY 必须传 `--yes`。 |
|
|
442
|
+
| `hb-sdk remote take-down [--yes]` | 下架当前线上小程序；交互式终端会确认，非 TTY 必须传 `--yes`。 |
|
|
443
|
+
| `hb-sdk remote reopen [--yes]` | 重新上架已下架的小程序；交互式终端会确认，非 TTY 必须传 `--yes`。 |
|
|
444
444
|
|
|
445
445
|
CLI 登录态只供 CLI 命令访问黑盒接口时复用，不会注入 iframe SDK，也不会改变 `auth.login()`、`user.getInfo()`、`network.request()` 或 mock 宿主中的用户状态。`hb-sdk login` 成功后会尝试读取开发者主体列表：单主体自动确认或切换为 current entity，多主体交互式环境要求选择主体，多主体非 TTY 环境只提示后续运行 `hb-sdk remote entity switch <entity-id>`；显式传 `--no-select-entity` 时只写登录态，不修改服务端 current entity。`hb-sdk login status` 默认展示脱敏状态、`heyboxId`、`loginBaseUrl`、登录时间和本地 `selectedEntity` 提示快照；`--verbose` 额外展示 cache 路径。不输出 `pkey`、cookie 或完整请求头。`selectedEntity` 不是权限事实源，每次 remote 命令仍以服务端 current entity 为准。
|
|
446
446
|
|
|
@@ -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-
|
|
8
|
+
var index = require('./index-DXIW8eBN.cjs');
|
|
9
9
|
require('node:module');
|
|
10
10
|
require('os');
|
|
11
11
|
require('readline');
|
|
@@ -9,7 +9,7 @@ var node_url = require('node:url');
|
|
|
9
9
|
var net = require('node:net');
|
|
10
10
|
var node_http = require('node:http');
|
|
11
11
|
var browser = require('./browser-RAy8e8cV.cjs');
|
|
12
|
-
var index = require('./index-
|
|
12
|
+
var index = require('./index-DXIW8eBN.cjs');
|
|
13
13
|
require('node:process');
|
|
14
14
|
require('node:buffer');
|
|
15
15
|
require('node:util');
|
|
@@ -4,7 +4,7 @@ var fs$1 = require('node:fs');
|
|
|
4
4
|
var fs = require('node:fs/promises');
|
|
5
5
|
var os = require('node:os');
|
|
6
6
|
var path = require('node:path');
|
|
7
|
-
var index = require('./index-
|
|
7
|
+
var index = require('./index-DXIW8eBN.cjs');
|
|
8
8
|
require('node:module');
|
|
9
9
|
require('path');
|
|
10
10
|
require('os');
|
|
@@ -234,19 +234,19 @@ function requireArgument () {
|
|
|
234
234
|
|
|
235
235
|
var command = {};
|
|
236
236
|
|
|
237
|
-
const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-
|
|
237
|
+
const require$5 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DXIW8eBN.cjs', document.baseURI).href)));
|
|
238
238
|
function __require$4() { return require$5("node:events"); }
|
|
239
239
|
|
|
240
|
-
const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-
|
|
240
|
+
const require$4 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DXIW8eBN.cjs', document.baseURI).href)));
|
|
241
241
|
function __require$3() { return require$4("node:child_process"); }
|
|
242
242
|
|
|
243
|
-
const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-
|
|
243
|
+
const require$3 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DXIW8eBN.cjs', document.baseURI).href)));
|
|
244
244
|
function __require$2() { return require$3("node:path"); }
|
|
245
245
|
|
|
246
|
-
const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-
|
|
246
|
+
const require$2 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DXIW8eBN.cjs', document.baseURI).href)));
|
|
247
247
|
function __require$1() { return require$2("node:fs"); }
|
|
248
248
|
|
|
249
|
-
const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-
|
|
249
|
+
const require$1 = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/index-DXIW8eBN.cjs', document.baseURI).href)));
|
|
250
250
|
function __require() { return require$1("node:process"); }
|
|
251
251
|
|
|
252
252
|
var help = {};
|
|
@@ -13094,7 +13094,7 @@ function readErrorMessage(error, options = {}) {
|
|
|
13094
13094
|
}
|
|
13095
13095
|
|
|
13096
13096
|
const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
|
|
13097
|
-
const BUILT_CLI_VERSION = '0.5.
|
|
13097
|
+
const BUILT_CLI_VERSION = '0.5.4';
|
|
13098
13098
|
const PACKAGE_JSON_CANDIDATES = [
|
|
13099
13099
|
path.resolve(__dirname, '..', '..', 'package.json'),
|
|
13100
13100
|
path.resolve(__dirname, '..', 'package.json'),
|
|
@@ -13377,31 +13377,31 @@ function createCommandLoggerResolver(options) {
|
|
|
13377
13377
|
};
|
|
13378
13378
|
}
|
|
13379
13379
|
const defaultClearLoginStatus = async (...args) => {
|
|
13380
|
-
const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-
|
|
13380
|
+
const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-Cmgyjaq2.cjs'); });
|
|
13381
13381
|
return clearLoginStatus(...args);
|
|
13382
13382
|
};
|
|
13383
13383
|
const defaultLoginToHeybox = async (...args) => {
|
|
13384
|
-
const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-
|
|
13384
|
+
const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-Cmgyjaq2.cjs'); });
|
|
13385
13385
|
return loginToHeybox(...args);
|
|
13386
13386
|
};
|
|
13387
13387
|
const defaultPrintLoginStatus = async (...args) => {
|
|
13388
|
-
const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-
|
|
13388
|
+
const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-Cmgyjaq2.cjs'); });
|
|
13389
13389
|
return printLoginStatus(...args);
|
|
13390
13390
|
};
|
|
13391
13391
|
const defaultRunCreateCommand = async (...args) => {
|
|
13392
|
-
const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-
|
|
13392
|
+
const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-BE4xNVc4.cjs'); });
|
|
13393
13393
|
return runCreateCommand(...args);
|
|
13394
13394
|
};
|
|
13395
13395
|
const defaultRunDevCommand = async (...args) => {
|
|
13396
|
-
const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-
|
|
13396
|
+
const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-BzH5dEtr.cjs'); });
|
|
13397
13397
|
return runDevCommand(...args);
|
|
13398
13398
|
};
|
|
13399
13399
|
const defaultRunDoctorCommand = async (...args) => {
|
|
13400
|
-
const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-
|
|
13400
|
+
const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-CUCUIlNm.cjs'); });
|
|
13401
13401
|
return runDoctorCommand(...args);
|
|
13402
13402
|
};
|
|
13403
13403
|
const defaultRunRemoteCommand = async (...args) => {
|
|
13404
|
-
const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-
|
|
13404
|
+
const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-CzlmufT8.cjs'); }).then(function (n) { return n.remote; });
|
|
13405
13405
|
return runRemoteCommand(...args);
|
|
13406
13406
|
};
|
|
13407
13407
|
function resolveStandaloneLogger(options, verbose) {
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
|
-
var index$2 = require('./index-
|
|
3
|
+
var index$2 = require('./index-DXIW8eBN.cjs');
|
|
4
4
|
var require$$0$2 = require('fs');
|
|
5
5
|
var require$$2$1 = require('crypto');
|
|
6
6
|
var require$$1$2 = require('path');
|
|
7
7
|
var require$$0$3 = require('assert');
|
|
8
8
|
var require$$4$2 = require('events');
|
|
9
9
|
var require$$1$1 = require('util');
|
|
10
|
-
var remote = require('./remote-
|
|
10
|
+
var remote = require('./remote-CzlmufT8.cjs');
|
|
11
11
|
var require$$0$5 = require('net');
|
|
12
12
|
var require$$0$4 = require('url');
|
|
13
13
|
var require$$2$2 = require('http');
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
var promises = require('node:readline/promises');
|
|
4
4
|
var node_crypto = require('node:crypto');
|
|
5
5
|
var node_http = require('node:http');
|
|
6
|
-
var session = require('./session-
|
|
6
|
+
var session = require('./session-ChVF_DnI.cjs');
|
|
7
7
|
var browser = require('./browser-RAy8e8cV.cjs');
|
|
8
|
-
var index = require('./index-
|
|
8
|
+
var index = require('./index-DXIW8eBN.cjs');
|
|
9
9
|
require('node:path');
|
|
10
10
|
require('fs');
|
|
11
11
|
require('constants');
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
'use strict';
|
|
2
2
|
|
|
3
3
|
var promises = require('node:readline/promises');
|
|
4
|
-
var session = require('./session-
|
|
4
|
+
var session = require('./session-ChVF_DnI.cjs');
|
|
5
5
|
var childProcess = require('node:child_process');
|
|
6
6
|
var fs = require('node:fs');
|
|
7
7
|
var fs$1 = require('node:fs/promises');
|
|
8
8
|
var path = require('node:path');
|
|
9
|
-
var index = require('./index-
|
|
9
|
+
var index = require('./index-DXIW8eBN.cjs');
|
|
10
10
|
|
|
11
11
|
var re = {exports: {}};
|
|
12
12
|
|
|
@@ -3113,7 +3113,7 @@ async function createDefaultCosClient(uploadToken) {
|
|
|
3113
3113
|
};
|
|
3114
3114
|
}
|
|
3115
3115
|
async function loadCosConstructor() {
|
|
3116
|
-
const cosModule = await Promise.resolve().then(function () { return require('./index-
|
|
3116
|
+
const cosModule = await Promise.resolve().then(function () { return require('./index-iU6ySidw.cjs'); }).then(function (n) { return n.index; });
|
|
3117
3117
|
return cosModule.default;
|
|
3118
3118
|
}
|
|
3119
3119
|
function formatSize(bytes) {
|
package/dist/cli.cjs
CHANGED
|
@@ -3554,6 +3554,7 @@ function createUserDetailOpenRouterPathProtocol(payload) {
|
|
|
3554
3554
|
};
|
|
3555
3555
|
}
|
|
3556
3556
|
function createPostDetailOpenRouterPathProtocol(payload) {
|
|
3557
|
+
// 不传 link_tag/has_video，让 App 先按 link_id 获取真实帖子类型再打开详情。
|
|
3557
3558
|
const params = {
|
|
3558
3559
|
link_id: payload.linkId,
|
|
3559
3560
|
};
|
|
@@ -5434,8 +5435,8 @@ function renderMockOpenAppPage(action) {
|
|
|
5434
5435
|
const protocol = action.options.protocol;
|
|
5435
5436
|
element.innerHTML = [
|
|
5436
5437
|
'<strong>已模拟打开 App 页面</strong>',
|
|
5437
|
-
`<span>${escapeMockHtml(protocol.
|
|
5438
|
-
`<pre>${escapeMockHtml(JSON.stringify(protocol
|
|
5438
|
+
`<span>${escapeMockHtml(protocol.protocol_type)}</span>`,
|
|
5439
|
+
`<pre>${escapeMockHtml(JSON.stringify(protocol, null, 2))}</pre>`,
|
|
5439
5440
|
].join('');
|
|
5440
5441
|
element.style.cssText = [
|
|
5441
5442
|
'position:fixed',
|
package/package.json
CHANGED
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
## Package metadata
|
|
20
20
|
|
|
21
21
|
- Package: `@heybox/hb-sdk`
|
|
22
|
-
- Version at generation time: `0.5.
|
|
22
|
+
- Version at generation time: `0.5.4`
|
|
23
23
|
- Public root export: `@heybox/hb-sdk`
|
|
24
24
|
- Protocol export: `@heybox/hb-sdk/protocol`
|
|
25
25
|
- Vite plugin export: `@heybox/hb-sdk/vite`
|
|
@@ -330,7 +330,7 @@ SDK 需要在黑盒小程序 iframe 容器内运行。父容器会为页面注
|
|
|
330
330
|
npm run dev
|
|
331
331
|
```
|
|
332
332
|
|
|
333
|
-
调试页会通过 iframe 加载本地页面并补齐小程序 bridge 环境；如果需要真实黑盒小程序容器加载同一页面，可以点击调试页里的「在 Mac 版 APP 中启动」按钮，或在「Mobile App」区域选择局域网网卡后用手机小黑盒 APP
|
|
333
|
+
调试页会通过 iframe 加载本地页面并补齐小程序 bridge 环境；如果需要真实黑盒小程序容器加载同一页面，可以点击调试页里的「在 Mac 版 APP 中启动」按钮，或在「Mobile App」区域选择局域网网卡后用手机小黑盒 APP 扫码。真实容器加载开发 `mini_url` 前会提示“即将打开未经验证的开发网页。该页面可能由本机或局域网服务提供，请确认来源可信后继续。”，用户确认后才继续加载。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP；遇到这种情况时，请在系统浏览器中打开同一个调试页后重试。
|
|
334
334
|
|
|
335
335
|
在未使用脚手架的 Vite 项目中，可以把命令加到 `package.json`：
|
|
336
336
|
|
|
@@ -492,7 +492,7 @@ await navigation.openAppPage({
|
|
|
492
492
|
|
|
493
493
|
await navigation.openAppPage({
|
|
494
494
|
target: 'post_detail',
|
|
495
|
-
linkId:
|
|
495
|
+
linkId: 57670836,
|
|
496
496
|
rootCommentId: 123,
|
|
497
497
|
commentId: 456,
|
|
498
498
|
});
|
package/skill/references/cli.md
CHANGED
|
@@ -106,16 +106,16 @@ hb-sdk dev
|
|
|
106
106
|
|
|
107
107
|
常用参数：
|
|
108
108
|
|
|
109
|
-
| 参数
|
|
110
|
-
|
|
|
111
|
-
| `--port <port>`
|
|
112
|
-
| `--mock-port <port>`
|
|
109
|
+
| 参数 | 说明 |
|
|
110
|
+
| --------------------- | ---------------------------------------------------------------------------------------------------------- |
|
|
111
|
+
| `--port <port>` | 指定小程序 Vite dev server 端口，默认从 `5173` 开始。 |
|
|
112
|
+
| `--mock-port <port>` | 指定 mock host 端口，默认从 `5174` 开始。 |
|
|
113
113
|
| `--runtime-url <url>` | 真实客户端调试时传给 dev shell 的自定义 runtime 地址；手机扫码时 loopback host 会自动改写为所选局域网 IP。 |
|
|
114
|
-
| `--no-open`
|
|
114
|
+
| `--no-open` | 不自动打开浏览器调试页。 |
|
|
115
115
|
|
|
116
116
|
## Mock runtime 边界
|
|
117
117
|
|
|
118
|
-
`hb-sdk dev` 会把实际小程序页面地址编码到 mock host 的 `mini_url` query 中，由 mock host iframe 加载页面并补齐小程序 bridge 环境。mock host 内置登录/登出、`show`、`hide`、在 Mac 版 APP 中启动、手机扫码调试等调试入口，并通过同一份 devtools-only runtime adapter 处理 SDK
|
|
118
|
+
`hb-sdk dev` 会把实际小程序页面地址编码到 mock host 的 `mini_url` query 中，由 mock host iframe 加载页面并补齐小程序 bridge 环境。mock host 内置登录/登出、`show`、`hide`、在 Mac 版 APP 中启动、手机扫码调试等调试入口，并通过同一份 devtools-only runtime adapter 处理 SDK 能力调用。真实 Mac / Mobile App dev shell 加载开发 `mini_url` 前会提示“即将打开未经验证的开发网页。该页面可能由本机或局域网服务提供，请确认来源可信后继续。”，用户确认后才继续加载。Codex、VSCode 等内嵌浏览器可能无法唤起系统 APP；遇到这种情况时，请在系统浏览器中打开同一个调试页后重试。
|
|
119
119
|
|
|
120
120
|
不要为了本地调试再创建独立 mock runtime 包。CLI、模板和 mock host 都归属 `@heybox/hb-sdk`。
|
|
121
121
|
|
package/skill/skill.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "hb-sdk",
|
|
3
|
-
"skillVersion": "0.5.
|
|
3
|
+
"skillVersion": "0.5.4+skill.9edb4788ffa5",
|
|
4
4
|
"sdk": {
|
|
5
5
|
"package": "@heybox/hb-sdk",
|
|
6
|
-
"version": "0.5.
|
|
7
|
-
"compatibility": "0.5.
|
|
6
|
+
"version": "0.5.4",
|
|
7
|
+
"compatibility": "0.5.4"
|
|
8
8
|
},
|
|
9
9
|
"source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
|
|
10
|
-
"integrity": "sha256-
|
|
10
|
+
"integrity": "sha256-9edb4788ffa5d68f4ef8e0096e89a2ceff3f355c441c13f20e85b7a58f40634e"
|
|
11
11
|
}
|