1
function createMainWindow(): BrowserWindow {
2
  const win = new BrowserWindow({
3
    width: 1440,
4
    height: 900,
5
    show: false,                // 先保持隐藏，待 DOM 绘制就绪后再显示，杜绝白屏闪烁
6
    backgroundColor: "#0f172a", // 预设与网页主背景完全一致的底色，双重防闪烁
7
    webPreferences: {
8
      sandbox: true,            // 强制启用 Chromium 原生沙箱
9
      spellcheck: false,        // 禁用无意义的拼写检查，节省进程资源
10
    },
11
  });
12

13
  win.removeMenu(); // 移除默认的 Windows 菜单栏
14

15
  // 伪装为标准 Chrome 浏览器 UA，剔除 Electron 特征指纹，避免触发外部网页防御机制
16
  win.webContents.setUserAgent(CHROME_STANDARD_UA);
17

18
  // 严密拦截所有通过 window.open 打开的新窗口，强制转由系统默认浏览器打开
19
  win.webContents.setWindowOpenHandler(({ url }) => {
20
    if (url.startsWith("http://") || url.startsWith("https://")) {
21
      void shell.openExternal(url);
22
    }
23
    return { action: "deny" };
24
  });
25

26
  showOnReady(win);
27
  return win;
28
}

1
async function createMarkedWindow(markerIdentifier: string): Promise<BrowserWindow> {
2
  const win = new BrowserWindow({
3
    show: false, // 永远在后台静默运行，用户无感知
4
    webPreferences: {
5
      partition: `memory:${markerIdentifier}`, // 关键：纯内存会话，缓存与 Cookie 与主界面物理隔离
6
      backgroundThrottling: false,             // 禁用后台定时器节流，确保后台任务全速执行
7
      sandbox: true,
8
      autoplayPolicy: "user-gesture-required",
9
    },
10
  });
11

12
  // 以特定的标题作为信标加载空白数据页
13
  await win.loadURL(`data:text/html,<title>${markerIdentifier}</title>`);
14
  return win;
15
}

1
// 2. 退出拦截与缓冲区 Flush 机制
2
let isFlushed = false;
3

4
app.on("before-quit", (event) => {
5
  if (isFlushed) return;
6

7
  // 阻止默认同步退出流程
8
  event.preventDefault();
9

10
  // 等待底层存储引擎（如 SQLite WAL checkpoint、异步工作队列）平稳写盘完毕
11
  void flushPendingStorage()
12
    .catch((err) => console.error("落盘异常:", err))
13
    .finally(() => {
14
      isFlushed = true;
15
      app.quit(); // 重新触发安全退出
16
    });
17
});

1
async function connectHostBrowser(): Promise<Browser> {
2
  const browser = await chromium.connectOverCDP(CDP_LOCAL_ENDPOINT, {
3
    timeout: 30_000,
4
    noDefaults: true,
5
    isLocal: true,
6
  });
7

8
  try {
9
    const session = await browser.newBrowserCDPSession();
10
    const { userAgent } = (await session.send("Browser.getVersion")) as { userAgent: string };
11
    await session.detach().catch(() => {});
12

13
    // 核心安全防线：校验 UA 必须包含 Electron 标识
14
    if (!userAgent.includes("Electron")) {
15
      throw new Error(
16
        `CDP 端点异常（目标 UA: ${userAgent}）。为防误连用户日常宿主浏览器，已强制切断连接！`
17
      );
18
    }
19
  } catch (err) {
20
    await browser.close().catch(() => {}); // 校验失败，立即断开销毁连接
21
    throw err;
22
  }
23

24
  return browser;
25
}

1
const TARGET_MARKER = "crawler-worker";
2

3
for (let attempt = 0; attempt < 2; attempt++) {
4
  const browser = await connectHostBrowser();
5
  browser.on("disconnected", resetConnectionState); // 异常断连自愈
6

7
  const activePages = browser.contexts()[0]?.pages() ?? [];
8
  // 通过检查 URL 是否包含特定的标题信标进行寻址
9
  const targetPage = activePages.find((p) => p.url().includes(TARGET_MARKER));
10

11
  if (targetPage) {
12
    targetPage.on("close", () => resetConnectionState());
13
    return targetPage;
14
  }
15

16
  // 首轮未寻找到信标：说明沙箱窗口已被回收，立即通知宿主按需补建窗口
17
  await browser.close().catch(() => {});
18
  if (attempt === 0) {
19
    await requestHostToEnsureWindow(TARGET_MARKER);
20
    await new Promise((resolve) => setTimeout(resolve, 300)); // 留出 300ms 窗口初始化时间
21
  }
22
}

