@heybox/hb-sdk 0.8.0-alpha.2 → 0.8.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.8.0-alpha.3
+
+### SDK / Agent Skill
+
+- Agent Skill 合并至 `@heybox/hb-sdk` npm 包，使用 `hb-sdk skill install`（项目）或 `hb-sdk skill install --global`（用户级）安装。
+- 要求 Node.js `>=22.20.0`；安装会校验项目 SDK 版本并维护 `skills-lock.json`，内容被修改时需使用 `--force` 覆盖。
+- `hb-sdk doctor` 改为本地多 Agent 诊断并支持 `--json`；Open 站点仅保留旧版只读兼容快照，不再持续发布。
+
 ## 0.8.0-alpha.2
 
 ### SDK

package/README.md

@@ -2,6 +2,8 @@
 
 小黑盒 APP 小程序工坊的前端 SDK 与开发 CLI，用于创建、调试、构建和发布工坊小程序，并在业务页面中调用小黑盒开放能力。
 
+运行环境要求 Node.js `>=22.20.0`。`@heybox/hb-sdk` npm 包同时包含与当前 SDK 版本严格对应的 Agent Skill；Skill 不再依赖 Open 远端分发。
+
 SDK 只提供面向小程序开发者的稳定接口，不提供客户端内部协议、登录凭据或私有实现入口。本地浏览器调试请使用 `hb-sdk dev` 提供的 Mock 环境，发布前仍需在小黑盒 APP 中完成真机验收。
 
 宿主集成边界：`@heybox/hb-sdk-runtime` 运行在 iframe 外并负责 bridge/Host Port；跨 iframe 的 wire contract 唯一维护在零依赖 `@heybox/hb-sdk-protocol`。业务页面不需要创建 Runtime、实现 Host Port 或导入协议包；客户端 SDK 只依赖已兼容 re-export 的 `@heybox/hb-sdk/protocol`。
