@yufengtadian/freedom-cli 1.1.10 → 1.10.12

package/README.md

@@ -1,10 +1,33 @@
+---
+AIGC:
+    Label: "1"
+    ContentProducer: 001191440300708461136T1XGW3
+    ProduceID: 84e692d233baf4c4ebb909c06f044dd3_70353d809c3a11f19bec525400826444
+    ReservedCode1: F+Qlzocu3qufDKwdTzizi2zKAc4B1PeLnx1QG2eBbCzoFNe8VCjjy7ZVan5+wjHbBQrGtKwJC6zkKzoSrFUq7Gv3XMiE7j3v8hF+C7Tmpw0ziqQdD/JCj6m6KXkxPjJqrRK2gF51x03qxPXi6Wsiye+vID13w/vsTmLretYS7o5/4Aagvd1xxvh/i3k=
+    ContentPropagator: 001191440300708461136T1XGW3
+    PropagateID: 84e692d233baf4c4ebb909c06f044dd3_70353d809c3a11f19bec525400826444
+    ReservedCode2: F+Qlzocu3qufDKwdTzizi2zKAc4B1PeLnx1QG2eBbCzoFNe8VCjjy7ZVan5+wjHbBQrGtKwJC6zkKzoSrFUq7Gv3XMiE7j3v8hF+C7Tmpw0ziqQdD/JCj6m6KXkxPjJqrRK2gF51x03qxPXi6Wsiye+vID13w/vsTmLretYS7o5/4Aagvd1xxvh/i3k=
+---
+
 # freedom-cli
 
-Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.1.10）。
+Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.10.12）。
 
 基于自研 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.10.12 核心升级**：macOS 产物升级为标准 .app 应用包，直接产出 `.app.zip`（mac 用户解压即得 `.app`，拖入 /Applications 即可使用）；在 macOS 上执行 `freedom dmg` 可再用系统 hdiutil 生成 `.dmg`。全程仍不依赖 Go 工具链。
+
+**v1.1.11 核心升级**：不再依赖 Go 工具链。壳层以预编译二进制随 npm 包分发（`shell/<platform>/`），`freedom build` 直接复制壳 + 写入前端与配置即可出包，Windows / macOS / Linux 三平台一次全出，任意前后端语言自由组合。
+
+**v1.10.12 新特性**：
+- macOS 产物打包为标准 `.app` bundle + `.app.zip`：壳复制进 `Contents/MacOS/`，resources 与前端/后端随包，解压即用，无需任何语言运行时；
+- `freedom dmg`：在 macOS 上用系统 hdiutil 把 `.app` 打成 `.dmg`（Windows / Linux 上运行会给出指引）；
+- TUI 壳管理去 Go 依赖感：「下载壳」标注无需 Go，「本地编译壳」明确为可选项（壳已预编译随包分发）。
+
+**v1.1.11 新特性**：
+- `freedom tui` 交互式终端界面：菜单化完成打包 / 新建项目 / 修改配置 / 壳管理 / 教程，零依赖、方向键 + 回车导航、支持搜索过滤与多选；
+- 前端构建缓存：源码无改动时跳过重复 `vite build`（秒级复用，典型加速 10 倍+），`--no-cache` 强制全量重建；
+- 多平台分发并行化：`--platform all` 各平台同时复制分发，全平台打包耗时显著缩短。
 
 ## 安装
 
@@ -22,22 +45,42 @@ 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`（只产出本机平台）。
+**macOS 产物（v1.10.12）**：`freedom build --platform mac` 除裸可执行文件外，额外生成标准 `.app` bundle 与 `<应用名>-<平台>.app.zip`：
+
+```
+dist/<应用名>.app/
+└── Contents/
+    ├── Info.plist
+    ├── MacOS/
+    │   ├── <应用名>            # 壳可执行文件
+    │   └── resources/          # 前端页面 + config.json + backend/
+    └── Resources/
+```
+
+mac 用户解压 `.app.zip` 即得 `.app`，拖入 `/Applications` 即可直接运行，无需安装任何语言运行时。如需 `.dmg` 安装映像，把产物拷到 macOS 上执行 `freedom dmg`（用系统 hdiutil 生成），或仅分发包内 `.app.zip`。
+
+**构建缓存**：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` 副本，避免覆盖项目源文件。
 
@@ -88,15 +131,18 @@ window.freedom.window.minimize();                       // 窗口控制
 - Node.js >= 18
 - 不需要 Go 工具链（壳层为随包分发的预编译二进制）
 - 可选：`freedom shell build` 需本机 Go（含 CGO，Windows 需 MSVC 编译环境），仅用于亲自编译壳
