@yufengtadian/freedom-cli 1.1.11 → 1.10.12

package/README.md

@@ -1,11 +1,29 @@
+---
+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.11）。
+Freedom 桌面壳打包工具：把你的 Web 前端一键打包成跨平台桌面应用（v1.10.12）。
 
 基于自研 Freedom WebView 壳层（对标 Wails / Tauri）：前端完全自由、后端可任意语言、渲染复用系统 WebView（Windows WebView2 / macOS WKWebView / Linux WebKitGTK），产物为单个可执行文件 + resources 目录，前端页面内存加载，不占本地端口。
 
+**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` 强制全量重建；
@@ -46,6 +64,20 @@ freedom build --no-cache             # 忽略前端构建缓存，强制重建
 
 构建产物默认输出到 `dist/`。`dist/<应用名>.exe`（或对应平台可执行文件）为壳层程序，运行时从 `dist/resources/` 加载前端页面与配置，不弹 cmd 黑窗。
 
+**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`（只产出本机平台）。多平台分发为并行执行，全平台打包耗时大幅缩短。
@@ -99,6 +131,7 @@ window.freedom.window.minimize();                       // 窗口控制
 - Node.js >= 18
 - 不需要 Go 工具链（壳层为随包分发的预编译二进制）
 - 可选：`freedom shell build` 需本机 Go（含 CGO，Windows 需 MSVC 编译环境），仅用于亲自编译壳
+- `.dmg` 打包需在 macOS 上执行（依赖系统 hdiutil）；`.app.zip` 在任意平台均可直接产出
 
 ## 命令
 
@@ -109,6 +142,7 @@ 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
 ```
@@ -135,3 +169,4 @@ export default {
 ## License
 
 MIT
+*（内容由AI生成，仅供参考）*

package/lib/build.js

@@ -11,6 +11,11 @@
 //      - 写 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/ 下，因此壳可复用、
 // 可跨平台分发、无需在目标机器安装任何语言运行时。
@@ -23,6 +28,7 @@ const { copyDir } = require('./utils');
 const {
   ALL_PLATFORMS,
   isWinPlat,
+  isMacPlat,
   platformExeName,
   nativePlatform,
   localShellPath,
@@ -69,6 +75,7 @@ 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);
@@ -103,7 +110,7 @@ async function build(projectDir, opts = {}) {
   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 });
+      const outFile = await emitPlatform({ plat, name, version, targetDir, html, configJSON, backendDir, hasBackend, autoDownload });
       return { plat, outFile };
     })
   );
@@ -111,7 +118,7 @@ async function build(projectDir, opts = {}) {
   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)) {
@@ -144,9 +151,106 @@ async function emitPlatform({ plat, name, targetDir, html, configJSON, backendDi
     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 = {

package/lib/cli.js

@@ -22,8 +22,9 @@ freedom - Freedom 桌面壳打包工具 v${VERSION}
   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>     修改单个配置项
@@ -34,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 原生最小化/最大化/关闭按钮
@@ -90,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)) {
@@ -183,6 +193,7 @@ async function runShell(rest) {
       }
       const dest = buildShell(plat);
       console.log(`[freedom] 已编译 ${plat} 壳：${dest}`);
+      console.log('[freedom] 提示：壳已预编译随包分发，一般无需本地编译。');
       return 0;
     }
     default:
@@ -191,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

@@ -259,7 +259,7 @@ async function configFlow(tui, cwd) {
 async function shellFlow(tui) {
   const { listLocal, downloadShell, buildShell } = require('./shell');
   for (;;) {
-    const items = ['查看已就绪壳', '下载壳', '本地编译壳', '返回'];
+    const items = ['查看已就绪壳', '下载壳（无需 Go）', '本地编译壳（可选·需 Go）', '返回'];
     const idx = await tui.menu('壳管理', items);
     if (idx === null || idx === items.length - 1) return;
 
@@ -277,7 +277,7 @@ async function shellFlow(tui) {
         console.log(`${C.fgGreen}[freedom]${C.reset} 已下载 ${ALL_PLATFORMS[p]} 壳：${dest}`);
       });
     } else {
-      const p = await tui.menu('选择要编译的壳平台（需 Go 且仅本机平台）', ALL_PLATFORMS);
+      const p = await tui.menu('选择要编译的壳平台（可选·需 Go，壳已预编译随包分发，一般无需编译）', ALL_PLATFORMS);
       if (p === null) continue;
       await tui.runTask(async () => {
         const dest = buildShell(ALL_PLATFORMS[p]);

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.11",
+  "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"
   }
 }
+