@yufengtadian/freedom-cli 1.12.12 → 1.12.14

package/lib/shell.js

@@ -22,6 +22,7 @@ const {
   ALL_PLATFORMS,
   SHELL_EXE_NAME,
   localShellPath,
+  nativePlatform,
 } = require('./utils');
 
 // GitHub Releases 下载源（可用环境变量覆盖）。
@@ -49,27 +50,63 @@ function releaseUrl(plat) {
 }
 
 // ---- 壳二进制平台格式校验 ----
-// 读取二进制文件头判断真实平台格式，防止"用 Windows 壳冒充 mac/linux 壳"这类假壳
+// 读取二进制头识别真实平台（含架构），防止"用 Windows 壳冒充 mac/linux 壳"这类假壳
 // 被静默分发（历史缺陷：shell/<darwin-*>/<linux-*> 曾误填 Windows PE 副本）。
+// 返回精确平台 key（win-x64 / win-arm64 / mac-x64 / mac-arm64 / linux-x64 / linux-arm64）、
+// 仅格式族（win / mac / linux，老壳 / 未知架构）或 'unknown'。
 function detectShellFormat(buf) {
-  if (!buf || buf.length < 4) return 'unknown';
-  // Windows PE：MZ
-  if (buf[0] === 0x4d && buf[1] === 0x5a) return 'win';
-  // Mach-O 64 位：CF FA ED FE（32 位为 CE FA ED FE，本项目仅 64 位）
-  if (buf[0] === 0xcf && buf[1] === 0xfa && buf[2] === 0xed && buf[3] === 0xfe) return 'mac';
-  // ELF：7F 45 4C 46
-  if (buf[0] === 0x7f && buf[1] === 0x45 && buf[2] === 0x4c && buf[3] === 0x46) return 'linux';
+  if (!buf || buf.length < 64) return 'unknown';
+  // Windows PE：MZ；e_lfanew @0x3C (4 LE) -> "PE\0\0"，machine @+4 (2 LE)
+  if (buf[0] === 0x4d && buf[1] === 0x5a) {
+    const peOff = buf.readUInt32LE(0x3c);
+    if (peOff + 6 <= buf.length && buf.readUInt32LE(peOff) === 0x00004550) {
+      const machine = buf.readUInt16LE(peOff + 4);
+      if (machine === 0x8664) return 'win-x64';
+      if (machine === 0xaa64) return 'win-arm64';
+    }
+    return 'win';
+  }
+  // Mach-O 64 位：CF FA ED FE（magic 0xfeedfacf 小端）；cputype @4 (4 LE)
+  if (buf[0] === 0xcf && buf[1] === 0xfa && buf[2] === 0xed && buf[3] === 0xfe) {
+    const cpu = buf.readUInt32LE(4);
+    if (cpu === 0x01000007) return 'mac-x64';
+    if (cpu === 0x0100000c) return 'mac-arm64';
+    return 'mac';
+  }
+  // ELF：7F 45 4C 46；e_machine @18 (2 LE)：62=x86_64，183=aarch64
+  if (buf[0] === 0x7f && buf[1] === 0x45 && buf[2] === 0x4c && buf[3] === 0x46) {
+    const machine = buf.readUInt16LE(18);
+    if (machine === 62) return 'linux-x64';
+    if (machine === 183) return 'linux-arm64';
+    return 'linux';
+  }
   return 'unknown';
 }
 
-// 平台 key -> 期望的二进制格式族
+// 平台 key -> 期望的二进制平台 key（含架构）
 function expectedFormat(plat) {
-  if (plat.startsWith('win')) return 'win';
-  if (plat.startsWith('darwin')) return 'mac';
-  if (plat.startsWith('linux')) return 'linux';
+  if (plat.startsWith('win')) {
+    return plat === 'win-x64' || plat === 'win-arm64' ? plat : 'win';
+  }
+  if (plat.startsWith('darwin')) {
+    if (plat === 'darwin-x64') return 'mac-x64';
+    if (plat === 'darwin-arm64') return 'mac-arm64';
+    return 'mac';
+  }
+  if (plat.startsWith('linux')) {
+    return plat === 'linux-x64' || plat === 'linux-arm64' ? plat : 'linux';
+  }
   return 'unknown';
 }
 
