perf: 减少索引器内存占用与持久化存储体积

1. 索引器优化(indexer.ts)：
   - 引入 `stripDetailsForPersist` 方法，在持久化 `history.details` 时剔除高占用的 `messages` 字段，仅保留摘要信息，显著降低内存驻留与磁盘I/O开销。
   - 优化 `DETAILS_CACHE_LIMIT` 缓存策略。

2. 资源清理(indexer.ts)：
   - 增强 `stopHistoryIndexer` 清理逻辑，显式清除所有 pending 状态的重试定时器 (`clearTimeout`)。
   - 退出时清空 `rescanCooldown` 映射，确保无残留对象引用。

3. 前端性能(App.tsx)：
   - 优化 `buildFilteredText` 依赖项 (添加 `selectedSessionFingerprint` 等)，减少无效计算与重渲染。
   - 调整 Effect 依赖，确保视图更新更精准。

4. 国际化与文案：
   - 更新中英文 Locale (`history.json`, `terminal.json`)，新增终端启动失败、复制行等文案。

Author: lulu-sk

electron/history.ts

@@ -13,7 +13,7 @@ import opentype from 'opentype.js';
 import iconv from 'iconv-lite';
 import projects, { IMPLEMENTATION_NAME as PROJECTS_IMPL } from "./projects/index";
 import history, { purgeHistoryCacheIfOutdated } from "./history";
-import { startHistoryIndexer, getIndexedSummaries, getIndexedDetails, getLastIndexerRoots, stopHistoryIndexer } from "./indexer";
+import { startHistoryIndexer, getIndexedSummaries, getIndexedDetails, getLastIndexerRoots, stopHistoryIndexer, cacheDetails, getCachedDetails } from "./indexer";
 import { getSessionsRootsFastAsync } from "./wsl";
 import { perfLogger } from "./log";
 import settings, { ensureSettingsAutodetect, ensureFirstRunTerminalSelection, type ThemeSetting as SettingsThemeSetting, type AppSettings } from "./settings";
