@xubill/xx-cli 1.0.0

package/bin/cli.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+/**
+ * xx CLI 工具入口文件
+ * 全局命令：xx
+ */
+
+(async () => {
+  const { program } = require("commander");
+  // 直接导入原始核心模块
+  const core = require("../lib/core");
+  const figlet = require("figlet");
+  const chalk = require("chalk").default;
+  const updateNotifier = require("update-notifier");
+  const pkg = require("../package.json");
+
+  // // 检查版本更新
+  // const notifier = updateNotifier({
+  //   pkg,
+  //   updateCheckInterval: 1000 * 60 * 60 * 24 // 1天检查一次
+  // });
+
+  // // 显示更新通知
+  // notifier.notify();
+
+  // 初始化核心功能
+  await core.init();
+
+  // 定义 CLI 命令
+  program
+    .name("xx")
+    .version(pkg.version)
+    .description("个人开发工具集，支持插件系统");
+
+  // 监听 --help 指令,加上额外的提示
+  program.on("--help", async function () {
+    // 美化logo
+    console.log(
+      chalk.green("\r\n" +
+        figlet.textSync("xx", {
+          font: "3D-ASCII",
+          horizontalLayout: "default",
+          verticalLayout: "default",
+          whitespaceBreak: true,
+        })
+      )
+    );
+    // 前后两个空行调整格式，更舒适
+    console.log();
+    console.log("示例:");
+    console.log("  $ xx help");
+    console.log("  $ xx version");
+    console.log();
+    console.log();
+  });
+
+  // 注册核心命令
+  core.registerCommands(program);
+
+  // 全局错误处理
+  process.on('uncaughtException', (error) => {
+    console.error(chalk.red('错误:'), error.message);
+    console.error(chalk.yellow('提示:'), '请检查命令参数是否正确，或使用 --help 查看帮助信息');
+    process.exit(1);
+  });
+
+  process.on('unhandledRejection', (error) => {
+    console.error(chalk.red('错误:'), error.message);
+    console.error(chalk.yellow('提示:'), '请检查命令参数是否正确，或使用 --help 查看帮助信息');
+    process.exit(1);
+  });
+
+  // 记录命令历史
+  const commandLine = process.argv.slice(2).join(' ');
+  if (commandLine) {
+    const historyManager = require('../lib/utils/history-manager');
+    historyManager.addHistory(commandLine);
+  }
+
+  // 解析命令行参数
+  program.parse(process.argv);
+
+  // 注册自动补全
+  if (program.autocomplete) {
+    program.autocomplete();
+  }
+})();

package/lib/core/base-plugin.js