+// 格式族（win / mac / linux）
+function formatFamily(s) {
+  if (s.startsWith('win')) return 'win';
+  if (s.startsWith('mac')) return 'mac';
+  if (s.startsWith('linux')) return 'linux';
+  return s;
+}
+
 // 校验本地壳二进制是否为目标平台的真实格式；不匹配返回错误说明，不抛错（供调用方决策）。
 function validateLocalShell(plat) {
   const p = localShellPath(plat);
@@ -87,12 +124,21 @@ function validateLocalShell(plat) {
   if (fmt === 'unknown') {
     return `壳二进制 ${p} 不是可识别的 PE/Mach-O/ELF 格式（detect=${fmt}）。`;
   }
-  if (fmt !== want) {
+  if (formatFamily(fmt) !== formatFamily(want)) {
     return `壳二进制 ${p} 格式与目标平台 ${plat} 不匹配：期望 ${want}，实际 ${fmt}。` +
       `这是假壳（历史缺陷曾把 Windows 壳复制到 mac/linux 平台）。` +
       `请运行 freedom shell build ${plat} 在 ${plat} 本机编译真实壳，` +
       `或 freedom shell download ${plat} 拉取 CI 预编译产物。`;
   }
+  if (fmt !== want) {
+    if (!fmt.includes('-')) {
+      // 老壳仅能识别格式族、无架构信息：降级通过并提示（历史二进制）
+      console.warn(`[freedom] 警告：壳二进制 ${p} 仅识别为 ${formatFamily(fmt)} 格式（架构未知，detect=${fmt}），按目标 ${plat} 使用。`);
+      return null;
+    }
+    return `壳二进制 ${p} 架构与目标平台 ${plat} 不匹配：期望 ${want}，实际 ${fmt}（如 linux-x64 与 linux-arm64 不能混用）。` +
+      `请运行 freedom shell download ${plat} 拉取正确的预编译壳。`;
+  }
   return null;
 }
 
@@ -117,6 +163,55 @@ function hasShell(plat) {
   return fs.existsSync(localShellPath(plat));
 }
 
+// ---- 代理支持（修复：本地无 linux/mac 壳时自动下载必失败的历史根因） ----
+// 背景：GitHub Releases 资产重定向到 S3，Node 内置 fetch 直连在受限网络下
+// body 下载会卡死（可拿到 200 响应头但 arrayBuffer 永远不结束）。本机若跑
+// 在代理后（如 socks5://127.0.0.1:10808），必须显式走代理才能拉取壳资产。
+// 方案：优先识别代理环境变量，存在时改用系统 curl（跨平台自带，原生支持
+// socks5h/http/https 代理）下载，Windows 加 --ssl-no-revoke 规避 schannel
+// 证书吊销离线检查。
+
+// 解析下载代理：专属变量 > 通用标准变量（大小写各试一次）
+function resolveProxy() {
+  const keys = ['FREEDOM_SHELL_PROXY', 'ALL_PROXY', 'all_proxy', 'HTTPS_PROXY', 'https_proxy'];
+  for (const k of keys) {
+    const v = process.env[k];
+    if (v && typeof v === 'string' && v.trim()) return v.trim();
+  }
+  return null;
+}
+
+// curl 是否可用（Windows 10+ 自带 curl.exe；Linux/macOS 系统自带）
+function hasCurl() {
+  if (process.env.FREEDOM_NO_CURL === '1') return false;
+  try {
+    const r = spawnSync('curl', ['--version'], { encoding: 'utf8', windowsHide: true });
+    return !r.error && r.status === 0;
+  } catch (e) {
+    return false;
+  }
+}
+
+// 用 curl 下载到 dest；成功返回 null，失败返回错误信息
+function curlDownload(url, dest, proxy) {
+  const args = [
+    '-L', '--fail', '--silent', '--show-error',
+    '--connect-timeout', '20', '--max-time', '180', '--retry', '2',
+    '--output', dest,
+  ];
+  if (proxy) args.push('--proxy', proxy);
+  if (process.platform === 'win32' && /^https:/i.test(url)) {
+    args.push('--ssl-no-revoke'); // 规避 Windows schannel CRYPT_E_REVOCATION_OFFLINE
+  }
+  args.push(url);
+  const r = spawnSync('curl', args, { encoding: 'utf8', windowsHide: true, maxBuffer: 8 * 1024 * 1024 });
+  if (r.error || r.status !== 0) {
+    const detail = (r.stderr || r.stdout || '').trim() || (r.error && r.error.message) || '未知错误';
+    return `curl 下载失败（exit=${r.status}）：${detail}`;
+  }
+  return null;
+}
+
 // 下载指定平台壳到包内 shell/<plat>/
 // 返回下载后的绝对路径；失败抛错。
 async function downloadShell(plat) {
@@ -127,24 +222,69 @@ async function downloadShell(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)}。`);
+  const proxy = resolveProxy();
+  let buf;
+  if (proxy) {
+    process.stdout.write(`[freedom] 下载壳 ${plat}（经代理 ${proxy}）<- ${url}\n`);
+    if (!hasCurl()) {
+      throw new Error(
+        `已配置下载代理 ${proxy} 但本机没有 curl，无法经代理下载壳。` +
+          `请安装 curl，或临时取消代理变量后直连重试。`
+      );
+    }
+    const tmp = `${dest}.tmp`;
+    const curlErr = curlDownload(url, tmp, proxy);
+    if (curlErr) {
+      try { fs.unlinkSync(tmp); } catch (e) { /* 清理失败忽略 */ }
+      throw new Error(
+        `${curlErr}\n下载地址 ${url} 不可达。` +
+          `请确认代理 ${proxy} 可用（可执行 curl --proxy ${proxy} ${url} -I 自测），` +
+          `或手动将壳二进制放入 ${localShellPath(plat)}。`
+      );
+    }
+    try {
+      buf = fs.readFileSync(tmp);
+    } finally {
+      try { fs.unlinkSync(tmp); } catch (e) { /* 清理失败忽略 */ }
+    }
+  } else {
+    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）。请检查网络后重试，` +
+            `或设置代理变量 FREEDOM_SHELL_PROXY=socks5h://127.0.0.1:10808 重试，` +
+            `或手动将壳二进制放入 ${localShellPath(plat)}。`
+        );
+      }
+      throw new Error(
+        `下载壳 ${plat} 失败：${e.message}。请检查网络（必要时设置 FREEDOM_SHELL_PROXY 走代理），` +
+          `或手动将壳二进制放入 ${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)}。`
+      );
+    }
+    buf = Buffer.from(await res.arrayBuffer());
   }
