dsh-oc-desktop 0.3.1

package/launcher/main.js

@@ -0,0 +1,800 @@
+'use strict';
+// dsh-desktop 主进程
+// 职责:单实例锁 / spawn 本地引擎(dsh web)/ 窗口与自绘标题栏 / 托盘 / 通知 /
+//       全局快捷键 / 开机自启 / 窗口状态记忆 / 崩溃自愈
+const { app, BrowserWindow, Tray, Menu, Notification, globalShortcut, ipcMain, shell, nativeImage } = require('electron');
+const { spawn, execFile } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+const os = require('node:os');
+const { connectEvents } = require('./events');
+const { applyUpdate } = require('./apply-update');
+const { checkForUpdates, fetchJson, diffLocal, downloadUpdate } = require('./updater');
+const { parseCurrentSession, SESSION_ID_RE } = require('./session-window');
+
+// ---------- 路径常量 ----------
+// 本文件从仓库 src/main.js 迁至 plugins/dsh-desktop/launcher/main.js(插件拆分)。
+// dsh-oc-desktop 由 electron . 运行(非打包为独立可执行),更新/apply 目录基于包自身根。
+const PACKAGE_ROOT = path.join(__dirname, '..'); // plugins/dsh-desktop(包根,自带 assets)
+
+app.setName('dsh-desktop');
+// Windows 原生通知需要 AppUserModelID(与 electron-builder 的 appId 一致),否则打包后通知不显示
+app.setAppUserModelId('dev.dsh.desktop');
+
+// ---------- 更新应用模式 ----------
+// 主进程以 --dsh-apply-update 重启:本进程只负责把 staging 文件树替换到位,
+// exe 本体与最终重启交给 .dsh-apply.cmd(脱离进程执行,绕开 exe 文件锁)。
+if (process.argv.includes('--dsh-apply-update')) {
+  const appRoot = PACKAGE_ROOT;
+  const res = applyUpdate(appRoot, path.join(appRoot, '.dsh-update-staging'));
+  if (res.ok && res.cmdPath) {
+    try { spawn('cmd.exe', ['/c', res.cmdPath], { detached: true, stdio: 'ignore', windowsHide: true }).unref(); } catch { /* ignore */ }
+  }
+  process.exit(0);
+}
+
+const ASSETS = path.join(PACKAGE_ROOT, 'assets');
+const userDataDir = app.getPath('userData'); // %APPDATA%\dsh-desktop
+const logDir = path.join(userDataDir, 'logs');
+const mainLogPath = path.join(logDir, 'main.log');
+const harnessLogPath = path.join(logDir, 'harness.log');
+const settingsPath = path.join(userDataDir, 'settings.json');
+const statePath = path.join(userDataDir, 'window-state.json');
+
+// ---------- 日志 ----------
+function writeLog(file, level, msg) {
+  try {
+    fs.mkdirSync(logDir, { recursive: true });
+    fs.appendFileSync(file, `${new Date().toISOString()} [${level}] ${msg}\n`);
+  } catch { /* 日志失败不致命 */ }
+}
+const log = (level, msg) => {
+  writeLog(mainLogPath, level, msg);
+  if (level !== 'harness') console.log(`[${level}] ${msg}`);
+};
+const hlog = (msg) => writeLog(harnessLogPath, 'harness', msg);
+
+// ---------- 配置 ----------
+const DEFAULT_SETTINGS = {
+  launcher: null,               // 自定义启动命令数组,如 ["node", "C:\\...\\bin.js", "web"]
+  autostart: false,             // 开机自启
+  customTitleBar: true,         // 自绘标题栏(壳自有能力,不依赖 SPA,DSH 更新不影响)
+  shortcut: 'Control+Alt+D',    // 全局显示/隐藏快捷键
+  startupTimeoutMs: 90000,      // 引擎启动超时
+  dataHome: null,               // 独立数据根(null = %APPDATA%\dsh-desktop\home,即独立的 DSH_HOME)
+  updateUrl: null,              // 更新服务器根地址(version.json 所在目录);null = 未配置,托盘「检查更新」会提示
+};
+function loadJson(file, fallback) {
+  try { return { ...fallback, ...JSON.parse(fs.readFileSync(file, 'utf8')) }; }
+  catch { return fallback; }
+}
+function saveJson(file, obj) {
+  try { fs.mkdirSync(path.dirname(file), { recursive: true }); fs.writeFileSync(file, JSON.stringify(obj, null, 2)); } catch { /* ignore */ }
+}
+let settings = loadJson(settingsPath, DEFAULT_SETTINGS);
+
+// 命令行 --no-open(桌面快捷方式传入):引擎启动时不自动打开默认浏览器,
+// 桌面壳只需原生窗口;命令行启动(npx dsh-desktop / npm start)不传则保持默认弹浏览器。
+const NO_OPEN = process.argv.includes('--no-open');
+
+// 桌面应用使用独立的数据根(DSH_HOME):会话/存储/凭据/设置与浏览器实例完全隔离
+// 桌面端与 web 端合并:共享数据根(默认 ~/.dsh,与浏览器版同一份数据)。
+// settings.dataHome 可覆盖;引擎复用 127.0.0.1:3080(web 端端口)——桌面端只是另一个入口。
+const dataHome = settings.dataHome || path.join(os.homedir(), '.dsh');
+
+// ---------- 独立数据根引导 ----------
+// profile 的 node_modules 是 junction 层(包实体在 npx 缓存/源安装树里),
+// 这里按原样重建 junction 指向同一实体(只读复用,零下载),数据目录则是全新的。
+function replicateEntry(src, dst) {
+  try {
+    const st = fs.lstatSync(src);
+    if (st.isSymbolicLink()) {
+      const target = fs.readlinkSync(src);
+      fs.symlinkSync(target, dst, 'junction');
+      return;
+    }
+    if (st.isDirectory()) {
+      fs.mkdirSync(dst, { recursive: true });
+      for (const name of fs.readdirSync(src)) replicateEntry(path.join(src, name), path.join(dst, name));
+      return;
+    }
+    if (st.isFile()) fs.copyFileSync(src, dst);
+  } catch (e) {
+    log('warn', `replicate ${src} failed: ${e.message}`);
+  }
+}
+// 自动安装源 dsh(npx 引导一次):本机没有任何 dsh 安装时,拉取并初始化
+// 源 profile。与 scripts/ensure-dsh.js 逻辑一致(打包后无法 require 外部脚本,
+// 故内联一份)。判定"就绪"= 引擎打印 URL 行(profile 初始化 + profiles\node_modules
+// 符号层自愈都在打印之前完成),随后杀掉引导进程。
+const AUTO_INSTALL_TIMEOUT_MS = 5 * 60 * 1000;
+function autoBootstrapSource() {
+  const srcHome = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+  const srcBin = path.join(srcHome, 'profiles', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js');
+  return new Promise((resolve) => {
+    log('info', 'source dsh missing — auto-installing via npx (first run, needs network ~100MB)');
+    const line = ['npx', '--yes', '@deepseek-ai/dsh', 'web', '--port', '0', ...(NO_OPEN ? ['--no-open'] : [])].map((a) => (/\s/.test(a) ? `"${a}"` : a)).join(' ');
+    const proc = spawn(process.env.ComSpec || 'cmd.exe', ['/d', '/s', '/c', line], { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] });
+    let buf = '';
+    let settled = false;
+    const finish = (ok) => { if (settled) return; settled = true; clearTimeout(timer); resolve(ok); };
+    const timer = setTimeout(() => {
+      killProcTree(proc);
+      // URL 没等到,但 profile 可能已初始化(自愈先行);按实际结果判定
+      finish(fs.existsSync(srcBin));
+    }, AUTO_INSTALL_TIMEOUT_MS);
+    proc.stdout.on('data', (d) => {
+      buf += String(d);
+      let nl;
+      while ((nl = buf.indexOf('\n')) >= 0) {
+        const l = buf.slice(0, nl).trim();
+        buf = buf.slice(nl + 1);
+        if (l) hlog(l);
+        if (/dsh web:\s*https?:\/\/127\.0\.0\.1:\d+/.test(l)) { log('info', 'auto-install: dsh booted'); killProcTree(proc); finish(true); return; }
+      }
+    });
+    proc.stderr.on('data', (d) => hlog(String(d).trimEnd()));
+    proc.on('error', () => finish(false));
+    proc.on('exit', () => finish(fs.existsSync(srcBin)));
+  });
+}
+function killProcTree(proc) {
+  try { proc.kill(); } catch { /* ignore */ }
+  if (process.platform === 'win32' && proc.pid) {
+    execFile('taskkill', ['/pid', String(proc.pid), '/t', '/f'], () => { /* ignore */ });
+  }
+}
+async function ensureDataHome() {
+  // 合并后:数据根 = 共享 ~/.dsh(与浏览器版一致)。引擎由 resolveLauncher 启动;
+  // 数据根内若未引导过 dsh 则 npx 引导一次。
+  fs.mkdirSync(dataHome, { recursive: true });
+  const bin = path.join(dataHome, 'profiles', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js');
+  if (fs.existsSync(bin)) return true;
+  log('warn', `dsh not bootstrapped at ${dataHome}; auto-installing via npx`);
+  const installed = await autoBootstrapSource();
+  if (!installed) {
+    log('error', `bootstrap failed: dsh missing at ${dataHome} and auto-install failed`);
+    return false;
+  }
+  return true;
+}
+
+// ---------- 状态 ----------
+let mainWin = null, splash = null, tray = null;
+let child = null, harnessUrl = null, quitting = false;
+let restartTimer = null, startTimer = null, stateTimer = null;
+let stdoutBuf = '', restartCount = 0;
+const sessionWindows = new Set();
+const openSessionArg = process.argv.find((a) => a.startsWith('--open-session-window='));
+let pendingOpenSession = openSessionArg ? openSessionArg.slice('--open-session-window='.length) : null;
+if (pendingOpenSession && !SESSION_ID_RE.test(pendingOpenSession)) pendingOpenSession = null;
+
+// ---------- 启动器解析 ----------
+// 优先级:settings.launcher > 共享数据根内已装 dsh > npx 兜底。
+// 引擎始终以 DSH_HOME=<dataHome> 运行,数据与会话与浏览器实例完全隔离。
+function resolveLauncher() {
+  // --no-open 仅追加到壳管理的启动路径(settings.launcher 是用户显式配置,不越权改动)
+  const noOpen = NO_OPEN ? ['--no-open'] : [];
+  if (Array.isArray(settings.launcher) && settings.launcher.length >= 1) {
+    return { command: settings.launcher[0], args: settings.launcher.slice(1) };
+  }
+  const bin = path.join(dataHome, 'profiles', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js');
+  if (fs.existsSync(bin)) return { command: 'node', args: [bin, 'web', ...noOpen] };
+  return { command: 'npx', args: ['--yes', '@deepseek-ai/dsh', 'web', ...noOpen] };
+}
+
+// ---------- 引擎子进程 ----------
+// 合并模式:优先连接已运行的 web 端引擎(127.0.0.1:3080)——同一引擎、同一数据;
+// 没有则自己启动(固定 3080 端口,天然防止双实例写同一数据根)。
+const WEB_PORT = 3080;
+function probePort(port, timeoutMs, cb) {
+  httpGet(`http://127.0.0.1:${port}/`, timeoutMs)
+    .then(() => { log('info', `probe ${port}: alive`); cb(true); })
+    .catch((e) => { log('warn', `probe ${port}: not responding (${e && e.message ? e.message : e})`); cb(false); });
+}
+function httpGet(url, timeoutMs) {
+  return new Promise((resolve, reject) => {
+    const req = require('node:http').get(url, (res) => { res.resume(); resolve(res.statusCode); });
+    req.setTimeout(timeoutMs || 1500, () => { req.destroy(new Error('timeout')); });
+    req.on('error', reject);
+  });
+}
+function startHarness() {
+  if (child) return;
+  // 1. 检测 web 端引擎是否已在跑
+  probePort(WEB_PORT, 1500, (alive) => {
+    if (alive) {
+      log('info', `web engine already running at 127.0.0.1:${WEB_PORT} — connecting as another entry`);
+      onHarnessReady(`http://127.0.0.1:${WEB_PORT}`);
+      return;
+    }
+    spawnEngine();
+  });
+}
+function spawnEngine() {
+  const { command, args } = resolveLauncher();
+  const fullArgs = [...args, '--host', '127.0.0.1', '--port', String(WEB_PORT)];
+  log('info', `spawning harness: ${command} ${fullArgs.join(' ')} (DSH_HOME=${dataHome})`);
+  let proc;
+  const spawnEnv = { ...process.env, DSH_HOME: dataHome };
+  if (process.platform === 'win32' && command === 'npx') {
+    // npx 是 .cmd,须经 cmd /c 执行;windowsHide 隐藏命令窗口
+    const line = ['npx', ...fullArgs].map((a) => (/\s/.test(a) ? `"${a}"` : a)).join(' ');
+    proc = spawn(process.env.ComSpec || 'cmd.exe', ['/d', '/s', '/c', line], { windowsHide: true, env: spawnEnv, stdio: ['ignore', 'pipe', 'pipe'] });
+  } else {
+    proc = spawn(command, fullArgs, { windowsHide: true, env: spawnEnv, stdio: ['ignore', 'pipe', 'pipe'] });
+  }
+  child = proc;
+  proc.stdout.on('data', (d) => onHarnessStdout(String(d)));
+  proc.stderr.on('data', (d) => hlog(String(d).trimEnd()));
+  proc.on('error', (err) => {
+    log('error', `harness spawn error: ${err.message}`);
+    showError(`无法启动本地引擎: ${err.message}`);
+    child = null;
+  });
+  proc.on('exit', (code, sig) => onHarnessExit(code, sig));
+  clearTimeout(startTimer);
+  startTimer = setTimeout(() => {
+    if (!harnessUrl) {
+      log('warn', 'harness startup timeout');
+      showError('本地引擎启动超时。请查看日志目录 logs\\ 后点击「重试」。');
+    }
+  }, settings.startupTimeoutMs);
+}
+
+// 按行缓冲解析 "dsh web: http://127.0.0.1:PORT"
+function onHarnessStdout(chunk) {
+  stdoutBuf += chunk;
+  let nl;
+  while ((nl = stdoutBuf.indexOf('\n')) >= 0) {
+    const line = stdoutBuf.slice(0, nl).trim();
+    stdoutBuf = stdoutBuf.slice(nl + 1);
+    if (line) hlog(line);
+    const m = line.match(/dsh web:\s*(https?:\/\/127\.0\.0\.1:\d+)/);
+    if (m) onHarnessReady(m[1]);
+  }
+}
+
+function onHarnessReady(url) {
+  if (harnessUrl === url) return;
+  harnessUrl = url;
+  clearTimeout(startTimer);
+  log('info', `harness ready at ${url}`);
+  if (splash && !splash.isDestroyed()) splash.close();
+  if (mainWin && !mainWin.isDestroyed()) {
+    mainWin.loadURL(desktopShellUrl(url));
+    mainWin.show();
+  } else {
+    mainWin = createMainWindow(url);
+  }
+  notify('DeepSeek Harness', '本地引擎已就绪');
+  startEventsWatch();
+  if (pendingOpenSession) {
+    openSessionUrl(pendingOpenSession);
+    pendingOpenSession = null;
+  }
+}
+
+// ---------- 业务事件通知(引擎 events.mux 下行流) ----------
+// 审批请求 / 用户提问 / 任务轮次结束 → 原生通知。
+// 仅当窗口不在前台(不可见或未聚焦)时通知,避免打扰正在使用的用户。
+let eventsStop = null;
+function startEventsWatch() {
+  if (eventsStop || !harnessUrl) return;
+  try {
+    const seenFrames = new Set(); // 每种帧类型记一次日志,避免刷屏
+    eventsStop = connectEvents(harnessUrl, {
+      onFrame: (frame) => {
+        const key = frame.event && frame.event.type ? `${frame.type}/${frame.event.type}` : frame.type;
+        if (!seenFrames.has(key)) {
+          seenFrames.add(key);
+          log('info', `events frame: ${key}`);
+        }
+      },
+      onNotify: (info) => {
+        // 无条件记日志(前台/后台都能看到事件流),前台只抑制弹通知
+        log('info', `business event: ${info.kind} — ${info.title}: ${info.body}`);
+        const inFront = mainWin && !mainWin.isDestroyed() && mainWin.isVisible() && mainWin.isFocused();
+        if (inFront) return; // 用户正在用,不弹通知
+        notify(info.title, info.body);
+      },
+      onState: (s) => log('info', `events watcher: ${s}`),
+    });
+    log('info', `events watcher started (${harnessUrl}/api/events.mux)`);
+  } catch (e) {
+    log('warn', `events watcher failed: ${e.message}`);
+  }
+}
+function stopEventsWatch() {
+  if (eventsStop) {
+    try { eventsStop.stop(); } catch { /* ignore */ }
+    eventsStop = null;
+  }
+}
+
+function onHarnessExit(code, sig) {
+  clearTimeout(startTimer); // 崩溃发生在启动超时前时,别让旧超时定时器误报
+  stopEventsWatch(); // 引擎已死,WS 必然断开;显式停掉避免对旧端口重连
+  const wasChild = child;
+  child = null;
+  stdoutBuf = '';
+  harnessUrl = null;
+  if (quitting || !wasChild) return;
+  log('warn', `harness exited (code=${code}, signal=${sig}) — restarting in 3s`);
+  notify('DeepSeek Harness', '本地引擎已停止,正在自动重启…');
+  showError('本地引擎已停止,3 秒后自动重启…');
+  clearTimeout(restartTimer);
+  restartTimer = setTimeout(() => {
+    // 合并兜底:退出可能因端口被占(现有引擎在 3080 而 probe 误判)。重启前先看 3080 是否活着,
+    // 活着 → 直接连接(不再 spawn,避免 EADDRINUSE 崩溃循环)
+    probePort(WEB_PORT, 1500, (alive) => {
+      if (alive) {
+        log('info', `engine exited but port ${WEB_PORT} alive — connecting to existing engine`);
+        onHarnessReady(`http://127.0.0.1:${WEB_PORT}`);
+        return;
+      }
+      restartCount += 1;
+      log('info', `restart #${restartCount}`);
+      startHarness();
+    });
+  }, 3000);
+}
+
+// ---------- 窗口 ----------
+function createMainWindow(url) {
+  const state = loadJson(statePath, { width: 1280, height: 860 });
+  const opts = {
+    width: state.width || 1280,
+    height: state.height || 860,
+    ...(Number.isInteger(state.x) && Number.isInteger(state.y) ? { x: state.x, y: state.y } : {}),
+    minWidth: 960,
+    minHeight: 600,
+    show: false,
+    title: 'DeepSeek Harness',
+    icon: nativeImage.createFromPath(path.join(ASSETS, 'icon-app.png')),
+    backgroundColor: '#14161a',
+    webPreferences: {
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: true,
+      spellcheck: false,
+      preload: path.join(__dirname, 'preload.js'),
+      additionalArguments: [`--dsh-custom-titlebar=${settings.customTitleBar ? 1 : 0}`],
+    },
+  };
+  if (settings.customTitleBar) {
+    // 自绘标题栏:隐藏系统标题栏与原生窗口控件,UI(logo/应用名/窗口按钮)由 preload 注入,
+    // 风格对齐 Codex/VS Code;不用 titleBarOverlay —— 控件也自绘,随主题变色
+    opts.titleBarStyle = 'hidden';
+  }
+  const win = new BrowserWindow(opts);
+  win.loadURL(desktopShellUrl(url));
+  win.once('ready-to-show', () => {
+    if (state.maximized) win.maximize();
+    win.show();
+  });
+  win.on('close', () => { saveStateNow(); }); // 关闭=销毁窗口;应用驻留托盘,可从托盘重新打开
+  win.on('closed', () => { if (mainWin === win) mainWin = null; });
+  win.on('maximize', () => { saveStateDebounced(); win.webContents.send('win-maximized', true); });
+  win.on('unmaximize', () => { saveStateDebounced(); win.webContents.send('win-maximized', false); });
+  win.webContents.on('did-finish-load', () => {
+    // 页面(含错误页)加载完成时同步一次最大化状态,避免启动时错过事件
+    if (!win.isDestroyed()) win.webContents.send('win-maximized', win.isMaximized());
+  });
+  win.on('resize', saveStateDebounced);
+  win.on('move', saveStateDebounced);
+  attachShellGuards(win);
+  win.webContents.on('did-fail-load', (e, code, desc) => {
+    if (code !== -3) showError(`页面加载失败 (${code} ${desc})`);
+  });
+  return win;
+}
+
+function attachShellGuards(win) {
+  win.webContents.setWindowOpenHandler(({ url: u }) => {
+    if (/^https?:/i.test(u)) shell.openExternal(u);
+    return { action: 'deny' };
+  });
+  win.webContents.on('will-navigate', (e, u) => {
+    if (harnessUrl && !u.startsWith(harnessUrl)) e.preventDefault();
+  });
+}
+
+// 自绘标题栏避让声明:让 better-sidebar 等插件自动探测桌面壳,而不是靠手动 custom 配置。
+function desktopShellUrl(url) {
+  try {
+    const u = new URL(url);
+    u.searchParams.set('dsh-desktop-mode', 'advanced');
+    u.searchParams.set('dsh-desktop-platform', process.platform);
+    u.searchParams.set('dsh-desktop-titlebar-inset', '32');
+    return u.toString();
+  } catch {
+    return url;
+  }
+}
+
+// 会话窗口:与主窗口同壳(自绘标题栏/同 preload/同安全守卫),但独立窗口、独立会话。
+function createSessionWindow(sessionId) {
+  const opts = {
+    width: 1100,
+    height: 760,
+    minWidth: 960,
+    minHeight: 600,
+    show: false,
+    title: 'DeepSeek Harness',
+    icon: nativeImage.createFromPath(path.join(ASSETS, 'icon-app.png')),
+    backgroundColor: '#14161a',
+    webPreferences: {
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: true,
+      spellcheck: false,
+      preload: path.join(__dirname, 'preload.js'),
+      additionalArguments: [
+        `--dsh-custom-titlebar=${settings.customTitleBar ? 1 : 0}`,
+        `--dsh-open-session=${sessionId}`,
+      ],
+    },
+  };
+  if (settings.customTitleBar) opts.titleBarStyle = 'hidden';
+  const win = new BrowserWindow(opts);
+  win.loadURL(desktopShellUrl(harnessUrl));
+  win.once('ready-to-show', () => win.show());
+  win.on('maximize', () => { if (!win.isDestroyed()) win.webContents.send('win-maximized', true); });
+  win.on('unmaximize', () => { if (!win.isDestroyed()) win.webContents.send('win-maximized', false); });
+  win.on('closed', () => sessionWindows.delete(win));
+  win.webContents.on('did-fail-load', (e, code, desc) => {
+    if (code !== -3) log('warn', `session window load failed (${code} ${desc})`);
+  });
+  win.webContents.on('did-finish-load', () => {
+    if (win.isDestroyed()) return;
+    win.webContents.send('win-maximized', win.isMaximized());
+    setTimeout(() => {
+      if (win.isDestroyed()) return;
+      win.webContents.executeJavaScript('localStorage.getItem("dsh.sessions.current")')
+        .then((raw) => {
+          const sid = parseCurrentSession(raw);
+          log('info', `session window loaded: ${sid || 'no current session'}`);
+        })
+        .catch((e) => log('warn', `session window state read failed: ${e.message}`));
+    }, 8000);
+  });
+  attachShellGuards(win);
+  return win;
+}
+
+function focusedShellWindow() {
+  const focused = BrowserWindow.getFocusedWindow();
+  if (focused && !focused.isDestroyed() && (focused === mainWin || sessionWindows.has(focused))) return focused;
+  return mainWin;
+}
+
+function openSessionUrl(sessionId) {
+  const win = createSessionWindow(sessionId);
+  sessionWindows.add(win);
+  log('info', `open session window: ${sessionId}`);
+}
+
+async function openSessionWindowFrom(sourceWin) {
+  if (!harnessUrl) {
+    log('warn', 'open session window: engine not ready');
+    notify('无法打开新窗口', '本地引擎未就绪');
+    return;
+  }
+  const target = sourceWin || focusedShellWindow();
+  if (!target || target.isDestroyed()) {
+    log('warn', 'open session window: no source window');
+    return;
+  }
+  let raw = null;
+  try {
+    raw = await target.webContents.executeJavaScript('localStorage.getItem("dsh.sessions.current")', true);
+  } catch (e) {
+    log('warn', `open session window: read current session failed: ${e.message}`);
+  }
+  const sessionId = parseCurrentSession(raw);
+  if (!sessionId) {
+    log('warn', 'open session window: current session id unavailable');
+    notify('无法打开新窗口', '未找到当前会话');
+    return;
+  }
+  openSessionUrl(sessionId);
+}
+
+function saveStateDebounced() {
+  clearTimeout(stateTimer);
+  stateTimer = setTimeout(saveStateNow, 600);
+}
+function saveStateNow() {
+  if (!mainWin || mainWin.isDestroyed()) return;
+  const b = mainWin.getBounds();
+  saveJson(statePath, { x: b.x, y: b.y, width: b.width, height: b.height, maximized: mainWin.isMaximized() });
+}
+
+// ---------- 启动画面 ----------
+function createSplash() {
+  splash = new BrowserWindow({
+    width: 380, height: 230, frame: false, resizable: false,
+    alwaysOnTop: true, skipTaskbar: true, show: false,
+    backgroundColor: '#101216',
+    webPreferences: { sandbox: true },
+  });
+  splash.loadFile(path.join(__dirname, 'splash.html'));
+  splash.once('ready-to-show', () => splash.show());
+  splash.on('closed', () => { splash = null; });
+}
+
+// ---------- 错误/重连页 ----------
+function escapeHtml(s) {
+  return String(s).replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
+}
+function errorHtml(msg) {
+  return `<!doctype html><html><head><meta charset="utf-8"><style>
+    body{margin:0;height:100vh;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:14px;background:#101216;color:#e5e7eb;font-family:'Segoe UI',system-ui,sans-serif}
+    h1{font-size:18px;margin:0;color:#9aa4b2;font-weight:600}
+    p{font-size:13px;color:#6b7280;max-width:520px;text-align:center;line-height:1.6}
+    button{background:#4d6bfe;border:none;color:#fff;font-size:14px;padding:8px 24px;border-radius:8px;cursor:pointer}
+    button:hover{background:#3b5bfe}</style></head><body>
+    <h1>DeepSeek Harness</h1><p>${escapeHtml(msg)}</p>
+    <button onclick="window.dshNative && window.dshNative.retryHarness()">重试</button>
+    </body></html>`;
+}
+function showError(msg) {
+  log('error', msg);
+  if (!mainWin || mainWin.isDestroyed()) {
+    if (splash && !splash.isDestroyed()) splash.close();
+    mainWin = new BrowserWindow({
+      width: 720, height: 420, show: false, title: 'DeepSeek Harness',
+      icon: nativeImage.createFromPath(path.join(ASSETS, 'icon-app.png')), backgroundColor: '#101216',
+      // 固定对话框(设计系统「窗口框架」):禁止缩放/最大化,保留拖拽
+      resizable: false, maximizable: false, minimizable: false,
+      // 必须带 preload:错误页的「重试」按钮依赖 window.dshNative.retryHarness()
+      webPreferences: { sandbox: true, contextIsolation: true, preload: path.join(__dirname, 'preload.js') },
+    });
+    mainWin.once('ready-to-show', () => mainWin.show());
+  }
+  mainWin.loadURL('data:text/html;charset=utf-8,' + encodeURIComponent(errorHtml(msg)));
+}
+
+// ---------- 通知 / 托盘 / 快捷键 / 自启 ----------
+function notify(title, body) {
+  if (!Notification.isSupported()) return;
+  try { new Notification({ title, body, icon: path.join(ASSETS, 'icon-app.png') }).show(); } catch { /* ignore */ }
+}
+function toggleWindow() {
+  if (!mainWin || mainWin.isDestroyed()) {
+    if (harnessUrl) mainWin = createMainWindow(harnessUrl);
+    return;
+  }
+  if (mainWin.isVisible() && mainWin.isFocused()) mainWin.hide();
+  else { mainWin.show(); mainWin.focus(); }
+}
+function createTray() {
+  // 托盘图标跟随系统主题(深色=白鲸,浅色=黑鲸),与窗口一致
+  try {
+    let icon = nativeImage.createFromPath(path.join(ASSETS, 'icon-app.png'));
+    if (icon.isEmpty()) icon = nativeImage.createFromPath(path.join(ASSETS, 'tray.png'));
+    if (icon.isEmpty()) icon = nativeImage.createEmpty();
+    tray = new Tray(icon);
+    tray.setToolTip('DeepSeek Harness');
+    refreshTrayMenu();
+    tray.on('click', toggleWindow);
+    log('info', 'tray created');
+  } catch (e) {
+    log('warn', `tray creation failed: ${e.message}`);
+    tray = null;
+  }
+}
+function refreshTrayMenu() {
+  if (!tray) return;
+  tray.setContextMenu(Menu.buildFromTemplate([
+    { label: '显示 / 隐藏主窗口', click: toggleWindow },
+    { type: 'separator' },
+    { label: '开机自启', type: 'checkbox', checked: !!settings.autostart, click: (item) => setAutostart(item.checked) },
+    { label: `全局快捷键 ${settings.shortcut}`, enabled: false },
+    { type: 'separator' },
+    { label: '当前会话在新窗口打开', click: () => { openSessionWindowFrom(null); } },
+    { label: '检查更新…', click: () => { runCheckUpdates(); } },
+    { label: '开发者工具', click: () => { if (mainWin && !mainWin.isDestroyed()) mainWin.webContents.toggleDevTools(); } },
+    { label: '退出', click: quitApp },
+  ]));
+}
+function setAutostart(on) {
+  settings.autostart = on;
+  saveJson(settingsPath, settings);
+  try {
+    app.setLoginItemSettings({ openAtLogin: on, path: process.execPath, args: app.isPackaged ? [] : [app.getAppPath()] });
+  } catch (e) { log('warn', `setLoginItemSettings: ${e.message}`); }
+  refreshTrayMenu();
+}
+function killHarness() {
+  if (!child) return;
+  const pid = child.pid;
+  try { child.kill(); } catch { /* ignore */ }
+  child = null; // 立即让出引用:手动重试/退出时不会触发自动重启分支
+  stdoutBuf = '';
+  harnessUrl = null;
+  if (process.platform === 'win32' && pid) {
+    // 确保进程树(含 npx/cmd 链)全部结束
+    execFile('taskkill', ['/pid', String(pid), '/t', '/f'], () => { /* ignore */ });
+  }
+}
+function quitApp() {
+  quitting = true;
+  clearTimeout(restartTimer); // 崩溃重启挂起时退出,避免定时器再 spawn 出孤儿引擎
+  clearTimeout(startTimer);
+  stopEventsWatch();
+  killHarness();
+  killWebEngine(); // 合并:托盘退出时顺带关闭共享的 web 端引擎(3080)
+  try { globalShortcut.unregisterAll(); } catch { /* ignore */ }
+  saveStateNow();
+  app.quit();
+}
+
+// 杀掉共享的 web 端引擎(启动参数含 "bin.js web ... --port N" 的 node 进程树)。
+// 与 stop-web.js 同逻辑(打包后无法 require scripts,内联实现)。
+function killWebEngine() {
+  try {
+    const r = require('node:child_process').execFileSync('powershell', [
+      '-NoProfile', '-NonInteractive', '-Command',
+      'Get-CimInstance Win32_Process -Filter "Name=\'node.exe\'" | Where-Object { $_.CommandLine -match \'bin\\.js.*web.*--port\' } | ForEach-Object { $_.ProcessId }',
+    ], { encoding: 'utf8', timeout: 10000 });
+    for (const pid of r.trim().split(/\s+/).filter(Boolean)) {
+      log('info', `quit: killing web engine pid ${pid}`);
+      execFile('taskkill', ['/PID', pid, '/T', '/F'], () => { /* ignore */ });
+    }
+  } catch (e) {
+    log('warn', `killWebEngine failed: ${e.message}`);
+  }
+}
+
+// ---------- IPC ----------
+// ---------- IPC ----------
+// 自绘标题栏:窗口控制(按钮点击由 preload 转发)
+function ipcWindow(event) {
+  const win = BrowserWindow.fromWebContents(event.sender);
+  return win && !win.isDestroyed() ? win : null;
+}
+ipcMain.on('win-minimize', (event) => {
+  const win = ipcWindow(event);
+  if (win) win.minimize();
+});
+ipcMain.on('win-maximize-toggle', (event) => {
+  const win = ipcWindow(event);
+  if (!win) return;
+  if (win.isMaximized()) win.unmaximize(); else win.maximize();
+});
+ipcMain.on('win-close', (event) => {
+  const win = ipcWindow(event);
+  if (win) win.close();
+});
+// 标题栏鲸鱼 logo:主进程读官方 SVG(单一来源 assets/whale.svg)注入渲染页
+ipcMain.handle('get-brand-svg', () => {
+  try { return fs.readFileSync(path.join(ASSETS, 'whale.svg'), 'utf8'); } catch { return null; }
+});
+ipcMain.on('notify', (_e, payload = {}) => {
+  if (payload.title) notify(payload.title, payload.body || '');
+});
+ipcMain.on('retry-harness', () => {
+  if (quitting) return;
+  if (child) killHarness(); // 启动超时/卡死时旧进程可能还活着,先清掉再重启
+  log('info', 'manual retry requested');
+  startHarness();
+});
+ipcMain.on('open-session-window', (event, payload) => {
+  const win = BrowserWindow.fromWebContents(event.sender);
+  const sid = payload && typeof payload.sessionId === 'string' && SESSION_ID_RE.test(payload.sessionId)
+    ? payload.sessionId
+    : null;
+  if (sid) openSessionUrl(sid);
+  else if (win) openSessionWindowFrom(win);
+  else log('warn', 'open session window: unknown source window');
+});
+// 拖拽调整尺寸黑边修复:渲染进程把页面背景色同步为窗口底层色,
+// resize 新增像素区域露出的底色与页面一致,不再闪黑边
+ipcMain.on('set-window-bg', (_e, color) => {
+  const win = ipcWindow(_e);
+  if (typeof color !== 'string' || !win) return;
+  log('info', `set window bg -> ${color}`);
+  try { win.setBackgroundColor(color); } catch (e) { log('warn', `setBackgroundColor failed: ${e.message}`); }
+});
+
+// ---------- 检查更新 / 自动更新(托盘入口) ----------
+// 流程:对比版本 → 拉取 files.json → 本地差异 → 下载(逐文件 sha256 校验)
+//       → 重启自身进入 apply 模式 → .dsh-apply.cmd 收尾(exe 替换 + 清理 + 再启动)。
+async function runCheckUpdates() {
+  const res = await checkForUpdates(settings.updateUrl, app.getVersion());
+  if (!res.ok) {
+    log('warn', `check update: ${res.error}`);
+    notify('检查更新', res.error);
+    return res;
+  }
+  log('info', `check update: current=${res.current} latest=${res.latest} hasUpdate=${res.hasUpdate}`);
+  if (!res.hasUpdate) {
+    notify('检查更新', `已是最新版本 v${res.current}`);
+    return res;
+  }
+  notify('检查更新', `发现新版本 v${res.latest}(当前 v${res.current}),开始下载…`);
+  const base = String(settings.updateUrl).replace(/\/+$/, '');
+  const appRoot = PACKAGE_ROOT;
+  const staging = path.join(appRoot, '.dsh-update-staging');
+  try {
+    const filesManifest = await fetchJson(base + '/files.json');
+    if (!Array.isArray(filesManifest.files)) throw new Error('files.json 缺少 files 数组');
+    fs.rmSync(staging, { recursive: true, force: true });
+    const need = await diffLocal(appRoot, filesManifest.files);
+    if (need.length === 0) {
+      notify('检查更新', '文件已是最新,无需下载');
+      return res;
+    }
+    log('info', `update: ${need.length} files to download (${(need.reduce((s, f) => s + f.size, 0) / 1048576).toFixed(1)} MB)`);
+    await downloadUpdate(base, need, staging, (done, total) => {
+      if (done === total || done % 100 === 0) log('info', `update download: ${done}/${total}`);
+    });
+    notify('检查更新', `更新已就绪(v${res.latest}),正在重启应用…`);
+    // 重启自身进入 apply 模式;本进程随后退出,由新进程替换文件树
+    try {
+      spawn(process.execPath, ['--dsh-apply-update'], { detached: true, stdio: 'ignore', windowsHide: true }).unref();
+    } catch (e) {
+      log('error', `spawn apply-update failed: ${e.message}`);
+    }
+    quitApp();
+    return { ...res, downloading: true };
+  } catch (e) {
+    fs.rmSync(staging, { recursive: true, force: true });
+    const msg = e && e.message ? e.message : String(e);
+    log('error', `update failed: ${msg}`);
+    notify('检查更新', `更新失败: ${msg}`);
+    return { ok: false, error: msg };
+  }
+}
+
+// ---------- 应用生命周期 ----------
+process.on('uncaughtException', (e) => log('error', `uncaughtException: ${e && e.stack ? e.stack : e}`));
+process.on('unhandledRejection', (r) => log('error', `unhandledRejection: ${r}`));
+
+const gotLock = app.requestSingleInstanceLock();
+if (!gotLock) {
+  app.quit();
+} else {
+  app.on('second-instance', () => {
+    if (mainWin && !mainWin.isDestroyed()) {
+      if (mainWin.isMinimized()) mainWin.restore();
+      mainWin.show();
+      mainWin.focus();
+    }
+  });
+
+  app.whenReady().then(async () => {
+    // 只允许 loopback 页面请求权限(摄像头/通知等),其余一律拒绝
+    app.on('web-contents-created', (_e, wc) => {
+      wc.session.setPermissionRequestHandler((wc2, permission, cb) => {
+        cb(wc2.getURL().startsWith('http://127.0.0.1:'));
+      });
+    });
+
+    try { createSplash(); } catch (e) { log('warn', `splash failed: ${e.message}`); }
+    try { createTray(); } catch (e) { log('warn', `tray failed: ${e.message}`); }
+
+    if (settings.autostart) {
+      try {
+        if (!app.getLoginItemSettings().openAtLogin) {
+          app.setLoginItemSettings({ openAtLogin: true, path: process.execPath, args: app.isPackaged ? [] : [app.getAppPath()] });
+        }
+      } catch (e) { log('warn', `autostart check: ${e.message}`); }
+    }
+    try { globalShortcut.register(settings.shortcut, toggleWindow); }
+    catch (e) { log('warn', `global shortcut register failed: ${e.message}`); }
+
+    if (!(await ensureDataHome())) {
+      showError('独立数据根引导失败:源 profile 不存在且自动安装 dsh 未成功(需联网)。请检查网络后点击「重试」。');
+      return;
+    }
+    startHarness();
+  });
+}
+
+app.on('window-all-closed', () => { /* 驻留托盘,不退出 */ });
+app.on('before-quit', () => { quitting = true; clearTimeout(restartTimer); clearTimeout(startTimer); stopEventsWatch(); killHarness(); });
+app.on('activate', () => { if (mainWin && !mainWin.isDestroyed()) mainWin.show(); });
+