+- `.dmg` 打包需在 macOS 上执行（依赖系统 hdiutil）；`.app.zip` 在任意平台均可直接产出
 
 ## 命令
 
 ```
+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>
+freedom dmg [--platform <plat>]      # 在 macOS 上把 .app 打包为 .dmg
 freedom tutorial
 freedom help
 ```
@@ -123,3 +169,4 @@ export default {
 ## License
 
 MIT
+*（内容由AI生成，仅供参考）*

package/lib/build.js

@@ -11,17 +11,24 @@
 //      - 写 resources/config.json（窗口 + 后端配置，壳运行时读取）
 //      - 复制壳为 outDir/<app>[.exe]
 //      - 复制 backend/ 到 resources/backend/（配置了 backend 时）
+//   4. macOS 平台额外生成 .app bundle + .app.zip：
+//      outDir/<app>.app/Contents/{Info.plist, MacOS/<app>, MacOS/resources/}
+//      壳加载 exe 同目录 resources/，因此 .app 无需改壳即可运行；
+//      mac 用户解压 .app.zip 得 .app，拖入 /Applications 即可使用；
+//      如需 .dmg，在 macOS 上运行 freedom dmg 用系统 hdiutil 生成。
 //
 // 产物不嵌入 HTML，页面与配置均在 exe 同目录 resources/ 下，因此壳可复用、
 // 可跨平台分发、无需在目标机器安装任何语言运行时。
 
 const fs = require('fs');
+const fsp = fs.promises;
 const path = require('path');
 const { spawnSync } = require('child_process');
 const { copyDir } = require('./utils');
 const {
   ALL_PLATFORMS,
   isWinPlat,
+  isMacPlat,
   platformExeName,
   nativePlatform,
   localShellPath,
@@ -68,16 +75,23 @@ async function build(projectDir, opts = {}) {
   const cfg = await loadConfig(dir);
 
   const name = (cfg.name || 'freedom-app').replace(/[^a-zA-Z0-9_.-]/g, '-');
+  const version = String(cfg.version || appVersionFromPkg(dir) || '1.0.0');
   const outDir = String(cfg.outDir || 'dist').trim() || 'dist';
   const outDirPath = path.resolve(dir, outDir);
   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,20 +104,21 @@ 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, version, targetDir, html, configJSON, backendDir, hasBackend, autoDownload });
+      return { plat, outFile };
+    })
+  );
 
   return { results };
 }
 
