@electron-memory/monitor 0.2.3 → 0.2.5

package/dist/index.mjs

@@ -261,13 +261,13 @@ var DataPersister = class {
       return null;
     }
   }
-  /** 获取所有会话列表 */
+  /** 获取所有会话列表（按 startTime 降序，最新在前；与索引写入顺序无关） */
   getSessions() {
     const indexFile = path.join(this.storageDir, "sessions.json");
     try {
       const content = fs.readFileSync(indexFile, "utf-8");
       const index = JSON.parse(content);
-      return index.sessions;
+      return this.sortSessionsByStartDesc(index.sessions);
     } catch {
       return [];
     }
@@ -370,11 +370,19 @@ var DataPersister = class {
   saveSessionIndex(sessions) {
     const indexFile = path.join(this.storageDir, "sessions.json");
     const index = {
-      sessions,
+      sessions: this.sortSessionsByStartDesc(sessions),
       lastUpdated: Date.now()
     };
     fs.writeFileSync(indexFile, JSON.stringify(index, null, 2), "utf-8");
   }
+  /** 统一排序：startTime 新 → 旧（同毫秒时按 id 稳定排序） */
+  sortSessionsByStartDesc(sessions) {
+    return [...sessions].sort((a, b) => {
+      const t = b.startTime - a.startTime;
+      if (t !== 0) return t;
+      return String(b.id).localeCompare(String(a.id));
+    });
+  }
   ensureDirectory(dir) {
     if (!fs.existsSync(dir)) {
       fs.mkdirSync(dir, { recursive: true });
@@ -437,10 +445,14 @@ var SessionManager = class {
   getCurrentSession() {
     return this.currentSession;
   }
-  /** 开始新会话 */
+  /** 开始新会话；若顶替了上一条进行中的会话，通过 `replaced` 返回以便主进程补写 report.json */
   startSession(label, description) {
+    if (!this.currentSession) {
+      this.reconcileStaleRunningInIndex();
+    }
+    let replaced = null;
     if (this.currentSession && this.currentSession.status === "running") {
-      this.endSession();
+      replaced = this.endSession();
     }
     const sessionId = v4();
     const { dataFile, metaFile } = this.persister.createSessionFiles(sessionId);
@@ -456,7 +468,7 @@ var SessionManager = class {
     };
     this.currentSession = session;
     this.persister.saveSessionMeta(session);
-    return session;
+    return { session, replaced };
   }
   /** 结束当前会话 */
   endSession() {
@@ -484,6 +496,24 @@ var SessionManager = class {
   getSession(sessionId) {
     return this.persister.readSessionMeta(sessionId);
   }
+  /**
+   * 当前内存无活动会话时，将索引中仍为 running 的条目标为 aborted（进程异常退出后残留）
+   */
+  reconcileStaleRunningInIndex() {
+    if (this.currentSession) return;
+    const sessions = this.persister.getSessions();
+    const now = Date.now();
+    for (const s of sessions) {
+      if (s.status !== "running") continue;
+      const fixed = {
+        ...s,
+        status: "aborted",
+        endTime: now,
+        duration: now - s.startTime
+      };
+      this.persister.saveSessionMeta(fixed);
+    }
+  }
 };
 
 // src/core/anomaly.ts
@@ -654,10 +684,38 @@ import * as os2 from "os";
 var Analyzer = class {
   /** 生成会话报告 */
   generateReport(sessionId, label, description, startTime, endTime, snapshots, anomalies, dataFile) {
+    const environment = this.collectEnvironment();
+    const eventMarks = this.collectEventMarks(snapshots);
     if (snapshots.length === 0) {
-      throw new Error("No snapshots to analyze");
+      const summary2 = this.emptySummary();
+      const suggestions2 = [
+        {
+          id: "no-snapshots",
+          severity: "info",
+          category: "optimization",
+          title: "\u4F1A\u8BDD\u5185\u6CA1\u6709\u53EF\u7528\u7684\u5185\u5B58\u5FEB\u7167",
+          description: "\u7ED3\u675F\u4F1A\u8BDD\u65F6\u78C1\u76D8\u4E0A\u5C1A\u672A\u5199\u5165\u4EFB\u4F55\u91C7\u6837\u70B9\uFF08\u4F8B\u5982\u521A\u542F\u52A8\u5C31\u7ACB\u523B\u7ED3\u675F\uFF0C\u6216\u91C7\u96C6\u95F4\u9694\u5C1A\u672A\u89E6\u53D1\uFF09\u3002\u62A5\u544A\u4E2D\u7684\u7EDF\u8BA1\u4E0E\u8D8B\u52BF\u65E0\u6CD5\u8BA1\u7B97\u3002",
+          suggestions: [
+            "\u4FDD\u6301\u4F1A\u8BDD\u5F00\u542F\u81F3\u5C11\u4E00\u4E2A\u91C7\u96C6\u5468\u671F\u540E\u518D\u70B9\u300C\u7ED3\u675F\u4F1A\u8BDD\u300D",
+            "\u5728\u914D\u7F6E\u4E2D\u9002\u5F53\u7F29\u77ED\u91C7\u96C6\u95F4\u9694\u4EE5\u4FBF\u66F4\u5FEB\u5F97\u5230\u6570\u636E"
+          ]
+        }
+      ];
+      return {
+        sessionId,
+        label,
+        description,
+        startTime,
+        endTime,
+        duration: endTime - startTime,
+        environment,
+        summary: summary2,
+        anomalies,
+        suggestions: suggestions2,
+        eventMarks,
+        dataFile
+      };
     }
-    const environment = this.collectEnvironment();
     const summary = this.computeSummary(snapshots);
     const suggestions = this.generateSuggestions(snapshots, summary, anomalies);
     return {
@@ -671,6 +729,7 @@ var Analyzer = class {
       summary,
       anomalies,
       suggestions,
+      eventMarks,
       dataFile
     };
   }
@@ -707,6 +766,53 @@ var Analyzer = class {
     };
   }
   // ===== 私有方法 =====
+  emptySummary() {
+    const z = this.computeMetricSummary([]);
+    const stable = { slope: 0, r2: 0, direction: "stable", confidence: "low" };
+    return {
+      totalProcesses: { min: 0, max: 0, avg: 0 },
+      totalMemory: z,
+      byProcessType: {
+        browser: z,
+        renderer: [],
+        gpu: null,
+        utility: null
+      },
+      mainV8Heap: {
+        heapUsed: z,
+        heapTotal: z,
+        external: z,
+        arrayBuffers: z
+      },
+      trends: {
+        totalMemory: stable,
+        browserMemory: stable,
+        rendererMemory: stable
+      }
+    };
+  }
+  /** 从快照展平所有标记，并附上该采样点的分类内存（KB） */
+  collectEventMarks(snapshots) {
+    const out = [];
+    for (const s of snapshots) {
+      if (!s.marks?.length) continue;
+      const browserKB = s.processes.filter((p) => p.type === "Browser").reduce((sum, p) => sum + p.memory.workingSetSize, 0);
+      const rendererKB = s.processes.filter((p) => p.type === "Tab" && !p.isMonitorProcess).reduce((sum, p) => sum + p.memory.workingSetSize, 0);
+      const gpuKB = s.processes.filter((p) => p.type === "GPU").reduce((sum, p) => sum + p.memory.workingSetSize, 0);
+      for (const m of s.marks) {
+        out.push({
+          timestamp: m.timestamp,
+          label: m.label,
+          metadata: m.metadata,
+          totalWorkingSetKB: s.totalWorkingSetSize,
+          browserKB,
+          rendererKB,
+          gpuKB
+        });
+      }
+    }
+    return out;
+  }
   collectEnvironment() {
     const cpus2 = os2.cpus();
     return {
@@ -1396,10 +1502,28 @@ var IPCMainHandler = class {
       return this.monitor.startSession(args.label, args.description);
     });
     ipcMain.handle(IPC_CHANNELS.SESSION_STOP, async () => {
-      return this.monitor.stopSession();
+      try {
+        const report = await this.monitor.stopSession();
+        if (!report) {
+          return { ok: false, reason: "no_active_session" };
+        }
+        return {
+          ok: true,
+          sessionId: report.sessionId,
+          label: report.label,
+          durationMs: report.duration
+        };
+      } catch (err) {
+        console.error("[electron-memory-monitor] SESSION_STOP failed:", err);
+        return {
+          ok: false,
+          reason: "error",
+          message: err instanceof Error ? err.message : String(err)
+        };
+      }
     });
     ipcMain.handle(IPC_CHANNELS.SESSION_LIST, async () => {
-      return this.monitor.getSessions();
+      return this.monitor.getSessionsPayloadForIpc();
     });
     ipcMain.handle(IPC_CHANNELS.SESSION_REPORT, async (_event, sessionId) => {
       return this.monitor.getSessionReport(sessionId);
@@ -1423,7 +1547,7 @@ var IPCMainHandler = class {
       return this.monitor.getConfig();
     });
     ipcMain.handle(IPC_CHANNELS.GET_SESSIONS, async () => {
-      return this.monitor.getSessions();
+      return this.monitor.getSessionsPayloadForIpc();
     });
     ipcMain.handle(IPC_CHANNELS.SESSION_EXPORT, async (_event, sessionId) => {
       return this.monitor.exportSession(sessionId);
@@ -1434,8 +1558,11 @@ var IPCMainHandler = class {
     ipcMain.handle(IPC_CHANNELS.SESSION_DELETE, async (_event, sessionId) => {
       return this.monitor.deleteSession(sessionId);
     });
-    ipcMain.on(IPC_CHANNELS.RENDERER_REPORT, (_event, detail) => {
-      this.monitor.updateRendererDetail(detail);
+    ipcMain.on(IPC_CHANNELS.RENDERER_REPORT, (event, detail) => {
+      this.monitor.updateRendererDetail({
+        ...detail,
+        webContentsId: event.sender.id
+      });
     });
   }
   /** 向监控面板推送快照数据 */
@@ -1465,6 +1592,10 @@ var DEFAULT_CONFIG = {
   enabled: true,
   autoStart: true,
   openDashboardOnStart: true,
+  session: {
+    autoStartOnLaunch: true,
+    autoLabelPrefix: "\u81EA\u52A8\u4F1A\u8BDD"
+  },
   collectInterval: 2e3,
   persistInterval: 60,
   enableRendererDetail: false,
@@ -1490,6 +1621,36 @@ var DEFAULT_CONFIG = {
 };
 
 // src/core/monitor.ts
+function mergeMarksFromExcludedSnapshots(full, sampled) {
+  const marked = full.filter((s) => s.marks && s.marks.length > 0);
+  if (marked.length === 0) return sampled;
+  const sampledRefs = new Set(sampled);
+  const result = sampled.map((s) => ({
+    ...s,
+    marks: s.marks?.length ? [...s.marks] : void 0
+  }));
+  for (const src of marked) {
+    if (sampledRefs.has(src)) continue;
+    let bestIdx = 0;
+    let bestDiff = Infinity;
+    for (let i = 0; i < result.length; i++) {
+      const d = Math.abs(result[i].timestamp - src.timestamp);
+      if (d < bestDiff) {
+        bestDiff = d;
+        bestIdx = i;
+      }
+    }
+    const target = result[bestIdx];
+    target.marks = [...target.marks || [], ...src.marks];
+  }
+  return result;
+}
+function formatAutoSessionLabel(prefix) {
+  const d = /* @__PURE__ */ new Date();
+  const p2 = (n) => String(n).padStart(2, "0");
+  const stamp = `${d.getFullYear()}-${p2(d.getMonth() + 1)}-${p2(d.getDate())} ${p2(d.getHours())}:${p2(d.getMinutes())}:${p2(d.getSeconds())}`;
+  return `${prefix || "\u81EA\u52A8\u4F1A\u8BDD"} ${stamp}`;
+}
 var ElectronMemoryMonitor = class extends EventEmitter3 {
   constructor(config) {
     super();
@@ -1533,11 +1694,20 @@ var ElectronMemoryMonitor = class extends EventEmitter3 {
     });
     this.collector.start();
     this.anomalyDetector.start();
+    this.persister.cleanOldSessions();
+    this.sessionManager.reconcileStaleRunningInIndex();
+    this.started = true;
+    if (this.config.session.autoStartOnLaunch) {
+      try {
+        const label = formatAutoSessionLabel(this.config.session.autoLabelPrefix);
+        this.startSession(label, this.config.session.autoDescription);
+      } catch (err) {
+        console.error("[@electron-memory/monitor] autoStartOnLaunch failed:", err);
+      }
+    }
     if (this.config.openDashboardOnStart) {
       this.openDashboard();
     }
-    this.persister.cleanOldSessions();
-    this.started = true;
   }
   /** 停止监控 */
   async stop() {
@@ -1566,9 +1736,16 @@ var ElectronMemoryMonitor = class extends EventEmitter3 {
     if (!this.started) {
       throw new Error("Monitor is not started");
     }
-    const session = this.sessionManager.startSession(label, description);
+    const anomaliesForReplaced = this.anomalyDetector.getAnomalies();
+    const { session, replaced } = this.sessionManager.startSession(label, description);
+    if (replaced) {
+      void this.persistCompletedSessionReport(replaced, anomaliesForReplaced).catch((err) => {
+        console.error("[@electron-memory/monitor] \u88AB\u9876\u66FF\u4F1A\u8BDD\u7684\u62A5\u544A\u5199\u5165\u5931\u8D25:", err);
+      });
+    }
     this.collector.setSessionId(session.id);
     this.anomalyDetector.clearAnomalies();
+    this.emit("session-start", session);
     return session.id;
   }
   /** 结束当前会话 */
@@ -1579,8 +1756,26 @@ var ElectronMemoryMonitor = class extends EventEmitter3 {
     const completedSession = this.sessionManager.endSession();
     if (!completedSession) return null;
     this.collector.setSessionId(null);
-    const snapshots = this.persister.readSessionSnapshots(completedSession.id);
     const anomalies = this.anomalyDetector.getAnomalies();
+    const report = await this.persistCompletedSessionReport(completedSession, anomalies);
+    return report;
+  }
+  /** 为已落盘元数据的会话生成并写入 report.json（显式结束或被新会话顶替） */
+  async persistCompletedSessionReport(completedSession, anomalies) {
+    const fs2 = await import("fs/promises");
+    const snapshotsPath = path4.join(
+      this.persister.getStorageDir(),
+      completedSession.id,
+      "snapshots.jsonl"
+    );
+    let snapshots = [];
+    try {
+      const content = await fs2.readFile(snapshotsPath, "utf-8");
+      const lines = content.trim().split("\n").filter(Boolean);
+      snapshots = lines.map((line) => JSON.parse(line));
+    } catch {
+      snapshots = this.persister.readSessionSnapshots(completedSession.id);
+    }
     const report = this.analyzer.generateReport(
       completedSession.id,
       completedSession.label,
@@ -1592,8 +1787,7 @@ var ElectronMemoryMonitor = class extends EventEmitter3 {
       completedSession.dataFile
     );
     const reportPath = path4.join(this.persister.getStorageDir(), completedSession.id, "report.json");
-    const fs2 = await import("fs");
-    fs2.writeFileSync(reportPath, JSON.stringify(report, null, 2), "utf-8");
+    await fs2.writeFile(reportPath, JSON.stringify(report, null, 2), "utf-8");
     this.emit("session-end", report);
     return report;
   }
@@ -1618,6 +1812,18 @@ var ElectronMemoryMonitor = class extends EventEmitter3 {
   async getSessions() {
     return this.sessionManager.getSessions();
   }
+  /**
+   * 供监控面板 IPC：列表来自磁盘索引，是否在录制以内存中的 currentSession 为准（避免索引僵尸 running）
+   */
+  getSessionsPayloadForIpc() {
+    if (!this.started) {
+      return { sessions: [], activeSessionId: null };
+    }
+    return {
+      sessions: this.sessionManager.getSessions(),
+      activeSessionId: this.sessionManager.getCurrentSession()?.id ?? null
+    };
+  }
   /** 获取指定会话报告 */
   async getSessionReport(sessionId) {
     const fs2 = await import("fs");
@@ -1629,7 +1835,6 @@ var ElectronMemoryMonitor = class extends EventEmitter3 {
       const session = this.sessionManager.getSession(sessionId);
       if (!session || !session.endTime) return null;
       const snapshots = this.persister.readSessionSnapshots(sessionId);
-      if (snapshots.length === 0) return null;
       return this.analyzer.generateReport(
         session.id,
         session.label,
@@ -1651,17 +1856,18 @@ var ElectronMemoryMonitor = class extends EventEmitter3 {
     if (endTime != null) {
       snapshots = snapshots.filter((s) => s.timestamp <= endTime);
     }
+    const beforeDownsample = snapshots;
     const limit = maxPoints ?? 600;
-    if (snapshots.length > limit) {
-      const step = snapshots.length / limit;
+    if (beforeDownsample.length > limit) {
+      const step = beforeDownsample.length / limit;
       const sampled = [];
       for (let i = 0; i < limit; i++) {
-        sampled.push(snapshots[Math.round(i * step)]);
+        sampled.push(beforeDownsample[Math.round(i * step)]);
       }
-      if (sampled[sampled.length - 1] !== snapshots[snapshots.length - 1]) {
-        sampled[sampled.length - 1] = snapshots[snapshots.length - 1];
+      if (sampled[sampled.length - 1] !== beforeDownsample[beforeDownsample.length - 1]) {
+        sampled[sampled.length - 1] = beforeDownsample[beforeDownsample.length - 1];
       }
-      snapshots = sampled;
+      snapshots = mergeMarksFromExcludedSnapshots(beforeDownsample, sampled);
     }
     return snapshots;
   }
@@ -1812,6 +2018,10 @@ var ElectronMemoryMonitor = class extends EventEmitter3 {
     return {
       ...DEFAULT_CONFIG,
       ...userConfig,
+      session: {
+        ...DEFAULT_CONFIG.session,
+        ...userConfig.session || {}
+      },
       anomaly: {
         ...DEFAULT_CONFIG.anomaly,
         ...userConfig.anomaly || {}