@agile-team/robot-cli 1.0.2

package/lib/download.js

@@ -0,0 +1,191 @@
+// lib/download.js - 修复版本
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import fetch from 'node-fetch';
+import extract from 'extract-zip';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 缓存目录
+const CACHE_DIR = path.join(os.homedir(), '.robot-cli', 'cache');
+
+/**
+ * 下载模板
+ * @param {Object} template - 模板配置
+ * @param {Object} options - 选项
+ * @returns {string} - 模板路径
+ */
+export async function downloadTemplate(template, options = {}) {
+  const { useCache = true, spinner } = options;
+  
+  // 验证模板参数
+  if (!template) {
+    throw new Error('模板参数不能为空');
+  }
+  
+  if (!template.key && !template.repo) {
+    throw new Error(`模板配置无效: ${JSON.stringify(template)}`);
+  }
+  
+  // 获取缓存键值，优先使用 key，其次使用 repo 的最后部分
+  const cacheKey = template.key || template.repo?.split('/').pop() || 'unknown-template';
+  const cachePath = path.join(CACHE_DIR, cacheKey);
+
+  // 检查缓存
+  if (useCache && fs.existsSync(cachePath)) {
+    if (spinner) {
+      spinner.text = '📂 使用缓存模板...';
+    }
+    
+    // 验证缓存完整性
+    const packageJsonPath = path.join(cachePath, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+      return cachePath;
+    } else {
+      // 缓存损坏，删除重新下载
+      if (spinner) {
+        spinner.text = '🔄 缓存损坏，重新下载...';
+      }
+      await fs.remove(cachePath);
+    }
+  }
+
+  // 如果是本地测试模板，直接返回缓存路径
+  if (template.localTest || !template.repo) {
+    if (fs.existsSync(cachePath)) {
+      return cachePath;
+    } else {
+      throw new Error([
+        '本地测试模板不存在',
+        '',
+        chalk.red.bold('问题描述:'),
+        `  测试模板路径不存在: ${cachePath}`,
+        '',
+        chalk.green.bold('解决方案:'),
+        '  1. 运行测试环境设置: npm run test:setup',
+        '  2. 或创建测试缓存: npm run test',
+        '  3. 检查模板是否正确创建',
+        '',
+        chalk.blue.bold('可用命令:'),
+        '  npm run test:setup --setup  # 创建完整测试环境',
+        '  npm run test:clean          # 清理测试环境'
+      ].join('\n'));
+    }
+  }
+
+  // 下载远程模板
+  if (spinner) {
+    spinner.text = '📥 从 ' + template.repo + ' 下载最新模板...';
+  }
+
+  try {
+    const downloadUrl = 'https://github.com/' + template.repo + '/archive/refs/heads/main.zip';
+    const tempZipPath = path.join(os.tmpdir(), cacheKey + '-' + Date.now() + '.zip');
+    const tempExtractPath = path.join(os.tmpdir(), cacheKey + '-extract-' + Date.now());
+
+    // 检查网络连接
+    if (spinner) {
+      spinner.text = '🌐 检查网络连接...';
+    }
+
+    // 下载zip文件
+    const response = await fetch(downloadUrl, {
+      timeout: 30000, // 30秒超时
+      headers: {
+        'User-Agent': 'Robot-CLI/1.0.0'
+      }
+    });
+    
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    if (spinner) {
+      spinner.text = '📦 下载中...';
+    }
+
+    const buffer = await response.buffer();
+    await fs.writeFile(tempZipPath, buffer);
+
+    if (spinner) {
+      spinner.text = '📂 解压模板文件...';
+    }
+
+    // 解压文件
+    await extract(tempZipPath, { dir: tempExtractPath });
+
+    // 找到解压后的项目目录 (通常是 reponame-main/)
+    const extractedItems = await fs.readdir(tempExtractPath);
+    const projectDir = extractedItems.find(item => 
+      item.endsWith('-main') || item.endsWith('-master')
+    );
+
+    if (!projectDir) {
+      throw new Error(`解压后找不到项目目录，可用目录: ${extractedItems.join(', ')}`);
+    }
+
+    const sourcePath = path.join(tempExtractPath, projectDir);
+
+    // 验证模板完整性
+    const packageJsonPath = path.join(sourcePath, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+      throw new Error(`模板缺少 package.json 文件`);
+    }
+
+    // 确保缓存目录存在
+    await fs.ensureDir(CACHE_DIR);
+
+    // 移动到缓存目录
+    if (fs.existsSync(cachePath)) {
+      await fs.remove(cachePath);
+    }
+    await fs.move(sourcePath, cachePath);
+
+    // 清理临时文件
+    await fs.remove(tempZipPath).catch(() => {});
+    await fs.remove(tempExtractPath).catch(() => {});
+
+    return cachePath;
+
+  } catch (error) {
+    // 清理可能的临时文件
+    try {
+      const tempFiles = await fs.readdir(os.tmpdir());
+      const robotTempFiles = tempFiles.filter(file => 
+        file.includes(cacheKey) && (file.endsWith('.zip') || file.includes('extract'))
+      );
+      
+      for (const file of robotTempFiles) {
+        await fs.remove(path.join(os.tmpdir(), file)).catch(() => {});
+      }
+    } catch (cleanupError) {
+      // 忽略清理错误
+    }
+
+    // 网络相关错误处理
+    if (error.code === 'ENOTFOUND' || error.code === 'ECONNREFUSED') {
+      throw new Error(`网络连接失败: 无法连接到 GitHub\n请检查网络连接或稍后重试`);
+    }
+
+    if (error.code === 'ETIMEDOUT' || error.type === 'request-timeout') {
+      throw new Error(`下载超时: 模板文件较大或网络较慢\n请稍后重试或使用 --no-cache 选项`);
+    }
+
+    // 重新抛出错误，保持原始错误信息
+    throw new Error(`模板下载失败: ${error.message}`);
+  }
+}
+
+/**
+ * 清除所有缓存
+ */
+export async function clearCache() {
+  if (fs.existsSync(CACHE_DIR)) {
+    await fs.remove(CACHE_DIR);
+  }
+  await fs.ensureDir(CACHE_DIR);
+}

