flu-cli 2.0.3 → 2.0.4

package/lib/templates/templateManager.js

@@ -1,191 +1,48 @@
 /**
- * 模板管理器
- * 负责克隆、更新和管理模板缓存
+ * 模板管理器 - 桥接至 @flu-cli/core
  */
+import { TemplateManager } from '@flu-cli/core';
 
-import simpleGit from 'simple-git';
-import { join, dirname } from 'path';
-import { existsSync, mkdirSync } from 'fs';
-import { homedir } from 'os';
-import { fileURLToPath } from 'url';
-import fsExtra from 'fs-extra';
-import { logger } from '../utils/logger.js';
-import { getConfig } from '../../config/dev.config.js';
-
-const { copySync, emptyDirSync } = fsExtra;
-
-// 获取当前文件所在目录
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-// 模板缓存目录
-const CACHE_DIR = join(homedir(), '.flu-cli', 'templates');
-
-// 本地模板目录（用于开发测试）
-const LOCAL_TEMPLATES_DIR = join(__dirname, '..', '..', 'templates');
-
-/**
- * 确保缓存目录存在
- */
-function ensureCacheDir () {
-  if (!existsSync(CACHE_DIR)) {
-    mkdirSync(CACHE_DIR, { recursive: true });
-  }
-}
+const templateManager = TemplateManager.getInstance();
 
 /**
  * 获取模板缓存路径
  */
 export function getTemplateCachePath (templateName) {
-  return join(CACHE_DIR, templateName);
+  // 保持向前兼容，虽然 core 现在内部管理缓存路径
+  return templateManager.getTemplatePath(templateName);
 }
 
 /**
  * 克隆或更新模板
- * @param {string} templateName - 模板名称
- * @param {string} repoUrl - Git 仓库地址（可选，本地模板不需要）
- * @param {string} branch - 分支名称
- * @param {boolean} forceUpdate - 是否强制更新
- * @param {boolean} isLocal - 是否为本地模板
- * @param {string} sourceLocalPath - 自定义本地模板路径
- * @returns {Promise<string>} 模板路径
  */
 export async function cloneOrUpdateTemplate (templateName, repoUrl, branch = 'main', forceUpdate = false, isLocal = false, sourceLocalPath = null) {
-  try {
-    ensureCacheDir();
-
-    const templatePath = getTemplateCachePath(templateName);
-    const localTemplatePath = sourceLocalPath || join(LOCAL_TEMPLATES_DIR, templateName);
-
-    // 优先级判断：
-    // 1. 如果明确指定 isLocal=false 且有 repoUrl，使用远程
-    // 2. 如果本地模板存在且 isLocal=true，使用本地
-    // 3. 如果本地模板不存在但有 repoUrl，使用远程
-    // 4. 否则报错
-
-    const shouldUseLocal = isLocal && existsSync(localTemplatePath);
-    const shouldUseRemote = repoUrl && (!isLocal || !existsSync(localTemplatePath));
-
-    // 使用本地模板
-    if (shouldUseLocal) {
-      logger.info(`使用本地模板: ${templateName}`);
-
-      // 如果缓存不存在或需要强制更新，复制本地模板到缓存
-      if (!existsSync(templatePath) || forceUpdate) {
-        if (existsSync(templatePath)) {
-          emptyDirSync(templatePath);
-        }
-        copySync(localTemplatePath, templatePath, { overwrite: true });
-      } else {
-        logger.info(`使用缓存的本地模板`);
-      }
-
-      return templatePath;
-    }
-
-    // 使用远程 Git 模板
-    if (shouldUseRemote) {
-      logger.info(`使用远程模板: ${templateName}`);
-
-      const git = simpleGit();
+  // 如果是本地模板，我们需要在 core 的配置中确保一致性，或者直接处理
+  // 实际上 v2 的 cloneOrUpdateTemplate 承担了“查找并准备”的职责
+  // 我们直接调用 core 的 prepareTemplate
 
-      // 如果模板已存在
-      if (existsSync(templatePath)) {
-        if (forceUpdate) {
-          const templateGit = simpleGit(templatePath);
-          await templateGit.fetch();
-          await templateGit.reset(['--hard', `origin/${branch}`]);
-          await templateGit.clean('f', ['-d', '-x']);
-        } else {
-          logger.info(`使用缓存的远程模板`);
-        }
-
-        return templatePath;
-      }
-
-      // 克隆新模板
-      logger.info(`从 Gitee 克隆模板 ${templateName}...`);
-      try {
-        await git.clone(repoUrl, templatePath, ['--branch', branch, '--single-branch', '--depth', '1']);
-        logger.success(`模板 ${templateName} 克隆成功`);
-      } catch (cloneError) {
-        logger.error(`克隆模板失败: ${cloneError.message}`);
-        logger.warn('可能的原因：');
-        logger.warn('  1. 网络连接问题');
-        logger.warn('  2. 仓库不存在或无访问权限');
-        logger.warn('  3. Git 未安装或配置错误');
-        logger.info('提示：可以使用 --remote 选项尝试从远程下载');
-        return null;
-      }
-
-      return templatePath;
-    }
-
-    // 无法获取模板
-    logger.error(`无法获取模板 ${templateName}: 本地模板不存在且未提供远程仓库地址`);
-    return null;
-
-  } catch (error) {
-    logger.error(`模板操作失败: ${error.message}`);
-    return null;
-  }
+  // NOTE: v2 这里的参数逻辑与 core 的 TemplateManager 略有不同
+  // v2 会根据 templateName 去查找模板
+  return await templateManager.prepareTemplate(templateName, undefined, forceUpdate);
 }
 
 /**
  * 检查模板是否有更新
  */
 export async function checkTemplateUpdate (templateName) {
-  try {
-    const templatePath = getTemplateCachePath(templateName);
-
-    if (!existsSync(templatePath)) {
-      return { hasUpdate: false, message: '模板未缓存' };
-    }
-
-    const git = simpleGit(templatePath);
-
-    // 获取本地和远程的最新提交
-    await git.fetch();
-    const status = await git.status();
-
-    if (status.behind > 0) {
-      return {
-        hasUpdate: true,
-        message: `有 ${status.behind} 个新提交`,
-        behind: status.behind
-      };
-    }
-
-    return { hasUpdate: false, message: '已是最新版本' };
-
-  } catch (error) {
-    logger.error(`检查更新失败: ${error.message}`);
-    return { hasUpdate: false, message: '检查失败' };
-  }
+  return await templateManager.checkUpdate(templateName);
 }
 
 /**
  * 获取模板信息
  */
 export async function getTemplateInfo (templateName) {
-  try {
-    const templatePath = getTemplateCachePath(templateName);
-
-    if (!existsSync(templatePath)) {
-      return null;
-    }
-
-    const git = simpleGit(templatePath);
-    const log = await git.log({ maxCount: 1 });
-
-    return {
-      path: templatePath,
-      lastCommit: log.latest,
-      exists: true
-    };
-
-  } catch (error) {
-    logger.error(`获取模板信息失败: ${error.message}`);
-    return null;
-  }
+  // v2 原本返回 path, lastCommit, exists
+  // core 的 TemplateManager 目前没提供完整的 getTemplateInfo，但我们可以简单封装
+  const path = templateManager.getTemplatePath(templateName);
+  const exists = !!path; // 简化处理
+  return {
+    path,
+    exists
+  };
 }

