@xubill/xx-cli 2.0.0 → 2.0.2

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/plugin-manager.js

@@ -150,7 +150,7 @@ class PluginManager {
    */
   toCamelCase(str) {
     if (!str) {
-      return 'Plugin';
+      return "Plugin";
     }
     return str
       .replace(/-([a-zA-Z])/g, (g) => g[1].toUpperCase())
@@ -166,14 +166,14 @@ class PluginManager {
   generatePluginTemplate(name, format) {
     // 参数检查
     if (!name) {
-      throw new Error('插件名称不能为空');
+      throw new Error("插件名称不能为空");
     }
-    
+
     // 生成插件命令名称（去除后缀，转小写，连字符转驼峰）
     const commandName = name
       .replace(".js", "")
       .toLowerCase()
-      .replace(/-(\w)/g, (g) => g[1].toUpperCase());
+      .replace(/-([a-zA-Z])/g, (g) => g[1].toUpperCase());
 
     // 生成驼峰命名的类名
     const className = this.toCamelCase(name);
@@ -302,7 +302,9 @@ module.exports = {
           }
         });
       } catch (error) {
-        helper.showInfo("提示：无法自动打开 vscode，请手动打开插件文件进行编辑");
+        helper.showInfo(
+          "提示：无法自动打开 vscode，请手动打开插件文件进行编辑",
+        );
       }
     } catch (error) {
       helper.showError(`创建插件模板失败: ${error.message || error}`);
@@ -400,7 +402,10 @@ module.exports = {
             .get(url, (response) => {
               if (response.statusCode === 200) {
                 // 获取文件大小
-                const fileSize = parseInt(response.headers["content-length"], 10);
+                const fileSize = parseInt(
+                  response.headers["content-length"],
+                  10,
+                );
                 let downloadedSize = 0;
 
                 // 创建写入流
@@ -468,6 +473,67 @@ module.exports = {
       helper.showError("添加插件失败:", error.message);
     }
   }
+
+  /**
+   * 同步开发插件
+   * 将当前目录下的 lib/myplugins 同步到 CLI 配置目录的 plugins
+   * @param {Object} helper - 插件帮助器
+   */
+  async syncDevPlugins(helper) {
+    try {
+      // 确保用户插件目录存在
+      fs.ensureDirSync(this.userPluginsDir);
+
+      // 开发插件目录路径
+      const devPluginsDir = path.join(process.cwd(), "lib/myplugins");
+
+      // 检查开发插件目录是否存在
+      if (!fs.existsSync(devPluginsDir)) {
+        helper.showError(`开发插件目录不存在: ${devPluginsDir}`);
+        return;
+      }
+
+      // 读取开发插件目录中的文件
+      const devPluginFiles = fs
+        .readdirSync(devPluginsDir)
+        .filter((file) => file.endsWith(".js"));
+
+      if (devPluginFiles.length === 0) {
+        helper.showInfo("开发插件目录中没有 JavaScript 文件");
+        return;
+      }
+
+      helper.showInfo(
+        `找到 ${devPluginFiles.length} 个开发插件文件，开始同步...`,
+      );
+
+      // 同步每个插件文件
+      let syncedCount = 0;
+      for (const file of devPluginFiles) {
+        const sourcePath = path.join(devPluginsDir, file);
+        const targetPath = path.join(this.userPluginsDir, file);
+
+        // 检查源文件是否存在
+        if (fs.existsSync(sourcePath)) {
+          // 复制文件
+          await fs.copy(sourcePath, targetPath, { overwrite: true });
+          helper.showSuccess(`已同步: ${file}`);
+          syncedCount++;
+        } else {
+          helper.showWarning(`跳过不存在的文件: ${file}`);
+        }
+      }
+
+      helper.showSuccess(`同步完成，共同步 ${syncedCount} 个插件文件`);
+      helper.showInfo(`插件已同步到: ${this.userPluginsDir}`);
+      helper.showInfo("\n提示:");
+      helper.showInfo("- 插件已自动注册到命令系统");
+      helper.showInfo('- 可以使用 "xx plugin list" 命令查看已安装的插件');
+      helper.showInfo('- 可以使用 "xx <plugin-command>" 命令使用插件功能');
+    } catch (error) {
+      helper.showError(`同步开发插件失败: ${error.message}`);
+    }
+  }
 }
 
 // 创建插件管理实例
@@ -567,21 +633,21 @@ module.exports = {
       action: async (args, options, helper) => {
         helper.showInfo(`args 对象: ${JSON.stringify(args)}`);
         helper.showInfo(`options 对象: ${JSON.stringify(options)}`);
-        
+
         // 提取插件名称
-        let pluginName = 'unnamed';
+        let pluginName = "unnamed";
         if (Array.isArray(args)) {
           // 遍历数组，找到非对象的字符串参数
           for (const arg of args) {
-            if (typeof arg === 'string') {
+            if (typeof arg === "string") {
               pluginName = arg;
               break;
             }
           }
-        } else if (typeof args === 'string') {
+        } else if (typeof args === "string") {
           pluginName = args;
         }
-        
+
         helper.showInfo(`提取的插件名称: ${pluginName}`);
         await pluginManager.createPlugin(pluginName, options, helper);
       },
@@ -608,7 +674,20 @@ module.exports = {
         },
       ],
       action: (args, options, helper) => {
-        pluginManager.managePluginConfig(args.plugin, args.key, args.value, helper);
+        pluginManager.managePluginConfig(
+          args.plugin,
+          args.key,
+          args.value,
+          helper,
+        );
+      },
+    },
+    {
+      name: "sync",
+      alias: "s",
+      description: "将当前目录下的 lib/myplugins 同步到 CLI 配置目录的 plugins",
+      action: async (args, options, helper) => {
+        await pluginManager.syncDevPlugins(helper);
       },
     },
   ],
@@ -618,4 +697,4 @@ module.exports = {
       description: "显示帮助信息",
     },
   ],
-};
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xubill/xx-cli",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "个人工具集",
   "main": "lib/core/index.js",
   "bin": {
@@ -55,8 +55,13 @@
     "zx": "^8.8.5"
   },
   "devDependencies": {
+    "medium-zoom": "^1.1.0",
+    "nprogress-v2": "^1.1.10",
     "standard-version": "^9.5.0",
     "vitepress": "^1.6.4",
+    "vitepress-plugin-announcement": "^0.1.7",
+    "vitepress-plugin-group-icons": "^1.7.1",
+    "vitepress-sidebar": "^1.33.1",
     "vue": "^3.5.26"
   }
 }