@heybox/hb-sdk 0.3.2 → 0.3.3

package/dist/devtools/mock-host/index.html

@@ -275,7 +275,7 @@
             <button class="primary" id="mac-app-button" type="button">在 Mac 版 APP 中启动</button>
           </div>
           <div class="mac-app-status" id="mac-app-status" hidden>
-            <div>如果没有唤起 Mac 版 APP，请在系统浏览器中打开当前调试页面后重试。Codex、VSCode 等内嵌浏览器可能会拦截 heybox:// 协议。</div>
+            <div>如果没有唤起 Mac 版 APP，请在系统浏览器中打开当前调试页面后重试。若 APP 已打开但加载失败，请升级到支持本地小程序调试的 Mac App 版本。</div>
             <div class="debug-page-url">
               <code id="debug-page-url"></code>
               <button

package/dist/devtools/mock-host/main.js

@@ -127,18 +127,16 @@ const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
 ];
 
 const MINI_PROGRAM_URL_QUERY_PARAM = 'mini_url';
-const MINI_PROGRAM_DEV_QUERY_PARAM = 'hb_mini_dev';
-const MINI_PROGRAM_DETAIL_URL = 'https://www.xiaoheihe.cn/tools/user_miniprogram/detail';
+const MINI_PROGRAM_DEV_SHELL_URL = 'heybox-mini-dev://sandbox';
 function createMacAppProtocol(appUrl) {
-    const detailUrl = new URL(MINI_PROGRAM_DETAIL_URL);
-    detailUrl.searchParams.set(MINI_PROGRAM_URL_QUERY_PARAM, appUrl);
-    detailUrl.searchParams.set(MINI_PROGRAM_DEV_QUERY_PARAM, '1');
+    const devShellUrl = new URL(MINI_PROGRAM_DEV_SHELL_URL);
+    devShellUrl.searchParams.set(MINI_PROGRAM_URL_QUERY_PARAM, appUrl);
     const protocolPayload = {
         protocol_type: 'openWindow',
         full_screen: true,
         mini_program: '1',
         webview: {
-            url: detailUrl.toString(),
+            url: devShellUrl.toString(),
             pull: false,
             refresh: false,
         },
@@ -818,8 +816,10 @@ queryElement('#hide-button').addEventListener('click', () => {
     postEvent('hide', { timestamp: Date.now(), source: 'mock-host' });
 });
 elements.macAppButton.addEventListener('click', () => {
+    const protocol = createMacAppProtocol(miniProgramUrl);
+    console.log('[hb-sdk] Mac App launch protocol:', protocol);
     showMacAppLaunchHint();
-    window.location.href = createMacAppProtocol(miniProgramUrl);
+    window.location.href = protocol;
 });
 elements.copyDebugPageUrlButton.addEventListener('click', () => {
     void copyDebugPageUrl();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "",
   "exports": {
     ".": {
@@ -26,6 +26,7 @@
     },
     "./vite": {
       "types": "./types/vite/index.d.ts",
+      "heybox": "./src/vite/index.ts",
       "import": "./dist/vite.esm.js",
       "require": "./dist/vite.cjs.js",
       "default": "./dist/vite.esm.js"
@@ -75,7 +76,7 @@
     "rimraf": "^5.0.5",
     "rollup": "^4.52.4",
     "typescript": "^5.9.3",
-    "vue": "2.7.16",
+    "vue": "^2.7.16",
     "vite": "^8.0.12",
     "vitest": "^3.2.4"
   },
@@ -102,10 +103,10 @@
   },
   "scripts": {
     "dev": "vite",
-    "build:package": "nx exec -- sh -c \"pnpm run clean && pnpm run build:lib && pnpm run build:cli && pnpm run build:mock-host && pnpm run build:templates && pnpm run build:types\"",
+    "build:package": "nx exec -- sh -c \"pnpm run clean && pnpm run build:lib && pnpm run build:cli && pnpm run build:templates && pnpm run build:types\"",
     "build:watch": "pnpm run build:lib -w & pnpm run build:types -w",
     "build:lib": "rollup -c rollup.config.ts  --configPlugin 'typescript={\"tsconfig\":\"tsconfig.build.json\"}'",
-    "build:cli": "rollup -c rollup.config.ts --environment HB_SDK_BUILD:cli --configPlugin 'typescript={\"tsconfig\":\"tsconfig.build.json\"}'",
+    "build:cli": "rollup -c rollup.config.ts --environment HB_SDK_BUILD:cli --configPlugin 'typescript={\"tsconfig\":\"tsconfig.build.json\"}' && pnpm run build:mock-host",
     "build:mock-host": "node scripts/copy-mock-host.cjs",
     "build:templates": "node scripts/copy-cli-templates.cjs",
     "build:types": "tsc -p tsconfig.dts.json",

package/skill/references/api-protocol.md

@@ -131,5 +131,5 @@ Reference 由 `packages/hb-sdk` 的公开导出与源码注释自动生成，不
 
 | 导出面 | Classes | Functions | Interfaces | Types | Constants |
 | --- | ---: | ---: | ---: | ---: | ---: |
-| Root API | 3 | 5 | 28 | 29 | 12 |
+| Root API | 3 | 4 | 22 | 17 | 0 |
 | Protocol API | 0 | 1 | 20 | 29 | 13 |

package/skill/references/api-root.md

@@ -19,7 +19,7 @@
 ## Package metadata
 
 - Package: `@heybox/hb-sdk`
-- Version at generation time: `0.3.2`
+- Version at generation time: `0.3.3`
 - Public root export: `@heybox/hb-sdk`
 - Protocol export: `@heybox/hb-sdk/protocol`
 - Vite plugin export: `@heybox/hb-sdk/vite`

package/skill/references/llms-index.md

@@ -24,7 +24,7 @@ This site documents the iframe-side SDK for external mini programs. For AI retri
 - [Root API](./llms/reference/root/README.md): 该页面收录从 `src/index.ts` 公开导出的 API。
 - [Protocol API](./llms/reference/protocol/README.md): 该页面收录从 `src/protocol.ts` 公开导出的 API。
 - [Root functions](./llms/reference/root/functions/README.md)
-- [Root interfaces](./llms/reference/root/interfaces/README.md): 所有请求失败都会被规范化成该结构，SDK 侧再包装为 `HbMiniProgramSDKError`。 |
+- [Root interfaces](./llms/reference/root/interfaces/README.md): `on/off` 会基于该映射推导 handler 参数类型。 |
 - [Protocol interfaces](./llms/reference/protocol/interfaces/README.md): 所有请求失败都会被规范化成该结构，SDK 侧再包装为 `HbMiniProgramSDKError`。 |
 - [Root types](./llms/reference/root/types/README.md): `user.getInfo` 不需要入参。
 - [Protocol types](./llms/reference/protocol/types/README.md): `user.getInfo` 不需要入参。

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.3.2+skill.f845392336aa",
+  "skillVersion": "0.3.3+skill.cb20a91e9529",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.3.2",
-    "compatibility": "0.3.2"
+    "version": "0.3.3",
+    "compatibility": "0.3.3"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-f845392336aabd50713f07fe9570e9208e1801f1e20eecb7ccd58941ab83ab64"
+  "integrity": "sha256-cb20a91e95291420a1f1d1b8a1601bbf21ba8bcd4dac64265d0c033e009d9456"
 }