fix(perf): 性能模式变更即时生效，活跃采集优雅重启

Author: Aparencia

client/electron/performanceMode.ts

@@ -27,6 +27,16 @@ const CAPTURE_RATE_SCALE: Record<PerformanceMode, number> = {
 
 let currentMode: PerformanceMode = DEFAULT_MODE;
 
+/** 模式变更监听器（供活跃采集循环等消费方热更新，实现即时生效） */
+type ModeChangeListener = (mode: PerformanceMode) => void;
+const modeListeners = new Set<ModeChangeListener>();
+
+/** 订阅模式变更，返回取消订阅函数 */
+export function onPerformanceModeChange(fn: ModeChangeListener): () => void {
+  modeListeners.add(fn);
+  return () => { modeListeners.delete(fn); };
+}
+
 function configPath(): string {
   return join(app.getPath('userData'), 'performance-mode.json');
 }
@@ -54,6 +64,10 @@ export function setPerformanceMode(mode: unknown): void {
     logger.error('[PerformanceMode] 持久化失败:', err);
   }
   logger.info(`[PerformanceMode] 模式已设置: ${mode}`);
+  // 通知消费方（活跃采集循环按新频率重启，使采集策略即时生效而非等下次启动）
+  modeListeners.forEach((fn) => {
+    try { fn(mode); } catch (err) { logger.error('[PerformanceMode] 监听回调异常:', err); }
+  });
 }
 
 /** 当前模式 */

client/electron/recordingStorage.ts

@@ -12,8 +12,8 @@
 import { app } from 'electron';
 import * as path from 'path';
 import { mkdir, writeFile, readFile, rm } from 'fs/promises';
-import { safeHandle } from '../ipcUtils.js';
-import { logger } from '../logger.js';
+import { safeHandle } from './ipcUtils.js';
+import { logger } from './logger.js';
 
 /** 安全文件名：字母数字/下划线/连字符，1-80 字符（防路径穿越） */
 const SAFE_NAME_RE = /^[A-Za-z0-9_-]{1,80}$/;

client/electron/screenCaptureHandlers.ts

@@ -14,7 +14,7 @@ import type { ScreenCaptureOptions, ScreenshotFrameData } from './screenCapture.
 import { safeHandle, getMainWindowId } from './ipcUtils.js';
 import { logger } from './logger.js';
 import { scoreAndFilterWindows } from './windowScorer.js';
-import { getCaptureRateScale } from './performanceMode.js';
+import { getCaptureRateScale, onPerformanceModeChange } from './performanceMode.js';
 
 // ================================================================
 // 模块级状态
@@ -23,6 +23,15 @@ import { getCaptureRateScale } from './performanceMode.js';
 /** 当前活跃的截图采集实例 */
 let activeCapture: ScreenCapture | null = null;
 
+/** 活跃采集的原始参数（未缩放 interval），供性能模式变更后按新频率重建实例 */
+let activeOptions: ScreenCaptureOptions | null = null;
+
+/** 活跃采集的帧推送目标窗口（重启实例后保持推送不中断） */
+let activeSenderWin: BrowserWindow | null = null;
+
+/** 性能模式变更订阅的取消函数 */
+let unsubscribeModeChange: (() => void) | null = null;
+
 /** screen_capture_start 防抖：500ms 内多次调用只响应最后一次 */
 let startDebounceTimer: ReturnType<typeof setTimeout> | null = null;
 const START_DEBOUNCE_MS = 500;
@@ -45,10 +54,43 @@ let lastWindowIds: Set<string> = new Set();
 
 const WINDOW_WATCH_INTERVAL_MS = 3000;
 
