@bolloon/bolloon-agent 0.3.36 → 0.3.38

package/dist/electron/window.js

@@ -1,63 +1,25 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMainWindow = getMainWindow;
-exports.createMainWindow = createMainWindow;
-exports.focusMainWindow = focusMainWindow;
 /**
  * 主窗口工厂 — preload 路径解析 + dev/prod loadURL + 外部链接走系统浏览器
  */
-const electron_1 = require("electron");
-const path = __importStar(require("path"));
-const logger_1 = require("./logger");
-const config_1 = require("./config");
-const server_1 = require("./server");
+import { BrowserWindow, shell } from 'electron';
+import * as path from 'path';
+import { log } from './logger';
+import { isDev, MAIN_WINDOW_DEFAULT, MAIN_WINDOW_MIN, preferredPort } from './config';
+import { startWebServer } from './server';
 const g = globalThis;
 const __basedir = g.__dirname
     ?? (g.__filename ? path.dirname(g.__filename) : process.cwd());
 let mainWindow = null;
-function getMainWindow() {
+export function getMainWindow() {
     return mainWindow;
 }
-async function createMainWindow() {
-    (0, logger_1.log)('创建主窗口...');
-    mainWindow = new electron_1.BrowserWindow({
-        width: config_1.MAIN_WINDOW_DEFAULT.width,
-        height: config_1.MAIN_WINDOW_DEFAULT.height,
-        minWidth: config_1.MAIN_WINDOW_MIN.width,
-        minHeight: config_1.MAIN_WINDOW_MIN.height,
+export async function createMainWindow() {
+    log('创建主窗口...');
+    mainWindow = new BrowserWindow({
+        width: MAIN_WINDOW_DEFAULT.width,
+        height: MAIN_WINDOW_DEFAULT.height,
+        minWidth: MAIN_WINDOW_MIN.width,
+        minHeight: MAIN_WINDOW_MIN.height,
         title: 'Bolloon Agent',
         webPreferences: {
             nodeIntegration: false,
@@ -67,40 +29,40 @@ async function createMainWindow() {
         },
         show: false,
     });
-    if (config_1.isDev) {
+    if (isDev) {
         // dev:web 用 tsx 起 server, 端口固定 preferredPort, 不会 EADDRINUSE 自增
-        const port = (0, config_1.preferredPort)();
+        const port = preferredPort();
         mainWindow.loadURL(`http://localhost:${port}`);
         mainWindow.webContents.openDevTools();
     }
     else {
         try {
-            (0, logger_1.log)('启动内置 Web 服务器...');
-            const { port: actualPort } = await (0, server_1.startWebServer)((0, config_1.preferredPort)());
+            log('启动内置 Web 服务器...');
+            const { port: actualPort } = await startWebServer(preferredPort());
             mainWindow.loadURL(`http://localhost:${actualPort}`);
         }
         catch (err) {
-            (0, logger_1.log)(`启动服务器失败: ${err.message}`, 'error');
+            log(`启动服务器失败: ${err.message}`, 'error');
             console.error('启动服务器失败:', err);
         }
     }
     mainWindow.once('ready-to-show', () => {
         mainWindow?.show();
-        (0, logger_1.log)('窗口已显示');
+        log('窗口已显示');
     });
     // 外部链接走系统浏览器, 不在 app 内开新窗口
     mainWindow.webContents.setWindowOpenHandler(({ url }) => {
         if (url.startsWith('http://') || url.startsWith('https://')) {
-            electron_1.shell.openExternal(url);
+            shell.openExternal(url);
         }
         return { action: 'deny' };
     });
     mainWindow.on('closed', () => {
         mainWindow = null;
     });
-    (0, logger_1.log)('窗口创建完成');
+    log('窗口创建完成');
 }
-function focusMainWindow() {
+export function focusMainWindow() {
     if (!mainWindow)
         return;
     if (mainWindow.isMinimized())
@@ -108,4 +70,3 @@ function focusMainWindow() {
     mainWindow.show();
     mainWindow.focus();
 }
-//# sourceMappingURL=window.js.map

package/dist/electron-build/electron/config.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDev = exports.MAIN_WINDOW_MIN = exports.MAIN_WINDOW_DEFAULT = exports.WEB_SERVER_STARTUP_TIMEOUT_MS = exports.DEFAULT_HOST = exports.DEFAULT_PORT = void 0;
+exports.preferredPort = preferredPort;
+/**
+ * 常量配置 (env 解析在这里集中, 不散在 main 流程)
+ */
+const electron_1 = require("electron");
+exports.DEFAULT_PORT = 54188;
+/** Hard-pin to loopback; LAN exposure must be explicit. */
+exports.DEFAULT_HOST = '127.0.0.1';
+exports.WEB_SERVER_STARTUP_TIMEOUT_MS = 15_000;
+exports.MAIN_WINDOW_DEFAULT = { width: 1200, height: 800 };
+exports.MAIN_WINDOW_MIN = { width: 800, height: 600 };
+function preferredPort() {
+    const raw = process.env.ELECTRON_PORT || process.env.PORT;
+    const n = parseInt(raw || '', 10);
+    return Number.isFinite(n) && n > 0 && n < 65536 ? n : exports.DEFAULT_PORT;
+}
+exports.isDev = process.env.NODE_ENV === 'development' || !electron_1.app.isPackaged;
+//# sourceMappingURL=config.js.map

package/dist/electron-build/electron/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/electron/config.ts"],"names":[],"mappings":";;;AAcA,sCAIC;AAlBD;;GAEG;AACH,uCAA+B;AAElB,QAAA,YAAY,GAAG,KAAK,CAAC;AAClC,2DAA2D;AAC9C,QAAA,YAAY,GAAG,WAAW,CAAC;AAE3B,QAAA,6BAA6B,GAAG,MAAM,CAAC;AAEvC,QAAA,mBAAmB,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AACnD,QAAA,eAAe,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AAE3D,SAAgB,aAAa;IAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAC1D,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAY,CAAC;AACrE,CAAC;AAEY,QAAA,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,CAAC,cAAG,CAAC,UAAU,CAAC"}

package/dist/electron-build/electron/dialogs.js

@@ -0,0 +1,108 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDialogIpc = registerDialogIpc;
+/**
+ * 文件 dialog 桥 (open / save / dir) + 安全的 fs 桥 (read / write / exists)
+ *
+ * 5MB read 上限保护 — 渲染进程直接 fs.readFile 没法做限制, 走主进程就有界
+ * 所有 handler 解析 event.sender 拿到 window, 让 dialog 模态在该窗口上
+ */
+const electron_1 = require("electron");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("./logger");
+const MAX_READ_BYTES = 5 * 1024 * 1024; // 5MB
+function windowFor(event) {
+    return electron_1.BrowserWindow.fromWebContents(event.sender);
+}
+function resolveSafe(target) {
+    // 不去硬限制路径 — user 给 renderer 暴露 fs 已经信任了, 这里只 normalize
+    return path.resolve(target);
+}
+function registerDialogIpc() {
+    electron_1.ipcMain.handle('dialog:open-file', async (event, opts = {}) => {
+        const win = windowFor(event);
+        const result = await electron_1.dialog.showOpenDialog(win, {
+            title: opts.title,
+            defaultPath: opts.defaultPath,
+            filters: opts.filters,
+            properties: opts.properties ?? ['openFile'],
+        });
+        return { canceled: result.canceled, filePaths: result.filePaths };
+    });
+    electron_1.ipcMain.handle('dialog:save-file', async (event, opts = {}) => {
+        const win = windowFor(event);
+        const result = await electron_1.dialog.showSaveDialog(win, {
+            title: opts.title,
+            defaultPath: opts.defaultPath,
+            filters: opts.filters,
+        });
+        return { canceled: result.canceled, filePath: result.filePath };
+    });
+    electron_1.ipcMain.handle('dialog:open-directory', async (event, opts = {}) => {
+        const win = windowFor(event);
+        const result = await electron_1.dialog.showOpenDialog(win, {
+            title: opts.title,
+            defaultPath: opts.defaultPath,
+            properties: ['openDirectory', 'createDirectory'],
+        });
+        return { canceled: result.canceled, filePaths: result.filePaths };
+    });
+    electron_1.ipcMain.handle('fs:read-text-file', async (_event, opts) => {
+        const target = resolveSafe(opts.path);
+        const stat = fs.statSync(target);
+        if (stat.size > MAX_READ_BYTES) {
+            throw new Error(`文件过大: ${stat.size} > ${MAX_READ_BYTES} bytes`);
+        }
+        return fs.readFileSync(target, { encoding: opts.encoding ?? 'utf8' });
+    });
+    electron_1.ipcMain.handle('fs:write-text-file', async (_event, opts) => {
+        const target = resolveSafe(opts.path);
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        fs.writeFileSync(target, opts.content, { encoding: opts.encoding ?? 'utf8' });
+    });
+    electron_1.ipcMain.handle('fs:path-exists', async (_event, opts) => {
+        try {
+            fs.accessSync(resolveSafe(opts.path));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+    (0, logger_1.log)('dialog + fs IPC handlers registered');
+}
+//# sourceMappingURL=dialogs.js.map

package/dist/electron-build/electron/dialogs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogs.js","sourceRoot":"","sources":["../../../src/electron/dialogs.ts"],"names":[],"mappings":"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"}

package/dist/electron-build/electron/first-run.js

@@ -0,0 +1,170 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasSeenFirstRun = hasSeenFirstRun;
+exports.markFirstRunSeen = markFirstRunSeen;
+exports.showFirstRunOverlay = showFirstRunOverlay;
+exports.registerFirstRunIpc = registerFirstRunIpc;
+exports.maybeShowFirstRun = maybeShowFirstRun;
+/**
+ * 首启检测 + 引导浮层
+ *
+ * 标记文件写在 userData (不是 ~/.bolloon/), 卸载 app 自然清掉
+ * 引导窗是父主窗的 modal, frame=false, 透明背景; 关闭时标记写入
+ */
+const electron_1 = require("electron");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const paths_1 = require("./paths");
+const logger_1 = require("./logger");
+const OVERLAY_HTML = `
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8" />
+<style>
+  :root { color-scheme: light dark; }
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+    margin: 0; padding: 32px 28px;
+    background: rgba(245,245,247,0.97);
+    color: #1d1d1f;
+    height: 100vh; box-sizing: border-box;
+  }
+  @media (prefers-color-scheme: dark) {
+    body { background: rgba(28,28,30,0.97); color: #f5f5f7; }
+  }
+  h1 { font-size: 18px; margin: 0 0 14px; font-weight: 600; }
+  p  { font-size: 13px; line-height: 1.55; margin: 8px 0; }
+  code {
+    font-family: ui-monospace, "SF Mono", Menlo, monospace;
+    font-size: 12px; padding: 1px 5px;
+    background: rgba(0,0,0,0.06); border-radius: 3px;
+  }
+  @media (prefers-color-scheme: dark) {
+    code { background: rgba(255,255,255,0.08); }
+  }
+  .btn {
+    display: inline-block; margin-top: 18px; padding: 8px 18px;
+    background: #007aff; color: #fff; border: none; border-radius: 6px;
+    font-size: 13px; font-weight: 500; cursor: pointer;
+  }
+  .btn:hover { background: #0066d6; }
+  ul { padding-left: 20px; }
+  li { font-size: 13px; line-height: 1.7; }
+</style>
+</head>
+<body>
+<h1>欢迎使用 Bolloon Agent</h1>
+<p>你的数据存放在本地, 不上传:</p>
+<ul>
+  <li>配置 / 频道 / P2P 密钥: <code id="data"></code></li>
+  <li>运行日志: <code id="logs"></code></li>
+</ul>
+<p>所有数据在卸载后仍保留 — 想清理就手动删除 ~/.bolloon/。</p>
+<button class="btn" id="ok">知道了</button>
+<script>
+  const ok = document.getElementById('ok');
+  ok.addEventListener('click', () => window.electronAPI.markFirstRunSeen());
+  document.getElementById('data').textContent = window.electronAPI.getDataPathSync?.() || '';
+  document.getElementById('logs').textContent = window.electronAPI.getLogsPathSync?.() || '';
+</script>
+</body>
+</html>
+`;
+function hasSeenFirstRun() {
+    try {
+        return fs.existsSync((0, paths_1.firstRunFlagPath)());
+    }
+    catch {
+        return false;
+    }
+}
+function markFirstRunSeen() {
+    try {
+        fs.mkdirSync(path.dirname((0, paths_1.firstRunFlagPath)()), { recursive: true });
+        fs.writeFileSync((0, paths_1.firstRunFlagPath)(), new Date().toISOString());
+    }
+    catch (err) {
+        (0, logger_1.log)(`写入首启标记失败: ${err.message}`, 'warn');
+    }
+}
+function showFirstRunOverlay(parent) {
+    return new Promise((resolve) => {
+        const overlay = new electron_1.BrowserWindow({
+            parent,
+            modal: true,
+            frame: false,
+            transparent: true,
+            width: 520,
+            height: 360,
+            resizable: false,
+            movable: false,
+            minimizable: false,
+            maximizable: false,
+            title: 'Welcome',
+        });
+        const dataUrl = 'data:text/html;charset=utf-8,' + encodeURIComponent(OVERLAY_HTML);
+        overlay.loadURL(dataUrl);
+        // 一次性的 IPC handler, 关闭后清掉避免累积
+        const handler = () => {
+            markFirstRunSeen();
+            overlay.close();
+        };
+        electron_1.ipcMain.once('first-run:ack', handler);
+        overlay.on('closed', () => {
+            electron_1.ipcMain.removeListener('first-run:ack', handler);
+            resolve();
+        });
+    });
+}
+/** 注册 IPC handlers (给 preload 桥用) */
+function registerFirstRunIpc() {
+    electron_1.ipcMain.handle('first-run:seen', () => hasSeenFirstRun());
+    electron_1.ipcMain.handle('first-run:mark-seen', () => { markFirstRunSeen(); });
+    // 同步值 (不用 ipcRenderer.invoke 的 await) — 用 exposeInMainWorld 的 sync getter 更顺
+    electron_1.ipcMain.handle('first-run:data-dir', () => (0, paths_1.dataDir)());
+    electron_1.ipcMain.handle('first-run:logs-dir', () => (0, paths_1.logsDir)());
+    (0, logger_1.log)('first-run IPC handlers registered');
+}
+/** 包装 — 决定要不要弹 overlay */
+async function maybeShowFirstRun(parent) {
+    if (hasSeenFirstRun())
+        return;
+    (0, logger_1.log)('首启 — 弹出引导');
+    await showFirstRunOverlay(parent);
+    electron_1.app.addRecentDocument((0, paths_1.firstRunFlagPath)()); // 跟踪最近文档, 让 user 知道有这文件
+}
+//# sourceMappingURL=first-run.js.map

package/dist/electron-build/electron/first-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run.js","sourceRoot":"","sources":["../../../src/electron/first-run.ts"],"names":[],"mappings":"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"}

package/dist/electron-build/electron/ipc.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCoreIpc = registerCoreIpc;
+/**
+ * IPC handler 集中注册 — version / userData path / open-external (legacy 3 个)
+ * dialog/fs 的注册在 dialogs.ts; updater 的注册在 updater.ts
+ */
+const electron_1 = require("electron");
+const paths_1 = require("./paths");
+const logger_1 = require("./logger");
+function registerCoreIpc() {
+    electron_1.ipcMain.handle('get-version', () => electron_1.app.getVersion());
+    electron_1.ipcMain.handle('get-user-data-path', () => (0, paths_1.userDataDir)());
+    electron_1.ipcMain.handle('get-data-path', () => (0, paths_1.dataDir)()); // 跟 userData 分开, 渲染层要用
+    electron_1.ipcMain.handle('open-external', async (_event, url) => {
+        await electron_1.shell.openExternal(url);
+    });
+    (0, logger_1.log)('core IPC handlers registered');
+}
+//# sourceMappingURL=ipc.js.map

package/dist/electron-build/electron/ipc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipc.js","sourceRoot":"","sources":["../../../src/electron/ipc.ts"],"names":[],"mappings":";;AAQA,0CAWC;AAnBD;;;GAGG;AACH,uCAA+C;AAC/C,mCAA+C;AAC/C,qCAA+B;AAE/B,SAAgB,eAAe;IAC7B,kBAAO,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,cAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAEtD,kBAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAA,mBAAW,GAAE,CAAC,CAAC;IAC1D,kBAAO,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,IAAA,eAAO,GAAE,CAAC,CAAC,CAAC,uBAAuB;IAEzE,kBAAO,CAAC,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,GAAW,EAAE,EAAE;QAC5D,MAAM,gBAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAA,YAAG,EAAC,8BAA8B,CAAC,CAAC;AACtC,CAAC"}

package/dist/electron-build/electron/logger.js

@@ -0,0 +1,114 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = log;
+/**
+ * 简单 logger: 写日志到 <userData>/logs/bolloon.log, size-based 轮转
+ * (5MB 上限, 保留 .1 .2 .3 共 3 个备份 → ~20MB 上限)
+ *
+ * 同步写是因为 Electron 主进程日志量小, 同步 append 简单可靠, 不丢日志.
+ * 量大的会话级 jsonl 走自己路径 (lifecycle-hooks 等), 跟本 logger 无关.
+ */
+const fs = __importStar(require("fs"));
+const paths_1 = require("./paths");
+const MAX_BYTES = 5 * 1024 * 1024;
+const MAX_BACKUPS = 3; // 保留 bolloon.log.1 .2 .3
+let currentSize = 0;
+let initialized = false;
+function ensureLogFile() {
+    if (initialized)
+        return;
+    initialized = true;
+    try {
+        fs.mkdirSync((0, paths_1.logsDir)(), { recursive: true });
+        try {
+            currentSize = fs.statSync((0, paths_1.mainLogPath)()).size;
+        }
+        catch {
+            currentSize = 0;
+        }
+    }
+    catch (err) {
+        // 失败也无所谓, log() 内部会 swallow
+        currentSize = 0;
+        console.error('[logger] ensureLogFile failed:', err);
+    }
+}
+function rotate() {
+    const logPath = (0, paths_1.mainLogPath)();
+    for (let i = MAX_BACKUPS; i >= 1; i--) {
+        const src = `${logPath}.${i}`;
+        const dst = `${logPath}.${i + 1}`;
+        if (i === MAX_BACKUPS) {
+            try {
+                fs.unlinkSync(src);
+            }
+            catch { /* missing ok */ }
+        }
+        else {
+            try {
+                fs.renameSync(src, dst);
+            }
+            catch { /* missing ok */ }
+        }
+    }
+    try {
+        fs.renameSync(logPath, `${logPath}.1`);
+    }
+    catch { /* missing ok */ }
+    currentSize = 0;
+}
+function log(message, level = 'info') {
+    ensureLogFile();
+    const ts = new Date().toISOString();
+    const line = `[${ts}] [${level}] ${message}\n`;
+    if (currentSize + line.length > MAX_BYTES)
+        rotate();
+    try {
+        fs.appendFileSync((0, paths_1.mainLogPath)(), line);
+        currentSize += line.length;
+    }
+    catch (err) {
+        // 写不进就 console, 不要再递归 log
+        console.error('[logger] appendFileSync failed:', err);
+    }
+    if (level === 'error')
+        console.error(line.trimEnd());
+    else if (level === 'warn')
+        console.warn(line.trimEnd());
+    else
+        console.log(line.trimEnd());
+}
+//# sourceMappingURL=logger.js.map

package/dist/electron-build/electron/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/electron/logger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDA,kBAkBC;AArED;;;;;;GAMG;AACH,uCAAyB;AAEzB,mCAA+C;AAE/C,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAClC,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,yBAAyB;AAEhD,IAAI,WAAW,GAAG,CAAC,CAAC;AACpB,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB,SAAS,aAAa;IACpB,IAAI,WAAW;QAAE,OAAO;IACxB,WAAW,GAAG,IAAI,CAAC;IACnB,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,IAAA,eAAO,GAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,WAAW,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAA,mBAAW,GAAE,CAAC,CAAC,IAAI,CAAC;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,4BAA4B;QAC5B,WAAW,GAAG,CAAC,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,SAAS,MAAM;IACb,MAAM,OAAO,GAAG,IAAA,mBAAW,GAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC;gBAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,OAAO,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC1E,WAAW,GAAG,CAAC,CAAC;AAClB,CAAC;AAID,SAAgB,GAAG,CAAC,OAAe,EAAE,QAAkB,MAAM;IAC3D,aAAa,EAAE,CAAC;IAChB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,EAAE,MAAM,KAAK,KAAK,OAAO,IAAI,CAAC;IAE/C,IAAI,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,SAAS;QAAE,MAAM,EAAE,CAAC;IAEpD,IAAI,CAAC;QACH,EAAE,CAAC,cAAc,CAAC,IAAA,mBAAW,GAAE,EAAE,IAAI,CAAC,CAAC;QACvC,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,0BAA0B;QAC1B,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;SAChD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;;QACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACnC,CAAC"}