sino-bc-cli 1.0.0

package/dist/core/command-registry.js

@@ -0,0 +1,195 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandRegistry = exports.CommandRegistry = void 0;
+const _ = __importStar(require("lodash"));
+const utils_1 = require("../utils");
+const constants_1 = require("../constants");
+/**
+ * 命令注册器类
+ * 负责注册、查找和执行 CLI 命令
+ * 采用注册中心模式，实现命令的低耦合管理，方便后续扩展新命令
+ */
+class CommandRegistry {
+    /** 命令存储 Map，key 为命令名称，value 为命令实例 */
+    commands = new Map();
+    /**
+     * 注册一个命令到注册中心
+     * 命令名称不区分大小写，会统一转为小写存储
+     * @param command 命令实例
+     * @returns 是否注册成功
+     */
+    register(command) {
+        // 参数合法性校验
+        if (_.isNil(command)) {
+            utils_1.logger.error('注册命令失败: 命令实例不能为空');
+            return false;
+        }
+        if (_.isEmpty(command.name)) {
+            utils_1.logger.error('注册命令失败: 命令名称不能为空');
+            return false;
+        }
+        if (_.isNil(command.execute) || !_.isFunction(command.execute)) {
+            utils_1.logger.error(`注册命令失败: 命令 [${command.name}] 缺少 execute 方法`);
+            return false;
+        }
+        // 命令名称统一转小写，确保不区分大小写
+        const commandName = _.toLower(command.name);
+        // 检查命令名称是否重复
+        if (this.commands.has(commandName)) {
+            utils_1.logger.warn(`命令 [${commandName}] 已存在，将覆盖原有注册`);
+        }
+        // 注册命令
+        this.commands.set(commandName, command);
+        utils_1.logger.debug(`成功注册命令: ${commandName}`);
+        return true;
+    }
+    /**
+     * 批量注册多个命令
+     * @param commands 命令实例数组
+     * @returns 成功注册的命令数量
+     */
+    registerAll(commands) {
+        let successCount = 0;
+        _.forEach(commands, (cmd) => {
+            if (this.register(cmd)) {
+                successCount++;
+            }
+        });
+        utils_1.logger.debug(`批量注册完成，成功 ${successCount}/${commands.length} 个命令`);
+        return successCount;
+    }
+    /**
+     * 根据名称查找命令
+     * @param name 命令名称（不区分大小写）
+     * @returns 命令实例，未找到返回 undefined
+     */
+    find(name) {
+        if (_.isEmpty(name)) {
+            return undefined;
+        }
+        return this.commands.get(_.toLower(name));
+    }
+    /**
+     * 检查指定名称的命令是否存在
+     * @param name 命令名称
+     * @returns 是否存在
+     */
+    has(name) {
+        return !_.isNil(this.find(name));
+    }
+    /**
+     * 获取所有已注册的命令列表
+     * @returns 命令实例数组
+     */
+    getAllCommands() {
+        return Array.from(this.commands.values());
+    }
+    /**
+     * 获取所有已注册的命令名称列表
+     * @returns 命令名称数组
+     */
+    getAllCommandNames() {
+        return Array.from(this.commands.keys());
+    }
+    /**
+     * 执行指定名称的命令
+     * 自动解析命令名称（支持带斜杠前缀，如 /homepage）
+     * @param name 命令名称或带斜杠的命令（如 /homepage 或 homepage）
+     * @param args 命令参数
+     * @param options 命令选项
+     * @returns Promise<boolean> 是否执行成功
+     */
+    async execute(name, args = [], options = {}) {
+        // 去除命令名称可能的斜杠前缀，并转小写
+        const cleanName = _.toLower(_.trimStart(name, '/'));
+        // 查找命令
+        const command = this.find(cleanName);
+        if (_.isNil(command)) {
+            utils_1.logger.error(`未找到命令: /${cleanName}`);
+            utils_1.logger.tip(`使用 "${constants_1.CLI_CONFIG.name} help" 查看所有可用命令`);
+            return false;
+        }
+        utils_1.logger.debug(`执行命令: /${cleanName}, 参数: ${JSON.stringify(args)}`);
+        try {
+            // 执行命令，兼容同步和异步返回
+            const result = command.execute(args, options);
+            if (result instanceof Promise) {
+                await result;
+            }
+            return true;
+        }
+        catch (error) {
+            utils_1.logger.error(`执行命令 /${cleanName} 时发生错误:`, error instanceof Error ? error.message : String(error));
+            if (error instanceof Error && !_.isEmpty(error.stack)) {
+                utils_1.logger.debug('错误堆栈:', error.stack);
+            }
+            return false;
+        }
+    }
+    /**
+     * 注销一个命令
+     * @param name 命令名称
+     * @returns 是否成功注销
+     */
+    unregister(name) {
+        const cleanName = _.toLower(_.trimStart(name, '/'));
+        if (!this.commands.has(cleanName)) {
+            utils_1.logger.warn(`无法注销命令 [${cleanName}]: 命令不存在`);
+            return false;
+        }
+        this.commands.delete(cleanName);
+        utils_1.logger.debug(`已注销命令: ${cleanName}`);
+        return true;
+    }
+    /**
+     * 清空所有已注册的命令
+     */
+    clear() {
+        this.commands.clear();
+        utils_1.logger.debug('已清空所有命令注册');
+    }
+    /**
+     * 获取已注册命令数量
+     * @returns 命令数量
+     */
+    size() {
+        return this.commands.size;
+    }
+}
+exports.CommandRegistry = CommandRegistry;
+/** 导出全局命令注册器单例 */
+exports.commandRegistry = new CommandRegistry();
+//# sourceMappingURL=command-registry.js.map

