@xubill/xx-cli 1.0.0

package/lib/utils/config-manager.js

@@ -0,0 +1,185 @@
+/**
+ * 统一配置管理模块
+ * 提供标准化的配置加载、保存、验证功能
+ * 支持配置优先级：命令行参数 > 本地配置 > 全局配置
+ */
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk').default;
+
+class ConfigManager {
+  /**
+   * 构造函数
+   * @param {string} pluginName - 插件名称
+   * @param {Object} options - 配置选项
+   */
+  constructor(pluginName, options = {}) {
+    this.homeDir = process.env.HOME || process.env.USERPROFILE;
+    this.globalConfigDir = path.join(this.homeDir, '.xx', pluginName);
+    this.localConfigPath = options.localConfigPath || `.${pluginName}Config`;
+    this.ensureConfigDir();
+  }
+
+  /**
+   * 确保配置目录存在
+   */
+  ensureConfigDir() {
+    if (!fs.existsSync(this.globalConfigDir)) {
+      fs.mkdirSync(this.globalConfigDir, { recursive: true });
+    }
+  }
+
+  /**
+   * 加载配置
+   * @param {string} configName - 配置名称
+   * @param {Object} cliOptions - 命令行选项
+   * @returns {Object} 合并后的配置对象
+   */
+  loadConfig(configName = 'config', cliOptions = {}) {
+    // 1. 加载全局配置
+    const globalConfig = this.loadGlobalConfig(configName);
+    
+    // 2. 加载本地配置
+    const localConfig = this.loadLocalConfig(configName);
+    
+    // 3. 合并配置：本地配置覆盖全局配置，命令行选项覆盖本地配置
+    const mergedConfig = {
+      ...globalConfig,
+      ...localConfig,
+      ...cliOptions
+    };
+    
+    return mergedConfig;
+  }
+
+  /**
+   * 加载全局配置
+   * @param {string} configName - 配置名称
+   * @returns {Object} 全局配置对象
+   */
+  loadGlobalConfig(configName = 'config') {
+    const configPath = path.join(this.globalConfigDir, `${configName}.json`);
+    if (fs.existsSync(configPath)) {
+      try {
+        return JSON.parse(fs.readFileSync(configPath, 'utf8'));
+      } catch (error) {
+        console.error(chalk.red(`解析全局配置文件失败: ${error.message}`));
+        return {};
+      }
+    }
+    return {};
+  }
+
+  /**
+   * 加载本地配置
+   * @param {string} configName - 配置名称
+   * @returns {Object} 本地配置对象
+   */
+  loadLocalConfig(configName = 'config') {
+    const configPath = path.resolve(this.localConfigPath);
+    if (fs.existsSync(configPath)) {
+      try {
+        const localConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        // 如果是多环境配置，返回指定环境的配置
+        if (localConfig[configName]) {
+          return localConfig[configName];
+        }
+        return localConfig;
+      } catch (error) {
+        console.error(chalk.red(`解析本地配置文件失败: ${error.message}`));
+        return {};
+      }
+    }
+    return {};
+  }
+
+  /**
+   * 保存配置
+   * @param {Object} config - 配置对象
+   * @param {string} configName - 配置名称
+   * @param {boolean} isGlobal - 是否保存到全局配置
+   */
+  saveConfig(config, configName = 'config', isGlobal = true) {
+    try {
+      const configPath = isGlobal 
+        ? path.join(this.globalConfigDir, `${configName}.json`) 
+        : path.resolve(this.localConfigPath);
+      
+      // 确保目录存在
+      if (isGlobal) {
+        this.ensureConfigDir();
+      } else {
+        const configDir = path.dirname(configPath);
+        if (!fs.existsSync(configDir)) {
+          fs.mkdirSync(configDir, { recursive: true });
+        }
+      }
+      
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+      console.log(chalk.green(`配置保存成功: ${configPath}`));
+    } catch (error) {
+      console.error(chalk.red(`保存配置失败: ${error.message}`));
+    }
+  }
+
+  /**
+   * 验证配置
+   * @param {Object} config - 配置对象
+   * @param {Object} schema - 配置 schema
+   * @returns {Object} 验证结果
+   */
+  validateConfig(config, schema) {
+    if (!schema) {
+      return { valid: true, data: config };
+    }
+    
+    // 这里可以集成 Joi 等验证库
+    // 暂时返回简单验证
+    return { valid: true, data: config };
+  }
+
+  /**
+   * 获取配置路径
+   * @param {string} configName - 配置名称
+   * @param {boolean} isGlobal - 是否获取全局配置路径
+   * @returns {string} 配置文件路径
+   */
+  getConfigPath(configName = 'config', isGlobal = true) {
+    return isGlobal 
+      ? path.join(this.globalConfigDir, `${configName}.json`) 
+      : path.resolve(this.localConfigPath);
+  }
+
+  /**
+   * 检查配置是否存在
+   * @param {string} configName - 配置名称
+   * @param {boolean} isGlobal - 是否检查全局配置
+   * @returns {boolean} 配置是否存在
+   */
+  hasConfig(configName = 'config', isGlobal = true) {
+    const configPath = this.getConfigPath(configName, isGlobal);
+    return fs.existsSync(configPath);
+  }
+
+  /**
+   * 删除配置
+   * @param {string} configName - 配置名称
+   * @param {boolean} isGlobal - 是否删除全局配置
+   */
+  deleteConfig(configName = 'config', isGlobal = true) {
+    try {
+      const configPath = this.getConfigPath(configName, isGlobal);
+      if (fs.existsSync(configPath)) {
+        fs.unlinkSync(configPath);
+        console.log(chalk.green(`配置删除成功: ${configPath}`));
+      } else {
+        console.log(chalk.yellow(`配置文件不存在: ${configPath}`));
+      }
+    } catch (error) {
+      console.error(chalk.red(`删除配置失败: ${error.message}`));
+    }
+  }
+}
+
+module.exports = ConfigManager;

