@htyf-mp/cli 0.7.0 → 0.7.1

package/README.md

@@ -21,11 +21,11 @@ npx @htyf-mp/cli
 按照交互提示完成：
 
 1. **输入应用目录名**（例如 `my-htyf-mp`，用于创建项目文件夹）。
-2. **输入应用显示名称**（2–4 个中文/字母/数字）。
+2. **输入应用显示名称**（2–10 个中文/字母/数字）。
 3. **选择模板类型**：
    - `app-template`：React Native 应用小程序（对应 `type: 'app'`）。
    - `game-template`：Godot 游戏小程序（对应 `type: 'game'`）。
-   - `web-template`：Web/H5 小程序（对应 `type: 'web'`）。
+   - `taro-template`：Taro 小程序模板。
 4. 选择模板仓库镜像（当前默认使用 GitHub）。
 
 CLI 会自动：
@@ -35,7 +35,40 @@ CLI 会自动：
 - 生成 `app.json` 中的 `htyf` 配置（包含 `appid`、`name`、`zipUrl`、`appUrlConfig` 等）。
 - 将模板拷贝到你指定的项目目录中。
 
-> 各模板的具体用法，请参考生成项目中 `_apps_temp_` / `_game_temp_` / `_web_temp_` 目录下的 `README.md`。
+> 各模板的具体用法，请参考生成项目中 `_apps_temp_` / `_game_temp_` / `_taro_temp_` 目录下的 `README.md`。
+
+## AI / 脚本直接调用
+
+不带子命令时保留交互菜单；以下子命令均为非交互模式，不需要模拟按键或逐步回答问题。`--non-interactive` 可显式标注自动化调用。无终端且未指定命令时立即报错，不会挂起等待输入。
+
+```bash
+# 创建项目，--project 指定父目录；不会自动安装依赖
+htyf init --name my-app --display-name 我的应用 --template taro --project ./workspace
+
+# 构建，显式设置并写入 app.json 的 htyf.version
+htyf build --project ./workspace/my-app --version 1.2.3 --platform ios
+
+# 省略 --version 时使用现有版本，不自动递增
+htyf build --project ./workspace/my-app
+htyf debug --project ./workspace/my-app
+
+# Godot 项目（项目根目录包含 project.godot）
+htyf build --project ./my-game --version 1.0.0 --platform android \
+  --godot-bin /path/to/godot --godot-preset Android
+
+# 指定清理范围；省略范围为 all，直接执行清理
+htyf clean build --project ./workspace/my-app
+htyf sync-deps --project ./workspace/my-app
+htyf --help
+```
+
+可将 `htyf` 替换为 `npx @htyf-mp/cli` 或 `htyf-mp`。初始化必须提供 `--name`、`--display-name`、`--template`；模板支持 `taro`、`app`、`game` 及对应的 `*-template` 全名。目标目录已存在时失败，不覆盖项目。
+
+`--project` 默认当前目录，其他相对路径基于此目录解析。Godot 支持 `--godot-project` 指定内部项目目录；可执行文件依次取 `--godot-bin`、`GODOT_EDITOR`、缓存、内置默认路径，不可执行时立即失败。预设默认随平台选择 `iOS` 或 `Android`。
+
+成功退出码为 `0`，参数或执行失败为 `1`；输出为人类可读日志，构建完成输出产物路径。`debug` 为持续运行的调试服务，使用 Ctrl+C 停止。人工菜单的构建版本询问和 Godot 选项询问保留。`--debug` 表示详细日志，与 `debug` 子命令不同。
+
+旧命令 `--clean [类型]`、`--sync-deps` 继续可用，`mp-build` / `mp-debug` 分别为 `build` / `debug` 的别名。使用 `--help` 时仅显示帮助，不执行操作。
 
 ## 项目操作命令
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@htyf-mp/cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "红糖云服app小程序模板-cli",
   "type": "module",
   "bin": {
@@ -13,7 +13,7 @@
   ],
   "scripts": {
     "start": "node src/index.mjs",
-    "test": "echo \"Error: no test specified\" && exit 0"
+    "test": "node --test tests/*.test.mjs"
   },
   "keywords": [
     "hongtangyun",
@@ -82,5 +82,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "0bb5ec21167c668e13d0a072a90edc153e4111e8"
+  "gitHead": "29d6076f403a5e856e08602ab61d57c887766787"
 }

package/src/build.mjs

