@yufengtadian/freedom-cli 1.12.1 → 1.12.13

package/lib/config.js

@@ -4,51 +4,114 @@ const fs = require('fs');
 const path = require('path');
 const { loadConfig, hasConfig } = require('./utils');
 
-// 配置文件中可安全写入的字段及其默认值（用于渲染或回填）。
-const KNOWN_KEYS = {
-  name: 'freedom-app',
-  width: 1024,
-  height: 720,
-  minWidth: 400,
-  minHeight: 300,
-  center: true,
-  debug: false,
-  titlebar: 'frameless',
-  icon: undefined,
-  outDir: 'dist',
+// 配置文件中可安全写入的字段：类型约束（写入前校验，防止坏值延迟到 build 才爆）。
+const KEY_TYPES = {
+  name: 'string',
+  width: 'int',
+  height: 'int',
+  minWidth: 'int',
+  minHeight: 'int',
+  center: 'bool',
+  debug: 'bool',
+  titlebar: 'titlebar',
+  icon: 'string',
+  outDir: 'string',
 };
 
-// 把配置写回 freedom.config.js（保留注释，只替换已知键的取值）。
+// 把 CLI/TUI 传入的值规范化为配置语义上的目标值；非法即抛错。
+function normalizeValue(key, value) {
+  const t = KEY_TYPES[key];
+  if (t === 'string') return String(value);
+  if (t === 'int') {
+    const n = Number(value);
+    if (!Number.isInteger(n)) {
+      throw new Error(`配置项 ${key} 需要整数值，收到：${JSON.stringify(value)}`);
+    }
+    return n;
+  }
+  if (t === 'bool') {
+    if (typeof value !== 'boolean') {
+      throw new Error(`配置项 ${key} 仅接受 true / false`);
+    }
+    return value;
+  }
+  if (t === 'titlebar') {
+    const s = String(value);
+    if (!['native', 'frameless'].includes(s)) {
+      throw new Error('titlebar 取值必须为：native / frameless。');
+    }
+    return s;
+  }
+  // 扩展键（如 backend）：字符串命令简写转 {command,args} 对象，
+  // 与 build.js renderConfigJSON 的契约对齐（纯字符串形态不会被打包为后端进程）。
+  if (key === 'backend') {
+    if (value === undefined || value === null || value === '') return undefined;
+    if (typeof value === 'string') {
+      const parts = value.trim().split(/\s+/);
+      return { command: parts[0], args: parts.slice(1) };
+    }
+    return value; // 对象/数组形式原样写入
+  }
+  return value;
+}
+
+// 把值渲染为合法 JS 字面量。统一走 JSON.stringify：
+// 反斜杠 / 引号自动转义，且不存在 $ 替换模式注入面（配合函数式 replace 使用）。
+function renderLiteral(v) {
+  if (v === undefined) return 'undefined';
+  if (v === null) return 'null';
+  return JSON.stringify(v, null, typeof v === 'object' ? 2 : 0);
+}
+
+// 统计一行内 { 与 } 的差值，用于把多行对象字面量并入替换范围
+//（启发式实现；配置值内含花括号字符串的场景需手动编辑配置文件）。
+function braceDelta(line) {
+  let d = 0;
+  for (const ch of line) {
+    if (ch === '{') d++;
+    else if (ch === '}') d--;
+  }
+  return d;
+}
+
+// 把配置写回 freedom.config.js（保留注释与格式，只替换目标键所在行）。
+// 逐行定位且跳过注释行：模板中被注释的示例键（如 // backend: undefined,）不会被误改。
 function setConfig(dir, key, value) {
   const cfgPath = path.join(dir, 'freedom.config.js');
   if (!fs.existsSync(cfgPath)) {
     throw new Error('未找到 freedom.config.js。');
   }
   const text = fs.readFileSync(cfgPath, 'utf8');
+  const norm = normalizeValue(key, value);
+  const rendered = renderLiteral(norm);
 
-  if (key === 'titlebar') {
-    const modes = ['native', 'hidden', 'frameless'];
-    if (!modes.includes(value)) {
-      throw new Error(`titlebar 取值必须为：${modes.join(' / ')}。`);
+  const lines = text.split('\n');
+  const keyRe = new RegExp(`^(\\s*)${key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*:(.*)$`);
+  let replaced = false;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].trim().startsWith('//')) continue; // 注释行不参与匹配与改写
+    const m = lines[i].match(keyRe);
+    if (!m) continue;
+    // 值为多行对象时吞并后续行直到花括号闭合，避免残留孤儿括号
+    let j = i;
+    let depth = braceDelta(lines[i]);
+    while (depth > 0 && j + 1 < lines.length) {
+      j++;
+      depth += braceDelta(lines[j]);
     }
+    const trailing = /,\s*$/.test(m[2]) ? ',' : '';
+    lines.splice(i, j - i + 1, `${m[1]}${key}: ${rendered}${trailing}`);
+    replaced = true;
+    break;
   }
-
-  // 同时兼容单引号与双引号字符串写法（模板统一单引号，用户手写可能用双引号）。
-  const regex = new RegExp(`(${key}\\s*:\\s*)(\"[^\"]*\"|'[^']*'|\\d+|true|false|undefined|null)`, 'g');
-  if (!regex.test(text)) {
-    throw new Error(`配置项 ${key} 未在 freedom.config.js 中找到，请手动添加。`);
-  }
-
-  let rendered = String(value);
-  if (typeof value === 'string') {
-    rendered = `'${value.replace(/'/g, "\\'")}'`;
+  if (!replaced) {
+    throw new Error(`配置项 ${key} 未在 freedom.config.js 中找到（注释行不参与修改），请手动添加。`);
   }
-
-  const updated = text.replace(regex, `$1${rendered}`);
-  fs.writeFileSync(cfgPath, updated, 'utf8');
-  return value;
+  fs.writeFileSync(cfgPath, lines.join('\n'), 'utf8');
+  return norm;
 }
 
+
 async function getConfig(dir) {
   if (!hasConfig(dir)) {
     throw new Error('当前目录不是 Freedom 项目（缺少 freedom.config.js）。');
@@ -57,6 +120,20 @@ async function getConfig(dir) {
   return cfg;
 }
 
+// 配置文件中可安全写入的字段及其默认值（用于渲染或回填）。
+const KNOWN_KEYS = {
+  name: 'freedom-app',
+  width: 1024,
+  height: 720,
+  minWidth: 400,
+  minHeight: 300,
+  center: true,
+  debug: false,
+  titlebar: 'frameless',
+  icon: undefined,
+  outDir: 'dist',
+};
+
 async function showConfig(dir) {
   const cfg = await loadConfig(dir);
   const lines = Object.keys(KNOWN_KEYS).map((k) => {

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;
 }
 
@@ -145,6 +191,16 @@ async function downloadShell(plat) {
     );
   }
   const buf = Buffer.from(await res.arrayBuffer());
+  // B13：下载后、落盘前校验格式/架构，防止代理劫持返回错误页或假壳被静默分发。
+  const fmt = detectShellFormat(buf);
+  const want = expectedFormat(plat);
+  if (fmt === 'unknown' || formatFamily(fmt) !== formatFamily(want)) {
+    throw new Error(
+      `下载的壳格式异常：期望 ${want}（${plat}），实际 detect=${fmt}。` +
+        `下载地址 ${url} 可能返回了错误页或非本平台假壳，请检查 GitHub Release 资产 ` +
+        `${releaseRepo()} 的 ${releaseTag()}。已放弃本次写入。`
+    );
+  }
   fs.writeFileSync(dest, buf);
   if (process.platform !== 'win32') {
     fs.chmodSync(dest, 0o755);
@@ -166,7 +222,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 +245,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

@@ -192,7 +192,7 @@ const CONFIG_KEYS = [
   ['minHeight', '窗口最小高度'],
   ['center', '启动居中（true/false）'],
   ['debug', '开发者工具（true/false）'],
-  ['titlebar', '标题栏：native | hidden | frameless'],
+  ['titlebar', '标题栏：native | frameless'],
   ['icon', '应用图标：.ico（Windows）/ .icns（macOS）路径'],
   ['outDir', '产物目录：dist（默认）| .（项目根）| 任意路径'],
   ['backend', '任意语言后端进程（JSON）'],
@@ -296,6 +296,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 +330,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 +341,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.1",
+  "version": "1.12.13",
   "description": "Freedom WebView desktop shell packaging tool - no Go toolchain required, one command packs three-platform desktop apps",
   "keywords": [
     "desktop",

package/templates/go/go.mod

@@ -3,3 +3,9 @@ module freedom-cli-shell
 go 1.22
 
 require github.com/webview/webview_go v0.0.0-20240831120633-6173450d4dd6
+
+require golang.org/x/sys v0.28.0
+
+// Freedom fork: 使用随包分发的本地 webview_go（标题栏图标与 exe 图标一致、
+// 无边框窗口最大化限定工作区、彻底清理非客户区等定制），避免拉取上游被覆盖。
+replace github.com/webview/webview_go => ./webview_go

package/templates/go/go.sum

@@ -1,2 +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=
+golang.org/x/sys v0.28.0 h1:Fksou7UEQUWlKvIdsqzJmUmCX3cZuD2+P3XyyzwMhlA=
+golang.org/x/sys v0.28.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=

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

@@ -52,10 +52,16 @@
       minimize: function () { return windowAction('minimize'); },
       maximize: function () { return windowAction('maximize'); },
       unmaximize: function () { return windowAction('unmaximize'); },
+      restore: function () { return windowAction('unmaximize'); },
       toggleMaximize: function () { return windowAction('toggleMaximize'); },
       close: function () { return windowAction('close'); },
       isMaximized: function () { return windowAction('isMaximized'); },
       isFrameless: function () { return windowAction('isFrameless'); },
+      // 应用图标（data URL）。从 exe 内嵌图标提取，供自绘标题栏显示，不依赖 resources 资源文件夹。
+      appIcon: function () { return windowAction('appIcon'); },
+      // 标题栏 JS 拖动（WM_NCLBUTTONDOWN + HTCAPTION），比 -webkit-app-region: drag
+      // 更稳（保留双击最大化 / 右键菜单等页面事件）。非 Windows 平台为 no-op。
+      startDrag: function () { return windowAction('startDrag'); },
     },
   };