package/lib/utils/config.js

@@ -1,99 +1,61 @@
 /**
- * 配置管理 - 缓存用户设置
+ * 配置管理 - 桥接至 @flu-cli/core
  */
 
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { homedir } from 'os';
+import { ConfigManager } from '@flu-cli/core';
 
-const CONFIG_DIR = join(homedir(), '.flu-cli');
-const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const configManager = ConfigManager.getInstance();
 
 /**
- * 读取配置
+ * 读取配置 (由于 ConfigManager 内部管理，此方法仅用于向下兼容)
  */
 export function getConfig () {
-  try {
-    if (existsSync(CONFIG_FILE)) {
-      const data = readFileSync(CONFIG_FILE, 'utf8');
-      return JSON.parse(data);
-    }
-  } catch (error) {
-    // 忽略错误，返回默认配置
-  }
-  return {};
+  return configManager['config'] || {};
 }
 
 /**
  * 保存配置
  */
 export function saveConfig (config) {
-  try {
-    // 确保目录存在
-    if (!existsSync(CONFIG_DIR)) {
-      mkdirSync(CONFIG_DIR, { recursive: true });
-    }
-    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf8');
-  } catch (error) {
-    // 忽略错误
-  }
+  // ConfigManager 内部会自动保存，这里仅为兼容
 }
 
 /**
  * 获取作者名字
  */
 export function getAuthorName () {
-  const config = getConfig();
-  return config.authorName || 'Your Name';
+  return configManager.getAuthorName();
 }
 
 /**
  * 保存作者名字
  */
 export function saveAuthorName (name) {
-  const config = getConfig();
-  config.authorName = name;
-  saveConfig(config);
+  configManager.setAuthorName(name);
 }
 
 // 读取默认模板（builtin/custom）
 export function getDefaultTemplate () {
-  const config = getConfig();
-  return config.defaultTemplate || { type: 'builtin', idOrName: 'lite' };
+  return configManager.getDefaultTemplate();
 }
 
 // 保存默认模板（builtin/custom）
 export function saveDefaultTemplate (defaultTemplate) {
-  const config = getConfig();
-  config.defaultTemplate = defaultTemplate;
-  saveConfig(config);
+  configManager.setDefaultTemplate(defaultTemplate.type, defaultTemplate.idOrName);
 }
 
 // 获取自定义模板列表
 export function getCustomTemplates () {
-  const config = getConfig();
-  return Array.isArray(config.customTemplates) ? config.customTemplates : [];
+  return configManager.getTemplates();
 }
 
 // 根据 id 查找自定义模板
 export function findCustomTemplateById (id) {
-  const list = getCustomTemplates();
-  return list.find(t => t.id === id) || null;
+  return configManager.getTemplate(id) || null;
 }
 
 // 新增或更新自定义模板
 export function addOrUpdateCustomTemplate (tpl) {
-  const config = getConfig();
-  const list = Array.isArray(config.customTemplates) ? config.customTemplates : [];
-  const idx = list.findIndex(x => x.id === tpl.id);
-  if (idx >= 0) {
-    list[idx] = { ...list[idx], ...tpl };
-  } else {
-    list.push(tpl);
-  }
-  config.customTemplates = list;
-  // 顺带更新最后使用时间
-  tpl.lastUsedAt = Date.now();
-  saveConfig(config);
+  configManager.addTemplate(tpl);
   return tpl;
 }

