sino-bc-cli 1.3.2 → 1.4.0

package/dist/core/command-registry.js

@@ -1,195 +0,0 @@
-"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());
-    }
-    /**
-     * 执行指定名称的命令
-     * 自动解析命令名称（支持带斜杠前缀，如 /ic-api）
-     * @param name 命令名称或带斜杠的命令（如 /ic-api 或 ic-api）
-     * @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

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

package/dist/core/index.d.ts

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

package/dist/core/index.js

@@ -1,9 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

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

package/dist/index.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,122 +0,0 @@
-/**
- * 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;
-    /** 所属分组（对应接口文档的标签），用于选择列表分节展示；不填则不分组 */
-    group?: 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

@@ -1,46 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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;AA0CD;;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

@@ -1,52 +0,0 @@
-/**
- * 浏览器工具类
- * 封装跨平台的浏览器打开操作，解决 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>;
-    /**
-     * 使用系统默认程序打开本地文件
-     * 优先尝试 Cursor / VS Code（带行号跳转），失败再回退系统关联程序
-     * @param filePath 本地绝对路径
-     * @param line 可选的 1-based 行号，用于打开 markdown 标题处
-     * @returns 是否打开成功
-     */
-    static openFile(filePath: string, line?: number): Promise<boolean>;
-    /**
-     * 探测可执行文件是否在 PATH 中
-     */
-    private static hasCommand;
-    /**
-     * 分离进程启动编辑器，不阻塞 CLI
-     */
-    private static spawnDetached;
-    /**
-     * 验证 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

@@ -1,222 +0,0 @@
-"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 fs_1 = require("fs");
-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;
-        }
-    }
-    /**
-     * 使用系统默认程序打开本地文件
-     * 优先尝试 Cursor / VS Code（带行号跳转），失败再回退系统关联程序
-     * @param filePath 本地绝对路径
-     * @param line 可选的 1-based 行号，用于打开 markdown 标题处
-     * @returns 是否打开成功
-     */
-    static async openFile(filePath, line) {
-        if (_.isEmpty(filePath) || !(0, fs_1.existsSync)(filePath)) {
-            logger_1.logger.error(`文件不存在: ${filePath}`);
-            return false;
-        }
-        const gotoTarget = !_.isNil(line) ? `${filePath}:${line}` : filePath;
-        logger_1.logger.debug(`准备打开本地文件: ${gotoTarget}`);
-        logger_1.logger.tip(`正在打开接口文档: ${filePath}`);
-        // 先探测 CLI 是否存在，再分离进程打开，避免 cursor/code 占用当前终端
-        if (await this.hasCommand('cursor') && this.spawnDetached('cursor', ['--goto', gotoTarget])) {
-            logger_1.logger.success(`已在 Cursor 中打开: ${gotoTarget}`);
-            return true;
-        }
-        if (await this.hasCommand('code') && this.spawnDetached('code', ['--goto', gotoTarget])) {
-            logger_1.logger.success(`已在 VS Code 中打开: ${gotoTarget}`);
-            return true;
-        }
-        try {
-            const platform = process.platform;
-            let command;
-            switch (platform) {
-                case 'win32':
-                    command = `cmd /c start "" "${this.escapeForCmd(filePath)}"`;
-                    break;
-                case 'darwin':
-                    command = `open "${filePath}"`;
-                    break;
-                default:
-                    command = `xdg-open "${filePath}"`;
-            }
-            logger_1.logger.debug(`执行打开命令: ${command}`);
-            await this.execCommand(command);
-            logger_1.logger.success(`已使用系统默认程序打开: ${filePath}`);
-            return true;
-        }
-        catch (error) {
-            logger_1.logger.error('打开文件失败:', error instanceof Error ? error.message : String(error));
-            logger_1.logger.tip(`您可以手动打开此文件: ${filePath}`);
-            return false;
-        }
-    }
-    /**
-     * 探测可执行文件是否在 PATH 中
-     */
-    static hasCommand(bin) {
-        const probe = process.platform === 'win32' ? `where ${bin}` : `command -v ${bin}`;
-        return new Promise((resolve) => {
-            child_process.exec(probe, { timeout: 3000, windowsHide: true }, (error, stdout) => {
-                resolve(_.isNil(error) && !_.isEmpty(_.trim(stdout)));
-            });
-        });
-    }
-    /**
-     * 分离进程启动编辑器，不阻塞 CLI
-     */
-    static spawnDetached(bin, args) {
-        try {
-            const child = child_process.spawn(bin, args, {
-                detached: true,
-                stdio: 'ignore',
-                windowsHide: true,
-                shell: process.platform === 'win32',
-            });
-            child.on('error', () => undefined);
-            child.unref();
-            return true;
-        }
-        catch {
-            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