package/dist/core/command-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../src/core/command-registry.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,0CAA4B;AAE5B,oCAAkC;AAClC,4CAA0C;AAE1C;;;;GAIG;AACH,MAAa,eAAe;IAC1B,qCAAqC;IAC7B,QAAQ,GAA0B,IAAI,GAAG,EAAE,CAAC;IAEpD;;;;;OAKG;IACI,QAAQ,CAAC,OAAiB;QAC/B,UAAU;QACV,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACrB,cAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,cAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/D,cAAM,CAAC,KAAK,CAAC,eAAe,OAAO,CAAC,IAAI,iBAAiB,CAAC,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;QAED,qBAAqB;QACrB,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE5C,aAAa;QACb,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,cAAM,CAAC,IAAI,CAAC,OAAO,WAAW,eAAe,CAAC,CAAC;QACjD,CAAC;QAED,OAAO;QACP,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACxC,cAAM,CAAC,KAAK,CAAC,WAAW,WAAW,EAAE,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAAoB;QACrC,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;YAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,YAAY,EAAE,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,cAAM,CAAC,KAAK,CAAC,aAAa,YAAY,IAAI,QAAQ,CAAC,MAAM,MAAM,CAAC,CAAC;QACjE,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACI,IAAI,CAAC,IAAY;QACtB,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACI,GAAG,CAAC,IAAY;QACrB,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACI,cAAc;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;OAGG;IACI,kBAAkB;QACvB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,OAAO,CAClB,IAAY,EACZ,OAAiB,EAAE,EACnB,UAAmC,EAAE;QAErC,qBAAqB;QACrB,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAEpD,OAAO;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACrB,cAAM,CAAC,KAAK,CAAC,WAAW,SAAS,EAAE,CAAC,CAAC;YACrC,cAAM,CAAC,GAAG,CAAC,OAAO,sBAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,cAAM,CAAC,KAAK,CAAC,UAAU,SAAS,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEjE,IAAI,CAAC;YACH,iBAAiB;YACjB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9C,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,MAAM,MAAM,CAAC;YACf,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,cAAM,CAAC,KAAK,CACV,SAAS,SAAS,SAAS,EAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;YACF,IAAI,KAAK,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtD,cAAM,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,UAAU,CAAC,IAAY;QAC5B,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAClC,cAAM,CAAC,IAAI,CAAC,WAAW,SAAS,UAAU,CAAC,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,cAAM,CAAC,KAAK,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,cAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,IAAI;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF;AAxKD,0CAwKC;AAED,kBAAkB;AACL,QAAA,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,2 @@
+export { CommandRegistry, commandRegistry } from './command-registry';
+export { CLIApplication } from './cli-app';

