@yufengtadian/freedom-cli 1.1.10 → 1.1.11

package/README.md

@@ -1,10 +1,15 @@
 # freedom-cli
 
-Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.1.10）。
+Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.1.11）。
 
 基于自研 Freedom WebView 壳层（对标 Wails / Tauri）：前端完全自由、后端可任意语言、渲染复用系统 WebView（Windows WebView2 / macOS WKWebView / Linux WebKitGTK），产物为单个可执行文件 + resources 目录，前端页面内存加载，不占本地端口。
 
-**v1.1.10 核心升级**：不再依赖 Go 工具链。壳层以预编译二进制随 npm 包分发（`shell/<platform>/`），`freedom build` 直接复制壳 + 写入前端与配置即可出包，Windows / macOS / Linux 三平台一次全出，任意前后端语言自由组合。
+**v1.1.11 核心升级**：不再依赖 Go 工具链。壳层以预编译二进制随 npm 包分发（`shell/<platform>/`），`freedom build` 直接复制壳 + 写入前端与配置即可出包，Windows / macOS / Linux 三平台一次全出，任意前后端语言自由组合。
+
+**v1.1.11 新特性**：
+- `freedom tui` 交互式终端界面：菜单化完成打包 / 新建项目 / 修改配置 / 壳管理 / 教程，零依赖、方向键 + 回车导航、支持搜索过滤与多选；
+- 前端构建缓存：源码无改动时跳过重复 `vite build`（秒级复用，典型加速 10 倍+），`--no-cache` 强制全量重建；
+- 多平台分发并行化：`--platform all` 各平台同时复制分发，全平台打包耗时显著缩短。
 
 ## 安装
 
@@ -22,22 +27,28 @@ freedom init my-app
 cd my-app
 npm install
 
-# 2. 调整标题栏（可选，随时可改）
+# 2. 交互式终端界面（方向键 + 回车选择，q 返回）
+freedom tui
+
+# 3. 调整标题栏（可选，随时可改）
 freedom titlebar native      # 保留系统原生标题栏（默认）
 freedom titlebar hidden      # 隐藏标题栏视觉，仅保留 Windows 原生最小化/最大化/关闭按钮
 freedom titlebar frameless   # 完全无边框，按钮由前端自绘（模板已内置示例）
 
-# 3. 打包
+# 4. 打包
 freedom build                        # 默认当前平台
 freedom build --platform all         # 三平台全量（win + mac + linux）
 freedom build --platform win-x64     # 仅 Windows
 freedom build --platform mac-arm64   # 仅 macOS Apple Silicon
 freedom build --platform linux-x64   # 仅 Linux
+freedom build --no-cache             # 忽略前端构建缓存，强制重建
 ```
 
 构建产物默认输出到 `dist/`。`dist/<应用名>.exe`（或对应平台可执行文件）为壳层程序，运行时从 `dist/resources/` 加载前端页面与配置，不弹 cmd 黑窗。
 
-**三平台打包**：壳层二进制随包分发，无需本机安装 Go 或交叉编译工具链。首次构建某平台时若本地缺少对应壳二进制，CLI 自动从 GitHub Releases 下载（`freedom shell download <platform>` 可手动补齐）；仅当你想用本机 Go 工具链亲自编译壳时才需要 `freedom shell build`（只产出本机平台）。
+**构建缓存**：CLI 会在 `.freedom/vite-dist/` 记录前端源码指纹，源码无改动时复用上次构建产物直接进入分发阶段（秒级完成）。修改了 `src/` / `index.html` / `vite.config.js` 等任一处会触发自动重建；需要强制全量时可加 `--no-cache`。
+
+**三平台打包**：壳层二进制随包分发，无需本机安装 Go 或交叉编译工具链。首次构建某平台时若本地缺少对应壳二进制，CLI 自动从 GitHub Releases 下载（`freedom shell download <platform>` 可手动补齐）；仅当你想用本机 Go 工具链亲自编译壳时才需要 `freedom shell build`（只产出本机平台）。多平台分发为并行执行，全平台打包耗时大幅缩短。
 
 产物目录可在 `freedom.config.js` 的 `outDir` 中调整：默认 `'dist'`，设为 `'.'` 则直接输出到项目根目录（dist 的上级），设为任意相对 / 绝对路径亦可。输出到项目根目录时会自动跳过 `index.html` 副本，避免覆盖项目源文件。
 
@@ -92,8 +103,9 @@ window.freedom.window.minimize();                       // 窗口控制
 ## 命令
 
 ```