package/lib/utils/history-manager.js

@@ -0,0 +1,118 @@
+/**
+ * 命令历史记录管理
+ * 用于存储和读取命令历史
+ * 支持浏览和重复执行之前的命令
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 历史记录文件路径
+const historyPath = path.join(process.env.HOME || process.env.USERPROFILE, '.xx-cli', 'history.json');
+
+/**
+ * 确保历史记录目录存在
+ */
+function ensureHistoryDir() {
+  const historyDir = path.dirname(historyPath);
+  if (!fs.existsSync(historyDir)) {
+    fs.mkdirSync(historyDir, { recursive: true });
+  }
+}
+
+/**
+ * 读取命令历史
+ * @returns {Array} 命令历史数组
+ */
+exports.readHistory = () => {
+  ensureHistoryDir();
+  
+  if (fs.existsSync(historyPath)) {
+    try {
+      const history = fs.readFileSync(historyPath, 'utf8');
+      return JSON.parse(history);
+    } catch (error) {
+      console.error('读取命令历史失败:', error.message);
+      return [];
+    }
+  }
+  
+  return [];
+};
+
+/**
+ * 写入命令历史
+ * @param {Array} history - 命令历史数组
+ */
+exports.writeHistory = (history) => {
+  ensureHistoryDir();
+  
+  try {
+    fs.writeFileSync(historyPath, JSON.stringify(history, null, 2));
+  } catch (error) {
+    console.error('写入命令历史失败:', error.message);
+  }
+};
+
+/**
+ * 添加命令到历史记录
+ * @param {string} command - 命令字符串
+ */
+exports.addHistory = (command) => {
+  // 不记录空命令、帮助命令和 history 命令本身
+  if (!command || 
+      command.trim() === '' || 
+      command.includes('--help') || 
+      command.includes('-h') ||
+      command.startsWith('history') ||
+      command.startsWith('h ') ||
+      command === 'h') {
+    return;
+  }
+  
+  const history = exports.readHistory();
+  
+  // 移除重复的命令
+  const filteredHistory = history.filter(item => item.command !== command);
+  
+  // 添加新命令到开头
+  const newHistory = [
+    {
+      command,
+      timestamp: new Date().toISOString()
+    },
+    ...filteredHistory
+  ];
+  
+  // 限制历史记录数量
+  const limitedHistory = newHistory.slice(0, 100);
+  
+  exports.writeHistory(limitedHistory);
+};
+
+/**
+ * 清除命令历史
+ */
+exports.clearHistory = () => {
+  exports.writeHistory([]);
+};
+
+/**
+ * 获取命令历史
+ * @param {number} limit - 限制数量
+ * @returns {Array} 命令历史数组
+ */
+exports.getHistory = (limit = 10) => {
+  const history = exports.readHistory();
+  return history.slice(0, limit);
+};
+
+/**
+ * 搜索命令历史
+ * @param {string} keyword - 搜索关键词
+ * @returns {Array} 匹配的命令历史数组
+ */
+exports.searchHistory = (keyword) => {
+  const history = exports.readHistory();
+  return history.filter(item => item.command.includes(keyword));
+};

