@heybox/hb-sdk 0.2.0-alpha.0 → 0.2.0-alpha.1

package/dist/index.cjs.js

@@ -416,6 +416,56 @@ class MiniProgramBridgeClient {
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const AUTH_LOGIN_METHOD = 'auth.login';
+/**
+ * 用户信息能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const USER_GET_INFO_METHOD = 'user.getInfo';
+/**
+ * 展示分享面板能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
+/**
+ * 截图分享能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const SHARE_SCREENSHOT_METHOD = 'share.screenshot';
+/**
+ * 视口窗口信息能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
+/**
+ * 读取小程序隔离 storage 能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
+/**
+ * 写入小程序隔离 storage 能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
+/**
+ * 发起网络请求能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const NETWORK_REQUEST_METHOD = 'network.request';
+
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
  *
@@ -441,13 +491,6 @@ function createAuthModule(requester) {
     };
 }
 
-/**
- * 截图分享能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const SHARE_SCREENSHOT_METHOD = 'share.screenshot';
 /**
  * 截图并唤起分享。
  *
@@ -460,13 +503,6 @@ function screenshot(requester, options) {
     return requester.request(SHARE_SCREENSHOT_METHOD, options);
 }
 
-/**
- * 展示分享面板能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
 /**
  * 展示基础分享面板。
  *
@@ -492,20 +528,6 @@ function createShareModule(requester) {
     };
 }
 
-/**
- * 读取小程序隔离 storage 能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
-/**
- * 写入小程序隔离 storage 能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
 /**
  * 获取小程序隔离 storage。
  *
@@ -541,13 +563,6 @@ function createStorageModule(requester) {
     };
 }
 
-/**
- * 发起网络请求能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const NETWORK_REQUEST_METHOD = 'network.request';
 const DEFAULT_VALIDATE_STATUS = status => status >= 200 && status < 300;
 function isPlainObject(value) {
     return Object.prototype.toString.call(value) === '[object Object]';
@@ -644,13 +659,6 @@ function createNetworkModule(requester) {
     };
 }
 
-/**
- * 视口窗口信息能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
 /**
  * 获取当前小程序窗口信息。
  *
@@ -673,13 +681,6 @@ function createViewportModule(requester) {
     };
 }
 
-/**
- * 用户信息能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const USER_GET_INFO_METHOD = 'user.getInfo';
 /**
  * 获取当前访问小程序用户的公开基础资料。
  *
@@ -903,28 +904,14 @@ exports.STORAGE_SET_STORAGE_METHOD = STORAGE_SET_STORAGE_METHOD;
 exports.USER_GET_INFO_METHOD = USER_GET_INFO_METHOD;
 exports.VIEWPORT_GET_WINDOW_INFO_METHOD = VIEWPORT_GET_WINDOW_INFO_METHOD;
 exports.auth = auth;
-exports.createAuthModule = createAuthModule;
 exports.createMiniProgramSDK = createMiniProgramSDK;
-exports.createNetworkModule = createNetworkModule;
-exports.createShareModule = createShareModule;
-exports.createStorageModule = createStorageModule;
-exports.createUserModule = createUserModule;
-exports.createViewportModule = createViewportModule;
 exports.default = hbSDK;
-exports.getInfo = getInfo;
-exports.getStorage = getStorage;
-exports.getWindowInfo = getWindowInfo;
 exports.isMiniProgramBridgeMessage = isMiniProgramBridgeMessage;
-exports.login = login;
 exports.network = network;
 exports.off = off;
 exports.on = on;
 exports.ready = ready;
-exports.request = request;
-exports.screenshot = screenshot;
-exports.setStorage = setStorage;
 exports.share = share;
-exports.showShareMenu = showShareMenu;
 exports.storage = storage;
 exports.user = user;
 exports.viewport = viewport;

package/dist/index.esm.js

@@ -412,6 +412,56 @@ class MiniProgramBridgeClient {
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const AUTH_LOGIN_METHOD = 'auth.login';
+/**
+ * 用户信息能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const USER_GET_INFO_METHOD = 'user.getInfo';
+/**
+ * 展示分享面板能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
+/**
+ * 截图分享能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const SHARE_SCREENSHOT_METHOD = 'share.screenshot';
+/**
+ * 视口窗口信息能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
+/**
+ * 读取小程序隔离 storage 能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
+/**
+ * 写入小程序隔离 storage 能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
+/**
+ * 发起网络请求能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const NETWORK_REQUEST_METHOD = 'network.request';
+
 /**
  * 唤起登录授权，并在流程返回后刷新用户公开基础资料。
  *
@@ -437,13 +487,6 @@ function createAuthModule(requester) {
     };
 }
 
-/**
- * 截图分享能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const SHARE_SCREENSHOT_METHOD = 'share.screenshot';
 /**
  * 截图并唤起分享。
  *
@@ -456,13 +499,6 @@ function screenshot(requester, options) {
     return requester.request(SHARE_SCREENSHOT_METHOD, options);
 }
 
-/**
- * 展示分享面板能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
 /**
  * 展示基础分享面板。
  *
@@ -488,20 +524,6 @@ function createShareModule(requester) {
     };
 }
 
-/**
- * 读取小程序隔离 storage 能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
-/**
- * 写入小程序隔离 storage 能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
 /**
  * 获取小程序隔离 storage。
  *
@@ -537,13 +559,6 @@ function createStorageModule(requester) {
     };
 }
 
-/**
- * 发起网络请求能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const NETWORK_REQUEST_METHOD = 'network.request';
 const DEFAULT_VALIDATE_STATUS = status => status >= 200 && status < 300;
 function isPlainObject(value) {
     return Object.prototype.toString.call(value) === '[object Object]';
@@ -640,13 +655,6 @@ function createNetworkModule(requester) {
     };
 }
 
-/**
- * 视口窗口信息能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
 /**
  * 获取当前小程序窗口信息。
  *
@@ -669,13 +677,6 @@ function createViewportModule(requester) {
     };
 }
 
-/**
- * 用户信息能力方法名。
- *
- * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
- */
-const USER_GET_INFO_METHOD = 'user.getInfo';
 /**
  * 获取当前访问小程序用户的公开基础资料。
  *
@@ -883,4 +884,4 @@ const hbSDK = {
     network,
 };
 
-export { AUTH_LOGIN_METHOD, HbMiniProgramNetworkError, HbMiniProgramSDKError, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MiniProgramSDK, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, auth, createAuthModule, createMiniProgramSDK, createNetworkModule, createShareModule, createStorageModule, createUserModule, createViewportModule, hbSDK as default, getInfo, getStorage, getWindowInfo, isMiniProgramBridgeMessage, login, network, off, on, ready, request, screenshot, setStorage, share, showShareMenu, storage, user, viewport };
+export { AUTH_LOGIN_METHOD, HbMiniProgramNetworkError, HbMiniProgramSDKError, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MiniProgramSDK, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, auth, createMiniProgramSDK, hbSDK as default, isMiniProgramBridgeMessage, network, off, on, ready, share, storage, user, viewport };

package/dist/protocol.cjs.js

@@ -33,7 +33,6 @@ function isMiniProgramBridgeMessage(value) {
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const AUTH_LOGIN_METHOD = 'auth.login';
-
 /**
  * 用户信息能力方法名。
  *
@@ -41,7 +40,13 @@ const AUTH_LOGIN_METHOD = 'auth.login';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const USER_GET_INFO_METHOD = 'user.getInfo';
-
+/**
+ * 展示分享面板能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
 /**
  * 截图分享能力方法名。
  *
@@ -49,15 +54,13 @@ const USER_GET_INFO_METHOD = 'user.getInfo';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const SHARE_SCREENSHOT_METHOD = 'share.screenshot';
-
 /**
- * 展示分享面板能力方法名。
+ * 视口窗口信息能力方法名。
  *
  * @remarks
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
-const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
-
+const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
 /**
  * 读取小程序隔离 storage 能力方法名。
  *
@@ -72,27 +75,83 @@ const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
-
 /**
- * 视口窗口信息能力方法名。
+ * 发起网络请求能力方法名。
  *
  * @remarks
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
-const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
-
+const NETWORK_REQUEST_METHOD = 'network.request';
 /**
- * 发起网络请求能力方法名。
+ * 小程序开放能力目录。
  *
  * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ * 新增 bridge method 时应先更新这里，再分别补齐 SDK 模块、runtime handler 与测试。
  */
-const NETWORK_REQUEST_METHOD = 'network.request';
+const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
+    {
+        method: AUTH_LOGIN_METHOD,
+        module: 'auth',
+        capability: AUTH_LOGIN_METHOD,
+        permission: 'auth.login',
+        risk: 'medium',
+    },
+    {
+        method: USER_GET_INFO_METHOD,
+        module: 'user',
+        capability: USER_GET_INFO_METHOD,
+        permission: 'user.getInfo',
+        risk: 'medium',
+    },
+    {
+        method: SHARE_SHOW_SHARE_MENU_METHOD,
+        module: 'share',
+        capability: SHARE_SHOW_SHARE_MENU_METHOD,
+        permission: 'share.basic',
+        risk: 'low',
+    },
+    {
+        method: SHARE_SCREENSHOT_METHOD,
+        module: 'share',
+        capability: SHARE_SCREENSHOT_METHOD,
+        permission: 'share.screenshot',
+        risk: 'medium',
+    },
+    {
+        method: VIEWPORT_GET_WINDOW_INFO_METHOD,
+        module: 'viewport',
+        capability: VIEWPORT_GET_WINDOW_INFO_METHOD,
+        permission: 'viewport.windowInfo',
+        risk: 'low',
+    },
+    {
+        method: STORAGE_GET_STORAGE_METHOD,
+        module: 'storage',
+        capability: STORAGE_GET_STORAGE_METHOD,
+        permission: 'storage.read',
+        risk: 'low',
+    },
+    {
+        method: STORAGE_SET_STORAGE_METHOD,
+        module: 'storage',
+        capability: STORAGE_SET_STORAGE_METHOD,
+        permission: 'storage.write',
+        risk: 'medium',
+    },
+    {
+        method: NETWORK_REQUEST_METHOD,
+        module: 'network',
+        capability: NETWORK_REQUEST_METHOD,
+        permission: 'network.request',
+        risk: 'high',
+    },
+];
 
 exports.AUTH_LOGIN_METHOD = AUTH_LOGIN_METHOD;
 exports.MINI_PROGRAM_BRIDGE_NONCE_PARAM = MINI_PROGRAM_BRIDGE_NONCE_PARAM;
 exports.MINI_PROGRAM_MESSAGE_NAMESPACE = MINI_PROGRAM_MESSAGE_NAMESPACE;
 exports.MINI_PROGRAM_MESSAGE_VERSION = MINI_PROGRAM_MESSAGE_VERSION;
