@htyf-mp/cli 0.2.0-beta.1 → 0.2.2

package/src/index.mjs

@@ -1,677 +1,101 @@
 #!/usr/bin/env node
 
 /**
- * React Native 应用 CLI 工具
- * 用于管理多应用项目的开发、构建和部署
+ * 红糖云服应用 CLI 工具主入口
+ * 
+ * 功能：
+ * - 初始化新小程序项目
+ * - 小程序打包构建
+ * - 小程序真机调试
+ * - 清理临时文件
+ * 
+ * 支持项目类型：
+ * - 普通小程序项目（使用 webpack 构建）
+ * - Godot 游戏项目（使用 Godot 导出工具）
  *
  * @author CLI Team
- * @version 2.0.0
+ * @version 2.2.0
+ * @module index
  */
 
 import inquirer from 'inquirer';
-import shell from 'shelljs';
-import fs from 'fs';
-import { fileURLToPath } from 'node:url';
 import path from 'path';
 import lodash from 'lodash';
 import fse from 'fs-extra';
-import superstatic from 'superstatic';
-import AdmZip from 'adm-zip';
-import QRCode from 'qrcode';
-import portfinder from 'portfinder';
-import si from 'systeminformation';
 import chalk from 'chalk';
-import ora from 'ora';
 import boxen from 'boxen';
 import gradient from 'gradient-string';
-
-// 获取当前文件的绝对路径和目录
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-const projectPath = path.resolve(__dirname, '../../../../');
-
-// 常量定义
-const CONSTANTS = {
-  SRC_DIR: '../src',
-  TEMP_DIR: './.temp',
-  MP_OUTPUT_DIR: './.mp-output',
-  LOGS_DIR: './.logs',
-  DEFAULT_VERSION_NAME: '1.0.0',
-  DEFAULT_VERSION_CODE: '1',
-  VERSION_NAME_REGEX: /^\d+(\.\d+){2}$/g,
-  VERSION_CODE_REGEX: /^\d+$/g,
-  WEBPACK_PORT: 8081,
-  BUNDLE_ENTRY_FILE: 'index.js',
-  BUNDLE_PLATFORM: 'ios',
-  MAX_RETRY_COUNT: 3,
-  DEFAULT_TIMEOUT: 30000
-};
-
-// 操作类型枚举
-const ACTION_TYPES = {
-  START: 'start',
-  MP_BUILD: 'mp-build',
-  MP_DEBUG: 'mp-debug',
-  CLEAN: 'clean',
-  QUIT: 'quit'
-};
-
-// 日志级别枚举
-const LOG_LEVELS = {
-  DEBUG: 0,
-  INFO: 1,
-  WARN: 2,
-  ERROR: 3
-};
-
-// 当前日志级别
-let currentLogLevel = LOG_LEVELS.INFO;
-
-/**
- * 日志工具类
- */
-class Logger {
-  static debug(message, ...args) {
-    if (currentLogLevel <= LOG_LEVELS.DEBUG) {
-      console.log(chalk.gray(`[DEBUG] ${message}`), ...args);
-    }
-  }
-
-  static info(message, ...args) {
-    if (currentLogLevel <= LOG_LEVELS.INFO) {
-      console.log(chalk.blue(`[INFO] ${message}`), ...args);
-    }
-  }
-
-  static warn(message, ...args) {
-    if (currentLogLevel <= LOG_LEVELS.WARN) {
-      console.log(chalk.yellow(`[WARN] ${message}`), ...args);
-    }
-  }
-
-  static error(message, ...args) {
-    if (currentLogLevel <= LOG_LEVELS.ERROR) {
-      console.log(chalk.red(`[ERROR] ${message}`), ...args);
-    }
-  }
-
-  static success(message, ...args) {
-    console.log(chalk.green(`[SUCCESS] ${message}`), ...args);
-  }
-
-  static writeToFile(message, level = 'INFO') {
-    const logDir = path.join(__dirname, CONSTANTS.LOGS_DIR);
-    const logFile = path.join(logDir, `cli-${new Date().toISOString().split('T')[0]}.log`);
-
-    try {
-      fse.ensureDirSync(logDir);
-      const timestamp = new Date().toISOString();
-      const logEntry = `[${timestamp}] [${level}] ${message}\n`;
-      fs.appendFileSync(logFile, logEntry);
-    } catch (error) {
-      console.error('写入日志文件失败:', error.message);
-    }
-  }
-}
+import { confirm } from '@inquirer/prompts';
+import { getProjectRoot } from './utils.mjs';
+import { Logger, setLogLevel } from './logger.mjs';
+import { CONSTANTS, ACTION_TYPES, LOG_LEVELS } from './constants.mjs';
+import { ProjectInitializer } from './project-initializer.mjs';
+import { mpBuildShell } from './build.mjs';
+import { mpDebugShell } from './debug.mjs';
+import { cleanShell } from './clean.mjs';
+import { incrementVersion, updateAppConfig } from './utils-functions.mjs';
+
+const projectPath = getProjectRoot();
+
+// ========== 全局状态管理 ==========
+// 用于优雅退出，避免重复退出操作
+let isExiting = false;
+let currentProcess = null;
 
 /**
- * 配置验证工具类
+ * 优雅退出处理函数
+ * 
+ * 当收到退出信号（如 Ctrl+C）时：
+ * 1. 尝试关闭正在运行的进程
+ * 2. 延迟退出，给清理操作一些时间
+ * 3. 如果已经在退出中，强制退出
  */
