ClassHelper/packages/desktop-client/scripts/dist-win.mjs

/**
 * Windows 打包入口（等价于 electron-builder --win，但做了三件工程化处理）：
 *
 * 1) 复用本地已解压的 Electron：node_modules/electron/dist 存在时通过
 *    --config.electronDist 直接使用，避免再下载 150MB+ 发行包（受网络影响最大的步骤）。
 * 2) 默认使用国内镜像（可用环境变量覆盖）：
 *      ELECTRON_MIRROR                   Electron 发行包
 *      ELECTRON_BUILDER_BINARIES_MIRROR  nsis / winCodeSign 等构建工具
 * 3) 缓存固定到仓库内的 .cache 目录，便于清理与迁移，不污染用户全局目录。
 *
 * 用法：
 *   node scripts/dist-win.mjs            # nsis 安装包 + portable 单文件
 *
 * 产物统一落到 releases/client/<版本>/（releases/ 不入库，与服务端、插件同级）：
 *   安装包/   ClassHelper-<版本>-x64-setup.exe / -portable.exe（+ .blockmap）
 *   构建中间/ builder-*.yml、*.nsis.7z
 *
 * 产物里**没有免安装目录**：electron-builder 的 `win-unpacked/` 只是生成两个 exe 的中间物
 * （每版 320MB 上下），打完就删 —— 便携版 `-portable.exe` 已是自解压单文件，交付不需要解包目录。
 * 因此也没有 `--dir`：那等于只产出中间物、拿不到任何交付物。需要临时跑一下解包目录时直接调
 * electron-builder，别往 releases/ 里塞。
 * electron-builder 自身的 `directories.output` 由本脚本用 --config 覆盖成上面的版本目录；
 * 显式传入 `-c.directories.output=...` 时不覆盖，整理（tidyArtifacts）以传入的目录为准。
 */
import { execFileSync, spawn } from 'node:child_process';
import fs from 'node:fs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
import { resolveNodeRuntime } from '../../../scripts/lib/node-runtime.mjs';

const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
const repoRoot = path.resolve(root, '..', '..');
const passthrough = process.argv.slice(2);

// makensis 会在 %TEMP% 所在位置建临时文件：Git Bash 里 TEMP=/tmp 是 MSYS 路径，
// 原生程序会把它当成「当前盘根下的 tmp」（D:\tmp，不存在）而报
// `!tempfile: Unable to create temporary file!`，NSIS 那一步就失败（磁盘并不紧张）。
// 统一指到仓库内的真实目录，避开宿主终端带来的环境差异。
const tmpDir = path.join(repoRoot, '.cache', 'tmp');
fs.mkdirSync(tmpDir, { recursive: true });

const env = {
  ...process.env,
  TEMP: tmpDir,
  TMP: tmpDir,
  ELECTRON_MIRROR: process.env.ELECTRON_MIRROR ?? 'https://cdn.npmmirror.com/binaries/electron/',
  ELECTRON_BUILDER_BINARIES_MIRROR:
    process.env.ELECTRON_BUILDER_BINARIES_MIRROR ??
    'https://npmmirror.com/mirrors/electron-builder-binaries/',
  ELECTRON_BUILDER_CACHE:
    process.env.ELECTRON_BUILDER_CACHE ?? path.join(repoRoot, '.cache', 'electron-builder'),
  ELECTRON_CACHE: process.env.ELECTRON_CACHE ?? path.join(repoRoot, '.cache', 'electron'),
};

const localElectronDist = path.join(root, 'node_modules', 'electron', 'dist');
const overrides = [];
if (fs.existsSync(path.join(localElectronDist, 'electron.exe'))) {
  overrides.push(`--config.electronDist=${localElectronDist}`);
  console.log('[dist] 复用本地已解压的 Electron：', localElectronDist);
} else {
  console.log('[dist] 未找到本地 Electron，将由 electron-builder 下载（镜像：' + env.ELECTRON_MIRROR + '）');
}

