@botanee/skillhub-cli 1.0.6

package/bin/run

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+// eslint-disable-next-line node/shebang
+import { run, Errors } from '@oclif/core'
+
+run(undefined, import.meta.url)
+  .then(async () => {
+    process.exit(0)
+  })
+  .catch(async (err) => {
+    // 简化错误输出，只显示消息
+    if (err instanceof Errors.CLIError) {
+      console.error(err.message)
+      process.exit(1)
+    }
+    // 其他错误显示完整堆栈
+    console.error(err)
+    process.exit(1)
+  })

package/dist/commands/agent-login.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../index';
+export default class AgentLogin extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        'agent-id': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'workspace-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'deployment-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        environment: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'agent-type': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private sleep;
+}

package/dist/commands/agent-login.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const cli_ux_1 = __importDefault(require("cli-ux"));
+const axios_1 = __importDefault(require("axios"));
+const index_1 = require("../index");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const qrcodeTerminal = require('qrcode-terminal');
+class AgentLogin extends index_1.BaseCommand {
+    static description = '远程 Agent 登录 BtnSkillHub 平台';
+    static examples = [
+        '$ btnskill agent-login --agent-id openclaw-prod-01',
+        '$ btnskill agent-login --agent-id codex-prod-01 --agent-type codex',
+    ];
+    static flags = {
+        help: core_1.Flags.help({ char: 'h' }),
+        'agent-id': core_1.Flags.string({
+            description: 'Agent 唯一标识',
+            required: true,
+        }),
+        'workspace-id': core_1.Flags.string({
+            description: 'Agent 所属工作区标识',
+        }),
+        'deployment-id': core_1.Flags.string({
+            description: 'Agent 部署实例标识',
+        }),
+        environment: core_1.Flags.string({
+            description: '运行环境，例如 prod/staging',
+        }),
+        'agent-type': core_1.Flags.string({
+            description: 'Agent 类型，例如 openclaw/claude-code/codex',
+            default: 'openclaw',
+        }),
+        timeout: core_1.Flags.integer({
+            description: '最长等待授权时间（秒）',
+            default: 600,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AgentLogin);
+        this.log(chalk_1.default.blue('\n🤖 BtnSkillHub Agent 登录\n'));
+        const startResponse = await axios_1.default.post(`${this.apiBaseUrl}/auth/agent/start`, {
+            agentId: flags['agent-id'],
+            workspaceId: flags['workspace-id'],
+            deploymentId: flags['deployment-id'],
+            environment: flags.environment,
+            agentType: flags['agent-type'],
+        });
+        const loginData = startResponse.data.data;
+        this.log(`请让用户完成授权：\n`);
+        this.log(`链接:\n${chalk_1.default.cyan(loginData.verificationUriComplete)}\n`);
+        this.log(`授权码: ${chalk_1.default.bold(loginData.userCode)}`);
+        this.log(`二维码内容: ${chalk_1.default.gray(loginData.qrCodePayload)}\n`);
+        qrcodeTerminal.generate(loginData.qrCodePayload, { small: true }, (qr) => {
+            this.log(qr);
+        });
+        const expiresAt = Date.now() + Math.min(flags.timeout, loginData.expiresIn) * 1000;
+        const pollIntervalMs = Math.max(loginData.interval, 1) * 1000;
+        cli_ux_1.default.action.start('等待用户完成 Agent 授权');
+        while (Date.now() < expiresAt) {
+            await this.sleep(pollIntervalMs);
+            const pollResponse = await axios_1.default.post(`${this.apiBaseUrl}/auth/agent/poll`, {
+                agentCode: loginData.agentCode,
+            });
+            const result = pollResponse.data?.data;
+            if (result?.status === 'pending') {
+                continue;
+            }
+            if (result?.status === 'expired') {
+                cli_ux_1.default.action.stop('失败');
+                this.error('Agent 授权已过期，请重新执行 btnskill agent-login');
+            }
+            if (result?.status === 'revoked') {
+                cli_ux_1.default.action.stop('失败');
+                this.error('Agent 授权已被撤销');
+            }
+            if (result?.accessToken) {
+                this.storeAuthSession({
+                    accessToken: result.accessToken,
+                    refreshToken: result.refreshToken,
+                    agentId: flags['agent-id'],
+                    authMode: 'agent',
+                    agentType: flags['agent-type'],
+                });
+                cli_ux_1.default.action.stop();
+                this.log(chalk_1.default.green('\n✅ Agent 登录成功！'));
+                this.log('现在可以使用 btnskill 命令了\n');
+                return;
+            }
+        }
+        cli_ux_1.default.action.stop('失败');
+        this.error('等待授权超时，请重新执行 btnskill agent-login');
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.default = AgentLogin;

package/dist/commands/config.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../index';
+export default class Config extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+    };
+    static args: {
+        action: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        key: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+        value: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+    private resolveKey;
+    private printConfig;
+    private getConfig;
+    private setConfig;
+    private unsetConfig;
+}

package/dist/commands/config.js

@@ -0,0 +1,99 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const index_1 = require("../index");
+const KEY_ALIASES = {
+    registry: 'registry',
+    api: 'registry',
+    apiBaseUrl: 'registry',
+};
+class Config extends index_1.BaseCommand {
+    static description = '查看或设置 CLI 配置';
+    static examples = [
+        '$ btnskill config list',
+        '$ btnskill config get registry',
+        '$ btnskill config set registry https://skillhub.botanee.com.cn',
+        '$ btnskill config unset registry',
+    ];
+    static flags = {
+        help: core_1.Flags.help({ char: 'h' }),
+    };
+    static args = {
+        action: core_1.Args.string({ description: 'list | get | set | unset', required: false }),
+        key: core_1.Args.string({ description: '配置项名称', required: false }),
+        value: core_1.Args.string({ description: '配置项值', required: false }),
+    };
+    async run() {
+        const { args } = await this.parse(Config);
+        const action = args.action || 'list';
+        switch (action) {
+            case 'list':
+                this.printConfig();
+                return;
+            case 'get':
+                this.getConfig(args.key);
+                return;
+            case 'set':
+                this.setConfig(args.key, args.value);
+                return;
+            case 'unset':
+                this.unsetConfig(args.key);
+                return;
+            default:
+                this.error(`不支持的操作: ${action}`);
+        }
+    }
+    resolveKey(key) {
+        if (!key) {
+            this.error('请指定配置项，例如: btnskill config get registry');
+        }
+        const resolved = KEY_ALIASES[key];
+        if (!resolved) {
+            this.error(`不支持的配置项: ${key}`);
+        }
+        return resolved;
+    }
+    printConfig() {
+        const storedRegistry = this.getConfigValue('registry');
+        const envRegistry = process.env.API_BASE_URL;
+        this.log(chalk_1.default.blue('\n当前 CLI 配置:\n'));
+        this.log(`  registry (effective): ${chalk_1.default.cyan(this.apiBaseUrl)}`);
+        this.log(`  registry (stored): ${storedRegistry ? chalk_1.default.cyan(storedRegistry) : chalk_1.default.gray('(未设置)')}`);
+        this.log(`  API_BASE_URL (env): ${envRegistry ? chalk_1.default.cyan(envRegistry) : chalk_1.default.gray('(未设置)')}`);
+        if (envRegistry) {
+            this.log(chalk_1.default.yellow('\n环境变量 API_BASE_URL 优先级高于持久化 registry 配置。\n'));
+        }
+        else {
+            this.log();
+        }
+    }
+    getConfig(key) {
+        const resolvedKey = this.resolveKey(key);
+        if (resolvedKey === 'registry') {
+            this.log(this.apiBaseUrl);
+        }
+    }
+    setConfig(key, value) {
+        const resolvedKey = this.resolveKey(key);
+        if (!value) {
+            this.error('请提供配置值，例如: btnskill config set registry https://skillhub.botanee.com.cn');
+        }
+        if (resolvedKey === 'registry') {
+            const normalized = this.normalizeApiBaseUrl(value);
+            this.setConfigValue('registry', normalized);
+            this.log(chalk_1.default.green(`已保存 registry: ${normalized}`));
+        }
+    }
+    unsetConfig(key) {
+        const resolvedKey = this.resolveKey(key);
+        if (resolvedKey === 'registry') {
+            this.deleteConfigValue('registry');
+            this.log(chalk_1.default.green('已删除 registry 配置'));
+        }
+    }
+}
+exports.default = Config;

package/dist/commands/help.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class HelpCommand extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'nested-commands': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        command: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/help.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+class HelpCommand extends core_1.Command {
+    static description = '显示帮助信息';
+    static examples = ['$ btnskill help', '$ btnskill help search'];
+    static flags = {
+        'nested-commands': core_1.Flags.boolean({
+            description: 'Include all nested commands in the output.',
+        }),
+    };
+    static args = {
+        command: core_1.Args.string({ description: '要查看帮助的命令' }),
+    };
+    async run() {
+        const { argv, flags } = await this.parse(HelpCommand);
+        const help = new core_1.Help(this.config, { all: flags['nested-commands'] });
+        help.showHelp(argv);
+    }
+}
+exports.default = HelpCommand;

package/dist/commands/install.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../index';
+export default class Install extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        'agent-type': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        global: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        target: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    static args: {
+        skill: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+    private normalizeAxiosError;
+    private registerSkillToOpenClaw;
+}

package/dist/commands/install.js

@@ -0,0 +1,244 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const chalk_1 = __importDefault(require("chalk"));
+const cli_ux_1 = __importDefault(require("cli-ux"));
+const axios_1 = __importDefault(require("axios"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const index_1 = require("../index");
+const install_paths_1 = require("../lib/install-paths");
+class Install extends index_1.BaseCommand {
+    static description = '安装一个 Skill';
+    static examples = [
+        '$ btnskill install my-skill',
+        '$ btnskill install my-skill@1.0.0',
+        '$ btnskill install my-skill --agent-type claude-code',
+        '$ btnskill install my-skill --agent-type openclaw',
+        '$ btnskill install my-skill --agent-type codex',
+        '$ btnskill install my-skill --target ~/.custom-agent/skills',
+    ];
+    static flags = {
+        help: core_1.Flags.help({ char: 'h' }),
+        'agent-type': core_1.Flags.string({ description: `安装到指定 Agent 类型的 Skills 目录，支持 ${install_paths_1.SUPPORTED_INSTALL_AGENT_TYPES.join('/')}` }),
+        global: core_1.Flags.boolean({ char: 'g', description: '安装到默认 Agent 目录（兼容旧参数）' }),
+        target: core_1.Flags.string({ char: 't', description: '指定自定义 Skills 根目录，优先级高于 --agent-type' }),
+    };
+    static args = {
+        skill: core_1.Args.string({ description: 'Skill 名称 (可带版本号)', required: true }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Install);
+        const installTarget = (0, install_paths_1.resolveSkillsDir)({ target: flags.target, agentType: flags['agent-type'] });
+        if (installTarget.unsupportedAgentType) {
+            this.error(`不支持的 Agent 类型: ${installTarget.unsupportedAgentType}。当前支持: ${install_paths_1.SUPPORTED_INSTALL_AGENT_TYPES.join(', ')}`);
+        }
+        const token = await this.requireAuth();
+        // 解析 skill 名称和版本
+        const [name, version] = args.skill.split('@');
+        cli_ux_1.default.action.start(`正在安装 ${name}${version ? `@${version}` : ''}`);
+        try {
+            // 1. 获取 skill 基本信息
+            const response = await axios_1.default.get(`${this.apiBaseUrl}/skills/${encodeURIComponent(name)}`, {
+                headers: { Authorization: `Bearer ${token}` },
+            });
+            const skill = response.data.data;
+            const installedVersion = version || skill.version;
+            if (version) {
+                const versionsResponse = await axios_1.default.get(`${this.apiBaseUrl}/skills/${skill.id}/versions`, {
+                    headers: { Authorization: `Bearer ${token}` },
+                });
+                const matchedVersion = versionsResponse.data.data.find((item) => item.version === version);
+                if (!matchedVersion) {
+                    this.error(`未找到版本: ${version}`);
+                }
+            }
+            // 2. 确定安装目录（默认安装到通用 Agent 目录）
+            const installDir = installTarget.dir;
+            // 3. 通过受保护接口下载 skill 包
+            const skillDir = path.join(installDir, skill.name);
+            const tmpFile = path.join(os.tmpdir(), `${skill.name}-${installedVersion}-${Date.now()}.zip`);
+            const fileResponse = await axios_1.default.get(`${this.apiBaseUrl}/skills/${skill.id}/download${version ? `?version=${encodeURIComponent(version)}` : ''}`, {
+                headers: { Authorization: `Bearer ${token}` },
+                responseType: 'arraybuffer',
+            });
+            fs.writeFileSync(tmpFile, fileResponse.data);
+            // 4. 解压并安装
+            if (!fs.existsSync(installDir)) {
+                fs.mkdirSync(installDir, { recursive: true });
+            }
+            // 如果已存在，先删除
+            if (fs.existsSync(skillDir)) {
+                fs.rmSync(skillDir, { recursive: true });
+            }
+            // 解压到临时目录
+            const extractDir = path.join(os.tmpdir(), `extract-${Date.now()}`);
+            const zip = new adm_zip_1.default(tmpFile);
+            zip.extractAllTo(extractDir, true);
+            // 检查是否需要"提升"目录（如果解压后只有一个子目录）
+            const extractedItems = fs.readdirSync(extractDir);
+            let sourceDir = extractDir;
+            // 过滤掉 __MACOSX 等隐藏目录
+            const validItems = extractedItems.filter(item => !item.startsWith('.') && !item.startsWith('__MACOSX'));
+            if (validItems.length === 1 && !validItems[0].includes('.')) {
+                // 只有一个子目录，提升一层
+                sourceDir = path.join(extractDir, validItems[0]);
+            }
+            // 移动到最终目录
+            fs.mkdirSync(skillDir, { recursive: true });
+            const items = fs.readdirSync(sourceDir);
+            for (const item of items) {
+                if (item.startsWith('__MACOSX'))
+                    continue;
+                fs.renameSync(path.join(sourceDir, item), path.join(skillDir, item));
+            }
+            // 清理临时目录
+            fs.rmSync(extractDir, { recursive: true });
+            // 5. 生成元数据文件
+            // _meta.json - 技能元数据
+            const metaData = {
+                name: skill.name,
+                version: installedVersion,
+                description: skill.description,
+                author: skill.authorId,
+                tags: skill.tags || [],
+                publishedAt: skill.createdAt,
+            };
+            fs.writeFileSync(path.join(skillDir, '_meta.json'), JSON.stringify(metaData, null, 2));
+            // .btnskill/origin.json - 安装来源信息
+            const btnskillDir = path.join(skillDir, '.btnskill');
+            if (!fs.existsSync(btnskillDir)) {
+                fs.mkdirSync(btnskillDir, { recursive: true });
+            }
+            const originData = {
+                version: 1,
+                registry: this.registryOrigin,
+                name: skill.name,
+                id: skill.id,
+                installedVersion,
+                installedAt: Date.now(),
+            };
+            fs.writeFileSync(path.join(btnskillDir, 'origin.json'), JSON.stringify(originData, null, 2));
+            // 6. 清理临时文件
+            fs.unlinkSync(tmpFile);
+            // 7. 安装到 OpenClaw 时同步注册 OpenClaw 配置
+            if (installTarget.agentType === 'openclaw') {
+                await this.registerSkillToOpenClaw(skill.name, skillDir);
+            }
+            cli_ux_1.default.action.stop();
+            this.log(chalk_1.default.green(`\n✅ 成功安装 ${skill.name}@${skill.version}`));
+            this.log(`安装路径: ${skillDir}\n`);
+        }
+        catch (error) {
+            cli_ux_1.default.action.stop('失败');
+            const normalizedError = this.normalizeAxiosError(error);
+            if (normalizedError.status === 401) {
+                this.error(`登录已过期，请重新登录: ${this.loginHint}`);
+            }
+            this.error(normalizedError.message || '安装失败');
+        }
+    }
+    normalizeAxiosError(error) {
+        const status = error?.response?.status;
+        const data = error?.response?.data;
+        if (typeof data?.message === 'string') {
+            return { status, message: data.message };
+        }
+        if (Buffer.isBuffer(data)) {
+            try {
+                const parsed = JSON.parse(data.toString('utf8'));
+                if (typeof parsed?.message === 'string') {
+                    return { status, message: parsed.message };
+                }
+            }
+            catch {
+                // Ignore malformed response bodies and fall through to generic handling.
+            }
+        }
+        if (data instanceof ArrayBuffer) {
+            try {
+                const parsed = JSON.parse(Buffer.from(data).toString('utf8'));
+                if (typeof parsed?.message === 'string') {
+                    return { status, message: parsed.message };
+                }
+            }
+            catch {
+                // Ignore malformed response bodies and fall through to generic handling.
+            }
+        }
+        return { status, message: error?.message };
+    }
+    async registerSkillToOpenClaw(skillName, skillDir) {
+        const openclawConfigPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
+        let config = {};
+        // 读取现有配置
+        if (fs.existsSync(openclawConfigPath)) {
+            try {
+                const content = fs.readFileSync(openclawConfigPath, 'utf-8');
+                config = JSON.parse(content);
+            }
+            catch {
+                // 配置文件格式错误，重置为空对象
+                config = {};
+            }
+        }
+        // 确保 skills 结构存在
+        if (!config.skills) {
+            config.skills = {};
+        }
+        if (!config.skills.entries) {
+            config.skills.entries = {};
+        }
+        // 添加 skill 条目
+        const skillKey = skillName.toLowerCase();
+        config.skills.entries[skillKey] = {
+            enabled: true,
+        };
+        // 确保目录存在
+        const openclawDir = path.dirname(openclawConfigPath);
+        if (!fs.existsSync(openclawDir)) {
+            fs.mkdirSync(openclawDir, { recursive: true });
+        }
+        // 写入配置
+        fs.writeFileSync(openclawConfigPath, JSON.stringify(config, null, 2));
+    }
+}
+exports.default = Install;

package/dist/commands/list.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../index';
+export default class List extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        'agent-type': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        local: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}