feat(history): 代理完成后抢先刷新历史索引

技术变更：
- 在 electron/indexer.ts 增加快速刷新队列与增量 upsert 逻辑，统一处理按文件和按根目录的轻量刷新请求。
- 补充 transcriptPath 的可访问路径规范化，兼容 WSL 路径与 UNC 路径互转。
- 在 Claude、Gemini 通知桥接中透传 transcriptPath，在 Codex 通知桥接中触发小范围近期会话扫描。
- 为索引器增加窗口 getter 缓存以及快速刷新状态清理，避免重启或热更新后残留定时器和闭包。

产品行为：
- Agent 完成一轮对话后，历史侧栏可以更早显示新会话或最新摘要。
- 不再完全依赖原有 800ms 文件监听去抖链路，同时保留 watcher 与重扫作为兜底。

测试：
- 已通过：npm run build:electron
- 已通过：npm run test

Signed-off-by: Lulu <58587930+lulu-sk@users.noreply.github.com>

Author: lulu-sk

electron/claude/notifications.ts

@@ -7,6 +7,7 @@ import { BrowserWindow } from "electron";
 import { perfLogger } from "../log";
 import { uncToWsl, type SessionsRootCandidate } from "../wsl";
 import { getClaudeRootCandidatesFastAsync } from "../agentSessions/claude/discovery";
+import { requestHistoryFastRefresh } from "../indexer";
 
 const CLAUDE_HOOK_FILENAME = "codexflow_stop_notify.js";
 const CLAUDE_HOOK_TIMEOUT_MS = 5000;
@@ -635,10 +636,17 @@ function readClaudeNotifyEntries(source: ClaudeNotifySource): ClaudeNotifyEntry[
 }
 
 /**
- * 中文说明：将 Claude 通知事件转发给渲染进程。
+ * 中文说明：将 Claude 通知事件转发给渲染进程，并用 transcriptPath 触发精确历史刷新。
  */
-function emitClaudeNotify(entry: ClaudeNotifyEntry): void {
+function emitClaudeNotify(entry: ClaudeNotifyEntry, sourcePath?: string): void {
   const win = claudeNotifyWindowGetter ? claudeNotifyWindowGetter() : null;
+  try {
+    requestHistoryFastRefresh({
+      providerId: "claude",
+      filePath: entry.transcriptPath,
+      sourcePath,
+    });
+  } catch {}
   if (!win) return;
   const providerId = String(entry.providerId || "claude").toLowerCase();
   if (providerId && providerId !== "claude") return;
@@ -668,7 +676,7 @@ async function pollClaudeNotifyFiles(): Promise<void> {
     for (const source of Array.from(claudeNotifySources.values())) {
       const entries = readClaudeNotifyEntries(source);
       if (!entries.length) continue;
-      for (const entry of entries) emitClaudeNotify(entry);
+      for (const entry of entries) emitClaudeNotify(entry, source.filePath);
     }
   } finally {
     claudeNotifyPolling = false;

electron/codex/notifications.ts

@@ -6,6 +6,7 @@ import path from "node:path";
 import { BrowserWindow } from "electron";
 import { perfLogger } from "../log";
 import { getCodexRootsFastAsync } from "../wsl";
+import { requestHistoryFastRefresh } from "../indexer";
 
 const CODEX_NOTIFY_FILENAME = "codexflow_after_agent_notify.jsonl";
 const CODEX_NOTIFY_POLL_INTERVAL_MS = 1200;
@@ -165,10 +166,16 @@ function readCodexNotifyEntries(source: CodexNotifySource): CodexNotifyEntry[] {
 }
 
 /**
- * 中文说明：将 Codex 通知事件转发给渲染进程。
+ * 中文说明：将 Codex 通知事件转发给渲染进程，并提示索引器抢先刷新最近历史。
  */
-function emitCodexNotify(entry: CodexNotifyEntry): void {
+function emitCodexNotify(entry: CodexNotifyEntry, sourcePath?: string): void {
   const win = codexNotifyWindowGetter ? codexNotifyWindowGetter() : null;
+  try {
+    requestHistoryFastRefresh({
+      providerId: "codex",
+      sourcePath,
+    });
+  } catch {}
   if (!win) return;
   const providerId = String(entry.providerId || "codex").toLowerCase();
   if (providerId && providerId !== "codex") return;
@@ -198,7 +205,7 @@ async function pollCodexNotifyFiles(): Promise<void> {
     for (const source of Array.from(codexNotifySources.values())) {
       const entries = readCodexNotifyEntries(source);
       if (!entries.length) continue;
-      for (const entry of entries) emitCodexNotify(entry);
+      for (const entry of entries) emitCodexNotify(entry, source.filePath);
     }
   } finally {
     codexNotifyPolling = false;

electron/gemini/notifications.ts

@@ -7,6 +7,7 @@ import { BrowserWindow } from "electron";
 import { perfLogger } from "../log";
 import { uncToWsl, type SessionsRootCandidate } from "../wsl";
 import { getGeminiRootCandidatesFastAsync } from "../agentSessions/gemini/discovery";
+import { requestHistoryFastRefresh } from "../indexer";
 
 const GEMINI_HOOK_FILENAME = "codexflow_after_agent_notify.js";
 const GEMINI_NOTIFY_FILENAME = "codexflow_after_agent_notify.jsonl";
@@ -796,10 +797,17 @@ function readGeminiNotifyEntries(source: GeminiNotifySource): GeminiNotifyEntry[
 }
 
 /**
- * 中文说明：将 Gemini 通知事件转发给渲染进程。
+ * 中文说明：将 Gemini 通知事件转发给渲染进程，并用 transcriptPath 触发精确历史刷新。
  */
-function emitGeminiNotify(entry: GeminiNotifyEntry): void {
+function emitGeminiNotify(entry: GeminiNotifyEntry, sourcePath?: string): void {
   const win = geminiNotifyWindowGetter ? geminiNotifyWindowGetter() : null;
+  try {
+    requestHistoryFastRefresh({
+      providerId: "gemini",
+      filePath: entry.transcriptPath,
+      sourcePath,
+    });
+  } catch {}
   if (!win) return;
   const providerId = String(entry.providerId || "gemini").toLowerCase();
   if (providerId && providerId !== "gemini") return;
@@ -829,7 +837,7 @@ async function pollGeminiNotifyFiles(): Promise<void> {
     for (const source of Array.from(geminiNotifySources.values())) {
       const entries = readGeminiNotifyEntries(source);
       if (!entries.length) continue;
-      for (const entry of entries) emitGeminiNotify(entry);
+      for (const entry of entries) emitGeminiNotify(entry, source.filePath);
     }
   } finally {
     geminiNotifyPolling = false;