const cli = path.join(root, 'node_modules', 'electron-builder', 'out', 'cli', 'cli.js');
if (!fs.existsSync(cli)) {
  console.error('[dist] 未找到 electron-builder，请先执行 pnpm install');
  process.exit(2);
}

// 交付产物落到 releases/client/<版本>/（与服务端、插件同一约定；releases/ 不入库）
const clientVersion = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).version;
const explicitOutput = passthrough.find((item) => item.includes('directories.output'));
const destDir = explicitOutput
  ? path.resolve(root, explicitOutput.slice(explicitOutput.indexOf('=') + 1))
  : path.join(repoRoot, 'releases', 'client', clientVersion);
if (!explicitOutput) overrides.push(`--config.directories.output=${destDir}`);

const cliArgs = [cli, '--win', ...overrides, ...passthrough];
console.log('[dist] electron-builder', cliArgs.slice(1).join(' '));

// 必须用真正的 node 执行 electron-builder CLI：
// 若宿主终端是 Electron（本机 pnpm 即如此），process.execPath 会指向 Electron，
// 直接 spawn 会让 Electron 把 cli.js 当成应用入口，多出一个位置参数，
// electron-builder 报 `Unknown argument: .../cli.js`。
const runtime = resolveNodeRuntime();
console.log(`[dist] Node 运行时：${runtime.path}（${runtime.version}）`);

// 清理上一轮产物：本仓库目录树带沙箱 ACL（含 Everyone 的 DENY(delete child)），
// 已存在的产物会被工具（makensis / 7za）判为"Can't open output file / 拒绝访问"而失败，
// 手动删掉再打包即可 —— 顺手也保证产物集合确定，不会残留上一轮的旧安装包。
let cleaned = false;
for (const name of ['win-unpacked', '免安装', '安装包', '构建中间']) {
  const target = path.join(destDir, name);
  if (!fs.existsSync(target)) continue;
  try {
    fs.rmSync(target, { recursive: true, force: true });
    cleaned = true;
  } catch (error) {
    console.warn(`[dist] 无法清理旧产物 ${name}：${error.message}`);
  }
}
if (cleaned) console.log('[dist] 已清理上一轮的中间物与安装包');

// 打包**之前**就要把输出目录的完整性标签压回 Low（继承），不留到收尾 ——
// 实测过一次：上一轮留下的 win-unpacked 是收尾时用 icacls 标成 Medium 的，
// 而 7za 自身带 Low 标签，pack 时读不动这些 Medium 目录，报
// "cannot open file ... Access is denied"，打包直接失败。
try {
  execFileSync('icacls', [destDir, '/setintegritylevel', '(OI)(CI)Low'], { stdio: 'pipe', windowsHide: true });
} catch {
  /* 宿主目录树本就没有 Low 标签体系时会被系统拒绝，保持继承即可 */
}

const child = spawn(runtime.path, cliArgs, { cwd: root, stdio: 'inherit', env });

/**
 * 把交付产物的完整性标签修正为 Medium（Windows）。
 *
 * 背景（踩过一次，代价是"客户端装不上、便捷版也双击没反应"）：
 *   本仓库目录树被宿主沙箱打上了 `Low Mandatory Level` 标签（可继承），
 *   因此在仓库内构建出的 exe 自身也带 Low 标签。Windows 会把这类进程降到 Low 完整性，
 *   于是 setup.exe 写不进 `%LOCALAPPDATA%`（报"拒绝访问"→ 装不上）、
 *   便捷版解不出 `%TEMP%`（→ 起不来）；即使装上了，Low 标签的应用文件也会让
 *   Chromium 的 AppContainer 子进程读不到（0x80000003 秒崩）。
 *
 *   要点：**只有交付物自身的标签要紧**。归档内部的载荷标签不会被还原
 *   （装到正常位置得到的是默认 Medium 文件），所以打包完成后再统一修正即可 ——
 *   反过来说，不能在打包前把 appOutDir 改成 Medium：那样 7za（自身 Low）
 *   会因"不能向上读/写"而无法生成归档。
 */
