@yufengtadian/freedom-cli 1.0.0 → 1.1.11

package/lib/shell.js

@@ -0,0 +1,139 @@
+'use strict';
+
+// 预编译壳管理：list / download / build
+//
+// 自 v1.1.10 起，Freedom 采用"通用预编译壳"架构：
+//   壳二进制（freedom-shell）是三平台预编译产物，应用内容通过 exe 同目录
+//   resources/（index.html + config.json）外部加载，因此打包时用户无需任何
+//   Go / CGO / 系统编译工具链。
+//
+// 壳二进制的三种来源（按优先级）：
+//   1. 包内自带  shell/<plat>/freedom-shell[.exe]（随 npm 包分发）
+//   2. 远程下载  GitHub Releases 资产（freedom shell download <plat>）
+//   3. 本地编译  freedom shell build <plat>（需要 Go + 对应平台编译环境）
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawnSync } = require('child_process');
+const {
+  shellDir,
+  goTemplateDir,
+  ALL_PLATFORMS,
+  SHELL_EXE_NAME,
+  localShellPath,
+} = require('./utils');
+
+// GitHub Releases 下载源（可用环境变量覆盖）。
+// 资产命名约定：freedom-shell-<plat>（单文件二进制，不压缩）。
+function releaseRepo() {
+  return process.env.FREEDOM_SHELL_REPO || 'yufengtadian/freedom';
+}
+function releaseTag() {
+  return process.env.FREEDOM_SHELL_TAG || 'v1.1.10';
+}
+function releaseUrl(plat) {
+  return `https://github.com/${releaseRepo()}/releases/download/${releaseTag()}/freedom-shell-${plat}`;
+}
+
+// 列出本地已就绪的壳平台
+function listLocal() {
+  const dir = shellDir();
+  const ready = [];
+  if (fs.existsSync(dir)) {
+    for (const name of fs.readdirSync(dir, { withFileTypes: true })) {
+      if (!name.isDirectory() || !ALL_PLATFORMS.includes(name.name)) continue;
+      const exe = SHELL_EXE_NAME[name.name] || 'freedom-shell';
+      if (fs.existsSync(path.join(dir, name.name, exe))) {
+        ready.push(name.name);
+      }
+    }
+  }
+  return ready;
+}
+
+// 是否存在指定平台本地壳
+function hasShell(plat) {
+  return fs.existsSync(localShellPath(plat));
+}
+
+// 下载指定平台壳到包内 shell/<plat>/
+// 返回下载后的绝对路径；失败抛错。
+async function downloadShell(plat) {
+  if (!ALL_PLATFORMS.includes(plat)) {
+    throw new Error(`未知平台：${plat}。可选：${ALL_PLATFORMS.join(' / ')}`);
+  }
+  const url = releaseUrl(plat);
+  const dest = localShellPath(plat);
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+
+  process.stdout.write(`[freedom] 下载壳 ${plat} <- ${url}\n`);
+  let res;
+  try {
+    // 30s 超时：网络挂起时明确报错，避免构建进程无限阻塞
+    res = await fetch(url, { redirect: 'follow', signal: AbortSignal.timeout(30000) });
+  } catch (e) {
+    if (e.name === 'AbortError' || e.name === 'TimeoutError') {
+      throw new Error(`下载壳 ${plat} 超时（30s）。请检查网络后重试，或手动将壳二进制放入 ${localShellPath(plat)}。`);
+    }
+    throw new Error(`下载壳 ${plat} 失败：${e.message}。请检查网络，或手动将壳二进制放入 ${localShellPath(plat)}。`);
+  }
+  if (!res.ok) {
+    throw new Error(
+      `下载壳失败：HTTP ${res.status}。请确认 GitHub 仓库 ${releaseRepo()} 已发布 ` +
+        `${releaseTag()} 的资产 freedom-shell-${plat}，或手动将壳二进制放入 ${localShellPath(plat)}。`
+    );
+  }
+  const buf = Buffer.from(await res.arrayBuffer());
+  fs.writeFileSync(dest, buf);
+  if (process.platform !== 'win32') {
+    fs.chmodSync(dest, 0o755);
+  }
+  return dest;
+}
+
+// 本地用 Go 编译指定平台壳（需要 Go + 该平台编译环境）。
+// Windows 产物以 GUI 子系统编译（-H windowsgui），运行时无 cmd 黑窗。
+function buildShell(plat) {
+  if (!ALL_PLATFORMS.includes(plat)) {
+    throw new Error(`未知平台：${plat}。可选：${ALL_PLATFORMS.join(' / ')}`);
+  }
+  const res = spawnSync('go', ['version'], { encoding: 'utf8' });
+  if (res.error || res.status !== 0) {
+    throw new Error('未检测到 Go 工具链。请先安装 Go（https://go.dev/dl/），或改用 freedom shell download。');
+  }
+  const dest = localShellPath(plat);
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+
+  // 本机只能编译本机平台（webview_go 依赖系统 WebView 框架，无法交叉编译）。
+  const native = nativePlatformKey();
+  if (plat !== native) {
+    throw new Error(
+      `无法在本机（${native}）交叉编译 ${plat}：webview_go 依赖系统 WebView 框架。` +
+        `请在目标平台执行 freedom shell build ${plat}，或用 freedom shell download ${plat} 拉取 CI 预编译产物。`
+    );
+  }
+
+  const buildDir = goTemplateDir();
+  const ldflags = plat.startsWith('win') ? ['-ldflags', '-H windowsgui'] : [];
+  const build = spawnSync('go', ['build', ...ldflags, '-o', dest, '.'], {
+    cwd: buildDir,
+    encoding: 'utf8',
+    env: { ...process.env, CGO_ENABLED: '1' },
+  });
+  if (build.error || build.status !== 0) {
+    throw new Error(`Go 编译失败：\n${build.stdout}\n${build.stderr}`);
+  }
+  return dest;
+}
+
+function nativePlatformKey() {
+  const plat = process.platform;
+  const arch = process.arch;
+  if (plat === 'win32') return 'win-x64';
+  if (plat === 'darwin') return arch === 'arm64' ? 'darwin-arm64' : 'darwin-x64';
+  if (plat === 'linux') return arch === 'arm64' ? 'linux-arm64' : 'linux-x64';
+  return `${plat}-${arch}`;
+}
+
+module.exports = { listLocal, hasShell, downloadShell, buildShell, releaseRepo, releaseTag };

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/lib/utils.js