@@ -1042,11 +1042,20 @@ ipcMain.handle('history.list', async (_e, args: { projectWslPath?: string; proje
 });
 
 ipcMain.handle('history.read', async (_e, { filePath }: { filePath: string }) => {
+  try {
+    const cached = getCachedDetails(filePath);
+    if (cached) return cached;
+  } catch {}
   try {
     const det = getIndexedDetails(filePath);
-    if (det) return det;
+    if (det) {
+      try { cacheDetails(filePath, det); } catch {}
+      return det;
+    }
   } catch {}
-  return history.readHistoryFile(filePath);
+  const parsed = await history.readHistoryFile(filePath);
+  try { cacheDetails(filePath, parsed as any); } catch {}
+  return parsed;
 });
 
 // 扫描所有索引的会话，找出"筛选后 input_text/output_text 皆为空"的文件
@@ -1063,6 +1072,7 @@ ipcMain.handle('history.findEmptySessions', async () => {
         let date = Number((s as any).date || 0);
         let id = String((s as any).id || '');
         if (det && det.messages) {
+          try { cacheDetails(s.filePath, det); } catch {}
           messages = det.messages as any[];
           if (!title && (det as any).title) title = String((det as any).title);
           if (!rawDate && (det as any).rawDate) rawDate = String((det as any).rawDate);
@@ -1072,6 +1082,7 @@ ipcMain.handle('history.findEmptySessions', async () => {
           // 兜底读取（性能较差，仅在详情缓存缺失时触发）
           try {
             const r = await history.readHistoryFile(s.filePath);
+            try { cacheDetails(s.filePath, r as any); } catch {}
             messages = r.messages as any[];
             if (!title && (r as any).title) title = String((r as any).title);
             if (!date && (r as any).date) date = Number((r as any).date);

electron/indexer.ts

@@ -2264,24 +2264,30 @@ export default function CodexFlowManagerUI() {
       logs: [],
       createdAt: Date.now(),
     };
-    registerTabProject(tab.id, project.id);
-    setTabsByProject((m) => ({ ...m, [project.id]: [...(m[project.id] || []), tab] }));
-    setActiveTab(tab.id, { focusMode: 'immediate', allowDuringRename: true, delay: 0 });
+    let ptyId: string | undefined;
     try {
       const startupCmd = injectTraceEnv(codexCmd);
       const { id } = await window.host.pty.openWSLConsole({ distro: wslDistro, wslPath: project.wslPath, winPath: project.winPath, cols: 80, rows: 24, startupCmd });
-      ptyByTabRef.current[tab.id] = id;
-      setPtyByTab((m) => ({ ...m, [tab.id]: id }));
-      ptyAliveRef.current[tab.id] = true;
-      setPtyAlive((m) => ({ ...m, [tab.id]: true }));
-      registerPtyForTab(tab.id, id);
-      try { tm.setPty(tab.id, id); } catch (err) { console.warn('tm.setPty failed', err); }
-      try { window.host.projects.touch(project.id); } catch {}
-      // 打开控制台后，立即在内存中更新最近使用时间，保证"最近使用优先"实时生效
-      markProjectUsed(project.id);
+      ptyId = id;
     } catch (e) {
       console.error('Failed to open PTY for project', e);
+      alert(String(t('terminal:openFailed', { error: String((e as any)?.message || e) })));
+      return;
+    }
+    registerTabProject(tab.id, project.id);
+    setTabsByProject((m) => ({ ...m, [project.id]: [...(m[project.id] || []), tab] }));
+    setActiveTab(tab.id, { focusMode: 'immediate', allowDuringRename: true, delay: 0 });
+    if (ptyId) {
+      ptyByTabRef.current[tab.id] = ptyId;
+      setPtyByTab((m) => ({ ...m, [tab.id]: ptyId }));
+      ptyAliveRef.current[tab.id] = true;
+      setPtyAlive((m) => ({ ...m, [tab.id]: true }));
+      registerPtyForTab(tab.id, ptyId);
+      try { tm.setPty(tab.id, ptyId); } catch (err) { console.warn('tm.setPty failed', err); }
     }
+    try { window.host.projects.touch(project.id); } catch {}
+    // 打开控制台后，立即在内存中更新最近使用时间，保证"最近使用优先"实时生效
+    markProjectUsed(project.id);
     // 确保视图停留在控制台
     try { setCenterMode('console'); } catch {}
   }
@@ -2335,10 +2341,7 @@ export default function CodexFlowManagerUI() {
       logs: [],
       createdAt: Date.now(),
     };
-    registerTabProject(tab.id, selectedProject.id);
-    setTabsByProject((m) => ({ ...m, [selectedProject.id]: [...(m[selectedProject.id] || []), tab] }));
-    setActiveTab(tab.id, { focusMode: 'immediate', allowDuringRename: true, delay: 0 });
-
+    let ptyId: string | undefined;
     // Open PTY in main (WSL)
     try {
       try { await (window as any).host?.utils?.perfLog?.(`[ui] openNewConsole start project=${selectedProject?.name}`); } catch {}
@@ -2352,21 +2355,30 @@ export default function CodexFlowManagerUI() {
         startupCmd,
       });
       try { await (window as any).host?.utils?.perfLog?.(`[ui] openNewConsole pty=${id}`); } catch {}
-      ptyByTabRef.current[tab.id] = id;
-      setPtyByTab((m) => ({ ...m, [tab.id]: id }));
-      ptyAliveRef.current[tab.id] = true;
-      setPtyAlive((m) => ({ ...m, [tab.id]: true }));
-      registerPtyForTab(tab.id, id);
-      // inform manager about PTY so it can wire bridges
-      try { tm.setPty(tab.id, id); } catch (err) { console.warn('tm.setPty failed', err); }
-      // touch project lastOpenedAt
-      try { window.host.projects.touch(selectedProject.id); } catch {}
-      // 同步更新内存，触发排序刷新；并抑制历史面板自动切换
-      markProjectUsed(selectedProject.id);
+      ptyId = id;
     } catch (e) {
       console.error('Failed to open PTY', e);
       try { await (window as any).host?.utils?.perfLog?.(`[ui] openNewConsole error ${String((e as any)?.stack || e)}`); } catch {}
+      alert(String(t('terminal:openFailed', { error: String((e as any)?.message || e) })));
+      return;
+    }
+
+    registerTabProject(tab.id, selectedProject.id);
+    setTabsByProject((m) => ({ ...m, [selectedProject.id]: [...(m[selectedProject.id] || []), tab] }));
+    setActiveTab(tab.id, { focusMode: 'immediate', allowDuringRename: true, delay: 0 });
+    if (ptyId) {
+      ptyByTabRef.current[tab.id] = ptyId;
+      setPtyByTab((m) => ({ ...m, [tab.id]: ptyId }));
+      ptyAliveRef.current[tab.id] = true;
+      setPtyAlive((m) => ({ ...m, [tab.id]: true }));
+      registerPtyForTab(tab.id, ptyId);
+      // inform manager about PTY so it can wire bridges
+      try { tm.setPty(tab.id, ptyId); } catch (err) { console.warn('tm.setPty failed', err); }
     }
+    // touch project lastOpenedAt
+    try { window.host.projects.touch(selectedProject.id); } catch {}
+    // 同步更新内存，触发排序刷新；并抑制历史面板自动切换
+    markProjectUsed(selectedProject.id);
   }
 
   // 当项目变更时，加载历史（项目范围）
@@ -3332,38 +3344,48 @@ export default function CodexFlowManagerUI() {
           logs: [],
           createdAt: Date.now(),
         };
-        registerTabProject(tab.id, selectedProject.id);
-        setTabsByProject((m) => ({ ...m, [selectedProject.id]: [...(m[selectedProject.id] || []), tab] }));
-        setActiveTab(tab.id, { focusMode: 'immediate', allowDuringRename: true, delay: 0 });
-        try {
-          setCenterMode('console');
-          requestAnimationFrame(() => {
-            try { scheduleFocusForTab(tab.id, { immediate: true, allowDuringRename: true }); } catch {}
-          });
-        } catch {}
+        let ptyId: string | undefined;
         try {
           await (window as any).host?.utils?.perfLog?.(`[ui] history.resume openWSLConsole start tab=${tab.id}`);
         } catch {}
-        const { id } = await window.host.pty.openWSLConsole({
+        try {
+          const { id } = await window.host.pty.openWSLConsole({
           distro: wslDistro,
           wslPath: selectedProject.wslPath,
           winPath: selectedProject.winPath,
           cols: 80,
           rows: 24,
           startupCmd,
         });
+          try {
+            await (window as any).host?.utils?.perfLog?.(`[ui] history.resume pty=${id} tab=${tab.id} - registering listener`);
+          } catch {}
+          ptyId = id;
+        } catch (err) {
+          console.warn('executeResume failed', err);
+          alert(String(t('history:resumeFailed', { error: String((err as any)?.message || err) })));
+          return false;
+        }
+        registerTabProject(tab.id, selectedProject.id);
+        setTabsByProject((m) => ({ ...m, [selectedProject.id]: [...(m[selectedProject.id] || []), tab] }));
+        setActiveTab(tab.id, { focusMode: 'immediate', allowDuringRename: true, delay: 0 });
         try {
-          await (window as any).host?.utils?.perfLog?.(`[ui] history.resume pty=${id} tab=${tab.id} - registering listener`);
-        } catch {}
-        ptyByTabRef.current[tab.id] = id;
-        setPtyByTab((m) => ({ ...m, [tab.id]: id }));
-        ptyAliveRef.current[tab.id] = true;
-        setPtyAlive((m) => ({ ...m, [tab.id]: true }));
-        registerPtyForTab(tab.id, id);
-        try {
-          await (window as any).host?.utils?.perfLog?.(`[ui] history.resume pty=${id} tab=${tab.id} - listener registered`);
+          setCenterMode('console');
+          requestAnimationFrame(() => {
+            try { scheduleFocusForTab(tab.id, { immediate: true, allowDuringRename: true }); } catch {}
+          });
         } catch {}
-        try { tm.setPty(tab.id, id); } catch (err) { console.warn('tm.setPty failed', err); }
+        if (ptyId) {
+          ptyByTabRef.current[tab.id] = ptyId;
+          setPtyByTab((m) => ({ ...m, [tab.id]: ptyId }));
+          ptyAliveRef.current[tab.id] = true;
+          setPtyAlive((m) => ({ ...m, [tab.id]: true }));
+          registerPtyForTab(tab.id, ptyId);
+          try {
+            await (window as any).host?.utils?.perfLog?.(`[ui] history.resume pty=${ptyId} tab=${tab.id} - listener registered`);
+          } catch {}
+          try { tm.setPty(tab.id, ptyId); } catch (err) { console.warn('tm.setPty failed', err); }
+        }
         try { window.host.projects.touch(selectedProject.id); } catch {}
         // 内存也更新最近使用时间，并抑制历史面板自动切换
         markProjectUsed(selectedProject.id);
@@ -3382,6 +3404,7 @@ export default function CodexFlowManagerUI() {
       try {
         await (window as any).host?.utils?.perfLog?.(`[ui] history.resume ${mode} error ${String((err as any)?.stack || err)}`);
       } catch {}
+      alert(String(t('history:resumeFailed', { error: String((err as any)?.message || err) })));
       return false;
     }
   };
@@ -4566,9 +4589,24 @@ function filterHistoryMessages(session: HistorySession, typeFilter: Record<strin
 
 function HistoryDetail({ sessions, selectedHistoryId, onBack, onResume, onResumeExternal, terminalMode }: { sessions: HistorySession[]; selectedHistoryId: string | null; onBack?: () => void; onResume?: (filePath?: string) => void; onResumeExternal?: (filePath?: string) => void; terminalMode: 'wsl' | 'windows' }) {
   const { t } = useTranslation(['history', 'common']);
+  const MAX_HISTORY_MESSAGE_CACHE = 5;
   const [loaded, setLoaded] = useState(false);
   const [skipped, setSkipped] = useState(0);
-  const [localSessions, setLocalSessions] = useState<HistorySession[]>(sessions);
+  const [localSessions, setLocalSessions] = useState<HistorySession[]>(() => sessions.map((s) => ({ ...s, messages: [] })));
+  const messageCacheIdsRef = useRef<string[]>([]);
+  const pruneMessages = useCallback((list: HistorySession[], allowed: Set<string>) => {
+    if (!Array.isArray(list) || list.length === 0) return list;
+    if (allowed.size === 0) return list.map((s) => ({ ...s, messages: [] }));
+    return list.map((s) => (allowed.has(s.id) ? s : { ...s, messages: [] }));
+  }, []);
+  const touchMessageCache = useCallback((id?: string | null) => {
+    if (!id) return messageCacheIdsRef.current;
+    const next = messageCacheIdsRef.current.filter((x) => x !== id);
+    next.unshift(id);
+    if (next.length > MAX_HISTORY_MESSAGE_CACHE) next.length = MAX_HISTORY_MESSAGE_CACHE;
+    messageCacheIdsRef.current = next;
+    return messageCacheIdsRef.current;
+  }, [MAX_HISTORY_MESSAGE_CACHE]);
   const [typeFilter, setTypeFilter] = useState<Record<string, boolean>>({});
   const [detailSearch, setDetailSearch] = useState("");
   const reqSeq = useRef(0);
@@ -4594,18 +4632,23 @@ function HistoryDetail({ sessions, selectedHistoryId, onBack, onResume, onResume
 
   // 刷新列表时保留已加载的消息内容，避免详情面板闪烁
   useEffect(() => {
+    const filteredIds = messageCacheIdsRef.current.filter((id) => sessions.some((s) => s.id === id));
+    messageCacheIdsRef.current = filteredIds;
+    const allowed = new Set(filteredIds);
     setLocalSessions((cur) => {
       const prevMap = new Map(cur.map((x) => [x.id, x]));
-      return sessions.map((s) => {
+      const merged = sessions.map((s) => {
         const prev = prevMap.get(s.id);
-        if (!prev) return s;
+        if (!prev) return allowed.has(s.id) ? s : { ...s, messages: [] };
         const prevMsgs = Array.isArray(prev.messages) ? prev.messages : [];
         const nextMsgs = Array.isArray(s.messages) ? s.messages : [];
-        if (nextMsgs.length === 0 && prevMsgs.length > 0) return { ...s, messages: prevMsgs };
+        if (allowed.has(s.id) && nextMsgs.length === 0 && prevMsgs.length > 0) return { ...s, messages: prevMsgs };
+        if (!allowed.has(s.id)) return { ...s, messages: [] };
         return s;
       });
+      return pruneMessages(merged, allowed);
     });
-  }, [sessions]);
+  }, [sessions, pruneMessages]);
 
   useEffect(() => {
     setDetailSearch("");
@@ -4725,7 +4768,11 @@ function HistoryDetail({ sessions, selectedHistoryId, onBack, onResume, onResume
         const res: any = await window.host.history.read({ filePath: String(selectedSession.filePath || '') });
         const msgs = (res.messages || []).map((m: any) => ({ role: m.role as any, content: m.content }));
         if (seq === reqSeq.current) {
-          setLocalSessions((cur) => cur.map((x) => (x.id === selectedHistoryId ? { ...x, messages: msgs } : x)));
+          const allowedIds = new Set(touchMessageCache(selectedHistoryId));
+          setLocalSessions((cur) => {
+            const next = cur.map((x) => (x.id === selectedHistoryId ? { ...x, messages: msgs } : x));
+            return pruneMessages(next, allowedIds);
+          });
           setSkipped(res.skippedLines || 0);
           setLoaded(true);
           lastLoadedFingerprintRef.current = signature;
@@ -4757,7 +4804,7 @@ function HistoryDetail({ sessions, selectedHistoryId, onBack, onResume, onResume
         if (seq === reqSeq.current) setLoaded(true);
       }
     })();
-  }, [selectedHistoryId, selectedSession, selectedSessionFingerprint, selectedLocalSession]);
+  }, [selectedHistoryId, selectedSession, selectedSessionFingerprint, selectedLocalSession, pruneMessages, touchMessageCache]);
 
   function buildFilteredText(): string {
     if (!selectedHistoryId) return '';

electron/main.ts

@@ -31,6 +31,7 @@
   "resumeShellMismatch": "This conversation was recorded in {expected} mode and cannot run while {current} is active. Switch to {expected} mode and try again.",
   "resumeShellMismatchExpectedLabel": "Session mode",
   "resumeShellMismatchCurrentLabel": "Active mode",
+  "resumeFailed": "Failed to resume conversation: {error}",
   "panelTitle": "Project History",
   "searchPlaceholder": "Search history…",
   "searchPlaceholderHint": "Search history by title, path, or first prompt",

web/src/App.tsx

@@ -6,6 +6,7 @@
   "expandInput": "Expand composer",
   "collapseInput": "Exit expand",
   "readyPlaceholder": "# Terminal ready. Embedded console placeholder (UI prototype; no real PTY yet).",
+  "openFailed": "Failed to start console: {error}",
   "ctx": {
     "copy": "Copy",
     "copyLine": "Copy Line",

web/src/locales/en/history.json

@@ -31,6 +31,7 @@
   "resumeShellMismatch": "该会话来自 {expected} 模式，当前运行环境为 {current}，暂不支持跨环境恢复。请切换到 {expected} 模式后再试。",
   "resumeShellMismatchExpectedLabel": "会话模式",
   "resumeShellMismatchCurrentLabel": "当前模式",
+  "resumeFailed": "恢复会话失败：{error}",
   "panelTitle": "项目历史",
   "searchPlaceholder": "搜索历史记录…",
   "searchPlaceholderHint": "按标题、路径或输入首条历史内容搜索历史记录",

web/src/locales/en/terminal.json

@@ -6,6 +6,7 @@
   "expandInput": "展开输入框",
   "collapseInput": "退出大屏",
   "readyPlaceholder": "# 终端就绪。这里是内嵌控制台的视觉占位（UI 原型，未接真 PTY）。",
+  "openFailed": "启动终端失败：{error}",
   "ctx": {
     "copy": "复制",
     "copyLine": "复制整行",