@xubill/xx-cli 2.0.4

package/lib/plugins/ai.js

@@ -0,0 +1,295 @@
+/**
+ * AI 智能解释插件
+ * 用于解释 xx-cli 命令的含义，将自然语言转换为命令
+ *
+ * 命令说明：
+ * - ai <query>：解释用户输入的自然语言，转换为对应的 xx 命令
+ *   - 示例：
+ *     - xx ai 关闭微信
+ *     - xx ai 打开浏览器
+ *     - xx ai 端口占用
+ */
+
+const axios = require('axios');
+const BasePlugin = require('../core/base-plugin');
+
+class AIPlugin extends BasePlugin {
+  constructor() {
+    super();
+    this.pluginName = 'ai';
+  }
+
+  registerCommands(program) {
+    const aiCommand = program.command('ai')
+      .description('AI 智能解释命令，将自然语言转换为 xx 命令')
+      .option('-c, --config <path>', '指定配置文件路径')
+      .arguments('[query...]')
+      .action(async (query, options) => {
+        await this.handleAI(query || [], options);
+      });
+
+    // 添加生成配置文件的子命令
+    aiCommand.command('config')
+      .description('生成 AI 插件配置文件')
+      .option('-o, --output <path>', '输出配置文件路径', '.ai-config.json')
+      .action(async (options) => {
+        await this.generateConfig(options);
+      });
+
+    // 添加快捷添加 API key 的子命令
+    aiCommand.command('add')
+      .description('快捷添加 API key')
+      .arguments('<apiKey>')
+      .action(async (apiKey) => {
+        await this.addApiKey(apiKey);
+      });
+  }
+
+  /**
+   * 快捷添加 API key
+   * @param {string} apiKey - API key
+   */
+  async addApiKey(apiKey) {
+    try {
+      this.startLoading('正在保存 API key...');
+      
+      const defaultConfig = {
+        apiUrl: 'https://api.edgefn.net/v1/chat/completions',
+        apiKey: apiKey,
+        model: 'DeepSeek-R1-0528-Qwen3-8B'
+      };
+      
+      // 保存到全局配置
+      this.saveConfig(defaultConfig, 'config', true);
+      
+      this.stopLoading('API key 保存成功');
+      this.showSuccess('API key 已保存到全局配置');
+      this.showInfo('下次使用无需指定 --config 选项');
+      
+      console.log('\n使用示例:');
+      console.log('  xx ai 关闭3000端口');
+      console.log('  xx ai 生成readme');
+    } catch (error) {
+      this.stopLoading();
+      this.showError(`保存 API key 失败: ${error.message}`);
+    }
+  }
+
+  /**
+   * 生成配置文件
+   * @param {Object} options - 命令选项
+   */
+  async generateConfig(options) {
+    const defaultConfig = {
+      apiUrl: 'https://api.edgefn.net/v1/chat/completions',
+      apiKey: '',
+      model: 'DeepSeek-R1-0528-Qwen3-8B'
+    };
+
+    const outputPath = options.output;
+
+    try {
+      this.startLoading(`正在生成配置文件到 ${outputPath}...`);
+      
+      // 写入配置文件
+      const fs = require('fs');
+      fs.writeFileSync(outputPath, JSON.stringify(defaultConfig, null, 2));
+      
+      this.stopLoading(`配置文件已生成到 ${outputPath}`);
+      this.showSuccess(`配置文件已生成，请根据需要修改其中的参数`);
+      
+      console.log('\n配置文件格式说明：');
+      console.log('  apiUrl: AI API 接口地址');
+      console.log('  apiKey: API 密钥');
+      console.log('  model: 使用的模型名称');
+    } catch (error) {
+      this.stopLoading();
+      this.showError(`生成配置文件失败: ${error.message}`);
+    }
+  }
+
+  /**
+   * 获取所有可用命令列表
+   * @returns {Promise<Array>} 命令数组
+   */
+  async getAllCommands() {
+    const core = require('../core');
+    const { Command } = require('commander');
+    const tempProgram = new Command();
+    tempProgram.name('xx').version('2.0.0');
+
+    // 注册所有命令
+    core.registerCommands(tempProgram);
+
+    // 收集命令
+    const commands = [];
+    if (tempProgram.commands) {
+      tempProgram.commands.forEach((command) => {
+        const commandName = command._name;
+        if (commandName && commandName !== '*') {
+          // 获取命令描述
+          const description = command.description() || '';
+          commands.push({ name: commandName, description });
+        }
+      });
+    }
+
+    return commands;
+  }
+
+  /**
+   * 加载配置
+   * @param {Object} options - 命令行选项
+   * @returns {Object} 配置对象
+   */
+  loadAIConfig(options) {
+    const defaultConfig = {
+      apiUrl: 'https://api.edgefn.net/v1/chat/completions',
+      apiKey: '',
+      model: 'DeepSeek-R1-0528-Qwen3-8B'
+    };
+
+    // 检查是否通过 --config 指定了配置文件
+    if (options.config) {
+      try {
+        const fs = require('fs');
+        const customConfig = JSON.parse(fs.readFileSync(options.config, 'utf8'));
+        // 保存到全局配置
+        this.saveConfig(customConfig, 'config', true);
+        this.showInfo(`配置已保存到全局，下次使用无需指定 --config 选项`);
+      } catch (error) {
+        this.showError(`读取配置文件失败: ${error.message}`);
+      }
+    }
+
+    // 加载配置文件（此时会包含全局配置）
+    const config = this.loadConfig('config', options);
+
+    const aiConfig = {
+      apiUrl: config.apiUrl || defaultConfig.apiUrl,
+      apiKey: config.apiKey || defaultConfig.apiKey,
+      model: config.model || defaultConfig.model
+    };
+
+    // 检查是否有 API key
+    if (!aiConfig.apiKey) {
+      this.showWarning('未配置 API key');
+      console.log('请访问以下链接获取 API key:');
+      console.log('https://ai.baishan.com/auth/login?referralCode=9CbeQycJJP');
+      
+      // 生成配置文件
+      const fs = require('fs');
+      const configPath = '.ai-config.json';
+      try {
+        fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
+        this.showInfo(`已生成配置文件到 ${configPath}`);
+        console.log('请在配置文件中填写您的 API key:');
+        console.log(`  $ vim ${configPath}`);
+      } catch (error) {
+        this.showError(`生成配置文件失败: ${error.message}`);
+      }
+      
+      // 尝试打开浏览器
+      try {
+        const open = require('open');
+        open('https://ai.baishan.com/auth/login?referralCode=9CbeQycJJP');
+        this.showInfo('正在打开浏览器...');
+      } catch (error) {
+        // 忽略打开浏览器的错误
+      }
+      console.log('\n快捷使用:');
+      console.log('  直接添加 API key: xx ai add <apiKey>');
+      console.log('  示例: xx ai add sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');
+
+      console.log('\n完全自定义使用方法:');
+      console.log('  1. 编辑配置文件');
+      console.log('  2. 使用命令: xx ai --config .ai-config.json <查询内容>');
+      console.log('  3. 配置会自动保存，下次使用无需指定 --config 选项');
+      
+      process.exit(1);
+    }
+
+    return aiConfig;
+  }
+
+  /**
+   * 调用 AI API 解释命令
+   * @param {string} query - 用户查询
+   * @param {Array} commands - 可用命令列表
+   * @param {Object} config - AI 配置
+   * @returns {Promise<string>} AI 返回的解释
+   */
+  async callAI(query, commands, config) {
+    const commandList = commands.map(c => `  - ${c.name}: ${c.description}`).join('\n');
+
+    const prompt = `你是一个命令行工具助手。用户使用 xx-cli 工具集，你需要解释用户的意图并给出对应的 xx 命令。\n\n可用命令列表：\n${commandList}\n\n规则：\n1. 如果用户的意图可以匹配到上述命令，返回对应的 xx 命令和简要说明，命令必须以 "xx" 开头\n2. 如果无法匹配，返回 "无法匹配" 并给出最相关的命令建议，建议的命令也必须以 "xx" 开头\n3. 直接返回结果，不需要额外解释\n\n用户输入: ${query}`;
+
+    const response = await axios.post(
+      config.apiUrl,
+      {
+        model: config.model,
+        messages: [{ role: 'user', content: prompt }]
+      },
+      {
+        headers: {
+          'Authorization': `Bearer ${config.apiKey}`,
+          'Content-Type': 'application/json'
+        }
+      }
+    );
+
+    return response.data.choices[0].message.content;
+  }
+
+  /**
+   * 主处理函数
+   * @param {Array} args - 命令参数
+   * @param {Object} options - 命令选项
+   */
+  async handleAI(args, options) {
+    // 处理参数，确保 args 是数组
+    let queryArgs = args;
+    if (!Array.isArray(args)) {
+      // 如果 args 不是数组，可能是因为 Commander.js 版本差异
+      // 检查 options 是否包含 args
+      if (options && options.args) {
+        queryArgs = options.args;
+      } else {
+        queryArgs = [];
+      }
+    }
+
+    if (!queryArgs || queryArgs.length === 0) {
+      this.showError('请输入要解释的内容，例如: xx ai 关闭微信');
+      console.log('\n用法: xx ai <查询内容>');
+      console.log('示例:');
+      console.log('  xx ai 关闭占用3000端口的进程');
+      console.log('  xx ai 生成readme');
+      console.log('  xx ai 查看ip地址');
+      return;
+    }
+
+    const query = queryArgs.join(' ');
+
+    try {
+      this.startLoading('正在获取命令列表...');
+      const commands = await this.getAllCommands();
+      this.stopLoading('命令列表获取成功');
+
+      this.startLoading('正在加载配置...');
+      const config = this.loadAIConfig(options);
+      this.stopLoading('配置加载成功');
+
+      this.startLoading('正在调用 AI 解释...');
+      const result = await this.callAI(query, commands, config);
+      this.stopLoading('解释完成');
+
+      console.log('\n' + result + '\n');
+    } catch (error) {
+      this.stopLoading();
+      this.showError(`调用失败: ${error.message}`);
+    }
+  }
+}
+
+module.exports = AIPlugin;

