react-native-flux-desktop-packer 0.1.4 → 0.1.7

package/lib/brand.js

@@ -111,15 +111,16 @@ async function brandRuntime(exePath, { projectRoot, iconPngPaths, name, descript
     args.push('--set-file-version', v, '--set-product-version', v);
   }
   if (ico) args.push('--set-icon', ico);
+  let branded = false;
   try {
     const r = cp.spawnSync(bin, args, { windowsHide: true, encoding: 'utf8', timeout: 60000 });
     if (r.error) throw r.error;
     if (r.status !== 0) throw new Error(String(r.stderr || r.stdout || '').trim() || 'exit ' + r.status);
     ok(`exe 已注入品牌：${path.basename(exePath)}${ico ? ' + 图标' : ''}`);
-    return true;
+    branded = true;
   } catch (e) {
     warn(`rcedit 注入失败（忽略）：${(e && e.message) || e}`);
-    return false;
+    branded = false;
   } finally {
     if (ico) {
       try {
@@ -129,6 +130,38 @@ async function brandRuntime(exePath, { projectRoot, iconPngPaths, name, descript
       }
     }
   }
+  if (!branded) return false;
+  // 回读硬校验：FileDescription 决定任务栏/Alt-Tab 分组名。历史上曾因「打包用的是陈旧 file: 拷贝、
+  // 该行被注释」而反复静默翻车（rcedit 跑了、ProductName 改了，唯独 FileDescription 仍是 Node 默认）。
+  // 故注入成功后回读确认：若仍为 node.exe 默认名 → 抛 brandFatal，让打包直接失败而非静默出货。
+  const got = readFileDescription(exePath);
+  if (got === null) {
+    warn('未能回读 FileDescription 校验（非 Windows 或 PowerShell 不可用）——请人工确认任务栏分组名已品牌化');
+  } else if (got === '' || /node\.?js javascript runtime/i.test(got)) {
+    const err = new Error(
+      `FileDescription 注入未生效：回读为「${got || '(空)'}」，任务栏/进程名仍会显示 Node.js 默认。` +
+        `（若本地打包反复出现此错，多半是消费方 node_modules 里的 packer 为陈旧 file: 拷贝，需同步 lib/）\nrcedit args=${JSON.stringify(args)}`
+    );
+    err.brandFatal = true;
+    throw err;
+  } else {
+    ok(`FileDescription 回读校验通过：${got}`);
+  }
+  return true;
+}
+
+/** 读回 exe 内嵌的 FileDescription（Windows 经 PowerShell 的 VersionInfo）；无法读取返回 null。 */
+function readFileDescription(exePath) {
+  if (process.platform !== 'win32') return null;
+  try {
+    const lit = "'" + String(exePath).replace(/'/g, "''") + "'"; // PowerShell 单引号字面量转义
+    const cmd = `(Get-Item -LiteralPath ${lit}).VersionInfo.FileDescription`;
+    const r = cp.spawnSync('powershell', ['-NoProfile', '-Command', cmd], { windowsHide: true, encoding: 'utf8', timeout: 15000 });
+    if (r.error || r.status !== 0) return null;
+    return String(r.stdout || '').trim();
+  } catch {
+    return null;
+  }
 }
 
-module.exports = { brandRuntime, buildIcoFromPngs, resolveRcedit, resolveRceditBin };
+module.exports = { brandRuntime, buildIcoFromPngs, resolveRcedit, resolveRceditBin, readFileDescription };

package/lib/bundle.js

@@ -21,6 +21,8 @@ const EXTERNALS = [
   'react-native-flux-desktop-linux-*',
   'react-native-flux-desktop-android-*',
   'react-native-flux-desktop-freebsd-*',
+  // 各原生扩展分支包的裸平台包名（ffi / webview / 未来新增）：保持 external，运行期由 bootstrap 钩子重定向到自解压目录
+  'react-native-flux-desktop-*-win32-x64-msvc',
   // @napi-rs/canvas 的平台预编译包（skia .node 由 bootstrap 经 env 指向解压副本）
   '@napi-rs/canvas-win32-x64-msvc',
   '@napi-rs/canvas-win32-x64-gnu',

package/lib/config.js

@@ -47,6 +47,16 @@ function loadConfig(projectRoot) {
   const packMode = packObj.mode === 'sea' ? 'sea' : 'folder';
   // 资源目录（相对项目根），sea 模式内嵌进 exe、运行时解压到 cwd；folder 模式整目录拷贝
   const assetsDirRel = typeof packObj.assets === 'string' ? packObj.assets : 'assets';
+  // 目标原生库（相对项目根路径数组）：随包拷进运行目录，运行期 ffi.open(相对路径) 按 cwd 命中。
+  const nativeLibs = Array.isArray(packObj.nativeLibs)
+    ? packObj.nativeLibs
+    : Array.isArray(app.nativeLibs)
+    ? app.nativeLibs
+    : [];
+  // 第三方原生包（sea 模式）：nativePackages 强制纳入整包落盘；skipNative 排除自动扫描命中的包。
+  // 二者均可缺省——sea 会自动扫描 node_modules 下含 .node 的第三方包，这里仅作兑底。
+  const nativePackages = Array.isArray(packObj.nativePackages) ? packObj.nativePackages : [];
+  const skipNative = Array.isArray(packObj.skipNative) ? packObj.skipNative : [];
 
   const cfg = {
     projectRoot,
@@ -58,6 +68,9 @@ function loadConfig(projectRoot) {
     outputRel: output,
     packMode,
     assetsDirRel,
+    nativeLibs,
+    nativePackages,
+    skipNative,
     // 归一化入口为平台分隔（Go 里用 dist\\Gallery.js）
     mainRel: main.split('/').join(path.sep),
     // 数据/缓存目录用的应用名（与启动器 sanitize 同规则：空格/斜杠等转 '-'）

package/lib/index.js

@@ -79,6 +79,17 @@ async function pack(options = {}) {
       fs.copyFileSync(src, path.join(stage, item));
     }
   }
+  // 目标原生库（ffi）：按相对路径拷进负载根，运行期 ffi.open(相对) 按 cwd 命中。
+  for (const rel of (cfg.nativeLibs || [])) {
+    const src = path.join(projectRoot, rel);
+    if (!fs.existsSync(src)) {
+      warn(`nativeLibs 跳过（不存在）：${rel}`);
+      continue;
+    }
+    const dst = path.join(stage, rel);
+    ensureDir(path.dirname(dst));
+    fs.copyFileSync(src, dst);
+  }
   // 捆绑当前 node.exe，但以应用名落盘（napi ABI 稳定，跨大版本可加载）。
   // 运行时进程改名 → 任务管理器「详细信息」页的名称列不再显示 node.exe（node 不校验自身文件名，改名照常运行）。
   const runtimeName = exeBase + '.exe';
@@ -98,6 +109,7 @@ async function pack(options = {}) {
       version: cfg.version,
     });
   } catch (e) {
+    if (e && e.brandFatal) throw e; // FileDescription 回读不达标 → 硬失败，不静默出货
     warn(`运行时 exe 品牌注入异常（忽略）：${e.message}`);
   }
 

package/lib/sea.js

@@ -61,29 +61,174 @@ function walkFiles(base, rel = '') {
 
 /**
  * 收集需内嵌为 SEA assets 的原生/数据文件。
- * @returns {{rnfd:string,skia:string,icu:string}} 绝对路径
+ * 通用发现：node_modules 下所有 react-native-flux-desktop* 包根的 *.win32-x64-msvc.node
+ * ——覆盖主包 + 各原生扩展分支包（ffi / webview / 未来新增），不再逐包硬编码。
+ * @returns {{natives:{base:string,abs:string}[],rnfdBase:string,skia:string,icu:string}}
  */
 function locateNatives(projectRoot) {
-  const roots = [path.join(projectRoot, 'node_modules')];
-  const pick = (rel) => {
-    for (const r of roots) {
-      const f = findFirst(r, rel);
-      if (f) return f;
+  const nm = path.join(projectRoot, 'node_modules');
+  // @napi-rs/canvas 平台包：命名特殊（skia.node + icudtl.dat 同目录），单独处理
+  const canvasPkg = path.join(nm, '@napi-rs', 'canvas-win32-x64-msvc');
+  const skia = findFirst(canvasPkg, ['skia.win32-x64-msvc.node']);
+  const icu = findFirst(canvasPkg, ['icudtl.dat']);
+  // 通用扫 flux 系原生 .node（主包与所有扩展分支包一视同仁）
+  const natives = [];
+  let dirs = [];
+  try { dirs = fs.readdirSync(nm); } catch { dirs = []; }
+  for (const d of dirs) {
+    if (!d.startsWith('react-native-flux-desktop')) continue;
+    let files = [];
+    try { files = fs.readdirSync(path.join(nm, d)); } catch { continue; }
+    for (const f of files) {
+      if (/\.win32-x64-msvc\.node$/.test(f)) natives.push({ base: f, abs: path.join(nm, d, f) });
     }
-    // 兜底：全局扫 node_modules（同名 .node 可能嵌在 pkg 副本里）
-    return null;
-  };
-  const rnfd = pick(['react-native-flux-desktop', 'react-native-flux-desktop.win32-x64-msvc.node']);
-  const skia = pick(['@napi-rs', 'canvas-win32-x64-msvc', 'skia.win32-x64-msvc.node']);
-  const icu = pick(['@napi-rs', 'canvas-win32-x64-msvc', 'icudtl.dat']);
+  }
+  const rnfdBase = 'react-native-flux-desktop.win32-x64-msvc.node';
   const miss = [];
-  if (!rnfd) miss.push('react-native-flux-desktop.win32-x64-msvc.node');
+  if (!natives.some((n) => n.base === rnfdBase)) miss.push(rnfdBase);
   if (!skia) miss.push('skia.win32-x64-msvc.node');
   if (!icu) miss.push('icudtl.dat');
   if (miss.length) throw new Error(`未找到原生依赖：${miss.join(', ')}\n（sea 模式需在项目 node_modules 里存在这些 .node/dat）`);
-  return { rnfd, skia, icu };
+  return { natives, rnfdBase, skia, icu };
+}
+
+// 判定一个包目录内（递归）是否存在 .node。不递归进嵌套 node_modules（其依赖作为顶层包单独处理）。
+function pkgHasNodeFile(dir, depth = 0) {
+  if (depth > 8) return false;
+  let items;
+  try {
+    items = fs.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return false;
+  }
+  for (const it of items) {
+    if (it.name === 'node_modules') continue;
+    const a = path.join(dir, it.name);
+    if (it.isDirectory()) {
+      if (pkgHasNodeFile(a, depth + 1)) return true;
+    } else if (/\.node$/.test(it.name)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+// 列出 node_modules 下所有包（含 @scope/*），返回 [{name, absDir}]。
+function listInstalledPackages(nm) {
+  const out = [];
+  let top;
+  try {
+    top = fs.readdirSync(nm, { withFileTypes: true });
+  } catch {
+    return out;
+  }
+  for (const it of top) {
+    if (!it.isDirectory() || it.name.startsWith('.')) continue;
+    const abs = path.join(nm, it.name);
+    if (it.name.startsWith('@')) {
+      let subs;
+      try {
+        subs = fs.readdirSync(abs, { withFileTypes: true });
+      } catch {
+        subs = [];
+      }
+      for (const s of subs) {
+        if (s.isDirectory() && fs.existsSync(path.join(abs, s.name, 'package.json'))) {
+          out.push({ name: it.name + '/' + s.name, absDir: path.join(abs, s.name) });
+        }
+      }
+    } else if (fs.existsSync(path.join(abs, 'package.json'))) {
+      out.push({ name: it.name, absDir: abs });
+    }
+  }
+  return out;
+}
+
+/**
+ * 收集需在 sea 下「整包原样落盘」的第三方原生包（node-pty / 未来 mysql/redis/better-sqlite3…）。
+ * 自动扫描 node_modules 下含 .node 的包 + cfg.nativePackages 强制纳入，剔 cfg.skipNative；
+ * 已特殊处理的 rnfd 系与 @napi-rs/canvas 不走本通道。再沿 runtime dependencies 求闭包，
+ * 确保被外置包的纯 JS 依赖也在磁盘上可解析。
+ * @returns {{name:string, absDir:string, native:boolean}[]} native=true 者需标为 esbuild external
+ */
+function collectNativePackages(projectRoot, cfg) {
+  const nm = path.join(projectRoot, 'node_modules');
+  const extra = (cfg && Array.isArray(cfg.nativePackages) && cfg.nativePackages) || [];
+  const skip = new Set((cfg && Array.isArray(cfg.skipNative) && cfg.skipNative) || []);
+  const isSpecial = (name) =>
+    name.startsWith('react-native-flux-desktop') || name === '@napi-rs/canvas' || name.startsWith('@napi-rs/canvas-');
+  // @types/* 为纯 TypeScript 声明包：运行时无 require，闭包不该把它拉进来（且个别 .d.ts 内嵌 SEA fuse 串会污染 blob）
+  const isTypeOnly = (name) => name.startsWith('@types/');
+
+  const all = listInstalledPackages(nm);
+  const byName = new Map(all.map((p) => [p.name, p]));
+
+  // 1) 命中的原生包（自动扫描 或 显式纳入）
+  const nativeNames = new Set();
+  for (const p of all) {
+    if (isSpecial(p.name) || isTypeOnly(p.name) || skip.has(p.name)) continue;
+    if (extra.includes(p.name) || pkgHasNodeFile(p.absDir)) nativeNames.add(p.name);
+  }
+  // 显式纳入但 node_modules 里找不到的 → 告警（配置错误早暴露）
+  for (const e of extra) {
+    if (!byName.has(e)) warn(`nativePackages 声明的包不在 node_modules：${e}（已忽略）`);
+  }
+
+  // 2) 沿 runtime deps 求闭包（仅纳入顶层能解析到的）
+  const closure = new Map(); // name -> {name, absDir, native}
+  const queue = [];
+  for (const n of nativeNames) {
+    const p = byName.get(n);
+    if (p) {
+      closure.set(n, { name: n, absDir: p.absDir, native: true });
+      queue.push(n);
+    }
+  }
+  while (queue.length) {
+    const name = queue.shift();
+    const p = byName.get(name);
+    if (!p) continue;
+    let deps = [];
+    try {
+      deps = Object.keys(JSON.parse(fs.readFileSync(path.join(p.absDir, 'package.json'), 'utf8')).dependencies || {});
+    } catch {
+      deps = [];
+    }
+    for (const d of deps) {
+      if (isSpecial(d) || isTypeOnly(d) || skip.has(d) || closure.has(d)) continue;
+      const dp = byName.get(d);
+      if (dp) {
+        closure.set(d, { name: d, absDir: dp.absDir, native: false });
+        queue.push(d);
+      }
+    }
+  }
+  return [...closure.values()];
+}
+
+/** 第三方原生包落盘时的逐文件裁剪：只留 win32-x64 二进制 + 运行时 JS，剔除其它平台与非运行时文件。 */
+function nativeAssetFilter(relIn) {
+  const rel = '/' + relIn.split(path.sep).join('/');
+  const base = rel.split('/').pop();
+  // 声明文件运行时无用（纯类型），一律剔除——既瘦身，又避免个别 .d.ts 内嵌串（如 @types/node/sea.d.ts 的 SEA fuse）污染 blob
+  if (/\.d\.ts$/.test(base)) return false;
+  // 其它平台原生产物（win32-x64 之外）一律丢弃
+  const pm = /\/prebuilds\/([^/]+)\//.exec(rel);
+  if (pm && pm[1] !== 'win32-x64') return false;
+  if (/\/prebuilds\/(darwin|linux|freebsd|android|sunos|aix|win32-arm64|win32-ia32)\b/.test(rel)) return false;
+  if (base && /-(darwin|linux|freebsd|android)-(x64|arm64|ia32|arm-eabi|arm64-v8a)/.test(base)) return false;
+  if (base && /-win32-(arm64|ia32)/.test(base)) return false;
+  // 明确的构建/非运行时目录（不含 src：某些包 main 指向 src）
+  if (/\/(deps|test|tests|examples|example|\.github|typings)\//.test(rel)) return false;
+  if (/\/third_party\//.test(rel)) return false;
+  // 非运行时扩展
+  if (/\.(pdb|map|cc|cpp|c|h|hpp|ts|tsx|md|yml|yaml|gyp|gypi|editorconfig)$/.test(base)) return false;
+  if (/\.(test|spec)\.js$/.test(base)) return false;
+  if (base === 'binding.gyp') return false;
+  return true;
 }
 
+
 // 生成 bootstrap.cjs 源码（SEA main）。manifest 以 JSON 字面量注入。
 function makeBootstrap(manifest) {
   return `// 自动生成：react-native-flux-desktop-packer sea bootstrap（请勿手改）
@@ -121,14 +266,21 @@ if (!fs.existsSync(appMarker) || fs.readFileSync(appMarker).toString() !== sig)
 // 3) @napi-rs/canvas：绝对路径直指解压后的 skia（最高优先级）
 process.env.NAPI_RS_NATIVE_LIBRARY_PATH = path.join(dir, MANIFEST.skiaRel);
 
-// 4) 自研原生：bare/相对 .node 重定向到 dir（全局钩子，对 createRequire 加载的模块同样生效）
-const RNFD = 'react-native-flux-desktop.win32-x64-msvc.node';
-const RNFD_ABS = path.join(dir, RNFD);
+// 4) 自研原生（主包 + 各扩展分支包 ffi/webview/…）：相对 .node 与 bare 平台包名一律重定向到 dir。
+//    通用规则，新增扩展包无需改此处——只要它的 .node 被 locateNatives 收集进 MANIFEST.natives。
+const NATIVE_LIST = MANIFEST.natives || [];
+const NATIVE_SET = new Set(NATIVE_LIST);
 const origResolve = Module._resolveFilename;
 Module._resolveFilename = function (request) {
   if (typeof request === 'string') {
-    if (request === 'react-native-flux-desktop-win32-x64-msvc') return RNFD_ABS;
-    if (request.indexOf(RNFD) >= 0) return RNFD_ABS;
+    for (let i = 0; i < NATIVE_LIST.length; i++) {
+      if (request.indexOf(NATIVE_LIST[i]) >= 0) return path.join(dir, NATIVE_LIST[i]);
+    }
+    const m = /^(react-native-flux-desktop(?:-[a-z0-9]+)*?)-win32-x64-msvc$/.exec(request);
+    if (m) {
+      const file = m[1] + '.win32-x64-msvc.node';
+      if (NATIVE_SET.has(file)) return path.join(dir, file);
+    }
   }
   return origResolve.apply(this, arguments);
 };
@@ -139,7 +291,18 @@ if (MANIFEST.appDirEnv) process.env.FLUX_APP_DIR = MANIFEST.appDirEnv;
 try { process.chdir(dir); } catch (e) {}
 
 // 6) 用 createRequire 正常加载 app（普通 require，绕开 embedderRequire）
-Module.createRequire(path.join(dir, 'boot.js'))(appPath);
+//    GUI 子系统无控制台：启动期任何抛错（如可选原生 .node 加载失败）都会静默闪退，
+//    故兜底把堆栈写到 LOCALAPPDATA 下 APPDIR 的 startup-error.log，便于诊断“双击打不开”。
+try {
+  Module.createRequire(path.join(dir, 'boot.js'))(appPath);
+} catch (err) {
+  try {
+    const errLog = path.join(process.env.LOCALAPPDATA || os.tmpdir(), APPDIR, 'startup-error.log');
+    fs.mkdirSync(path.dirname(errLog), { recursive: true });
+    fs.writeFileSync(errLog, '[' + new Date().toISOString() + '] stamp=' + MANIFEST.stamp + '\\n' + ((err && err.stack) || err) + '\\n', 'utf8');
+  } catch (e2) {}
+  throw err;
+}
 `;
 }
 
@@ -191,10 +354,16 @@ async function packSea(a) {
   const seaDir = path.join(work, 'sea');
   ensureDir(seaDir);
 
+  // 第三方原生包（node-pty 等）：须在 bundle 前算出，以便把它们的 JS 标为 external（不内联），
+  // 并在下面作为整包 assets 落盘。collectNativePackages 只依赖 node_modules，与 bundle 无耦合。
+  const nativePkgs = collectNativePackages(projectRoot, cfg);
+  const nativeExternals = nativePkgs.filter((p) => p.native).map((p) => p.name);
+  if (nativeExternals.length) ok(`第三方原生包（external + 整包落盘）：${nativeExternals.join(', ')}`);
+
   // ---- 1) bundle app ----
   step('[s1/4] esbuild 打包应用为单 bundle');
   const bundle = path.join(seaDir, 'app.cjs');
-  const r = await buildAppBundle({ projectRoot, entryAbs, outfile: bundle });
+  const r = await buildAppBundle({ projectRoot, entryAbs, outfile: bundle, extraExternals: nativeExternals });
   ok(`app bundle：${fmtMB(r.size)}（全部 JS 已内联，无 dist 源码树）`);
 
   // ---- 2) 收集 assets（原生 + 数据 + 资源树）+ stamp ----
@@ -207,9 +376,51 @@ async function packSea(a) {
     resources.push({ key, rel });
     assetsMap[key] = abs;
   };
-  addRes('rnfd', 'react-native-flux-desktop.win32-x64-msvc.node', nat.rnfd);
+  // 通用内嵌所有 flux 原生 .node（主包 + ffi + webview + 未来扩展），按文件名落盘到 dir 根
+  for (const n of nat.natives) addRes('nat' + idx++, n.base, n.abs);
+  ok(`flux 原生绑定：${nat.natives.map((n) => n.base).join(', ')}`);
   addRes('skia', 'skia.win32-x64-msvc.node', nat.skia);
   addRes('icu', 'icudtl.dat', nat.icu);
+  // 目标原生库（app.json.pack.nativeLibs / app.nativeLibs）：按相对路径内嵌，运行期 ffi.open(相对) 命中 cwd。
+  const nativeLibs = Array.isArray(cfg.nativeLibs) ? cfg.nativeLibs : [];
+  let nlCount = 0;
+  for (const rel of nativeLibs) {
+    const abs = path.join(projectRoot, rel);
+    if (!fs.existsSync(abs)) {
+      warn(`nativeLibs 跳过（不存在）：${rel}`);
+      continue;
+    }
+    addRes('nl' + idx++, rel.split('/').join(path.sep), abs);
+    nlCount++;
+  }
+  if (nlCount) ok(`目标原生库随包：${nlCount} 个`);
+
+  // 第三方原生包整包落盘：把闭包内每个包目录（经平台/非运行时裁剪）以 node_modules/<name>/... 相对路径
+  // 内嵌为 assets，运行期解压到 <run-dir>/node_modules/ → createRequire 天然解析，其相对 .node 与兄弟 DLL 自洽。
+  const shippedNativeFiles = [];
+  const shippedNodeByPkg = new Map();
+  for (const p of nativePkgs) {
+    let count = 0;
+    let nodeCount = 0;
+    for (const rel of walkFiles(p.absDir)) {
+      const relFull = path.join('node_modules', p.name, rel);
+      if (!nativeAssetFilter(relFull)) continue;
+      const absFile = path.join(p.absDir, rel);
+      addRes('np' + idx++, relFull, absFile);
+      shippedNativeFiles.push(absFile);
+      count++;
+      if (/\.node$/.test(rel)) nodeCount++;
+    }
+    shippedNodeByPkg.set(p.name, nodeCount);
+    ok(`第三方原生包落盘：node_modules/${p.name}（${count} 文件${p.native ? '' : '，JS 依赖'}）`);
+  }
+  // 验证守卫：仅当包源码内确有 .node（真原生包）却被裁剪到无一个 .node 落盘时，才告警（防「外置了却没落盘」）。
+  // 白名单强制外置的纯 JS 包（sequelize/mysql2 等本就无 .node）属正常，不误报。
+  for (const p of nativePkgs) {
+    if (p.native && !shippedNodeByPkg.get(p.name) && pkgHasNodeFile(p.absDir)) {
+      warn(`第三方原生包 ${p.name} 已标 external，但裁剪后无 .node 落盘——运行期可能加载失败（检查其 .node 是否放在被裁剪的目录）`);
+    }
+  }
 
   // app.json：应用运行时从 cwd 读它取 name/description/version/icon（如 App.tsx 里
   // readFileSync(process.cwd()/app.json)）。sea 下 cwd=解压目录，故须把 app.json 也展到根，
@@ -231,7 +442,11 @@ async function packSea(a) {
 
   // stamp：内容变化才重解压（含 app.json，改名字/描述也能刷新）
   const ajSig = fs.existsSync(appJsonAbs) ? (() => { const s = fs.statSync(appJsonAbs); return s.size + ':' + Math.round(s.mtimeMs); })() : 'none';
-  const sigSrc = [nat.rnfd, nat.skia, nat.icu].map((p) => { const s = fs.statSync(p); return s.size + ':' + Math.round(s.mtimeMs); }).join('|') + '|' + ajSig + '|' + r.size;
+  const nativeFiles = nat.natives.map((n) => n.abs)
+    .concat([nat.skia, nat.icu])
+    .concat(nativeLibs.map((r) => path.join(projectRoot, r)).filter((p) => fs.existsSync(p)))
+    .concat(shippedNativeFiles);
+  const sigSrc = nativeFiles.map((p) => { const s = fs.statSync(p); return s.size + ':' + Math.round(s.mtimeMs); }).join('|') + '|' + ajSig + '|' + r.size;
   const stamp = crypto.createHash('md5').update(sigSrc).digest('hex').slice(0, 12);
 
   const appDirEnv = cfg.safeAppName || 'Flux';
@@ -241,6 +456,7 @@ async function packSea(a) {
     appDirEnv,
     appKey: 'app',
     skiaRel: 'skia.win32-x64-msvc.node',
+    natives: nat.natives.map((n) => n.base),
     resources,
   };
   const bootstrapPath = path.join(seaDir, 'bootstrap.cjs');
@@ -277,6 +493,7 @@ async function packSea(a) {
       version: cfg.version,
     });
   } catch (e) {
+    if (e && e.brandFatal) throw e; // FileDescription 回读不达标 → 硬失败，不静默出货
     warn(`品牌注入跳过（不影响运行）：${e.message}`);
   }
 
@@ -295,4 +512,4 @@ async function packSea(a) {
   return finalExe;
 }
 
-module.exports = { packSea, makeBootstrap, locateNatives, walkFiles };
+module.exports = { packSea, makeBootstrap, locateNatives, walkFiles, collectNativePackages, nativeAssetFilter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-flux-desktop-packer",
-  "version": "0.1.4",
+  "version": "0.1.7",
   "description": "Package a react-native-flux-desktop app into a self-contained Windows .exe (Go launcher + go:embed payload). Install as a devDependency, add `output`/`main` to app.json, then run `flux-pack`.",
   "license": "MIT",
   "author": "keyon",