@@ -21,6 +21,46 @@ function goTemplateDir() {
   return path.join(templateDir(), 'go');
 }
 
+function shellDir() {
+  return path.join(PKG_ROOT, 'shell');
+}
+
+// 平台矩阵：key -> { exe 文件名（壳二进制名） }
+// 通用壳为三平台预编译二进制，应用内容通过 exe 同目录 resources/ 外部加载，
+// 因此同一壳可复用于任意应用，打包时无需任何语言工具链。
+const ALL_PLATFORMS = ['win-x64', 'darwin-x64', 'darwin-arm64', 'linux-x64', 'linux-arm64'];
+
+const SHELL_EXE_NAME = {
+  'win-x64': 'freedom-shell.exe',
+  'darwin-x64': 'freedom-shell',
+  'darwin-arm64': 'freedom-shell',
+  'linux-x64': 'freedom-shell',
+  'linux-arm64': 'freedom-shell',
+};
+
+function isWinPlat(plat) {
+  return plat.startsWith('win');
+}
+
+// 平台 key -> 产物可执行文件名（Windows 带 .exe，其余无扩展名）
+function platformExeName(plat, appName) {
+  return isWinPlat(plat) ? `${appName}.exe` : appName;
+}
+
+// 把 node 的 process.platform / process.arch 映射为平台 key
+function nativePlatform() {
+  const plat = process.platform;
+  const arch = process.arch;
+  if (plat === 'win32') return 'win-x64';
+  if (plat === 'darwin') return arch === 'arm64' ? 'darwin-arm64' : 'darwin-x64';
+  if (plat === 'linux') return arch === 'arm64' ? 'linux-arm64' : 'linux-x64';
+  return `${plat}-${arch}`;
+}
+
+function localShellPath(plat) {
+  return path.join(shellDir(), plat, SHELL_EXE_NAME[plat] || 'freedom-shell');
+}
+
 function tutorialFile() {
   return path.join(PKG_ROOT, 'tutorial', 'tutorial.html');
 }
@@ -62,6 +102,13 @@ module.exports = {
   templateDir,
   projectTemplateDir,
   goTemplateDir,
+  shellDir,
+  ALL_PLATFORMS,
+  SHELL_EXE_NAME,
+  isWinPlat,
+  platformExeName,
+  nativePlatform,
+  localShellPath,
   tutorialFile,
   loadConfig,
   hasConfig,

package/package.json

@@ -1,8 +1,8 @@
-{
+{
   "name": "@yufengtadian/freedom-cli",
-  "version": "1.0.0",
-  "description": "Freedom WebView desktop shell packaging tool - embed any web frontend into a cross-platform desktop app",
-  "keywords": ["desktop", "webview", "electron-alternative", "wails", "tauri", "go", "frontend"],
+  "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",
   "publishConfig": {
     "access": "public"
@@ -13,6 +13,7 @@
   "files": [
     "bin",
     "lib",
+    "shell",
     "templates",
     "tutorial",
     "postinstall.js",

package/templates/go/gen_config.go

@@ -2,9 +2,12 @@ package main
 
 import "freedom-cli-shell/pkg/freedom"
 
-// appConfig 返回应用窗口配置。
-// 本文件由 freedom CLI 在 build 阶段根据 freedom.config.js 重新生成，
-// 不要手动修改（手动修改会在下次 build 时被覆盖）。
+// appConfig 返回应用窗口配置（编译期默认值）。
+//
+// 通用壳在运行时还会读取 exe 同目录 resources/config.json（由 freedom CLI build
+// 阶段根据 freedom.config.js 生成），其中的字段会覆盖本默认值。因此：
+//   - 使用预编译通用壳时，本文件中的值只是兜底，无需手动修改；
+//   - 若通过 go build 直接编译本项目（不使用 CLI），此处即为最终配置。
 func appConfig() freedom.Config {
 	return freedom.Config{
 		Title:     "Freedom App",

package/templates/go/go.sum

@@ -0,0 +1,2 @@
+github.com/webview/webview_go v0.0.0-20240831120633-6173450d4dd6 h1:VQpB2SpK88C6B5lPHTuSZKb2Qee1QWwiFlC5CKY4AW0=
+github.com/webview/webview_go v0.0.0-20240831120633-6173450d4dd6/go.mod h1:yE65LFCeWf4kyWD5re+h4XNvOHJEXOCOuJZ4v8l5sgk=