+freedom tui                          # 交互式终端界面
 freedom init <目录> [--force]
-freedom build [--platform win-x64|mac-arm64|linux-x64|all]
+freedom build [--platform win-x64|mac-arm64|linux-x64|all] [--no-cache]
 freedom titlebar <native|hidden|frameless>
 freedom config [get|set]
 freedom shell list|download <platform>|build <platform>

package/lib/build.js

@@ -16,6 +16,7 @@
 // 可跨平台分发、无需在目标机器安装任何语言运行时。
 
 const fs = require('fs');
+const fsp = fs.promises;
 const path = require('path');
 const { spawnSync } = require('child_process');
 const { copyDir } = require('./utils');
@@ -73,11 +74,17 @@ async function build(projectDir, opts = {}) {
   const platforms = parsePlatforms(opts.platform);
   const autoDownload = opts.autoDownload !== false;
 
-  // 1) 前端打包
+  // 1) 前端打包（带缓存：源码未变更时复用上次 vite 产物，跳过 npm run build）
   ensureNodeModules(dir);
-  const vite = run('npm', ['run', 'build'], { cwd: dir });
-  if (vite.status !== 0) {
-    throw new Error(`前端打包失败：\n${vite.stdout}\n${vite.stderr}`);
+  const useCache = opts.noCache !== true;
+  if (useCache && !viteNeedsRebuild(dir)) {
+    process.stdout.write('[freedom] 前端源码无改动，复用构建缓存...\n');
+  } else {
+    const vite = run('npm', ['run', 'build'], { cwd: dir });
+    if (vite.status !== 0) {
+      throw new Error(`前端打包失败：\n${vite.stdout}\n${vite.stderr}`);
+    }
+    writeViteCacheMarker(dir);
   }
   const distHtml = path.join(dir, '.freedom', 'vite-dist', 'index.html');
   if (!fs.existsSync(distHtml)) {
@@ -90,15 +97,16 @@ async function build(projectDir, opts = {}) {
   const backendDir = path.join(dir, cfg.backendDir || 'backend');
   const hasBackend = !!(cfg.backend && fs.existsSync(backendDir));
 
-  // 3) 逐平台分发
+  // 3) 逐平台分发（多平台并行，显著缩短全平台打包耗时）
   // 单平台直接输出到 outDir；多平台各自放到 outDir/<plat>/ 子目录，避免互相覆盖
   const multi = platforms.length > 1;
-  const results = [];
-  for (const plat of platforms) {
-    const targetDir = multi ? path.join(outDirPath, plat) : outDirPath;
-    const outFile = await emitPlatform({ plat, name, targetDir, html, configJSON, backendDir, hasBackend, autoDownload });
-    results.push({ plat, outFile });
-  }
+  const results = await Promise.all(
+    platforms.map(async (plat) => {
+      const targetDir = multi ? path.join(outDirPath, plat) : outDirPath;
+      const outFile = await emitPlatform({ plat, name, targetDir, html, configJSON, backendDir, hasBackend, autoDownload });
+      return { plat, outFile };
+    })
+  );
 
   return { results };
 }
@@ -117,21 +125,21 @@ async function emitPlatform({ plat, name, targetDir, html, configJSON, backendDi
     await downloadShell(plat);
   }
 
-  fs.mkdirSync(targetDir, { recursive: true });
+  await fsp.mkdir(targetDir, { recursive: true });
 
   // 壳二进制 -> 应用可执行文件
   const exeName = platformExeName(plat, name);
   const outFile = path.join(targetDir, exeName);
-  fs.copyFileSync(shell, outFile);
+  await fsp.copyFile(shell, outFile);
   if (!isWinPlat(plat)) {
-    fs.chmodSync(outFile, 0o755);
+    await fsp.chmod(outFile, 0o755);
   }
 
   // 写 resources：页面 + 配置 + 后端
   const resDir = path.join(targetDir, 'resources');
-  fs.mkdirSync(resDir, { recursive: true });
-  fs.writeFileSync(path.join(resDir, 'index.html'), html, 'utf8');
-  fs.writeFileSync(path.join(resDir, 'config.json'), configJSON, 'utf8');
+  await fsp.mkdir(resDir, { recursive: true });
+  await fsp.writeFile(path.join(resDir, 'index.html'), html, 'utf8');
+  await fsp.writeFile(path.join(resDir, 'config.json'), configJSON, 'utf8');
   if (hasBackend) {
     copyDir(backendDir, path.join(resDir, 'backend'));
   }
@@ -164,6 +172,63 @@ function renderConfigJSON(cfg, name) {
   return JSON.stringify(obj, null, 2);
 }
 
+// ---- 前端构建缓存 ----
+// 追踪影响前端产物的源文件（index.html / vite.config.* / src/**）的最新 mtime，
+// 与上次 vite build 记录值比较：未变更则跳过 npm run build，直接复用 .freedom/vite-dist 产物。
+
+function collectViteSources(dir) {
+  const files = [];
+  const roots = ['index.html', 'vite.config.js', 'vite.config.mjs', 'vite.config.ts', 'vite.config.cjs'];
+  for (const r of roots) {
+    const p = path.join(dir, r);
+    if (fs.existsSync(p)) files.push(p);
+  }
+  const src = path.join(dir, 'src');
+  if (fs.existsSync(src)) {
+    const walk = (d) => {
+      for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
+        const p = path.join(d, entry.name);
+        if (entry.isDirectory()) walk(p);
+        else files.push(p);
+      }
+    };
+    walk(src);
+  }
+  return files;
+}
+
+function maxMtime(files) {
+  return files.reduce((m, f) => {
+    try {
+      const t = fs.statSync(f).mtimeMs;
+      return t > m ? t : m;
+    } catch (e) {
+      return m;
+    }
+  }, 0);
+}
+
+function viteCacheMarker(dir) {
+  return path.join(dir, '.freedom', 'vite-dist', '.cache-mtime');
+}
+
+function viteNeedsRebuild(dir) {
+  const distHtml = path.join(dir, '.freedom', 'vite-dist', 'index.html');
+  const marker = viteCacheMarker(dir);
+  if (!fs.existsSync(distHtml) || !fs.existsSync(marker)) return true;
+  let recorded = 0;
+  try {
+    recorded = Number(fs.readFileSync(marker, 'utf8'));
+  } catch (e) { return true; }
+  // 留 1s 容差避免文件系统时间精度抖动
+  return maxMtime(collectViteSources(dir)) > recorded + 1000;
+}
+
+function writeViteCacheMarker(dir) {
+  fs.mkdirSync(path.join(dir, '.freedom', 'vite-dist'), { recursive: true });
+  fs.writeFileSync(viteCacheMarker(dir), String(maxMtime(collectViteSources(dir))), 'utf8');
+}
+
 function ensureNodeModules(dir) {
   // 缺陷修复：node_modules 存在但 package.json 更新过（依赖变更）时自动重装。
   const pkgFile = path.join(dir, 'package.json');

package/lib/cli.js

@@ -14,9 +14,11 @@ function help() {
 freedom - Freedom 桌面壳打包工具 v${VERSION}
 
 用法：
+  freedom tui                           进入交互式 TUI 界面（新建/打包/配置/壳管理）
   freedom init [目录] [--force]        在当前/指定目录新建项目模板
   freedom build [--platform <p>]       前端打包并分发桌面应用（默认当前平台）
       --platform win|mac|linux|all     指定目标平台（all = 三平台全量）
+      --no-cache                       忽略前端构建缓存，强制重新打包
   freedom titlebar <native|hidden|frameless>
                                        一键切换标题栏策略
   freedom shell list                   列出本地已就绪的预编译壳
@@ -56,6 +58,9 @@ async function run(argv) {
       console.log(VERSION);
       return 0;
 
+    case 'tui':
+      return await require('./tui').tui(process.cwd());
+
     case 'init': {
       const force = rest.includes('--force');
       const dirArg = rest.filter((a) => a !== '--force')[0];
@@ -74,7 +79,7 @@ async function run(argv) {
       if (platArg) {
         platform = platArg.includes('=') ? platArg.split('=')[1] : rest[rest.indexOf(platArg) + 1];
       }
-      const { results } = await build(process.cwd(), { platform });
+      const { results } = await build(process.cwd(), { platform, noCache: rest.includes('--no-cache') });
       for (const r of results) {
         console.log(`[freedom] [${r.plat}] 构建完成：${r.outFile}`);
       }

package/lib/tui.js

@@ -0,0 +1,331 @@
+'use strict';
+
+// freedom tui —— 零依赖 ANSI 终端交互界面
+// 纯 Node 标准库（readline + ANSI escape）实现，无第三方依赖，安装即用。
+
+const path = require('path');
+const readline = require('readline');
+const { init } = require('./init');
+const { build } = require('./build');
+const { setConfig, showConfig } = require('./config');
+const { tutorialFile, hasConfig, ALL_PLATFORMS } = require('./utils');
+
+// ---------------- ANSI ----------------
+const ESC = '\x1b';
+const C = {
+  reset: `${ESC}[0m`, bold: `${ESC}[1m`, dim: `${ESC}[2m`, rev: `${ESC}[7m`, underline: `${ESC}[4m`,
+  fgRed: `${ESC}[31m`, fgGreen: `${ESC}[32m`, fgYellow: `${ESC}[33m`,
+  fgCyan: `${ESC}[36m`, fgMagenta: `${ESC}[35m`, fgWhite: `${ESC}[37m`, fgGray: `${ESC}[90m`,
+};
+const CLEAR = `${ESC}[2J${ESC}[H`;
+const HIDE = `${ESC}[?25l`;
+const SHOW = `${ESC}[?25h`;
+
+function line(content, color = '') {
+  return color + content + C.reset;
+}
+
+class TUI {
+  constructor() {
+    this.out = process.stdout;
+    this.in = process.stdin;
+    this.active = false;
+    this.keyHandler = null;
+  }
+
+  enter() {
+    if (this.active) return;
+    this.active = true;
+    this.in.setRawMode(true);
+    this.in.resume();
+    this.in.setEncoding('utf8');
+    readline.emitKeypressEvents(this.in);
+    this.in.on('keypress', this._onKey);
+    this.out.write(HIDE + CLEAR);
+  }
+
+  exit() {
+    if (!this.active) return;
+    this.active = false;
+    this.in.removeListener('keypress', this._onKey);
+    try { this.in.setRawMode(false); } catch (e) { /* ignore */ }
+    this.in.pause();
+    this.out.write(SHOW + CLEAR);
+  }
+
+  _onKey = (str, key) => {
+    if (this.keyHandler) this.keyHandler(str, key);
+  };
+
+  _waitKey() {
+    return new Promise((resolve) => {
+      const done = (str, key) => {
+        this.keyHandler = null;
+        resolve({ str, key });
+      };
+      this.keyHandler = done;
+    });
+  }
+
+  _renderFrame(title, bodyLines, footer) {
+    const w = this.out.columns || 80;
+    const top = `  ${C.fgCyan}${C.bold}┌${'─'.repeat(Math.max(10, w - 6))}┐${C.reset}`;
+    const titleMid = `  ${C.fgCyan}${C.bold}│${C.reset}${C.fgWhite}${C.bold} ${title}${C.reset}`;
+    const bottom = `  ${C.fgCyan}${C.bold}└${'─'.repeat(Math.max(10, w - 6))}┘${C.reset}`;
+    const pad = (s) => `  ${s}`;
+    const lines = [
+      '',
+      `  ${C.fgCyan}${C.bold}▚  F R E E D O M   T U I   ${C.fgGray}v1.1.10${C.reset}`,
+      '',
+      top,
+      pad(titleMid),
+      ...bodyLines.map((l) => pad(typeof l === 'string' ? l : l.text)),
+      bottom,
+      '',
+      pad(footer ? C.fgGray + footer + C.reset : ''),
+      '',
+    ];
+    this.out.write(CLEAR + lines.join('\n'));
+  }
+
+  // 单选菜单：返回选中下标；null = 取消（q/Esc）
+  async menu(title, items, { selected = 0, footer = '↑ ↓ 选择 · Enter 确认 · q 返回' } = {}) {
+    let idx = selected;
+    const draw = () => {
+      const body = items.map((it, i) => {
+        if (i === idx) return { text: ` ${C.fgCyan}${C.rev} ▶ ${it} ${C.reset}` };
+        return `   ${C.fgGray}${it}${C.reset}`;
+      });
+      this._renderFrame(title, body, footer);
+    };
+    draw();
+    for (;;) {
+      const { key } = await this._waitKey();
+      if (key.name === 'up' || key.sequence === '\x1b[A') idx = (idx - 1 + items.length) % items.length;
+      else if (key.name === 'down' || key.sequence === '\x1b[B') idx = (idx + 1) % items.length;
+      else if (key.name === 'return') return idx;
+      else if (key.name === 'q' || key.name === 'escape') return null;
+      draw();
+    }
+  }
+
+  // 多选：Space 切换，Enter 确认，返回选中的下标数组
+  async multiselect(title, items, { checked = [], footer = '↑ ↓ 移动 · 空格 勾选 · Enter 确认 · q 返回' } = {}) {
+    let idx = 0;
+    const sel = new Set(checked);
+    const draw = () => {
+      const body = items.map((it, i) => {
+        const mark = sel.has(i) ? `${C.fgGreen}${C.bold}●${C.reset}` : `${C.fgGray}○${C.reset}`;
+        const cursor = i === idx ? `${C.fgCyan}▶${C.reset}` : ' ';
+        const txt = i === idx ? `${C.rev} ${it} ${C.reset}` : it;
+        return { text: ` ${cursor} ${mark} ${txt}` };
+      });
+      this._renderFrame(title, body, footer);
+    };
+    draw();
+    for (;;) {
+      const { key } = await this._waitKey();
+      if (key.name === 'up' || key.sequence === '\x1b[A') idx = (idx - 1 + items.length) % items.length;
+      else if (key.name === 'down' || key.sequence === '\x1b[B') idx = (idx + 1) % items.length;
+      else if (key.name === 'space') {
+        if (sel.has(idx)) sel.delete(idx); else sel.add(idx);
+      } else if (key.name === 'return') return [...sel].sort((a, b) => a - b);
+      else if (key.name === 'q' || key.name === 'escape') return null;
+      draw();
+    }
+  }
+
+  // 文本输入：返回字符串；null = 取消
+  async input(title, { initial = '', footer = '输入后回车确认 · Esc 取消' } = {}) {
+    let buf = initial;
+    const draw = () => {
+      this._renderFrame(title, [
+        { text: ' ' + C.fgYellow + '> ' + C.fgWhite + buf + (C.fgCyan + '▌' + C.reset) },
+        '',
+        { text: C.fgGray + '（自由填写，回车确认）' + C.reset },
+      ], footer);
+    };
+    draw();
+    for (;;) {
+      const { str, key } = await this._waitKey();
+      if (key.name === 'return') return buf;
+      if (key.name === 'escape' || key.name === 'q') return null;
+      if (key.name === 'backspace') buf = buf.slice(0, -1);
+      else if (str && str.length === 1) buf += str;
+      draw();
+    }
+  }
+
+  // 确认：返回 bool
+  async confirm(title, { footer = '← → 选择 · Enter 确认' } = {}) {
+    const yes = await this.menu(title, ['是', '否'], { footer });
+    return yes === 0;
+  }
+
+  // 消息：按任意键继续
+  async message(title, bodyLines, { footer = '按任意键继续' } = {}) {
+    this._renderFrame(title, bodyLines, footer);
+    await this._waitKey();
+  }
+
+  // 切换出 TUI 执行任务（任务输出直接走终端），完成后回到 TUI
+  async runTask(fn) {
+    this.exit();
+    try {
+      await fn();
+    } catch (e) {
+      console.error(`${C.fgRed}[freedom]${C.reset} 任务失败：${e.message}`);
+    }
+    this.enter();
+  }
+}
+
+// ---------------- 主流程 ----------------
+
+const CONFIG_KEYS = [
+  ['name', '应用名 / 窗口标题 / exe 文件名'],
+  ['width', '窗口宽度'],
+  ['height', '窗口高度'],
+  ['minWidth', '窗口最小宽度'],
+  ['minHeight', '窗口最小高度'],
+  ['center', '启动居中（true/false）'],
+  ['debug', '开发者工具（true/false）'],
+  ['titlebar', '标题栏：native | hidden | frameless'],
+  ['outDir', '产物目录：dist（默认）| .（项目根）| 任意路径'],
+  ['backend', '任意语言后端进程（JSON）'],
+];
+
+function openBrowser(file) {
+  const { spawn } = require('child_process');
+  const plat = process.platform;
+  const url = `file://${file.replace(/\\/g, '/')}`;
+  try {
+    if (plat === 'win32') spawn('cmd', ['/c', 'start', '', url], { detached: true, stdio: 'ignore' }).unref();
+    else if (plat === 'darwin') spawn('open', [url], { detached: true, stdio: 'ignore' }).unref();
+    else spawn('xdg-open', [url], { detached: true, stdio: 'ignore' }).unref();
+  } catch (e) { /* ignore */ }
+}
+
+async function buildFlow(tui, cwd) {
+  // 平台多选：默认勾选当前平台
+  const native = require('./utils').nativePlatform();
+  const checked = [ALL_PLATFORMS.indexOf(native)];
+  const picked = await tui.multiselect('选择目标平台（多选）', ALL_PLATFORMS, { checked });
+  if (picked === null) return;
+  const platforms = picked.map((i) => ALL_PLATFORMS[i]);
+  const platArg = picked.length === ALL_PLATFORMS.length ? 'all' : platforms.join(',');
+
+  await tui.runTask(async () => {
+    const { results } = await build(cwd, { platform: platArg });
+    for (const r of results) {
+      console.log(`${C.fgGreen}[freedom]${C.reset} [${r.plat}] 构建完成：${r.outFile}`);
+    }
+  });
+}
+
+async function initFlow(tui, cwd) {
+  const name = await tui.input('新建项目', { initial: '' });
+  if (name === null) return;
+  const dir = await tui.runTask(() => {
+    const d = init(name || '.', { force: false });
+    console.log(`${C.fgGreen}[freedom]${C.reset} 项目已创建：${d}`);
+    console.log(`  cd ${d} && npm install && freedom build`);
+  });
+  void dir;
+}
+
+async function configFlow(tui, cwd) {
+  for (;;) {
+    if (!hasConfig(cwd)) {
+      await tui.message('配置', [{ text: C.fgRed + ' 未找到 freedom.config.js，请先创建项目。' + C.reset }]);
+      return;
+    }
+    const names = ['查看当前配置', ...CONFIG_KEYS.map((k) => k[0]), '返回'];
+    const idx = await tui.menu('修改配置', names);
+    if (idx === null || idx === names.length - 1) return;
+    if (idx === 0) {
+      const cfgText = await showConfig(cwd);
+      await tui.message('当前配置', cfgText.split('\n').map((l) => ({ text: l })));
+      continue;
+    }
+    const [key, desc] = CONFIG_KEYS[idx - 1];
+    const val = await tui.input(`${key}`, { initial: '' });
+    if (val === null) continue;
+    setConfig(cwd, key, coerce(val));
+    await tui.message('配置', [{ text: C.fgGreen + `  ${key} = ${val}` + C.reset }]);
+  }
+}
+
+async function shellFlow(tui) {
+  const { listLocal, downloadShell, buildShell } = require('./shell');
+  for (;;) {
+    const items = ['查看已就绪壳', '下载壳', '本地编译壳', '返回'];
+    const idx = await tui.menu('壳管理', items);
+    if (idx === null || idx === items.length - 1) return;
+
+    if (idx === 0) {
+      const ready = listLocal();
+      const rows = ready.length
+        ? ready.map((p) => ({ text: C.fgGreen + `  ✓ ${p}` + C.reset }))
+        : [{ text: C.fgGray + '  暂无已就绪壳' + C.reset }];
+      await tui.message('已就绪壳', rows);
+    } else if (idx === 1) {
+      const p = await tui.menu('选择要下载的壳平台', ALL_PLATFORMS);
+      if (p === null) continue;
+      await tui.runTask(async () => {
+        const dest = await downloadShell(ALL_PLATFORMS[p]);
+        console.log(`${C.fgGreen}[freedom]${C.reset} 已下载 ${ALL_PLATFORMS[p]} 壳：${dest}`);
+      });
+    } else {
+      const p = await tui.menu('选择要编译的壳平台（需 Go 且仅本机平台）', ALL_PLATFORMS);
+      if (p === null) continue;
+      await tui.runTask(async () => {
+        const dest = buildShell(ALL_PLATFORMS[p]);
+        console.log(`${C.fgGreen}[freedom]${C.reset} 已编译 ${ALL_PLATFORMS[p]} 壳：${dest}`);
+      });
+    }
+  }
+}
+
+async function tutorialFlow(tui) {
+  const file = tutorialFile();
+  openBrowser(file);
+  await tui.message('教程', [{ text: C.fgGreen + `  已打开：${file}` + C.reset }]);
+}
+
+function coerce(value) {
+  if (value === 'true') return true;
+  if (value === 'false') return false;
+  const num = Number(value);
+  if (value !== '' && Number.isFinite(num) && String(num) === value.trim()) return num;
+  return value;
+}
+
+async function tui(cwd) {
+  if (!process.stdin.isTTY) {
+    console.error('[freedom] tui 需要交互式终端，请直接在本机终端中运行 freedom tui。');
+    return 1;
+  }
+  const app = new TUI();
+  app.enter();
+  let keep = true;
+  while (keep) {
+    const items = ['打包桌面应用', '新建项目', '修改配置', '壳管理', '打开教程', '退出'];
+    const idx = await app.menu('主菜单', items, {
+      footer: `工作目录：${cwd}   ↑ ↓ 选择 · Enter 确认 · q 退出`,
+    });
+    if (idx === null) break;
+    switch (idx) {
+      case 0: await buildFlow(app, cwd); break;
+      case 1: await initFlow(app, cwd); break;
+      case 2: await configFlow(app, cwd); break;
+      case 3: await shellFlow(app); break;
+      case 4: await tutorialFlow(app); break;
+      case 5: keep = false; break;
+    }
+  }
+  app.exit();
+  return 0;
+}
+
+module.exports = { tui, TUI };

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "@yufengtadian/freedom-cli",
-  "version": "1.1.10",
+  "version": "1.1.11",
   "description": "Freedom WebView desktop shell packaging tool - no Go toolchain required, one command packs three-platform desktop apps",
   "keywords": ["desktop", "webview", "electron-alternative", "wails", "tauri", "frontend", "cross-platform"],
   "license": "MIT",