@heybox/hb-sdk 0.9.1-alpha.11 → 0.9.1-alpha.12

package/dist/devtools/browser-dev-host/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="theme-color" content="#f4f5f7" />
     <title>小程序工坊调试台</title>
-    <script type="module" crossorigin src="/assets/index-CuH8wWTJ.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-D1z3MxUY.js">
+    <script type="module" crossorigin src="/assets/index-BdfQ_aP4.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/desktop-app-launch-F0wNWGvm.js">
     <link rel="stylesheet" crossorigin href="/assets/index-BRxbUJVN.css">
   </head>
   <body>

package/dist/index.cjs.js

@@ -7278,7 +7278,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.11';
+    : '0.9.1-alpha.12';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -10270,6 +10270,12 @@ function decodeBase64Url(value) {
  * @see {@link MiniProgramScreenshotOptions}
  */
 function screenshot(requester, options) {
+    try {
+        console.warn('[hb-sdk] share.screenshot 行为变更提醒：正式版 SDK 0.9.1 及以上默认添加小程序品牌水印；低于 0.9.1（含预发布版本）的 SDK 保持无水印截图。升级前请在目标截图区域底部预留至少 57 个逻辑像素，避免遮挡重要内容；watermarkTheme 的 light 为黑色水印，dark 为白色水印且是默认值，不自动跟随系统主题。系统按键截图不在此能力范围内。');
+    }
+    catch {
+        // 日志输出失败不能阻断截图调用。
+    }
     return requester.request(SHARE_SCREENSHOT_METHOD, options);
 }
 

package/dist/index.esm.js

@@ -7274,7 +7274,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.11';
+    : '0.9.1-alpha.12';
 
 const RUNTIME_MODES = new Set(['production', 'preview', 'development', 'unknown']);
 const OPERATING_SYSTEM_NAMES = new Set(['android', 'ios', 'ohos', 'windows', 'macos', 'linux', 'unknown']);
@@ -10266,6 +10266,12 @@ function decodeBase64Url(value) {
  * @see {@link MiniProgramScreenshotOptions}
  */
 function screenshot(requester, options) {
+    try {
+        console.warn('[hb-sdk] share.screenshot 行为变更提醒：正式版 SDK 0.9.1 及以上默认添加小程序品牌水印；低于 0.9.1（含预发布版本）的 SDK 保持无水印截图。升级前请在目标截图区域底部预留至少 57 个逻辑像素，避免遮挡重要内容；watermarkTheme 的 light 为黑色水印，dark 为白色水印且是默认值，不自动跟随系统主题。系统按键截图不在此能力范围内。');
+    }
+    catch {
+        // 日志输出失败不能阻断截图调用。
+    }
     return requester.request(SHARE_SCREENSHOT_METHOD, options);
 }
 

package/dist/vite.cjs.js

@@ -10282,7 +10282,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.11';
+    : '0.9.1-alpha.12';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/dist/vite.esm.js

@@ -10279,7 +10279,7 @@ async function ensureBasicInfoDirectory(rootPath, relative) {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.9.1-alpha.11';
+    : '0.9.1-alpha.12';
 
 /**
  * iframe 与调试台页面的开发期 console 捕获转发。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.9.1-alpha.11",
+  "version": "0.9.1-alpha.12",
   "sideEffects": [
     "./src/index.ts",
     "./src/core/singleton.ts",
@@ -76,7 +76,7 @@
     "undici": "^7.28.0",
     "ws": "^8.18.0",
     "sharp": "^0.34.5",
-    "@heybox/hb-sdk-protocol": "0.9.1-alpha.11"
+    "@heybox/hb-sdk-protocol": "0.9.1-alpha.12"
   },
   "peerDependencies": {
     "vite": ">=5"
@@ -129,11 +129,11 @@
     "@ai-desktop/view-contract": "file:../hb-sdk-protocol/vendor/view-contract-2.2.2-6ac49bbf6410.tgz",
     "rollup-plugin-dts": "6.4.0",
     "@heybox-domain/heybox-theme": "~0.1.0",
-    "@heybox/hb-sdk-runtime": "~0.9.1-alpha.11",
-    "@heybox/hb-api": "~1.28.14",
     "@heybox-domain/heybox-vue3-ui": "~0.1.0",
+    "@heybox/hb-sdk-runtime": "~0.9.1-alpha.12",
     "@heybox/runtime": "~0.2.1",
     "@heybox/runtime-policy": "~0.2.1",
+    "@heybox/hb-api": "~1.28.14",
     "@heybox/runtime-transport-fetch": "~0.2.1"
   },
   "publishConfig": {

package/skill/SKILL.md

@@ -7,6 +7,16 @@ description: Uses @heybox/hb-sdk and the hb-sdk CLI to build, debug, review, and
 
 Use this Skill for workshop mini-program application code, project declarations, public SDK APIs, CLI workflows, Host/Runtime protocol maintenance, and publishing review.
 
+## Screenshot API Changes: Mandatory Upgrade Checks
+
+Before implementing screenshot flows or upgrading the SDK, use the canonical documentation index to read the screenshot Reference, community-sharing Recipe, and upgrade notes. Explicitly explain these changes to the developer:
+
+- Check the installed SDK against the watermark version cutoff, including prerelease ordering. Explain the warning emitted by the SDK screenshot entry and the Runtime's compatibility behavior for legacy screenshots versus the default watermark behavior for newer SDKs.
+- Check the required reserved area at the bottom of the capture region, the content that must remain unobstructed, and the corresponding rules for custom capture rectangles.
+- Check the light/dark theme option, default colors, system-theme behavior, and the support boundary between SDK screenshots and physical-button screenshots.
+
+Before upgrading, verify both the page layout and the captured image. Do not only update the dependency or invocation without explaining screenshot behavior changes. Read exact version cutoffs, dimensions, parameters, and Host support from the canonical documentation fetched for this task; never substitute an older installed Skill snapshot.
+
 ## Canonical Documentation
 
 The only maintained hb-sdk guidance source is:

package/skill/skill.json

@@ -1,16 +1,16 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.9.1-alpha.11+skill.3260e7d71ada",
+  "skillVersion": "0.9.1-alpha.12+skill.c3a240ca503a",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.9.1-alpha.11",
-    "compatibility": "0.9.1-alpha.11"
+    "version": "0.9.1-alpha.12",
+    "compatibility": "0.9.1-alpha.12"
   },
   "distribution": {
     "type": "npm",
     "package": "@heybox/hb-sdk",
-    "version": "0.9.1-alpha.11",
+    "version": "0.9.1-alpha.12",
     "path": "skill"
   },
-  "integrity": "sha256-3260e7d71ada646d5d8b269490e3de4b5ecd3fe824b18cdb73fe64247738ffea"
+  "integrity": "sha256-c3a240ca503a1e5f3b15033e091f1fa79a8b70585aa0d8d8fa0b332daec60ac5"
 }

package/types/index.d.ts

@@ -3451,7 +3451,12 @@ interface MiniProgramShareModule {
      * `pixelRatio` 换算，也不把越界矩形夹取到窗口内。JavaScript 的 coercible 非 number 值可能被
      * 当前 Runtime 接受，但这不是 TypeScript 公共合同，不应依赖。
      *
-     * Runtime 会在截图区域底部居中叠加「小黑盒 + 搜索图标 + 当前小程序名称」胶囊，
+     * SDK 每次调用都会输出 warning，提醒水印行为变化及布局、配色要求；日志失败不阻断截图。
+     * 新 Runtime 按 Version record 中已校验的 SDK 版本启用水印：低于正式版 `0.9.1`
+     * （包括 `0.9.1-alpha.*`）或兼容模式下版本缺失时，静默保持无水印截图；
+     * `0.9.1` 及以上默认添加水印。升级 SDK 前应同步调整截图布局。
+     *
+     * 启用水印时，Runtime 会在截图区域底部居中叠加「小黑盒 + 搜索图标 + 当前小程序名称」胶囊，
      * 下方显示灰色「小黑盒工坊小程序」。开发者应在目标截图区域底部预留至少 57 个逻辑
      * 像素的空白背景，不放置成绩、正文、按钮等重要内容，并保证背景与所选水印配色
      * 有足够对比度；自定义 `rect` 也按该区域的底部预留。水印不增加图片尺寸，只在本次