package/lib/utils/logger.js

@@ -0,0 +1,28 @@
+/**
+ * 日志工具模块
+ * 使用 winston 实现日志功能
+ */
+
+const winston = require('winston');
+
+// 自定义日志格式化
+const consoleFormat = winston.format.combine(
+  winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
+  winston.format.printf(({ timestamp, level, message }) => {
+    return `[${timestamp}] [${level.toUpperCase()}] ${message}`;
+  })
+);
+
+// 创建日志实例
+const logger = winston.createLogger({
+  level: 'info',
+  format: winston.format.json(),
+  transports: [
+    // 控制台输出
+    new winston.transports.Console({
+      format: consoleFormat
+    })
+  ]
+});
+
+module.exports = logger;

package/lib/utils/plugin-config.js

@@ -0,0 +1,158 @@
+/**
+ * 插件配置管理
+ * 用于管理插件的启用/禁用状态
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 插件配置文件路径
+const configPath = path.join(process.env.HOME || process.env.USERPROFILE, '.xx-cli', 'plugin-config.json');
+
+/**
+ * 确保配置目录存在
+ */
+function ensureConfigDir() {
+  const configDir = path.dirname(configPath);
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+  }
+}
+
+/**
+ * 读取插件配置
+ * @returns {Object} 插件配置
+ */
+exports.readConfig = () => {
+  ensureConfigDir();
+  
+  if (fs.existsSync(configPath)) {
+    try {
+      const config = fs.readFileSync(configPath, 'utf8');
+      return JSON.parse(config);
+    } catch (error) {
+      console.error('读取插件配置失败:', error.message);
+      return { disabled: [] };
+    }
+  }
+  
+  return { disabled: [] };
+};
+
+/**
+ * 写入插件配置
+ * @param {Object} config - 插件配置
+ */
+exports.writeConfig = (config) => {
+  ensureConfigDir();
+  
+  try {
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  } catch (error) {
+    console.error('写入插件配置失败:', error.message);
+  }
+};
+
+/**
+ * 检查插件是否已禁用
+ * @param {string} pluginName - 插件名称
+ * @returns {boolean} 是否已禁用
+ */
+exports.isPluginDisabled = (pluginName) => {
+  const config = exports.readConfig();
+  return config.disabled.includes(pluginName);
+};
+
+/**
+ * 禁用插件
+ * @param {string} pluginName - 插件名称
+ */
+exports.disablePlugin = (pluginName) => {
+  const config = exports.readConfig();
+  if (!config.disabled.includes(pluginName)) {
+    config.disabled.push(pluginName);
+    exports.writeConfig(config);
+  }
+};
+
+/**
+ * 启用插件
+ * @param {string} pluginName - 插件名称
+ */
+exports.enablePlugin = (pluginName) => {
+  const config = exports.readConfig();
+  config.disabled = config.disabled.filter(name => name !== pluginName);
+  exports.writeConfig(config);
+};
+
+/**
+ * 从配置中移除插件
+ * @param {string} pluginName - 插件名称
+ */
+exports.removePluginFromConfig = (pluginName) => {
+  const config = exports.readConfig();
+  config.disabled = config.disabled.filter(name => name !== pluginName);
+  
+  // 同时移除插件的配置
+  if (config.plugins && config.plugins[pluginName]) {
+    delete config.plugins[pluginName];
+  }
+  
+  exports.writeConfig(config);
+};
+
+/**
+ * 设置插件配置
+ * @param {string} pluginName - 插件名称
+ * @param {string} key - 配置键
+ * @param {string} value - 配置值
+ */
+exports.setPluginConfig = (pluginName, key, value) => {
+  const config = exports.readConfig();
+  
+  // 确保 plugins 对象存在
+  if (!config.plugins) {
+    config.plugins = {};
+  }
+  
+  // 确保插件的配置对象存在
+  if (!config.plugins[pluginName]) {
+    config.plugins[pluginName] = {};
+  }
+  
+  // 设置配置值
+  config.plugins[pluginName][key] = value;
+  
+  exports.writeConfig(config);
+};
+
+/**
+ * 获取插件配置
+ * @param {string} pluginName - 插件名称
+ * @param {string} key - 配置键
+ * @returns {*} 配置值
+ */
+exports.getPluginConfig = (pluginName, key) => {
+  const config = exports.readConfig();
+  
+  if (config.plugins && config.plugins[pluginName]) {
+    return config.plugins[pluginName][key];
+  }
+  
+  return undefined;
+};
+
+/**
+ * 获取插件所有配置
+ * @param {string} pluginName - 插件名称
+ * @returns {Object} 插件配置对象
+ */
+exports.getPluginConfigs = (pluginName) => {
+  const config = exports.readConfig();
+  
+  if (config.plugins && config.plugins[pluginName]) {
+    return config.plugins[pluginName];
+  }
+  
+  return {};
+};

