@agile-team/robot-cli 1.0.3 → 1.0.4

package/bin/index.js

@@ -1,341 +1,476 @@
 #!/usr/bin/env node
 
-import { Command } from 'commander';
-import chalk from 'chalk';
-import boxen from 'boxen';
-import inquirer from 'inquirer';
-import { createProject } from '../lib/create.js';
-import { clearCache, getCacheInfo, formatSize } from '../lib/cache.js';
-import { getAllTemplates, searchTemplates, getRecommendedTemplates } from '../lib/templates.js';
-import { checkNetworkConnection } from '../lib/utils.js';
+import { fileURLToPath } from 'url';
+import { dirname, join, resolve } from 'path';
+import { existsSync } from 'fs';
 
-const program = new Command();
+// 获取当前文件的目录
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 
-// 现代化欢迎信息
-function showWelcome() {
-  console.clear();
-  
-  const logoLines = [
-    '   ██████╗  ██████╗ ██████╗  ██████╗ ████████╗',
-    '   ██╔══██╗██╔═══██╗██╔══██╗██╔═══██╗╚══██╔══╝',
-    '   ██████╔╝██║   ██║██████╔╝██║   ██║   ██║   ',
-    '   ██╔══██╗██║   ██║██╔══██╗██║   ██║   ██║   ',
-    '   ██║  ██║╚██████╔╝██████╔╝╚██████╔╝   ██║   ',
-    '   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═════╝    ╚═╝   '
+/**
+ * 智能路径解析 - 兼容不同包管理器的安装路径
+ */
+function resolveLibPath() {
+  // 可能的 lib 目录路径
+  const possiblePaths = [
+    // 1. 标准相对路径 (开发环境 + 大多数情况)
+    join(__dirname, '..', 'lib'),
+    
+    // 2. 同级目录 (某些链接情况)
+    join(__dirname, 'lib'),
+    
+    // 3. 向上查找 (深度嵌套情况)
+    join(__dirname, '..', '..', 'lib'),
+    
+    // 4. 从 node_modules 查找 (npm/yarn)
+    join(__dirname, '..', 'node_modules', '@agile-team', 'robot-cli', 'lib'),
+    
+    // 5. 全局安装的各种可能路径
+    resolve(__dirname, '..', 'lib'),
+    resolve(__dirname, '../../lib'),
+    
+    // 6. bun 特殊路径处理
+    join(__dirname, '..', '..', '@agile-team', 'robot-cli', 'lib'),
   ];
-  
-  const logo = logoLines.map(line => chalk.cyan(line)).join('\n');
-  
-  const titleBox = boxen(
-    logo + '\n\n' +
-    '      🤖 Robot 项目脚手架工具  v1.0.0\n' +
-    '         ',
-    {
-      padding: { top: 1, bottom: 1, left: 2, right: 2 },
-      borderStyle: 'round',
-      borderColor: 'cyan',
-      backgroundColor: 'blackBright'
+
+  // 查找第一个存在的路径
+  for (const libPath of possiblePaths) {
+    if (existsSync(libPath)) {
+      return libPath;
     }
-  );
-  
-  console.log();
-  console.log(titleBox);
-  console.log();
+  }
+
+  // 如果都找不到，抛出详细错误
+  throw new Error(`
+无法找到 lib 目录，已尝试以下路径:
+${possiblePaths.map(p => `  - ${p}`).join('\n')}
+
+当前执行路径: ${__dirname}
+工作目录: ${process.cwd()}
+
+可能的解决方案:
+1. 重新安装: npm uninstall -g @agile-team/robot-cli && npm install -g @agile-team/robot-cli
+2. 使用 npx: npx @agile-team/robot-cli
+3. 检查包完整性: npm list -g @agile-team/robot-cli
+  `);
 }
 
-// 显示主菜单
-async function showMainMenu() {
-  const title = chalk.white.bold('🚀 快速开始');
-  
-  console.log('  ' + title);
-  console.log();
-  
-  // 获取统计信息
-  const allTemplates = getAllTemplates();
-  const templateCount = Object.keys(allTemplates).length;
-  const cacheInfo = await getCacheInfo();
-  
-  console.log(chalk.dim(`  📦 可用模板: ${templateCount} 个`));
-  console.log(chalk.dim(`  💾 缓存模板: ${cacheInfo.templates.length} 个 (${formatSize(cacheInfo.size)})`));
-  console.log();
-  
-  const commands = [
-    {
-      cmd: 'robot create',
-      desc: '交互式创建项目',
-      color: 'cyan'
-    },
-    {
-      cmd: 'robot create <name>',
-      desc: '快速创建项目',
-      color: 'green'
-    },
-    {
-      cmd: 'robot list',
-      desc: '查看所有可用模板',
-      color: 'blue'
-    },
-    {
-      cmd: 'robot search <keyword>',
-      desc: '搜索模板',
-      color: 'magenta'
-    },
-    {
-      cmd: 'robot cache',
-      desc: '缓存管理',
-      color: 'yellow'
-    }
-  ];
-  
-  commands.forEach(({ cmd, desc, color }) => {
-    console.log('  ' + chalk[color](cmd.padEnd(24)) + chalk.dim(desc));
-  });
-  
-  console.log();
-  console.log(chalk.dim('  示例:'));
-  console.log(chalk.dim('    robot create my-vue-admin'));
-  console.log(chalk.dim('    robot search vue'));
-  console.log(chalk.dim('    robot create my-app --template vue-admin-full'));
-  console.log();
+// 动态导入所需模块
+async function loadModules() {
+  try {
+    const libPath = resolveLibPath();
+    
+    // 动态导入所有需要的模块
+    const [
+      { Command },
+      chalk,
+      boxen,
+      inquirer,
+      { createProject },
+      { clearCache, getCacheInfo, formatSize },
+      { getAllTemplates, searchTemplates, getRecommendedTemplates },
+      { checkNetworkConnection }
+    ] = await Promise.all([
+      import('commander'),
+      import('chalk'),
+      import('boxen'),
+      import('inquirer'),
+      import(join(libPath, 'create.js')),
+      import(join(libPath, 'cache.js')),
+      import(join(libPath, 'templates.js')),
+      import(join(libPath, 'utils.js'))
+    ]);
+
+    return {
+      Command,
+      chalk: chalk.default,
+      boxen: boxen.default,
+      inquirer: inquirer.default,
+      createProject,
+      clearCache,
+      getCacheInfo,
+      formatSize,
+      getAllTemplates,
+      searchTemplates,
+      getRecommendedTemplates,
+      checkNetworkConnection
+    };
+  } catch (error) {
+    console.error(`
+❌ 模块加载失败: ${error.message}
+
+🔧 诊断信息:
+  当前文件: ${__filename}
+  执行目录: ${__dirname}
+  工作目录: ${process.cwd()}
+  Node版本: ${process.version}
+
+💡 解决方案:
+  1. 完全重装: npm uninstall -g @agile-team/robot-cli && npm install -g @agile-team/robot-cli
+  2. 使用npx: npx @agile-team/robot-cli
+  3. 联系支持: https://github.com/ChenyCHENYU/robot-cli/issues
+    `);
+    process.exit(1);
+  }
 }
 
-program
-  .name('robot')
-  .description('🤖 Robot 项目脚手架工具 - @cheny/robot-cli')
-  .version('1.0.0')
-  .hook('preAction', () => {
-    showWelcome();
-  });
+// 主程序
+async function main() {
+  try {
+    const modules = await loadModules();
+    const { 
+      Command, 
+      chalk, 
+      boxen, 
+      inquirer,
+      createProject,
+      clearCache,
+      getCacheInfo,
+      formatSize,
+      getAllTemplates,
+      searchTemplates,
+      getRecommendedTemplates,
+      checkNetworkConnection
+    } = modules;
 
-// 创建项目命令
-program
-  .command('create [project-name]')
-  .description('创建新项目')
-  .option('-t, --template <template>', '指定模板类型')
-  .option('--no-cache', '强制重新下载模板')
-  .option('--skip-install', '跳过依赖安装')
-  .action(async (projectName, options) => {
-    try {
-      // 检查网络连接
-      if (!options.cache) {
-        console.log(chalk.blue('🌐 检查网络连接...'));
-        const hasNetwork = await checkNetworkConnection();
-        if (!hasNetwork) {
-          console.log(chalk.red('❌ 网络连接失败，无法下载模板'));
-          console.log(chalk.yellow('💡 请检查网络连接后重试'));
-          process.exit(1);
-        }
-      }
+    const program = new Command();
+
+    // 现代化欢迎信息
+    function showWelcome() {
+      console.clear();
       
-      await createProject(projectName, options);
-    } catch (error) {
-      console.log();
-      console.log(chalk.red('✗'), chalk.red.bold('创建失败'));
+      const logoLines = [
+        '   ██████╗  ██████╗ ██████╗  ██████╗ ████████╗',
+        '   ██╔══██╗██╔═══██╗██╔══██╗██╔═══██╗╚══██╔══╝',
+        '   ██████╔╝██║   ██║██████╔╝██║   ██║   ██║   ',
+        '   ██╔══██╗██║   ██║██╔══██╗██║   ██║   ██║   ',
+        '   ██║  ██║╚██████╔╝██████╔╝╚██████╔╝   ██║   ',
+        '   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚═════╝    ╚═╝   '
+      ];
       
-      // 根据错误类型提供不同的建议
-      if (error.message.includes('网络')) {
-        console.log('  ' + chalk.dim('网络相关问题，请检查网络连接'));
-      } else if (error.message.includes('权限')) {
-        console.log('  ' + chalk.dim('权限问题，请检查文件夹权限'));
-      } else {
-        console.log('  ' + chalk.dim(error.message));
-      }
+      const logo = logoLines.map(line => chalk.cyan(line)).join('\n');
+      
+      const titleBox = boxen(
+        logo + '\n\n' +
+        '      🤖 Robot 项目脚手架工具  v1.0.3\n' +
+        '         兼容 npm/yarn/pnpm/bun',
+        {
+          padding: { top: 1, bottom: 1, left: 2, right: 2 },
+          borderStyle: 'round',
+          borderColor: 'cyan',
+          backgroundColor: 'blackBright'
+        }
+      );
       
       console.log();
-      console.log(chalk.blue('💡 获取帮助:'));
-      console.log(chalk.dim('   robot --help'));
-      console.log(chalk.dim('   联系团队技术支持'));
+      console.log(titleBox);
       console.log();
-      process.exit(1);
     }
-  });
 
-// 列出所有模板
-program
-  .command('list')
-  .alias('ls')
-  .description('列出所有可用模板')
-  .option('-r, --recommended', '只显示推荐模板')
-  .option('-c, --category <category>', '按分类筛选')
-  .action(async (options) => {
-    try {
-      let templates;
-      let title;
+    // 显示主菜单
+    async function showMainMenu() {
+      const title = chalk.white.bold('🚀 快速开始');
+      
+      console.log('  ' + title);
+      console.log();
       
-      if (options.recommended) {
-        templates = getRecommendedTemplates();
-        title = '🎯 推荐模板';
-      } else {
-        templates = getAllTemplates();
-        title = '📋 所有可用模板';
-      }
+      // 获取统计信息
+      const allTemplates = getAllTemplates();
+      const templateCount = Object.keys(allTemplates).length;
+      const cacheInfo = await getCacheInfo();
       
+      console.log(chalk.dim(`  📦 可用模板: ${templateCount} 个`));
+      console.log(chalk.dim(`  💾 缓存模板: ${cacheInfo.templates.length} 个 (${formatSize(cacheInfo.size)})`));
       console.log();
-      console.log(chalk.blue(title));
-      console.log(chalk.dim(`共 ${Object.keys(templates).length} 个模板\n`));
       
-      // 按分类显示
-      const categories = {};
-      Object.entries(templates).forEach(([key, template]) => {
-        // 简单分类逻辑，根据模板名称前缀
-        const category = key.split('-')[0];
-        if (!categories[category]) {
-          categories[category] = [];
+      const commands = [
+        {
+          cmd: 'robot create',
+          desc: '交互式创建项目',
+          color: 'cyan'
+        },
+        {
+          cmd: 'robot create <name>',
+          desc: '快速创建项目',
+          color: 'green'
+        },
+        {
+          cmd: 'robot list',
+          desc: '查看所有可用模板',
+          color: 'blue'
+        },
+        {
+          cmd: 'robot search <keyword>',
+          desc: '搜索模板',
+          color: 'magenta'
+        },
+        {
+          cmd: 'robot cache',
+          desc: '缓存管理',
+          color: 'yellow'
         }
-        categories[category].push({ key, ...template });
-      });
+      ];
       
-      Object.entries(categories).forEach(([category, templates]) => {
-        console.log(chalk.cyan(`${category.toUpperCase()} 相关:`));
-        templates.forEach(template => {
-          console.log(`  ${chalk.green('●')} ${chalk.bold(template.name)}`);
-          console.log(`    ${chalk.dim(template.description)}`);
-          console.log(`    ${chalk.dim('功能: ' + template.features.join(', '))}`);
-          console.log(`    ${chalk.dim('使用: robot create my-app --template ' + template.key)}`);
-          console.log();
-        });
+      commands.forEach(({ cmd, desc, color }) => {
+        console.log('  ' + chalk[color](cmd.padEnd(24)) + chalk.dim(desc));
       });
       
-    } catch (error) {
-      console.log(chalk.red('❌ 获取模板列表失败:'), error.message);
-    }
-  });
-
-// 搜索模板
-program
-  .command('search <keyword>')
-  .description('搜索模板')
-  .action(async (keyword) => {
-    try {
-      const results = searchTemplates(keyword);
-      
       console.log();
-      if (Object.keys(results).length === 0) {
-        console.log(chalk.yellow('🔍 没有找到匹配的模板'));
-        console.log();
-        console.log(chalk.blue('💡 建议:'));
-        console.log(chalk.dim('   • 尝试其他关键词'));
-        console.log(chalk.dim('   • 使用 robot list 查看所有模板'));
-        console.log(chalk.dim('   • 使用 robot list --recommended 查看推荐模板'));
-      } else {
-        console.log(chalk.green(`🔍 找到 ${Object.keys(results).length} 个匹配的模板:`));
-        console.log();
-        
-        Object.entries(results).forEach(([key, template]) => {
-          console.log(`${chalk.green('●')} ${chalk.bold(template.name)}`);
-          console.log(`  ${chalk.dim(template.description)}`);
-          console.log(`  ${chalk.dim('功能: ' + template.features.join(', '))}`);
-          console.log(`  ${chalk.cyan('robot create my-app --template ' + key)}`);
-          console.log();
-        });
-      }
-    } catch (error) {
-      console.log(chalk.red('❌ 搜索失败:'), error.message);
+      console.log(chalk.dim('  示例:'));
+      console.log(chalk.dim('    robot create my-vue-admin'));
+      console.log(chalk.dim('    robot search vue'));
+      console.log(chalk.dim('    robot create my-app --template robot-admin'));
+      console.log();
     }
-  });
 
-// 缓存管理
-program
-  .command('cache')
-  .description('缓存管理')
-  .option('-c, --clear', '清除所有缓存')
-  .option('-i, --info', '显示缓存信息')
-  .action(async (options) => {
-    try {
-      if (options.clear) {
-        const { confirmed } = await inquirer.prompt([
-          {
-            type: 'confirm',
-            name: 'confirmed',
-            message: '确认清除所有模板缓存?',
-            default: false
+    program
+      .name('robot')
+      .description('🤖 Robot 项目脚手架工具 - @agile-team/robot-cli')
+      .version('1.0.3')
+      .hook('preAction', () => {
+        showWelcome();
+      });
+
+    // 创建项目命令
+    program
+      .command('create [project-name]')
+      .description('创建新项目')
+      .option('-t, --template <template>', '指定模板类型')
+      .option('--no-cache', '强制重新下载模板')
+      .option('--skip-install', '跳过依赖安装')
+      .action(async (projectName, options) => {
+        try {
+          // 检查网络连接
+          if (!options.cache) {
+            console.log(chalk.blue('🌐 检查网络连接...'));
+            const hasNetwork = await checkNetworkConnection();
+            if (!hasNetwork) {
+              console.log(chalk.red('❌ 网络连接失败，无法下载模板'));
+              console.log(chalk.yellow('💡 请检查网络连接后重试'));
+              process.exit(1);
+            }
           }
-        ]);
-        
-        if (confirmed) {
-          await clearCache();
+          
+          await createProject(projectName, options);
+        } catch (error) {
           console.log();
-          console.log(chalk.green('✓'), chalk.green.bold('缓存清除成功'));
-        } else {
-          console.log(chalk.yellow('❌ 取消清除'));
+          console.log(chalk.red('✗'), chalk.red.bold('创建失败'));
+          
+          // 根据错误类型提供不同的建议
+          if (error.message.includes('网络')) {
+            console.log('  ' + chalk.dim('网络相关问题，请检查网络连接'));
+          } else if (error.message.includes('权限')) {
+            console.log('  ' + chalk.dim('权限问题，请检查文件夹权限'));
+          } else {
+            console.log('  ' + chalk.dim(error.message));
+          }
+          
+          console.log();
+          console.log(chalk.blue('💡 获取帮助:'));
+          console.log(chalk.dim('   robot --help'));
+          console.log(chalk.dim('   https://github.com/ChenyCHENYU/robot-cli/issues'));
+          console.log();
+          process.exit(1);
         }
-      } else {
-        // 显示缓存信息
-        const cacheInfo = await getCacheInfo();
-        
-        console.log();
-        console.log(chalk.blue('💾 缓存信息:'));
-        console.log();
-        
-        if (!cacheInfo.exists || cacheInfo.templates.length === 0) {
-          console.log(chalk.dim('  暂无缓存模板'));
-        } else {
-          console.log(`  缓存目录: ${chalk.dim(cacheInfo.path)}`);
-          console.log(`  模板数量: ${chalk.cyan(cacheInfo.templates.length)} 个`);
-          console.log(`  总大小: ${chalk.cyan(formatSize(cacheInfo.size))}`);
+      });
+
+    // 列出所有模板
+    program
+      .command('list')
+      .alias('ls')
+      .description('列出所有可用模板')
+      .option('-r, --recommended', '只显示推荐模板')
+      .option('-c, --category <category>', '按分类筛选')
+      .action(async (options) => {
+        try {
+          let templates;
+          let title;
+          
+          if (options.recommended) {
+            templates = getRecommendedTemplates();
+            title = '🎯 推荐模板';
+          } else {
+            templates = getAllTemplates();
+            title = '📋 所有可用模板';
+          }
+          
           console.log();
-          console.log(chalk.blue('  缓存的模板:'));
+          console.log(chalk.blue(title));
+          console.log(chalk.dim(`共 ${Object.keys(templates).length} 个模板\n`));
           
-          cacheInfo.templates.forEach(template => {
-            const modifiedTime = template.modifiedTime.toLocaleDateString();
-            console.log(`    ${chalk.green('●')} ${template.name}`);
-            console.log(`      大小: ${formatSize(template.size)}  更新: ${modifiedTime}`);
+          // 按分类显示
+          const categories = {};
+          Object.entries(templates).forEach(([key, template]) => {
+            // 简单分类逻辑，根据模板名称前缀
+            const category = key.split('-')[0];
+            if (!categories[category]) {
+              categories[category] = [];
+            }
+            categories[category].push({ key, ...template });
           });
+          
+          Object.entries(categories).forEach(([category, templates]) => {
+            console.log(chalk.cyan(`${category.toUpperCase()} 相关:`));
+            templates.forEach(template => {
+              console.log(`  ${chalk.green('●')} ${chalk.bold(template.name)}`);
+              console.log(`    ${chalk.dim(template.description)}`);
+              console.log(`    ${chalk.dim('功能: ' + template.features.join(', '))}`);
+              console.log(`    ${chalk.dim('使用: robot create my-app --template ' + template.key)}`);
+              console.log();
+            });
+          });
+          
+        } catch (error) {
+          console.log(chalk.red('❌ 获取模板列表失败:'), error.message);
+        }
+      });
+
+    // 搜索模板
+    program
+      .command('search <keyword>')
+      .description('搜索模板')
+      .action(async (keyword) => {
+        try {
+          const results = searchTemplates(keyword);
+          
+          console.log();
+          if (Object.keys(results).length === 0) {
+            console.log(chalk.yellow('🔍 没有找到匹配的模板'));
+            console.log();
+            console.log(chalk.blue('💡 建议:'));
+            console.log(chalk.dim('   • 尝试其他关键词'));
+            console.log(chalk.dim('   • 使用 robot list 查看所有模板'));
+            console.log(chalk.dim('   • 使用 robot list --recommended 查看推荐模板'));
+          } else {
+            console.log(chalk.green(`🔍 找到 ${Object.keys(results).length} 个匹配的模板:`));
+            console.log();
+            
+            Object.entries(results).forEach(([key, template]) => {
+              console.log(`${chalk.green('●')} ${chalk.bold(template.name)}`);
+              console.log(`  ${chalk.dim(template.description)}`);
+              console.log(`  ${chalk.dim('功能: ' + template.features.join(', '))}`);
+              console.log(`  ${chalk.cyan('robot create my-app --template ' + key)}`);
+              console.log();
+            });
+          }
+        } catch (error) {
+          console.log(chalk.red('❌ 搜索失败:'), error.message);
+        }
+      });
+
+    // 缓存管理
+    program
+      .command('cache')
+      .description('缓存管理')
+      .option('-c, --clear', '清除所有缓存')
+      .option('-i, --info', '显示缓存信息')
+      .action(async (options) => {
+        try {
+          if (options.clear) {
+            const { confirmed } = await inquirer.prompt([
+              {
+                type: 'confirm',
+                name: 'confirmed',
+                message: '确认清除所有模板缓存?',
+                default: false
+              }
+            ]);
+            
+            if (confirmed) {
+              await clearCache();
+              console.log();
+              console.log(chalk.green('✓'), chalk.green.bold('缓存清除成功'));
+            } else {
+              console.log(chalk.yellow('❌ 取消清除'));
+            }
+          } else {
+            // 显示缓存信息
+            const cacheInfo = await getCacheInfo();
+            
+            console.log();
+            console.log(chalk.blue('💾 缓存信息:'));
+            console.log();
+            
+            if (!cacheInfo.exists || cacheInfo.templates.length === 0) {
+              console.log(chalk.dim('  暂无缓存模板'));
+            } else {
+              console.log(`  缓存目录: ${chalk.dim(cacheInfo.path)}`);
+              console.log(`  模板数量: ${chalk.cyan(cacheInfo.templates.length)} 个`);
+              console.log(`  总大小: ${chalk.cyan(formatSize(cacheInfo.size))}`);
+              console.log();
+              console.log(chalk.blue('  缓存的模板:'));
+              
+              cacheInfo.templates.forEach(template => {
+                const modifiedTime = template.modifiedTime.toLocaleDateString();
+                console.log(`    ${chalk.green('●')} ${template.name}`);
+                console.log(`      大小: ${formatSize(template.size)}  更新: ${modifiedTime}`);
+              });
+            }
+            
+            console.log();
+            console.log(chalk.dim('  使用 robot cache --clear 清除缓存'));
+          }
+        } catch (error) {
+          console.log(chalk.red('❌ 缓存操作失败:'), error.message);
+        }
+      });
+
+    // 清除缓存命令 (向后兼容)
+    program
+      .command('clear-cache')
+      .description('清除模板缓存')
+      .action(async () => {
+        try {
+          await clearCache();
+          console.log();
+          console.log(chalk.green('✓'), chalk.green.bold('缓存清除成功'));
+          console.log();
+        } catch (error) {
+          console.log();
+          console.log(chalk.red('✗'), chalk.red.bold('清除缓存失败'));
+          console.log('  ' + chalk.dim(error.message));
+          console.log();
         }
-        
-        console.log();
-        console.log(chalk.dim('  使用 robot cache --clear 清除缓存'));
-      }
-    } catch (error) {
-      console.log(chalk.red('❌ 缓存操作失败:'), error.message);
+      });
+
+    // 如果没有参数，显示主菜单
+    if (process.argv.length === 2) {
+      showWelcome();
+      await showMainMenu();
+      process.exit(0);
     }
-  });
 
-// 清除缓存命令 (向后兼容)
-program
-  .command('clear-cache')
-  .description('清除模板缓存')
-  .action(async () => {
-    try {
-      await clearCache();
-      console.log();
-      console.log(chalk.green('✓'), chalk.green.bold('缓存清除成功'));
+    // 全局错误处理
+    process.on('uncaughtException', (error) => {
       console.log();
-    } catch (error) {
+      console.log(chalk.red('💥 程序发生未预期的错误:'));
+      console.log(chalk.dim(error.message));
       console.log();
-      console.log(chalk.red('✗'), chalk.red.bold('清除缓存失败'));
-      console.log('  ' + chalk.dim(error.message));
+      console.log(chalk.blue('💡 建议:'));
+      console.log(chalk.dim('   • 重启终端重试'));
+      console.log(chalk.dim('   • 检查网络连接'));
+      console.log(chalk.dim('   • 重新安装: npm install -g @agile-team/robot-cli'));
+      console.log(chalk.dim('   • 联系技术支持: https://github.com/ChenyCHENYU/robot-cli/issues'));
       console.log();
-    }
-  });
+      process.exit(1);
+    });
 
-// 如果没有参数，显示主菜单
-if (process.argv.length === 2) {
-  showWelcome();
-  await showMainMenu();
-  process.exit(0);
-}
+    process.on('unhandledRejection', (error) => {
+      console.log();
+      console.log(chalk.red('💥 程序发生未处理的异步错误:'));
+      console.log(chalk.dim(error.message));
+      console.log();
+      process.exit(1);
+    });
 
-// 全局错误处理
-process.on('uncaughtException', (error) => {
-  console.log();
-  console.log(chalk.red('💥 程序发生未预期的错误:'));
-  console.log(chalk.dim(error.message));
-  console.log();
-  console.log(chalk.blue('💡 建议:'));
-  console.log(chalk.dim('   • 重启终端重试'));
-  console.log(chalk.dim('   • 检查网络连接'));
-  console.log(chalk.dim('   • 联系技术支持'));
-  console.log();
-  process.exit(1);
-});
+    program.parse();
 
-process.on('unhandledRejection', (error) => {
-  console.log();
-  console.log(chalk.red('💥 程序发生未处理的异步错误:'));
-  console.log(chalk.dim(error.message));
-  console.log();
-  process.exit(1);
-});
+  } catch (error) {
+    console.error('启动失败:', error.message);
+    process.exit(1);
+  }
+}
 
-program.parse();
+// 启动程序
+main();

package/lib/utils.js

@@ -1,58 +1,155 @@
-// lib/utils.js - 优化版本
+// lib/utils.js - 增强版本
 import fs from 'fs-extra';
 import path from 'path';
-import { execSync } from 'child_process';
 import chalk from 'chalk';
+import { execSync } from 'child_process';
+import fetch from 'node-fetch';
+
+/**
+ * 检测当前使用的包管理器
+ */
+export function detectPackageManager() {
+  try {
+    // 检查各种包管理器的可用性
+    const managers = [];
+    
+    // 检查 bun
+    try {
+      execSync('bun --version', { stdio: 'ignore' });
+      managers.push('bun');
+    } catch {}
+    
+    // 检查 pnpm
+    try {
+      execSync('pnpm --version', { stdio: 'ignore' });
+      managers.push('pnpm');
+    } catch {}
+    
+    // 检查 yarn
+    try {
+      execSync('yarn --version', { stdio: 'ignore' });
+      managers.push('yarn');
+    } catch {}
+    
+    // npm 通常总是可用的
+    try {
+      execSync('npm --version', { stdio: 'ignore' });
+      managers.push('npm');
+    } catch {}
+    
+    return managers;
+  } catch (error) {
+    return ['npm']; // 默认返回 npm
+  }
+}
+
+/**
+ * 获取当前CLI的安装信息
+ */
+export function getInstallationInfo() {
+  try {
+    const packagePath = process.env.npm_config_global 
+      ? path.join(process.env.npm_config_global, 'node_modules', '@agile-team', 'robot-cli')
+      : null;
+      
+    return {
+      binPath: process.argv[1],
+      packagePath,
+      nodeVersion: process.version,
+      platform: process.platform,
+      arch: process.arch
+    };
+  } catch (error) {
+    return {
+      binPath: process.argv[1],
+      packagePath: null,
+      nodeVersion: process.version,
+      platform: process.platform,
+      arch: process.arch
+    };
+  }
+}
+
+/**
+ * 诊断安装问题
+ */
+export function diagnoseInstallation() {
+  const info = getInstallationInfo();
+  const managers = detectPackageManager();
+  
+  console.log(chalk.blue('🔍 安装诊断信息:'));
+  console.log();
+  console.log(`  执行文件: ${chalk.cyan(info.binPath)}`);
+  console.log(`  Node版本: ${chalk.cyan(info.nodeVersion)}`);
+  console.log(`  系统平台: ${chalk.cyan(info.platform)} (${info.arch})`);
+  console.log(`  可用包管理器: ${chalk.cyan(managers.join(', '))}`);
+  
+  if (info.packagePath) {
+    console.log(`  包路径: ${chalk.cyan(info.packagePath)}`);
+  }
+  
+  console.log();
+  console.log(chalk.blue('💡 推荐的安装方式:'));
+  
+  if (managers.includes('bun')) {
+    console.log(chalk.green('  bun install -g @agile-team/robot-cli'));
+  }
+  if (managers.includes('pnpm')) {
+    console.log(chalk.green('  pnpm install -g @agile-team/robot-cli'));
+  }
+  if (managers.includes('yarn')) {
+    console.log(chalk.green('  yarn global add @agile-team/robot-cli'));
+  }
+  if (managers.includes('npm')) {
+    console.log(chalk.green('  npm install -g @agile-team/robot-cli'));
+  }
+  
+  console.log();
+  console.log(chalk.yellow('⚠️  建议只使用一种包管理器来避免冲突'));
+}
 
 /**
  * 验证项目名称
  */
 export function validateProjectName(name) {
   const errors = [];
-  
-  // 检查是否为空
-  if (!name || !name.trim()) {
+
+  if (!name || typeof name !== 'string') {
     errors.push('项目名称不能为空');
     return { valid: false, errors };
   }
-  
+
   const trimmedName = name.trim();
-  
-  // 检查长度
-  if (trimmedName.length < 1) {
+
+  if (trimmedName.length === 0) {
     errors.push('项目名称不能为空');
   }
-  
+
   if (trimmedName.length > 214) {
-    errors.push('项目名称过长 (最大214个字符)');
+    errors.push('项目名称不能超过214个字符');
   }
-  
-  // 检查字符规则
-  if (!/^[a-z0-9\-_@.]+$/i.test(trimmedName)) {
-    errors.push('项目名称只能包含字母、数字、连字符、下划线、@和点');
+
+  if (trimmedName.toLowerCase() !== trimmedName) {
+    errors.push('项目名称只能包含小写字母');
   }
-  
-  // 检查开头字符
+
   if (/^[._]/.test(trimmedName)) {
-    errors.push('项目名称不能以点或下划线开头');
+    errors.push('项目名称不能以 "." 或 "_" 开头');
   }
-  
-  // 检查是否包含空格
-  if (/\s/.test(trimmedName)) {
-    errors.push('项目名称不能包含空格');
+
+  if (!/^[a-z0-9._-]+$/.test(trimmedName)) {
+    errors.push('项目名称只能包含字母、数字、点、下划线和短横线');
   }
-  
-  // 检查保留字
+
   const reservedNames = [
-    'node_modules', 'favicon.ico', 'con', 'prn', 'aux', 'nul',
-    'com1', 'com2', 'com3', 'com4', 'com5', 'com6', 'com7', 'com8', 'com9',
-    'lpt1', 'lpt2', 'lpt3', 'lpt4', 'lpt5', 'lpt6', 'lpt7', 'lpt8', 'lpt9'
+    'node_modules', 'favicon.ico', '.git', '.env', 'package.json',
+    'npm', 'yarn', 'pnpm', 'bun', 'robot'
   ];
-  
-  if (reservedNames.includes(trimmedName.toLowerCase())) {
-    errors.push(`"${trimmedName}" 是保留字，不能作为项目名称`);
+
+  if (reservedNames.includes(trimmedName)) {
+    errors.push(`"${trimmedName}" 是保留名称，请使用其他名称`);
   }
-  
+
   return {
     valid: errors.length === 0,
     errors
@@ -63,208 +160,79 @@ export function validateProjectName(name) {
  * 复制模板文件
  */
 export async function copyTemplate(sourcePath, targetPath) {
-  try {
-    // 确保目标目录存在
-    await fs.ensureDir(targetPath);
-    
-    // 获取源目录中的所有文件和文件夹
-    const items = await fs.readdir(sourcePath);
-    
-    for (const item of items) {
-      const sourceItemPath = path.join(sourcePath, item);
-      const targetItemPath = path.join(targetPath, item);
-      
-      // 跳过不需要的文件
-      if (shouldSkipFile(item)) {
-        continue;
-      }
-      
-      const stats = await fs.stat(sourceItemPath);
-      
-      if (stats.isDirectory()) {
-        // 递归复制目录
-        await copyTemplate(sourceItemPath, targetItemPath);
-      } else {
-        // 复制文件
-        await fs.copy(sourceItemPath, targetItemPath);
-      }
-    }
-  } catch (error) {
-    throw new Error(`复制模板文件失败: ${error.message}`);
+  if (!fs.existsSync(sourcePath)) {
+    throw new Error(`源路径不存在: ${sourcePath}`);
   }
-}
 
-/**
- * 判断是否应该跳过文件/目录
- */
-function shouldSkipFile(fileName) {
-  const skipPatterns = [
-    '.git',
-    '.DS_Store',
-    'Thumbs.db',
-    '.vscode',
-    '.idea',
-    'node_modules',
-    '.cache',
-    'dist',
-    'build',
-    '*.log',
-    '.env.local',
-    '.env.*.local'
-  ];
-  
-  return skipPatterns.some(pattern => {
-    if (pattern.includes('*')) {
-      // 简单的通配符匹配
-      const regex = new RegExp(pattern.replace(/\*/g, '.*'));
-      return regex.test(fileName);
+  await fs.ensureDir(targetPath);
+  await fs.copy(sourcePath, targetPath, {
+    filter: (src) => {
+      const basename = path.basename(src);
+      // 排除不需要的文件
+      return ![
+        '.git',
+        'node_modules',
+        '.DS_Store',
+        'Thumbs.db',
+        '.vscode',
+        '.idea'
+      ].includes(basename);
     }
-    return fileName === pattern;
   });
 }
 
 /**
- * 安装项目依赖
+ * 安装依赖
  */
-export async function installDependencies(projectPath, spinner, packageManager) {
+export async function installDependencies(projectPath, spinner, packageManager = 'npm') {
   const originalCwd = process.cwd();
-  
+
   try {
     process.chdir(projectPath);
-    
-    // 如果没有指定包管理器，自动检测（优先bun和pnpm）
-    const pm = packageManager || detectPackageManager(projectPath);
-    
-    if (spinner) {
-      spinner.text = `使用 ${pm} 安装依赖...`;
-    }
-    
-    // 安装依赖
-    const installCommand = getInstallCommand(pm);
-    
-    execSync(installCommand, {
-      stdio: 'pipe', // 不显示安装输出
-      timeout: 300000 // 5分钟超时
-    });
-    
-  } catch (error) {
-    throw new Error(`安装依赖失败: ${error.message}`);
-  } finally {
-    process.chdir(originalCwd);
-  }
-}
 
-/**
- * 检测包管理器 - 优先推荐bun和pnpm
- */
-function detectPackageManager(projectPath) {
-  // 1. 检查项目中是否有锁文件
-  if (fs.existsSync(path.join(projectPath, 'bun.lockb'))) {
-    return 'bun';
-  }
-  
-  if (fs.existsSync(path.join(projectPath, 'pnpm-lock.yaml'))) {
-    return 'pnpm';
-  }
-  
-  // 2. 检查全局是否安装了bun（最优先）
-  try {
-    execSync('bun --version', { stdio: 'ignore' });
-    return 'bun';
-  } catch {
-    // bun 不可用
-  }
-  
-  // 3. 检查全局是否安装了pnpm（次优先）
-  try {
-    execSync('pnpm --version', { stdio: 'ignore' });
-    return 'pnpm';
-  } catch {
-    // pnpm 不可用
-  }
-  
-  // 4. 检查yarn（兼容性）
-  if (fs.existsSync(path.join(projectPath, 'yarn.lock'))) {
-    return 'yarn';
-  }
-  
-  try {
-    execSync('yarn --version', { stdio: 'ignore' });
-    return 'yarn';
-  } catch {
-    // yarn 不可用
-  }
-  
-  // 5. 默认使用npm（最后选择）
-  return 'npm';
-}
+    // 检查 package.json 是否存在
+    const packageJsonPath = path.join(projectPath, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+      if (spinner) {
+        spinner.text = '⚠️  跳过依赖安装 (无 package.json)';
+      }
+      return;
+    }
 
-/**
- * 获取安装命令
- */
-function getInstallCommand(packageManager) {
-  const commands = {
-    bun: 'bun install',
-    pnpm: 'pnpm install',
-    yarn: 'yarn install',
-    npm: 'npm install'
-  };
-  
-  return commands[packageManager] || commands.npm;
-}
+    // 根据包管理器选择安装命令
+    const installCommands = {
+      bun: 'bun install',
+      pnpm: 'pnpm install',
+      yarn: 'yarn install',
+      npm: 'npm install'
+    };
 
-/**
- * 检查命令是否存在
- */
-export function commandExists(command) {
-  try {
-    execSync(`${command} --version`, { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
+    const command = installCommands[packageManager] || 'npm install';
 
-/**
- * 格式化文件大小
- */
-export function formatFileSize(bytes) {
-  if (bytes === 0) return '0 B';
-  
-  const k = 1024;
-  const sizes = ['B', 'KB', 'MB', 'GB'];
-  const i = Math.floor(Math.log(bytes) / Math.log(k));
-  
-  return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
-}
+    if (spinner) {
+      spinner.text = `📦 使用 ${packageManager} 安装依赖...`;
+    }
 
-/**
- * 获取文件夹大小
- */
-export async function getFolderSize(folderPath) {
-  let size = 0;
+    execSync(command, { 
+      stdio: 'ignore',
+      timeout: 300000 // 5分钟超时
+    });
 
-  async function calculateSize(currentPath) {
-    try {
-      const items = await fs.readdir(currentPath);
-      
-      for (const item of items) {
-        const itemPath = path.join(currentPath, item);
-        const stats = await fs.stat(itemPath);
-        
-        if (stats.isDirectory()) {
-          await calculateSize(itemPath);
-        } else {
-          size += stats.size;
-        }
-      }
-    } catch (error) {
-      // 忽略权限错误等
+  } catch (error) {
+    if (spinner) {
+      spinner.text = `⚠️  依赖安装失败，请手动安装`;
     }
+    console.log();
+    console.log(chalk.yellow('⚠️  自动安装依赖失败'));
+    console.log(chalk.dim(`   错误: ${error.message}`));
+    console.log();
+    console.log(chalk.blue('💡 请手动安装:'));
+    console.log(chalk.cyan(`   cd ${path.basename(projectPath)}`));
+    console.log(chalk.cyan(`   ${packageManager} install`));
+    console.log();
+  } finally {
+    process.chdir(originalCwd);
   }
-
-  await calculateSize(folderPath);
-  return size;
 }
 
 /**
@@ -272,19 +240,27 @@ export async function getFolderSize(folderPath) {
  */
 export async function checkNetworkConnection() {
   try {
-    const { default: fetch } = await import('node-fetch');
-    const response = await fetch('https://github.com', {
+    const response = await fetch('https://api.github.com', {
       method: 'HEAD',
       timeout: 5000
     });
     return response.ok;
-  } catch {
-    return false;
+  } catch (error) {
+    // 尝试备用检查
+    try {
+      const response = await fetch('https://www.npmjs.com', {
+        method: 'HEAD',
+        timeout: 5000
+      });
+      return response.ok;
+    } catch (backupError) {
+      return false;
+    }
   }
 }
 
 /**
- * 生成项目统计信息
+ * 生成项目统计
  */
 export async function generateProjectStats(projectPath) {
   try {
@@ -292,35 +268,35 @@ export async function generateProjectStats(projectPath) {
       files: 0,
       directories: 0,
       size: 0,
-      types: {}
+      fileTypes: {}
     };
 
-    async function analyze(currentPath) {
-      const items = await fs.readdir(currentPath);
-      
+    async function walkDir(dirPath) {
+      const items = await fs.readdir(dirPath);
+
       for (const item of items) {
-        if (shouldSkipFile(item)) continue;
-        
-        const itemPath = path.join(currentPath, item);
-        const itemStats = await fs.stat(itemPath);
-        
-        if (itemStats.isDirectory()) {
-          stats.directories++;
-          await analyze(itemPath);
+        const itemPath = path.join(dirPath, item);
+        const stat = await fs.stat(itemPath);
+
+        if (stat.isDirectory()) {
+          // 跳过 node_modules 等目录
+          if (!['node_modules', '.git', '.DS_Store'].includes(item)) {
+            stats.directories++;
+            await walkDir(itemPath);
+          }
         } else {
           stats.files++;
-          stats.size += itemStats.size;
-          
-          // 统计文件类型
+          stats.size += stat.size;
+
           const ext = path.extname(item).toLowerCase();
           if (ext) {
-            stats.types[ext] = (stats.types[ext] || 0) + 1;
+            stats.fileTypes[ext] = (stats.fileTypes[ext] || 0) + 1;
           }
         }
       }
     }
 
-    await analyze(projectPath);
+    await walkDir(projectPath);
     return stats;
   } catch (error) {
     return null;
@@ -328,17 +304,37 @@ export async function generateProjectStats(projectPath) {
 }
 
 /**
- * 美化打印项目统计
+ * 打印项目统计
  */
 export function printProjectStats(stats) {
   if (!stats) return;
-  
+
   console.log(chalk.blue('📊 项目统计:'));
-  console.log(`   文件数量: ${chalk.cyan(stats.files)}`);
-  console.log(`   目录数量: ${chalk.cyan(stats.directories)}`);
-  console.log(`   总大小: ${chalk.cyan(formatFileSize(stats.size))}`);
-  
-  if (Object.keys(stats.types).length > 0) {
-    console.log(`   文件类型: ${chalk.cyan(Object.keys(stats.types).join(', '))}`);
+  console.log(`   文件数量: ${chalk.cyan(stats.files)} 个`);
+  console.log(`   目录数量: ${chalk.cyan(stats.directories)} 个`);
+  console.log(`   项目大小: ${chalk.cyan(formatBytes(stats.size))}`);
+
+  const topTypes = Object.entries(stats.fileTypes)
+    .sort(([,a], [,b]) => b - a)
+    .slice(0, 5);
+
+  if (topTypes.length > 0) {
+    console.log('   主要文件类型:');
+    topTypes.forEach(([ext, count]) => {
+      console.log(`     ${ext}: ${chalk.cyan(count)} 个`);
+    });
   }
+}
+
+/**
+ * 格式化字节大小
+ */
+function formatBytes(bytes) {
+  if (bytes === 0) return '0 B';
+
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB', 'GB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agile-team/robot-cli",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "🤖 现代化项目脚手架工具，支持多技术栈快速创建项目",
   "type": "module",
   "bin": {