package/lib/plugins/config-manager.js

@@ -0,0 +1,165 @@
+/**
+ * 配置管理插件
+ * 用于管理所有插件的配置文件
+ * 
+ * 命令说明：
+ * - config-manager [options]：管理所有插件的配置文件
+ *   - 示例：config-manager export
+ *   - 示例：config-manager import
+ *   - 示例：config-manager list
+ * 
+ * 功能说明：
+ * - 导出所有插件配置到指定目录
+ * - 从指定目录导入配置并覆盖
+ * - 列出所有插件的配置文件位置和状态
+ * 
+ * 用户体验：
+ * - 使用标准化的用户提示
+ * - 提供清晰的错误提示
+ * - 支持命令行参数
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+
+/**
+ * 配置管理类
+ * 封装所有配置管理相关的方法
+ */
+class ConfigManager {
+  constructor() {
+    // 获取用户主目录，添加 process.cwd() 作为 fallback
+    this.homeDir = process.env.HOME || process.env.USERPROFILE || process.cwd();
+    this.xxDir = path.join(this.homeDir, '.xx-cli');
+  }
+
+  /**
+   * 导出配置
+   * @param {string} target - 目标路径
+   * @param {Object} helper - 插件帮助器
+   */
+  exportConfig(target, helper) {
+    const exportDir = target || path.join(process.cwd(), 'config-backup');
+    helper.showInfo(`开始导出配置到: ${exportDir}`);
+    
+    // 确保导出目录存在
+    fs.ensureDirSync(exportDir);
+    
+    // 复制 .xx 目录
+    if (fs.existsSync(this.xxDir)) {
+      const exportPath = path.join(exportDir, '.xx-cli');
+      fs.ensureDirSync(path.dirname(exportPath));
+      fs.copySync(this.xxDir, exportPath);
+      helper.showInfo(`导出目录: ${this.xxDir}`);
+    }
+    
+    helper.showSuccess('配置导出完成！');
+  }
+
+  /**
+   * 导入配置
+   * @param {string} source - 源路径
+   * @param {Object} helper - 插件帮助器
+   */
+  importConfig(source, helper) {
+    const importDir = source || path.join(process.cwd(), 'config-backup');
+    helper.showInfo(`开始从 ${importDir} 导入配置...`);
+    
+    // 检查导入目录是否存在
+    if (!fs.existsSync(importDir)) {
+      helper.showError(`导入目录不存在: ${importDir}`);
+      return;
+    }
+    
+    // 复制配置到 .xx 目录
+    const importPath = path.join(importDir, '.xx-cli');
+    if (fs.existsSync(importPath)) {
+      fs.ensureDirSync(path.dirname(this.xxDir));
+      fs.copySync(importPath, this.xxDir, { overwrite: true });
+      helper.showInfo(`导入目录: ${importPath}`);
+    }
+    
+    helper.showSuccess('配置导入完成！');
+  }
+
+  /**
+   * 列出配置
+   * @param {Object} helper - 插件帮助器
+   */
+  listConfig(helper) {
+    helper.showInfo('列出所有插件配置文件...\n');
+    
+    if (fs.existsSync(this.xxDir)) {
+      const items = fs.readdirSync(this.xxDir).filter(item => !item.startsWith('.') && item !== 'plugins');
+      items.forEach(item => {
+        const itemPath = path.join(this.xxDir, item);
+        const stat = fs.statSync(itemPath);
+        if (stat.isDirectory()) {
+          helper.showInfo(`插件配置目录: ${itemPath}`);
+          const configFiles = fs.readdirSync(itemPath).filter(file => !file.startsWith('.'));
+          configFiles.forEach(file => {
+            helper.showInfo(`  - ${file}`);
+          });
+        } else if (stat.isFile()) {
+          helper.showInfo(`配置文件: ${itemPath}`);
+        }
+      });
+    } else {
+      helper.showWarning('配置目录不存在');
+    }
+    
+    helper.showSuccess('配置列表完成！');
+  }
+}
+
+// 创建配置管理实例
+const configManager = new ConfigManager();
+
+module.exports = {
+  name: 'config-manager',
+  alias: 'conf',
+  description: '管理所有插件的配置文件',
+  subcommands: [
+    {
+      name: 'export',
+      description: '导出所有插件配置到指定目录，默认导出到当前目录的 config-backup 文件夹',
+      action: (args, options, helper) => {
+        configManager.exportConfig(args.target, helper);
+      },
+      args: [
+        {
+          name: 'target',
+          description: '目标路径',
+          optional: true
+        }
+      ]
+    },
+    {
+      name: 'import',
+      description: '从指定目录导入配置并覆盖，默认从当前目录的 config-backup 文件夹导入',
+      action: (args, options, helper) => {
+        configManager.importConfig(args.source, helper);
+      },
+      args: [
+        {
+          name: 'source',
+          description: '源路径',
+          optional: true
+        }
+      ]
+    },
+    {
+      name: 'list',
+      description: '列出所有插件的配置文件位置和状态',
+      action: (args, options, helper) => {
+        configManager.listConfig(helper);
+      }
+    }
+  ],
+  options: [
+    {
+      name: '-h, --help',
+      description: '显示帮助信息'
+    }
+  ]
+};

