@heybox/hb-sdk 0.5.12 → 0.5.15

package/dist/cli-chunks/{create-Ba353lSg.cjs → create-D6ZrVnxS.cjs}

@@ -5,7 +5,7 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var require$$0 = require('fs');
 var require$$1 = require('path');
-var index = require('./index-DeamIV1-.cjs');
+var index = require('./index-ZyZW5yLP.cjs');
 require('node:module');
 require('os');
 require('readline');

package/dist/cli-chunks/{dev-BhPFNef-.cjs → dev-QeQVW2rk.cjs}

@@ -9,7 +9,7 @@ var node_url = require('node:url');
 var net = require('node:net');
 var node_http = require('node:http');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-DeamIV1-.cjs');
+var index = require('./index-ZyZW5yLP.cjs');
 require('node:process');
 require('node:buffer');
 require('node:util');

package/dist/cli-chunks/{doctor-CP4kwgAn.cjs → doctor-C8oAIjua.cjs}

@@ -4,7 +4,7 @@ var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var os = require('node:os');
 var path = require('node:path');
-var index = require('./index-DeamIV1-.cjs');
+var index = require('./index-ZyZW5yLP.cjs');
 require('node:module');
 require('path');
 require('os');

package/dist/cli-chunks/{index-BfpHPA6k.cjs → index-Cui92wKP.cjs}

@@ -1,13 +1,13 @@
 'use strict';
 
-var index$2 = require('./index-DeamIV1-.cjs');
+var index$2 = require('./index-ZyZW5yLP.cjs');
 var require$$0$2 = require('fs');
 var require$$2$1 = require('crypto');
 var require$$1$2 = require('path');
 var require$$0$3 = require('assert');
 var require$$4$2 = require('events');
 var require$$1$1 = require('util');
-var remote = require('./remote-gXUjRvGB.cjs');
+var remote = require('./remote-BbJbKVsT.cjs');
 var require$$0$5 = require('net');
 var require$$0$4 = require('url');
 var require$$2$2 = require('http');

package/dist/cli-chunks/{index-DeamIV1-.cjs → index-ZyZW5yLP.cjs}