-class ConfigValidator {
-  static validateAppConfig(config) {
-    const errors = [];
-    const warnings = [];
-
-    // 必需字段检查
-    const requiredFields = ['productName', 'versionName', 'versionCode'];
-    requiredFields.forEach(field => {
-      if (!config[field]) {
-        errors.push(`缺少必需字段: ${field}`);
-      }
-    });
-
-    // 版本格式检查
-    // if (config.versionName && !CONSTANTS.VERSION_NAME_REGEX.test(`${config.versionName}`)) {
-    //   errors.push(`版本名称格式错误: ${config.versionName}，应为 x.y.z 格式`);
-    // }
-    // if (config.versionCode && !CONSTANTS.VERSION_CODE_REGEX.test(`${config.versionCode}`)) {
-    //   errors.push(`版本代码格式错误: ${config.versionCode}，应为数字格式`);
-    // }
-
-    // 平台配置检查
-    if (config.iosBuild) {
-      if (!config.iosBuild.appId) {
-        warnings.push('iOS配置缺少appId');
-      }
-    }
-
-    if (config.andBuild) {
-      if (!config.andBuild.appId) {
-        warnings.push('Android配置缺少appId');
-      }
-    }
-
-    return { errors, warnings, isValid: errors.length === 0 };
-  }
-
-  static validateNetworkConfig() {
-    return new Promise(async (resolve) => {
-      try {
-        const networkInfo = await si.networkInterfaces();
-        const defaultNet = (lodash.isArray(networkInfo) ? networkInfo : [networkInfo])
-          .find(i => lodash.get(i, 'default', false));
-
-        if (!defaultNet || !defaultNet.ip4) {
-          resolve({ isValid: false, error: '无法获取网络配置' });
-          return;
-        }
-
-        resolve({
-          isValid: true,
-          host: defaultNet.ip4,
-          interface: defaultNet.iface
-        });
-      } catch (error) {
-        resolve({ isValid: false, error: error.message });
-      }
-    });
-  }
-}
-
-/**
- * 文件系统工具类
- */
-class FileSystemUtils {
-  static ensureDirectory(dirPath) {
-    try {
-      fse.ensureDirSync(dirPath);
-      Logger.debug(`目录已确保存在: ${dirPath}`);
-      return true;
-    } catch (error) {
-      Logger.error(`创建目录失败: ${dirPath}`, error.message);
-      return false;
-    }
+function handleGracefulExit() {
+  if (isExiting) {
+    // 如果已经在退出中，强制退出
+    Logger.warn('强制退出...');
+    process.exit(1);
   }
 
-  static cleanDirectory(dirPath) {
-    try {
-      if (fs.existsSync(dirPath)) {
-        fse.removeSync(dirPath);
-        Logger.info(`目录已清理: ${dirPath}`);
-      }
-      return true;
-    } catch (error) {
-      Logger.error(`清理目录失败: ${dirPath}`, error.message);
-      return false;
-    }
-  }
+  isExiting = true;
+  Logger.info('\n正在退出...');
 
-  static backupFile(filePath) {
+  // 如果有正在运行的进程，尝试关闭
+  if (currentProcess) {
     try {
-      if (fs.existsSync(filePath)) {
-        const backupPath = `${filePath}.backup.${Date.now()}`;
-        fse.copySync(filePath, backupPath);
-        Logger.info(`文件已备份: ${backupPath}`);
-        return backupPath;
+      if (typeof currentProcess.close === 'function') {
+        currentProcess.close();
+      } else if (typeof currentProcess.kill === 'function') {
+        currentProcess.kill('SIGTERM');
       }
-      return null;
-    } catch (error) {
-      Logger.error(`备份文件失败: ${filePath}`, error.message);
-      return null;
-    }
-  }
-
-  static getFileSize(filePath) {
-    try {
-      const stats = fs.statSync(filePath);
-      return stats.size;
     } catch (error) {
-      return 0;
-    }
-  }
-
-  static formatFileSize(bytes) {
-    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
-    if (bytes === 0) return '0 Bytes';
-    const i = Math.floor(Math.log(bytes) / Math.log(1024));
-    return Math.round(bytes / Math.pow(1024, i) * 100) / 100 + ' ' + sizes[i];
-  }
-}
-
-/**
- * 命令执行工具类
- */
-class CommandExecutor {
-  static async execute(command, options = {}) {
-    const {
-      silent = false,
-      fatal = true,
-      timeout = CONSTANTS.DEFAULT_TIMEOUT,
-      retryCount = CONSTANTS.MAX_RETRY_COUNT,
-      description = '执行命令'
-    } = options;
-
-    const spinner = ora(`${description}: ${command}`).start();
-
-    for (let attempt = 1; attempt <= retryCount; attempt++) {
-      try {
-        Logger.debug(`执行命令 (尝试 ${attempt}/${retryCount}): ${command}`);
-
-        const result = await new Promise((resolve, reject) => {
-          const timeoutId = setTimeout(() => {
-            reject(new Error(`命令执行超时 (${timeout}ms)`));
-          }, timeout);
-
-          shell.exec(command, {
-            silent: silent,
-            fatal: false,
-            async: false
-          }, (code, stdout, stderr) => {
-            clearTimeout(timeoutId);
-            resolve({ code, stdout, stderr });
-          });
-        });
-
-        if (result.code === 0) {
-          spinner.succeed(`${description} 成功`);
-          Logger.debug(`命令输出: ${result.stdout}`);
-          return result;
-        } else {
-          throw new Error(`命令执行失败，退出码: ${result.code}, 错误: ${result.stderr}`);
-        }
-      } catch (error) {
-        if (attempt === retryCount) {
-          spinner.fail(`${description} 失败 (${retryCount} 次尝试后)`);
-          Logger.error(`命令执行失败: ${error.message}`);
-
-          if (fatal) {
-            process.exit(1);
-          }
-          throw error;
-        } else {
-          Logger.warn(`命令执行失败，准备重试 (${attempt}/${retryCount}): ${error.message}`);
-          await new Promise(resolve => setTimeout(resolve, 1000 * attempt)); // 递增延迟
-        }
-      }
+      Logger.debug(`关闭进程时出错: ${error.message}`);
     }
   }
 
-  static async executeWithProgress(command, options = {}) {
-    const { description = '执行命令', progressCallback } = options;
-
-    return new Promise((resolve, reject) => {
-      const child = shell.exec(command, {
-        silent: false,
-        fatal: false,
-        async: true
-      });
-
-      let output = '';
-
-      child.stdout?.on('data', (data) => {
-        output += data;
-        if (progressCallback) {
-          progressCallback(data.toString());
-        }
-      });
-
-      child.stderr?.on('data', (data) => {
-        output += data;
-        Logger.warn(`命令输出: ${data}`);
-      });
-
-      child.on('close', (code) => {
-        if (code === 0) {
-          Logger.success(`${description} 完成`);
-          resolve({ code, output });
-        } else {
-          Logger.error(`${description} 失败，退出码: ${code}`);
-          reject(new Error(`命令执行失败，退出码: ${code}`));
-        }
-      });
-
-      child.on('error', (error) => {
-        Logger.error(`${description} 出错: ${error.message}`);
-        reject(error);
-      });
-    });
-  }
-}
-
-/**
- * 验证版本号格式
- *
- * @param {string} versionName - 版本名称 (格式: x.y.z)
- * @param {string} versionCode - 版本代码 (格式: 数字)
- * @returns {boolean} 验证结果
- */
-function validateVersion(versionName, versionCode) {
-  const isVersionNameValid = CONSTANTS.VERSION_NAME_REGEX.test(versionName);
-  const isVersionCodeValid = CONSTANTS.VERSION_CODE_REGEX.test(versionCode);
-
-  if (!isVersionNameValid) {
-    Logger.error(`版本名称格式错误: ${versionName}，应为 x.y.z 格式`);
-  }
-
-  if (!isVersionCodeValid) {
-    Logger.error(`版本代码格式错误: ${versionCode}，应为数字格式`);
-  }
-
-  return isVersionNameValid && isVersionCodeValid;
-}
-
-/**
- * 更新应用配置
- *
- * @param {string} appName - 应用名称
- * @param {Object} newConfig - 新配置
- * @returns {boolean} 更新是否成功
- */
-function updateAppConfig(newConfig) {
-  try {
-    const configPath = path.join(projectPath, 'app.json');
-    const localConfig = fse.readJsonSync(configPath);
-    const _newConfig = {
-      ...localConfig,
-      'htyf': {
-        ...localConfig.htyf,
-        ...newConfig
-      }
-    }
-    // 备份原配置文件
-    // FileSystemUtils.backupFile(configPath);
-
-    // 写入新配置
-    fs.writeFileSync(configPath, JSON.stringify(_newConfig, undefined, 2), 'utf-8');
-    Logger.success(`配置文件已更新: ${configPath}`);
-
-    return true;
-  } catch (error) {
-    Logger.error(`更新配置文件失败: ${error.message}`);
-    return false;
-  }
-}
-
-/**
- * 构建小程序包
- *
- * @param {string} appName - 应用名称
- */
-async function mpBuildShell(newAppInfo) {
-  Logger.info(`开始构建小程序包...`);
-  Logger.info(`应用: ${newAppInfo.name}`);
-  Logger.info(`平台: ${CONSTANTS.BUNDLE_PLATFORM}`);
-
-  // 创建临时目录
-  const tempPath = path.join(__dirname, CONSTANTS.TEMP_DIR, newAppInfo.name);
-  if (!FileSystemUtils.ensureDirectory(tempPath)) {
-    return;
-  }
-
-  const mpOutputPath = path.join(__dirname, CONSTANTS.MP_OUTPUT_DIR, newAppInfo.name, 'dist');
-  if (!FileSystemUtils.ensureDirectory(mpOutputPath)) {
-    return;
-  }
-  const version = newAppInfo.version;
-  const appid = newAppInfo.appid;
-  const scriptName = getMiniAppScriptId(appid, version);
-
-  const appJson = {
-    type: 'app',
-    engines: '2.0.0',
-    name: newAppInfo.name,
-    appid: appid,
-    version: version,
-    appUrlConfig: newAppInfo.appUrlConfig || `${newAppInfo.host}/app.json`,
-    zipUrl: newAppInfo.zipUrl || `${newAppInfo.host}/dist.dgz`
-  }
-
-  const mpOptions = {
-    name: scriptName,
-    filename: `${scriptName}.bundle`,
-    exposes: {
-      'App': `./src/${newAppInfo.name}/index.tsx`,
-    },
-    outputPath: path.join(mpOutputPath, '../build'),
-    extraChunksPath: path.join(mpOutputPath),
-  }
-
-
-  const appJsonPath = path.join(mpOutputPath, '../', `./app.json`);
-  fs.writeFileSync(appJsonPath, JSON.stringify(appJson, undefined, 2));
-  const webpackConfigPath = path.join(__dirname, 'webpack.config.mjs');
-  const command = `npx cross-env APP_USE_ENTRY_DEV=${newAppInfo.name} APP_EXPOSES_OPTIONS=${encodeURI(JSON.stringify(mpOptions))} APP_EXPOSES_FILENAME=${mpOptions.filename} APP_EXPOSES_EXPOSES=${JSON.stringify(mpOptions.exposes)} npx webpack --config ${webpackConfigPath}`;
-
-  try {
-    await CommandExecutor.execute(command, {
-      description: '构建小程序包',
-      timeout: 120000
-    });
-
-    fs.copyFileSync(appJsonPath, path.join(mpOutputPath, '../dist', `./app.json`));
-    const zipPath = await handleZip(mpOutputPath, path.join(mpOutputPath, '../', `./dist.dgz`));
-    Logger.success(`压缩包已创建: ${zipPath}`);
-    return zipPath;
-  } catch (error) {
-    Logger.error(`小程序构建失败: ${error.message}`);
-    throw error;
-  }
-}
-
-/**
- * 压缩文件夹为zip文件
- *
- * @param {string} inputPath - 输入文件夹路径
- * @param {string} outputPath - 输出zip文件路径
- * @returns {Promise<string>} zip文件路径
- */
-const handleZip = async (inputPath, outputPath) => {
-  Logger.info(`开始压缩文件夹: ${inputPath}`);
-  Logger.info(`输出文件: ${outputPath}`);
-
-  // 检查输入路径是否存在
-  if (!fs.existsSync(inputPath)) {
-    throw new Error(`输入路径不存在: ${inputPath}`);
-  }
-
-  // 检查输入路径是否为目录
-  const stats = fs.statSync(inputPath);
-  if (!stats.isDirectory()) {
-    throw new Error(`输入路径不是目录: ${inputPath}`);
-  }
-
-  // 列出目录内容
-  const files = fs.readdirSync(inputPath);
-  Logger.debug(`目录内容: ${files.length} 个文件/文件夹`);
-  files.forEach(file => {
-    const filePath = path.join(inputPath, file);
-    const fileStats = fs.statSync(filePath);
-    Logger.debug(`  - ${file} (${fileStats.isDirectory() ? '目录' : '文件'})`);
-  });
-
-  if (files.length === 0) {
-    Logger.warn(`警告: 目录为空，将创建空的zip文件`);
-  }
-
-  const zipPath = outputPath;
-  const admzip = new AdmZip();
-
-  try {
-    await admzip.addLocalFolderPromise(inputPath, {
-      filter: (filename) => {
-        // 过滤掉 .map 文件
-        if (filename.endsWith('.map')) {
-          Logger.debug(`过滤文件: ${filename}`);
-          return false;
-        }
-        Logger.debug(`添加文件: ${filename}`);
-        return true;
-      }
-    });
-
-    await admzip.writeZipPromise(zipPath);
-    Logger.success(`压缩完成: ${zipPath}`);
-
-    // 检查生成的zip文件大小
-    const zipStats = fs.statSync(zipPath);
-    Logger.info(`ZIP文件大小: ${FileSystemUtils.formatFileSize(zipStats.size)}`);
-
-    return zipPath;
-  } catch (error) {
-    Logger.error(`压缩失败: ${error.message}`);
-    throw error;
-  }
-};
-
-/**
- * 小程序真机调试
- *
- * @param {string} appName - 应用名称
- */
-async function mpDebugShell(newAppInfo) {
-  try {
-    const zipPath = await mpBuildShell(newAppInfo);
-    const assetsPath = path.dirname(zipPath);
-    const appJsonPath = path.join(assetsPath, 'app.json');
-
-    Logger.info(`资源路径: ${assetsPath}`);
-    const applocaljson = fse.readJsonSync(appJsonPath);
-
-    // 验证网络配置
-    const networkValidation = await ConfigValidator.validateNetworkConfig();
-    if (!networkValidation.isValid) {
-      throw new Error(`网络配置验证失败: ${networkValidation.error}`);
-    }
-
-    const host = networkValidation.host;
-    const port = await portfinder.getPortPromise();
-
-    const app = superstatic.server({
-      port: port,
-      address: host,
-      cwd: assetsPath
-    });
-
-    const server = app.listen(function () {
-      const address = server.address();
-
-      const debugerAppUrlConfig = `http://${host}:${address.port}/app.json`;
-      const debugerZip = `http://${host}:${address.port}/dist.dgz`;
-      const args = {
-        ...applocaljson,
-        development: true,
-        "name": applocaljson.name,
-        "appid": applocaljson.appid,
-        "version": applocaljson.version,
-        appUrlConfig: debugerAppUrlConfig,
-        zipUrl: debugerZip,
-      }
-
-      fse.writeJSONSync(appJsonPath, {
-        ...fse.readJSONSync(appJsonPath),
-        appUrlConfig: debugerAppUrlConfig,
-        zipUrl: debugerZip,
-      });
-
-      const qrcodeUrl = `https://share.dagouzhi.com/#/pages/index/index?data=${encodeURIComponent(JSON.stringify(args))}`;
-
-      // 显示调试信息
-      console.log('\n');
-      console.log(boxen(
-        gradient.rainbow('小程序真机调试') + '\n\n' +
-        chalk.cyan('服务器地址: ') + chalk.white(`${host}:${address.port}`) + '\n' +
-        chalk.cyan('应用名称: ') + chalk.white(applocaljson.name) + '\n' +
-        chalk.cyan('应用ID: ') + chalk.white(applocaljson.appid) + '\n' +
-        chalk.cyan('版本: ') + chalk.white(applocaljson.version),
-        {
-          padding: 1,
-          margin: 1,
-          borderStyle: 'round',
-          borderColor: 'cyan'
-        }
-      ));
-
-      console.log('\n' + chalk.yellow('调试配置:'));
-      console.log(JSON.stringify(args, undefined, 2));
-
-      console.log('\n' + chalk.green('调试链接:'));
-      console.log(qrcodeUrl);
-
-      console.log('\n' + chalk.blue('二维码:'));
-      printQrcode(qrcodeUrl);
-
-      Logger.info('调试服务器已启动，按 Ctrl+C 停止');
-    });
-
-    // 优雅关闭
-    process.on('SIGINT', () => {
-      Logger.info('正在关闭调试服务器...');
-      server.close(() => {
-        Logger.success('调试服务器已关闭');
-        process.exit(0);
-      });
-    });
-
-  } catch (error) {
-    Logger.error(`小程序调试失败: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-/**
- * 清理临时文件
- *
- * @param {string} appName - 应用名称（可选）
- */
-async function cleanShell(appName = null) {
-  Logger.info('开始清理临时文件...');
-
-  const pathsToClean = [];
-
-  if (appName) {
-    // 清理指定应用的临时文件
-    pathsToClean.push(
-      path.join(__dirname, CONSTANTS.TEMP_DIR, appName),
-      path.join(__dirname, CONSTANTS.MP_OUTPUT_DIR, appName)
-    );
-  } else {
-    // 清理所有临时文件
-    pathsToClean.push(
-      path.join(__dirname, CONSTANTS.TEMP_DIR),
-      path.join(__dirname, CONSTANTS.MP_OUTPUT_DIR)
-    );
-  }
-
-  let cleanedCount = 0;
-  for (const path of pathsToClean) {
-    if (FileSystemUtils.cleanDirectory(path)) {
-      cleanedCount++;
-    }
-  }
-
-  Logger.success(`清理完成，已清理 ${cleanedCount} 个目录`);
+  // 延迟退出，给清理操作一些时间
+  setTimeout(() => {
+    Logger.info('再见!');
+    process.exit(0);
+  }, 100);
 }
 
-/**
- * 打印二维码
- *
- * @param {string} url - 要生成二维码的URL
- */
-const printQrcode = async (url) => {
-  try {
-    let terminalStr = await QRCode.toString(url, { type: 'terminal', small: true });
-    console.log(terminalStr);
-  } catch (error) {
-    Logger.error(`生成二维码失败: ${error.message}`);
-  }
-};
+// ========== 注册全局信号处理 ==========
+// 使用 once 确保只注册一次
+// 注意：某些模块（如 debug.mjs）可能会移除这些监听器并添加自己的处理
+process.on('SIGINT', handleGracefulExit);   // Ctrl+C
+process.on('SIGTERM', handleGracefulExit);  // 终止信号
 
 /**
  * 主启动函数
- * 处理用户选择的操作类型
- *
- * @param {string} action - 操作类型
+ * 
+ * 根据操作类型执行相应的功能：
+ * - MP_BUILD: 构建小程序包
+ * - MP_DEBUG: 启动真机调试服务器
+ * - CLEAN: 清理临时文件
+ * - QUIT: 退出程序
+ * 
+ * @param {string} action - 操作类型（ACTION_TYPES 中的值）
  */
 async function Start(action) {
   const actionNames = {
@@ -683,45 +107,87 @@ async function Start(action) {
 
   Logger.info(`当前操作: ${actionNames[action] || '未知操作'}`);
 
-  // 如果是退出操作，直接返回
+  // ========== 退出操作 ==========
   if (action === ACTION_TYPES.QUIT) {
     Logger.info('再见!');
     return;
   }
 
-  // 如果是清理或状态操作，不需要选择应用
+  // ========== 清理操作 ==========
   if (action === ACTION_TYPES.CLEAN) {
-    const { cleanAll } = await inquirer.prompt([
+    const { cleanType } = await inquirer.prompt([
       {
-        type: 'confirm',
-        name: 'cleanAll',
-        message: '是否清理所有应用的临时文件？',
-        default: false
+        type: 'list',
+        name: 'cleanType',
+        message: '请选择清理类型：',
+        choices: [
+          { name: '🧹 清理所有临时文件', value: 'all' },
+          { name: '📁 清理构建输出', value: 'build' },
+          { name: '🗂️  清理临时目录', value: 'temp' },
+          { name: '📝 清理日志文件', value: 'logs' },
+          { name: '💾 清理缓存文件', value: 'cache' },
+          { name: '❌ 取消', value: 'cancel' }
+        ]
       }
     ]);
 
-    if (cleanAll) {
-      await cleanShell();
+    if (cleanType === 'cancel') {
+      Logger.info('已取消清理操作');
+      return;
+    }
+
+    const getCleanTypeName = (type) => {
+      switch (type) {
+        case 'all': return '所有';
+        case 'build': return '构建输出';
+        case 'temp': return '临时';
+        case 'logs': return '日志';
+        case 'cache': return '缓存';
+        default: return type;
+      }
+    };
+
+    const confirmClean = await confirm({
+      message: `确定要清理${getCleanTypeName(cleanType)}文件吗？`,
+      default: false
+    });
+
+    if (confirmClean) {
+      await cleanShell(cleanType);
+    } else {
+      Logger.info('已取消清理操作');
     }
     return;
   }
 
-
-  // 显示应用选择界面
+  // ========== 构建/调试操作 ==========
   try {
-    const appInfo = fse.readJsonSync(path.join(projectPath, 'app.json')).htyf;
+    // 读取应用配置
+    const appConfigPath = path.join(projectPath, 'app.json');
+    const appInfo = fse.readJsonSync(appConfigPath).htyf;
+    
+    // 检测是否为 Godot 项目（通过检查是否存在 project.godot 文件）
+    const isGodot = fse.existsSync(path.join(projectPath, 'project.godot'));
+    Logger.info(`项目类型: ${isGodot ? 'Godot 游戏项目' : '普通小程序项目'}`);
+    
     if (!appInfo) {
       Logger.error('应用配置不存在，请先在app.json中配置htyf');
       return;
     }
+    
+    // ========== 版本处理 ==========
+    // 自动递增版本号作为默认值
+    const version = appInfo?.version;
+    const incrementedVersion = version ? incrementVersion(version) : '1.0.0';
     const { versionName } = await inquirer.prompt([
       {
         type: 'input',
         name: 'versionName',
         message: '请输入应用版本名称 (格式: x.y.z):',
-        default: appInfo?.version,
+        default: incrementedVersion,
         validate: (input) => {
-          return CONSTANTS.VERSION_NAME_REGEX.test(input) || '请输入正确的版本名称格式 (x.y.z)';
+          const _ipt = input || incrementedVersion;
+          return (!!_ipt && /^\d+(\.\d+){2}$/g.test(_ipt)) || '请输入正确的版本名称格式 (x.y.z)';
         }
       },
     ]);
@@ -729,25 +195,22 @@ async function Start(action) {
     Logger.info(`用户选择:`);
     Logger.info(`版本名称: ${versionName}`);
 
-    // 验证版本格式
-    // if (!validateVersion(versionName, versionCode)) {
-    //   return;
-    // }
-
-    // 合并新配置
+    // ========== 更新应用配置 ==========
+    // 合并用户输入的版本号到应用信息中
     const newAppInfo = lodash.merge({}, appInfo, {
       version: versionName,
     });
 
-    // 更新配置文件
+    // 更新 app.json 文件
     if (!updateAppConfig(newAppInfo)) {
       return;
     }
 
-    // 显示操作信息
+    // ========== 显示应用信息 ==========
     console.log('\n' + boxen(
       chalk.cyan('应用信息') + '\n\n' +
-      chalk.white('名称: ') + chalk.yellow(`${newAppInfo.name})`) + '\n' +
+      chalk.white('名称: ') + chalk.yellow(`${newAppInfo.name}`) + '\n' +
+      chalk.white('版本: ') + chalk.yellow(`${newAppInfo.version}`),
       {
         padding: 1,
         margin: 1,
@@ -756,16 +219,17 @@ async function Start(action) {
       }
     ));
 
-    // 执行初始化
-    Logger.info('执行初始化...');
+    Logger.info('开始执行操作...');
 
-    // 根据操作类型执行相应命令
+    // ========== 执行相应操作 ==========
     switch (action) {
       case ACTION_TYPES.MP_BUILD:
-        await mpBuildShell(newAppInfo);
+        // 构建小程序包
+        await mpBuildShell(newAppInfo, isGodot);
         break;
       case ACTION_TYPES.MP_DEBUG:
-        await mpDebugShell(newAppInfo);
+        // 启动真机调试服务器
+        await mpDebugShell(newAppInfo, isGodot);
         break;
       default:
         Logger.error(`未知的操作类型: ${action}`);
@@ -777,10 +241,13 @@ async function Start(action) {
   }
 }
 
-// 主程序入口
+// ========== 主程序入口 ==========
+// 显示欢迎信息
 console.log('\n' + boxen(
-  gradient.rainbow('🎯 红糖云服 应用 CLI 工具 v2.0.0') + '\n' +
-  chalk.gray('用于管理多应用项目的开发、构建和部署'),
+  gradient.rainbow('🎯 红糖云服 应用 CLI 工具 v2.2.0') + '\n' +
+  chalk.gray('用于管理多应用项目的开发、构建和部署') + '\n' +
+  chalk.gray(`项目目录:`) + '\n\n' +
+  chalk.gray(`${projectPath}`) + '\n',
   {
     padding: 1,
     margin: 1,
@@ -789,15 +256,62 @@ console.log('\n' + boxen(
   }
 ));
 
-// 设置日志级别
+// ========== 命令行参数处理 ==========
+
+// 处理调试模式参数
 if (process.argv.includes('--debug')) {
-  currentLogLevel = LOG_LEVELS.DEBUG;
+  setLogLevel(LOG_LEVELS.DEBUG);
   Logger.debug('调试模式已启用');
 }
 
 // 记录启动日志
 Logger.writeToFile('CLI 工具启动', 'INFO');
 
+// 处理清理参数（命令行直接清理，不进入交互界面）
+if (process.argv.includes('--clean')) {
+  const cleanIndex = process.argv.indexOf('--clean');
+  const cleanType = process.argv[cleanIndex + 1] || 'all';
+  
+  if (['all', 'build', 'temp', 'logs', 'cache'].includes(cleanType)) {
+    Logger.info(`执行命令行清理: ${cleanType}`);
+    await cleanShell(cleanType);
+    process.exit(0);
+  } else {
+    Logger.error(`无效的清理类型: ${cleanType}`);
+    Logger.error('支持的清理类型: all, build, temp, logs, cache');
+    process.exit(1);
+  }
+}
+
+// 显示帮助信息
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log('\n' + boxen(
+    chalk.cyan('CLI 工具使用说明') + '\n\n' +
+    chalk.white('基本用法:') + '\n' +
+    chalk.gray('  node index.mjs                    # 启动交互式界面') + '\n' +
+    chalk.gray('  node index.mjs --debug           # 启用调试模式') + '\n' +
+    chalk.gray('  node index.mjs --help            # 显示帮助信息') + '\n\n' +
+    chalk.white('清理命令:') + '\n' +
+    chalk.gray('  node index.mjs --clean all       # 清理所有临时文件') + '\n' +
+    chalk.gray('  node index.mjs --clean build     # 清理构建输出') + '\n' +
+    chalk.gray('  node index.mjs --clean temp      # 清理临时目录') + '\n' +
+    chalk.gray('  node index.mjs --clean logs      # 清理日志文件') + '\n' +
+    chalk.gray('  node index.mjs --clean cache     # 清理缓存文件') + '\n\n' +
+    chalk.white('功能说明:') + '\n' +
+    chalk.gray('  🆕 初始化新小程序项目 - 创建新的小程序项目') + '\n' +
+    chalk.gray('  🔍 小程序打包 - 构建小程序包') + '\n' +
+    chalk.gray('  📦 小程序调试 - 启动真机调试服务') + '\n' +
+    chalk.gray('  🧹 清理模式 - 清理临时文件') + '\n',
+    {
+      padding: 1,
+      margin: 1,
+      borderStyle: 'round',
+      borderColor: 'blue'
+    }
+  ));
+  process.exit(0);
+}
+
 inquirer
   .prompt([
     {
@@ -805,6 +319,7 @@ inquirer
       name: 'index',
       message: '请选择你想要执行的操作：',
       choices: [
+        { name: '🆕 初始化新小程序项目', value: ACTION_TYPES.INIT },
         { name: '🔍 小程序 - 打包小程序', value: ACTION_TYPES.MP_BUILD },
         { name: '📦 小程序 - 真机调试', value: ACTION_TYPES.MP_DEBUG },
         { name: '🧹 清理模式 - 清理临时文件', value: ACTION_TYPES.CLEAN },
@@ -812,14 +327,22 @@ inquirer
       ],
     },
   ])
-  .then(({ index }) => {
-    Start(index);
+  .then(async ({ index }) => {
+    if (index === ACTION_TYPES.INIT) {
+      const initializer = new ProjectInitializer();
+      await initializer.initialize();
+    } else {
+      await Start(index);
+    }
   })
   .catch((error) => {
+    // 如果是用户取消（Ctrl+C），不显示错误
+    if (error.isTtyError || error.name === 'AbortError') {
+      handleGracefulExit();
+      return;
+    }
     Logger.error(`程序启动失败: ${error.message}`);
-    process.exit(1);
+    if (!isExiting) {
+      process.exit(1);
+    }
   });
-
-export const getMiniAppScriptId = (appid, version) => {
-  return `${appid}_v${version?.replace(/\./gi, '_')}`
-}