package/lib/utils/transformers/getInput.js

@@ -0,0 +1,76 @@
+/**
+ * 获取输入配置
+ * 处理用户输入的模板配置，转换为标准格式
+ */
+
+/**
+ * 处理模板配置
+ * @param {Object} config - 原始模板配置
+ * @returns {Object} 处理后的模板配置
+ */
+function processTemplateConfig(config) {
+  // 确保配置对象存在
+  if (!config) {
+    return {
+      dir: '.lists',
+      pages: {},
+      routes: { isRender: false },
+      mock: false
+    };
+  }
+
+  // 处理默认值
+  return {
+    dir: config.dir || '.lists',
+    pages: config.pages || {},
+    routes: {
+      isRender: config.routes?.isRender ?? false,
+      ...config.routes
+    },
+    mock: config.mock ?? false,
+    templateType: config.templateType || 'element-ui'
+  };
+}
+
+/**
+ * 处理页面配置
+ * @param {Object} pageConfig - 原始页面配置
+ * @returns {Object} 处理后的页面配置
+ */
+function processPageConfig(pageConfig) {
+  // 确保配置对象存在
+  if (!pageConfig) {
+    return {
+      template: {
+        cn: '列表页面',
+        en: 'list',
+        top: false,
+        bottom: false,
+        select: false,
+        btn: []
+      },
+      filter: {},
+      table: {}
+    };
+  }
+
+  // 处理默认值
+  return {
+    template: {
+      cn: pageConfig.template?.cn || '列表页面',
+      en: pageConfig.template?.en || 'list',
+      top: pageConfig.template?.top ?? false,
+      bottom: pageConfig.template?.bottom ?? false,
+      select: pageConfig.template?.select ?? false,
+      btn: pageConfig.template?.btn || [],
+      ...pageConfig.template
+    },
+    filter: pageConfig.filter || {},
+    table: pageConfig.table || {}
+  };
+}
+
+module.exports = {
+  processTemplateConfig,
+  processPageConfig
+};