@@ -0,0 +1,292 @@
+/**
+ * 插件基础类
+ * 提供标准化的插件接口和通用功能
+ * 所有插件应该继承此类以确保一致性
+ */
+
+const ConfigManager = require('../utils/config-manager');
+const chalk = require('chalk').default;
+const ora = require('ora').default;;
+const clipboardy = require('clipboardy').default;
+
+class BasePlugin {
+  /**
+   * 构造函数
+   * @param {Object} options - 插件选项
+   */
+  constructor(options = {}) {
+    this.pluginName = this.constructor.name.replace('Plugin', '').toLowerCase();
+    this.homeDir = process.env.HOME || process.env.USERPROFILE;
+    this.configManager = new ConfigManager(this.pluginName, options);
+    this.spinner = null;
+    this.progressTotal = 0;
+    this.progressCurrent = 0;
+    this.hooks = {};
+  }
+
+  /**
+   * 注册命令
+   * @param {Object} program - Commander.js 实例
+   * @abstract
+   */
+  registerCommands(program) {
+    throw new Error('子类必须实现 registerCommands 方法');
+  }
+
+  /**
+   * 初始化插件
+   * @returns {Promise<void>}
+   */
+  async init() {
+    // 插件初始化逻辑，子类可以覆盖
+  }
+
+  /**
+   * 获取插件信息
+   * @returns {Object} 插件信息对象
+   */
+  getInfo() {
+    return {
+      name: this.pluginName,
+      version: '1.0.0',
+      description: '插件描述'
+    };
+  }
+
+  /**
+   * 显示加载状态
+   * @param {string} text - 加载文本
+   */
+  startLoading(text) {
+    this.spinner = ora(text).start();
+  }
+
+  /**
+   * 停止加载状态
+   * @param {string} text - 成功文本
+   */
+  stopLoading(text) {
+    if (this.spinner) {
+      this.spinner.succeed(text);
+      this.spinner = null;
+    }
+  }
+
+  /**
+   * 显示错误状态
+   * @param {string} text - 错误文本
+   */
+  showError(text) {
+    if (this.spinner) {
+      this.spinner.fail(text);
+      this.spinner = null;
+    } else {
+      console.error(chalk.red(`❌ ${text}`));
+    }
+  }
+
+  /**
+   * 启动进度条
+   * @param {string} text - 进度条文本
+   * @param {number} total - 总进度值
+   */
+  startProgressBar(text, total = 100) {
+    this.spinner = ora({
+      text,
+      spinner: 'arc',
+      color: 'cyan'
+    }).start();
+    this.progressTotal = total;
+    this.progressCurrent = 0;
+  }
+
+  /**
+   * 更新进度条
+   * @param {number} current - 当前进度值
+   * @param {string} text - 进度条文本
+   */
+  updateProgressBar(current, text) {
+    if (this.spinner && this.progressTotal > 0) {
+      this.progressCurrent = current;
+      const percentage = Math.min(Math.round((current / this.progressTotal) * 100), 100);
+      this.spinner.text = `${text || ''} ${percentage}%`;
+    }
+  }
+
+  /**
+   * 停止进度条
+   * @param {string} text - 完成文本
+   */
+  stopProgressBar(text) {
+    if (this.spinner) {
+      this.spinner.succeed(text);
+      this.spinner = null;
+      this.progressTotal = 0;
+      this.progressCurrent = 0;
+    }
+  }
+
+  /**
+   * 显示成功信息
+   * @param {string} text - 成功文本
+   */
+  showSuccess(text) {
+    console.log(chalk.green(`✅ ${text}`));
+  }
+
+  /**
+   * 显示警告信息
+   * @param {string} text - 警告文本
+   */
+  showWarning(text) {
+    console.log(chalk.yellow(`⚠️  ${text}`));
+  }
+
+  /**
+   * 显示信息
+   * @param {string} text - 信息文本
+   */
+  showInfo(text) {
+    console.log(chalk.blue(`${text}`));
+  }
+
+  /**
+   * 加载配置
+   * @param {string} configName - 配置名称
+   * @param {Object} cliOptions - 命令行选项
+   * @returns {Object} 合并后的配置对象
+   */
+  loadConfig(configName = 'config', cliOptions = {}) {
+    return this.configManager.loadConfig(configName, cliOptions);
+  }
+
+  /**
+   * 保存配置
+   * @param {Object} config - 配置对象
+   * @param {string} configName - 配置名称
+   * @param {boolean} isGlobal - 是否保存到全局配置
+   */
+  saveConfig(config, configName = 'config', isGlobal = true) {
+    this.configManager.saveConfig(config, configName, isGlobal);
+  }
+
+  /**
+   * 验证配置
+   * @param {Object} config - 配置对象
+   * @param {Object} schema - 配置 schema
+   * @returns {Object} 验证结果
+   */
+  validateConfig(config, schema) {
+    return this.configManager.validateConfig(config, schema);
+  }
+
+  /**
+   * 错误处理
+   * @param {Error} error - 错误对象
+   * @param {string} message - 错误消息
+   */
+  handleError(error, message = '操作失败') {
+    this.showError(`${message}: ${error.message}`);
+    // 可以添加错误日志记录等逻辑
+  }
+
+  /**
+   * 执行异步操作
+   * @param {Function} fn - 异步函数
+   * @param {string} loadingText - 加载文本
+   * @param {string} successText - 成功文本
+   * @param {string} errorText - 错误文本
+   * @returns {Promise<any>}
+   */
+  async executeAsync(fn, loadingText, successText, errorText) {
+    try {
+      this.startLoading(loadingText);
+      const result = await fn();
+      this.stopLoading(successText);
+      return result;
+    } catch (error) {
+      this.handleError(error, errorText);
+      throw error;
+    }
+  }
+
+  /**
+   * 注册钩子
+   * @param {string} event - 事件名称
+   * @param {Function} callback - 回调函数
+   */
+  registerHook(event, callback) {
+    if (!this.hooks) {
+      this.hooks = {};
+    }
+    
+    if (!this.hooks[event]) {
+      this.hooks[event] = [];
+    }
+    
+    this.hooks[event].push(callback);
+  }
+
+  /**
+   * 触发钩子
+   * @param {string} event - 事件名称
+   * @param {*} data - 事件数据
+   * @returns {Promise<Array>} 钩子执行结果
+   */
+  async triggerHook(event, data) {
+    if (!this.hooks || !this.hooks[event]) {
+      return [];
+    }
+    
+    const results = [];
+    for (const callback of this.hooks[event]) {
+      try {
+        const result = await callback(data);
+        results.push(result);
+      } catch (error) {
+        this.handleError(error, `执行钩子 ${event} 时出错`);
+      }
+    }
+    
+    return results;
+  }
+
+  /**
+   * 检查是否注册了指定钩子
+   * @param {string} event - 事件名称
+   * @returns {boolean} 是否注册了钩子
+   */
+  hasHook(event) {
+    return this.hooks && this.hooks[event] && this.hooks[event].length > 0;
+  }
+
+  /**
+   * 复制文本到剪贴板
+   * @param {string} text - 要复制的文本
+   * @param {string} successMessage - 成功消息
+   * @returns {Promise<boolean>} 是否复制成功
+   */
+  async copyToClipboard(text, successMessage) {
+    try {
+      // 尝试不同的 clipboardy API 调用方式
+      if (clipboardy.default && typeof clipboardy.default.write === 'function') {
+        await clipboardy.default.write(text);
+      } else if (typeof clipboardy.write === 'function') {
+        await clipboardy.write(text);
+      } else if (typeof clipboardy.writeSync === 'function') {
+        clipboardy.writeSync(text);
+      } else {
+        throw new Error('clipboardy API 不可用');
+      }
+      if (successMessage) {
+        this.showSuccess(successMessage);
+      }
+      return true;
+    } catch (error) {
+      this.showWarning(`复制到剪贴板失败: ${error.message}`);
+      return false;
+    }
+  }
+}
+
+module.exports = BasePlugin;