package/lib/utils/flutterHelper.js

@@ -1,85 +1,10 @@
 /**
- * Flutter 辅助工具
- * 职责：封装 flutter create/pub get/版本检测等命令调用
+ * Flutter 辅助工具 - 桥接至 @flu-cli/core
  */
 
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import { logger } from './logger.js';
-
-const execAsync = promisify(exec);
-
-/**
- * 运行 flutter create 命令
- * @param {string} projectDir - 项目目录
- * @param {string} projectName - 项目名称
- * @param {string} packageName - 包名
- * @returns {Promise<boolean>} 是否成功
- */
-export async function runFlutterCreate (projectDir, projectName, packageName) {
-  try {
-    const command = `flutter create --project-name ${projectName} --org ${packageName} ${projectDir}`;
-
-    const { stdout, stderr } = await execAsync(command);
-
-    if (stderr && !stderr.includes('Warning')) {
-      logger.warn(stderr);
-    }
-
-    return stdout.includes('All done!') || stdout.includes('Created project');
-
-  } catch (error) {
-    logger.error(`Flutter create 失败: ${error.message}`);
-    return false;
-  }
-}
-
-/**
- * 运行 flutter pub get
- * @param {string} projectDir - 项目目录
- * @returns {Promise<boolean>} 是否成功
- */
-export async function runFlutterPubGet (projectDir) {
-  try {
-    const { stdout, stderr } = await execAsync('flutter pub get', {
-      cwd: projectDir
-    });
-
-    if (stderr) {
-      logger.warn(stderr);
-    }
-
-    return true;
-
-  } catch (error) {
-    logger.error(`Flutter pub get 失败: ${error.message}`);
-    return false;
-  }
-}
-
-/**
- * 检查 Flutter 是否安装
- * @returns {Promise<boolean>} 是否已安装
- */
-export async function checkFlutterInstalled () {
-  try {
-    await execAsync('flutter --version');
-    return true;
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * 获取 Flutter 版本
- * @returns {Promise<string|null>} Flutter 版本
- */
-export async function getFlutterVersion () {
-  try {
-    const { stdout } = await execAsync('flutter --version');
-    const match = stdout.match(/Flutter (\d+\.\d+\.\d+)/);
-    return match ? match[1] : null;
-  } catch (error) {
-    return null;
-  }
-}
+export {
+  runFlutterCreate,
+  runFlutterPubGet,
+  checkFlutterInstalled,
+  getFlutterVersion
+} from '@flu-cli/core';

package/lib/utils/i18n.js

@@ -0,0 +1,7 @@
+/**
+ * 国际化工具 - 桥接至 @flu-cli/core
+ */
+import { I18nManager, t as coreT } from '@flu-cli/core';
+
+export const i18n = I18nManager.getInstance();
+export const t = (key, params) => coreT(key, params);

package/lib/utils/templateSelectorEnquirer.js

@@ -1,15 +1,14 @@
 /**
  * 使用 Enquirer 实现实时模板预览
- * 当用户上下切换时，实时显示对应模板的结构
+ * 职责：负责 CLI 环境下的模板选择交互逻辑
+ * 该文件从 @flu-cli/core 迁移回来，以保持 core 的 Headless 纯净。
  */
 
 import enquirer from 'enquirer';
 import chalk from 'chalk';
 import { existsSync } from 'fs';
 import { basename } from 'path';
-import { getAllTemplates } from '../../config/templates.js';
-import { ConfigManager } from '@flu-cli/core';
-import { getDefaultTemplate, saveDefaultTemplate } from '../utils/config.js';
+import { BUILTIN_TEMPLATES, ConfigManager } from '@flu-cli/core';
 
 const { Select } = enquirer;
 
@@ -17,24 +16,27 @@ const { Select } = enquirer;
  * 选择模板（带实时预览 - Enquirer 版本）
  */
 export async function selectTemplateWithEnquirer () {
-  const templates = getAllTemplates();
+  const builtinTemplates = Object.values(BUILTIN_TEMPLATES);
   const configManager = ConfigManager.getInstance();
   const customTemplates = configManager.getTemplates();
-  const defaultTpl = getDefaultTemplate();
+  const defaultTpl = configManager.getDefaultTemplate();
 
   // 创建自定义的 Select prompt
   class TemplateSelect extends Select {
+    constructor(options) {
+      super(options);
+    }
+
     async render () {
-      const { submitted, size } = this.state;
+      const { size } = this.state;
       const index = this.index;
       // 选择项与模板索引可能不一致，安全获取
       const choice = this.choices[index];
       const isBuiltin = choice?.name?.startsWith('builtin:');
-      const builtinIndex = isBuiltin ? templates.findIndex(t => `builtin:${t.name.toLowerCase()}` === choice.name) : -1;
-      const template = isBuiltin && builtinIndex >= 0 ? templates[builtinIndex] : null;
+      const builtinKey = isBuiltin ? choice.name.split(':')[1] : '';
+      const template = isBuiltin ? BUILTIN_TEMPLATES[builtinKey] : null;
 
       let prompt = '';
-      let header = await this.header();
       let prefix = await this.prefix();
       let separator = await this.separator();
       let message = await this.message();
@@ -50,9 +52,9 @@ export async function selectTemplateWithEnquirer () {
       for (let i = 0; i < this.choices.length; i++) {
         const choice = this.choices[i];
         const isSelected = i === index;
-        const prefix = isSelected ? chalk.cyan('❯') : ' ';
+        const prefixStr = isSelected ? chalk.cyan('❯') : ' ';
         const style = isSelected ? chalk.cyan : chalk.gray;
-        output += `${prefix} ${style(choice.message)}\n`;
+        output += `${prefixStr} ${style(choice.message)}\n`;
         if (choice.hint) {
           output += `  ${chalk.gray(choice.hint)}\n`;
         }
@@ -63,7 +65,7 @@ export async function selectTemplateWithEnquirer () {
       if (template) {
         output += chalk.yellow('📁 项目结构预览:\n\n');
         const structureLines = template.structure.trim().split('\n');
-        structureLines.forEach(line => {
+        structureLines.forEach((line) => {
           output += chalk.gray(line) + '\n';
         });
         output += '\n';
@@ -80,38 +82,45 @@ export async function selectTemplateWithEnquirer () {
   }
 
   // 构建选择项：内置模板 + 自定义模板 + 新增自定义入口
-  const builtinChoices = templates.map(t => ({
+  const builtinChoices = builtinTemplates.map(t => ({
     name: `builtin:${t.name.toLowerCase()}`,
-    message: `${t.displayName}`
+    message: `${t.displayName}`,
   }));
   const customChoices = customTemplates.map(ct => ({
     name: `custom:${ct.id}`,
     message: `自定义：${ct.name}`,
-    hint: ct.type === 'git' ? ct.url : `本地: ${ct.path}`
+    hint: ct.type === 'git' ? ct.url : `本地: ${ct.path}`,
   }));
-  const addCustomChoice = { name: '__add_custom__', message: chalk.yellow('➕ 新增自定义模板（本地或 Git）') };
+  const addCustomChoice = {
+    name: '__add_custom__',
+    message: chalk.yellow('➕ 新增自定义模板（本地或 Git）'),
+  };
 
   const allChoices = [...builtinChoices, ...customChoices, addCustomChoice];
 
   // 计算默认选中索引
   let initialIndex = 0;
   if (defaultTpl && defaultTpl.type === 'builtin') {
-    const idx = allChoices.findIndex(c => c.name === `builtin:${defaultTpl.idOrName}`);
+    const idx = allChoices.findIndex(
+      c => c.name === `builtin:${defaultTpl.idOrName}`
+    );
     if (idx >= 0) initialIndex = idx;
   } else if (defaultTpl && defaultTpl.type === 'custom') {
-    const idx = allChoices.findIndex(c => c.name === `custom:${defaultTpl.idOrName}`);
+    const idx = allChoices.findIndex(
+      c => c.name === `custom:${defaultTpl.idOrName}`
+    );
     if (idx >= 0) initialIndex = idx;
   }
 
-  const prompt = new TemplateSelect({
+  const templatePrompt = new TemplateSelect({
     name: 'template',
     message: '选择项目模板（使用 ↑↓ 键切换，实时查看结构）',
     choices: allChoices,
-    initial: initialIndex
+    initial: initialIndex,
   });
 
   try {
-    const answer = await prompt.run();
+    const answer = await templatePrompt.run();
 
     // 清除屏幕上的大量输出，只保留简洁的确认信息
     console.clear();
@@ -124,15 +133,18 @@ export async function selectTemplateWithEnquirer () {
         message: '选择自定义模板来源',
         choices: [
           { name: 'local', message: '本地目录' },
-          { name: 'git', message: 'Git 仓库' }
-        ]
+          { name: 'git', message: 'Git 仓库' },
+        ],
       });
       const sourceType = await typePrompt.run();
 
       // 输入路径或 URL
       const inputPrompt = new enquirer.Input({
         name: 'pathOrUrl',
-        message: sourceType === 'git' ? '请输入 Git 仓库地址（如 https://... 或 git@...）' : '请输入本地模板目录绝对路径'
+        message:
+          sourceType === 'git'
+            ? '请输入 Git 仓库地址（如 https://... 或 git@...）'
+            : '请输入本地模板目录绝对路径',
       });
       const pathOrUrl = await inputPrompt.run();
 
@@ -142,7 +154,7 @@ export async function selectTemplateWithEnquirer () {
         const branchPrompt = new enquirer.Input({
           name: 'branch',
           message: '请输入分支名称（默认 main）',
-          initial: 'main'
+          initial: 'main',
         });
         branch = await branchPrompt.run();
         if (!branch) branch = 'main';
@@ -155,47 +167,62 @@ export async function selectTemplateWithEnquirer () {
       }
 
       // 生成 id 与名称
-      const nameGuess = sourceType === 'git'
-        ? (pathOrUrl.split('/').pop() || 'custom')
-        : basename(pathOrUrl);
-      const id = `${nameGuess.replace(/\W+/g, '-').toLowerCase()}-${Date.now()}`;
+      const nameGuess =
+        sourceType === 'git'
+          ? pathOrUrl.split('/').pop()?.replace('.git', '') || 'custom'
+          : basename(pathOrUrl);
+      const id = `${nameGuess
+        .replace(/\W+/g, '-')
+        .toLowerCase()}-${Date.now()}`;
 
       const newTemplate = {
         id,
         name: nameGuess,
         type: sourceType,
-        ...(sourceType === 'git' ? { url: pathOrUrl, branch } : { path: pathOrUrl })
+        ...(sourceType === 'git' ? { url: pathOrUrl, branch } : { path: pathOrUrl }),
       };
 
       configManager.addTemplate(newTemplate);
 
-      console.log(chalk.green('✓ 已保存自定义模板:'), chalk.cyan.bold(newTemplate.name));
-      saveDefaultTemplate({ type: 'custom', idOrName: newTemplate.id });
+      console.log(
+        chalk.green('✓ 已保存自定义模板:'),
+        chalk.cyan.bold(newTemplate.name)
+      );
+      configManager.setDefaultTemplate('custom', newTemplate.id);
       return { kind: 'custom', id: newTemplate.id };
     }
 
     if (answer.startsWith('builtin:')) {
       const name = answer.split(':')[1];
-      const selectedTemplate = templates.find(t => t.name.toLowerCase() === name);
-      console.log(chalk.green('✓ 已选择:'), chalk.cyan.bold(selectedTemplate.displayName));
-      saveDefaultTemplate({ type: 'builtin', idOrName: name });
+      const selectedTemplate = BUILTIN_TEMPLATES[name];
+      console.log(
+        chalk.green('✓ 已选择:'),
+        chalk.cyan.bold(selectedTemplate.displayName)
+      );
+      configManager.setDefaultTemplate('builtin', name);
       return { kind: 'builtin', name };
     }
 
     if (answer.startsWith('custom:')) {
       const id = answer.split(':')[1];
       const ct = customTemplates.find(t => t.id === id);
-      console.log(chalk.green('✓ 已选择自定义:'), chalk.cyan.bold(ct?.name || id));
-      saveDefaultTemplate({ type: 'custom', idOrName: id });
+      console.log(
+        chalk.green('✓ 已选择自定义:'),
+        chalk.cyan.bold(ct?.name || id)
+      );
+      configManager.setDefaultTemplate('custom', id);
       return { kind: 'custom', id };
     }
 
     // 兜底（保持兼容）
-    const name = answer;
-    saveDefaultTemplate({ type: 'builtin', idOrName: name });
-    const selectedTemplate = templates.find(t => t.name.toLowerCase() === name);
-    console.log(chalk.green('✓ 已选择:'), chalk.cyan.bold(selectedTemplate?.displayName || name));
-    return { kind: 'builtin', name };
+    const nameFallback = answer;
+    configManager.setDefaultTemplate('builtin', nameFallback);
+    const selectedTemplate = BUILTIN_TEMPLATES[nameFallback];
+    console.log(
+      chalk.green('✓ 已选择:'),
+      chalk.cyan.bold(selectedTemplate?.displayName || nameFallback)
+    );
+    return { kind: 'builtin', name: nameFallback };
   } catch (error) {
     console.log(chalk.yellow('\n操作已取消'));
     process.exit(0);