@bolloon/bolloon-agent 0.1.41 → 0.2.0

package/dist/bollharness-integration/skill-adapter.js

@@ -88,6 +88,10 @@ function loadAllHarnessSkills() {
  * Base skill class for bollharness-compatible skills
  */
 export class BaseSkill {
+    static llm = null;
+    static setLlm(instance) {
+        BaseSkill.llm = instance;
+    }
     log(message, level = 'info') {
         const prefix = level === 'error' ? '❌' : level === 'warn' ? '⚠️' : 'ℹ️';
         console.log(`${prefix} [${this.name}] ${message}`);
@@ -95,6 +99,33 @@ export class BaseSkill {
     formatOutput(output) {
         return JSON.stringify(output, null, 2);
     }
+    async callLm(system, user) {
+        let llm = BaseSkill.llm;
+        if (!llm) {
+            try {
+                const { getMinimax } = await import('../llm/pi-ai.js');
+                const m = getMinimax();
+                if (m && typeof m.chat === 'function') {
+                    BaseSkill.setLlm(m);
+                    llm = m;
+                }
+            }
+            catch {
+                return this.formatOutput({ warning: 'LLM 未注入', name: this.name });
+            }
+        }
+        if (!llm) {
+            return this.formatOutput({ warning: 'LLM 未注入', name: this.name });
+        }
+        try {
+            const res = await llm.chat([{ role: 'user', content: user }], system);
+            return res.reply || '(空回复)';
+        }
+        catch (err) {
+            this.log(`LLM 调用失败: ${err.message}`, 'error');
+            return this.formatOutput({ error: `LLM 调用失败: ${err.message}` });
+        }
+    }
 }
 /**
  * Architecture Skill - Project architect for architecture decisions
@@ -103,58 +134,12 @@ export class ArchSkill extends BaseSkill {
     name = 'arch';
     description = 'Project architect. Responsible for architecture decisions, scheme comparison, and boundary freezing.';
     async execute(params) {
-        const task = params.task || params.description;
+        const task = (params.task || params.description || params.action || '');
         this.log('Analyzing architecture task');
-        // Extract essence
-        const essence = this.extractEssence(task);
-        // Find tensions
-        const tensions = this.identifyTensions(task);
-        // Compare alternatives
-        const alternatives = this.compareAlternatives(task);
-        // Identify boundaries to freeze
-        const boundaries = this.identifyBoundaries(task);
-        return this.formatOutput({
-            essence,
-            tensions,
-            alternatives,
-            boundaries,
-            recommendation: this.makeRecommendation(task, alternatives),
-        });
-    }
-    extractEssence(task) {
-        // Simplified essence extraction
-        return `The core challenge is: ${task}`;
-    }
-    identifyTensions(task) {
-        return [
-            'Simplicity vs Flexibility',
-            'Performance vs Maintainability',
-            'Coupling vs Cohesion',
-        ];
-    }
-    compareAlternatives(task) {
-        return [
-            {
-                name: 'Option A: Direct Implementation',
-                tradeoffs: ['Fast to implement', 'May not scale'],
-                recommendation: 'Suitable for MVP',
-            },
-            {
-                name: 'Option B: Abstraction Layer',
-                tradeoffs: ['More upfront work', 'Better for extension'],
-                recommendation: 'Suitable for long-term',
-            },
-        ];
-    }
-    identifyBoundaries(task) {
-        return [
-            'API contract boundaries',
-            'Data format boundaries',
-            'Capability boundaries',
-        ];
-    }
-    makeRecommendation(task, alternatives) {
-        return alternatives[1]?.recommendation || 'Consider abstraction layer for long-term maintainability';
+        if (!task) {
+            return this.formatOutput({ warning: '未提供任务', usage: '--harness-skill arch "你的架构任务"' });
+        }
+        return this.callLm('You are a senior software architect. Analyze the task and output structured JSON with fields: essence, tensions, alternatives, boundaries, recommendation.', `Architecture task: ${task}`);
     }
 }
 /**
@@ -221,18 +206,9 @@ export class LeadSkill extends BaseSkill {
             gate_pack: this.getGatePack(),
         });
     }
-    classifyChange(params) {
+    async classifyChange(params) {
         const description = params.description || '';
-        // Simplified classification
-        const isPolicy = description.includes('policy') || description.includes('boundary');
-        const isContract = description.includes('API') || description.includes('contract') || description.includes('schema');
-        const isImplementation = !isPolicy && !isContract;
-        return this.formatOutput({
-            classification: isPolicy ? 'policy' : isContract ? 'contract' : 'implementation',
-            description,
-            minimum_gate_path: isPolicy ? '0→8 (full)' : isContract ? '0→8 (full + consumers)' : '0→7 (fast track eligible)',
-            fast_track_eligible: isImplementation,
-        });
+        return this.callLm('You are a change classifier. Given a description, classify the change as policy, contract, or implementation. Output JSON: { classification, description, minimum_gate_path, fast_track_eligible }.', `Classify this change: ${description}`);
     }
 }
 /**
@@ -242,44 +218,12 @@ export class TaskArchSkill extends BaseSkill {
     name = 'task-arch';
     description = 'Task decomposition. Breaks down PLAN into parallelizable work packages (WP).';
     async execute(params) {
-        const plan = params.plan;
+        const plan = (params.plan || params.task || params.description || params.action || '');
         this.log('Decomposing plan into work packages');
-        // Extract work packages
-        const workPackages = this.extractWorkPackages(plan);
-        // Identify seams
-        const seams = this.identifySeams(workPackages);
-        // Identify integration points
-        const integration = this.identifyIntegration(workPackages);
-        return this.formatOutput({
-            work_packages: workPackages,
-            seams,
-            integration,
-            seam_owners: this.assignSeamOwners(seams),
-        });
-    }
-    extractWorkPackages(plan) {
-        // Simplified WP extraction
-        return [
-            { id: 'WP-1', description: 'Core implementation', files: ['src/agents/*.ts'] },
-            { id: 'WP-2', description: 'Network layer', files: ['src/network/*.ts'] },
-            { id: 'WP-3', description: 'Testing', files: ['src/test/*.ts'] },
-        ];
-    }
-    identifySeams(packages) {
-        return [
-            { from: 'WP-1', to: 'WP-2', interface: 'P2PNetwork interface' },
-            { from: 'WP-1', to: 'WP-3', interface: 'Test fixtures' },
-        ];
-    }
-    identifyIntegration(packages) {
-        return ['Integration test at WP-1/WP-2 boundary'];
-    }
-    assignSeamOwners(seams) {
-        const owners = {};
-        for (const seam of seams) {
-            owners[`${seam.from}/${seam.to}`] = 'integration-owner';
+        if (!plan) {
+            return this.formatOutput({ warning: '未提供 plan', usage: '--harness-skill task-arch "你的开发计划"' });
         }
-        return owners;
+        return this.callLm('You are a task decomposition specialist. Given a plan, break it down into work packages (WP) with seams and integration points. Output JSON: { work_packages, seams, integration }.', `Plan: ${plan}`);
     }
 }
 /**
@@ -398,35 +342,12 @@ export class CrystalLearnSkill extends BaseSkill {
     name = 'crystal-learn';
     description = 'Extracts failure patterns and maintains invariants.';
     async execute(params) {
-        const task = params.task;
-        this.log('Extracting failure patterns');
-        // Identify failure modes
-        const failures = this.identifyFailures(task);
-        // Extract patterns
-        const patterns = this.extractPatterns(failures);
-        // Generate invariants
-        const invariants = this.generateInvariants(patterns);
-        return this.formatOutput({
-            failure_modes: failures,
-            patterns,
-            invariants,
-        });
-    }
-    identifyFailures(task) {
-        return [
-            'Truth source split',
-            'Verification decay',
-            'Orphaned seams',
-        ];
-    }
-    extractPatterns(failures) {
-        return failures.map(f => ({
-            pattern: f,
-            prevention: `Implement guard to prevent ${f}`,
-        }));
-    }
-    generateInvariants(patterns) {
-        return patterns.map(p => `INV: ${p.pattern} must not occur`);
+        const task = (params.task || params.description || params.action || '');
+        this.log('Extracting failure patterns from: ' + (task || '(空)'));
+        if (!task) {
+            return this.formatOutput({ warning: '未提供任务', usage: '--harness-skill crystal-learn "你的任务描述"' });
+        }
+        return this.callLm('You are a failure pattern analyst. Extract failure modes, patterns, and invariants from the task description. Output structured JSON with failure_modes, patterns, invariants.', `Task: ${task}`);
     }
 }
 /**
@@ -482,6 +403,10 @@ export class SkillAdapter {
     getSkill(name) {
         return this.registry.get(name);
     }
+    injectLlm(llm) {
+        BaseSkill.setLlm(llm);
+        this.log('LLM 已注入到所有 BaseSkill');
+    }
     listSkills() {
         return this.registry.list();
     }

package/dist/bootstrap/context-hierarchy.js

@@ -43,13 +43,15 @@ export const DEFAULT_MAX_CHARS = {
 // ============================================================
 export function resolveUserPath(home) {
     const h = home ?? process.env.HOME ?? os.homedir() ?? '/tmp';
-    return path.join(h, '.bolloon', 'Bolloon.md');
+    // 用 path.posix.join — 这些是配置/注入路径,跨平台语义稳定, 便于测试断言 + 注入 system prompt
+    // (Windows 文件系统也接受 '/' 分隔符, 所以 fs.readFile 不受影响)
+    return path.posix.join(h, '.bolloon', 'Bolloon.md');
 }
 export function resolveProjectPaths(cwd) {
     return {
-        project: path.join(cwd, 'Bolloon.md'),
-        projectRulesDir: path.join(cwd, '.claude', 'rules'),
-        local: path.join(cwd, 'CLAUDE.local.md'),
+        project: path.posix.join(cwd, 'Bolloon.md'),
+        projectRulesDir: path.posix.join(cwd, '.claude', 'rules'),
+        local: path.posix.join(cwd, 'CLAUDE.local.md'),
     };
 }
 // ============================================================

package/dist/cli/interface.js

@@ -1,4 +1,5 @@
 import * as readline from 'readline';
+import { spawn } from 'child_process';
 import { documentReader } from '../documents/reader.js';
 import { getMinimax } from '../constraints/index.js';
 import { AgentProtocol } from '../agents/protocol.js';
@@ -63,6 +64,7 @@ export class CLIInterface {
         console.log('  send <peer>     - 向指定节点发送消息');
         console.log('  broadcast       - 广播任务到所有节点');
         console.log('  summary <text>  - 总结文本');
+        console.log('  chat <消息正文>  - 跨机聊天 (commits as messages, wrapper)');
         console.log('  help            - 显示帮助');
         console.log('  exit            - 退出\n');
     }
@@ -89,6 +91,9 @@ export class CLIInterface {
                     case 'summary':
                         await this.handleSummary(args.join(' '));
                         break;
+                    case 'chat':
+                        await this.handleChat(args.join(' '));
+                        break;
                     case 'help':
                         this.showHelp();
                         break;
@@ -172,6 +177,29 @@ export class CLIInterface {
         console.log(result.summary);
         console.log(`\n质量评分: ${(result.qualityScore * 10).toFixed(1)}/10`);
     }
+    handleChat(text) {
+        return new Promise((resolve) => {
+            if (!text) {
+                console.log('请提供聊天内容: chat <消息正文>');
+                resolve();
+                return;
+            }
+            // 委派给 bolloon --chat-send, spawn 子进程, 同步输出
+            const child = spawn('npx', ['tsx', 'src/index.ts', '--chat-send', text], {
+                cwd: process.cwd(),
+                stdio: 'inherit',
+            });
+            child.on('close', (code) => {
+                if (code !== 0)
+                    console.error(`chat 子进程退出码 ${code}`);
+                resolve();
+            });
+            child.on('error', (err) => {
+                console.error('chat 子进程启动失败:', err.message);
+                resolve();
+            });
+        });
+    }
     async shutdown() {
         console.log('\n正在关闭...');
         await p2pNetwork.shutdown();

package/dist/documents/reader.js

@@ -16,6 +16,20 @@ export class DocumentReader {
             case '.yaml':
             case '.yml':
             case '.json':
+            // M3.5 (2026-06-17): agent 自读源码需要 — 之前 .ts 不支持, LLM 拿到空内容
+            //   .ts/.tsx/.js/.jsx 都是纯文本, 直接 readFile
+            case '.ts':
+            case '.tsx':
+            case '.js':
+            case '.jsx':
+            case '.mjs':
+            case '.cjs':
+            case '.py':
+            case '.go':
+            case '.rs':
+            case '.java':
+            case '.sh':
+            case '.bash':
                 text = await fs.readFile(filePath, 'utf-8');
                 break;
             case '.pdf':

package/dist/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/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/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/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