function normalizeIntegrityLabel(dir) {
  if (process.platform !== 'win32') return;
  const run = (args) => execFileSync('icacls', args, { stdio: 'pipe', windowsHide: true });
  // 这一行才是"交付物能不能用"的关键，失败必须喊出来
  try {
    run([dir, '/setintegritylevel', 'Medium', '/T', '/C']);
    console.log('[dist] 已把交付物完整性标签修正为 Medium：', dir);
  } catch (error) {
    console.warn('[dist] 完整性标签修正失败（交付物可能装不上，见 AGENTS.md §7 第 7 条）：', error.message);
  }
  // 目录自身恢复为"继承父目录的 Low"，保证下次构建时带 Low 标签的 7za 仍能写进这个目录。
  // 宿主目录树本来就没有 Low 标签体系时，这一步会被系统拒绝（保持继承即可），属正常，不提示。
  try {
    run([dir, '/setintegritylevel', '(OI)(CI)Low']);
  } catch {
    /* 忽略 */
  }
}

/**
 * 把 electron-builder 的原始输出整理成 releases 的固定分层：
 *   *.exe / *.blockmap → 安装包/
 *   *.yml / *.nsis.7z  → 构建中间/
 *   win-unpacked/      → **直接删掉**（见文件头：它只是生成两个 exe 的中间物）
 * electron-builder 每次都会按自己的布局重写这些路径，因此整理只放在打包成功之后做；
 * 同名文件用 renameSync 同盘移动，不会产生大文件的额外拷贝。
 */
function tidyArtifacts(dir) {
  if (!fs.existsSync(dir)) return;
  const moveInto = (from, sub) => {
    const to = path.join(dir, sub);
    fs.mkdirSync(to, { recursive: true });
    fs.renameSync(from, path.join(to, path.basename(from)));
  };

  // 必须留在最后删：electron-builder 的 portable 目标就是拿它自己解包出来的 app 做自解压包，
  // 提前删会让 `-portable.exe` 这一步找不到源文件。
  const throwaway = [];
  for (const name of ['win-unpacked', '免安装']) {
    const from = path.join(dir, name);
    if (fs.existsSync(from)) throwaway.push(from);
  }

  for (const name of fs.readdirSync(dir)) {
    const from = path.join(dir, name);
    if (!fs.statSync(from).isFile()) continue;
    if (/\.(exe|blockmap)$/i.test(name)) moveInto(from, '安装包');
    else if (/\.(yml|7z)$/i.test(name)) moveInto(from, '构建中间');
  }

  for (const from of throwaway) {
    // 体积必须在删之前量：删完再 walk 只会得到 0
    const mb = Math.round(dirSizeMb(from));
    try {
      fs.rmSync(from, { recursive: true, force: true });
      console.log(`[dist] 已删除中间物 ${path.basename(from)}/（约 ${mb} MB）`);
    } catch (error) {
      console.warn(`[dist] 中间物 ${path.basename(from)}/ 删除失败（不影响交付物）：${error.message}`);
    }
  }
}

/** 交付目录里没有现成的体积统计函数，这里只在打日志时用一次 */
function dirSizeMb(target) {
  let total = 0;
  const walk = (dir) => {
    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
      const full = path.join(dir, entry.name);
      if (entry.isDirectory()) walk(full);
      else total += fs.statSync(full).size;
    }
  };
  if (fs.existsSync(target)) walk(target);
  return total / 1024 / 1024;
}

child.on('exit', (code) => {
  if (code === 0) {
    tidyArtifacts(destDir);
    normalizeIntegrityLabel(destDir);
    console.log('\n[dist] 打包完成，产物目录：', destDir);
  }
  process.exit(code ?? 1);
});