@yufengtadian/freedom-cli 1.12.16 → 1.12.18

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.16",
-  "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/anti_debug_other.go

@@ -0,0 +1,8 @@
+//go:build !windows
+
+package freedom
+
+// 反调试（非 Windows 平台空实现）。
+// macOS/Linux 的调试器检测（ptrace / task_for_pid 等）依赖平台特定 API，
+// 本版本不做；如需加强可在对应平台文件扩展。
+func antiDebugCheck() {}

package/templates/go/pkg/freedom/anti_debug_windows.go

@@ -0,0 +1,39 @@
+//go:build windows
+
+package freedom
+
+// 反调试（Windows 实现）：high 安全模式下调用。
+// 检测常见用户态调试器，发现时静默退出，防止攻击者在调试器下
+// 单步追踪资源解密 / 密钥派生逻辑。
+
+import (
+	"os"
+	"syscall"
+	"unsafe"
+)
+
+var (
+	kernel32dbg                      = syscall.NewLazyDLL("kernel32.dll")
+	procIsDebuggerPresent            = kernel32dbg.NewProc("IsDebuggerPresent")
+	procCheckRemoteDebuggerPresent   = kernel32dbg.NewProc("CheckRemoteDebuggerPresent")
+)
+
+// antiDebugCheck 检测调试器；发现则立即退出进程（退出码 77，无提示）。
+// 仅在 high 安全模式启用时由 freedom.go Run() 调用。
+func antiDebugCheck() {
+	if isBeingDebugged() {
+		os.Exit(77)
+	}
+}
+
+// isBeingDebugged 同时检测本地调试器（IsDebuggerPresent）与远程/内核调试器
+// （CheckRemoteDebuggerPresent），任一命中即认为正在被调试。
+func isBeingDebugged() bool {
+	r, _, _ := procIsDebuggerPresent.Call()
+	if r != 0 {
+		return true
+	}
+	var present int32
+	procCheckRemoteDebuggerPresent.Call(uintptr(0), uintptr(unsafe.Pointer(&present)))
+	return present != 0
+}

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

package/templates/go/pkg/freedom/center_windows.go

@@ -46,30 +46,48 @@ func (a *App) applyCenter() {
 		mi.cbSize = uint32(unsafe.Sizeof(mi))
 		if r1, _, _ := procGetMonitorInfo.Call(mon, uintptr(unsafe.Pointer(&mi))); r1 != 0 {
 			work := mi.rcWork
-			sw := work.right - work.left
-			sh := work.bottom - work.top
-			x := work.left + (sw-int32(a.cfg.Width))/2
-			y := work.top + (sh-int32(a.cfg.Height))/2
-			if x < 0 {
-				x = 0
-			}
-			if y < 0 {
-				y = 0
-			}
+			sw := int(work.right - work.left)
+			sh := int(work.bottom - work.top)
+			// M5：窗口居中坐标双向 clamp。逻辑抽到 clampCentered 便于无头单测。
+			x, y := clampCentered(a.cfg.Width, a.cfg.Height, int(work.left), int(work.top), sw, sh)
 			procMoveWindow.Call(hwnd, uintptr(x), uintptr(y), uintptr(a.cfg.Width), uintptr(a.cfg.Height), 1)
 			return
 		}
 	}
-	// 回退：主屏全屏尺寸居中（原实现）
+	// 回退：主屏全屏尺寸居中（M5 同双向 clamp，上界不小于下界 0）
 	sw, _, _ := procGetSystemMetrics.Call(smCxScreen)
 	sh, _, _ := procGetSystemMetrics.Call(smCyScreen)
