@yufengtadian/freedom-cli 1.12.17 → 1.12.18

package/lib/build.js

@@ -112,9 +112,13 @@ async function build(projectDir, opts = {}) {
   if (useCache && !viteNeedsRebuild(dir)) {
     process.stdout.write('[freedom] 前端源码无改动，复用构建缓存...\n');
   } else {
-    const vite = run('npm', ['run', 'build'], { cwd: dir });
+    process.stdout.write('[freedom] 前端打包中（npm run build）...\n');
+    // 全量构建时 npm/vite 输出必须实时透传（stdio: inherit），
+    // 此前 pipe 缓冲会吞掉构建全程输出，Node 主线程被 spawnSync 同步阻塞，
+    // 大前端全量构建时终端长时间零输出，表现如"未响应/卡死"。
+    const vite = run('npm', ['run', 'build'], { cwd: dir, stdio: 'inherit' });
     if (vite.status !== 0) {
-      throw new Error(`前端打包失败：\n${vite.stdout}\n${vite.stderr}`);
+      throw new Error(`前端打包失败（退出码 ${vite.status}），详见上方构建输出。`);
     }
     writeViteCacheMarker(dir);
   }
@@ -150,6 +154,33 @@ async function build(projectDir, opts = {}) {
     })
   );
 
+  // 5) 产物自检 + 形态树（消除"build 后形态未知 / 需实测"）：
+  //    build 完成后自动校验产物完整性，并打印产物结构；自检发现问题仅告警不阻断，
+  //    完整失败信息可用 freedom verify 复核（返回非零退出码，供 CI 使用）。
+  const { verifyProduct, renderTree, formatChecks } = require('./verify');
+  const v = await verifyProduct(dir);
+  if (v.error) {
+    process.stdout.write(`[freedom] 产物自检跳过：${v.error}\n`);
+  } else if (v.targets.length === 0) {
+    process.stdout.write('[freedom] 产物自检跳过：未在产物目录发现可执行文件。\n');
+  } else {
+    process.stdout.write('\n[freedom] 产物自检：\n');
+    for (const t of v.targets) {
+      process.stdout.write(`  [${t.plat}] ${t.dir}\n`);
+      for (const line of formatChecks(t.checks)) {
+        process.stdout.write(`    ${line}\n`);
+      }
+    }
+    process.stdout.write('\n[freedom] 产物结构：\n');
+    for (const line of renderTree(v.targets).split('\n')) {
+      process.stdout.write(`  ${line}\n`);
+    }
+    const failed = v.targets.some((t) => t.checks.some((c) => !c.pass));
+    if (failed) {
+      process.stdout.write(`\n[freedom] 警告：产物自检存在失败项，请运行 ${'freedom verify'} 复核。\n`);
+    }
+  }
+
   return { results };
 }
 