@@ -365,7 +365,10 @@ export async function mpBuildShell(newAppInfo, isGodot = false, buildOptions = {
       };
       
       // 提示用户输入或确认 Godot 导出选项
-      const godotOptions = await promptGodotOptions(godotDefaults);
+      const godotOptions = await promptGodotOptions({
+        ...godotDefaults, ...buildOptions.godot,
+        nonInteractive: buildOptions.nonInteractive
+      });
       outputPath = path.resolve(godotOptions.targetBaseDir);
       await fse.ensureDir(outputPath);
       

package/src/clean.mjs

@@ -74,6 +74,8 @@ export async function cleanShell(cleanType = 'all') {
   for (const cleanPath of pathsToClean) {
     if (FileSystemUtils.cleanDirectory(cleanPath)) {
       cleanedCount++;
+    } else {
+      throw new Error(`清理目录失败: ${cleanPath}`);
     }
   }
 

package/src/cli-options.mjs

@@ -0,0 +1,77 @@
+import { parseArgs } from 'node:util';
+
+export const HELP = `红糖云服 CLI
+
+用法：
+  htyf                              交互式菜单（需要终端）
+  htyf init --name my-app --display-name 我的应用 --template taro
+  htyf build --project ./my-app --version 1.2.3 --platform ios
+  htyf debug --project ./my-app
+  htyf clean [all|build|temp|logs|cache] --project ./my-app
+  htyf sync-deps --project ./my-app
+
+所有子命令均不询问问题，可由 AI、脚本或 CI 直接调用。
+  --project <目录>          项目目录；init 时为父目录，默认当前目录
+  --non-interactive        显式要求非交互模式，必须指定子命令
+  --name <名称>            init 必填，英文目录名称，如 my-app
+  --display-name <名称>    init 必填，2–10 个中文、字母或数字
+  --template <模板>        init 必填：taro、app、game（也支持 *-template）
+  --version <x.y.z>        build/debug 使用的版本；省略则保留现有版本
+  --platform <平台>        build/debug：ios（默认）或 android
+  --godot-bin <文件>       Godot 可执行文件；也可使用 GODOT_EDITOR
+  --godot-project <目录>   Godot 项目目录，默认自动检测
+  --godot-preset <名称>    默认 iOS 或 Android
+  --debug                 详细日志（真机调试使用 debug 子命令）
+  --help, -h              帮助
+
+兼容：--clean [类型]、--sync-deps、mp-build、mp-debug。
+成功退出码 0，失败 1；debug 为持续运行服务，Ctrl+C 停止。
+`;
+
+export function parseCliArgs(args, isTTY = Boolean(process.stdin.isTTY)) {
+  const { values, positionals } = parseArgs({ args, allowPositionals: true, options: {
+    help: { type: 'boolean', short: 'h' }, debug: { type: 'boolean' },
+    'non-interactive': { type: 'boolean' }, clean: { type: 'boolean' },
+    'sync-deps': { type: 'boolean' },
+    ...Object.fromEntries(['project', 'name', 'display-name', 'template', 'version', 'platform',
+      'godot-bin', 'godot-project', 'godot-preset'].map(key => [key, { type: 'string' }]))
+  }});
+  if (values.help || positionals[0] === 'help') return { help: true };
+  const commands = [...positionals];
+  if (values.clean && values['sync-deps']) throw new Error('不能同时指定多个命令');
+  if (values.clean) commands.unshift('clean');
+  if (values['sync-deps']) commands.unshift('sync-deps');
+  let command = commands.shift();
+  command = ({ 'mp-build': 'build', 'mp-debug': 'debug' })[command] || command;
+  if (!command) {
+    if (values['non-interactive'] || !isTTY) throw new Error('非交互环境必须指定命令；运行 htyf --help 查看用法');
+    if (Object.keys(values).some(key => !['debug', 'project'].includes(key))) throw new Error('请为参数指定子命令');
+    return { command: 'interactive', values };
+  }
+  const allowed = {
+    init: ['name', 'display-name', 'template'],
+    build: ['version', 'platform', 'godot-bin', 'godot-project', 'godot-preset'],
+    debug: ['version', 'platform', 'godot-bin', 'godot-project', 'godot-preset'],
+    clean: ['clean'], 'sync-deps': ['sync-deps']
+  };
+  if (!Object.hasOwn(allowed, command)) throw new Error(`未知命令: ${command}`);
+  for (const key of Object.keys(values)) {
+    if (!['project', 'debug', 'non-interactive'].includes(key) && !allowed[command].includes(key)) {
+      throw new Error(`${command} 不支持 --${key}`);
+    }
+    if (typeof values[key] === 'string' && !values[key].trim()) throw new Error(`--${key} 不能为空`);
+  }
+  const cleanType = command === 'clean' ? commands.shift() || 'all' : undefined;
+  if (commands.length) throw new Error(`多余参数: ${commands.join(' ')}`);
+  if (cleanType && !['all', 'build', 'temp', 'logs', 'cache'].includes(cleanType)) throw new Error(`无效清理类型: ${cleanType}`);
+  if (values.version && !/^\d+\.\d+\.\d+$/.test(values.version)) throw new Error('--version 必须为 x.y.z');
+  if (values.platform && !['ios', 'android'].includes(values.platform)) throw new Error('--platform 必须为 ios 或 android');
+  if (command === 'init') {
+    for (const key of ['name', 'display-name', 'template']) if (!values[key]) throw new Error(`init 缺少 --${key}`);
+    values.template = values.template.replace(/-template$/, '') + '-template';
+    if (!['taro-template', 'app-template', 'game-template'].includes(values.template)) throw new Error('无效模板类型');
+    if (!/^([a-z]+)(-[a-z0-9]+)*$/.test(values.name)) throw new Error('目录名称格式应为 my-app');
+    if (!/^[\u4e00-\u9fa5a-zA-Z0-9]{2,10}$/.test(values['display-name'])) throw new Error('应用名称需为 2–10 个中文、字母或数字');
+  }
+  return { command, values, cleanType };
+}

package/src/debug.mjs

@@ -73,7 +73,7 @@ async function waitForWebH5Output(options = {}) {
  *   entry: './src/index.js'
  * }, false);
  */
-export async function mpDebugShell(newAppInfo, isGodot = false) {
+export async function mpDebugShell(newAppInfo, isGodot = false, buildOptions = {}) {
   try {
     // ========== 参数验证 ==========
     // Godot 项目不需要 entry 字段，Web 类型也不需要；
@@ -102,7 +102,7 @@ export async function mpDebugShell(newAppInfo, isGodot = false) {
 
     // ========== 构建小程序包 ==========
     Logger.info('开始构建小程序包...');
-    const zipPath = await mpBuildShell(newAppInfo, isGodot, { skipWebBuild: isWeb });
+    const zipPath = await mpBuildShell(newAppInfo, isGodot, { ...buildOptions, skipWebBuild: isWeb });
     const assetsPath = path.dirname(zipPath);
     const appJsonPath = path.join(assetsPath, 'app.json');
 

package/src/export_godot.mjs

@@ -265,7 +265,7 @@ export async function promptGodotOptions(defaults = {}) {
   if (
     defaults.targetBaseDir &&
     projectDir &&
-    defaults.appid &&
+    (defaults.appid || (defaults.nonInteractive && defaults.name)) &&
     defaults.preset &&
     defaults.platform
   ) {
@@ -278,12 +278,16 @@ export async function promptGodotOptions(defaults = {}) {
     return {
       targetBaseDir: String(defaults.targetBaseDir).trim(),
       projectDir: projectDir,
-      name: String(defaults.appid).trim(),
+      name: String(defaults.appid || defaults.name).trim(),
+      nonInteractive: defaults.nonInteractive,
+      godotBin: defaults.godotBin,
       preset: String(defaults.preset).trim(),
       platform: defaults.platform
     };
   }
 
+  if (defaults.nonInteractive) throw new Error('缺少 Godot 导出参数');
+
   // 通过交互式命令行获取用户输入
   const answers = await inquirer.prompt([
     {
@@ -415,22 +419,22 @@ async function promptForGodotBinaryPath(defaultPath) {
 /**
  * 解析并获取 Godot 编辑器可执行文件路径
  * 
- * 优先级：环境变量 > 缓存 > 默认路径
- * 总是会询问用户，但将缓存值或默认值作为默认输入
+ * 优先级：显式参数 > 环境变量 > 缓存 > 默认路径
+ * 交互模式询问用户；非交互模式直接验证并使用已解析路径
  * 
  * @returns {Promise<string>} Godot 编辑器可执行文件路径
  * @throws {Error} 当路径不可执行时抛出错误
  */
-async function resolveGodotBinary() {
+async function resolveGodotBinary(options = {}) {
   // 获取可能的默认值（优先级：环境变量 > 缓存 > 默认路径）
   const override = process.env.GODOT_EDITOR ? process.env.GODOT_EDITOR.trim() : '';
   const cached = readCachedGodotPath();
   
   // 确定默认值
-  let defaultPath = override || cached || DEFAULT_GODOT_BIN;
+  const defaultPath = options.godotBin || override || cached || DEFAULT_GODOT_BIN;
   
-  // 总是询问用户，但将缓存值或默认值作为默认输入
-  const godotPath = await promptForGodotBinaryPath(defaultPath);
+  // 自动化调用不进入输入提示
+  const godotPath = options.nonInteractive ? defaultPath : await promptForGodotBinaryPath(defaultPath);
 
   // 验证路径是否可执行
   if (!isExecutable(godotPath)) {
@@ -538,7 +542,7 @@ async function handleIosExport({ godotBin, projectDir, preset, targetBaseDir, na
  */
 export async function exportGodot(options) {
   // 解析并获取 Godot 编辑器路径
-  const godotBin = await resolveGodotBinary();
+  const godotBin = await resolveGodotBinary(options);
   const { platform, projectDir, preset, targetBaseDir, name } = options;
 
   // 执行两次 import 以确保资源正确导入

package/src/index.mjs

@@ -1,367 +1,25 @@
 #!/usr/bin/env node
+import { HELP, parseCliArgs } from './cli-options.mjs';
 
-/**
- * 红糖云服应用 CLI 工具主入口
- * 
- * 功能：
- * - 初始化新小程序项目
- * - 小程序打包构建
- * - 小程序真机调试
- * - 清理临时文件
- * 
- * 支持项目类型：
- * - 普通小程序项目（使用 webpack 构建）
- * - Godot 游戏项目（使用 Godot 导出工具）
- *
- * @author CLI Team
- * @version 2.2.0
- * @module index
- */
-
-import inquirer from 'inquirer';
-import path from 'path';
-import chalk from 'chalk';
-import { requireCjs } from './cjs.mjs';
-
-const lodash = requireCjs('lodash');
-const fse = requireCjs('fs-extra');
-import boxen from 'boxen';
-import gradient from 'gradient-string';
-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 { syncDepsShell } from './sync-deps.mjs';
-import { incrementVersion, updateAppConfig } from './utils-functions.mjs';
-
-const projectPath = getProjectRoot();
-
-// ========== 全局状态管理 ==========
-// 用于优雅退出，避免重复退出操作
-let isExiting = false;
-let currentProcess = null;
-
-/**
- * 优雅退出处理函数
- * 
- * 当收到退出信号（如 Ctrl+C）时：
- * 1. 尝试关闭正在运行的进程
- * 2. 延迟退出，给清理操作一些时间
- * 3. 如果已经在退出中，强制退出
- */
-function handleGracefulExit() {
-  if (isExiting) {
-    // 如果已经在退出中，强制退出
-    Logger.warn('强制退出...');
-    process.exit(1);
-  }
-
-  isExiting = true;
-  Logger.info('\n正在退出...');
-
-  // 如果有正在运行的进程，尝试关闭
-  if (currentProcess) {
-    try {
-      if (typeof currentProcess.close === 'function') {
-        currentProcess.close();
-      } else if (typeof currentProcess.kill === 'function') {
-        currentProcess.kill('SIGTERM');
-      }
-    } catch (error) {
-      Logger.debug(`关闭进程时出错: ${error.message}`);
-    }
-  }
-
-  // 延迟退出，给清理操作一些时间
-  setTimeout(() => {
-    Logger.info('再见!');
-    process.exit(0);
-  }, 100);
-}
-
-// ========== 注册全局信号处理 ==========
-// 使用 once 确保只注册一次
-// 注意：某些模块（如 debug.mjs）可能会移除这些监听器并添加自己的处理
-process.on('SIGINT', handleGracefulExit);   // Ctrl+C
-process.on('SIGTERM', handleGracefulExit);  // 终止信号
-
-/**
- * 主启动函数
- * 
- * 根据操作类型执行相应的功能：
- * - MP_BUILD: 构建小程序包
- * - MP_DEBUG: 启动真机调试服务器
- * - CLEAN: 清理临时文件
- * - QUIT: 退出程序
- * 
- * @param {string} action - 操作类型（ACTION_TYPES 中的值）
- */
-async function Start(action) {
-  const actionNames = {
-    [ACTION_TYPES.MP_BUILD]: '小程序构建',
-    [ACTION_TYPES.MP_DEBUG]: '小程序调试',
-    [ACTION_TYPES.SYNC_DEPS]: '同步依赖版本',
-    [ACTION_TYPES.CLEAN]: '清理模式',
-    [ACTION_TYPES.QUIT]: '退出'
-  };
-
-  Logger.info(`当前操作: ${actionNames[action] || '未知操作'}`);
-
-  // ========== 退出操作 ==========
-  if (action === ACTION_TYPES.QUIT) {
-    Logger.info('再见!');
-    return;
-  }
-
-  // ========== 同步依赖版本 ==========
-  if (action === ACTION_TYPES.SYNC_DEPS) {
-    await syncDepsShell();
-    return;
-  }
-
-  // ========== 清理操作 ==========
-  if (action === ACTION_TYPES.CLEAN) {
-    const { cleanType } = await inquirer.prompt([
-      {
-        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 (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);
+try {
+  const options = parseCliArgs(process.argv.slice(2));
+  if (options.help) {
+    console.log(HELP);
+  } else {
+    // 模块在加载时计算项目路径，必须先切换目录再导入。
+    if (options.values.project) process.chdir(options.values.project);
+    if (options.values.debug) {
+      const { setLogLevel } = await import('./logger.mjs');
+      setLogLevel(0);
+    }
+    if (options.command === 'interactive') {
+      await import('./interactive.mjs');
     } else {
-      Logger.info('已取消清理操作');
-    }
-    return;
-  }
-
-  // ========== 构建/调试操作 ==========
-  try {
-    // 读取应用配置
-    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 { runCommand } = await import('./run-command.mjs');
+      await runCommand(options);
     }
-    
-    // ========== 版本处理 ==========
-    // 自动递增版本号作为默认值
-    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: incrementedVersion,
-        validate: (input) => {
-          const _ipt = input || incrementedVersion;
-          return (!!_ipt && /^\d+(\.\d+){2}$/g.test(_ipt)) || '请输入正确的版本名称格式 (x.y.z)';
-        }
-      },
-    ]);
-
-    Logger.info(`用户选择:`);
-    Logger.info(`版本名称: ${versionName}`);
-
-    // ========== 更新应用配置 ==========
-    // 合并用户输入的版本号到应用信息中
-    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.version}`),
-      {
-        padding: 1,
-        margin: 1,
-        borderStyle: 'round',
-        borderColor: 'yellow'
-      }
-    ));
-
-    Logger.info('开始执行操作...');
-
-    // ========== 执行相应操作 ==========
-    switch (action) {
-      case ACTION_TYPES.MP_BUILD:
-        // 构建小程序包
-        await mpBuildShell(newAppInfo, isGodot);
-        break;
-      case ACTION_TYPES.MP_DEBUG:
-        // 启动真机调试服务器
-        await mpDebugShell(newAppInfo, isGodot);
-        break;
-      default:
-        Logger.error(`未知的操作类型: ${action}`);
-    }
-
-  } catch (error) {
-    Logger.error(`操作失败: ${error.message}`);
-    Logger.error(`错误详情: ${error.stack}`);
   }
+} catch (error) {
+  console.error(`htyf: ${error.message}`);
+  process.exitCode = 1;
 }
-
-// ========== 主程序入口 ==========
-// 显示欢迎信息
-console.log('\n' + boxen(
-  gradient.rainbow('🎯 红糖云服 应用 CLI 工具 v2.2.0') + '\n' +
-  chalk.gray('用于管理多应用项目的开发、构建和部署') + '\n' +
-  chalk.gray(`项目目录:`) + '\n\n' +
-  chalk.gray(`${projectPath}`) + '\n',
-  {
-    padding: 1,
-    margin: 1,
-    borderStyle: 'round',
-    borderColor: 'cyan'
-  }
-));
-
-// ========== 命令行参数处理 ==========
-
-// 处理调试模式参数
-if (process.argv.includes('--debug')) {
-  setLogLevel(LOG_LEVELS.DEBUG);
-  Logger.debug('调试模式已启用');
-}
-
-// 记录启动日志
-Logger.writeToFile('CLI 工具启动', 'INFO');
-
-// 处理依赖同步参数（命令行直接同步，不进入交互界面）
-if (process.argv.includes('--sync-deps')) {
-  await syncDepsShell({ skipConfirm: true });
-  process.exit(0);
-}
-
-// 处理清理参数（命令行直接清理，不进入交互界面）
-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.gray('  node index.mjs --sync-deps       # 同步依赖版本') + '\n\n' +
-    chalk.white('功能说明:') + '\n' +
-    chalk.gray('  🆕 初始化新小程序项目 - 创建新的小程序项目') + '\n' +
-    chalk.gray('  🔍 小程序打包 - 构建小程序包') + '\n' +
-    chalk.gray('  📦 小程序调试 - 启动真机调试服务') + '\n' +
-    chalk.gray('  🔄 同步依赖版本 - 将 package.json 依赖对齐 shared-output.json') + '\n' +
-    chalk.gray('  🧹 清理模式 - 清理临时文件') + '\n',
-    {
-      padding: 1,
-      margin: 1,
-      borderStyle: 'round',
-      borderColor: 'blue'
-    }
-  ));
-  process.exit(0);
-}
-
-inquirer
-  .prompt([
-    {
-      type: 'rawlist',
-      name: 'index',
-      message: '请选择你想要执行的操作：',
-      choices: [
-        { name: '🆕 初始化新小程序项目', value: ACTION_TYPES.INIT },
-        { name: '🔍 小程序 - 打包小程序', value: ACTION_TYPES.MP_BUILD },
-        { name: '📦 小程序 - 真机调试', value: ACTION_TYPES.MP_DEBUG },
-        { name: '🔄 同步依赖版本 - 对齐 shared-output.json', value: ACTION_TYPES.SYNC_DEPS },
-        { name: '🧹 清理模式 - 清理临时文件', value: ACTION_TYPES.CLEAN },
-        { name: '👋 退出', value: ACTION_TYPES.QUIT },
-      ],
-    },
-  ])
-  .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}`);
-    if (!isExiting) {
-      process.exit(1);
-    }
-  });

package/src/interactive.mjs

@@ -0,0 +1,303 @@
+#!/usr/bin/env node
+
+/**
+ * 红糖云服应用 CLI 工具主入口
+ *
+ * 功能：
+ * - 初始化新小程序项目
+ * - 小程序打包构建
+ * - 小程序真机调试
+ * - 清理临时文件
+ *
+ * 支持项目类型：
+ * - 普通小程序项目（使用 webpack 构建）
+ * - Godot 游戏项目（使用 Godot 导出工具）
+ *
+ * @author CLI Team
+ * @version 2.2.0
+ * @module index
+ */
+
+import inquirer from 'inquirer';
+import path from 'path';
+import chalk from 'chalk';
+import { requireCjs } from './cjs.mjs';
+
+const lodash = requireCjs('lodash');
+const fse = requireCjs('fs-extra');
+import boxen from 'boxen';
+import gradient from 'gradient-string';
+import { confirm } from '@inquirer/prompts';
+import { getProjectRoot } from './utils.mjs';
+import { Logger } from './logger.mjs';
+import { ACTION_TYPES } 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 { syncDepsShell } from './sync-deps.mjs';
+import { incrementVersion, updateAppConfig } from './utils-functions.mjs';
+
+const projectPath = getProjectRoot();
+
+// ========== 全局状态管理 ==========
+// 用于优雅退出，避免重复退出操作
+let isExiting = false;
+let currentProcess = null;
+
+/**
+ * 优雅退出处理函数
+ *
+ * 当收到退出信号（如 Ctrl+C）时：
+ * 1. 尝试关闭正在运行的进程
+ * 2. 延迟退出，给清理操作一些时间
+ * 3. 如果已经在退出中，强制退出
+ */
+function handleGracefulExit() {
+  if (isExiting) {
+    // 如果已经在退出中，强制退出
+    Logger.warn('强制退出...');
+    process.exit(1);
+  }
+
+  isExiting = true;
+  Logger.info('\n正在退出...');
+
+  // 如果有正在运行的进程，尝试关闭
+  if (currentProcess) {
+    try {
+      if (typeof currentProcess.close === 'function') {
+        currentProcess.close();
+      } else if (typeof currentProcess.kill === 'function') {
+        currentProcess.kill('SIGTERM');
+      }
+    } catch (error) {
+      Logger.debug(`关闭进程时出错: ${error.message}`);
+    }
+  }
+
+  // 延迟退出，给清理操作一些时间
+  setTimeout(() => {
+    Logger.info('再见!');
+    process.exit(0);
+  }, 100);
+}
+
+// ========== 注册全局信号处理 ==========
+// 使用 once 确保只注册一次
+// 注意：某些模块（如 debug.mjs）可能会移除这些监听器并添加自己的处理
+process.on('SIGINT', handleGracefulExit);   // Ctrl+C
+process.on('SIGTERM', handleGracefulExit);  // 终止信号
+
+/**
+ * 主启动函数
+ *
+ * 根据操作类型执行相应的功能：
+ * - MP_BUILD: 构建小程序包
+ * - MP_DEBUG: 启动真机调试服务器
+ * - CLEAN: 清理临时文件
+ * - QUIT: 退出程序
+ *
+ * @param {string} action - 操作类型（ACTION_TYPES 中的值）
+ */
+async function Start(action) {
+  const actionNames = {
+    [ACTION_TYPES.MP_BUILD]: '小程序构建',
+    [ACTION_TYPES.MP_DEBUG]: '小程序调试',
+    [ACTION_TYPES.SYNC_DEPS]: '同步依赖版本',
+    [ACTION_TYPES.CLEAN]: '清理模式',
+    [ACTION_TYPES.QUIT]: '退出'
+  };
+
+  Logger.info(`当前操作: ${actionNames[action] || '未知操作'}`);
+
+  // ========== 退出操作 ==========
+  if (action === ACTION_TYPES.QUIT) {
+    Logger.info('再见!');
+    return;
+  }
+
+  // ========== 同步依赖版本 ==========
+  if (action === ACTION_TYPES.SYNC_DEPS) {
+    await syncDepsShell();
+    return;
+  }
+
+  // ========== 清理操作 ==========
+  if (action === ACTION_TYPES.CLEAN) {
+    const { cleanType } = await inquirer.prompt([
+      {
+        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 (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 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) {
+      throw new Error('应用配置不存在，请先在app.json中配置htyf');
+    }
+
+    // ========== 版本处理 ==========
+    // 自动递增版本号作为默认值
+    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: incrementedVersion,
+        validate: (input) => {
+          const _ipt = input || incrementedVersion;
+          return (!!_ipt && /^\d+(\.\d+){2}$/g.test(_ipt)) || '请输入正确的版本名称格式 (x.y.z)';
+        }
+      },
+    ]);
+
+    Logger.info(`用户选择:`);
+    Logger.info(`版本名称: ${versionName}`);
+
+    // ========== 更新应用配置 ==========
+    // 合并用户输入的版本号到应用信息中
+    const newAppInfo = lodash.merge({}, appInfo, {
+      version: versionName,
+    });
+
+    // 更新 app.json 文件
+    if (!updateAppConfig(newAppInfo)) {
+      throw new Error('更新 app.json 失败');
+    }
+
+    // ========== 显示应用信息 ==========
+    console.log('\n' + boxen(
+      chalk.cyan('应用信息') + '\n\n' +
+      chalk.white('名称: ') + chalk.yellow(`${newAppInfo.name}`) + '\n' +
+      chalk.white('版本: ') + chalk.yellow(`${newAppInfo.version}`),
+      {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'yellow'
+      }
+    ));
+
+    Logger.info('开始执行操作...');
+
+    // ========== 执行相应操作 ==========
+    switch (action) {
+      case ACTION_TYPES.MP_BUILD:
+        // 构建小程序包
+        await mpBuildShell(newAppInfo, isGodot);
+        break;
+      case ACTION_TYPES.MP_DEBUG:
+        // 启动真机调试服务器
+        await mpDebugShell(newAppInfo, isGodot);
+        break;
+      default:
+        Logger.error(`未知的操作类型: ${action}`);
+    }
+
+  } catch (error) {
+    Logger.error(`操作失败: ${error.message}`);
+    Logger.error(`错误详情: ${error.stack}`);
+    process.exitCode = 1;
+  }
+}
+
+// ========== 主程序入口 ==========
+// 显示欢迎信息
+console.log('\n' + boxen(
+  gradient.rainbow('🎯 红糖云服 应用 CLI 工具 v2.2.0') + '\n' +
+  chalk.gray('用于管理多应用项目的开发、构建和部署') + '\n' +
+  chalk.gray(`项目目录:`) + '\n\n' +
+  chalk.gray(`${projectPath}`) + '\n',
+  {
+    padding: 1,
+    margin: 1,
+    borderStyle: 'round',
+    borderColor: 'cyan'
+  }
+));
+
+inquirer
+  .prompt([
+    {
+      type: 'rawlist',
+      name: 'index',
+      message: '请选择你想要执行的操作：',
+      choices: [
+        { name: '🆕 初始化新小程序项目', value: ACTION_TYPES.INIT },
+        { name: '🔍 小程序 - 打包小程序', value: ACTION_TYPES.MP_BUILD },
+        { name: '📦 小程序 - 真机调试', value: ACTION_TYPES.MP_DEBUG },
+        { name: '🔄 同步依赖版本 - 对齐 shared-output.json', value: ACTION_TYPES.SYNC_DEPS },
+        { name: '🧹 清理模式 - 清理临时文件', value: ACTION_TYPES.CLEAN },
+        { name: '👋 退出', value: ACTION_TYPES.QUIT },
+      ],
+    },
+  ])
+  .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}`);
+    if (!isExiting) {
+      process.exit(1);
+    }
+  });

package/src/project-initializer.mjs

@@ -1,7 +1,6 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
-import md5 from 'md5';
 import ora from 'ora';
 import { requireCjs } from './cjs.mjs';
 
@@ -27,7 +26,7 @@ export class ProjectInitializer {
     this.processor = new TemplateProcessor(this.config);
   }
 
-  async initialize() {
+  async initialize(options = {}) {
     const spinner = ora('正在初始化项目...');
     let tmpdir = null;
     let rootPath = null;
@@ -53,7 +52,10 @@ export class ProjectInitializer {
 
     try {
       // 1. 获取用户输入
-      const userInputs = await this.getUserInputs();
+      const userInputs = options.nonInteractive ? {
+        appName: options.name, displayName: options.displayName,
+        templateType: options.template, nonInteractive: true, repoType: CONSTANTS.TEMPLATE_REPOS.GITHUB
+      } : await this.getUserInputs();
 
       // 2. 验证输入
       const validation = this.validateInputs(userInputs);
@@ -61,8 +63,7 @@ export class ProjectInitializer {
         process.removeListener('SIGINT', handleExit);
         process.removeListener('SIGTERM', handleExit);
         spinner.fail('输入验证失败');
-        Logger.error(validation.error);
-        return;
+        throw new Error(validation.error);
       }
 
       // 3. 检查目录
@@ -71,8 +72,7 @@ export class ProjectInitializer {
         process.removeListener('SIGINT', handleExit);
         process.removeListener('SIGTERM', handleExit);
         spinner.fail('目录已存在');
-        Logger.error(`目录已存在: ${rootPath}`);
-        return;
+        throw new Error(`目录已存在: ${rootPath}`);
       }
 
       // 4. 创建项目（在此之前启动 spinner）
@@ -95,6 +95,8 @@ export class ProjectInitializer {
       process.removeListener('SIGTERM', handleExit);
       spinner.fail('项目初始化失败');
       Logger.error('初始化失败:', error.message);
+      if (options.nonInteractive) throw error;
+      process.exitCode = 1;
       if (error.exitCode === 128) {
         Logger.error('Error: 目录已经存在。');
       } else if (error.code === 'ENOTFOUND') {
@@ -151,6 +153,9 @@ export class ProjectInitializer {
   }
 
   validateInputs(inputs) {
+    if (!this.config.validateAppName(inputs.appName)) return { isValid: false, error: '应用目录名称格式无效' };
+    if (!this.config.validateDisplayName(inputs.displayName)) return { isValid: false, error: '应用名称需为 2–10 个中文、字母或数字' };
+    if (!Object.hasOwn(this.config.templates, inputs.templateType)) return { isValid: false, error: '模板类型无效' };
     const pathValidation = FileSystemUtils.validatePath(inputs.appName);
     if (!pathValidation.isValid) {
       return { isValid: false, error: pathValidation.error };
@@ -164,8 +169,7 @@ export class ProjectInitializer {
 
     // 创建临时目录
     spinner.text = '正在准备临时目录...';
-    const tmpdir = path.join(os.tmpdir(), md5('__HTYF__'), appName);
-    fse.emptyDirSync(tmpdir);
+    const tmpdir = fs.mkdtempSync(path.join(os.tmpdir(), 'htyf-init-'));
     
     // 设置临时目录引用，以便在退出时清理
     if (setTmpdirCallback) {
@@ -175,7 +179,7 @@ export class ProjectInitializer {
     try {
       // 克隆仓库
       spinner.text = '正在克隆模板仓库...';
-      await this.processor.cloneRepository(repoType, tmpdir);
+      await this.processor.cloneRepository(repoType, tmpdir, { nonInteractive: userInputs.nonInteractive });
 
       // 确定应用根路径
       const template = this.config.templates[templateType];
@@ -241,18 +245,9 @@ export class ProjectInitializer {
       // 移动到目标目录
       spinner.text = '正在创建项目目录...';
 
-      if (fs.existsSync(rootPath)) {
-        fse.ensureDirSync(rootPath);
-        const items = fs.readdirSync(appRootPath);
-        items.forEach((item) => {
-          const source = path.join(appRootPath, item);
-          const destination = path.join(rootPath, item);
-          fse.moveSync(source, destination, { overwrite: true });
-        });
-        fse.removeSync(appRootPath);
-      } else {
-        fse.moveSync(appRootPath, rootPath);
-      }
+      // 创建过程中目录可能被其他进程占用；同样拒绝覆盖。
+      if (fs.existsSync(rootPath)) throw new Error(`目录已存在: ${rootPath}`);
+      fse.moveSync(appRootPath, rootPath, { overwrite: false });
 
       // 清理临时目录
       fse.removeSync(tmpdir);
@@ -262,7 +257,7 @@ export class ProjectInitializer {
     } catch (error) {
       // 清理临时目录
       if (fs.existsSync(tmpdir)) {
-        // fse.removeSync(tmpdir);
+        fse.removeSync(tmpdir);
       }
       throw error;
     }

package/src/run-command.mjs

@@ -0,0 +1,46 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+export async function runCommand({ command, values, cleanType }) {
+  if (command === 'init') {
+    const { ProjectInitializer } = await import('./project-initializer.mjs');
+    return new ProjectInitializer().initialize({
+      nonInteractive: true, name: values.name,
+      displayName: values['display-name'], template: values.template
+    });
+  }
+  if (command === 'clean') {
+    const { cleanShell } = await import('./clean.mjs');
+    return cleanShell(cleanType);
+  }
+  if (command === 'sync-deps') {
+    const { syncDepsShell } = await import('./sync-deps.mjs');
+    return syncDepsShell({ skipConfirm: true });
+  }
+  const config = JSON.parse(fs.readFileSync('app.json', 'utf8'));
+  if (!config.htyf || typeof config.htyf !== 'object' || Array.isArray(config.htyf)) {
+    throw new Error('请先在 app.json 中配置 htyf');
+  }
+  const appInfo = { ...config.htyf, version: values.version || config.htyf.version };
+  if (!/^\d+\.\d+\.\d+$/.test(appInfo.version || '')) throw new Error('缺少有效版本，请指定 --version x.y.z');
+  const { CONSTANTS } = await import('./constants.mjs');
+  CONSTANTS.BUNDLE_PLATFORM = values.platform || 'ios';
+  const isGodot = fs.existsSync('project.godot');
+  const godot = {};
+  if (values['godot-bin']) godot.godotBin = path.resolve(values['godot-bin']);
+  if (values['godot-project']) godot.projectDir = path.resolve(values['godot-project']);
+  if (values['godot-preset']) godot.preset = values['godot-preset'];
+  const buildOptions = { nonInteractive: true, godot };
+  if (values.version) {
+    const { updateAppConfig } = await import('./utils-functions.mjs');
+    if (!updateAppConfig(appInfo)) throw new Error('更新 app.json 失败');
+  }
+  if (command === 'build') {
+    const { mpBuildShell } = await import('./build.mjs');
+    const artifact = await mpBuildShell(appInfo, isGodot, buildOptions);
+    console.log(`构建产物: ${artifact}`);
+    return;
+  }
+  const { mpDebugShell } = await import('./debug.mjs');
+  return mpDebugShell(appInfo, isGodot, buildOptions);
+}

package/src/sync-deps.mjs

@@ -72,13 +72,11 @@ export async function syncDepsShell(options = {}) {
   const packageJsonPath = path.join(projectPath, 'package.json');
 
   if (!fse.pathExistsSync(packageJsonPath)) {
-    Logger.error(`未找到 package.json: ${packageJsonPath}`);
-    return;
+    throw new Error(`未找到 package.json: ${packageJsonPath}`);
   }
 
   if (!fse.pathExistsSync(sharedOutputPath)) {
-    Logger.error(`未找到 shared-output.json: ${sharedOutputPath}`);
-    return;
+    throw new Error(`未找到 shared-output.json: ${sharedOutputPath}`);
   }
 
   const sharedVersions = fse.readJsonSync(sharedOutputPath);

package/src/template-processor.mjs

@@ -14,14 +14,15 @@ export class TemplateProcessor {
     this.config = config;
   }
 
-  async cloneRepository(repoUrl, tmpdir) {
+  async cloneRepository(repoUrl, tmpdir, options = {}) {
     Logger.info('正在克隆模板仓库...');
     Logger.debug(`仓库地址: ${repoUrl}`);
     Logger.debug(`目标目录: ${tmpdir}`);
     
     try {
       await execa('git', ['clone', '--depth', '1', repoUrl, tmpdir], {
-        timeout: 60000 // 60秒超时
+        timeout: 60000, // 60秒超时
+        ...(options.nonInteractive ? { env: { GIT_TERMINAL_PROMPT: '0', GCM_INTERACTIVE: 'never' } } : {})
       });
       Logger.success('模板仓库克隆完成');
     } catch (error) {