package/lib/templates.js

@@ -0,0 +1,355 @@
+// lib/templates.js - 统一Robot命名风格
+export const TEMPLATE_CATEGORIES = {
+  frontend: {
+    name: '🎨 前端项目',
+    stacks: {
+      vue: {
+        name: 'Vue.js',
+        patterns: {
+          monolith: {
+            name: '单体应用',
+            templates: {
+              'robot-admin': {
+                name: 'Robot Admin 完整版',
+                description: '包含30+完整示例、权限管理、图表组件、最佳实践等等',
+                repo: 'ChenyCHENYU/Robot_Admin',
+                features: ['Naive UI', 'Vue Router', 'Pinia', '权限管理', '动态路由', '图表组件', '性能优化等等'],
+                version: 'full',
+                localTest: true  // 标记为测试模板
+              },
+              'robot-admin-base': {
+                name: 'Robot Admin 精简版',
+                description: '基础架构、核心功能、快速启动',
+                repo: 'ChenyCHENYU/Robot_Admin_Base',
+                features: ['Naive UI', 'Vue Router', 'Pinia', '基础布局'],
+                version: 'base',
+                localTest: true  // 标记为测试模板
+              }
+            }
+          },
+          monorepo: {
+            name: 'Monorepo 架构',
+            templates: {
+              'robot-monorepo': {
+                name: 'Robot Monorepo 完整版',
+                description: 'bun workspace + 多包管理 + 共享组件库',
+                repo: 'ChenyCHENYU/Robot_Monorepo',
+                features: ['bun workspace', 'shared components', 'build tools', 'CI/CD'],
+                version: 'full'
+              },
+              'robot-monorepo-base': {
+                name: 'Robot Monorepo 精简版',
+                description: '基础 monorepo 结构 + 核心配置',
+                repo: 'ChenyCHENYU/Robot_Monorepo_Base',
+                features: ['bun workspace', 'basic structure'],
+                version: 'base'
+              }
+            }
+          },
+          microfrontend: {
+            name: '微前端架构',
+            templates: {
+              'robot-micro': {
+                name: 'Robot微前端 完整版',
+                description: 'MicroApp + Vite插件模块联邦 + 多应用示例',
+                repo: 'ChenyCHENYU/Robot_Micro',
+                features: ['MicroApp', 'Vite模块联邦', '多应用', '路由共享'],
+                version: 'full'
+              },
+              'robot-micro-base': {
+                name: 'Robot微前端 精简版',
+                description: '基础 MicroApp 架构 + 主子应用',
+                repo: 'ChenyCHENYU/Robot_Micro_Base',
+                features: ['MicroApp', '基础配置'],
+                version: 'base'
+              }
+            }
+          }
+        }
+      },
+      react: {
+        name: 'React.js',
+        patterns: {
+          monolith: {
+            name: '单体应用',
+            templates: {
+              'robot-react': {
+                name: 'Robot React 完整版',
+                description: 'Ant Design + 完整功能演示',
+                repo: 'ChenyCHENYU/Robot_React',
+                features: ['Ant Design', 'React Router', 'Redux Toolkit'],
+                version: 'full'
+              },
+              'robot-react-base': {
+                name: 'Robot React 精简版',
+                description: '基础React + 核心功能',
+                repo: 'ChenyCHENYU/Robot_React_Base',
+                features: ['React', 'React Router', '基础组件'],
+                version: 'base'
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  mobile: {
+    name: '📱 移动端项目',
+    stacks: {
+      uniapp: {
+        name: 'uni-app',
+        patterns: {
+          multiplatform: {
+            name: '多端应用',
+            templates: {
+              'robot-uniapp': {
+                name: 'Robot uni-app 完整版',
+                description: '多端适配 + 插件市场 + 完整示例',
+                repo: 'ChenyCHENYU/Robot_Uniapp',
+                features: ['多端发布', 'uView UI', '插件集成'],
+                version: 'full'
+              },
+              'robot-uniapp-base': {
+                name: 'Robot uni-app 精简版',
+                description: '基础框架 + 核心功能',
+                repo: 'ChenyCHENYU/Robot_Uniapp_Base',
+                features: ['基础框架', '路由配置'],
+                version: 'base'
+              }
+            }
+          }
+        }
+      },
+      tarao: {
+        name: 'Tarao',
+        patterns: {
+          native: {
+            name: '原生应用',
+            templates: {
+              'robot-tarao': {
+                name: 'Robot Tarao 完整版',
+                description: '原生性能 + 跨平台 + 完整功能（暂无，后续完善）',
+                repo: 'ChenyCHENYU/Robot_Tarao',
+                features: ['原生性能', '跨平台', '完整功能'],
+                version: 'full',
+                status: 'coming-soon'
+              },
+              'robot-tarao-base': {
+                name: 'Robot Tarao 精简版',
+                description: '基础 Tarao 框架(暂无，后续完善)',
+                repo: 'ChenyCHENYU/Robot_Tarao_Base',
+                features: ['基础框架', '核心功能'],
+                version: 'base',
+                status: 'coming-soon'
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  backend: {
+    name: '🚀 后端项目',
+    stacks: {
+      nestjs: {
+        name: 'NestJS',
+        patterns: {
+          api: {
+            name: 'API服务',
+            templates: {
+              'robot-nest': {
+                name: 'Robot NestJS 完整版',
+                description: 'NestJS + TypeORM + JWT + Swagger + Redis + 完整生态',
+                repo: 'ChenyCHENYU/Robot_Nest',
+                features: ['NestJS', 'TypeORM', 'JWT认证', 'ApiFox文档', 'Redis', '微服务'],
+                version: 'full'
+              },
+              'robot-nest-base': {
+                name: 'Robot NestJS 精简版',
+                description: '基础 NestJS + 核心模块',
+                repo: 'ChenyCHENYU/Robot_Nest_Base',
+                features: ['NestJS', '基础路由', '错误处理'],
+                version: 'base'
+              }
+            }
+          },
+          microservice: {
+            name: '微服务架构',
+            templates: {
+              'robot-nest-micro': {
+                name: 'Robot NestJS微服务版',
+                description: 'NestJS + 微服务架构 + gRPC + 服务发现',
+                repo: 'ChenyCHENYU/Robot_Nest_Micro',
+                features: ['NestJS', '微服务', 'gRPC', 'Redis', '服务发现'],
+                version: 'micro'
+              }
+            }
+          }
+        }
+      },
+      koa: {
+        name: 'Koa3',
+        patterns: {
+          api: {
+            name: 'API服务',
+            templates: {
+              'robot-koa': {
+                name: 'Robot Koa3 完整版',
+                description: 'Koa3 + TypeScript + JWT + 数据库 + 中间件',
+                repo: 'ChenyCHENYU/Robot_Koa',
+                features: ['Koa3', 'TypeScript', 'JWT认证', 'MySQL', '中间件'],
+                version: 'full'
+              },
+              'robot-koa-base': {
+                name: 'Robot Koa3 精简版',
+                description: '基础Koa3 + 核心中间件',
+                repo: 'ChenyCHENYU/Robot_Koa_Base',
+                features: ['Koa3', '基础路由', '错误处理'],
+                version: 'base'
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  desktop: {
+    name: '💻 桌面端项目',
+    stacks: {
+      electron: {
+        name: 'Electron',
+        patterns: {
+          desktop: {
+            name: '桌面应用',
+            templates: {
+              'robot-electron': {
+                name: 'Robot Electron 完整版',
+                description: 'Vue3 + Electron + 自动更新 + 原生能力',
+                repo: 'ChenyCHENYU/Robot_Electron',
+                features: ['Vue3', 'Electron', '自动更新', '原生API'],
+                version: 'full'
+              },
+              'robot-electron-base': {
+                name: 'Robot Electron 精简版',
+                description: '基础Electron + Vue框架',
+                repo: 'ChenyCHENYU/Robot_Electron_Base',
+                features: ['Vue3', 'Electron', '基础功能'],
+                version: 'base'
+              }
+            }
+          }
+        }
+      },
+      tauri: {
+        name: 'Tauri',
+        patterns: {
+          desktop: {
+            name: '桌面应用',
+            templates: {
+              'robot-tauri': {
+                name: 'Robot Tauri 完整版',
+                description: 'Rust后端 + Vue前端 + 原生性能',
+                repo: 'ChenyCHENYU/Robot_Tauri',
+                features: ['Tauri', 'Vue3', 'Rust backend', '原生性能'],
+                version: 'full'
+              },
+              'robot-tauri-base': {
+                name: 'Robot Tauri 精简版',
+                description: '基础Tauri + Vue框架',
+                repo: 'ChenyCHENYU/Robot_Tauri_Base',
+                features: ['Tauri', 'Vue3', '基础功能'],
+                version: 'base'
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+};
+
+/**
+ * 获取所有模板的扁平化列表
+ */
+export function getAllTemplates() {
+  const templates = {};
+  
+  Object.values(TEMPLATE_CATEGORIES).forEach(category => {
+    Object.values(category.stacks).forEach(stack => {
+      Object.values(stack.patterns).forEach(pattern => {
+        Object.assign(templates, pattern.templates);
+      });
+    });
+  });
+  
+  return templates;
+}
+
+/**
+ * 根据分类获取模板
+ */
+export function getTemplatesByCategory(categoryKey, stackKey, patternKey) {
+  const category = TEMPLATE_CATEGORIES[categoryKey];
+  if (!category) return {};
+  
+  const stack = category.stacks[stackKey];
+  if (!stack) return {};
+  
+  const pattern = stack.patterns[patternKey];
+  if (!pattern) return {};
+  
+  return pattern.templates;
+}
+
+/**
+ * 搜索模板
+ */
+export function searchTemplates(keyword) {
+  const allTemplates = getAllTemplates();
+  const results = {};
+  
+  Object.entries(allTemplates).forEach(([key, template]) => {
+    const searchText = `${template.name} ${template.description} ${template.features.join(' ')}`.toLowerCase();
+    if (searchText.includes(keyword.toLowerCase())) {
+      results[key] = template;
+    }
+  });
+  
+  return results;
+}
+
+/**
+ * 获取推荐模板（基于使用频率或团队偏好）- 统一Robot命名
+ */
+export function getRecommendedTemplates() {
+  const allTemplates = getAllTemplates();
+  const recommended = {};
+  
+  // 使用统一的Robot命名风格
+  const recommendedKeys = [
+    'robot-admin',       // Vue后台管理 - 最常用
+    'robot-uniapp',      // 移动端开发 - 跨平台
+    'robot-nest',        // 后端API - 企业级
+    'robot-electron',    // 桌面应用 - 全栈
+    'robot-react',       // React项目 - 前端选择
+    'robot-koa'          // 轻量后端 - 快速开发
+  ];
+  
+  recommendedKeys.forEach(key => {
+    if (allTemplates[key]) {
+      recommended[key] = allTemplates[key];
+    }
+  });
+  
+  // 如果没有找到足够的推荐模板，补充一些
+  if (Object.keys(recommended).length < 4) {
+    const availableKeys = Object.keys(allTemplates);
+    for (const key of availableKeys) {
+      if (!recommended[key] && Object.keys(recommended).length < 6) {
+        recommended[key] = allTemplates[key];
+      }
+    }
+  }
+  
+  return recommended;
+}