@@ -184,8 +215,10 @@ async function emitPlatform({ plat, name, version, targetDir, html, configJSON,
   }
 
   // 自定义 exe 图标（仅 Windows PE 支持嵌入 .ico 资源；mac 用 .icns 走 .app 分支）
+  // 修复：此前引用未传入 emitPlatform 作用域的 cfg 导致 ReferenceError（cfg is not defined），
+  // 配置 icon 后 Windows 构建必然失败；改用 emitPlatform 已解构的 name/version。
   if (isWinPlat(plat) && icon) {
-    await applyWindowsIcon(outFile, icon);
+    await applyWindowsIcon(outFile, icon, name, version);
   }
 
   // 写 resources：页面 + 配置 + 后端
@@ -239,9 +272,11 @@ async function emitPlatform({ plat, name, version, targetDir, html, configJSON,
   return outFile;
 }
 
-// 把 .ico 图标注入到 Windows exe 的 PE 资源（RT_ICON + RT_GROUP_ICON）。
+// 把 .ico 图标注入到 Windows exe 的 PE 资源（RT_ICON + RT_GROUP_ICON），
+// 并设置版本信息（产品名 / 说明 / 版本），使资源管理器详情可读。
 // 依赖 rcedit（随 npm 包分发的预编译 rcedit-x64.exe，无需 Go/资源编译器）。
-async function applyWindowsIcon(exePath, iconPath) {
+// 产品名取自 cfg.name，版本取自 cfg.version —— 修复"产物无产品名 / 版本无法配置"。
+async function applyWindowsIcon(exePath, iconPath, name, version) {
   const ext = path.extname(iconPath).toLowerCase();
   if (ext !== '.ico') {
     process.stdout.write(
@@ -256,8 +291,24 @@ async function applyWindowsIcon(exePath, iconPath) {
     return;
   }
   const rcedit = require('rcedit'); // 惰性加载，避免未配置 icon 时增加启动开销
-  await rcedit(exePath, { icon: iconPath });
-  process.stdout.write(`[freedom] 已注入 exe 图标：${iconPath}\n`);
+  const info = { icon: iconPath };
+  // rcedit 4.x 参数结构：FileDescription/ProductName 等字符串必须走
+  // version-string（--set-version-string 键值对），file-version/product-version
+  // 才是独立的 --set-* 单值参数。旧版平铺的 file-description/product-name 会被静默忽略。
+  const versionString = {};
+  if (name) {
+    versionString['FileDescription'] = name;
+    versionString['ProductName'] = name;
+  }
+  if (Object.keys(versionString).length > 0) {
+    info['version-string'] = versionString;
+  }
+  if (version) {
+    info['file-version'] = version;
+    info['product-version'] = version;
+  }
+  await rcedit(exePath, info);
+  process.stdout.write(`[freedom] 已注入 exe 图标与版本信息：${iconPath} (${name || '?'} ${version || '?'})\n`);
 }
 
 // 解析 cfg.icon：相对项目根或绝对路径 -> 绝对路径；未配置返回 null。
@@ -497,7 +548,11 @@ function intVal(v, dft) {
 // 导致页面 JS/CSS 丢失静默空白。检测到此类引用时明确告警，避免用户无感知翻车。
 function warnIfNotSingleFile(html, distHtml) {
   const refs = [];
-  const re = /<(?:script|link)\b[^>]*(?:src|href)\s*=\s*["']([^"']+)["']/gi;
+  // M4：此前只检查 script/link，漏掉了 img/iframe/video/audio/source/object/embed/track 等
+  // 一切带 URL 引用的标签。壳只 SetHtml 单页内存加载，任何相对路径 / 根路径 / 协议相对的
+  // 外部引用（JS、CSS、图片、子页面、音视频、内嵌对象）在无服务器环境下都会失效，
+  // 需一并告警，避免"脚本内联了但图片仍空白"这类半翻车。
+  const re = /<(?:script|link|img|iframe|video|audio|source|object|embed|track)\b[^>]*(?:src|href|data)\s*=\s*["']([^"']+)["']/gi;
   let m;
   while ((m = re.exec(html)) !== null) {
     const url = m[1];
@@ -505,6 +560,16 @@ function warnIfNotSingleFile(html, distHtml) {
     if (/^(?:data:|blob:|https?:|file:)/i.test(url)) continue;
     refs.push(url);
   }
+  // img 的 srcset（逗号分隔多候选 URL）单独扫描
+  const srcsetRe = /<img\b[^>]*\bsrcset\s*=\s*["']([^"']+)["']/gi;
+  while ((m = srcsetRe.exec(html)) !== null) {
+    for (const part of m[1].split(',')) {
+      const url = part.trim().split(/\s+/)[0];
+      if (!url) continue;
+      if (/^(?:data:|blob:|https?:|file:)/i.test(url)) continue;
+      refs.push(url);
+    }
+  }
   if (refs.length > 0) {
     console.warn(
       `[freedom] 警告：${path.basename(distHtml)} 引用了外部资源（${refs.join(', ')}）。` +

package/lib/cli.js

@@ -22,12 +22,13 @@ function help() {
   L.push(`  ${paint('freedom', C.fg.cyan, C.bold)}                  ${dim('进入完整 CLI 模式（交互式菜单，新建 / 打包 / 配置 / 壳管理）')}`);
   L.push(`  ${paint('freedom tui', C.fg.cyan, C.bold)}              ${dim('同上（兼容写法，显式进入交互式模式）')}`);
   L.push(section('项目'));
-  L.push(`  ${paint('freedom init [目录] [--force]', C.fg.cyan)}    ${dim('在当前 / 指定目录新建项目模板')}`);
+  L.push(`  ${paint('freedom init [目录] [--force] [--template full|minimal]', C.fg.cyan)}  ${dim('新建项目模板（默认 full：含自绘标题栏示例；minimal：极简无自绘标题栏）')}`);
   L.push(`  ${paint('freedom tutorial', C.fg.cyan)}                 ${dim('再次打开安装教程')}`);
   L.push(section('打包'));
   L.push(`  ${paint('freedom build [--platform <p>]', C.fg.cyan)}   ${dim('前端打包并分发桌面应用（默认当前平台）')}`);
   L.push(`      ${dim('--platform win|mac|linux|all')}    ${dim('指定目标平台（all = 三平台全量）')}`);
   L.push(`      ${dim('--no-cache')}                      ${dim('忽略前端构建缓存，强制重新打包')}`);
+  L.push(`  ${paint('freedom verify [--platform <p>]', C.fg.cyan)}   ${dim('校验已构建产物完整性并打印产物结构（CI 可依赖退出码）')}`);
   L.push(`  ${paint('freedom dmg [--platform <plat>]', C.fg.cyan)}  ${dim('将已构建的 .app 打包为 .dmg（需 macOS）')}`);
   L.push(section('外观'));
   L.push(`  ${paint('freedom titlebar <native|frameless>', C.fg.cyan)} ${dim('一键切换标题栏策略')}`);
@@ -113,9 +114,25 @@ async function run(argv) {
 
     case 'init': {
       const force = rest.includes('--force');
-      const dirArg = rest.filter((a) => a !== '--force')[0];
-      const dir = init(dirArg || '.', { force });
+      const tmplArg = rest.find((a) => a.startsWith('--template'));
+      let template;
+      if (tmplArg) {
+        template = tmplArg.includes('=') ? tmplArg.split('=')[1] : rest[rest.indexOf(tmplArg) + 1];
+        if (!template || template.startsWith('--')) {
+          console.error(`${err('--template 缺少取值。')} ${dim('用法：')}${paint('freedom init <目录> --template <full|minimal>', C.fg.cyan)}`);
+          return 1;
+        }
+      }
+      const dirArg = rest.filter((a) => a !== '--force' && !a.startsWith('--template'))[0];
+      let dir;
+      try {
+        dir = init(dirArg || '.', { force, template });
+      } catch (e) {
+        console.error(`${err(e.message)}`);
+        return 1;
+      }
       console.log(`${ok('项目已创建：')}${paint(dir, C.fg.cyan, C.bold)}`);
+      console.log(`  ${dim(`模板：${template === 'minimal' ? 'minimal（极简，无自绘标题栏）' : 'full（完整，含自绘标题栏示例）'}`)}`);
       console.log(`  ${dim('下一步：')}`);
       console.log(`    ${paint(`cd ${dir}`, C.fg.white)}`);
       console.log(`    ${paint('npm install', C.fg.white)}`);
@@ -161,6 +178,47 @@ async function run(argv) {
       return 0;
     }
 
+    case 'verify': {
+      const platArg = rest.find((a) => a.startsWith('--platform') || a.startsWith('-p'));
+      let platform;
+      if (platArg) {
+        const inline = platArg.includes('=') ? platArg.split('=')[1] : undefined;
+        platform = inline || rest[rest.indexOf(platArg) + 1];
+        if (!platform || platform.startsWith('--')) {
+          console.error(`${err('--platform 缺少取值。')} ${dim('用法：')}${paint('freedom verify [--platform <p>]', C.fg.cyan)}`);
+          return 1;
+        }
+      }
+      const { verifyProduct, renderTree, formatChecks } = require('./verify');
+      const v = await verifyProduct(process.cwd(), { platform });
+      if (v.error) {
+        console.error(`${err('校验失败：')}${v.error}`);
+        return 1;
+      }
+      if (v.targets.length === 0) {
+        console.error(`${err('未在产物目录发现可执行文件。')} ${dim('请先运行')} ${paint('freedom build', C.fg.cyan)} ${dim('生成产物。')}`);
+        return 1;
+      }
+      let allPass = true;
+      for (const t of v.targets) {
+        console.log(`\n${section(`[${t.plat}] ${t.dir}`)}`);
+        for (const c of t.checks) {
+          console.log(`  ${c.pass ? ok('通过') : err('失败')} ${c.name}：${c.detail}`);
+        }
+        allPass = allPass && t.checks.every((c) => c.pass);
+      }
+      console.log(`\n${dim('产物结构：')}`);
+      for (const line of renderTree(v.targets).split('\n')) {
+        console.log(`  ${line}`);
+      }
+      if (allPass) {
+        console.log(`\n${ok('产物校验全部通过。')}`);
+        return 0;
+      }
+      console.log(`\n${err('产物校验存在失败项，请检查上方输出。')}`);
+      return 1;
+    }
+
     case 'shell':
       return await runShell(rest);
 

package/lib/init.js

@@ -12,8 +12,16 @@ function init(targetDir, opts = {}) {
     throw new Error(`目标目录 ${abs} 非空，请使用空目录，或加 --force 覆盖。`);
   }
 
+  // 模板选择：'minimal' 极简（无自绘标题栏 / 无演示内容，默认 native 标题栏）；默认完整模板。
+  // 非法值快速失败，避免静默回退成默认模板让用户误以为指定成功。
+  const template = opts.template || 'full';
+  const templateName = template === 'minimal' ? 'project-minimal' : 'project';
+  if (template !== 'full' && template !== 'minimal') {
+    throw new Error(`未知模板：${template}。可选：full（完整模板，含自绘标题栏示例）/ minimal（极简模板，无自绘标题栏）。`);
+  }
+
   fs.mkdirSync(abs, { recursive: true });
-  copyDir(projectTemplateDir(), abs);
+  copyDir(projectTemplateDir(templateName), abs);
 
   // 项目名替换到 package.json 与 freedom.config.js
   const name = opts.name || path.basename(abs);

package/lib/security.js

@@ -1,6 +1,6 @@
 'use strict';
 
-// 安全加固模块（v1.13.0）
+// 安全加固模块（v1.13.10）
 //
 // 为 freedom build 提供两种安全模式：
 //   - basic（简单模式）：资源压缩 + 壳剥离符号建议，阻止"随手打开 resources/

package/lib/utils.js

@@ -13,8 +13,11 @@ function templateDir() {
   return path.join(PKG_ROOT, 'templates');
 }
 
-function projectTemplateDir() {
-  return path.join(templateDir(), 'project');
+// 项目模板目录：name 为 templates/ 下的子目录名。
+//   'project'        完整模板（默认）：含自绘标题栏（frameless）示例、右键菜单、桥接演示；
+//   'project-minimal' 极简模板：无自绘标题栏 / 无演示内容，默认 native 标题栏，开箱即用。
+function projectTemplateDir(name = 'project') {
+  return path.join(templateDir(), name);
 }
 
 function goTemplateDir() {

package/lib/verify.js

@@ -0,0 +1,236 @@
+'use strict';
+
+// freedom verify：产物完整性自检 + 产物形态树。
+// 供两个场景复用：
+//   1. freedom build 完成后自动调用（发现问题输出告警，但不阻断正常构建流程）；
+//   2. freedom verify 命令独立运行（发现问题返回非零退出码，供 CI / 发布前检查）。
+// 消除"build 后形态未知 / 需手动实测"：自检覆盖可执行文件、resources、安全模式资源形态、
+// 运行时配置一致性、后端目录、Windows PE 头与 high 模式 app.bin 容器头。
+
+const fs = require('fs');
+const path = require('path');
+const { isWinPlat, platformExeName } = require('./utils');
+
+// ---- 产物定位 ----
+
+// 依据项目配置探测 outDir 下的产物目标。
+// 布局：
+//   单平台：outDir/<app>.exe（win）/ outDir/<app>（unix）
+//   多平台：outDir/<plat>/<app>.exe 或 outDir/<plat>/<app>
+// 返回 [{ plat, dir, outFile }]。
+function findProducts(projectDir, cfg) {
+  const name = (cfg.name || 'freedom-app').replace(/[^a-zA-Z0-9_.-]/g, '-');
+  const outDir = String(cfg.outDir || 'dist').trim() || 'dist';
+  const outDirPath = path.resolve(projectDir, outDir);
+  if (!fs.existsSync(outDirPath)) return [];
+
+  const winExe = `${name}.exe`;
+  const targets = [];
+
+  // 平台子目录（--platform all 布局）：目录名即平台 key，目录内含 <app>[.exe] 或 resources/
+  const entries = fs.readdirSync(outDirPath, { withFileTypes: true });
+  for (const e of entries) {
+    if (!e.isDirectory()) continue;
+    const dir = path.join(outDirPath, e.name);
+    const exePath = path.join(dir, isWinPlat(e.name) ? winExe : name);
+    if (fs.existsSync(exePath) || fs.existsSync(path.join(dir, 'resources'))) {
+      targets.push({ plat: e.name, dir, outFile: exePath });
+    }
+  }
+  // 单平台布局：outDir 根下的可执行文件
+  if (targets.length === 0) {
+    for (const p of ['win-x64', 'linux-x64', 'darwin-arm64', 'linux-arm64']) {
+      const exePath = path.join(outDirPath, isWinPlat(p) ? winExe : name);
+      if (fs.existsSync(exePath)) {
+        targets.push({ plat: p, dir: outDirPath, outFile: exePath });
+        break;
+      }
+    }
+  }
+  return targets;
+}
+
+// ---- 单平台自检 ----
+
+function safeStat(p) {
+  try {
+    return fs.statSync(p);
+  } catch (e) {
+    return null;
+  }
+}
+
+function fmtSize(n) {
+  if (n < 1024) return `${n} B`;
+  if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
+  return `${(n / 1024 / 1024).toFixed(2)} MB`;
+}
+
+// 单平台产物校验，返回 [{ name, pass, detail }]。
+function checkPlatformProduct({ targetDir, plat, appName, hasBackend }) {
+  const checks = [];
+  const fail = (name, detail) => checks.push({ name, pass: false, detail });
+  const okc = (name, detail) => checks.push({ name, pass: true, detail });
+
+  // 1) 可执行文件存在且非空
+  const exeName = platformExeName(plat, appName);
+  const exePath = path.join(targetDir, exeName);
+  const exeStat = safeStat(exePath);
+  if (!exeStat) {
+    fail('可执行文件', `缺失：${exeName}`);
+  } else if (exeStat.size <= 0) {
+    fail('可执行文件', `${exeName} 为空文件（0 字节）`);
+  } else {
+    okc('可执行文件', `${exeName}（${fmtSize(exeStat.size)}）`);
+    // Windows 产物校验 PE 头（MZ），杜绝"假壳 / 空壳"被静默分发
+    if (isWinPlat(plat)) {
+      let head = '';
+      try {
+        head = fs.readFileSync(exePath).subarray(0, 2).toString('latin1');
+      } catch (e) { /* 读取失败按不通过处理 */ }
+      if (head === 'MZ') okc('PE 格式', 'MZ 头有效');
+      else fail('PE 格式', '文件头不是 MZ，非有效 Windows 可执行文件');
+    }
+  }
+
+  // 2) resources 目录
+  const resDir = path.join(targetDir, 'resources');
+  const resStat = safeStat(resDir);
+  if (!resStat || !resStat.isDirectory()) {
+    fail('resources 目录', '缺失：resources/');
+    return checks; // 后续资源检查依赖该目录，缺失则提前返回
+  }
+  okc('resources 目录', '存在');
+
+  // 3) 资源形态与安全模式一致（high: app.bin+.integrity；明文: index.html+config.json；互斥）
+  const hasBin = fs.existsSync(path.join(resDir, 'app.bin'));
+  const hasIntegrity = fs.existsSync(path.join(resDir, '.integrity'));
+  const hasHtml = fs.existsSync(path.join(resDir, 'index.html'));
+  const hasConfig = fs.existsSync(path.join(resDir, 'config.json'));
+  if (hasBin) {
+    if (hasHtml || hasConfig) {
+      fail('资源形态', 'high 模式残留明文 index.html/config.json（互斥被破坏）');
+    } else {
+      okc('资源形态', 'high 模式（app.bin + .integrity）');
+    }
+    if (!hasIntegrity) fail('完整性清单', '缺失 .integrity');
+    else okc('完整性清单', '.integrity 存在');
+    // app.bin 容器头校验（FRDM1）
+    let head = '';
+    try {
+      head = fs.readFileSync(path.join(resDir, 'app.bin')).subarray(0, 5).toString('latin1');
+    } catch (e) { /* 读取失败按不通过处理 */ }
+    if (head === 'FRDM1') okc('app.bin 容器', 'FRDM1 头有效');
+    else fail('app.bin 容器', '容器头不是 FRDM1，文件损坏或非本工具产物');
+  } else {
+    if (hasIntegrity) {
+      fail('资源形态', '明文模式残留 high 产物（.integrity）');
+    } else {
+      okc('资源形态', '明文模式（index.html + config.json）');
+    }
+    const htmlStat = safeStat(path.join(resDir, 'index.html'));
+    if (!hasHtml) fail('前端页面', '缺失 resources/index.html');
+    else if (htmlStat.size <= 0) fail('前端页面', 'index.html 为空（0 字节）');
+    else okc('前端页面', `index.html（${fmtSize(htmlStat.size)}）`);
+    if (!hasConfig) {
+      fail('运行时配置', '缺失 resources/config.json');
+    } else {
+      try {
+        const cfg = JSON.parse(fs.readFileSync(path.join(resDir, 'config.json'), 'utf8'));
+        if (cfg.name !== appName) {
+          fail('运行时配置', `config.json name=${cfg.name} 与可执行文件名 ${appName} 不一致`);
+        } else {
+          okc('运行时配置', `config.json 可解析，name=${cfg.name} 一致`);
+        }
+      } catch (e) {
+        fail('运行时配置', `config.json 解析失败：${e.message}`);
+      }
+    }
+  }
+
+  // 4) 后端目录
+  if (hasBackend) {
+    if (fs.existsSync(path.join(resDir, 'backend'))) okc('后端进程', 'resources/backend 存在');
+    else fail('后端进程', '配置了 backend 但 resources/backend 缺失');
+  }
+
+  return checks;
+}
+
+// ---- 对外入口 ----
+
+// 校验项目产物。返回 { ok, targets: [{ plat, dir, outFile, checks }] }。
+async function verifyProduct(projectDir, opts = {}) {
+  const dir = path.resolve(projectDir || '.');
+  const { loadConfig } = require('./utils');
+  let cfg;
+  try {
+    cfg = await loadConfig(dir);
+  } catch (e) {
+    return { ok: false, targets: [], error: e.message };
+  }
+  const appName = (cfg.name || 'freedom-app').replace(/[^a-zA-Z0-9_.-]/g, '-');
+  const hasBackendDir = !!(cfg.backend && fs.existsSync(path.join(dir, cfg.backendDir || 'backend')));
+
+  const targets = findProducts(dir, cfg)
+    .filter((t) => !opts.platform || t.plat === opts.platform)
+    .map((t) => ({ ...t, checks: checkPlatformProduct({ targetDir: t.dir, plat: t.plat, appName, hasBackend: hasBackendDir }) }));
+
+  const ok = targets.length > 0 && targets.every((t) => t.checks.every((c) => c.pass));
+  return { ok, targets, appName };
+}
+
+// ---- 产物形态树 ----
+
+// 递归收集目录树：[{ rel, size, isDir, depth }]，depth 限制避免深层目录（如 backend/node_modules）爆炸。
+function collectTree(dir, depth, out, maxDepth) {
+  let entries;
+  try {
+    entries = fs.readdirSync(dir, { withFileTypes: true });
+  } catch (e) {
+    return out;
+  }
+  for (const e of entries) {
+    if (e.name === '.integrity') {
+      // 完整性清单内容为敏感校验值，仅标注存在与大小，不展开内容
+      out.push({ rel: e.name, size: 0, isDir: false, depth, hidden: true });
+      continue;
+    }
+    const abs = path.join(dir, e.name);
+    const stat = safeStat(abs);
+    if (e.isDirectory()) {
+      out.push({ rel: e.name, size: 0, isDir: true, depth });
+      if (depth < maxDepth) collectTree(abs, depth + 1, out, maxDepth);
+    } else if (stat) {
+      out.push({ rel: e.name, size: stat.size, isDir: false, depth });
+    }
+  }
+  return out;
+}
+
+function renderTree(targets) {
+  const lines = [];
+  for (const t of targets) {
+    lines.push(`${t.dir}`);
+    const maxDepth = 5;
+    const tree = collectTree(t.dir, 1, [], maxDepth).sort((a, b) => {
+      if (a.depth !== b.depth) return a.depth - b.depth;
+      return a.rel.localeCompare(b.rel);
+    });
+    // 同层排序：目录优先，保证层级清晰
+    for (const node of tree) {
+      const prefix = '  '.repeat(node.depth) + (node.isDir ? '[dir] ' : '      ');
+      const size = node.isDir ? '' : ` (${fmtSize(node.size)})`;
+      const hidden = node.hidden ? ' [校验值]' : '';
+      lines.push(`${prefix}${node.rel}${size}${hidden}`);
+    }
+  }
+  return lines.join('\n');
+}
+
+// 校验项 -> 可打印行（build 自动自检 / verify 命令共用；纯文本，跨平台不依赖彩色终端）
+function formatChecks(checks) {
+  return checks.map((c) => `${c.pass ? '[通过]' : '[失败]'} ${c.name}：${c.detail}`);
+}
+
+module.exports = { verifyProduct, findProducts, checkPlatformProduct, renderTree, formatChecks };

package/package.json

@@ -1,39 +1,39 @@
-{
-  "name": "@yufengtadian/freedom-cli",
-  "version": "1.12.17",
-  "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"
-  },
-  "bin": {
-    "freedom": "bin/freedom.js"
-  },
-  "files": [
-    "bin",
-    "lib",
-    "shell",
-    "templates",
-    "tutorial",
-    "postinstall.js",
-    "README.md"
-  ],
-  "scripts": {
-    "postinstall": "node postinstall.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "rcedit": "^4.0.1"
-  }
-}
+{
+  "name": "@yufengtadian/freedom-cli",
+  "version": "1.12.18",
+  "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"
+  },
+  "bin": {
+    "freedom": "bin/freedom.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "shell",
+    "templates",
+    "tutorial",
+    "postinstall.js",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "rcedit": "^4.0.1"
+  }
+}

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

@@ -52,16 +52,10 @@
       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'); },
     },
   };
 
@@ -71,19 +65,14 @@
     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;
-    // 所有桥接调用均带 .catch：页面先于桥接就绪时点击按钮会产生未捕获的
-    // Promise rejection（并导致自绘标题栏静默失效），此处兜底为控制台告警。
-    if (min) min.addEventListener('click', function () {
-      self.minimize().catch(function (e) { console.warn('[freedom] minimize:', e); });
-    });
+    var ignoreErr = function () { /* 桥接未就绪（如窗口销毁中）时忽略本次操作 */ };
+    if (min) min.addEventListener('click', function () { self.minimize().catch(ignoreErr); });
     if (max) max.addEventListener('click', function () {
       self.isMaximized().then(function (m) {
-        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 (m) self.unmaximize(); else self.maximize();
+      }).catch(ignoreErr);
     });
+    if (close) close.addEventListener('click', function () { self.close().catch(ignoreErr); });
   };
 
   function windowAction(action) {
@@ -106,4 +95,18 @@
   window.go = go;
 
   window.freedom = freedom;
+
+  // H3：页面就绪回调。Go 侧 onReady 改为在 __freedom__ready 被调用时触发
+  //（此前在 SetHtml 前触发，期间 Emit 的初始化事件因 SDK 尚未建立而丢失）。
+  // DOMContentLoaded 后上报就绪；若脚本执行时 DOM 已加载完成则立即上报。
+  function signalReady() {
+    if (typeof window.__freedom__ready === 'function') {
+      try { window.__freedom__ready(); } catch (e) { /* 忽略 */ }
+    }
+  }
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', signalReady);
+  } else {
+    signalReady();
+  }
 })();

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

@@ -261,7 +261,13 @@ func (p *ProcBackend) Close() error {
 	case <-time.After(3 * time.Second):
 		if cmd.Process != nil {
 			_ = cmd.Process.Kill()
-			<-done
+			// M2：Kill 后进程仍可能不退出（僵死/句柄被占用/权限拒绝），
+			// 再等一小段，仍不退则放弃等待，避免 Close 永久阻塞壳退出。
+			select {
+			case <-done:
+			case <-time.After(time.Second):
+				fmt.Fprintf(os.Stderr, "freedom: proc backend: process did not exit after kill\n")
+			}
 		}
 	}
 	return nil