+/** 按性能模式缩放采集间隔（静谧档 scale=0.5 → 间隔翻倍、频率减半，降低开销） */
+function applyRateScale(options: ScreenCaptureOptions): ScreenCaptureOptions {
+  const scaled = { ...options };
+  const rateScale = getCaptureRateScale();
+  if (typeof scaled.interval === 'number' && rateScale !== 1) {
+    scaled.interval = Math.min(60000, Math.round(scaled.interval / rateScale));
+  }
+  return scaled;
+}
+
+/** 销毁旧实例并按其参数/推送目标重建采集（start 与性能模式重启共用） */
+function startCaptureWith(senderWin: BrowserWindow | null, options: ScreenCaptureOptions): void {
+  if (activeCapture) {
+    activeCapture.dispose();
+    activeCapture = null;
+  }
+  activeCapture = new ScreenCapture(applyRateScale(options), (frame: ScreenshotFrameData) => {
+    if (senderWin && !senderWin.isDestroyed()) {
+      senderWin.webContents.send('screen_capture_frame', frame);
+    }
+  });
+  activeCapture.start();
+}
+
 /**
  * 注册屏幕截图与窗口监听相关的 IPC handler
  */
 export function registerScreenCaptureHandlers(): void {
+  // 性能模式变更 → 活跃采集按新频率优雅重启（即时生效，替代"等下次启动"）
+  unsubscribeModeChange = onPerformanceModeChange(() => {
+    if (!activeCapture || !activeOptions) return;
+    const senderWin = activeSenderWin;
+    const options = activeOptions;
+    logger.info('[IPC] 性能模式变更，采集按新频率重启');
+    startCaptureWith(senderWin, options);
+  });
+
   safeHandle(
     'screen_capture_start',
     async (event, options: ScreenCaptureOptions) => {
@@ -93,19 +135,11 @@ export function registerScreenCaptureHandlers(): void {
             safeOptions.interval = 5000;
           }
 
-          // 按性能模式缩放采集间隔（静谧档 scale=0.5 → 间隔翻倍、频率减半，降低开销）
-          const rateScale = getCaptureRateScale();
-          if (typeof safeOptions.interval === 'number' && rateScale !== 1) {
-            safeOptions.interval = Math.min(60000, Math.round(safeOptions.interval / rateScale));
-          }
+          // 记录原始参数与推送目标（供性能模式变更时重启采集）
+          activeOptions = safeOptions;
+          activeSenderWin = senderWin;
 
-          activeCapture = new ScreenCapture(safeOptions, (frame: ScreenshotFrameData) => {
-            if (senderWin && !senderWin.isDestroyed()) {
-              senderWin.webContents.send('screen_capture_frame', frame);
-            }
-          });
-
-          activeCapture.start();
+          startCaptureWith(senderWin, safeOptions);
           logger.info('[IPC] screen_capture_start 已启动（防抖后）');
           resolve({ success: true });
         }, START_DEBOUNCE_MS);
@@ -136,6 +170,8 @@ export function registerScreenCaptureHandlers(): void {
       activeCapture = null;
       logger.info('[IPC] screen_capture_stop 已停止');
     }
+    activeOptions = null;
+    activeSenderWin = null;
     return { success: true };
   });
 
@@ -226,6 +262,11 @@ export function registerScreenCaptureHandlers(): void {
  * 释放屏幕截图相关资源（含防抖定时器与轮询）
  */
 export function disposeScreenCaptureHandlers(): void {
+  // 注销性能模式变更订阅
+  if (unsubscribeModeChange) {
+    unsubscribeModeChange();
+    unsubscribeModeChange = null;
+  }
   // 清理防抖定时器
   if (startDebounceTimer) {
     clearTimeout(startDebounceTimer);
@@ -245,4 +286,6 @@ export function disposeScreenCaptureHandlers(): void {
     activeCapture.dispose();
     activeCapture = null;
   }
+  activeOptions = null;
+  activeSenderWin = null;
 }

client/src/pages/settings/PerformanceSettings.tsx

@@ -6,6 +6,8 @@
  * 显示名 静谧/从容/澎湃，默认从容（medium）。
  *
  * @ai-context: 设置页组件：PerformanceSettings。
+ * 生效时机：3D 画质/动画即时生效；后台采集频率在变更瞬间优雅重启活跃
+ * 采集循环即时生效（主进程 onPerformanceModeChange 订阅），不再等下次启动。
  */
 import { motion } from 'framer-motion';
 import { Card } from '@/components/ui';
@@ -136,7 +138,7 @@ export default function PerformanceSettings() {
       </div>
 
       <p className="text-c1 text-text-tertiary">
-        3D 画质与动画即时生效；后台采集频率与进程策略在下次启动后完全生效。
+        3D 画质与动画即时生效；后台采集频率在变更后立即生效（当前采集循环将按新频率重启）。
       </p>
     </Card>
   );