@huyooo/ai-search 0.2.3 → 0.2.5

package/dist/bridge/electron.js

@@ -1,7 +1,7 @@
 import {
   SearchElectronBridge,
   createSearchElectronBridge
-} from "../chunk-GAT4F5NK.js";
+} from "../chunk-MXWSYA4O.js";
 import "../chunk-YJIIX54F.js";
 export {
   SearchElectronBridge,

package/dist/bridge/renderer.d.ts

@@ -0,0 +1,71 @@
+import { c as SearchOptions, d as SearchResult, I as IndexProgress } from '../types-D1U3F-Fs.js';
+
+/**
+ * Electron 渲染进程桥接（给 App UI 使用）
+ *
+ * 注意：此模块依赖 electron（ipcRenderer），请仅在 Electron 渲染进程中使用：
+ * `import { createSearchClient } from '@huyooo/ai-search/bridge/renderer'`
+ */
+
+type IpcDateRange = {
+    start?: string;
+    end?: string;
+};
+type IpcSearchOptions = Omit<SearchOptions, 'dateRange'> & {
+    dateRange?: IpcDateRange;
+};
+interface WorkspaceState {
+    directory: string | null;
+    indexed: boolean;
+    filesIndexed: number;
+}
+interface SearchClientOptions {
+    channelPrefix?: string;
+}
+interface SearchClient {
+    /** 搜索（语义/关键词/混合） */
+    search: (query: string, options?: IpcSearchOptions) => Promise<{
+        success: boolean;
+        data?: SearchResult[];
+        error?: string;
+    }>;
+    /** 设置工作空间（会触发索引） */
+    setWorkspace: (directory: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /** 获取工作空间状态 */
+    getWorkspaceState: () => Promise<WorkspaceState>;
+    getIndexStats: () => Promise<{
+        totalDocuments: number;
+        indexSize: number;
+        lastUpdated: string | null;
+    }>;
+    syncIndex: () => Promise<{
+        success: boolean;
+    }>;
+    getIndexStatus: () => Promise<{
+        isIndexing: boolean;
+        lastProgress: IndexProgress | null;
+    }>;
+    cancelIndex: () => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    deleteIndex: () => Promise<{
+        success: boolean;
+    }>;
+    registerIndexProgressListener: () => Promise<{
+        success: boolean;
+    }>;
+    unregisterIndexProgressListener: () => Promise<{
+        success: boolean;
+    }>;
+    onIndexProgress: (callback: (progress: IndexProgress | (IndexProgress & {
+        stage: 'cancelled' | 'error';
+        error?: string;
+    })) => void) => () => void;
+}
+declare function createSearchClient(options?: SearchClientOptions): SearchClient;
+
+export { type IpcSearchOptions, type SearchClient, type SearchClientOptions, type WorkspaceState, createSearchClient };

package/dist/bridge/renderer.js

@@ -0,0 +1,29 @@
+// src/bridge/renderer.ts
+import { ipcRenderer } from "electron";
+function createSearchClient(options = {}) {
+  const channelPrefix = options.channelPrefix || "ai-chat";
+  const channel = (name) => `${channelPrefix}:${name}`;
+  return {
+    search: (query, searchOptions) => ipcRenderer.invoke(channel("search:query"), query, searchOptions),
+    setWorkspace: (directory) => ipcRenderer.invoke(channel("workspace:set"), directory),
+    getWorkspaceState: () => ipcRenderer.invoke(channel("workspace:get")),
+    getIndexStats: () => ipcRenderer.invoke(channel("index:getStats")),
+    syncIndex: () => ipcRenderer.invoke(channel("index:sync")),
+    getIndexStatus: () => ipcRenderer.invoke(channel("index:status")),
+    cancelIndex: () => ipcRenderer.invoke(channel("index:cancel")),
+    deleteIndex: () => ipcRenderer.invoke(channel("index:delete")),
+    registerIndexProgressListener: () => ipcRenderer.invoke(channel("index:registerListener")),
+    unregisterIndexProgressListener: () => ipcRenderer.invoke(channel("index:unregisterListener")),
+    onIndexProgress: (callback) => {
+      const handler = (_event, progress) => {
+        callback(progress);
+      };
+      ipcRenderer.on(channel("index:progress"), handler);
+      return () => ipcRenderer.removeListener(channel("index:progress"), handler);
+    }
+  };
+}
+export {
+  createSearchClient
+};
+//# sourceMappingURL=renderer.js.map

package/dist/bridge/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/bridge/renderer.ts"],"sourcesContent":["/**\n * Electron 渲染进程桥接（给 App UI 使用）\n *\n * 注意：此模块依赖 electron（ipcRenderer），请仅在 Electron 渲染进程中使用：\n * `import { createSearchClient } from '@huyooo/ai-search/bridge/renderer'`\n */\n\nimport { ipcRenderer, type IpcRendererEvent } from 'electron'\nimport type { IndexProgress, SearchOptions, SearchResult } from '../types'\n\ntype IpcDateRange = { start?: string; end?: string }\nexport type IpcSearchOptions = Omit<SearchOptions, 'dateRange'> & {\n  dateRange?: IpcDateRange\n}\n\nexport interface WorkspaceState {\n  directory: string | null\n  indexed: boolean\n  filesIndexed: number\n}\n\nexport interface SearchClientOptions {\n  channelPrefix?: string\n}\n\nexport interface SearchClient {\n  /** 搜索（语义/关键词/混合） */\n  search: (query: string, options?: IpcSearchOptions) => Promise<{ success: boolean; data?: SearchResult[]; error?: string }>\n  /** 设置工作空间（会触发索引） */\n  setWorkspace: (directory: string) => Promise<{ success: boolean; error?: string }>\n  /** 获取工作空间状态 */\n  getWorkspaceState: () => Promise<WorkspaceState>\n\n  // ===== 索引控制（可选） =====\n  getIndexStats: () => Promise<{ totalDocuments: number; indexSize: number; lastUpdated: string | null }>\n  syncIndex: () => Promise<{ success: boolean }>\n  getIndexStatus: () => Promise<{ isIndexing: boolean; lastProgress: IndexProgress | null }>\n  cancelIndex: () => Promise<{ success: boolean; message?: string }>\n  deleteIndex: () => Promise<{ success: boolean }>\n\n  // ===== 进度广播 =====\n  registerIndexProgressListener: () => Promise<{ success: boolean }>\n  unregisterIndexProgressListener: () => Promise<{ success: boolean }>\n  onIndexProgress: (callback: (progress: IndexProgress | (IndexProgress & { stage: 'cancelled' | 'error'; error?: string })) => void) => () => void\n}\n\nexport function createSearchClient(options: SearchClientOptions = {}): SearchClient {\n  const channelPrefix = options.channelPrefix || 'ai-chat'\n  const channel = (name: string) => `${channelPrefix}:${name}`\n\n  return {\n    search: (query, searchOptions) => ipcRenderer.invoke(channel('search:query'), query, searchOptions),\n    setWorkspace: (directory) => ipcRenderer.invoke(channel('workspace:set'), directory),\n    getWorkspaceState: () => ipcRenderer.invoke(channel('workspace:get')),\n\n    getIndexStats: () => ipcRenderer.invoke(channel('index:getStats')),\n    syncIndex: () => ipcRenderer.invoke(channel('index:sync')),\n    getIndexStatus: () => ipcRenderer.invoke(channel('index:status')),\n    cancelIndex: () => ipcRenderer.invoke(channel('index:cancel')),\n    deleteIndex: () => ipcRenderer.invoke(channel('index:delete')),\n\n    registerIndexProgressListener: () => ipcRenderer.invoke(channel('index:registerListener')),\n    unregisterIndexProgressListener: () => ipcRenderer.invoke(channel('index:unregisterListener')),\n    onIndexProgress: (callback) => {\n      const handler = (_event: IpcRendererEvent, progress: IndexProgress) => {\n        callback(progress)\n      }\n      ipcRenderer.on(channel('index:progress'), handler)\n      return () => ipcRenderer.removeListener(channel('index:progress'), handler)\n    },\n  }\n}\n\n\n"],"mappings":";AAOA,SAAS,mBAA0C;AAuC5C,SAAS,mBAAmB,UAA+B,CAAC,GAAiB;AAClF,QAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,QAAM,UAAU,CAAC,SAAiB,GAAG,aAAa,IAAI,IAAI;AAE1D,SAAO;AAAA,IACL,QAAQ,CAAC,OAAO,kBAAkB,YAAY,OAAO,QAAQ,cAAc,GAAG,OAAO,aAAa;AAAA,IAClG,cAAc,CAAC,cAAc,YAAY,OAAO,QAAQ,eAAe,GAAG,SAAS;AAAA,IACnF,mBAAmB,MAAM,YAAY,OAAO,QAAQ,eAAe,CAAC;AAAA,IAEpE,eAAe,MAAM,YAAY,OAAO,QAAQ,gBAAgB,CAAC;AAAA,IACjE,WAAW,MAAM,YAAY,OAAO,QAAQ,YAAY,CAAC;AAAA,IACzD,gBAAgB,MAAM,YAAY,OAAO,QAAQ,cAAc,CAAC;AAAA,IAChE,aAAa,MAAM,YAAY,OAAO,QAAQ,cAAc,CAAC;AAAA,IAC7D,aAAa,MAAM,YAAY,OAAO,QAAQ,cAAc,CAAC;AAAA,IAE7D,+BAA+B,MAAM,YAAY,OAAO,QAAQ,wBAAwB,CAAC;AAAA,IACzF,iCAAiC,MAAM,YAAY,OAAO,QAAQ,0BAA0B,CAAC;AAAA,IAC7F,iBAAiB,CAAC,aAAa;AAC7B,YAAM,UAAU,CAAC,QAA0B,aAA4B;AACrE,iBAAS,QAAQ;AAAA,MACnB;AACA,kBAAY,GAAG,QAAQ,gBAAgB,GAAG,OAAO;AACjD,aAAO,MAAM,YAAY,eAAe,QAAQ,gBAAgB,GAAG,OAAO;AAAA,IAC5E;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-GAT4F5NK.js → chunk-MXWSYA4O.js}

@@ -147,6 +147,61 @@ var SearchElectronBridge = class {
         throw error;
       }
     });
+    const normalizeSearchOptions = (options) => {
+      if (!options) return void 0;
+      const { dateRange: rawDateRange, ...rest } = options;
+      if (!rawDateRange) {
+        return rest;
+      }
+      const start = rawDateRange.start ? new Date(rawDateRange.start) : void 0;
+      const end = rawDateRange.end ? new Date(rawDateRange.end) : void 0;
+      const hasValidStart = !!start && !Number.isNaN(start.getTime());
+      const hasValidEnd = !!end && !Number.isNaN(end.getTime());
+      if (!hasValidStart && !hasValidEnd) {
+        return rest;
+      }
+      return {
+        ...rest,
+        dateRange: {
+          start: hasValidStart ? start : void 0,
+          end: hasValidEnd ? end : void 0
+        }
+      };
+    };
+    this.ipcMain.handle(
+      `${this.channelPrefix}:search:query`,
+      async (_event, query, options) => {
+        try {
+          const searchPlugin = getSearchPlugin();
+          if (!searchPlugin) {
+            return { success: false, error: "\u641C\u7D22\u63D2\u4EF6\u672A\u521D\u59CB\u5316" };
+          }
+          const results = await searchPlugin.search.search(query, normalizeSearchOptions(options));
+          return { success: true, data: results };
+        } catch (error) {
+          return { success: false, error: error instanceof Error ? error.message : String(error) };
+        }
+      }
+    );
+    this.ipcMain.handle(`${this.channelPrefix}:workspace:set`, async (_event, directory) => {
+      const searchPlugin = getSearchPlugin();
+      if (!searchPlugin) {
+        return { success: false, error: "\u641C\u7D22\u63D2\u4EF6\u672A\u521D\u59CB\u5316" };
+      }
+      try {
+        await searchPlugin.setWorkspace(directory);
+        return { success: true };
+      } catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : String(error) };
+      }
+    });
+    this.ipcMain.handle(`${this.channelPrefix}:workspace:get`, async () => {
+      const searchPlugin = getSearchPlugin();
+      if (!searchPlugin) {
+        return { directory: null, indexed: false, filesIndexed: 0 };
+      }
+      return searchPlugin.getWorkspaceState();
+    });
   }
   /** 广播索引进度到所有前端监听器 */
   broadcastIndexProgress(progress) {
@@ -173,4 +228,4 @@ export {
   SearchElectronBridge,
   createSearchElectronBridge
 };
-//# sourceMappingURL=chunk-GAT4F5NK.js.map
+//# sourceMappingURL=chunk-MXWSYA4O.js.map

package/dist/chunk-MXWSYA4O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bridge/electron.ts"],"sourcesContent":["/**\n * Electron 桥接模块\n * \n * 使用全局进度监听器自动广播索引进度\n * 无需包装方法，无需轮询，解决时序问题\n */\n\nimport type { IpcMain, WebContents } from 'electron';\nimport { getSearchPlugin } from '../tools';\nimport { addGlobalProgressListener } from '../core/progress';\nimport type { IndexProgress, SearchOptions, SearchResult } from '../types';\n\n// 扩展的索引进度类型，支持取消和错误状态\ntype ExtendedIndexProgress = IndexProgress | {\n  indexed: number;\n  total: number;\n  currentFile?: string;\n  stage: 'cancelled' | 'error';\n  error?: string;\n};\n\n/** Electron 桥接选项 */\nexport interface SearchElectronBridgeOptions {\n  /** IPC channel 前缀 */\n  channelPrefix?: string;\n  /** IPC Main 实例 */\n  ipcMain: IpcMain;\n}\n\n/** 索引进度广播系统 */\nexport class SearchElectronBridge {\n  private channelPrefix: string;\n  private ipcMain: IpcMain;\n  private indexingListeners = new Set<WebContents>();\n  private lastProgress: ExtendedIndexProgress | null = null;\n  private isIndexing = false;\n\n  constructor(options: SearchElectronBridgeOptions) {\n    this.channelPrefix = options.channelPrefix || 'ai-chat';\n    this.ipcMain = options.ipcMain;\n  }\n\n  /** 初始化桥接（注册 IPC handlers 和全局进度监听器） */\n  init(): void {\n    this.registerIpcHandlers();\n    this.registerGlobalProgressListener();\n    console.log('[AI-Search] Electron 桥接已初始化');\n  }\n\n  /** 注册全局进度监听器 */\n  private registerGlobalProgressListener(): void {\n    // 注册全局进度监听器，所有 indexDirectory 调用都会触发\n    addGlobalProgressListener((progress: IndexProgress) => {\n      // 更新状态\n      this.isIndexing = progress.stage !== 'done';\n      this.lastProgress = progress;\n      \n      // 广播进度到所有前端监听器\n      this.broadcastIndexProgress(progress);\n    });\n  }\n\n  /** 注册 IPC handlers */\n  private registerIpcHandlers(): void {\n    // 注册索引进度监听器（前端调用）\n    this.ipcMain.handle(`${this.channelPrefix}:index:registerListener`, (event) => {\n      const webContents = event.sender;\n      this.indexingListeners.add(webContents);\n      \n      // 如果正在索引，立即发送最后进度\n      if (this.lastProgress && this.isIndexing) {\n        if (!webContents.isDestroyed()) {\n          webContents.send(`${this.channelPrefix}:index:progress`, {\n            indexed: this.lastProgress.indexed,\n            total: this.lastProgress.total,\n            currentFile: this.lastProgress.currentFile,\n            stage: this.lastProgress.stage,\n          });\n        }\n      }\n      \n      return { success: true };\n    });\n\n    // 注销索引进度监听器（前端调用）\n    this.ipcMain.handle(`${this.channelPrefix}:index:unregisterListener`, (event) => {\n      this.indexingListeners.delete(event.sender);\n      return { success: true };\n    });\n\n    // 获取索引统计信息\n    this.ipcMain.handle(`${this.channelPrefix}:index:getStats`, async () => {\n      try {\n        const searchPlugin = getSearchPlugin();\n        \n        if (!searchPlugin) {\n          return {\n            totalDocuments: 0,\n            indexSize: 0,\n            lastUpdated: null,\n          };\n        }\n        \n        const stats = searchPlugin.search.getStats();\n        return {\n          totalDocuments: stats.totalDocuments,\n          indexSize: stats.indexSize,\n          lastUpdated: stats.lastUpdated ? stats.lastUpdated.toISOString() : null,\n        };\n      } catch (error) {\n        console.error('[AI-Search] 获取索引统计失败:', error);\n        return {\n          totalDocuments: 0,\n          indexSize: 0,\n          lastUpdated: null,\n        };\n      }\n    });\n\n    // 同步索引（重新索引工作空间）\n    this.ipcMain.handle(`${this.channelPrefix}:index:sync`, async () => {\n      try {\n        const searchPlugin = getSearchPlugin();\n        \n        if (!searchPlugin) {\n          throw new Error('搜索插件未初始化');\n        }\n\n        const workspaceState = searchPlugin.getWorkspaceState();\n        if (!workspaceState.directory) {\n          throw new Error('工作空间未设置');\n        }\n\n        // 开始索引（进度会通过全局监听器自动广播）\n        await searchPlugin.search.indexDirectory(workspaceState.directory!);\n        \n        return { success: true };\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        console.error('[AI-Search] 同步索引失败:', errorMessage);\n        \n        // 广播错误状态\n        this.broadcastIndexProgress({\n          indexed: 0,\n          total: 0,\n          stage: 'error',\n          error: errorMessage,\n        });\n        \n        throw error;\n      }\n    });\n\n    // 检查索引状态\n    this.ipcMain.handle(`${this.channelPrefix}:index:status`, async () => {\n      return {\n        isIndexing: this.isIndexing,\n        lastProgress: this.lastProgress,\n      };\n    });\n\n    // 取消索引\n    this.ipcMain.handle(`${this.channelPrefix}:index:cancel`, async () => {\n      try {\n        const searchPlugin = getSearchPlugin();\n        \n        if (!searchPlugin) {\n          return { success: false, message: '搜索插件未初始化' };\n        }\n\n        const cancelled = searchPlugin.search.cancelIndexing();\n        \n        if (cancelled) {\n          // 广播取消状态\n          this.broadcastIndexProgress({\n            indexed: this.lastProgress?.indexed || 0,\n            total: this.lastProgress?.total || 0,\n            stage: 'cancelled',\n          });\n          this.isIndexing = false;\n          return { success: true };\n        } else {\n          return { success: false, message: '没有正在运行的索引任务' };\n        }\n      } catch (error) {\n        console.error('[AI-Search] 取消索引失败:', error);\n        return { success: false, message: String(error) };\n      }\n    });\n\n    // 删除索引\n    this.ipcMain.handle(`${this.channelPrefix}:index:delete`, async () => {\n      try {\n        const searchPlugin = getSearchPlugin();\n        \n        if (!searchPlugin) {\n          throw new Error('搜索插件未初始化');\n        }\n\n        await searchPlugin.search.clear();\n        \n        // 重置状态\n        this.isIndexing = false;\n        this.lastProgress = null;\n        \n        // 广播清空状态（使用 done 阶段，indexed=0 表示已清空）\n        this.broadcastIndexProgress({\n          indexed: 0,\n          total: 0,\n          stage: 'done',\n        });\n        \n        return { success: true };\n      } catch (error) {\n        console.error('[AI-Search] 删除索引失败:', error);\n        throw error;\n      }\n    });\n\n    // ==================== 搜索能力（给 App UI 使用） ====================\n\n    type IpcDateRange = { start?: string; end?: string };\n    type IpcSearchOptions = Omit<SearchOptions, 'dateRange'> & {\n      dateRange?: IpcDateRange;\n    };\n\n    const normalizeSearchOptions = (options?: IpcSearchOptions): SearchOptions | undefined => {\n      if (!options) return undefined;\n\n      const { dateRange: rawDateRange, ...rest } = options;\n\n      if (!rawDateRange) {\n        // 关键：必须剥离 IpcSearchOptions 的 dateRange 字段，避免类型不匹配\n        return rest;\n      }\n\n      const start = rawDateRange.start ? new Date(rawDateRange.start) : undefined;\n      const end = rawDateRange.end ? new Date(rawDateRange.end) : undefined;\n\n      const hasValidStart = !!start && !Number.isNaN(start.getTime());\n      const hasValidEnd = !!end && !Number.isNaN(end.getTime());\n\n      if (!hasValidStart && !hasValidEnd) {\n        return rest;\n      }\n\n      return {\n        ...rest,\n        dateRange: {\n          start: hasValidStart ? start : undefined,\n          end: hasValidEnd ? end : undefined,\n        },\n      };\n    };\n\n    // 语义/关键词/混合搜索（一次性返回）\n    this.ipcMain.handle(\n      `${this.channelPrefix}:search:query`,\n      async (_event, query: string, options?: IpcSearchOptions): Promise<{ success: boolean; data?: SearchResult[]; error?: string }> => {\n        try {\n          const searchPlugin = getSearchPlugin();\n          if (!searchPlugin) {\n            return { success: false, error: '搜索插件未初始化' };\n          }\n          const results = await searchPlugin.search.search(query, normalizeSearchOptions(options));\n          return { success: true, data: results };\n        } catch (error) {\n          return { success: false, error: error instanceof Error ? error.message : String(error) };\n        }\n      }\n    );\n\n    // 设置工作空间（会触发索引，进度通过全局监听器自动广播）\n    this.ipcMain.handle(`${this.channelPrefix}:workspace:set`, async (_event, directory: string) => {\n      const searchPlugin = getSearchPlugin();\n      if (!searchPlugin) {\n        return { success: false, error: '搜索插件未初始化' };\n      }\n      try {\n        await searchPlugin.setWorkspace(directory);\n        return { success: true };\n      } catch (error) {\n        return { success: false, error: error instanceof Error ? error.message : String(error) };\n      }\n    });\n\n    // 获取工作空间状态\n    this.ipcMain.handle(`${this.channelPrefix}:workspace:get`, async () => {\n      const searchPlugin = getSearchPlugin();\n      if (!searchPlugin) {\n        return { directory: null, indexed: false, filesIndexed: 0 };\n      }\n      return searchPlugin.getWorkspaceState();\n    });\n  }\n\n  /** 广播索引进度到所有前端监听器 */\n  private broadcastIndexProgress(progress: ExtendedIndexProgress): void {\n    // 更新最后进度\n    this.lastProgress = progress;\n    \n    // 向所有监听器广播\n    this.indexingListeners.forEach((webContents) => {\n      if (!webContents.isDestroyed()) {\n        webContents.send(`${this.channelPrefix}:index:progress`, {\n          indexed: progress.indexed,\n          total: progress.total,\n          currentFile: progress.currentFile,\n          stage: progress.stage,\n        });\n      } else {\n        // 清理已销毁的 webContents\n        this.indexingListeners.delete(webContents);\n      }\n    });\n  }\n}\n\n/**\n * 创建搜索 Electron 桥接\n * \n * @example\n * ```typescript\n * import { createSearchElectronBridge } from '@huyooo/ai-search/bridge/electron';\n * import { ipcMain } from 'electron';\n * \n * const bridge = createSearchElectronBridge({\n *   ipcMain,\n *   channelPrefix: 'ai-chat',\n * });\n * bridge.init();\n * ```\n */\nexport function createSearchElectronBridge(\n  options: SearchElectronBridgeOptions\n): SearchElectronBridge {\n  return new SearchElectronBridge(options);\n}\n"],"mappings":"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","names":[]}

package/dist/{index-B6UR8lRu.d.ts → index-BKiGwrBS.d.ts}

@@ -1,268 +1,6 @@
+import { I as IndexProgress, S as SearchConfig, c as SearchOptions, d as SearchResult, b as IndexStats, B as BatchOperationResult, W as WatchOptions, H as HealthCheckResult, g as IndexError, E as ExportInfo, f as BackupInfo } from './types-D1U3F-Fs.js';
 import { ToolPlugin, Tool } from '@huyooo/ai-chat-core';
 
-/**
- * 文件类型（与 file-explorer 兼容）
- */
-declare const FileType: {
-    readonly FOLDER: "folder";
-    readonly FILE: "file";
-    readonly IMAGE: "image";
-    readonly VIDEO: "video";
-    readonly MUSIC: "music";
-    readonly DOCUMENT: "document";
-    readonly CODE: "code";
-    readonly TEXT: "text";
-    readonly PDF: "pdf";
-    readonly ARCHIVE: "archive";
-    readonly APPLICATION: "application";
-    readonly UNKNOWN: "unknown";
-};
-type FileType = (typeof FileType)[keyof typeof FileType];
-/**
- * 搜索结果（兼容 file-explorer 的 FileItem）
- */
-interface SearchResult {
-    /** 唯一标识（文件路径） */
-    id: string;
-    /** 文件名 */
-    name: string;
-    /** 文件类型 */
-    type: FileType;
-    /** 格式化后的文件大小 */
-    size?: string;
-    /** 格式化后的修改日期 */
-    dateModified?: string;
-    /** 文件 URL */
-    url?: string;
-    /** 缩略图 URL（文档类型通常没有） */
-    thumbnailUrl?: string;
-    /** 相关度分数 0-1 */
-    score: number;
-    /** 匹配文本摘要 */
-    snippet?: string;
-    /** 匹配类型 */
-    matchType: 'semantic' | 'keyword' | 'hybrid';
-    /** 匹配的块索引（分块后可用） */
-    chunkIndex?: number;
-}
-/**
- * 索引项（内部使用）
- */
-interface IndexedDocument {
-    /** 唯一 ID */
-    id: string;
-    /** 文件路径 */
-    path: string;
-    /** 文件名 */
-    name: string;
-    /** 文件类型 */
-    fileType: FileType;
-    /** 文件扩展名 */
-    extension: string;
-    /** 文档标题（从内容提取） */
-    title?: string;
-    /** 文档内容（用于全文搜索） */
-    content: string;
-    /** 文件大小（字节） */
-    fileSize: number;
-    /** 创建时间 */
-    createdAt: Date;
-    /** 修改时间 */
-    modifiedAt: Date;
-    /** 索引时间 */
-    indexedAt: Date;
-    /** 内容哈希（用于检测变更） */
-    contentHash: string;
-    /** 分块数量（用于清理旧数据） */
-    chunkCount?: number;
-}
-/**
- * 搜索配置
- */
-interface SearchConfig {
-    /** 数据存储目录 */
-    dataDir: string;
-    /** 索引目录列表 */
-    indexDirectories?: string[];
-    /** 排除目录 */
-    excludeDirs?: string[];
-    /** 支持的扩展名 */
-    extensions?: string[];
-    /** 最大文件大小（字节） */
-    maxFileSize?: number;
-    /** Embedding 模型（默认 doubao-embedding-vision-250615） */
-    embeddingModel?: string;
-    /** 豆包 API Key（ARK_API_KEY），也可通过环境变量设置 */
-    arkApiKey?: string;
-    /** 向量维度（默认 1024） */
-    embeddingDimension?: number;
-    /** 并行索引并发数（默认 5） */
-    indexConcurrency?: number;
-    /** 是否启用并行索引（默认 true） */
-    enableParallelIndexing?: boolean;
-}
-/**
- * 搜索选项
- */
-interface SearchOptions {
-    /** 返回数量限制 */
-    limit?: number;
-    /** 文件类型过滤 */
-    fileTypes?: FileType[];
-    /** 时间范围过滤 */
-    dateRange?: {
-        start?: Date;
-        end?: Date;
-    };
-    /** 目录过滤 */
-    directories?: string[];
-    /** 搜索模式 */
-    mode?: 'semantic' | 'keyword' | 'hybrid';
-    /** 文件大小过滤 */
-    sizeRange?: {
-        min?: number;
-        max?: number;
-    };
-    /** 文件名模式过滤（支持通配符 * 和 ?） */
-    fileNamePattern?: string;
-    /** 文档标题包含 */
-    titleContains?: string;
-    /** 组合条件模式 */
-    combineMode?: 'AND' | 'OR';
-}
-/**
- * 索引进度回调
- */
-interface IndexProgress {
-    /** 当前已索引数量 */
-    indexed: number;
-    /** 总文件数量 */
-    total: number;
-    /** 当前正在处理的文件 */
-    currentFile?: string;
-    /** 阶段 */
-    stage: 'scanning' | 'parsing' | 'embedding' | 'storing' | 'done' | 'cancelled';
-}
-/**
- * 索引统计
- */
-interface IndexStats {
-    /** 总文档数 */
-    totalDocuments: number;
-    /** 按类型统计 */
-    byType: Record<FileType, number>;
-    /** 索引目录 */
-    directories: string[];
-    /** 最后更新时间 */
-    lastUpdated?: Date;
-    /** 索引大小（字节） */
-    indexSize: number;
-}
-/**
- * 文件监听选项
- */
-interface WatchOptions {
-    /** 是否忽略初始扫描（只监听后续变化） */
-    ignoreInitial?: boolean;
-    /** 防抖延迟（毫秒），避免频繁触发 */
-    debounce?: number;
-    /** 监听事件回调 */
-    onEvent?: (event: WatchEvent) => void;
-}
-/**
- * 文件监听事件
- */
-interface WatchEvent {
-    /** 事件类型 */
-    type: 'add' | 'change' | 'unlink' | 'unlinkDir';
-    /** 文件路径 */
-    path: string;
-    /** 时间戳 */
-    timestamp: Date;
-}
-/**
- * 批量操作结果
- */
-interface BatchOperationResult {
-    /** 成功数量 */
-    success: number;
-    /** 失败数量 */
-    failed: number;
-    /** 失败的文件路径和错误信息 */
-    errors: Array<{
-        path: string;
-        error: string;
-    }>;
-}
-/**
- * 索引导出信息
- */
-interface ExportInfo {
-    /** 导出路径 */
-    exportPath: string;
-    /** 导出时间 */
-    timestamp: Date;
-    /** 包含的组件 */
-    components: {
-        meta: boolean;
-        vectors: boolean;
-        fulltext: boolean;
-    };
-    /** 统计信息 */
-    stats: IndexStats;
-}
-/**
- * 备份信息
- */
-interface BackupInfo {
-    /** 备份路径 */
-    path: string;
-    /** 备份时间 */
-    timestamp: Date;
-    /** 备份大小（字节） */
-    size: number;
-}
-/**
- * 索引错误信息
- */
-interface IndexError {
-    /** 文件路径 */
-    filePath: string;
-    /** 错误信息 */
-    error: string;
-    /** 重试次数 */
-    retryCount: number;
-    /** 时间戳 */
-    timestamp: Date;
-}
-/**
- * 健康检查结果
- */
-interface HealthCheckResult {
-    /** 是否健康 */
-    healthy: boolean;
-    /** 总文档数 */
-    totalDocuments: number;
-    /** 无效索引数（文件不存在） */
-    invalidIndexes: number;
-    /** 过期索引数（文件已修改） */
-    staleIndexes: number;
-    /** 错误数 */
-    errorCount: number;
-    /** 索引完整性 */
-    integrity: {
-        meta: boolean;
-        vectors: boolean;
-        fulltext: boolean;
-    };
-}
-/**
- * 默认配置
- * 注意：详细的排除规则和文件类型规则现在由 rules.ts 中的规则管理器统一管理
- * 这里的配置主要用于向后兼容和简单配置场景
- */
-declare const DEFAULT_CONFIG: Partial<SearchConfig>;
-
 /**
  * 文本分块模块
  * 递归语义分割，保持上下文连贯性
@@ -573,4 +311,4 @@ declare function searchPlugin(options: SearchPluginOptions): Promise<SearchPlugi
 /** 获取搜索插件实例（用于运行时控制） */
 declare function getSearchPlugin(): SearchPluginInstance | null;
 
-export { type BatchOperationResult as B, type ChunkOptions as C, DocumentSearch as D, type ExportInfo as E, FileType as F, type HealthCheckResult as H, type IndexProgress as I, type PipelineConfig as P, type SearchConfig as S, type TextChunk as T, type WatchOptions as W, type IndexedDocument as a, type IndexStats as b, type SearchOptions as c, type SearchResult as d, type WatchEvent as e, type BackupInfo as f, type IndexError as g, DEFAULT_CONFIG as h, createIndexingPipeline as i, IndexingPipeline as j, type PipelineStats as k, type SkipCheckCallback as l, getChunkStats as m, searchPlugin as n, getSearchPlugin as o, type SearchPluginOptions as p, type SearchPluginInstance as q, splitText as s };
+export { type ChunkOptions as C, DocumentSearch as D, IndexingPipeline as I, type PipelineConfig as P, type SkipCheckCallback as S, type TextChunk as T, type PipelineStats as a, searchPlugin as b, createIndexingPipeline as c, getSearchPlugin as d, type SearchPluginOptions as e, type SearchPluginInstance as f, getChunkStats as g, splitText as s };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { I as IndexProgress, F as FileType, a as IndexedDocument, b as IndexStats } from './index-B6UR8lRu.js';
-export { f as BackupInfo, B as BatchOperationResult, C as ChunkOptions, h as DEFAULT_CONFIG, D as DocumentSearch, E as ExportInfo, H as HealthCheckResult, g as IndexError, j as IndexingPipeline, P as PipelineConfig, k as PipelineStats, S as SearchConfig, c as SearchOptions, q as SearchPluginInstance, p as SearchPluginOptions, d as SearchResult, l as SkipCheckCallback, T as TextChunk, e as WatchEvent, W as WatchOptions, i as createIndexingPipeline, m as getChunkStats, o as getSearchPlugin, n as searchPlugin, s as splitText } from './index-B6UR8lRu.js';
+export { C as ChunkOptions, D as DocumentSearch, I as IndexingPipeline, P as PipelineConfig, a as PipelineStats, f as SearchPluginInstance, e as SearchPluginOptions, S as SkipCheckCallback, T as TextChunk, c as createIndexingPipeline, g as getChunkStats, d as getSearchPlugin, b as searchPlugin, s as splitText } from './index-BKiGwrBS.js';
+import { I as IndexProgress, F as FileType, a as IndexedDocument, b as IndexStats } from './types-D1U3F-Fs.js';
+export { f as BackupInfo, B as BatchOperationResult, D as DEFAULT_CONFIG, E as ExportInfo, H as HealthCheckResult, g as IndexError, S as SearchConfig, c as SearchOptions, d as SearchResult, e as WatchEvent, W as WatchOptions } from './types-D1U3F-Fs.js';
 export { SearchElectronBridge, SearchElectronBridgeOptions, createSearchElectronBridge } from './bridge/electron.js';
 export { Tool, ToolContext, ToolPlugin } from '@huyooo/ai-chat-core';
 import 'electron';

package/dist/index.js

@@ -1,7 +1,7 @@
 import {
   SearchElectronBridge,
   createSearchElectronBridge
-} from "./chunk-GAT4F5NK.js";
+} from "./chunk-MXWSYA4O.js";
 import {
   DEFAULT_CONFIG,
   DEFAULT_DIRECTORY_RULES,

package/dist/tools/index.d.ts

@@ -1,2 +1,3 @@
-export { q as SearchPluginInstance, p as SearchPluginOptions, o as getSearchPlugin, n as searchPlugin } from '../index-B6UR8lRu.js';
+export { f as SearchPluginInstance, e as SearchPluginOptions, d as getSearchPlugin, b as searchPlugin } from '../index-BKiGwrBS.js';
 export { SideEffect, Tool, ToolContext, ToolPlugin, ToolResult } from '@huyooo/ai-chat-core';
+import '../types-D1U3F-Fs.js';

package/dist/types-D1U3F-Fs.d.ts

@@ -0,0 +1,264 @@
+/**
+ * 文件类型（与 file-explorer 兼容）
+ */
+declare const FileType: {
+    readonly FOLDER: "folder";
+    readonly FILE: "file";
+    readonly IMAGE: "image";
+    readonly VIDEO: "video";
+    readonly MUSIC: "music";
+    readonly DOCUMENT: "document";
+    readonly CODE: "code";
+    readonly TEXT: "text";
+    readonly PDF: "pdf";
+    readonly ARCHIVE: "archive";
+    readonly APPLICATION: "application";
+    readonly UNKNOWN: "unknown";
+};
+type FileType = (typeof FileType)[keyof typeof FileType];
+/**
+ * 搜索结果（兼容 file-explorer 的 FileItem）
+ */
+interface SearchResult {
+    /** 唯一标识（文件路径） */
+    id: string;
+    /** 文件名 */
+    name: string;
+    /** 文件类型 */
+    type: FileType;
+    /** 格式化后的文件大小 */
+    size?: string;
+    /** 格式化后的修改日期 */
+    dateModified?: string;
+    /** 文件 URL */
+    url?: string;
+    /** 缩略图 URL（文档类型通常没有） */
+    thumbnailUrl?: string;
+    /** 相关度分数 0-1 */
+    score: number;
+    /** 匹配文本摘要 */
+    snippet?: string;
+    /** 匹配类型 */
+    matchType: 'semantic' | 'keyword' | 'hybrid';
+    /** 匹配的块索引（分块后可用） */
+    chunkIndex?: number;
+}
+/**
+ * 索引项（内部使用）
+ */
+interface IndexedDocument {
+    /** 唯一 ID */
+    id: string;
+    /** 文件路径 */
+    path: string;
+    /** 文件名 */
+    name: string;
+    /** 文件类型 */
+    fileType: FileType;
+    /** 文件扩展名 */
+    extension: string;
+    /** 文档标题（从内容提取） */
+    title?: string;
+    /** 文档内容（用于全文搜索） */
+    content: string;
+    /** 文件大小（字节） */
+    fileSize: number;
+    /** 创建时间 */
+    createdAt: Date;
+    /** 修改时间 */
+    modifiedAt: Date;
+    /** 索引时间 */
+    indexedAt: Date;
+    /** 内容哈希（用于检测变更） */
+    contentHash: string;
+    /** 分块数量（用于清理旧数据） */
+    chunkCount?: number;
+}
+/**
+ * 搜索配置
+ */
+interface SearchConfig {
+    /** 数据存储目录 */
+    dataDir: string;
+    /** 索引目录列表 */
+    indexDirectories?: string[];
+    /** 排除目录 */
+    excludeDirs?: string[];
+    /** 支持的扩展名 */
+    extensions?: string[];
+    /** 最大文件大小（字节） */
+    maxFileSize?: number;
+    /** Embedding 模型（默认 doubao-embedding-vision-250615） */
+    embeddingModel?: string;
+    /** 豆包 API Key（ARK_API_KEY），也可通过环境变量设置 */
+    arkApiKey?: string;
+    /** 向量维度（默认 1024） */
+    embeddingDimension?: number;
+    /** 并行索引并发数（默认 5） */
+    indexConcurrency?: number;
+    /** 是否启用并行索引（默认 true） */
+    enableParallelIndexing?: boolean;
+}
+/**
+ * 搜索选项
+ */
+interface SearchOptions {
+    /** 返回数量限制 */
+    limit?: number;
+    /** 文件类型过滤 */
+    fileTypes?: FileType[];
+    /** 时间范围过滤 */
+    dateRange?: {
+        start?: Date;
+        end?: Date;
+    };
+    /** 目录过滤 */
+    directories?: string[];
+    /** 搜索模式 */
+    mode?: 'semantic' | 'keyword' | 'hybrid';
+    /** 文件大小过滤 */
+    sizeRange?: {
+        min?: number;
+        max?: number;
+    };
+    /** 文件名模式过滤（支持通配符 * 和 ?） */
+    fileNamePattern?: string;
+    /** 文档标题包含 */
+    titleContains?: string;
+    /** 组合条件模式 */
+    combineMode?: 'AND' | 'OR';
+}
+/**
+ * 索引进度回调
+ */
+interface IndexProgress {
+    /** 当前已索引数量 */
+    indexed: number;
+    /** 总文件数量 */
+    total: number;
+    /** 当前正在处理的文件 */
+    currentFile?: string;
+    /** 阶段 */
+    stage: 'scanning' | 'parsing' | 'embedding' | 'storing' | 'done' | 'cancelled';
+}
+/**
+ * 索引统计
+ */
+interface IndexStats {
+    /** 总文档数 */
+    totalDocuments: number;
+    /** 按类型统计 */
+    byType: Record<FileType, number>;
+    /** 索引目录 */
+    directories: string[];
+    /** 最后更新时间 */
+    lastUpdated?: Date;
+    /** 索引大小（字节） */
+    indexSize: number;
+}
+/**
+ * 文件监听选项
+ */
+interface WatchOptions {
+    /** 是否忽略初始扫描（只监听后续变化） */
+    ignoreInitial?: boolean;
+    /** 防抖延迟（毫秒），避免频繁触发 */
+    debounce?: number;
+    /** 监听事件回调 */
+    onEvent?: (event: WatchEvent) => void;
+}
+/**
+ * 文件监听事件
+ */
+interface WatchEvent {
+    /** 事件类型 */
+    type: 'add' | 'change' | 'unlink' | 'unlinkDir';
+    /** 文件路径 */
+    path: string;
+    /** 时间戳 */
+    timestamp: Date;
+}
+/**
+ * 批量操作结果
+ */
+interface BatchOperationResult {
+    /** 成功数量 */
+    success: number;
+    /** 失败数量 */
+    failed: number;
+    /** 失败的文件路径和错误信息 */
+    errors: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+/**
+ * 索引导出信息
+ */
+interface ExportInfo {
+    /** 导出路径 */
+    exportPath: string;
+    /** 导出时间 */
+    timestamp: Date;
+    /** 包含的组件 */
+    components: {
+        meta: boolean;
+        vectors: boolean;
+        fulltext: boolean;
+    };
+    /** 统计信息 */
+    stats: IndexStats;
+}
+/**
+ * 备份信息
+ */
+interface BackupInfo {
+    /** 备份路径 */
+    path: string;
+    /** 备份时间 */
+    timestamp: Date;
+    /** 备份大小（字节） */
+    size: number;
+}
+/**
+ * 索引错误信息
+ */
+interface IndexError {
+    /** 文件路径 */
+    filePath: string;
+    /** 错误信息 */
+    error: string;
+    /** 重试次数 */
+    retryCount: number;
+    /** 时间戳 */
+    timestamp: Date;
+}
+/**
+ * 健康检查结果
+ */
+interface HealthCheckResult {
+    /** 是否健康 */
+    healthy: boolean;
+    /** 总文档数 */
+    totalDocuments: number;
+    /** 无效索引数（文件不存在） */
+    invalidIndexes: number;
+    /** 过期索引数（文件已修改） */
+    staleIndexes: number;
+    /** 错误数 */
+    errorCount: number;
+    /** 索引完整性 */
+    integrity: {
+        meta: boolean;
+        vectors: boolean;
+        fulltext: boolean;
+    };
+}
+/**
+ * 默认配置
+ * 注意：详细的排除规则和文件类型规则现在由 rules.ts 中的规则管理器统一管理
+ * 这里的配置主要用于向后兼容和简单配置场景
+ */
+declare const DEFAULT_CONFIG: Partial<SearchConfig>;
+
+export { type BatchOperationResult as B, DEFAULT_CONFIG as D, type ExportInfo as E, FileType as F, type HealthCheckResult as H, type IndexProgress as I, type SearchConfig as S, type WatchOptions as W, type IndexedDocument as a, type IndexStats as b, type SearchOptions as c, type SearchResult as d, type WatchEvent as e, type BackupInfo as f, type IndexError as g };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huyooo/ai-search",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "本地文档语义搜索引擎 - 支持 Word、PDF、Excel、TXT、MD",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,6 +23,12 @@
       "development": "./src/bridge/electron.ts",
       "import": "./dist/bridge/electron.js",
       "default": "./dist/bridge/electron.js"
+    },
+    "./bridge/renderer": {
+      "types": "./dist/bridge/renderer.d.ts",
+      "development": "./src/bridge/renderer.ts",
+      "import": "./dist/bridge/renderer.js",
+      "default": "./dist/bridge/renderer.js"
     }
   },
   "files": [

package/dist/chunk-GAT4F5NK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/bridge/electron.ts"],"sourcesContent":["/**\n * Electron 桥接模块\n * \n * 使用全局进度监听器自动广播索引进度\n * 无需包装方法，无需轮询，解决时序问题\n */\n\nimport type { IpcMain, WebContents } from 'electron';\nimport { getSearchPlugin } from '../tools';\nimport { addGlobalProgressListener } from '../core/progress';\nimport type { IndexProgress } from '../types';\n\n// 扩展的索引进度类型，支持取消和错误状态\ntype ExtendedIndexProgress = IndexProgress | {\n  indexed: number;\n  total: number;\n  currentFile?: string;\n  stage: 'cancelled' | 'error';\n  error?: string;\n};\n\n/** Electron 桥接选项 */\nexport interface SearchElectronBridgeOptions {\n  /** IPC channel 前缀 */\n  channelPrefix?: string;\n  /** IPC Main 实例 */\n  ipcMain: IpcMain;\n}\n\n/** 索引进度广播系统 */\nexport class SearchElectronBridge {\n  private channelPrefix: string;\n  private ipcMain: IpcMain;\n  private indexingListeners = new Set<WebContents>();\n  private lastProgress: ExtendedIndexProgress | null = null;\n  private isIndexing = false;\n\n  constructor(options: SearchElectronBridgeOptions) {\n    this.channelPrefix = options.channelPrefix || 'ai-chat';\n    this.ipcMain = options.ipcMain;\n  }\n\n  /** 初始化桥接（注册 IPC handlers 和全局进度监听器） */\n  init(): void {\n    this.registerIpcHandlers();\n    this.registerGlobalProgressListener();\n    console.log('[AI-Search] Electron 桥接已初始化');\n  }\n\n  /** 注册全局进度监听器 */\n  private registerGlobalProgressListener(): void {\n    // 注册全局进度监听器，所有 indexDirectory 调用都会触发\n    addGlobalProgressListener((progress: IndexProgress) => {\n      // 更新状态\n      this.isIndexing = progress.stage !== 'done';\n      this.lastProgress = progress;\n      \n      // 广播进度到所有前端监听器\n      this.broadcastIndexProgress(progress);\n    });\n  }\n\n  /** 注册 IPC handlers */\n  private registerIpcHandlers(): void {\n    // 注册索引进度监听器（前端调用）\n    this.ipcMain.handle(`${this.channelPrefix}:index:registerListener`, (event) => {\n      const webContents = event.sender;\n      this.indexingListeners.add(webContents);\n      \n      // 如果正在索引，立即发送最后进度\n      if (this.lastProgress && this.isIndexing) {\n        if (!webContents.isDestroyed()) {\n          webContents.send(`${this.channelPrefix}:index:progress`, {\n            indexed: this.lastProgress.indexed,\n            total: this.lastProgress.total,\n            currentFile: this.lastProgress.currentFile,\n            stage: this.lastProgress.stage,\n          });\n        }\n      }\n      \n      return { success: true };\n    });\n\n    // 注销索引进度监听器（前端调用）\n    this.ipcMain.handle(`${this.channelPrefix}:index:unregisterListener`, (event) => {\n      this.indexingListeners.delete(event.sender);\n      return { success: true };\n    });\n\n    // 获取索引统计信息\n    this.ipcMain.handle(`${this.channelPrefix}:index:getStats`, async () => {\n      try {\n        const searchPlugin = getSearchPlugin();\n        \n        if (!searchPlugin) {\n          return {\n            totalDocuments: 0,\n            indexSize: 0,\n            lastUpdated: null,\n          };\n        }\n        \n        const stats = searchPlugin.search.getStats();\n        return {\n          totalDocuments: stats.totalDocuments,\n          indexSize: stats.indexSize,\n          lastUpdated: stats.lastUpdated ? stats.lastUpdated.toISOString() : null,\n        };\n      } catch (error) {\n        console.error('[AI-Search] 获取索引统计失败:', error);\n        return {\n          totalDocuments: 0,\n          indexSize: 0,\n          lastUpdated: null,\n        };\n      }\n    });\n\n    // 同步索引（重新索引工作空间）\n    this.ipcMain.handle(`${this.channelPrefix}:index:sync`, async () => {\n      try {\n        const searchPlugin = getSearchPlugin();\n        \n        if (!searchPlugin) {\n          throw new Error('搜索插件未初始化');\n        }\n\n        const workspaceState = searchPlugin.getWorkspaceState();\n        if (!workspaceState.directory) {\n          throw new Error('工作空间未设置');\n        }\n\n        // 开始索引（进度会通过全局监听器自动广播）\n        await searchPlugin.search.indexDirectory(workspaceState.directory!);\n        \n        return { success: true };\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        console.error('[AI-Search] 同步索引失败:', errorMessage);\n        \n        // 广播错误状态\n        this.broadcastIndexProgress({\n          indexed: 0,\n          total: 0,\n          stage: 'error',\n          error: errorMessage,\n        });\n        \n        throw error;\n      }\n    });\n\n    // 检查索引状态\n    this.ipcMain.handle(`${this.channelPrefix}:index:status`, async () => {\n      return {\n        isIndexing: this.isIndexing,\n        lastProgress: this.lastProgress,\n      };\n    });\n\n    // 取消索引\n    this.ipcMain.handle(`${this.channelPrefix}:index:cancel`, async () => {\n      try {\n        const searchPlugin = getSearchPlugin();\n        \n        if (!searchPlugin) {\n          return { success: false, message: '搜索插件未初始化' };\n        }\n\n        const cancelled = searchPlugin.search.cancelIndexing();\n        \n        if (cancelled) {\n          // 广播取消状态\n          this.broadcastIndexProgress({\n            indexed: this.lastProgress?.indexed || 0,\n            total: this.lastProgress?.total || 0,\n            stage: 'cancelled',\n          });\n          this.isIndexing = false;\n          return { success: true };\n        } else {\n          return { success: false, message: '没有正在运行的索引任务' };\n        }\n      } catch (error) {\n        console.error('[AI-Search] 取消索引失败:', error);\n        return { success: false, message: String(error) };\n      }\n    });\n\n    // 删除索引\n    this.ipcMain.handle(`${this.channelPrefix}:index:delete`, async () => {\n      try {\n        const searchPlugin = getSearchPlugin();\n        \n        if (!searchPlugin) {\n          throw new Error('搜索插件未初始化');\n        }\n\n        await searchPlugin.search.clear();\n        \n        // 重置状态\n        this.isIndexing = false;\n        this.lastProgress = null;\n        \n        // 广播清空状态（使用 done 阶段，indexed=0 表示已清空）\n        this.broadcastIndexProgress({\n          indexed: 0,\n          total: 0,\n          stage: 'done',\n        });\n        \n        return { success: true };\n      } catch (error) {\n        console.error('[AI-Search] 删除索引失败:', error);\n        throw error;\n      }\n    });\n  }\n\n  /** 广播索引进度到所有前端监听器 */\n  private broadcastIndexProgress(progress: ExtendedIndexProgress): void {\n    // 更新最后进度\n    this.lastProgress = progress;\n    \n    // 向所有监听器广播\n    this.indexingListeners.forEach((webContents) => {\n      if (!webContents.isDestroyed()) {\n        webContents.send(`${this.channelPrefix}:index:progress`, {\n          indexed: progress.indexed,\n          total: progress.total,\n          currentFile: progress.currentFile,\n          stage: progress.stage,\n        });\n      } else {\n        // 清理已销毁的 webContents\n        this.indexingListeners.delete(webContents);\n      }\n    });\n  }\n}\n\n/**\n * 创建搜索 Electron 桥接\n * \n * @example\n * ```typescript\n * import { createSearchElectronBridge } from '@huyooo/ai-search/bridge/electron';\n * import { ipcMain } from 'electron';\n * \n * const bridge = createSearchElectronBridge({\n *   ipcMain,\n *   channelPrefix: 'ai-chat',\n * });\n * bridge.init();\n * ```\n */\nexport function createSearchElectronBridge(\n  options: SearchElectronBridgeOptions\n): SearchElectronBridge {\n  return new SearchElectronBridge(options);\n}\n"],"mappings":"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","names":[]}