-  if (!res.ok) {
+
+  // B13：下载后、落盘前校验格式/架构，防止代理劫持返回错误页或假壳被静默分发。
+  const fmt = detectShellFormat(buf);
+  const want = expectedFormat(plat);
+  if (fmt === 'unknown' || formatFamily(fmt) !== formatFamily(want)) {
     throw new Error(
-      `下载壳失败：HTTP ${res.status}。请确认 GitHub 仓库 ${releaseRepo()} 已发布 ` +
-        `${releaseTag()} 的资产 freedom-shell-${plat}，或手动将壳二进制放入 ${localShellPath(plat)}。`
+      `下载的壳格式异常：期望 ${want}（${plat}），实际 detect=${fmt}。` +
+        `下载地址 ${url} 可能返回了错误页或非本平台假壳，请检查 GitHub Release 资产 ` +
+        `${releaseRepo()} 的 ${releaseTag()}。已放弃本次写入。`
     );
   }
-  const buf = Buffer.from(await res.arrayBuffer());
   fs.writeFileSync(dest, buf);
   if (process.platform !== 'win32') {
     fs.chmodSync(dest, 0o755);
@@ -166,7 +306,8 @@ function buildShell(plat) {
   fs.mkdirSync(path.dirname(dest), { recursive: true });
 
   // 本机只能编译本机平台（webview_go 依赖系统 WebView 框架，无法交叉编译）。
-  const native = nativePlatformKey();
+  // 统一走 utils.nativePlatform：Intel Mac 会明确抛"已不支持"，避免两套映射语义不一（B44）。
+  const native = nativePlatform();
   if (plat !== native) {
     throw new Error(
       `无法在本机（${native}）交叉编译 ${plat}：webview_go 依赖系统 WebView 框架。` +
@@ -188,12 +329,8 @@ function buildShell(plat) {
 }
 
 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}`;
+  // 已废弃：统一使用 utils.nativePlatform（B44），本函数保留仅作内部兜底，勿再调用。
+  return nativePlatform();
 }
 
 module.exports = {

package/lib/theme.js

@@ -0,0 +1,105 @@
+'use strict';
+
+// Claude Code 风格终端 UI 主题：零依赖 ANSI 渲染
+// 非 TTY（管道 / 重定向）或 NO_COLOR 环境变量时自动降级为纯文本，不影响脚本输出解析。
+
+const ESC = '\x1b';
+
+const C = {
+  reset: `${ESC}[0m`,
+  bold: `${ESC}[1m`,
+  dim: `${ESC}[2m`,
+  italic: `${ESC}[3m`,
+  underline: `${ESC}[4m`,
+  fg: {
+    black: `${ESC}[30m`,
+    red: `${ESC}[31m`,
+    green: `${ESC}[32m`,
+    yellow: `${ESC}[33m`,
+    blue: `${ESC}[34m`,
+    magenta: `${ESC}[35m`,
+    cyan: `${ESC}[36m`,
+    white: `${ESC}[37m`,
+    gray: `${ESC}[90m`,
+  },
+  bg: {
+    red: `${ESC}[41m`,
+    green: `${ESC}[42m`,
+    yellow: `${ESC}[43m`,
+    magenta: `${ESC}[45m`,
+    cyan: `${ESC}[46m`,
+    gray: `${ESC}[100m`,
+  },
+};
+
+const COLOR = Boolean(process.stdout.isTTY && process.env.NO_COLOR === undefined);
+
+function paint(text, ...codes) {
+  if (!COLOR) return text;
+  return codes.join('') + text + C.reset;
+}
+
+function stripAnsi(s) {
+  return String(s).replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+// 符号徽章（Claude Code 风格）：✓ / ✗ / ⚠ / ℹ / ➜
+function ok(text) { return paint('✓ ', C.fg.green, C.bold) + text; }
+function err(text) { return paint('✗ ', C.fg.red, C.bold) + text; }
+function warn(text) { return paint('⚠ ', C.fg.yellow, C.bold) + text; }
+function info(text) { return paint('ℹ ', C.fg.cyan, C.bold) + text; }
+function tip(text) { return paint('➜ ', C.fg.magenta, C.bold) + text; }
+function dim(text) { return paint(text, C.fg.gray); }
+function bold(text, color) { return paint(text, C.bold, color ? C.fg[color] : ''); }
+
+// 行内标签：[freedom] 加粗
+function tag() { return paint('[freedom]', C.fg.blue, C.bold); }
+
+// 水平分隔线
+function rule(ch = '─', color = 'gray') {
+  const w = Math.max(8, (process.stdout.columns || 80) - 2);
+  return paint(ch.repeat(w), C.fg[color]);
+}
+
+// 帮助分组标题：── 分组名 ──
+function section(title) {
+  return `  ${paint('──', C.fg.gray)} ${paint(title, C.bold, C.fg.cyan)} ${paint('──', C.fg.gray)}`;
+}
+
+// 品牌横幅（ASCII 标识 + 版本徽章）
+function banner(version, extra) {
+  const lines = [
+    '',
+    `  ${paint('▚▚', C.fg.cyan, C.bold)} ${paint('F R E E D O M', C.bold, C.fg.white)}  ${paint(`v${version}`, C.fg.gray)}`,
+    `  ${paint('│', C.fg.cyan)}  Freedom 桌面壳打包工具 · Web 前端一键出三平台桌面应用`,
+  ];
+  if (extra) lines.push(`  ${paint('│', C.fg.cyan)}  ${extra}`);
+  lines.push('');
+  return lines.join('\n');
+}
+
+// 版本信息卡
+function versionCard(current, latest, hasUpdate) {
+  const lines = [];
+  lines.push('');
+  lines.push(`  ${paint('⚡', C.fg.magenta)} ${paint('freedom', C.bold)} ${paint(`v${current}`, C.fg.white, C.bold)}`);
+  lines.push(rule('─'));
+  if (hasUpdate && latest) {
+    lines.push(
+      `  ${paint('➜ 当前版本：', C.fg.gray)}${paint(current, C.fg.white, C.bold)}` +
+      `  ${paint('➜ 最新版本：', C.fg.gray)}${paint(latest, C.fg.green, C.bold)}  ${paint('（有新版本可升级）', C.fg.yellow)}`
+    );
+  } else if (latest) {
+    lines.push(`  ${paint('➜ 当前版本：', C.fg.gray)}${paint(current, C.fg.white, C.bold)}  ${paint('（已是最新版本）', C.fg.green)}`);
+  } else {
+    lines.push(`  ${paint('➜ 当前版本：', C.fg.gray)}${paint(current, C.fg.white, C.bold)}  ${paint('（离线，未检测到最新版本）', C.fg.gray)}`);
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+module.exports = {
+  C, COLOR, paint, stripAnsi,
+  ok, err, warn, info, tip, dim, bold, tag,
+  rule, section, banner, versionCard,
+};

package/lib/tui.js

@@ -254,7 +254,13 @@ async function configFlow(tui, cwd) {
     const [key, desc] = CONFIG_KEYS[idx - 1];
     const val = await tui.input(`${key}`, { initial: '' });
     if (val === null) continue;
-    setConfig(cwd, key, coerce(val));
+    try {
+      setConfig(cwd, key, coerce(val));
+    } catch (e) {
+      // 抛错必须留在 TUI 内提示，否则绕过 exit() 导致终端残留 raw mode / 光标隐藏（历史 bug B12）
+      await tui.message('配置', [{ text: C.fgRed + `  设置失败：${e.message}` + C.reset }]);
+      continue;
+    }
     await tui.message('配置', [{ text: C.fgGreen + `  ${key} = ${val}` + C.reset }]);
   }
 }
@@ -296,6 +302,23 @@ async function tutorialFlow(tui) {
   await tui.message('教程', [{ text: C.fgGreen + `  已打开：${file}` + C.reset }]);
 }
 
+async function updateFlow(tui) {
+  const { checkUpdate, PKG_NAME } = require('./update');
+  const r = await checkUpdate({ force: true });
+  const lines = [
+    { text: C.fgWhite + C.bold + `  当前版本：v${r.current}` + C.reset },
+  ];
+  if (r.latest) {
+    lines.push({ text: C.fgCyan + `  最新版本：v${r.latest}` + C.reset });
+    lines.push({ text: r.hasUpdate
+      ? C.fgYellow + `  发现新版本，可执行：npm install -g ${PKG_NAME}@latest` + C.reset
+      : C.fgGreen + `  已是最新版本` + C.reset });
+  } else {
+    lines.push({ text: C.fgGray + `  检查失败：网络不可用，请稍后重试` + C.reset });
+  }
+  await tui.message('检查版本更新', lines);
+}
+
 function coerce(value) {
   if (value === 'true') return true;
   if (value === 'false') return false;
@@ -313,7 +336,7 @@ async function tui(cwd) {
   app.enter();
   let keep = true;
   while (keep) {
-    const items = ['打包桌面应用', '新建项目', '修改配置', '壳管理', '打开教程', '退出'];
+    const items = ['打包桌面应用', '新建项目', '修改配置', '壳管理', '打开教程', '检查更新', '退出'];
     const idx = await app.menu('主菜单', items, {
       footer: `工作目录：${cwd}   ↑ ↓ 选择 · Enter 确认 · q 退出`,
     });
@@ -324,7 +347,8 @@ async function tui(cwd) {
       case 2: await configFlow(app, cwd); break;
       case 3: await shellFlow(app); break;
       case 4: await tutorialFlow(app); break;
-      case 5: keep = false; break;
+      case 5: await updateFlow(app); break;
+      case 6: keep = false; break;
     }
   }
   app.exit();

package/lib/update.js

@@ -0,0 +1,109 @@
+'use strict';
+
+// 版本检测：零依赖（https 内置），查询 npm registry 最新版本并对比本地版本。
+// - 结果缓存到 ~/.freedom/update-cache.json，24h 内不重复联网（离线不打扰）
+// - compareVersions 手写 semver 比较（仅处理 x.y.z 数字前缀，满足语义版本场景）
+// - 所有联网失败均静默降级，绝不阻塞主流程
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const https = require('https');
+const { packageRoot } = require('./utils');
+
+const PKG_NAME = '@yufengtadian/freedom-cli';
+const REGISTRY = `https://registry.npmjs.org/${encodeURIComponent(PKG_NAME)}/latest`;
+const CACHE_FILE = path.join(os.homedir(), '.freedom', 'update-cache.json');
+const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 小时
+const REQUEST_TIMEOUT = 4000;
+
+function currentVersion() {
+  return require(path.join(packageRoot(), 'package.json')).version;
+}
+
+// semver 简单比较：返回 1 / -1 / 0
+function compareVersions(a, b) {
+  const pa = String(a || '').replace(/[^\d.]/g, '').split('.').map((n) => parseInt(n, 10) || 0);
+  const pb = String(b || '').replace(/[^\d.]/g, '').split('.').map((n) => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i += 1) {
+    const x = pa[i] || 0;
+    const y = pb[i] || 0;
+    if (x > y) return 1;
+    if (x < y) return -1;
+  }
+  return 0;
+}
+
+function readCache() {
+  try {
+    const j = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'));
+    if (j && j.latest && Date.now() - j.ts < CACHE_TTL) return j;
+  } catch (e) { /* 无缓存或损坏，忽略 */ }
+  return null;
+}
+
+function writeCache(data) {
+  try {
+    fs.mkdirSync(path.dirname(CACHE_FILE), { recursive: true });
+    fs.writeFileSync(CACHE_FILE, JSON.stringify({ ...data, ts: Date.now() }));
+  } catch (e) { /* 写缓存失败静默 */ }
+}
+
+// 从 npm registry 拉取 latest 版本；失败 / 超时返回 null
+function fetchLatest(timeout = REQUEST_TIMEOUT) {
+  return new Promise((resolve) => {
+    const req = https.get(REGISTRY, {
+      headers: { 'user-agent': 'freedom-cli', accept: 'application/json' },
+      timeout,
+    }, (res) => {
+      if (res.statusCode !== 200) {
+        res.resume();
+        return resolve(null);
+      }
+      let body = '';
+      res.setEncoding('utf8');
+      res.on('data', (chunk) => { body += chunk; });
+      res.on('end', () => {
+        try {
+          resolve(JSON.parse(body).version || null);
+        } catch (e) {
+          resolve(null);
+        }
+      });
+    });
+    req.on('timeout', () => req.destroy());
+    req.on('error', () => resolve(null));
+  });
+}
+
+// 检查更新：force=true 强制联网（忽略缓存）；否则优先读缓存
+async function checkUpdate({ force = false } = {}) {
+  const current = currentVersion();
+  const cache = force ? null : readCache();
+  let latest = cache ? cache.latest : null;
+  if (!latest) {
+    latest = await fetchLatest();
+    if (latest) writeCache({ latest });
+  }
+  const hasUpdate = Boolean(latest && compareVersions(latest, current) > 0);
+  return { current, latest, hasUpdate };
+}
+
+// 静默异步通知：仅在检测到新版本时打印一行升级提示，不阻塞调用方
+async function maybeNotifyUpdate() {
+  try {
+    const r = await checkUpdate();
+    if (r.hasUpdate && r.latest) {
+      const theme = require('./theme');
+      console.log('');
+      console.log(`  ${theme.paint('➜', theme.C.fg.magenta, theme.C.bold)} ${theme.paint(`新版本可用 ${r.latest}（当前 ${r.current}）`, theme.C.fg.yellow)}`);
+      console.log(`    ${theme.dim('运行')} ${theme.paint(`npm install -g ${PKG_NAME}@latest`, theme.C.fg.cyan)} ${theme.dim('升级，或')} ${theme.paint('freedom update', theme.C.fg.cyan)} ${theme.dim('查看详情')}`);
+      console.log('');
+    }
+  } catch (e) { /* 检测失败静默 */ }
+}
+
+module.exports = {
+  PKG_NAME, REGISTRY, CACHE_FILE, CACHE_TTL,
+  currentVersion, compareVersions, checkUpdate, maybeNotifyUpdate,
+};

package/lib/utils.js

@@ -28,8 +28,14 @@ function shellDir() {
 // 平台矩阵：key -> { exe 文件名（壳二进制名） }
 // 通用壳为三平台预编译二进制，应用内容通过 exe 同目录 resources/ 外部加载，
 // 因此同一壳可复用于任意应用，打包时无需任何语言工具链。
+// 全部平台 key（含暂无预编译资产来源的 linux-arm64，仅支持显式指定 / 本地编译）。
 const ALL_PLATFORMS = ['win-x64', 'darwin-arm64', 'linux-x64', 'linux-arm64'];
 
+// 可分发平台（有预编译壳资产，CI 已产出）：--platform all 的取值集合。
+// linux-arm64 无 CI runner 与 GitHub 资产，若列入 all 会在 build 时 404 拖垮整个
+// 全量构建（历史 bug B41）；故 all 仅包含以下三平台，linux-arm64 需显式指定。
+const DIST_PLATFORMS = ['win-x64', 'darwin-arm64', 'linux-x64'];
+
 const SHELL_EXE_NAME = {
   'win-x64': 'freedom-shell.exe',
   'darwin-arm64': 'freedom-shell',
@@ -55,7 +61,13 @@ function platformExeName(plat, appName) {
 function nativePlatform() {
   const plat = process.platform;
   const arch = process.arch;
-  if (plat === 'win32') return 'win-x64';
+  if (plat === 'win32') {
+    if (arch !== 'x64') {
+      // ARM64 Windows 没有独立的 win-arm64 壳，x64 壳经系统仿真可运行；给出提示而非静默。
+      console.error(`[freedom] 注意：当前为 ${arch} 架构 Windows，将使用 win-x64 壳（x64 仿真运行）。`);
+    }
+    return 'win-x64';
+  }
   if (plat === 'darwin') {
     if (arch !== 'arm64') {
       throw new Error('已不支持 Intel Mac（darwin-x64）：请改用 Apple Silicon Mac 构建 darwin-arm64，或直接使用 darwin-arm64 产物。');
@@ -113,6 +125,7 @@ module.exports = {
   goTemplateDir,
   shellDir,
   ALL_PLATFORMS,
+  DIST_PLATFORMS,
   SHELL_EXE_NAME,
   isWinPlat,
   isMacPlat,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yufengtadian/freedom-cli",
-  "version": "1.12.12",
+  "version": "1.12.14",
   "description": "Freedom WebView desktop shell packaging tool - no Go toolchain required, one command packs three-platform desktop apps",
   "keywords": [
     "desktop",

package/templates/go/main.go

@@ -4,7 +4,8 @@ import "freedom-cli-shell/pkg/freedom"
 
 // main 是 Freedom 壳层应用入口。
 // 窗口与标题栏配置来自 build 阶段生成的 gen_config.go（appConfig），
-// 前端页面由 pkg/freedom 的 assets_embed.go 嵌入（build 阶段把打包后的 index.html 放进去）。
+// 前端页面运行时从 exe 同目录 resources/index.html 加载（build 阶段由 CLI
+// 把打包后的 index.html 与 config.json 写入该目录，壳 SetHtml 内存加载、不占端口）。
 func main() {
 	cfg := appConfig()
 	app := freedom.New(cfg)

package/templates/go/pkg/freedom/assets/freedom.js

@@ -71,13 +71,19 @@
     var q = function (s) { return typeof s === 'string' ? document.querySelector(s) : s; };
     var min = q(sel && sel.min), max = q(sel && sel.max), close = q(sel && sel.close);
     var self = this;
-    if (min) min.addEventListener('click', function () { self.minimize(); });
+    // 所有桥接调用均带 .catch：页面先于桥接就绪时点击按钮会产生未捕获的
+    // Promise rejection（并导致自绘标题栏静默失效），此处兜底为控制台告警。
+    if (min) min.addEventListener('click', function () {
+      self.minimize().catch(function (e) { console.warn('[freedom] minimize:', e); });
+    });
     if (max) max.addEventListener('click', function () {
       self.isMaximized().then(function (m) {
-        if (m) self.unmaximize(); else self.maximize();
-      });
+        if (m) return self.unmaximize(); else return self.maximize();
+      }).catch(function (e) { console.warn('[freedom] maximize toggle:', e); });
+    });
+    if (close) close.addEventListener('click', function () {
+      self.close().catch(function (e) { console.warn('[freedom] close:', e); });
     });
-    if (close) close.addEventListener('click', function () { self.close(); });
   };
 
   function windowAction(action) {

package/templates/go/pkg/freedom/backend_proc.go

@@ -97,6 +97,9 @@ func (p *ProcBackend) OnEvent(fn func(event string, data interface{})) {
 func (p *ProcBackend) start() error {
 	p.mu.Lock()
 	defer p.mu.Unlock()
+	if p.closed {
+		return fmt.Errorf("freedom: proc backend is closed")
+	}
 	if p.stdin != nil {
 		return nil // 已启动
 	}
@@ -134,12 +137,12 @@ func (p *ProcBackend) Handle(method string, params []json.RawMessage) (interface
 	id := p.nextID
 	ch := make(chan procResp, 1)
 	p.pending[id] = ch
-	msg := procMessage{ID: id, Method: method, Params: paramsJSON}
-	line, _ := json.Marshal(msg)
-	_, err = p.stdin.Write(append(line, '\n'))
+	w := p.stdin // 锁内取引用，锁外写，避免持锁阻塞（后端不消费 stdin 时 Write 可能挂起）
 	p.mu.Unlock()
 
-	if err != nil {
+	msg := procMessage{ID: id, Method: method, Params: paramsJSON}
+	line, _ := json.Marshal(msg)
+	if _, err := w.Write(append(line, '\n')); err != nil {
 		p.cancel(id, fmt.Errorf("freedom: proc backend write: %w", err))
 		return nil, err
 	}