-async function emitPlatform({ plat, name, targetDir, html, configJSON, backendDir, hasBackend, autoDownload }) {
+async function emitPlatform({ plat, name, version, targetDir, html, configJSON, backendDir, hasBackend, autoDownload }) {
   // 取预编译壳二进制
   const shell = localShellPath(plat);
   if (!fs.existsSync(shell)) {
@@ -117,28 +132,125 @@ 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'));
   }
 
+  // macOS：额外生成 .app bundle + .app.zip（供 mac 用户解压即用）
+  // 壳加载 exe 同目录 resources/，故把 resources 放进 Contents/MacOS/ 即可运行，无需改壳。
+  if (isMacPlat(plat)) {
+    const appZip = createMacApp({ targetDir, name, plat, exeName, resDir, version });
+    process.stdout.write(
+      `[freedom] macOS 产物已打包为 .app.zip：${path.relative(process.cwd(), appZip)}\n`
+    );
+  }
+
   return outFile;
 }
 
+// 把已分发的裸产物升级为标准 .app bundle，并压缩为 .app.zip
+function createMacApp({ targetDir, name, plat, exeName, resDir, version }) {
+  const appDir = path.join(targetDir, `${name}.app`);
+  const contents = path.join(appDir, 'Contents');
+  const macos = path.join(contents, 'MacOS');
+  const appRes = path.join(macos, 'resources');
+  fs.mkdirSync(macos, { recursive: true });
+  fs.mkdirSync(path.join(contents, 'Resources'), { recursive: true });
+
+  // 可执行文件：exe 名与 app 同名，放入 MacOS/
+  const exeDst = path.join(macos, name);
+  fs.copyFileSync(path.join(targetDir, exeName), exeDst);
+  fs.chmodSync(exeDst, 0o755);
+
+  // resources -> MacOS/resources（壳的运行时目录）
+  if (fs.existsSync(resDir)) {
+    copyDir(resDir, appRes);
+  }
+
+  // Info.plist
+  fs.writeFileSync(path.join(contents, 'Info.plist'), renderInfoPlist(name, version), 'utf8');
+
+  // .app.zip：解压即得 .app，拖入 /Applications 即可使用
+  const zipPath = path.join(targetDir, `${name}-${plat}.app.zip`);
+  zipDir(zipPath, appDir);
+  return zipPath;
+}
+
+function renderInfoPlist(name, version) {
+  const safe = String(name).replace(/&/g, '&amp;');
+  const bundleId = `com.freedom.app.${String(name).toLowerCase().replace(/[^a-z0-9.-]/g, '-')}`;
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>${safe}</string>
+  <key>CFBundleDisplayName</key>
+  <string>${safe}</string>
+  <key>CFBundleExecutable</key>
+  <string>${safe}</string>
+  <key>CFBundleIdentifier</key>
+  <string>${bundleId}</string>
+  <key>CFBundleVersion</key>
+  <string>${version}</string>
+  <key>CFBundleShortVersionString</key>
+  <string>${version}</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>LSMinimumSystemVersion</key>
+  <string>10.13</string>
+  <key>NSHighResolutionCapable</key>
+  <true/>
+  <key>NSAppTransportSecurity</key>
+  <dict>
+    <key>NSAllowsArbitraryLoads</key>
+    <true/>
+  </dict>
+</dict>
+</plist>
+`;
+}
+
+// 用系统 tar（Windows 为 bsdtar）把目录压成 zip：跨平台可用，无需额外依赖
+function zipDir(zipPath, dir) {
+  const parent = path.dirname(dir);
+  const base = path.basename(dir);
+  if (fs.existsSync(zipPath)) fs.unlinkSync(zipPath);
+  const res = spawnSync('tar', ['-a', '-c', '-f', zipPath, base], { cwd: parent, encoding: 'utf8' });
+  if (res.error || res.status !== 0) {
+    throw new Error(
+      `打包 ${base} 为 zip 失败：${(res.stderr || res.stdout || '').trim() || res.error.message}`
+    );
+  }
+}
+
+// 从项目 package.json 取版本号（cfg.version 优先）
+function appVersionFromPkg(dir) {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8'));
+    return typeof pkg.version === 'string' ? pkg.version : null;
+  } catch (e) {
+    return null;
+  }
+}
+
 // 渲染 resources/config.json（与壳 configfile.go 的 runtimeConfigFile 字段对齐）
 function renderConfigJSON(cfg, name) {
   const obj = {
@@ -164,6 +276,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,14 +14,17 @@ 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                   列出本地已就绪的预编译壳
-  freedom shell download <plat>        从 GitHub Releases 下载预编译壳
-  freedom shell build <plat>           本地用 Go 编译壳（需要 Go）
+  freedom shell download <plat>        从 GitHub Releases 下载预编译壳（无需 Go）
+  freedom shell build <plat>           本地用 Go 编译壳（可选，壳已预编译一般无需）
+  freedom dmg [--platform <plat>]      将已构建的 .app 打包为 .dmg（需在 macOS 上执行）
   freedom config                       查看当前配置
   freedom config get <key>             读取单个配置项
   freedom config set <key> <value>     修改单个配置项
@@ -32,6 +35,11 @@ freedom - Freedom 桌面壳打包工具 v${VERSION}
 平台（<p>/<plat>）：win-x64 / darwin-x64 / darwin-arm64 / linux-x64 / linux-arm64，
 快捷别名：win / mac / linux / all。
 
+macOS 产物说明：
+  freedom build --platform mac 直接产出 <app>.app.zip（解压即得 .app，
+  拖入 /Applications 即可使用，无需安装任何语言运行时）；如需 .dmg，
+  在 macOS 上执行 freedom dmg 用系统 hdiutil 生成。
+
 标题栏策略说明：
   native    保留系统原生标题栏（默认）
   hidden    隐藏标题栏视觉，仅保留 Windows 原生最小化/最大化/关闭按钮
@@ -56,6 +64,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 +85,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}`);
       }
@@ -85,6 +96,10 @@ async function run(argv) {
       return await runShell(rest);
     }
 
+    case 'dmg': {
+      return await runDmg(rest);
+    }
+
     case 'titlebar': {
       const mode = rest[0];
       if (!['native', 'hidden', 'frameless'].includes(mode)) {
@@ -178,6 +193,7 @@ async function runShell(rest) {
       }
       const dest = buildShell(plat);
       console.log(`[freedom] 已编译 ${plat} 壳：${dest}`);
+      console.log('[freedom] 提示：壳已预编译随包分发，一般无需本地编译。');
       return 0;
     }
     default:
@@ -186,6 +202,45 @@ async function runShell(rest) {
   }
 }
 