@@ -25,6 +27,24 @@ npm run dev
 npm install @heybox/hb-sdk
 ```
 
+### 安装 Agent Skill
+
+在项目目录安装到项目 Agent 目录：
+
+```bash
+hb-sdk skill install
+```
+
+安装到当前用户目录，或指定 Agent：
+
+```bash
+hb-sdk skill install --global
+hb-sdk skill install --agent codex cursor
+hb-sdk skill install --all-agents
+```
+
+使用 `hb-sdk doctor` 或 `hb-sdk doctor --json` 检查各 Agent 的 Skill 是否与当前 npm 包匹配；已有内容被修改时，使用 `--force` 才会覆盖。
+
 SDK 会在导入时启动握手，能力调用会自动等待 SDK 就绪。未开通网络权限的小程序通过 `user.getInfo()` 静默读取当前小程序内的隔离身份和公开资料：
 
 需要可信用户手势的按钮不能在点击回调里等待握手。页面加载时先用 `getHandshakeState()` 读取当前状态，再用 `onHandshakeStateChange()` 订阅并立即接收当前状态；仅在 `status === 'ready'` 时启用按钮，并在组件或页面销毁时调用订阅返回的取消函数。`ready` 生命周期事件只是握手成功瞬间派发、不会重放的边沿通知，不能用来判断当前状态。

package/dist/cli-chunks/{build-CCLWgXyA.cjs → build-qWzAbpS7.cjs}

@@ -5,8 +5,8 @@ var fs = require('node:fs/promises');
 var path = require('node:path');
 var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 var runtimeGate = require('./runtime-gate-DFjw66kF.cjs');
-var index = require('./index-BL5eEPap.cjs');
-var projectVite = require('./project-vite-Qu6Xe9Dn.cjs');
+var index = require('./index-De687C6-.cjs');
+var projectVite = require('./project-vite-1rvkK-M8.cjs');
 require('node:async_hooks');
 require('node:module');
 require('path');

package/dist/cli-chunks/{context-Brh56h56.cjs → context-CtS2Thp0.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var session = require('./session-D-_N3WVL.cjs');
+var session = require('./session-CzaM2Cq3.cjs');
 var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');

package/dist/cli-chunks/{create-BZ-hi2s1.cjs → create-PV5ua977.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-BL5eEPap.cjs');
+var index = require('./index-De687C6-.cjs');
 require('node:module');
 require('os');
 require('readline');

package/dist/cli-chunks/{dev-CoSXtEYa.cjs → dev-CwKbAm_H.cjs}

@@ -8,15 +8,16 @@ var node_crypto = require('node:crypto');
 var promises = require('node:dns/promises');
 var node_http = require('node:http');
 var node_module = require('node:module');
-var context = require('./context-Brh56h56.cjs');
+var context = require('./context-CtS2Thp0.cjs');
 var undici = require('undici');
 var fs$1 = require('node:fs/promises');
-var index = require('./index-BL5eEPap.cjs');
+var index = require('./index-De687C6-.cjs');
 var require$$0$1 = require('crypto');
 var require$$0 = require('buffer');
-var session = require('./session-D-_N3WVL.cjs');
+var session = require('./session-CzaM2Cq3.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var projectVite = require('./project-vite-Qu6Xe9Dn.cjs');
+var projectVite = require('./project-vite-1rvkK-M8.cjs');
+var version = require('./version-Bz-AfXQU.cjs');
 var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
@@ -1850,8 +1851,8 @@ const DEFAULT_CHANNEL_TRANSPORT = {
 };
 const IPV4_LOOPBACK_ADDRESSES = new net.BlockList();
 IPV4_LOOPBACK_ADDRESSES.addSubnet('127.0.0.0', 8, 'ipv4');
-const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-CoSXtEYa.cjs', document.baseURI).href)))('ws');
-const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-CoSXtEYa.cjs', document.baseURI).href)))('parse5');
+const { WebSocket, WebSocketServer } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-CwKbAm_H.cjs', document.baseURI).href)))('ws');
+const { parse: parseHtml } = node_module.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli-chunks/dev-CwKbAm_H.cjs', document.baseURI).href)))('parse5');
 const BROWSER_DEV_HOST_ROOT_CANDIDATES = [
     path.resolve(__dirname, 'devtools/browser-dev-host'),
     path.resolve(__dirname, '../devtools/browser-dev-host'),
@@ -10894,7 +10895,7 @@ function assertNodeRuntimeCapabilities(ctx, settings) {
 function createNodeRealtimeDriverRegistry() {
     const registry = createRuntimeRealtimeDriverRegistry();
     registry.registerLazy('node-websocket', async () => {
-        const mod = await Promise.resolve().then(function () { return require('./index.esm-BoBHPfpq.cjs'); });
+        const mod = await Promise.resolve().then(function () { return require('./index.esm-B-4yrLNm.cjs'); });
         return mod.createNodeWebSocketRuntimeDriver();
     });
     return registry;
@@ -14954,11 +14955,6 @@ function writeLaunchResponse(response, status, body) {
     response.end(body ?? '');
 }
 
-/** 构建时替换为当前发布包的实际版本。 */
-const HB_SDK_VERSION = typeof undefined === 'string'
-    ? undefined
-    : '0.8.0-alpha.2';
-
 const DEFAULT_APP_PORT = 5173;
 const DEFAULT_BROWSER_DEV_HOST_PORT = 5174;
 const DEFAULT_DEV_CONTEXT_TIMEOUT_MS = 3000;
@@ -15006,7 +15002,7 @@ async function runDevCommand(options, runtime = {}) {
             localDevLaunchToken: currentLocalDevLaunchToken,
             miniProgramId: devLaunchContext.miniProgramId,
             runtimePermissions: launchRuntimePermissions,
-            sdkVersion: HB_SDK_VERSION,
+            sdkVersion: version.HB_SDK_VERSION,
         }));
         if (!handled)
             next();
@@ -15024,7 +15020,7 @@ async function runDevCommand(options, runtime = {}) {
         interfaces: networkInterfaceSnapshot,
         localDevLaunchToken: currentLocalDevLaunchToken,
         miniProgramId: devLaunchContext.miniProgramId,
-        sdkVersion: HB_SDK_VERSION,
+        sdkVersion: version.HB_SDK_VERSION,
         viteNetworkUrls: appServer.resolvedUrls?.network ?? [],
     });
     const lanAddresses = buildLanAddresses();

package/dist/cli-chunks/doctor-tJUGOYrm.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+var fs = require('node:fs/promises');
+var os = require('node:os');
+var path = require('node:path');
+var index = require('./index-De687C6-.cjs');
+require('node:module');
+require('node:fs');
+require('path');
+require('os');
+require('readline');
+require('tty');
+require('assert');
+require('events');
+require('stream');
+require('buffer');
+require('util');
+
+const CANDIDATES = [path.resolve(__dirname, '..', 'package.json'), path.resolve(__dirname, '..', '..', 'package.json'), path.resolve(__dirname, '..', '..', '..', 'package.json')];
+const AGENTS = ['codex', 'claude', 'cursor'];
+async function runDoctorCommand(runtime = {}) {
+    const logger = runtime.logger ?? index.createCliLogger();
+    const result = await logger.task('正在检查本地 Agent Skill', () => getDoctorResult(runtime), { successText: 'Agent Skill 检查完成' });
+    if (runtime.json)
+        logger.raw(JSON.stringify(result));
+    else {
+        logger.section('Doctor');
+        logger.info(`SDK version: ${result.currentSdkVersion}`);
+        for (const a of result.agents)
+            logger.info(`${a.agent}: ${a.status}${a.skillVersion ? ` (${a.skillVersion})` : ''}`);
+        logger.info(`Status: ${result.status}`);
+        if (result.status !== 'OK')
+            logger.warn('请运行 hb-sdk skill install 安装或更新对应 Skill。');
+    }
+    return result;
+}
+async function getDoctorResult(runtime = {}) {
+    const version = await readVersion(runtime.packageJsonFiles);
+    const results = await Promise.all((runtime.agentNames ?? AGENTS).map(a => inspect(a, version, runtime)));
+    const status = results.every(a => a.status === 'OK') ? 'OK' : results.find(a => a.status !== 'OK').status;
+    return { currentSdkVersion: version, status, agents: results, localSkillJsonPath: results[0]?.path ?? '', localSkillVersion: results[0]?.skillVersion };
+}
+async function inspect(agent, version, runtime) {
+    const home = runtime.agentRoots?.[agent] ?? runtime.env?.[`${agent.toUpperCase()}_HOME`] ?? process.env[`${agent.toUpperCase()}_HOME`] ?? path.join(os.homedir(), `.${agent}`);
+    const file = path.join(home, 'skills', index.HB_SDK_SKILL_NAME, 'skill.json');
+    try {
+        const m = JSON.parse(await fs.readFile(file, 'utf8'));
+        const ok = m.name === index.HB_SDK_SKILL_NAME && m.sdk?.package === index.HB_SDK_PACKAGE_NAME && m.sdk?.version === version && m.distribution?.type === 'npm' && m.distribution?.package === index.HB_SDK_PACKAGE_NAME && m.distribution?.version === version && m.skillVersion?.startsWith(`${version}+skill.`);
+        return { agent, path: file, status: ok ? 'OK' : 'SKILL_OUTDATED', skillVersion: m.skillVersion };
+    }
+    catch {
+        return { agent, path: file, status: 'SKILL_MISSING' };
+    }
+}
+async function readVersion(files = CANDIDATES) { for (const file of files) {
+    try {
+        const m = JSON.parse(await fs.readFile(file, 'utf8'));
+        if (typeof m.version === 'string' && m.version)
+            return m.version;
+    }
+    catch { }
+} throw new Error(`未能读取 ${index.HB_SDK_PACKAGE_NAME} 当前版本号`); }
+
+exports.getDoctorResult = getDoctorResult;
+exports.runDoctorCommand = runDoctorCommand;

package/dist/cli-chunks/{index-CS6Q0o5C.cjs → index-DVuD75Hr.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var index$2 = require('./index-BL5eEPap.cjs');
+var index$2 = require('./index-De687C6-.cjs');
 var require$$0$3 = require('fs');
 var require$$0$2 = require('crypto');
 var require$$1$2 = require('path');

package/dist/cli-chunks/{index-BL5eEPap.cjs → index-De687C6-.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-BL5eEPap.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-De687C6-.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-BL5eEPap.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-De687C6-.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-BL5eEPap.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-De687C6-.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-BL5eEPap.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-De687C6-.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-BL5eEPap.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-De687C6-.cjs', document.baseURI).href)));
 function __require() { return require$1("node:process"); }
 
 var help = {};
@@ -3883,10 +3883,6 @@ var envPaths = /*@__PURE__*/getDefaultExportFromCjs(envPathsExports);
 
 const HB_SDK_PACKAGE_NAME = '@heybox/hb-sdk';
 const HB_SDK_SKILL_NAME = 'hb-sdk';
-const HB_SDK_AGENT_SKILLS_BASE_URL = 'https://open.xiaoheihe.cn/agent-skills';
-const HB_SDK_SKILL_SOURCE = `${HB_SDK_AGENT_SKILLS_BASE_URL}/${HB_SDK_SKILL_NAME}`;
-const HB_SDK_SKILL_INDEX_URL = `${HB_SDK_AGENT_SKILLS_BASE_URL}/.well-known/agent-skills/index.json`;
-const HB_SDK_SKILL_INSTALL_COMMAND = `npx skills add ${HB_SDK_SKILL_SOURCE}`;
 
 var ora$1 = {exports: {}};
 
@@ -13347,7 +13343,7 @@ function getPathname(pathWithQuery) {
 }
 
 const CLI_VERSION_PLACEHOLDER = ['__HB', 'SDK', 'CLI', 'VERSION__'].join('_');
-const BUILT_CLI_VERSION = '0.8.0-alpha.2';
+const BUILT_CLI_VERSION = '0.8.0-alpha.3';
 const PACKAGE_JSON_CANDIDATES = [
     path.resolve(__dirname, '..', '..', 'package.json'),
     path.resolve(__dirname, '..', 'package.json'),
@@ -13412,6 +13408,7 @@ function createCliProgram(overrides = {}) {
         runDevCommand: defaultRunDevCommand,
         runDoctorCommand: defaultRunDoctorCommand,
         runRemoteCommand: defaultRunRemoteCommand,
+        runSkillInstallCommand: defaultRunSkillInstallCommand,
         ...overrides,
     };
     const program = new Command();
@@ -13451,9 +13448,20 @@ function createCliProgram(overrides = {}) {
         await handlers.runBuildCommand({}, { logger });
     });
     installRemoteCommands(program, handlers, resolveLogger);
-    addVerboseOption(program.command('doctor').description('诊断 hb-sdk 本地环境和 Agent Skill 版本')).action(async (...args) => {
-        const logger = resolveLogger(readCommandFromActionArgs(args));
-        const result = await handlers.runDoctorCommand({ logger });
+    const skill = addVerboseOption(program.command('skill').description('管理 Agent Skill'));
+    skill.command('install')
+        .option('--global', '安装到用户级 Agent 目录')
+        .option('--agent <agents...>', '指定 Agent')
+        .option('--all-agents', '安装到所有检测到的 Agent')
+        .option('--force', '覆盖已存在且被修改的 Skill')
+        .action(async (options, command) => {
+        const logger = resolveLogger(command);
+        await handlers.runSkillInstallCommand({ ...options, logger });
+    });
+    addVerboseOption(program.command('doctor').description('诊断 hb-sdk 本地环境和 Agent Skill 版本').option('--json', '以 JSON 格式输出诊断结果')).action(async (...args) => {
+        const command = readCommandFromActionArgs(args);
+        const logger = resolveLogger(command);
+        const result = await handlers.runDoctorCommand({ logger, json: Boolean(command?.opts().json) });
         if (result.status !== 'SDK_MISMATCH') {
             await handlers.printUpdateReminder({ logger });
         }
@@ -13682,35 +13690,39 @@ function createCommandLoggerResolver(options) {
     };
 }
 const defaultClearLoginStatus = async (...args) => {
-    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-CILLxGuf.cjs'); });
+    const { clearLoginStatus } = await Promise.resolve().then(function () { return require('./login-DolpqD8K.cjs'); });
     return clearLoginStatus(...args);
 };
 const defaultLoginToHeybox = async (...args) => {
-    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-CILLxGuf.cjs'); });
+    const { loginToHeybox } = await Promise.resolve().then(function () { return require('./login-DolpqD8K.cjs'); });
     return loginToHeybox(...args);
 };
 const defaultPrintLoginStatus = async (...args) => {
-    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-CILLxGuf.cjs'); });
+    const { printLoginStatus } = await Promise.resolve().then(function () { return require('./login-DolpqD8K.cjs'); });
     return printLoginStatus(...args);
 };
 const defaultRunBuildCommand = async (...args) => {
-    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-CCLWgXyA.cjs'); });
+    const { runBuildCommand } = await Promise.resolve().then(function () { return require('./build-qWzAbpS7.cjs'); });
     return runBuildCommand(...args);
 };
 const defaultRunCreateCommand = async (...args) => {
-    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-BZ-hi2s1.cjs'); });
+    const { runCreateCommand } = await Promise.resolve().then(function () { return require('./create-PV5ua977.cjs'); });
     return runCreateCommand(...args);
 };
 const defaultRunDevCommand = async (...args) => {
-    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-CoSXtEYa.cjs'); }).then(function (n) { return n.dev; });
+    const { runDevCommand } = await Promise.resolve().then(function () { return require('./dev-CwKbAm_H.cjs'); }).then(function (n) { return n.dev; });
     return runDevCommand(...args);
 };
 const defaultRunDoctorCommand = async (...args) => {
-    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-EsCYJGhV.cjs'); });
+    const { runDoctorCommand } = await Promise.resolve().then(function () { return require('./doctor-tJUGOYrm.cjs'); });
     return runDoctorCommand(...args);
 };
+const defaultRunSkillInstallCommand = async (...args) => {
+    const { runSkillInstallCommand } = await Promise.resolve().then(function () { return require('./skill-CM40_9WH.cjs'); });
+    return runSkillInstallCommand(...args);
+};
 const defaultRunRemoteCommand = async (...args) => {
-    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-DRuTQ51u.cjs'); });
+    const { runRemoteCommand } = await Promise.resolve().then(function () { return require('./remote-rIAQE_G2.cjs'); });
     return runRemoteCommand(...args);
 };
 function resolveStandaloneLogger(options, verbose) {
@@ -13804,10 +13816,7 @@ function parseNonNegativeInteger(value) {
 
 exports.CliError = CliError;
 exports.HB_SDK_PACKAGE_NAME = HB_SDK_PACKAGE_NAME;
-exports.HB_SDK_SKILL_INDEX_URL = HB_SDK_SKILL_INDEX_URL;
-exports.HB_SDK_SKILL_INSTALL_COMMAND = HB_SDK_SKILL_INSTALL_COMMAND;
 exports.HB_SDK_SKILL_NAME = HB_SDK_SKILL_NAME;
-exports.HB_SDK_SKILL_SOURCE = HB_SDK_SKILL_SOURCE;
 exports.applyServiceTagIfNeeded = applyServiceTagIfNeeded;
 exports.commonjsGlobal = commonjsGlobal;
 exports.createCliLogger = createCliLogger;

package/dist/cli-chunks/{index.esm-BoBHPfpq.cjs → index.esm-B-4yrLNm.cjs}

@@ -11,8 +11,8 @@ var require$$0$4 = require('url');
 var require$$0 = require('zlib');
 var require$$0$1 = require('buffer');
 var require$$1 = require('util');
-var index = require('./index-BL5eEPap.cjs');
-var dev = require('./dev-CoSXtEYa.cjs');
+var index = require('./index-De687C6-.cjs');
+var dev = require('./dev-CwKbAm_H.cjs');
 require('node:module');
 require('node:fs');
 require('node:fs/promises');
@@ -27,8 +27,8 @@ require('node:net');
 require('node:crypto');
 require('node:dns/promises');
 require('node:http');
-require('./context-Brh56h56.cjs');
-require('./session-D-_N3WVL.cjs');
+require('./context-CtS2Thp0.cjs');
+require('./session-CzaM2Cq3.cjs');
 require('fs');
 require('constants');
 require('./runtime-permission-env-CjsCe5bp.cjs');
@@ -40,7 +40,8 @@ require('node:buffer');
 require('node:url');
 require('node:util');
 require('node:child_process');
-require('./project-vite-Qu6Xe9Dn.cjs');
+require('./project-vite-1rvkK-M8.cjs');
+require('./version-Bz-AfXQU.cjs');
 
 var bufferUtil = {exports: {}};
 

package/dist/cli-chunks/{login-CILLxGuf.cjs → login-DolpqD8K.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-D-_N3WVL.cjs');
+var session = require('./session-CzaM2Cq3.cjs');
 var browser = require('./browser-RAy8e8cV.cjs');
-var index = require('./index-BL5eEPap.cjs');
+var index = require('./index-De687C6-.cjs');
 require('node:path');
 require('fs');
 require('constants');

package/dist/cli-chunks/{project-vite-Qu6Xe9Dn.cjs → project-vite-1rvkK-M8.cjs}

@@ -5,7 +5,7 @@ var fs$1 = require('node:fs/promises');
 var node_module = require('node:module');
 var path = require('node:path');
 var node_url = require('node:url');
-var index = require('./index-BL5eEPap.cjs');
+var index = require('./index-De687C6-.cjs');
 
 function findProjectRoot(startDir) {
     let current = path.resolve(startDir);

package/dist/cli-chunks/{remote-DRuTQ51u.cjs → remote-rIAQE_G2.cjs}

@@ -1,8 +1,8 @@
 'use strict';
 
 var promises = require('node:readline/promises');
-var index = require('./index-BL5eEPap.cjs');
-var session = require('./session-D-_N3WVL.cjs');
+var index = require('./index-De687C6-.cjs');
+var session = require('./session-CzaM2Cq3.cjs');
 var childProcess = require('node:child_process');
 var fs = require('node:fs');
 var fs$1 = require('node:fs/promises');
@@ -10,7 +10,7 @@ var path = require('node:path');
 var runtimePermissionEnv = require('./runtime-permission-env-CjsCe5bp.cjs');
 var runtimeGate = require('./runtime-gate-DFjw66kF.cjs');
 var node_crypto = require('node:crypto');
-var context = require('./context-Brh56h56.cjs');
+var context = require('./context-CtS2Thp0.cjs');
 require('node:module');
 require('path');
 require('os');
@@ -271,7 +271,7 @@ function createDefaultCosClient(uploadToken, COS) {
     };
 }
 async function loadCosConstructor() {
-    const cosModule = await Promise.resolve().then(function () { return require('./index-CS6Q0o5C.cjs'); }).then(function (n) { return n.index; });
+    const cosModule = await Promise.resolve().then(function () { return require('./index-DVuD75Hr.cjs'); }).then(function (n) { return n.index; });
     return cosModule.default;
 }
 function formatSize(bytes) {

package/dist/cli-chunks/{session-D-_N3WVL.cjs → session-CzaM2Cq3.cjs}

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

package/dist/cli-chunks/skill-CM40_9WH.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+var path = require('node:path');
+var version = require('./version-Bz-AfXQU.cjs');
+var childProcess = require('node:child_process');
+var fs = require('node:fs/promises');
+var index = require('./index-De687C6-.cjs');
+require('node:module');
+require('node:fs');
+require('path');
+require('os');
+require('readline');
+require('tty');
+require('assert');
+require('events');
+require('stream');
+require('buffer');
+require('util');
+
+function installSkill(options) {
+    const binary = require.resolve('skills/bin/cli.mjs');
+    const args = ['add', path.join(options.packageRoot, 'skill'), '--copy'];
+    if (options.global)
+        args.push('--global');
+    if (options.allAgents)
+        args.push('--agent', '*');
+    else if (options.agents?.length)
+        args.push('--agent', ...options.agents);
+    if (options.force)
+        args.push('--force');
+    const env = { ...process.env, ...options.env, DISABLE_TELEMETRY: '1', DO_NOT_TRACK: '1' };
+    const run = options.spawnImpl ?? childProcess.spawn;
+    return new Promise((resolve, reject) => {
+        const child = run(process.execPath, [binary, ...args], { cwd: options.cwd, env, stdio: 'inherit' });
+        child.on('error', reject);
+        child.on('close', (code) => resolve({ code: code ?? 1 }));
+    });
+}
+
+async function findProjectPackageJson(cwd = process.cwd()) {
+    let current = path.resolve(cwd);
+    while (true) {
+        const candidate = path.join(current, 'package.json');
+        try {
+            await fs.access(candidate);
+            return candidate;
+        }
+        catch { /* continue */ }
+        const parent = path.dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+async function verifyProjectSdk(cwd, version) {
+    const file = await findProjectPackageJson(cwd);
+    if (!file)
+        throw new Error('未找到项目 package.json，请在项目目录执行');
+    const pkg = JSON.parse(await fs.readFile(file, 'utf8'));
+    const declared = pkg.dependencies?.['@heybox/hb-sdk'] ?? pkg.devDependencies?.['@heybox/hb-sdk'];
+    if (!declared)
+        throw new Error('项目缺少 @heybox/hb-sdk 依赖');
+    if (declared !== version && !String(declared).includes(version)) {
+        throw new Error(`项目 @heybox/hb-sdk 版本 ${declared} 与 CLI ${version} 不一致`);
+    }
+}
+
+async function runSkillInstallCommand(options = {}) {
+    if (options.agent?.length && options.allAgents)
+        throw new Error('--agent 与 --all-agents 互斥');
+    const logger = options.logger ?? index.createCliLogger();
+    const packageRoot = options.packageRoot ?? path.resolve(__dirname, '../../..');
+    const cwd = options.cwd ?? process.cwd();
+    if (!options.global)
+        await verifyProjectSdk(cwd, version.HB_SDK_VERSION);
+    const result = await installSkill({ packageRoot, cwd, global: options.global, agents: options.agent, allAgents: options.allAgents, force: options.force });
+    if (result.code !== 0)
+        throw new Error(`Skill 安装失败（退出码 ${result.code}）`);
+    logger.success('hb-sdk Skill 安装完成');
+    return result;
+}
+
+exports.runSkillInstallCommand = runSkillInstallCommand;

package/dist/cli-chunks/version-Bz-AfXQU.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+/** 构建时替换为当前发布包的实际版本。 */
+const HB_SDK_VERSION = typeof undefined === 'string'
+    ? undefined
+    : '0.8.0-alpha.3';
+
+exports.HB_SDK_VERSION = HB_SDK_VERSION;

package/dist/cli.cjs

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

package/dist/index.cjs.js

@@ -785,7 +785,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.0-alpha.2';
+    : '0.8.0-alpha.3';
 
 const DEFAULT_TIMEOUT = 10000;
 const HANDSHAKE_RETRY_INTERVAL = 250;

package/dist/index.esm.js

@@ -781,7 +781,7 @@ function createMessageId() {
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.0-alpha.2';
+    : '0.8.0-alpha.3';
 
 const DEFAULT_TIMEOUT = 10000;
 const HANDSHAKE_RETRY_INTERVAL = 250;

package/dist/vite.cjs.js

@@ -8,7 +8,7 @@ var _documentCurrentScript = typeof document !== 'undefined' ? document.currentS
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.0-alpha.2';
+    : '0.8.0-alpha.3';
 
 var re = {exports: {}};
 

package/dist/vite.esm.js

@@ -5,7 +5,7 @@ import { AsyncLocalStorage } from 'node:async_hooks';
 /** 构建时替换为当前发布包的实际版本。 */
 const HB_SDK_VERSION = typeof undefined === 'string'
     ? undefined
-    : '0.8.0-alpha.2';
+    : '0.8.0-alpha.3';
 
 var re = {exports: {}};