package/dist/core/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLIApplication = exports.commandRegistry = exports.CommandRegistry = void 0;
+var command_registry_1 = require("./command-registry");
+Object.defineProperty(exports, "CommandRegistry", { enumerable: true, get: function () { return command_registry_1.CommandRegistry; } });
+Object.defineProperty(exports, "commandRegistry", { enumerable: true, get: function () { return command_registry_1.commandRegistry; } });
+var cli_app_1 = require("./cli-app");
+Object.defineProperty(exports, "CLIApplication", { enumerable: true, get: function () { return cli_app_1.CLIApplication; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;AAAA,uDAAsE;AAA7D,mHAAA,eAAe,OAAA;AAAE,mHAAA,eAAe,OAAA;AACzC,qCAA2C;AAAlC,yGAAA,cAAc,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * BeyondClick CLI 工具 - 入口文件
+ *
+ * 本文件是整个 CLI 应用的启动入口，主要职责：
+ * 1. 创建 CLIApplication 实例
+ * 2. 调用 run 方法启动应用
+ * 3. 处理退出码，确保进程正确退出
+ *
+ * 在 package.json 中通过 bin 字段将本文件关联到 sino-bc-cli 命令
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * BeyondClick CLI 工具 - 入口文件
+ *
+ * 本文件是整个 CLI 应用的启动入口，主要职责：
+ * 1. 创建 CLIApplication 实例
+ * 2. 调用 run 方法启动应用
+ * 3. 处理退出码，确保进程正确退出
+ *
+ * 在 package.json 中通过 bin 字段将本文件关联到 sino-bc-cli 命令
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_app_1 = require("./core/cli-app");
+/**
+ * 主函数：启动 CLI 应用
+ * 使用立即执行异步函数模式，确保可以使用 async/await
+ */
+(async function main() {
+    // 创建 CLI 应用实例
+    const app = new cli_app_1.CLIApplication();
+    // 启动应用并获取退出码
+    const exitCode = await app.run(process.argv);
+    // 以正确的退出码退出进程
+    // 0 表示成功，非 0 表示执行失败
+    process.exit(exitCode);
+})().catch((error) => {
+    // 最外层异常兜底，确保进程不会因未捕获异常异常终止
+    // 注意：正常情况下 CLIApplication.run 内部已经做了异常处理
+    // 这里是为了防止极端情况下的未捕获 Promise rejection
+    console.error('[FATAL] CLI 启动失败:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;GASG;;AAEH,4CAAgD;AAEhD;;;GAGG;AACH,CAAC,KAAK,UAAU,IAAI;IAClB,cAAc;IACd,MAAM,GAAG,GAAG,IAAI,wBAAc,EAAE,CAAC;IAEjC,aAAa;IACb,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,cAAc;IACd,oBAAoB;IACpB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACnB,2BAA2B;IAC3B,yCAAyC;IACzC,qCAAqC;IACrC,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,120 @@
+/**
+ * CLI 命令接口定义
+ * 所有命令都必须实现此接口，确保命令注册器的统一管理
+ */
+export interface ICommand {
+    /** 命令名称（不含斜杠） */
+    name: string;
+    /** 命令描述，用于帮助信息展示 */
+    description: string;
+    /** 命令使用示例 */
+    usage?: string;
+    /** 命令选项配置 */
+    options?: ICommandOption[];
+    /**
+     * 命令执行函数
+     * @param args 命令行参数
+     * @param options 解析后的选项
+     */
+    execute(args: string[], options?: Record<string, unknown>): Promise<void> | void;
+}
+/**
+ * 命令选项接口定义
+ */
+export interface ICommandOption {
+    /** 选项名称（短格式，如 -p） */
+    short?: string;
+    /** 选项名称（长格式，如 --port） */
+    long: string;
+    /** 选项描述 */
+    description: string;
+    /** 是否需要参数值 */
+    required?: boolean;
+    /** 默认值 */
+    defaultValue?: unknown;
+}
+/**
+ * CLI 配置接口
+ */
+export interface ICLIConfig {
+    /** CLI 名称 */
+    name: string;
+    /** CLI 版本号 */
+    version: string;
+    /** CLI 描述 */
+    description: string;
+}
+/**
+ * 运行环境枚举
+ */
+export declare enum EnvName {
+    /** 测试环境 */
+    TEST = "test",
+    /** 预发环境 */
+    PRE = "pre",
+    /** 生产环境 */
+    PROD = "prod"
+}
+/**
+ * 单个环境的网关配置
+ */
+export interface IGatewayConfig {
+    /** 环境标识 */
+    env: EnvName;
+    /** 环境中文说明 */
+    label: string;
+    /** 网关地址（后续填写） */
+    baseUrl: string;
+}
+/**
+ * HTTP 请求方法
+ */
+export type HttpMethod = 'GET' | 'POST';
+/**
+ * api-doc 中单个可调用接口的描述
+ * 与 src/api-doc 文档保持一一对应
+ */
+export interface IApiDocEndpoint {
+    /** 接口 name，与文档一致 */
+    name: string;
+    /** 展示名 */
+    displayName: string;
+    /** 接口说明 */
+    description: string;
+    /** HTTP 方法 */
+    method: HttpMethod;
+    /** 相对路径 */
+    path: string;
+    /** 文档请求示例中的默认请求体；GET 无请求体时为空 */
+    defaultBody?: Record<string, unknown>;
+    /** 超时毫秒数 */
+    timeout: number;
+}
+/**
+ * 日志级别枚举
+ */
+export declare enum LogLevel {
+    /** 调试级别 */
+    DEBUG = "debug",
+    /** 信息级别 */
+    INFO = "info",
+    /** 警告级别 */
+    WARN = "warn",
+    /** 错误级别 */
+    ERROR = "error"
+}
+/**
+ * 浏览器类型枚举
+ */
+export declare enum BrowserType {
+    /** 使用系统默认浏览器 */
+    DEFAULT = "default",
+    /** Chrome 浏览器 */
+    CHROME = "chrome",
+    /** Firefox 浏览器 */
+    FIREFOX = "firefox",
+    /** Edge 浏览器 */
+    EDGE = "edge",
+    /** Safari 浏览器 */
+    SAFARI = "safari"
+}

package/dist/types/index.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserType = exports.LogLevel = exports.EnvName = void 0;
+/**
+ * 运行环境枚举
+ */
+var EnvName;
+(function (EnvName) {
+    /** 测试环境 */
+    EnvName["TEST"] = "test";
+    /** 预发环境 */
+    EnvName["PRE"] = "pre";
+    /** 生产环境 */
+    EnvName["PROD"] = "prod";
+})(EnvName || (exports.EnvName = EnvName = {}));
+/**
+ * 日志级别枚举
+ */
+var LogLevel;
+(function (LogLevel) {
+    /** 调试级别 */
+    LogLevel["DEBUG"] = "debug";
+    /** 信息级别 */
+    LogLevel["INFO"] = "info";
+    /** 警告级别 */
+    LogLevel["WARN"] = "warn";
+    /** 错误级别 */
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+/**
+ * 浏览器类型枚举
+ */
+var BrowserType;
+(function (BrowserType) {
+    /** 使用系统默认浏览器 */
+    BrowserType["DEFAULT"] = "default";
+    /** Chrome 浏览器 */
+    BrowserType["CHROME"] = "chrome";
+    /** Firefox 浏览器 */
+    BrowserType["FIREFOX"] = "firefox";
+    /** Edge 浏览器 */
+    BrowserType["EDGE"] = "edge";
+    /** Safari 浏览器 */
+    BrowserType["SAFARI"] = "safari";
+})(BrowserType || (exports.BrowserType = BrowserType = {}));
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AAiDA;;GAEG;AACH,IAAY,OAOX;AAPD,WAAY,OAAO;IACjB,WAAW;IACX,wBAAa,CAAA;IACb,WAAW;IACX,sBAAW,CAAA;IACX,WAAW;IACX,wBAAa,CAAA;AACf,CAAC,EAPW,OAAO,uBAAP,OAAO,QAOlB;AAwCD;;GAEG;AACH,IAAY,QASX;AATD,WAAY,QAAQ;IAClB,WAAW;IACX,2BAAe,CAAA;IACf,WAAW;IACX,yBAAa,CAAA;IACb,WAAW;IACX,yBAAa,CAAA;IACb,WAAW;IACX,2BAAe,CAAA;AACjB,CAAC,EATW,QAAQ,wBAAR,QAAQ,QASnB;AAED;;GAEG;AACH,IAAY,WAWX;AAXD,WAAY,WAAW;IACrB,gBAAgB;IAChB,kCAAmB,CAAA;IACnB,iBAAiB;IACjB,gCAAiB,CAAA;IACjB,kBAAkB;IAClB,kCAAmB,CAAA;IACnB,eAAe;IACf,4BAAa,CAAA;IACb,iBAAiB;IACjB,gCAAiB,CAAA;AACnB,CAAC,EAXW,WAAW,2BAAX,WAAW,QAWtB"}

package/dist/utils/browser.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 浏览器工具类
+ * 封装跨平台的浏览器打开操作，解决 Windows 和 macOS 兼容性问题
+ * 使用 Node.js 原生 child_process 模块，避免第三方依赖的兼容性风险
+ */
+export declare class BrowserUtils {
+    /**
+     * 使用系统默认浏览器打开指定 URL
+     * 跨平台兼容：Windows 使用 start，macOS 使用 open，Linux 使用 xdg-open
+     * @param url 要打开的网址
+     * @returns Promise<boolean> 是否打开成功
+     */
+    static openUrl(url: string): Promise<boolean>;
+    /**
+     * 验证 URL 格式是否合法
+     * 使用 lodash 和正则表达式进行校验
+     * @param url 待验证的 URL
+     * @returns 是否为合法 URL
+     */
+    private static isValidUrl;
+    /**
+     * 对 Windows cmd 命令中的特殊字符进行转义
+     * 解决 URL 中包含 & 等特殊字符时 cmd 解析错误的问题
+     * @param input 输入字符串
+     * @returns 转义后的字符串
+     */
+    private static escapeForCmd;
+    /**
+     * 执行 shell 命令的 Promise 封装
+     * 使用 child_process.exec 并包装为 Promise，便于 async/await 调用
+     * @param command 要执行的命令
+     * @param timeout 超时时间（毫秒），默认 30 秒
+     * @returns Promise<void>
+     */
+    private static execCommand;
+}

package/dist/utils/browser.js

@@ -0,0 +1,143 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserUtils = void 0;
+const _ = __importStar(require("lodash"));
+const child_process = __importStar(require("child_process"));
+const logger_1 = require("./logger");
+/**
+ * 浏览器工具类
+ * 封装跨平台的浏览器打开操作，解决 Windows 和 macOS 兼容性问题
+ * 使用 Node.js 原生 child_process 模块，避免第三方依赖的兼容性风险
+ */
+class BrowserUtils {
+    /**
+     * 使用系统默认浏览器打开指定 URL
+     * 跨平台兼容：Windows 使用 start，macOS 使用 open，Linux 使用 xdg-open
+     * @param url 要打开的网址
+     * @returns Promise<boolean> 是否打开成功
+     */
+    static async openUrl(url) {
+        // 验证 URL 格式
+        if (_.isEmpty(url) || !this.isValidUrl(url)) {
+            logger_1.logger.error(`无效的 URL 地址: ${url}`);
+            return false;
+        }
+        logger_1.logger.debug(`准备打开 URL: ${url}`);
+        logger_1.logger.tip(`正在使用默认浏览器打开: ${url}`);
+        try {
+            // 根据操作系统平台选择打开命令
+            const platform = process.platform;
+            let command;
+            switch (platform) {
+                // Windows 平台
+                case 'win32':
+                    // 使用 cmd /c start "" "url" 格式，兼容含特殊字符的 URL
+                    command = `cmd /c start "" "${this.escapeForCmd(url)}"`;
+                    break;
+                // macOS 平台
+                case 'darwin':
+                    command = `open "${url}"`;
+                    break;
+                // Linux 及其他类 Unix 平台
+                default:
+                    command = `xdg-open "${url}"`;
+            }
+            logger_1.logger.debug(`执行打开命令: ${command}`);
+            // 执行命令并等待完成
+            await this.execCommand(command);
+            logger_1.logger.success(`已成功在默认浏览器中打开: ${url}`);
+            return true;
+        }
+        catch (error) {
+            logger_1.logger.error('打开浏览器失败:', error instanceof Error ? error.message : String(error));
+            // 失败时给出手动访问提示
+            logger_1.logger.tip(`您可以手动在浏览器中访问此地址: ${url}`);
+            return false;
+        }
+    }
+    /**
+     * 验证 URL 格式是否合法
+     * 使用 lodash 和正则表达式进行校验
+     * @param url 待验证的 URL
+     * @returns 是否为合法 URL
+     */
+    static isValidUrl(url) {
+        if (_.isEmpty(url)) {
+            return false;
+        }
+        // 支持 http 和 https 协议
+        const urlPattern = /^https?:\/\/[^\s/$.?#].[^\s]*$/i;
+        return urlPattern.test(url);
+    }
+    /**
+     * 对 Windows cmd 命令中的特殊字符进行转义
+     * 解决 URL 中包含 & 等特殊字符时 cmd 解析错误的问题
+     * @param input 输入字符串
+     * @returns 转义后的字符串
+     */
+    static escapeForCmd(input) {
+        // Windows cmd 中需要转义的字符：&、|、^、<、>
+        return _.replace(input, /[&|^<>]/g, (match) => `^${match}`);
+    }
+    /**
+     * 执行 shell 命令的 Promise 封装
+     * 使用 child_process.exec 并包装为 Promise，便于 async/await 调用
+     * @param command 要执行的命令
+     * @param timeout 超时时间（毫秒），默认 30 秒
+     * @returns Promise<void>
+     */
+    static execCommand(command, timeout = 30000) {
+        return new Promise((resolve, reject) => {
+            child_process.exec(command, { timeout, windowsHide: true }, (error, _stdout, stderr) => {
+                if (error) {
+                    // 某些平台上即使浏览器已成功打开，exec 也可能返回非零状态
+                    // 只要没有 stderr 输出，就认为打开成功
+                    if (_.isEmpty(stderr)) {
+                        resolve();
+                    }
+                    else {
+                        reject(error);
+                    }
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+}
+exports.BrowserUtils = BrowserUtils;
+//# sourceMappingURL=browser.js.map

package/dist/utils/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/utils/browser.ts"],"names":[],"mappings":"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"}