+exports.MINI_PROGRAM_PROTOCOL_CAPABILITIES = MINI_PROGRAM_PROTOCOL_CAPABILITIES;
 exports.NETWORK_REQUEST_METHOD = NETWORK_REQUEST_METHOD;
 exports.SDK_HANDSHAKE_METHOD = SDK_HANDSHAKE_METHOD;
 exports.SHARE_SCREENSHOT_METHOD = SHARE_SCREENSHOT_METHOD;

package/dist/protocol.esm.js

@@ -31,7 +31,6 @@ function isMiniProgramBridgeMessage(value) {
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const AUTH_LOGIN_METHOD = 'auth.login';
-
 /**
  * 用户信息能力方法名。
  *
@@ -39,7 +38,13 @@ const AUTH_LOGIN_METHOD = 'auth.login';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const USER_GET_INFO_METHOD = 'user.getInfo';
-
+/**
+ * 展示分享面板能力方法名。
+ *
+ * @remarks
+ * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ */
+const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
 /**
  * 截图分享能力方法名。
  *
@@ -47,15 +52,13 @@ const USER_GET_INFO_METHOD = 'user.getInfo';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const SHARE_SCREENSHOT_METHOD = 'share.screenshot';
-
 /**
- * 展示分享面板能力方法名。
+ * 视口窗口信息能力方法名。
  *
  * @remarks
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
-const SHARE_SHOW_SHARE_MENU_METHOD = 'share.showShareMenu';
-
+const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
 /**
  * 读取小程序隔离 storage 能力方法名。
  *
@@ -70,21 +73,76 @@ const STORAGE_GET_STORAGE_METHOD = 'storage.getStorage';
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
 const STORAGE_SET_STORAGE_METHOD = 'storage.setStorage';
-
 /**
- * 视口窗口信息能力方法名。
+ * 发起网络请求能力方法名。
  *
  * @remarks
  * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
  */
-const VIEWPORT_GET_WINDOW_INFO_METHOD = 'viewport.getWindowInfo';
-
+const NETWORK_REQUEST_METHOD = 'network.request';
 /**
- * 发起网络请求能力方法名。
+ * 小程序开放能力目录。
  *
  * @remarks
- * 供 SDK 与父容器 runtime 共享同一 bridge method 标识。
+ * 新增 bridge method 时应先更新这里，再分别补齐 SDK 模块、runtime handler 与测试。
  */
-const NETWORK_REQUEST_METHOD = 'network.request';
+const MINI_PROGRAM_PROTOCOL_CAPABILITIES = [
+    {
+        method: AUTH_LOGIN_METHOD,
+        module: 'auth',
+        capability: AUTH_LOGIN_METHOD,
+        permission: 'auth.login',
+        risk: 'medium',
+    },
+    {
+        method: USER_GET_INFO_METHOD,
+        module: 'user',
+        capability: USER_GET_INFO_METHOD,
+        permission: 'user.getInfo',
+        risk: 'medium',
+    },
+    {
+        method: SHARE_SHOW_SHARE_MENU_METHOD,
+        module: 'share',
+        capability: SHARE_SHOW_SHARE_MENU_METHOD,
+        permission: 'share.basic',
+        risk: 'low',
+    },
+    {
+        method: SHARE_SCREENSHOT_METHOD,
+        module: 'share',
+        capability: SHARE_SCREENSHOT_METHOD,
+        permission: 'share.screenshot',
+        risk: 'medium',
+    },
+    {
+        method: VIEWPORT_GET_WINDOW_INFO_METHOD,
+        module: 'viewport',
+        capability: VIEWPORT_GET_WINDOW_INFO_METHOD,
+        permission: 'viewport.windowInfo',
+        risk: 'low',
+    },
+    {
+        method: STORAGE_GET_STORAGE_METHOD,
+        module: 'storage',
+        capability: STORAGE_GET_STORAGE_METHOD,
+        permission: 'storage.read',
+        risk: 'low',
+    },
+    {
+        method: STORAGE_SET_STORAGE_METHOD,
+        module: 'storage',
+        capability: STORAGE_SET_STORAGE_METHOD,
+        permission: 'storage.write',
+        risk: 'medium',
+    },
+    {
+        method: NETWORK_REQUEST_METHOD,
+        module: 'network',
+        capability: NETWORK_REQUEST_METHOD,
+        permission: 'network.request',
+        risk: 'high',
+    },
+];
 
-export { AUTH_LOGIN_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, isMiniProgramBridgeMessage };
+export { AUTH_LOGIN_METHOD, MINI_PROGRAM_BRIDGE_NONCE_PARAM, MINI_PROGRAM_MESSAGE_NAMESPACE, MINI_PROGRAM_MESSAGE_VERSION, MINI_PROGRAM_PROTOCOL_CAPABILITIES, NETWORK_REQUEST_METHOD, SDK_HANDSHAKE_METHOD, SHARE_SCREENSHOT_METHOD, SHARE_SHOW_SHARE_MENU_METHOD, STORAGE_GET_STORAGE_METHOD, STORAGE_SET_STORAGE_METHOD, USER_GET_INFO_METHOD, VIEWPORT_GET_WINDOW_INFO_METHOD, isMiniProgramBridgeMessage };

package/dist/templates/vue3-vite-ts/README.md.ejs

@@ -6,7 +6,6 @@
 
 ```bash
 npm install
-npm run dev:mock
 npm run dev
 npm run typecheck
 npm run test:unit
@@ -15,12 +14,9 @@ npm run build
 
 ## 开发模式
 
-- `npm run dev:mock`：启动本地 Vite 服务和 `hb-sdk` 内置 mock runtime host，适合本地调试 SDK 能力。
-- `npm run dev`：只启动小程序页面服务，适合被真实黑盒小程序容器加载。
+- `npm run dev`：启动本地 Vite 服务和 `hb-sdk` 内置 mock runtime host，适合本地调试 SDK 能力；调试页内可点击按钮在 Mac 版 APP 中启动同一页面。
 - `npm run build`：先执行 TypeScript 检查，再构建生产产物。
 
-普通浏览器直接打开 `npm run dev` 的页面时，SDK 会因为缺少小程序 iframe 容器或 bridge nonce 而显示错误状态。开发时请优先使用 `npm run dev:mock`。
-
 ## 更多能力
 
 模板页面只保留最小接入示例。其他常用能力可以直接从 `@heybox/hb-sdk` 调用：

package/dist/templates/vue3-vite-ts/package.json.ejs

@@ -5,7 +5,6 @@
   "type": "module",
   "scripts": {
     "dev": "hb-sdk dev",
-    "dev:mock": "hb-sdk dev --mock --open",
     "build": "vue-tsc --noEmit && vite build",
     "preview": "vite preview",
     "typecheck": "vue-tsc --noEmit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.2.0-alpha.0",
+  "version": "0.2.0-alpha.1",
   "description": "",
   "exports": {
     ".": {
@@ -24,6 +24,7 @@
   "files": [
     "bin",
     "dist",
+    "skill",
     "types"
   ],
   "keywords": [],
@@ -47,6 +48,7 @@
     "get-port": "^7.1.0",
     "happy-dom": "^19.0.2",
     "open": "^10.2.0",
+    "picocolors": "^1.1.1",
     "rimraf": "^5.0.5",
     "rollup": "^4.52.4",
     "typescript": "^5.9.3",