-	x := int(sw/2) - a.cfg.Width/2
-	y := int(sh/2) - a.cfg.Height/2
-	if x < 0 {
-		x = 0
+	// 主屏全屏居中：等价于左上 (0,0) 的工作区，同走 clampCentered 双向 clamp。
+	x, y := clampCentered(a.cfg.Width, a.cfg.Height, 0, 0, int(sw), int(sh))
+	procMoveWindow.Call(hwnd, uintptr(x), uintptr(y), uintptr(a.cfg.Width), uintptr(a.cfg.Height), 1)
+}
+
+// clampCentered 计算窗口在其所在工作区内的居中左上角坐标，并做双向 clamp：
+// 窗口小于工作区时严格居中；窗口大于工作区时贴左上缘，保证窗口整体落在
+// 工作区内、可被拖拽恢复（M5——此前只 clamp 下界，窗口超屏时上界 work.right-w
+// 越过下界 work.left，上下界互打架会把坐标钳回负值；现上界不小于下界）。
+func clampCentered(winW, winH, left, top, workW, workH int) (int, int) {
+	x := left + (workW-winW)/2
+	y := top + (workH-winH)/2
+	upperX := left + workW - winW
+	if upperX < left {
+		upperX = left
 	}
-	if y < 0 {
-		y = 0
+	upperY := top + workH - winH
+	if upperY < top {
+		upperY = top
 	}
-	procMoveWindow.Call(hwnd, uintptr(x), uintptr(y), uintptr(a.cfg.Width), uintptr(a.cfg.Height), 1)
+	if x < left {
+		x = left
+	}
+	if x > upperX {
+		x = upperX
+	}
+	if y < top {
+		y = top
+	}
+	if y > upperY {
+		y = upperY
+	}
+	return x, y
 }

package/templates/go/pkg/freedom/center_windows_test.go

@@ -0,0 +1,32 @@
+//go:build windows
+
+package freedom
+
+import "testing"
+
+// TestClampCentered 覆盖 M5 双向 clamp 的所有分支：
+// 小窗严格居中 / 超屏贴左上（上下界互打架）/ 副屏负坐标 / 右缘与下缘不越界。
+func TestClampCentered(t *testing.T) {
+	cases := []struct {
+		name                         string
+		winW, winH, left, top        int
+		workW, workH, wantX, wantY   int
+	}{
+		{"主屏小窗严格居中", 240, 180, 0, 0, 1920, 1040, 840, 430},
+		{"主屏超屏贴左上角", 3000, 2000, 0, 0, 1920, 1040, 0, 0},
+		{"副屏负坐标居中", 800, 600, -1920, 0, 1920, 1080, -1360, 240},
+		{"右缘不越界", 1900, 1000, 0, 0, 1920, 1080, 10, 40},
+		{"窗口恰等于工作区", 1920, 1040, 0, 0, 1920, 1040, 0, 0},
+		{"副屏超屏上界回贴左上", 3000, 2000, -1920, 0, 1920, 1040, -1920, 0},
+		{"高度触下缘", 200, 1040, 0, 0, 1920, 1040, 860, 0},
+	}
+	for _, c := range cases {
+		t.Run(c.name, func(t *testing.T) {
+			x, y := clampCentered(c.winW, c.winH, c.left, c.top, c.workW, c.workH)
+			if x != c.wantX || y != c.wantY {
+				t.Fatalf("clampCentered(%d,%d,%d,%d,%d,%d) = (%d,%d), want (%d,%d)",
+					c.winW, c.winH, c.left, c.top, c.workW, c.workH, x, y, c.wantX, c.wantY)
+			}
+		})
+	}
+}

package/templates/go/pkg/freedom/configfile.go

@@ -18,6 +18,42 @@ import (
 	"path/filepath"
 )
 
+// secureFatalError 表示 high 安全模式下资源加载/校验失败（app.bin 存在但读取、
+// 解密或完整性校验不通过）。此类错误必须"拒绝运行"（不显示窗口、不回退占位页），
+// 防止资源被篡改/替换/密钥不匹配后静默降级运行（H2）。
+type secureFatalError struct{ err error }
+
+func (e *secureFatalError) Error() string { return e.err.Error() }
+func (e *secureFatalError) Unwrap() error { return e.err }
+
+// secureFatal 将 loadSecureResources 的错误包装为安全致命错误。
+// loadSecureResources 已区分：app.bin 不存在时返回 hit=false（非 high 产物），
+// 其余错误均为"存在但读取/解密/校验失败"，正是需要拒绝运行的场景。
+func secureFatal(err error) error {
+	return &secureFatalError{err: err}
+}
+
+// loadRuntimeConfig 读取 exe 同目录 resources/config.json，将命中的字段覆盖到应用配置。
+// 文件不存在时视为未配置（返回 nil，保持编译期/默认配置不变）；
+// 文件存在但读取/解析失败时返回具体错误，由调用方打印告警，避免用户手改配置出错时无感知。
+func (a *App) loadRuntimeConfig() error {
+	// high 安全模式：配置与页面封装在加密容器 app.bin 内，优先内存解密加载。
+	if p, hit, err := loadSecureResources(); err != nil {
+		return secureFatal(err)
+	} else if hit {
+		var rc runtimeConfigFile
+		if err := json.Unmarshal([]byte(p.Config), &rc); err != nil {
+			return fmt.Errorf("parse encrypted config: %w", err)
+		}
+		a.applyRuntimeConfig(&rc)
+		// high 模式强制关闭 WebView 开发者工具，防止前端源码经 devtools 直接查看。
+		a.cfg.Debug = false
+		a.secure = true
+		return nil
+	}
+	return a.loadRuntimeConfigPlain()
+}
+
 // runtimeBackend 描述 config.json 中的后端进程配置（任意语言，经 stdio NDJSON 桥接）。
 type runtimeBackend struct {
 	Command string   `json:"command"`
@@ -48,10 +84,8 @@ func resourcesDir() (string, error) {
 	return filepath.Join(filepath.Dir(exe), "resources"), nil
 }
 
-// loadRuntimeConfig 读取 exe 同目录 resources/config.json，将命中的字段覆盖到应用配置。
-// 文件不存在时视为未配置（返回 nil，保持编译期/默认配置不变）；
-// 文件存在但读取/解析失败时返回具体错误，由调用方打印告警，避免用户手改配置出错时无感知。
-func (a *App) loadRuntimeConfig() error {
+// loadRuntimeConfigPlain 明文配置路径（非 high 模式）：读取 resources/config.json。
+func (a *App) loadRuntimeConfigPlain() error {
 	dir, err := resourcesDir()
 	if err != nil {
 		return err
@@ -68,10 +102,19 @@ func (a *App) loadRuntimeConfig() error {
 	if err := json.Unmarshal(data, &rc); err != nil {
 		return fmt.Errorf("parse %s: %w", cfgPath, err)
 	}
+	if err := a.applyRuntimeConfig(&rc); err != nil {
+		return err
+	}
+	return nil
+}
+
+// applyRuntimeConfig 把解析后的运行时配置覆盖到应用配置（明文与加密路径共用）。
+func (a *App) applyRuntimeConfig(rc *runtimeConfigFile) error {
+	// 窗口标题：config.json 的 title 覆盖编译期默认（"Freedom App"）。
+	// 此前只解析未应用，导致改 freedom.config.js 的 name/title 无效、
+	// 打包产物窗口标题永远停留在默认值（"无法修改程序名字"）。
 	if rc.Title != "" {
 		a.cfg.Title = rc.Title
-	} else if rc.Name != "" {
-		a.cfg.Title = rc.Name
 	}
 	switch rc.TitleBar {
 	case "native":
@@ -112,8 +155,14 @@ func (a *App) loadRuntimeConfig() error {
 	return nil
 }
 
-// loadRuntimeHTML 读取 exe 同目录 resources/index.html；文件不存在时返回空串。
+// loadRuntimeHTML 返回前端页面内容（high 模式：解密 app.bin 内的 html；
+// 否则读取 exe 同目录 resources/index.html）。文件不存在时返回空串。
 func loadRuntimeHTML() (string, error) {
+	if p, hit, err := loadSecureResources(); err != nil {
+		return "", secureFatal(err)
+	} else if hit {
+		return p.HTML, nil
+	}
 	dir, err := resourcesDir()
 	if err != nil {
 		return "", err