1
// build.mjs —— 主进程构建流水线
2
import { execSync } from "node:child_process";
3
import { build } from "esbuild";
4

5
// 第一阶段：通过 tsc 执行严格的类型检查
6
execSync("tsc -b", { stdio: "inherit" });
7

8
// 第二阶段：利用 esbuild 将主进程及所有内嵌服务收敛成单个 JS 文件
9
await build({
10
  entryPoints: ["src/main.ts"],
11
  outfile: "dist/main.js",
12
  bundle: true,
13
  platform: "node",
14
  target: "node22",
15
  format: "esm",
16
  sourcemap: true,
17
  // 核心白名单：原生二进制模块（.node）与重量级动态外部库绝不打包
18
  external: [
19
    "electron",
20
    "better-sqlite3",
21
    "@libsql/*",
22
    "playwright-core",
23
  ],
24
  banner: {
25
    // ESM 模式下的关键兼容垫片：修复被 bundle 依赖中残留的 CommonJS require 与 __dirname
26
    js: `
27
      import { createRequire as __createRequire } from 'node:module';
28
      import { fileURLToPath as __fileURLToPath } from 'node:url';
29
      import { dirname as __dirnameFunction } from 'node:path';
30
      const require = __createRequire(import.meta.url);
31
      const __filename = __fileURLToPath(import.meta.url);
32
      const __dirname = __dirnameFunction(__filename);
33
    `,
34
  },
35
  minify: true,
36
});

1
# electron-builder.yml（核心裁剪配置）
2
asar: true
3
asarUnpack:
4
  # 原生 .node 二进制与配套依赖无法在虚拟 asar 中直接加载，必须解压释放至物理磁盘
5
  - "**/better-sqlite3/**/*"
6
  - "**/@libsql/**/*"
7

8
files:
9
  - dist/main.js
10
  - package.json
11
  # 仅打包运行时必需的原生依赖与核心执行文件
12
  - node_modules/@libsql/win32-x64-msvc/**/*
13
  - node_modules/playwright-core/**/*
14
  # 关键排除：剔除已经被 bundle 完整打入 main.js 的上百个纯 JS 依赖库，严防体积翻倍
15
  - "!node_modules/@ai-sdk/**"
16
  - "!node_modules/drizzle-orm/**"
17
  - "!node_modules/zod/**"
18
  # 剔除其他平台的无关预编译二进制（如当前打包 Windows，剔除 Darwin/Linux 二进制）
19
  - "!node_modules/**/@rspack/binding-{darwin,linux}-*/**"
20
  - "!node_modules/**/@esbuild/{darwin-*,linux-*}/**"
21

22
extraResources:
23
  # 将前端 SPA 静态产物统一映射到 resources/web-dist
24
  - from: ../web/dist
25
    to: web-dist

1
function startMemoryMonitor(): void {
2
  setInterval(() => {
3
    const metrics = app.getAppMetrics();
4
    // 遍历每一个被标记的沙箱窗口
5
    for (const [marker, entry] of markedWindows.entries()) {
6
      const pid = entry.win.webContents.getOSProcessId();
7
      const processInfo = metrics.find((m) => m.pid === pid);
8

9
      // 若单个渲染进程 WorkingSet 物理常驻内存突破 1.5GB 阈值，立即熔断
10
      if (processInfo && processInfo.memory.workingSetSize > 1536 * 1024 * 1024) {
11
        console.warn(`[Memory Monitor] 沙箱窗口 ${marker} 内存超限，执行熔断重置！`);
12
        void destroyMarkedWindow(marker); // 销毁窗口，直接由操作系统回收整个子进程
13
      }
14
    }
15
  }, 5 * 60 * 1000); // 每 5 分钟采样巡检一次
16
}