package/lib/utils/transformers/index.js

@@ -0,0 +1,43 @@
+/**
+ * Transformers 统一入口
+ * 导出所有转换逻辑方法
+ */
+
+// 导出筛选器转换
+const { transformFilter, generateFieldName } = require('./transformFilter');
+
+// 导出表格转换
+const { transformTable } = require('./transformTable');
+
+// 导出列表页面转换
+const { transformList } = require('./transformList');
+
+// 导出路由转换
+const { transformRoutes } = require('./transformRoutes');
+
+// 导出 Mock 数据转换
+const { transformMock } = require('./transformMock');
+
+// 导出渲染列表页面
+const { renderLists } = require('./renderLists');
+
+module.exports = {
+  // 筛选器相关
+  transformFilter,
+  generateFieldName,
+  
+  // 表格相关
+  transformTable,
+  
+  // 列表页面相关
+  transformList,
+  
+  // 路由相关
+  transformRoutes,
+  
+  // Mock 数据相关
+  transformMock,
+  
+  // 渲染相关
+  renderLists
+};

package/lib/utils/transformers/renderLists.js

@@ -0,0 +1,94 @@
+/**
+ * 渲染列表页面的主入口
+ * 协调各个转换模块，生成完整的页面文件
+ */
+
+// 导入转换模块
+const { processTemplateConfig, processPageConfig } = require('./getInput');
+const { getSfcMaterial, getTransformersByType } = require('./sfcMaterial');
+const { transformList } = require('./transformList');
+const { transformRoutes } = require('./transformRoutes');
+const { transformMock } = require('./transformMock');
+
+/**
+ * 渲染列表页面
+ * @param {Object} config - 模板配置
+ * @returns {Object} 生成的文件内容
+ */
+function renderLists(config) {
+  // 处理模板配置
+  const processedConfig = processTemplateConfig(config);
+  
+  // 获取模板类型
+  const templateType = processedConfig.templateType;
+  
+  // 获取组件材料
+  const material = getSfcMaterial(templateType);
+  
+  // 获取转换函数
+  const transformers = getTransformersByType(templateType);
+  
+  const results = {
+    pages: {},
+    routes: null,
+    mock: {}
+  };
+  
+  // 处理每个页面
+  const pages = processedConfig.pages;
+  for (const [pageName, pageConfig] of Object.entries(pages)) {
+    // 处理页面配置
+    const processedPageConfig = processPageConfig(pageConfig);
+    const { template, filter, table } = processedPageConfig;
+    
+    // 生成 Vue 文件内容
+    const vueContent = transformList(template, filter, table, material);
+    results.pages[pageName] = {
+      content: vueContent,
+      fileName: `${template.en}.vue`
+    };
+    
+    // 生成 Mock 数据（如果需要）
+    if (processedConfig.mock) {
+      const mockContent = transformMock(template);
+      results.mock[pageName] = {
+        content: mockContent,
+        fileName: `${template.en}.mock.js`
+      };
+    }
+  }
+  
+  // 生成路由配置（如果需要）
+  if (processedConfig.routes?.isRender) {
+    const routesContent = transformRoutes(processedConfig);
+    results.routes = {
+      content: routesContent,
+      fileName: 'routes.js'
+    };
+  }
+  
+  return results;
+}
+
+/**
+ * 渲染单个页面
+ * @param {Object} pageConfig - 页面配置
+ * @param {string} templateType - 模板类型
+ * @returns {string} Vue 文件内容
+ */
+function renderSinglePage(pageConfig, templateType = 'element-ui') {
+  // 处理页面配置
+  const processedPageConfig = processPageConfig(pageConfig);
+  const { template, filter, table } = processedPageConfig;
+  
+  // 获取组件材料
+  const material = getSfcMaterial(templateType);
+  
+  // 生成 Vue 文件内容
+  return transformList(template, filter, table, material);
+}
+
+module.exports = {
+  renderLists,
+  renderSinglePage
+};