package/lib/plugins/history.js

@@ -0,0 +1,108 @@
+/**
+ * 历史记录插件
+ * 用于查看命令历史记录
+ * 
+ * 命令说明：
+ * - history [options]：查看命令历史记录
+ *   - 示例：history
+ *   - 示例：history --limit 20
+ *   - 示例：history --clear
+ *   - 示例：history --search <keyword>
+ * 
+ * 功能说明：
+ * - 查看命令历史记录
+ * - 限制显示的历史记录数量
+ * - 清除命令历史记录
+ * - 搜索命令历史记录
+ * 
+ * 用户体验：
+ * - 使用标准化的用户提示
+ * - 提供清晰的错误提示
+ * - 支持命令行参数
+ */
+
+/**
+ * 历史记录管理类
+ * 封装所有历史记录相关的方法
+ */
+class HistoryManager {
+  constructor() {
+    // 加载历史记录管理器
+    this.historyManager = require('../utils/history-manager');
+  }
+
+  /**
+   * 显示命令历史记录
+   * @param {Object} options - 选项
+   * @param {Object} helper - 插件帮助器
+   */
+  showHistory(options, helper) {
+    if (options.clear) {
+      // 清除命令历史记录
+      this.historyManager.clearHistory();
+      helper.showSuccess('命令历史记录已清除');
+      return;
+    }
+    
+    if (options.search) {
+      // 搜索命令历史记录
+      const searchResults = this.historyManager.searchHistory(options.search);
+      if (searchResults.length > 0) {
+        helper.showInfo('\n搜索结果:');
+        helper.showInfo('=====================================');
+        searchResults.forEach((item, index) => {
+          const date = new Date(item.timestamp).toLocaleString();
+          helper.showInfo(`${index + 1}. ${item.command} (${date})`);
+        });
+        helper.showInfo('=====================================');
+        helper.showInfo(`总计: ${searchResults.length} 条记录\n`);
+      } else {
+        helper.showInfo(`\n未找到匹配 "${options.search}" 的命令历史记录\n`);
+      }
+      return;
+    }
+    
+    // 显示命令历史记录
+    const history = this.historyManager.getHistory(options.limit);
+    if (history.length > 0) {
+      helper.showInfo('\n命令历史记录:');
+      helper.showInfo('=====================================');
+      history.forEach((item, index) => {
+        const date = new Date(item.timestamp).toLocaleString();
+        helper.showInfo(`${index + 1}. ${item.command} (${date})`);
+      });
+      helper.showInfo('=====================================');
+      helper.showInfo(`总计: ${history.length} 条记录\n`);
+    } else {
+      helper.showInfo('\n命令历史记录为空\n');
+    }
+  }
+}
+
+// 创建历史记录管理实例
+const historyManager = new HistoryManager();
+
+module.exports = {
+  name: 'history',
+  alias: 'h',
+  description: '查看命令历史记录',
+  options: [
+    {
+      name: '-l, --limit <number>',
+      description: '限制显示的历史记录数量',
+      parse: parseInt,
+      default: 10
+    },
+    {
+      name: '-c, --clear',
+      description: '清除命令历史记录'
+    },
+    {
+      name: '-s, --search <keyword>',
+      description: '搜索命令历史记录'
+    }
+  ],
+  action: (args, options, helper) => {
+    historyManager.showHistory(options, helper);
+  }
+};