@@ -234,19 +234,19 @@ function requireArgument () {
 
 var command = {};
 
-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-DeamIV1-.cjs', document.baseURI).href)));
+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-ZyZW5yLP.cjs', document.baseURI).href)));
 function __require$4() { return require$5("node:events"); }
 
-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-DeamIV1-.cjs', document.baseURI).href)));
+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-ZyZW5yLP.cjs', document.baseURI).href)));
 function __require$3() { return require$4("node:child_process"); }
 
-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-DeamIV1-.cjs', document.baseURI).href)));
+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-ZyZW5yLP.cjs', document.baseURI).href)));
 function __require$2() { return require$3("node:path"); }
 
-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-DeamIV1-.cjs', document.baseURI).href)));
+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-ZyZW5yLP.cjs', document.baseURI).href)));
 function __require$1() { return require$2("node:fs"); }
 
-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-DeamIV1-.cjs', document.baseURI).href)));
+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-ZyZW5yLP.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -13094,7 +13094,7 @@ function readErrorMessage(error, options = {}) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.5.12';
+const BUILT_CLI_VERSION = '0.5.15';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13411,31 +13411,31 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DMNap0-y.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-4Z2z6QRT.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DMNap0-y.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-4Z2z6QRT.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DMNap0-y.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-4Z2z6QRT.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-Ba353lSg.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-D6ZrVnxS.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-BhPFNef-.cjs'); });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-QeQVW2rk.cjs'); });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-CP4kwgAn.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-C8oAIjua.cjs'); });
     return runDoctorCommand(...args);
 };
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-gXUjRvGB.cjs'); }).then(function (n) { return n.remote; });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-BbJbKVsT.cjs'); }).then(function (n) { return n.remote; });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {

package/dist/cli-chunks/{login-DMNap0-y.cjs → login-4Z2z6QRT.cjs}

@@ -3,9 +3,9 @@
 var promises = require('node:readline/promises');
 var node_crypto = require('node:crypto');
 var node_http = require('node:http');
-var session = require('./session-D5Vf-fNZ.cjs');
+var session = require('./session-D6CnwMrc.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-DeamIV1-.cjs');
+var index = require('./index-ZyZW5yLP.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{remote-gXUjRvGB.cjs → remote-BbJbKVsT.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var session = require('./session-D5Vf-fNZ.cjs');
+var session = require('./session-D6CnwMrc.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
 var path = require('node:path');
-var index = require('./index-DeamIV1-.cjs');
+var index = require('./index-ZyZW5yLP.cjs');
 
 var re = {exports: {}};
 
@@ -3115,7 +3115,7 @@ async function createDefaultCosClient(uploadToken) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-BfpHPA6k.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-Cui92wKP.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {

package/dist/cli-chunks/{session-D5Vf-fNZ.cjs → session-D6CnwMrc.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./index-DeamIV1-.cjs');
+var index = require('./index-ZyZW5yLP.cjs');
 var node_crypto = require('node:crypto');
 var path = require('node:path');
 var require$$0$2 = require('fs');

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var index = require('./cli-chunks/index-DeamIV1-.cjs');
+var index = require('./cli-chunks/index-ZyZW5yLP.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heybox/hb-sdk",
-  "version": "0.5.12",
+  "version": "0.5.15",
   "description": "",
   "exports": {
     ".": {

package/skill/references/api-protocol.md

@@ -201,12 +201,12 @@ Reference 由 `@heybox/hb-sdk` 的公开导出与源码注释自动生成，不
 
 | 导出面 | 说明 |
 | --- | --- |
-| [Root API](./root/) | 来自 `src/index.ts` 的默认导出、命名导出与公开能力。 |
-| [Protocol API](./protocol/) | 来自 `src/protocol.ts` 的协议常量、消息类型与 method 契约。 |
+| [Root API](api-root.md) | 来自 `src/index.ts` 的默认导出、命名导出与公开能力。 |
+| [Protocol API](#public-protocol-entrypoint) | 来自 `src/protocol.ts` 的协议常量、消息类型与 method 契约。 |
 
 ## 查询建议
 
-- 想查业务接入路径：先看 [Guide](../guide/)。
+- 想查业务接入路径：先看 [Guide](recipes.md)。
 - 想查导出符号：从 Root API 或 Protocol API 进入对应分类页。
 - 想看场景化用法：优先看 Guide / Recipes 页面中的“进一步阅读”。
 

package/skill/references/api-root.md

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

package/skill/references/recipes.md

@@ -76,7 +76,7 @@ stopAuthChange()
 
 默认单例适合一个页面只有一个 SDK 上下文的情况。大多数小程序页面都应该使用默认单例，因为它可以避免重复握手和重复维护事件监听。
 
-需要控制 `timeout`、注入测试 window 或隔离多个上下文时，再使用 [独立实例](../recipes/custom-instance)。
+需要控制 `timeout`、注入测试 window 或隔离多个上下文时，再使用 [独立实例](#custom-instance-recipe)。
 
 ## User and login
 
@@ -193,8 +193,8 @@ stop()
 
 完整载荷与事件名见：
 
-- [MiniProgramEventPayloadMap](../reference/protocol/interfaces/MiniProgramEventPayloadMap)
-- [MiniProgramEventName](../reference/protocol/types/#miniprogrameventname)
+- [MiniProgramEventPayloadMap](api-root.md)
+- [MiniProgramEventName](api-root.md)
 
 ## 生命周期建议
 

package/skill/scripts/sync-references.mjs

@@ -89,6 +89,20 @@ function frontmatterless(markdown) {
   return markdown.replace(/^---\n[\s\S]*?\n---\n/, '').trimEnd();
 }
 
+function rewriteBundledRecipeLinks(markdown) {
+  return markdown
+    .replaceAll('(../recipes/custom-instance)', '(#custom-instance-recipe)')
+    .replaceAll('(../reference/protocol/interfaces/MiniProgramEventPayloadMap)', '(api-root.md)')
+    .replaceAll('(../reference/protocol/types/#miniprogrameventname)', '(api-root.md)');
+}
+
+function rewriteBundledProtocolIndexLinks(markdown) {
+  return markdown
+    .replaceAll('(./root/)', '(api-root.md)')
+    .replaceAll('(./protocol/)', '(#public-protocol-entrypoint)')
+    .replaceAll('(../guide/)', '(recipes.md)');
+}
+
 function contents(items) {
   return [
     '',
@@ -318,7 +332,7 @@ ${sdkRuntimeRelation}
 
 ## Generated reference index
 
-${referenceHome}
+${rewriteBundledProtocolIndexLinks(referenceHome)}
 `);
 
 files.set('cli.md', `${header('CLI reference', [
@@ -476,27 +490,27 @@ files.set('recipes.md', `${header('Recipes', [
   ['Custom instance recipe', 'custom-instance-recipe'],
 ])}## Quick start
 
-${quickStart}
+${rewriteBundledRecipeLinks(quickStart)}
 
 ## User and login
 
-${authGuide}
+${rewriteBundledRecipeLinks(authGuide)}
 
 ## Lifecycle events
 
-${lifecycleGuide}
+${rewriteBundledRecipeLinks(lifecycleGuide)}
 
 ## Error handling
 
-${errorGuide}
+${rewriteBundledRecipeLinks(errorGuide)}
 
 ## Login gate recipe
 
-${loginGate}
+${rewriteBundledRecipeLinks(loginGate)}
 
 ## Custom instance recipe
 
-${customInstance}
+${rewriteBundledRecipeLinks(customInstance)}
 `);
 
 files.set('safety-boundaries.md', `${header('Safety boundaries', [

package/skill/scripts/validate-skill.mjs

@@ -70,6 +70,23 @@ function parseFrontmatter(markdown) {
   return fields;
 }
 
+function validateLocalMarkdownLinks(filePath, markdown) {
+  const linkPattern = /\[[^\]]*\]\(([^)]+)\)/g;
+  for (const match of markdown.matchAll(linkPattern)) {
+    const rawTarget = match[1].trim().replace(/^<|>$/g, '');
+    if (/^(?:https?:|mailto:|#)/i.test(rawTarget)) continue;
+
+    const targetWithoutAnchor = rawTarget.split('#')[0];
+    if (!targetWithoutAnchor) continue;
+
+    const resolved = path.resolve(path.dirname(filePath), targetWithoutAnchor);
+    if (!existsSync(resolved)) {
+      const line = markdown.slice(0, match.index).split('\n').length;
+      fail(`Broken local Markdown link in ${skillRel(filePath)}:${line}: ${rawTarget}`);
+    }
+  }
+}
+
 const requiredFiles = [
   'SKILL.md',
   'skill.json',
@@ -180,6 +197,7 @@ const removedUserLoginPattern = /\b(?:hbSDK\.)?user\.login\s*\(/;
 for (const file of textFiles) {
   const relative = skillRel(file);
   const content = read(file);
+  if (file.endsWith('.md')) validateLocalMarkdownLinks(file, content);
   if (removedUserLoginPattern.test(content)) {
     fail(`Removed API guidance found in ${relative}: use auth.login() instead of user.login().`);
   }

package/skill/skill.json

@@ -1,11 +1,11 @@
 {
   "name": "hb-sdk",
-  "skillVersion": "0.5.11+skill.c0b2205c74df",
+  "skillVersion": "0.5.14+skill.2ed2b210acdb",
   "sdk": {
     "package": "@heybox/hb-sdk",
-    "version": "0.5.11",
-    "compatibility": "0.5.11"
+    "version": "0.5.14",
+    "compatibility": "0.5.14"
   },
   "source": "https://open.xiaoheihe.cn/agent-skills/hb-sdk",
-  "integrity": "sha256-c0b2205c74df6a619a08d4f9a974d89a796d1783cc30a1d698d875bd179fd8c3"
+  "integrity": "sha256-2ed2b210acdb606888cde6fb80559ce26500c105b143914910b88b3d6b06eaf9"
 }