+// freedom dmg：在 macOS 上把已构建的 .app 打包为 .dmg（依赖系统 hdiutil）
+async function runDmg(rest) {
+  const { loadConfig, nativePlatform } = require('./utils');
+  const { makeDmg } = require('./dmg');
+  const dir = process.cwd();
+  const cfg = await loadConfig(dir);
+  const name = (cfg.name || 'freedom-app').replace(/[^a-zA-Z0-9_.-]/g, '-');
+  const outDir = String(cfg.outDir || 'dist').trim() || 'dist';
+
+  const platArg = rest.find((a) => a.startsWith('--platform'));
+  const plat = platArg
+    ? (platArg.includes('=') ? platArg.split('=')[1] : rest[rest.indexOf(platArg) + 1])
+    : nativePlatform();
+  if (!plat || !plat.startsWith('darwin')) {
+    console.error('[freedom] dmg 仅支持 macOS 平台（darwin-x64 / darwin-arm64）。');
+    return 1;
+  }
+
+  const baseDir = path.resolve(dir, outDir);
+  // 兼容 build --platform all 的 outDir/<plat> 布局
+  const candidates = [path.join(baseDir, `${name}.app`), path.join(baseDir, plat, `${name}.app`)];
+  const appDir = candidates.find((p) => fs.existsSync(p));
+  if (!appDir) {
+    console.error(`[freedom] 未找到 ${name}.app（已检查 ${candidates.join(' / ')}）。`);
+    console.error('  请先在 macOS 上运行 freedom build --platform mac 生成 .app。');
+    return 1;
+  }
+
+  const outPath = path.join(path.dirname(appDir), `${name}-${plat}.dmg`);
+  try {
+    const dmgPath = await makeDmg(appDir, outPath, name);
+    console.log(`[freedom] 已生成 dmg：${dmgPath}`);
+    return 0;
+  } catch (e) {
+    console.error(`[freedom] ${e.message}`);
+    return 1;
+  }
+}
+
 function openBrowser(file) {
   const { spawn } = require('child_process');
   const plat = process.platform;

package/lib/dmg.js

@@ -0,0 +1,43 @@
+'use strict';
+
+// freedom dmg：把已构建的 .app bundle 打包为 .dmg（macOS 分发格式）
+//
+// 说明：.dmg 依赖 macOS 系统自带的 hdiutil，只能在 macOS 上生成。
+// Windows / Linux 上运行 freedom build 已直接产出 .app.zip（解压即得 .app，
+// 拖入 /Applications 即可使用），无需 dmg；如仍需 dmg，把产物拷到 Mac 上执行
+// freedom dmg 即可。
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+async function makeDmg(appDir, outPath, volName) {
+  if (process.platform !== 'darwin') {
+    throw new Error(
+      '.dmg 依赖 macOS 系统 hdiutil，只能在 macOS 上生成。\n' +
+        '  当前平台可直接分发 .app.zip（解压即得 .app，拖入 /Applications 即可使用）。\n' +
+        '  如需 .dmg，请把 .app 拷到 macOS 上运行：freedom dmg'
+    );
+  }
+  fs.mkdirSync(path.dirname(outPath), { recursive: true });
+  if (fs.existsSync(outPath)) fs.unlinkSync(outPath);
+
+  const args = [
+    'create',
+    '-volname',
+    String(volName || path.basename(appDir, '.app')),
+    '-srcfolder',
+    appDir,
+    '-ov',
+    '-format',
+    'UDZO',
+    outPath,
+  ];
+  const res = spawnSync('hdiutil', args, { encoding: 'utf8' });
+  if (res.error || res.status !== 0) {
+    throw new Error(`hdiutil 生成 dmg 失败：\n${(res.stderr || res.stdout || '').trim()}`);
+  }
+  return outPath;
+}
+
+module.exports = { makeDmg };

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 = ['查看已就绪壳', '下载壳（无需 Go）', '本地编译壳（可选·需 Go）', '返回'];
+    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/lib/utils.js

@@ -42,6 +42,11 @@ function isWinPlat(plat) {
   return plat.startsWith('win');
 }
 
+// macOS 平台（darwin-*）：产物需升级为 .app bundle + .app.zip 供 mac 用户解压即用
+function isMacPlat(plat) {
+  return plat.startsWith('darwin');
+}
+
 // 平台 key -> 产物可执行文件名（Windows 带 .exe，其余无扩展名）
 function platformExeName(plat, appName) {
   return isWinPlat(plat) ? `${appName}.exe` : appName;
@@ -106,6 +111,7 @@ module.exports = {
   ALL_PLATFORMS,
   SHELL_EXE_NAME,
   isWinPlat,
+  isMacPlat,
   platformExeName,
   nativePlatform,
   localShellPath,

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "@yufengtadian/freedom-cli",
-  "version": "1.1.10",
+  "version": "1.10.12",
   "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",
@@ -26,3 +26,4 @@
     "node": ">=18"
   }
 }
+