@huyooo/ai-chat-bridge-electron 0.1.6 → 0.2.0

package/dist/renderer/index.d.cts

@@ -18,13 +18,15 @@ interface SendMessageParams {
     };
 }
 /** 模型配置 */
-interface ModelConfig$1 {
-    provider: string;
-    model: string;
+interface ModelOption$1 {
+    modelId: string;
     displayName: string;
-    supportsTools: boolean;
-    supportsWebSearch: boolean;
-    supportedThinkingModes: string[];
+    /** 分组名称（由后端决定，前端只负责渲染，必填） */
+    group: string;
+    /** 是否来自 OpenRouter（保留用于兼容，后续可能移除） */
+    isOpenRouter?: boolean;
+    /** 提供商名称（保留用于兼容，后续可能移除） */
+    provider?: string;
 }
 /** 会话记录 */
 interface SessionRecord$1 {
@@ -34,6 +36,10 @@ interface SessionRecord$1 {
     title: string;
     model: string;
     mode: 'agent' | 'plan' | 'ask';
+    webSearchEnabled: boolean;
+    thinkingEnabled: boolean;
+    /** 是否在 tab 栏隐藏（关闭但不删除） */
+    hidden: boolean;
     createdAt: Date;
     updatedAt: Date;
 }
@@ -43,9 +49,16 @@ interface MessageRecord$1 {
     sessionId: string;
     role: 'user' | 'assistant';
     content: string;
-    thinking?: string | null;
-    toolCalls?: string | null;
-    searchResults?: string | null;
+    /** 生成此消息时使用的模型 */
+    model?: string | null;
+    /** 生成此消息时使用的模式 (ask/agent) */
+    mode?: string | null;
+    /** 生成此消息时是否启用 web 搜索 */
+    webSearchEnabled?: boolean | null;
+    /** 生成此消息时是否启用深度思考 */
+    thinkingEnabled?: boolean | null;
+    /** 执行步骤列表 JSON */
+    steps?: string | null;
     operationIds?: string | null;
     timestamp: Date;
 }
@@ -69,19 +82,24 @@ interface TrashRecord$1 {
     deletedAt: Date;
     autoDeleteAt: Date;
 }
+/** 文件信息 */
+interface FileInfo$1 {
+    name: string;
+    path: string;
+    isDirectory: boolean;
+    size: number;
+    modifiedAt: Date;
+    extension: string;
+}
 interface AiChatBridge {
     /** 获取可用模型 */
-    getModels(): Promise<ModelConfig$1[]>;
+    getModels(): Promise<ModelOption$1[]>;
     /** 发送消息 */
     send(params: SendMessageParams): Promise<void>;
     /** 取消当前请求 */
     cancel(): Promise<void>;
-    /** 清空 Agent 内存历史 */
-    clearAgentHistory(): Promise<void>;
-    /** 获取 Agent 内存历史 */
-    getAgentHistory(): Promise<unknown[]>;
-    /** 设置工作目录 */
-    setWorkingDir(dir: string): Promise<void>;
+    /** 设置当前工作目录 */
+    setCwd(dir: string): Promise<void>;
     /** 获取配置 */
     getConfig(): Promise<unknown>;
     /** 监听进度事件 */
@@ -95,12 +113,18 @@ interface AiChatBridge {
         title?: string;
         model?: string;
         mode?: string;
+        webSearchEnabled?: boolean;
+        thinkingEnabled?: boolean;
+        hidden?: boolean;
     }): Promise<SessionRecord$1>;
     /** 更新会话 */
     updateSession(id: string, data: {
         title?: string;
         model?: string;
         mode?: string;
+        webSearchEnabled?: boolean;
+        thinkingEnabled?: boolean;
+        hidden?: boolean;
     }): Promise<SessionRecord$1 | null>;
     /** 删除会话 */
     deleteSession(id: string): Promise<{
@@ -110,14 +134,31 @@ interface AiChatBridge {
     getMessages(sessionId: string): Promise<MessageRecord$1[]>;
     /** 保存消息 */
     saveMessage(params: {
+        /** 消息 ID（可选，如果不传则自动生成） */
+        id?: string;
         sessionId: string;
         role: 'user' | 'assistant';
         content: string;
-        thinking?: string;
-        toolCalls?: string;
-        searchResults?: string;
+        /** 生成此消息时使用的模型 */
+        model?: string;
+        /** 生成此消息时使用的模式 (ask/agent) */
+        mode?: string;
+        /** 生成此消息时是否启用 web 搜索 */
+        webSearchEnabled?: boolean;
+        /** 生成此消息时是否启用深度思考 */
+        thinkingEnabled?: boolean;
+        /** 执行步骤列表 JSON */
+        steps?: string;
         operationIds?: string;
     }): Promise<MessageRecord$1>;
+    /** 更新消息（增量保存） */
+    updateMessage(params: {
+        id: string;
+        content?: string;
+        steps?: string;
+    }): Promise<{
+        success: boolean;
+    }>;
     /** 删除指定时间之后的消息（用于分叉） */
     deleteMessagesAfter(sessionId: string, timestamp: number): Promise<{
         success: boolean;
@@ -128,6 +169,98 @@ interface AiChatBridge {
     getTrashItems(): Promise<TrashRecord$1[]>;
     /** 恢复回收站项目 */
     restoreFromTrash(id: string): Promise<TrashRecord$1 | undefined>;
+    /** 在系统默认浏览器中打开链接 */
+    openExternal(url: string): Promise<void>;
+    /** 列出目录内容 */
+    listDir(dirPath: string): Promise<FileInfo$1[]>;
+    /** 检查路径是否存在 */
+    exists(filePath: string): Promise<boolean>;
+    /** 获取文件信息 */
+    stat(filePath: string): Promise<FileInfo$1 | null>;
+    /** 读取文件内容（文本） */
+    readFile(filePath: string): Promise<string | null>;
+    /** 读取文件为 base64 */
+    readFileBase64(filePath: string): Promise<string | null>;
+    /** 获取用户主目录 */
+    homeDir(): Promise<string>;
+    /** 解析路径（处理 ~） */
+    resolvePath(inputPath: string): Promise<string>;
+    /** 获取父目录 */
+    parentDir(dirPath: string): Promise<string>;
+    /** 监听目录变化 */
+    watchDir(dirPath: string): Promise<boolean>;
+    /** 停止监听目录 */
+    unwatchDir(dirPath: string): Promise<void>;
+    /** 监听目录变化事件 */
+    onDirChange(callback: (data: {
+        dirPath: string;
+        eventType: string;
+        filename: string | null;
+    }) => void): () => void;
+    /** 获取用户设置 */
+    getSetting(key: string): Promise<string | null>;
+    /** 设置用户设置 */
+    setSetting(key: string, value: string): Promise<{
+        success: boolean;
+    }>;
+    /** 获取所有用户设置 */
+    getAllSettings(): Promise<Record<string, string>>;
+    /** 删除用户设置 */
+    deleteSetting(key: string): Promise<{
+        success: boolean;
+    }>;
+    /** 获取索引统计信息 */
+    getIndexStats(): Promise<{
+        totalDocuments: number;
+        indexSize: number;
+        lastUpdated: string | null;
+    }>;
+    /** 检查索引状态 */
+    getIndexStatus(): Promise<{
+        isIndexing: boolean;
+        lastProgress: {
+            indexed: number;
+            total: number;
+            currentFile?: string;
+            stage: string;
+        } | null;
+    }>;
+    /** 同步索引（重新索引工作空间） */
+    syncIndex(): Promise<{
+        success: boolean;
+    }>;
+    /** 取消索引 */
+    cancelIndex(): Promise<{
+        success: boolean;
+    }>;
+    /** 删除索引 */
+    deleteIndex(): Promise<{
+        success: boolean;
+    }>;
+    /** 注册索引进度监听器 */
+    registerIndexListener(): Promise<{
+        success: boolean;
+    }>;
+    /** 注销索引进度监听器 */
+    unregisterIndexListener(): Promise<{
+        success: boolean;
+    }>;
+    /** 监听索引进度 */
+    onIndexProgress(callback: (progress: {
+        indexed: number;
+        total: number;
+        currentFile?: string;
+        stage: string;
+        error?: string;
+    }) => void): () => void;
+    /** 监听工具批准请求（manual 模式） */
+    onToolApprovalRequest(callback: (request: {
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+    }) => void): () => void;
+    /** 响应工具批准请求 */
+    respondToolApproval(id: string, approved: boolean): Promise<void>;
 }
 
 /**
@@ -136,29 +269,54 @@ interface AiChatBridge {
  * 在渲染进程中使用，创建 ChatAdapter
  */
 
-type ChatProgressType = 'thinking' | 'search_start' | 'search_result' | 'tool_call' | 'tool_result' | 'text' | 'text_delta' | 'image' | 'video' | 'done' | 'error';
-interface ChatProgress {
-    type: ChatProgressType;
+type ChatEventType = 'thinking_start' | 'thinking_delta' | 'thinking_end' | 'search_start' | 'search_result' | 'search_end' | 'tool_approval_request' | 'tool_call_start' | 'tool_call_result' | 'text_delta' | 'image' | 'video' | 'stream_start' | 'done' | 'error' | 'abort' | 'step_start' | 'step_end';
+interface ChatEvent {
+    type: ChatEventType;
     data: unknown;
 }
 type ChatMode = 'agent' | 'plan' | 'ask';
-type ModelProvider = 'doubao' | 'deepseek' | 'openrouter' | 'qwen' | 'gemini' | 'ark' | 'anthropic' | 'openai';
+type ProviderType = 'ark' | 'qwen' | 'gemini' | 'openrouter';
 type ThinkingMode = 'enabled' | 'disabled';
+type AutoRunMode = 'run-everything' | 'manual';
+interface AutoRunConfig {
+    /**
+     * 自动运行模式
+     * - 'run-everything': 运行所有内容（自动执行）
+     * - 'manual': 手动批准（每次执行前询问）
+     */
+    mode?: AutoRunMode;
+}
+/** 聊天历史消息（无状态架构） */
+interface ChatHistoryMessage {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+}
 interface ChatOptions {
     mode?: ChatMode;
     model?: string;
-    provider?: ModelProvider;
+    provider?: ProviderType;
     enableWebSearch?: boolean;
+    /** 深度思考开关（每个 provider 内部使用最优参数） */
     thinkingMode?: ThinkingMode;
-    thinkingBudget?: number;
+    /** 自动运行配置 */
+    autoRunConfig?: AutoRunConfig;
+    /** 对话历史（无状态架构，历史从前端传入） */
+    history?: ChatHistoryMessage[];
 }
-interface ModelConfig {
-    provider: ModelProvider;
-    model: string;
+/**
+ * 简化的模型配置
+ */
+interface ModelOption {
+    /** 模型 ID（发送给 API） */
+    modelId: string;
+    /** 显示名称 */
     displayName: string;
-    supportsTools: boolean;
-    supportsWebSearch: boolean;
-    supportedThinkingModes: ThinkingMode[];
+    /** 分组名称（由后端决定，前端只负责渲染，必填） */
+    group: string;
+    /** 是否来自 OpenRouter（保留用于兼容，后续可能移除） */
+    isOpenRouter?: boolean;
+    /** 提供商名称（保留用于兼容，后续可能移除） */
+    provider?: string;
 }
 interface SessionRecord {
     id: string;
@@ -167,6 +325,10 @@ interface SessionRecord {
     title: string;
     model: string;
     mode: ChatMode;
+    webSearchEnabled: boolean;
+    thinkingEnabled: boolean;
+    /** 是否在 tab 栏隐藏（关闭但不删除） */
+    hidden: boolean;
     createdAt: Date;
     updatedAt: Date;
 }
@@ -175,9 +337,16 @@ interface MessageRecord {
     sessionId: string;
     role: 'user' | 'assistant';
     content: string;
-    thinking?: string | null;
-    toolCalls?: string | null;
-    searchResults?: string | null;
+    /** 生成此消息时使用的模型 */
+    model?: string | null;
+    /** 生成此消息时使用的模式 (ask/agent) */
+    mode?: string | null;
+    /** 生成此消息时是否启用 web 搜索 */
+    webSearchEnabled?: boolean | null;
+    /** 生成此消息时是否启用深度思考 */
+    thinkingEnabled?: boolean | null;
+    /** 执行步骤列表 JSON */
+    steps?: string | null;
     operationIds?: string | null;
     timestamp: Date;
 }
@@ -199,19 +368,23 @@ interface TrashRecord {
     deletedAt: Date;
     autoDeleteAt: Date;
 }
+interface FileInfo {
+    name: string;
+    path: string;
+    isDirectory: boolean;
+    size: number;
+    modifiedAt: Date;
+    extension: string;
+}
 interface ChatAdapter {
     /** 获取可用模型 */
-    getModels(): Promise<ModelConfig[]>;
+    getModels(): Promise<ModelOption[]>;
     /** 发送消息，返回异步迭代器 */
-    sendMessage(message: string, options?: ChatOptions, images?: string[]): AsyncIterable<ChatProgress>;
+    sendMessage(message: string, options?: ChatOptions, images?: string[], sessionId?: string): AsyncIterable<ChatEvent>;
     /** 取消当前请求 */
     cancel(): void;
-    /** 清空 Agent 内存历史 */
-    clearAgentHistory?(): void;
-    /** 获取 Agent 内存历史 */
-    getAgentHistory?(): Promise<unknown[]>;
-    /** 设置工作目录 */
-    setWorkingDir?(dir: string): void;
+    /** 设置当前工作目录 */
+    setCwd?(dir: string): void;
     /** 获取会话列表 */
     getSessions(): Promise<SessionRecord[]>;
     /** 获取单个会话 */
@@ -221,12 +394,18 @@ interface ChatAdapter {
         title?: string;
         model?: string;
         mode?: string;
+        webSearchEnabled?: boolean;
+        thinkingEnabled?: boolean;
+        hidden?: boolean;
     }): Promise<SessionRecord>;
     /** 更新会话 */
     updateSession(id: string, data: {
         title?: string;
         model?: string;
         mode?: string;
+        webSearchEnabled?: boolean;
+        thinkingEnabled?: boolean;
+        hidden?: boolean;
     }): Promise<SessionRecord | null>;
     /** 删除会话 */
     deleteSession(id: string): Promise<void>;
@@ -234,14 +413,29 @@ interface ChatAdapter {
     getMessages(sessionId: string): Promise<MessageRecord[]>;
     /** 保存消息 */
     saveMessage(params: {
+        /** 消息 ID（可选，如果不传则自动生成） */
+        id?: string;
         sessionId: string;
         role: 'user' | 'assistant';
         content: string;
-        thinking?: string;
-        toolCalls?: string;
-        searchResults?: string;
+        /** 生成此消息时使用的模型 */
+        model?: string;
+        /** 生成此消息时使用的模式 (ask/agent) */
+        mode?: string;
+        /** 生成此消息时是否启用 web 搜索 */
+        webSearchEnabled?: boolean;
+        /** 生成此消息时是否启用深度思考 */
+        thinkingEnabled?: boolean;
+        /** 执行步骤列表 JSON */
+        steps?: string;
         operationIds?: string;
     }): Promise<MessageRecord>;
+    /** 更新消息（增量保存） */
+    updateMessage(params: {
+        id: string;
+        content?: string;
+        steps?: string;
+    }): Promise<void>;
     /** 删除指定时间之后的消息（用于分叉） */
     deleteMessagesAfter(sessionId: string, timestamp: number): Promise<void>;
     /** 获取操作日志 */
@@ -250,6 +444,48 @@ interface ChatAdapter {
     getTrashItems(): Promise<TrashRecord[]>;
     /** 恢复回收站项目 */
     restoreFromTrash(id: string): Promise<TrashRecord | undefined>;
+    /** 列出目录内容 */
+    listDir?(dirPath: string): Promise<FileInfo[]>;
+    /** 检查路径是否存在 */
+    exists?(filePath: string): Promise<boolean>;
+    /** 获取文件信息 */
+    stat?(filePath: string): Promise<FileInfo | null>;
+    /** 读取文件内容（文本） */
+    readFile?(filePath: string): Promise<string | null>;
+    /** 读取文件为 base64 */
+    readFileBase64?(filePath: string): Promise<string | null>;
+    /** 获取用户主目录 */
+    homeDir?(): Promise<string>;
+    /** 解析路径（处理 ~） */
+    resolvePath?(inputPath: string): Promise<string>;
+    /** 获取父目录 */
+    parentDir?(dirPath: string): Promise<string>;
+    /** 监听目录变化 */
+    watchDir?(dirPath: string): Promise<boolean>;
+    /** 停止监听目录 */
+    unwatchDir?(dirPath: string): Promise<void>;
+    /** 监听目录变化事件 */
+    onDirChange?(callback: (data: {
+        dirPath: string;
+        eventType: string;
+        filename: string | null;
+    }) => void): () => void;
+    /** 获取用户设置 */
+    getSetting?(key: string): Promise<string | null>;
+    /** 设置用户设置 */
+    setSetting?(key: string, value: string): Promise<void>;
+    /** 获取所有用户设置 */
+    getAllSettings?(): Promise<Record<string, string>>;
+    /** 删除用户设置 */
+    deleteSetting?(key: string): Promise<void>;
+    /** 监听工具批准请求（manual 模式） */
+    onToolApprovalRequest?(callback: (request: {
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+    }) => void): () => void;
+    /** 响应工具批准请求 */
+    respondToolApproval?(id: string, approved: boolean): Promise<void>;
 }
 declare global {
     interface Window {
@@ -265,4 +501,4 @@ interface CreateAdapterOptions {
  */
 declare function createElectronAdapter(options?: CreateAdapterOptions): ChatAdapter;
 
-export { type ChatAdapter, type ChatMode, type ChatOptions, type ChatProgress, type ChatProgressType, type CreateAdapterOptions, type MessageRecord, type ModelConfig, type ModelProvider, type OperationRecord, type SessionRecord, type ThinkingMode, type TrashRecord, createElectronAdapter };
+export { type AutoRunConfig, type AutoRunMode, type ChatAdapter, type ChatEvent, type ChatEventType, type ChatHistoryMessage, type ChatMode, type ChatOptions, type CreateAdapterOptions, type FileInfo, type MessageRecord, type ModelOption, type OperationRecord, type ProviderType, type SessionRecord, type ThinkingMode, type TrashRecord, createElectronAdapter };