feat: 添加 ExportCard 组件以导出聊天会话

功能：增强 MessageBubble，增加复制和分享功能

功能：实现 ShareModal，用于将消息以图片形式分享

重构：移除未使用的 AttachMenuItem 类型及相关代码

功能：扩展 useAgentChat 钩子以支持导出会话

功能：添加 CardBlock 类型以支持导出向导功能

修复：更新 ElectronAPI 类型以包含用于本地消息处理的新方法

Author: ILoveBingLu

electron/main/ipc/agentHandlers.ts

@@ -737,6 +737,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
       model: string
       enableThinking?: boolean
       systemPrompt?: string
+      commandHint?: string
+      readLimit?: number
       enabledTools?: Array<{ type: string; function: { name: string; description?: string; parameters?: Record<string, unknown> } }>
       scopedSessions?: Array<{ id: string; name: string }>
     }) => ipcRenderer.invoke('agent:sendMessage', opts),
@@ -751,8 +753,19 @@ contextBridge.exposeInMainWorld('electronAPI', {
 
     newConversation: () => ipcRenderer.invoke('agent:newConversation'),
 
+    appendLocalMessages: (opts: {
+      conversationId?: number
+      messages: Array<{
+        role: 'user' | 'assistant'
+        content?: string
+        blocks?: unknown[]
+      }>
+    }) => ipcRenderer.invoke('agent:appendLocalMessages', opts),
+
     updateTitle: (id: number, title: string) => ipcRenderer.invoke('agent:updateTitle', id, title),
 
+    getLastConversationId: () => ipcRenderer.invoke('agent:getLastConversationId'),
+
     generateTitle: (opts: {
       conversationId: number
       userMessage: string

electron/preload.ts

@@ -11,6 +11,21 @@ export type BuiltinToolDef = {
 }
 
 export const BUILTIN_TOOL_SCHEMAS: BuiltinToolDef[] = [
+  {
+    type: 'function',
+    function: {
+      name: 'ct_initiate_export',
+      description: '初始化聊天记录导出工作流。在通过 ct_list_sessions 确认目标会话后调用此工具，系统将展示一个交互式导出确认卡片供用户选择格式并执行导出。每次导出流程只需调用一次。',
+      parameters: {
+        type: 'object',
+        properties: {
+          sessionId: { type: 'string', description: '目标会话的 sessionId（从 ct_list_sessions 获取）' },
+          sessionName: { type: 'string', description: '目标会话的显示名称' }
+        },
+        required: ['sessionId', 'sessionName']
+      }
+    }
+  },
   {
     type: 'function',
     function: {
@@ -19,7 +34,7 @@ export const BUILTIN_TOOL_SCHEMAS: BuiltinToolDef[] = [
       parameters: {
         type: 'object',
         properties: {
-          limit: { type: 'number', description: '返回数量，默认 20，最多 100' }
+          limit: { type: 'number', description: '返回数量，默认 20，上限由用户在输入框设定' }
         }
       }
     }
@@ -32,7 +47,7 @@ export const BUILTIN_TOOL_SCHEMAS: BuiltinToolDef[] = [
       parameters: {
         type: 'object',
         properties: {
-          limit: { type: 'number', description: '返回数量，默认 30，最多 200' }
+          limit: { type: 'number', description: '返回数量，默认 30，上限由用户在输入框设定' }
         }
       }
     }
@@ -47,7 +62,7 @@ export const BUILTIN_TOOL_SCHEMAS: BuiltinToolDef[] = [
         properties: {
           keyword: { type: 'string', description: '搜索关键词' },
           sessionId: { type: 'string', description: '（可选）限定搜索的会话 sessionId，不填则跨多个最近会话搜索' },
-          limit: { type: 'number', description: '返回结果数，默认 20，最多 50' }
+          limit: { type: 'number', description: '返回结果数，默认 20，上限由用户在输入框设定' }
         },
         required: ['keyword']
       }
@@ -62,12 +77,30 @@ export const BUILTIN_TOOL_SCHEMAS: BuiltinToolDef[] = [
         type: 'object',
         properties: {
           sessionId: { type: 'string', description: '会话的 sessionId（从 ct_list_sessions 获取）' },
-          limit: { type: 'number', description: '返回消息数量，默认 15，最多 50' }
+          limit: { type: 'number', description: '返回消息数量，默认 15，上限由用户在输入框设定' }
         },
         required: ['sessionId']
       }
     }
   },
+  {
+    type: 'function',
+    function: {
+      name: 'ct_get_moments',
+      description: '获取微信朋友圈时间线。可按时间范围、关键词、发布者过滤。返回动态列表，含作者、时间、内容文字、点赞数和评论摘要。',
+      parameters: {
+        type: 'object',
+        properties: {
+          limit: { type: 'number', description: '返回条数，默认 20，上限由读取条数设定' },
+          offset: { type: 'number', description: '分页偏移量，默认 0' },
+          keyword: { type: 'string', description: '（可选）按内容关键词过滤' },
+          usernames: { type: 'array', items: { type: 'string' }, description: '（可选）按发布者微信 ID 过滤' },
+          startTime: { type: 'number', description: '（可选）起始时间戳（Unix 秒）' },
+          endTime: { type: 'number', description: '（可选）结束时间戳（Unix 秒）' }
+        }
+      }
+    }
+  },
   {
     type: 'function',
     function: {
@@ -81,7 +114,7 @@ export const BUILTIN_TOOL_SCHEMAS: BuiltinToolDef[] = [
           sender: { type: 'string', description: '（可选）按发送人过滤，模糊匹配用户名，填 "我" 则只看自己发的消息' },
           startTime: { type: 'number', description: '（可选）起始时间戳（Unix 秒），配合 endTime 限定时间范围，可查任意历史区间' },
           endTime: { type: 'number', description: '（可选）结束时间戳（Unix 秒），不填则到最新消息' },
-          limit: { type: 'number', description: '返回结果数，默认 20，最多 50' },
+          limit: { type: 'number', description: '返回结果数，默认 20，上限由用户在输入框设定' },
           caseInsensitive: { type: 'boolean', description: '是否忽略大小写，默认 true' }
         },
         required: ['pattern']
@@ -136,11 +169,20 @@ async function searchOneSession(
   }))
 }
 
-export async function executeBuiltinTool(toolName: string, args: Record<string, unknown>): Promise<unknown> {
+export async function executeBuiltinTool(toolName: string, args: Record<string, unknown>, context?: { readLimit?: number }): Promise<unknown> {
   const { chatService } = await import('./chatService')
+  const userReadLimit = context?.readLimit ?? 50
+
+  if (toolName === 'ct_initiate_export') {
+    const sessionId = String(args.sessionId || '')
+    const sessionName = String(args.sessionName || '')
+    if (!sessionId) return { error: '缺少 sessionId 参数' }
+    // 返回结构化标记，useAgentChat 的 onDone 检测到后注入 CardBlock
+    return { __ct_card: 'export-wizard', sessionId, sessionName, message: `已准备好「${sessionName}」的导出确认卡片。` }
+  }
 
   if (toolName === 'ct_list_sessions') {
-    const limit = Math.min(100, Math.max(1, Number(args.limit) || 10))
+    const limit = Math.min(userReadLimit, Math.max(1, Number(args.limit) || Math.min(20, userReadLimit)))
     const result = await chatService.getSessions(0, limit)
     if (!result.success) return { error: result.error }
     return (result.sessions || []).map(s => ({
@@ -152,7 +194,7 @@ export async function executeBuiltinTool(toolName: string, args: Record<string,
   }
 
   if (toolName === 'ct_list_contacts') {
-    const limit = Math.min(200, Math.max(1, Number(args.limit) || 30))
+    const limit = Math.min(userReadLimit, Math.max(1, Number(args.limit) || Math.min(30, userReadLimit)))
     const result = await chatService.getContacts()
     if (!result.success) return { error: result.error }
     return (result.contacts || []).slice(0, limit).map(c => ({
@@ -166,7 +208,7 @@ export async function executeBuiltinTool(toolName: string, args: Record<string,
   if (toolName === 'ct_search_messages') {
     const keyword = String(args.keyword || '')
     if (!keyword) return { error: '缺少 keyword 参数' }
-    const limit = Math.min(50, Math.max(1, Number(args.limit) || 20))
+    const limit = Math.min(userReadLimit, Math.max(1, Number(args.limit) || Math.min(20, userReadLimit)))
     const { agentRetriever } = await import('./ai-agent/qa/data/retriever')
     const { chatSearchIndexService } = await import('./search/chatSearchIndexService')
     const sessionId = args.sessionId ? String(args.sessionId) : undefined
@@ -175,17 +217,43 @@ export async function executeBuiltinTool(toolName: string, args: Record<string,
       return searchOneSession(agentRetriever, chatSearchIndexService, sessionId, undefined, keyword, limit)
     }
 
-    // 跨会话搜索：取前 10 个最近会话，每个最多 3 条，按 score 全局排序后取 top limit
-    const sessionsResult = await chatService.getSessions(0, 10)
+    // 全量跨会话搜索：取全部会话（上限 1000），分批并行，每批 20 个
+    const sessionsResult = await chatService.getSessions(0, 1000)
     const sessions = sessionsResult.sessions || []
     const allHits: SearchHitRow[] = []
-    for (const s of sessions) {
-      const hits = await searchOneSession(
-        agentRetriever, chatSearchIndexService,
-        s.username, s.displayName || s.username,
-        keyword, 3
+    const BATCH = 20
+    const PER_SESSION = 3
+    const kw = keyword.toLowerCase()
+    for (let i = 0; i < sessions.length; i += BATCH) {
+      const batch = sessions.slice(i, i + BATCH)
+      const batchHits = await Promise.all(
+        batch.map(async s => {
+          const state = chatSearchIndexService.getSessionVectorIndexState(s.username)
+          if (state.indexedCount === 0) {
+            // 未建 FTS 索引：降级为扫描最近 200 条消息做关键词匹配
+            const r = await chatService.getMessages(s.username, 0, 200)
+            if (!r.success) return []
+            return (r.messages || [])
+              .filter((m: any) => (m.parsedContent || '').toLowerCase().includes(kw))
+              .slice(0, PER_SESSION)
+              .map((m: any): SearchHitRow => ({
+                sessionId: s.username,
+                sessionName: s.displayName || s.username,
+                text: m.parsedContent || '',
+                sender: m.isSend === 1 ? '我' : (m.senderUsername || '对方'),
+                time: m.createTime,
+                score: 0.5,
+                source: 'scan'
+              }))
+          }
+          return searchOneSession(
+            agentRetriever, chatSearchIndexService,
+            s.username, s.displayName || s.username,
+            keyword, PER_SESSION
+          )
+        })
       )
-      allHits.push(...hits)
+      allHits.push(...batchHits.flat())
     }
     allHits.sort((a, b) => b.score - a.score)
     return allHits.slice(0, limit)
@@ -194,7 +262,7 @@ export async function executeBuiltinTool(toolName: string, args: Record<string,
   if (toolName === 'ct_get_recent_messages') {
     const sessionId = String(args.sessionId || '')
     if (!sessionId) return { error: '缺少 sessionId 参数' }
-    const limit = Math.min(50, Math.max(1, Number(args.limit) || 15))
+    const limit = Math.min(userReadLimit, Math.max(1, Number(args.limit) || Math.min(15, userReadLimit)))
     const result = await chatService.getMessages(sessionId, 0, limit)
     if (!result.success) return { error: result.error }
     return (result.messages || []).map(m => {
@@ -207,6 +275,32 @@ export async function executeBuiltinTool(toolName: string, args: Record<string,
     })
   }
 
+  if (toolName === 'ct_get_moments') {
+    const limit = Math.min(userReadLimit, Math.max(1, Number(args.limit) || Math.min(20, userReadLimit)))
+    const offset = Math.max(0, Number(args.offset) || 0)
+    const keyword = args.keyword ? String(args.keyword) : undefined
+    const usernames = Array.isArray(args.usernames) ? (args.usernames as unknown[]).map(String) : undefined
+    const startTime = args.startTime ? Number(args.startTime) : undefined
+    const endTime = args.endTime ? Number(args.endTime) : undefined
+
+    const { snsService } = await import('./snsService')
+    const result = await snsService.getTimeline(limit, offset, usernames, keyword, startTime, endTime)
+    if (!result.success) return { error: result.error || '获取朋友圈失败，请确认朋友圈数据库已加载' }
+
+    return (result.timeline || []).map(post => ({
+      id: post.id,
+      author: post.nickname || post.username,
+      time: post.createTime,
+      text: (post.contentDesc || '').slice(0, 500),
+      mediaCount: post.media?.length || 0,
+      likeCount: post.likes?.length || 0,
+      comments: (post.comments || []).slice(0, 5).map(c => ({
+        author: c.nickname,
+        text: c.content,
+      })),
+    }))
+  }
+
   if (toolName === 'ct_grep_messages') {
     const pattern = String(args.pattern || '')
     if (!pattern) return { error: '缺少 pattern 参数' }
@@ -218,7 +312,7 @@ export async function executeBuiltinTool(toolName: string, args: Record<string,
       return { error: `无效的正则表达式: ${e instanceof Error ? e.message : String(e)}` }
     }
 
-    const limit = Math.min(50, Math.max(1, Number(args.limit) || 20))
+    const limit = Math.min(userReadLimit, Math.max(1, Number(args.limit) || Math.min(20, userReadLimit)))
     const sessionId = args.sessionId ? String(args.sessionId) : undefined
     const senderFilter = args.sender ? String(args.sender).toLowerCase() : undefined
     const startTime = args.startTime ? Number(args.startTime) : undefined

electron/services/agentBuiltinTools.ts

@@ -132,6 +132,13 @@ class AgentConversationDb {
   updateTitle(id: number, title: string): void {
     this.getDb().prepare('UPDATE agent_conversations SET title = ? WHERE id = ?').run(title, id)
   }
+
+  hasConversation(id: number): boolean {
+    const row = this.getDb()
+      .prepare('SELECT 1 as ok FROM agent_conversations WHERE id = ? LIMIT 1')
+      .get(id) as { ok?: number } | undefined
+    return Boolean(row?.ok)
+  }
 }
 
 export const agentConversationDb = new AgentConversationDb()

electron/services/agentConversationDb.ts

@@ -42,6 +42,7 @@ interface ConfigSchema {
   cachePath: string
   lastOpenedDb: string
   lastSession: string
+  lastAgentConversationId: number
 
   // 导出相关
   exportPath: string
@@ -109,6 +110,7 @@ interface ConfigSchema {
   aiEnableCache: boolean
   aiEnableThinking: boolean  // 是否显示思考过程
   aiMessageLimit: number     // 摘要提取的消息条数限制
+  agentReadLimit: number     // Agent 内置工具单次读取消息条数上限（500-2000）
   aiAgentDecisionMaxTokens: number // 会话问答 Agent 每轮决策输出 token 上限
   aiAgentAnswerMaxTokens: number   // 会话问答最终回答输出 token 上限
   aiEmbeddingMode: 'local' | 'online'
@@ -148,6 +150,7 @@ const defaults: ConfigSchema = {
   cachePath: '',
   lastOpenedDb: '',
   lastSession: '',
+  lastAgentConversationId: 0,
   exportPath: '',
   theme: 'cloud-dancer',
   themeMode: 'light',
@@ -190,6 +193,7 @@ const defaults: ConfigSchema = {
   aiEnableCache: true,
   aiEnableThinking: true,  // 默认显示思考过程
   aiMessageLimit: 3000,    // 默认3000条，用户可调至5000
+  agentReadLimit: 500,     // 默认500条
   aiAgentDecisionMaxTokens: 2048,
   aiAgentAnswerMaxTokens: 8192,
   aiEmbeddingMode: 'local',

electron/services/config.ts

@@ -1,4 +1,5 @@
-import { useState, useEffect, useCallback } from 'react'
+import { useState, useEffect, useCallback, useRef } from 'react'
+import { useLocation } from 'react-router-dom'
 import { Search, Download, FolderOpen, RefreshCw, Check, FileJson, FileText, Table, Loader2, X, FileSpreadsheet, Database, FileCode, CheckCircle, XCircle, ExternalLink, MessageSquare, Users, User, Filter, Image, Video, CircleUserRound, Smile, Mic } from 'lucide-react'
 import DateRangePicker from '../components/DateRangePicker'
 import { useTitleBarStore } from '../stores/titleBarStore'
@@ -59,6 +60,8 @@ type SessionTypeFilter = 'all' | 'group' | 'private'
 function ExportPage() {
   const [activeTab, setActiveTab] = useState<ExportTab>('chat')
   const setTitleBarContent = useTitleBarStore(state => state.setRightContent)
+  const location = useLocation()
+  const preSelectAppliedRef = useRef(false)
 
   // 聊天导出状态
   const [sessions, setSessions] = useState<ChatSession[]>([])
@@ -195,13 +198,20 @@ function ExportPage() {
       if (sessionsResult.success && sessionsResult.sessions) {
         setSessions(sessionsResult.sessions)
         setFilteredSessions(sessionsResult.sessions)
+        if (!preSelectAppliedRef.current) {
+          const state = location.state as { preSelectedSessions?: string[] } | null
+          if (state?.preSelectedSessions?.length) {
+            preSelectAppliedRef.current = true
+            setSelectedSessions(new Set(state.preSelectedSessions))
+          }
+        }
       }
     } catch (e) {
       console.error('加载会话失败:', e)
     } finally {
       setIsLoading(false)
     }
-  }, [])
+  }, [location.state])
 
   // 加载通讯录
   const loadContacts = useCallback(async () => {