Merge pull request #260 from hicccc77/dev

解决年度报告导出失败 #252；集成WechatVisualization的功能并支持词云排除 #259

.gitignore

@@ -57,4 +57,7 @@ Thumbs.db
 
 wcdb/
 *info
-*.md
+概述.md
+chatlab-format.md
+*.bak
+AGENTS.md

README.md

@@ -38,6 +38,22 @@ WeFlow 是一个**完全本地**的微信**实时**聊天记录查看、分析
 - 统计分析与群聊画像
 - 年度报告与可视化概览
 - 导出聊天记录为 HTML 等格式
+- HTTP API 接口（供开发者集成）
+
+
+## HTTP API
+
+> [!WARNING]
+> 此功能目前处于早期阶段，接口可能会有变动，请等待后续更新完善。
+
+WeFlow 提供本地 HTTP API 服务，支持通过接口查询消息数据，可用于与其他工具集成或二次开发。
+
+- **启用方式**：设置 → API 服务 → 启动服务
+- **默认端口**：5031
+- **访问地址**：`http://127.0.0.1:5031`
+- **支持格式**：原始 JSON 或 [ChatLab](https://chatlab.fun/) 标准格式
+
+📖 完整接口文档：[点击查看](docs/HTTP-API.md)
 
 
 ## 快速开始

docs/HTTP-API.md

@@ -0,0 +1,312 @@
+# WeFlow HTTP API 接口文档
+
+WeFlow 提供 HTTP API 服务，支持通过 HTTP 接口查询消息数据，支持 [ChatLab](https://github.com/nichuanfang/chatlab-format) 标准化格式输出。
+
+## 启用 API 服务
+
+在设置页面 → API 服务 → 点击「启动服务」按钮。
+
+默认端口：`5031`
+
+## 基础地址
+
+```
+http://127.0.0.1:5031
+```
+
+---
+
+## 接口列表
+
+### 1. 健康检查
+
+检查 API 服务是否正常运行。
+
+**请求**
+```
+GET /health
+```
+
+**响应**
+```json
+{
+  "status": "ok"
+}
+```
+
+---
+
+### 2. 获取消息列表
+
+获取指定会话的消息，支持 ChatLab 格式输出。
+
+**请求**
+```
+GET /api/v1/messages
+```
+
+**参数**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| `talker` | string | ✅ | 会话 ID（wxid 或群 ID） |
+| `limit` | number | ❌ | 返回数量限制，默认 100 |
+| `offset` | number | ❌ | 偏移量，用于分页，默认 0 |
+| `start` | string | ❌ | 开始时间，格式 YYYYMMDD |
+| `end` | string | ❌ | 结束时间，格式 YYYYMMDD |
+| `chatlab` | string | ❌ | 设为 `1` 则输出 ChatLab 格式 |
+| `format` | string | ❌ | 输出格式：`json`（默认）或 `chatlab` |
+
+**示例请求**
+
+```bash
+# 获取消息（原始格式）
+GET http://127.0.0.1:5031/api/v1/messages?talker=wxid_xxx&limit=50
+
+# 获取消息（ChatLab 格式）
+GET http://127.0.0.1:5031/api/v1/messages?talker=wxid_xxx&chatlab=1
+
+# 带时间范围查询
+GET http://127.0.0.1:5031/api/v1/messages?talker=wxid_xxx&start=20260101&end=20260205&limit=100
+```
+
+**响应（原始格式）**
+```json
+{
+  "success": true,
+  "talker": "wxid_xxx",
+  "count": 50,
+  "hasMore": true,
+  "messages": [
+    {
+      "localId": 123,
+      "talker": "wxid_xxx",
+      "type": 1,
+      "content": "消息内容",
+      "createTime": 1738713600000,
+      "isSelf": false,
+      "sender": "wxid_sender"
+    }
+  ]
+}
+```
+
+**响应（ChatLab 格式）**
+```json
+{
+  "chatlab": {
+    "version": "0.0.2",
+    "exportedAt": 1738713600000,
+    "generator": "WeFlow",
+    "description": "Exported from WeFlow"
+  },
+  "meta": {
+    "name": "会话名称",
+    "platform": "wechat",
+    "type": "private",
+    "ownerId": "wxid_me"
+  },
+  "members": [
+    {
+      "platformId": "wxid_xxx",
+      "accountName": "用户名",
+      "groupNickname": "群昵称"
+    }
+  ],
+  "messages": [
+    {
+      "sender": "wxid_xxx",
+      "accountName": "用户名",
+      "timestamp": 1738713600000,
+      "type": 0,
+      "content": "消息内容"
+    }
+  ]
+}
+```
+
+---
+
+### 3. 获取会话列表
+
+获取所有会话列表。
+
+**请求**
+```
+GET /api/v1/sessions
+```
+
+**参数**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| `keyword` | string | ❌ | 搜索关键词，匹配会话名或 ID |
+| `limit` | number | ❌ | 返回数量限制，默认 100 |
+
+**示例请求**
+```bash
+GET http://127.0.0.1:5031/api/v1/sessions
+
+GET http://127.0.0.1:5031/api/v1/sessions?keyword=工作群&limit=20
+```
+
+**响应**
+```json
+{
+  "success": true,
+  "count": 50,
+  "total": 100,
+  "sessions": [
+    {
+      "username": "wxid_xxx",
+      "displayName": "用户名",
+      "lastMessage": "最后一条消息",
+      "lastTime": 1738713600000,
+      "unreadCount": 0
+    }
+  ]
+}
+```
+
+---
+
+### 4. 获取联系人列表
+
+获取所有联系人信息。
+
+**请求**
+```
+GET /api/v1/contacts
+```
+
+**参数**
+
+| 参数名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| `keyword` | string | ❌ | 搜索关键词 |
+| `limit` | number | ❌ | 返回数量限制，默认 100 |
+
+**示例请求**
+```bash
+GET http://127.0.0.1:5031/api/v1/contacts
+
+GET http://127.0.0.1:5031/api/v1/contacts?keyword=张三
+```
+
+**响应**
+```json
+{
+  "success": true,
+  "count": 50,
+  "contacts": [
+    {
+      "userName": "wxid_xxx",
+      "alias": "微信号",
+      "nickName": "昵称",
+      "remark": "备注名"
+    }
+  ]
+}
+```
+
+---
+
+## ChatLab 格式说明
+
+ChatLab 是一种标准化的聊天记录交换格式，版本 0.0.2。
+
+### 消息类型映射
+
+| ChatLab Type | 值 | 说明 |
+|--------------|-----|------|
+| TEXT | 0 | 文本消息 |
+| IMAGE | 1 | 图片 |
+| VOICE | 2 | 语音 |
+| VIDEO | 3 | 视频 |
+| FILE | 4 | 文件 |
+| EMOJI | 5 | 表情 |
+| LINK | 7 | 链接 |
+| LOCATION | 8 | 位置 |
+| RED_PACKET | 20 | 红包 |
+| TRANSFER | 21 | 转账 |
+| CALL | 23 | 通话 |
+| SYSTEM | 80 | 系统消息 |
+| RECALL | 81 | 撤回消息 |
+| OTHER | 99 | 其他 |
+
+---
+
+## 使用示例
+
+### PowerShell
+
+```powershell
+# 健康检查
+Invoke-RestMethod http://127.0.0.1:5031/health
+
+# 获取会话列表
+Invoke-RestMethod http://127.0.0.1:5031/api/v1/sessions
+
+# 获取消息
+Invoke-RestMethod "http://127.0.0.1:5031/api/v1/messages?talker=wxid_xxx&limit=10"
+
+# 获取 ChatLab 格式
+Invoke-RestMethod "http://127.0.0.1:5031/api/v1/messages?talker=wxid_xxx&chatlab=1" | ConvertTo-Json -Depth 10
+```
+
+### cURL
+
+```bash
+# 健康检查
+curl http://127.0.0.1:5031/health
+
+# 获取会话列表
+curl http://127.0.0.1:5031/api/v1/sessions
+
+# 获取消息（ChatLab 格式）
+curl "http://127.0.0.1:5031/api/v1/messages?talker=wxid_xxx&chatlab=1"
+```
+
+### Python
+
+```python
+import requests
+
+BASE_URL = "http://127.0.0.1:5031"
+
+# 获取会话列表
+sessions = requests.get(f"{BASE_URL}/api/v1/sessions").json()
+print(sessions)
+
+# 获取消息
+messages = requests.get(f"{BASE_URL}/api/v1/messages", params={
+    "talker": "wxid_xxx",
+    "limit": 100,
+    "chatlab": 1
+}).json()
+print(messages)
+```
+
+### JavaScript / Node.js
+
+```javascript
+const BASE_URL = "http://127.0.0.1:5031";
+
+// 获取会话列表
+const sessions = await fetch(`${BASE_URL}/api/v1/sessions`).then(r => r.json());
+console.log(sessions);
+
+// 获取消息（ChatLab 格式）
+const messages = await fetch(`${BASE_URL}/api/v1/messages?talker=wxid_xxx&chatlab=1`)
+  .then(r => r.json());
+console.log(messages);
+```
+
+---
+
+## 注意事项
+
+1. API 仅监听本地地址 `127.0.0.1`，不对外网开放
+2. 需要先连接数据库才能查询数据
+3. 时间参数格式为 `YYYYMMDD`（如 20260205）
+4. 支持 CORS，可从浏览器前端直接调用

electron/dualReportWorker.ts

@@ -11,6 +11,7 @@ interface WorkerConfig {
   resourcesPath?: string
   userDataPath?: string
   logEnabled?: boolean
+  excludeWords?: string[]
 }
 
 const config = workerData as WorkerConfig
@@ -29,6 +30,7 @@ async function run() {
     dbPath: config.dbPath,
     decryptKey: config.decryptKey,
     wxid: config.myWxid,
+    excludeWords: config.excludeWords,
     onProgress: (status: string, progress: number) => {
       parentPort?.postMessage({
         type: 'dualReport:progress',

electron/main.ts

@@ -23,6 +23,7 @@ import { contactExportService } from './services/contactExportService'
 import { windowsHelloService } from './services/windowsHelloService'
 import { llamaService } from './services/llamaService'
 import { registerNotificationHandlers, showNotification } from './windows/notificationWindow'
+import { httpService } from './services/httpService'
 
 
 // 配置自动更新
@@ -863,6 +864,10 @@ function registerIpcHandlers() {
     return await chatService.getContactAvatar(username)
   })
 
+  ipcMain.handle('chat:resolveTransferDisplayNames', async (_, chatroomId: string, payerUsername: string, receiverUsername: string) => {
+    return await chatService.resolveTransferDisplayNames(chatroomId, payerUsername, receiverUsername)
+  })
+
   ipcMain.handle('chat:getContacts', async () => {
     return await chatService.getContacts()
   })
@@ -895,6 +900,12 @@ function registerIpcHandlers() {
   ipcMain.handle('chat:getVoiceData', async (_, sessionId: string, msgId: string, createTime?: number, serverId?: string | number) => {
     return chatService.getVoiceData(sessionId, msgId, createTime, serverId)
   })
+  ipcMain.handle('chat:getAllVoiceMessages', async (_, sessionId: string) => {
+    return chatService.getAllVoiceMessages(sessionId)
+  })
+  ipcMain.handle('chat:getMessageDates', async (_, sessionId: string) => {
+    return chatService.getMessageDates(sessionId)
+  })
   ipcMain.handle('chat:resolveVoiceCache', async (_, sessionId: string, msgId: string) => {
     return chatService.resolveVoiceCache(sessionId, msgId)
   })
@@ -951,6 +962,10 @@ function registerIpcHandlers() {
   })
 
   // 导出相关
+  ipcMain.handle('export:getExportStats', async (_, sessionIds: string[], options: any) => {
+    return exportService.getExportStats(sessionIds, options)
+  })
+
   ipcMain.handle('export:exportSessions', async (event, sessionIds: string[], outputDir: string, options: ExportOptions) => {
     const onProgress = (progress: ExportProgress) => {
       if (!event.sender.isDestroyed()) {
@@ -973,8 +988,8 @@ function registerIpcHandlers() {
     return analyticsService.getOverallStatistics(force)
   })
 
-  ipcMain.handle('analytics:getContactRankings', async (_, limit?: number) => {
-    return analyticsService.getContactRankings(limit)
+  ipcMain.handle('analytics:getContactRankings', async (_, limit?: number, beginTimestamp?: number, endTimestamp?: number) => {
+    return analyticsService.getContactRankings(limit, beginTimestamp, endTimestamp)
   })
 
   ipcMain.handle('analytics:getTimeDistribution', async () => {
@@ -1180,6 +1195,7 @@ function registerIpcHandlers() {
     const logEnabled = cfg.get('logEnabled')
     const friendUsername = payload?.friendUsername
     const year = payload?.year ?? 0
+    const excludeWords = cfg.get('wordCloudExcludeWords') || []
 
     if (!friendUsername) {
       return { success: false, error: '缺少好友用户名' }
@@ -1194,7 +1210,7 @@ function registerIpcHandlers() {
 
     return await new Promise((resolve) => {
       const worker = new Worker(workerPath, {
-        workerData: { year, friendUsername, dbPath, decryptKey, myWxid: wxid, resourcesPath, userDataPath, logEnabled }
+        workerData: { year, friendUsername, dbPath, decryptKey, myWxid: wxid, resourcesPath, userDataPath, logEnabled, excludeWords }
       })
 
       const cleanup = () => {
@@ -1282,6 +1298,23 @@ function registerIpcHandlers() {
     })
   })
 
+  // HTTP API 服务
+  ipcMain.handle('http:start', async (_, port?: number) => {
+    return httpService.start(port || 5031)
+  })
+
+  ipcMain.handle('http:stop', async () => {
+    await httpService.stop()
+    return { success: true }
+  })
+
+  ipcMain.handle('http:status', async () => {
+    return {
+      running: httpService.isRunning(),
+      port: httpService.getPort()
+    }
+  })
+
 }
 
 // 主窗口引用

electron/preload.ts

@@ -131,6 +131,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
       ipcRenderer.invoke('chat:getNewMessages', sessionId, minTime, limit),
     getContact: (username: string) => ipcRenderer.invoke('chat:getContact', username),
     getContactAvatar: (username: string) => ipcRenderer.invoke('chat:getContactAvatar', username),
+    resolveTransferDisplayNames: (chatroomId: string, payerUsername: string, receiverUsername: string) =>
+      ipcRenderer.invoke('chat:resolveTransferDisplayNames', chatroomId, payerUsername, receiverUsername),
     getMyAvatarUrl: () => ipcRenderer.invoke('chat:getMyAvatarUrl'),
     downloadEmoji: (cdnUrl: string, md5?: string) => ipcRenderer.invoke('chat:downloadEmoji', cdnUrl, md5),
     getCachedMessages: (sessionId: string) => ipcRenderer.invoke('chat:getCachedMessages', sessionId),
@@ -139,6 +141,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
     getImageData: (sessionId: string, msgId: string) => ipcRenderer.invoke('chat:getImageData', sessionId, msgId),
     getVoiceData: (sessionId: string, msgId: string, createTime?: number, serverId?: string | number) =>
       ipcRenderer.invoke('chat:getVoiceData', sessionId, msgId, createTime, serverId),
+    getAllVoiceMessages: (sessionId: string) => ipcRenderer.invoke('chat:getAllVoiceMessages', sessionId),
+    getMessageDates: (sessionId: string) => ipcRenderer.invoke('chat:getMessageDates', sessionId),
     resolveVoiceCache: (sessionId: string, msgId: string) => ipcRenderer.invoke('chat:resolveVoiceCache', sessionId, msgId),
     getVoiceTranscript: (sessionId: string, msgId: string, createTime?: number) => ipcRenderer.invoke('chat:getVoiceTranscript', sessionId, msgId, createTime),
     onVoiceTranscriptPartial: (callback: (payload: { msgId: string; text: string }) => void) => {
@@ -186,7 +190,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
   // 数据分析
   analytics: {
     getOverallStatistics: (force?: boolean) => ipcRenderer.invoke('analytics:getOverallStatistics', force),
-    getContactRankings: (limit?: number) => ipcRenderer.invoke('analytics:getContactRankings', limit),
+    getContactRankings: (limit?: number, beginTimestamp?: number, endTimestamp?: number) =>
+      ipcRenderer.invoke('analytics:getContactRankings', limit, beginTimestamp, endTimestamp),
     getTimeDistribution: () => ipcRenderer.invoke('analytics:getTimeDistribution'),
     getExcludedUsernames: () => ipcRenderer.invoke('analytics:getExcludedUsernames'),
     setExcludedUsernames: (usernames: string[]) => ipcRenderer.invoke('analytics:setExcludedUsernames', usernames),
@@ -236,6 +241,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
 
   // 导出
   export: {
+    getExportStats: (sessionIds: string[], options: any) =>
+      ipcRenderer.invoke('export:getExportStats', sessionIds, options),
     exportSessions: (sessionIds: string[], outputDir: string, options: any) =>
       ipcRenderer.invoke('export:exportSessions', sessionIds, outputDir, options),
     exportSession: (sessionId: string, outputPath: string, options: any) =>
@@ -286,5 +293,12 @@ contextBridge.exposeInMainWorld('electronAPI', {
       ipcRenderer.on('llama:downloadProgress', listener)
       return () => ipcRenderer.removeListener('llama:downloadProgress', listener)
     }
+  },
+
+  // HTTP API 服务
+  http: {
+    start: (port?: number) => ipcRenderer.invoke('http:start', port),
+    stop: () => ipcRenderer.invoke('http:stop'),
+    status: () => ipcRenderer.invoke('http:status')
   }
 })

electron/services/analyticsService.ts

@@ -31,6 +31,7 @@ export interface ContactRanking {
   username: string
   displayName: string
   avatarUrl?: string
+  wechatId?: string
   messageCount: number
   sentCount: number
   receivedCount: number
@@ -576,7 +577,11 @@ class AnalyticsService {
     }
   }
 
-  async getContactRankings(limit: number = 20): Promise<{ success: boolean; data?: ContactRanking[]; error?: string }> {
+  async getContactRankings(
+    limit: number = 20,
+    beginTimestamp: number = 0,
+    endTimestamp: number = 0
+  ): Promise<{ success: boolean; data?: ContactRanking[]; error?: string }> {
     try {
       const conn = await this.ensureConnected()
       if (!conn.success || !conn.cleanedWxid) return { success: false, error: conn.error }
@@ -586,7 +591,7 @@ class AnalyticsService {
         return { success: false, error: '未找到消息会话' }
       }
 
-      const result = await this.getAggregateWithFallback(sessionInfo.usernames, 0, 0)
+      const result = await this.getAggregateWithFallback(sessionInfo.usernames, beginTimestamp, endTimestamp)
       if (!result.success || !result.data) {
         return { success: false, error: result.error || '聚合统计失败' }
       }
@@ -594,9 +599,10 @@ class AnalyticsService {
       const d = result.data
       const sessions = this.normalizeAggregateSessions(d.sessions, d.idMap)
       const usernames = Object.keys(sessions)
-      const [displayNames, avatarUrls] = await Promise.all([
+      const [displayNames, avatarUrls, aliasMap] = await Promise.all([
         wcdbService.getDisplayNames(usernames),
-        wcdbService.getAvatarUrls(usernames)
+        wcdbService.getAvatarUrls(usernames),
+        this.getAliasMap(usernames)
       ])
 
       const rankings: ContactRanking[] = usernames
@@ -608,10 +614,13 @@ class AnalyticsService {
           const avatarUrl = avatarUrls.success && avatarUrls.map
             ? avatarUrls.map[username]
             : undefined
+          const alias = aliasMap[username] || ''
+          const wechatId = alias || (!username.startsWith('wxid_') ? username : '')
           return {
             username,
             displayName,
             avatarUrl,
+            wechatId,
             messageCount: stat.total,
             sentCount: stat.sent,
             receivedCount: stat.received,

electron/services/annualReportService.ts

@@ -116,7 +116,7 @@ class AnnualReportService {
     }
     const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/)
     const cleaned = suffixMatch ? suffixMatch[1] : trimmed
-    
+
     return cleaned
   }
 
@@ -193,11 +193,15 @@ class AnnualReportService {
     if (!raw) return ''
     if (typeof raw === 'string') {
       if (raw.length === 0) return ''
-      if (this.looksLikeHex(raw)) {
+      // 只有当字符串足够长（超过16字符）且看起来像 hex 时才尝试解码
+      // 短字符串（如 "123456" 等纯数字）容易被误判为 hex
+      if (raw.length > 16 && this.looksLikeHex(raw)) {
         const bytes = Buffer.from(raw, 'hex')
         if (bytes.length > 0) return this.decodeBinaryContent(bytes)
       }
-      if (this.looksLikeBase64(raw)) {
+      // 只有当字符串足够长（超过16字符）且看起来像 base64 时才尝试解码
+      // 短字符串（如 "test", "home" 等）容易被误判为 base64
+      if (raw.length > 16 && this.looksLikeBase64(raw)) {
         try {
           const bytes = Buffer.from(raw, 'base64')
           return this.decodeBinaryContent(bytes)
@@ -495,7 +499,7 @@ class AnnualReportService {
         }
       }
 
-      this.reportProgress('加载扩展统计... (初始化)', 30, onProgress)
+      this.reportProgress('加载扩展统计...', 30, onProgress)
       const extras = await wcdbService.getAnnualReportExtras(sessionIds, actualStartTime, actualEndTime, peakDayBegin, peakDayEnd)
       if (extras.success && extras.data) {
         this.reportProgress('加载扩展统计... (解析热力图)', 32, onProgress)

electron/services/chatService.ts

@@ -72,6 +72,9 @@ export interface Message {
   // 名片消息
   cardUsername?: string     // 名片的微信ID
   cardNickname?: string     // 名片的昵称
+  // 转账消息
+  transferPayerUsername?: string   // 转账付款人
+  transferReceiverUsername?: string // 转账收款人
   // 聊天记录
   chatRecordTitle?: string  // 聊天记录标题
   chatRecordList?: Array<{
@@ -117,10 +120,13 @@ class ChatService {
   private voiceWavCache = new Map<string, Buffer>()
   private voiceTranscriptCache = new Map<string, string>()
   private voiceTranscriptPending = new Map<string, Promise<{ success: boolean; transcript?: string; error?: string }>>()
+  private transcriptCacheLoaded = false
+  private transcriptCacheDirty = false
+  private transcriptFlushTimer: ReturnType<typeof setTimeout> | null = null
   private mediaDbsCache: string[] | null = null
   private mediaDbsCacheTime = 0
   private readonly mediaDbsCacheTtl = 300000 // 5分钟
-  private readonly voiceCacheMaxEntries = 50
+  private readonly voiceWavCacheMaxEntries = 50
   // 缓存 media.db 的表结构信息
   private mediaDbSchemaCache = new Map<string, {
     voiceTable: string
@@ -720,7 +726,7 @@ class ChatService {
       // 1. 没有游标状态
       // 2. offset 为 0 (重新加载会话)
       // 3. batchSize 改变
-      // 4. startTime 改变
+      // 4. startTime/endTime 改变（视为全新查询）
       // 5. ascending 改变
       const needNewCursor = !state ||
         offset === 0 ||
@@ -753,27 +759,35 @@ class ChatService {
         this.messageCursors.set(sessionId, state)
 
         // 如果需要跳过消息(offset > 0),逐批获取但不返回
+        // 注意：仅在 offset === 0 时重建游标最安全；
+        // 当 startTime/endTime 变化导致重建时，offset 应由前端重置为 0
         if (offset > 0) {
-
+          console.warn(`[ChatService] 新游标需跳过 ${offset} 条消息（startTime=${startTime}, endTime=${endTime}）`)
           let skipped = 0
-          while (skipped < offset) {
+          const maxSkipAttempts = Math.ceil(offset / batchSize) + 5 // 防止无限循环
+          let attempts = 0
+          while (skipped < offset && attempts < maxSkipAttempts) {
+            attempts++
             const skipBatch = await wcdbService.fetchMessageBatch(state.cursor)
             if (!skipBatch.success) {
               console.error('[ChatService] 跳过消息批次失败:', skipBatch.error)
               return { success: false, error: skipBatch.error || '跳过消息失败' }
             }
             if (!skipBatch.rows || skipBatch.rows.length === 0) {
-
+              console.warn(`[ChatService] 跳过时数据耗尽: skipped=${skipped}/${offset}`)
               return { success: true, messages: [], hasMore: false }
             }
             skipped += skipBatch.rows.length
             state.fetched += skipBatch.rows.length
             if (!skipBatch.hasMore) {
-
+              console.warn(`[ChatService] 跳过后无更多数据: skipped=${skipped}/${offset}`)
               return { success: true, messages: [], hasMore: false }
             }
           }
-
+          if (attempts >= maxSkipAttempts) {
+            console.error(`[ChatService] 跳过消息超过最大尝试次数: attempts=${attempts}`)
+          }
+          console.log(`[ChatService] 跳过完成: skipped=${skipped}, fetched=${state.fetched}`)
         }
       } else if (state && offset !== state.fetched) {
         // offset 与 fetched 不匹配,说明状态不一致
@@ -1120,6 +1134,9 @@ class ChatService {
       // 名片消息
       let cardUsername: string | undefined
       let cardNickname: string | undefined
+      // 转账消息
+      let transferPayerUsername: string | undefined
+      let transferReceiverUsername: string | undefined
       // 聊天记录
       let chatRecordTitle: string | undefined
       let chatRecordList: Array<{
@@ -1151,8 +1168,8 @@ class ChatService {
         const cardInfo = this.parseCardInfo(content)
         cardUsername = cardInfo.username
         cardNickname = cardInfo.nickname
-      } else if (localType === 49 && content) {
-        // Type 49 消息（链接、文件、小程序、转账等）
+      } else if ((localType === 49 || localType === 8589934592049) && content) {
+        // Type 49 消息（链接、文件、小程序、转账等），8589934592049 也是转账类型
         const type49Info = this.parseType49Message(content)
         xmlType = type49Info.xmlType
         linkTitle = type49Info.linkTitle
@@ -1163,6 +1180,8 @@ class ChatService {
         fileExt = type49Info.fileExt
         chatRecordTitle = type49Info.chatRecordTitle
         chatRecordList = type49Info.chatRecordList
+        transferPayerUsername = type49Info.transferPayerUsername
+        transferReceiverUsername = type49Info.transferReceiverUsername
       } else if (localType === 244813135921 || (content && content.includes('<type>57</type>'))) {
         const quoteInfo = this.parseQuoteMessage(content)
         quotedContent = quoteInfo.content
@@ -1199,6 +1218,8 @@ class ChatService {
         xmlType,
         cardUsername,
         cardNickname,
+        transferPayerUsername,
+        transferReceiverUsername,
         chatRecordTitle,
         chatRecordList
       })
@@ -1663,6 +1684,8 @@ class ChatService {
     fileName?: string
     fileSize?: number
     fileExt?: string
+    transferPayerUsername?: string
+    transferReceiverUsername?: string
     chatRecordTitle?: string
     chatRecordList?: Array<{
       datatype: number
@@ -1786,6 +1809,16 @@ class ChatService {
           } else if (feedesc) {
             result.linkTitle = feedesc
           }
+
+          // 提取转账双方 wxid
+          const payerUsername = this.extractXmlValue(content, 'payer_username')
+          const receiverUsername = this.extractXmlValue(content, 'receiver_username')
+          if (payerUsername) {
+            result.transferPayerUsername = payerUsername
+          }
+          if (receiverUsername) {
+            result.transferReceiverUsername = receiverUsername
+          }
           break
         }
 
@@ -2168,19 +2201,32 @@ class ChatService {
 
   /**
    * 清理拍一拍消息
-   * 格式示例: 我拍了拍 "梨绒" ງ໐໐໓ ຖiງht620000wxid_...
+   * 格式示例:
+   *   纯文本: 我拍了拍 "梨绒" ງ໐໐໓ ຖiງht620000wxid_...
+   *   XML: <msg><appmsg...><title>"有幸"拍了拍"浩天空"相信未来!</title>...</msg>
    */
   private cleanPatMessage(content: string): string {
     if (!content) return '[拍一拍]'
 
-    // 1. 尝试匹配标准的 "A拍了拍B" 格式
-    // 这里的正则比较宽泛，为了兼容不同的语言环境
+    // 1. 优先从 XML <title> 标签提取内容
+    const titleMatch = /<title>([\s\S]*?)<\/title>/i.exec(content)
+    if (titleMatch) {
+      const title = titleMatch[1]
+        .replace(/<!\[CDATA\[/g, '')
+        .replace(/\]\]>/g, '')
+        .trim()
+      if (title) {
+        return `[拍一拍] ${title}`
+      }
+    }
+
+    // 2. 尝试匹配标准的 "A拍了拍B" 格式
     const match = /^(.+?拍了拍.+?)(?:[\r\n]|$|ງ|wxid_)/.exec(content)
     if (match) {
       return `[拍一拍] ${match[1].trim()}`
     }
 
-    // 2. 如果匹配失败，尝试清理掉疑似的 garbage (wxid, 乱码)
+    // 3. 如果匹配失败，尝试清理掉疑似的 garbage (wxid, 乱码)
     let cleaned = content.replace(/wxid_[a-zA-Z0-9_-]+/g, '') // 移除 wxid
     cleaned = cleaned.replace(/[ງ໐໓ຖiht]+/g, ' ') // 移除已知的乱码字符
     cleaned = cleaned.replace(/\d{6,}/g, '') // 移除长数字
@@ -2227,7 +2273,9 @@ class ChatService {
       if (raw.length === 0) return ''
 
       // 检查是否是 hex 编码
-      if (this.looksLikeHex(raw)) {
+      // 只有当字符串足够长（超过16字符）且看起来像 hex 时才尝试解码
+      // 短字符串（如 "123456" 等纯数字）容易被误判为 hex
+      if (raw.length > 16 && this.looksLikeHex(raw)) {
         const bytes = Buffer.from(raw, 'hex')
         if (bytes.length > 0) {
           const result = this.decodeBinaryContent(bytes, raw)
@@ -2237,7 +2285,9 @@ class ChatService {
       }
 
       // 检查是否是 base64 编码
-      if (this.looksLikeBase64(raw)) {
+      // 只有当字符串足够长（超过16字符）且看起来像 base64 时才尝试解码
+      // 短字符串（如 "test", "home" 等）容易被误判为 base64
+      if (raw.length > 16 && this.looksLikeBase64(raw)) {
         try {
           const bytes = Buffer.from(raw, 'base64')
           return this.decodeBinaryContent(bytes, raw)
@@ -2384,6 +2434,75 @@ class ChatService {
     }
   }
 
+  /**
+   * 解析转账消息中的付款方和收款方显示名称
+   * 优先使用群昵称，群昵称为空时回退到微信昵称/备注
+   */
+  async resolveTransferDisplayNames(
+    chatroomId: string,
+    payerUsername: string,
+    receiverUsername: string
+  ): Promise<{ payerName: string; receiverName: string }> {
+    try {
+      const connectResult = await this.ensureConnected()
+      if (!connectResult.success) {
+        return { payerName: payerUsername, receiverName: receiverUsername }
+      }
+
+      // 如果是群聊，尝试获取群昵称
+      let groupNicknames: Record<string, string> = {}
+      if (chatroomId.endsWith('@chatroom')) {
+        const nickResult = await wcdbService.getGroupNicknames(chatroomId)
+        if (nickResult.success && nickResult.nicknames) {
+          groupNicknames = nickResult.nicknames
+        }
+      }
+
+      // 获取当前用户 wxid，用于识别"自己"
+      const myWxid = this.configService.get('myWxid')
+      const cleanedMyWxid = myWxid ? this.cleanAccountDirName(myWxid) : ''
+
+      // 解析付款方名称：自己 > 群昵称 > 备注 > 昵称 > alias > wxid
+      const resolveName = async (username: string): Promise<string> => {
+        // 特判：如果是当前用户自己（contact 表通常不包含自己）
+        if (myWxid && (username === myWxid || username === cleanedMyWxid)) {
+          // 先查群昵称中是否有自己
+          const myGroupNick = groupNicknames[username]
+          if (myGroupNick) return myGroupNick
+          // 尝试从缓存获取自己的昵称
+          const cached = this.avatarCache.get(username) || this.avatarCache.get(myWxid)
+          if (cached?.displayName) return cached.displayName
+          return '我'
+        }
+
+        // 先查群昵称
+        const groupNick = groupNicknames[username]
+        if (groupNick) return groupNick
+
+        // 再查联系人信息
+        const contact = await this.getContact(username)
+        if (contact) {
+          return contact.remark || contact.nickName || contact.alias || username
+        }
+
+        // 兜底：查缓存
+        const cached = this.avatarCache.get(username)
+        if (cached?.displayName) return cached.displayName
+
+        return username
+      }
+
+      const [payerName, receiverName] = await Promise.all([
+        resolveName(payerUsername),
+        resolveName(receiverUsername)
+      ])
+
+      return { payerName, receiverName }
+    } catch {
+      return { payerName: payerUsername, receiverName: receiverUsername }
+    }
+  }
+
   /**
    * 获取当前用户的头像 URL
    */
@@ -3406,6 +3525,8 @@ class ChatService {
   ): Promise<{ success: boolean; transcript?: string; error?: string }> {
     const startTime = Date.now()
 
+    // 确保磁盘缓存已加载
+    this.loadTranscriptCacheIfNeeded()
 
     try {
       let msgCreateTime = createTime
@@ -3533,17 +3654,162 @@ class ChatService {
 
   private cacheVoiceWav(cacheKey: string, wavData: Buffer): void {
     this.voiceWavCache.set(cacheKey, wavData)
-    if (this.voiceWavCache.size > this.voiceCacheMaxEntries) {
+    if (this.voiceWavCache.size > this.voiceWavCacheMaxEntries) {
       const oldestKey = this.voiceWavCache.keys().next().value
       if (oldestKey) this.voiceWavCache.delete(oldestKey)
     }
   }
 
+  /** 获取持久化转写缓存文件路径 */
+  private getTranscriptCachePath(): string {
+    const cachePath = this.configService.get('cachePath')
+    const base = cachePath || join(app.getPath('documents'), 'WeFlow')
+    return join(base, 'Voices', 'transcripts.json')
+  }
+
+  /** 首次访问时从磁盘加载转写缓存 */
+  private loadTranscriptCacheIfNeeded(): void {
+    if (this.transcriptCacheLoaded) return
+    this.transcriptCacheLoaded = true
+    try {
+      const filePath = this.getTranscriptCachePath()
+      if (existsSync(filePath)) {
+        const raw = readFileSync(filePath, 'utf-8')
+        const data = JSON.parse(raw) as Record<string, string>
+        for (const [k, v] of Object.entries(data)) {
+          if (typeof v === 'string') this.voiceTranscriptCache.set(k, v)
+        }
+        console.log(`[Transcribe] 从磁盘加载了 ${this.voiceTranscriptCache.size} 条转写缓存`)
+      }
+    } catch (e) {
+      console.error('[Transcribe] 加载转写缓存失败:', e)
+    }
+  }
+
+  /** 将转写缓存持久化到磁盘（防抖 3 秒） */
+  private scheduleTranscriptFlush(): void {
+    if (this.transcriptFlushTimer) return
+    this.transcriptFlushTimer = setTimeout(() => {
+      this.transcriptFlushTimer = null
+      this.flushTranscriptCache()
+    }, 3000)
+  }
+
+  /** 立即写入转写缓存到磁盘 */
+  flushTranscriptCache(): void {
+    if (!this.transcriptCacheDirty) return
+    try {
+      const filePath = this.getTranscriptCachePath()
+      const dir = dirname(filePath)
+      if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+      const obj: Record<string, string> = {}
+      for (const [k, v] of this.voiceTranscriptCache) obj[k] = v
+      writeFileSync(filePath, JSON.stringify(obj), 'utf-8')
+      this.transcriptCacheDirty = false
+    } catch (e) {
+      console.error('[Transcribe] 写入转写缓存失败:', e)
+    }
+  }
+
   private cacheVoiceTranscript(cacheKey: string, transcript: string): void {
     this.voiceTranscriptCache.set(cacheKey, transcript)
-    if (this.voiceTranscriptCache.size > this.voiceCacheMaxEntries) {
-      const oldestKey = this.voiceTranscriptCache.keys().next().value
-      if (oldestKey) this.voiceTranscriptCache.delete(oldestKey)
+    this.transcriptCacheDirty = true
+    this.scheduleTranscriptFlush()
+  }
+
+  /**
+   * 检查某个语音消息是否已有缓存的转写结果
+   */
+  hasTranscriptCache(sessionId: string, msgId: string, createTime?: number): boolean {
+    this.loadTranscriptCacheIfNeeded()
+    const cacheKey = this.getVoiceCacheKey(sessionId, msgId, createTime)
+    return this.voiceTranscriptCache.has(cacheKey)
+  }
+
+  /**
+   * 获取某会话的所有语音消息（localType=34），用于批量转写
+   */
+  async getAllVoiceMessages(sessionId: string): Promise<{ success: boolean; messages?: Message[]; error?: string }> {
+    try {
+      const connectResult = await this.ensureConnected()
+      if (!connectResult.success) {
+        return { success: false, error: connectResult.error || '数据库未连接' }
+      }
+
+      // 获取会话表信息
+      let tables = this.sessionTablesCache.get(sessionId)
+      if (!tables) {
+        const tableStats = await wcdbService.getMessageTableStats(sessionId)
+        if (!tableStats.success || !tableStats.tables || tableStats.tables.length === 0) {
+          return { success: false, error: '未找到会话消息表' }
+        }
+        tables = tableStats.tables
+          .map(t => ({ tableName: t.table_name || t.name, dbPath: t.db_path }))
+          .filter(t => t.tableName && t.dbPath) as Array<{ tableName: string; dbPath: string }>
+        if (tables.length > 0) {
+          this.sessionTablesCache.set(sessionId, tables)
+          setTimeout(() => { this.sessionTablesCache.delete(sessionId) }, this.sessionTablesCacheTtl)
+        }
+      }
+
+      let allVoiceMessages: Message[] = []
+
+      for (const { tableName, dbPath } of tables) {
+        try {
+          const sql = `SELECT * FROM ${tableName} WHERE local_type = 34 ORDER BY create_time DESC`
+          const result = await wcdbService.execQuery('message', dbPath, sql)
+          if (result.success && result.rows && result.rows.length > 0) {
+            const mapped = this.mapRowsToMessages(result.rows as Record<string, any>[])
+            allVoiceMessages.push(...mapped)
+          }
+        } catch (e) {
+          console.error(`[ChatService] 查询语音消息失败 (${dbPath}):`, e)
+        }
+      }
+
+      // 按 createTime 降序排序
+      allVoiceMessages.sort((a, b) => b.createTime - a.createTime)
+
+      // 去重
+      const seen = new Set<string>()
+      allVoiceMessages = allVoiceMessages.filter(msg => {
+        const key = `${msg.serverId}-${msg.localId}-${msg.createTime}-${msg.sortSeq}`
+        if (seen.has(key)) return false
+        seen.add(key)
+        return true
+      })
+
+      console.log(`[ChatService] 共找到 ${allVoiceMessages.length} 条语音消息（去重后）`)
+      return { success: true, messages: allVoiceMessages }
+    } catch (e) {
+      console.error('[ChatService] 获取所有语音消息失败:', e)
+      return { success: false, error: String(e) }
+    }
+  }
+
+  /**
+   * 获取某会话中有消息的日期列表
+   * 返回 YYYY-MM-DD 格式的日期字符串数组
+   */
+  async getMessageDates(sessionId: string): Promise<{ success: boolean; dates?: string[]; error?: string }> {
+    try {
+      const connectResult = await this.ensureConnected()
+      if (!connectResult.success) {
+        return { success: false, error: connectResult.error || '数据库未连接' }
+      }
+
+      const result = await wcdbService.getMessageDates(sessionId)
+      if (!result.success) {
+        throw new Error(result.error || '查询失败')
+      }
+
+      const dates = result.dates || []
+
+      console.log(`[ChatService] 会话 ${sessionId} 共有 ${dates.length} 个有消息的日期`)
+      return { success: true, dates }
+    } catch (e) {
+      console.error('[ChatService] 获取消息日期失败:', e)
+      return { success: false, error: String(e) }
     }
   }
 

electron/services/config.ts

@@ -42,6 +42,7 @@ interface ConfigSchema {
   notificationPosition: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'
   notificationFilterMode: 'all' | 'whitelist' | 'blacklist'
   notificationFilterList: string[]
+  wordCloudExcludeWords: string[]
 }
 
 export class ConfigService {
@@ -94,7 +95,8 @@ export class ConfigService {
         notificationEnabled: true,
         notificationPosition: 'top-right',
         notificationFilterMode: 'all',
-        notificationFilterList: []
+        notificationFilterList: [],
+        wordCloudExcludeWords: []
       }
     })
   }

electron/services/dualReportService.ts

@@ -1,11 +1,15 @@
 import { parentPort } from 'worker_threads'
 import { wcdbService } from './wcdbService'
 
+
 export interface DualReportMessage {
   content: string
   isSentByMe: boolean
   createTime: number
   createTimeStr: string
+  localType?: number
+  emojiMd5?: string
+  emojiCdnUrl?: string
 }
 
 export interface DualReportFirstChat {
@@ -14,6 +18,9 @@ export interface DualReportFirstChat {
   content: string
   isSentByMe: boolean
   senderUsername?: string
+  localType?: number
+  emojiMd5?: string
+  emojiCdnUrl?: string
 }
 
 export interface DualReportStats {
@@ -26,13 +33,17 @@ export interface DualReportStats {
   friendTopEmojiMd5?: string
   myTopEmojiUrl?: string
   friendTopEmojiUrl?: string
+  myTopEmojiCount?: number
+  friendTopEmojiCount?: number
 }
 
 export interface DualReportData {
   year: number
   selfName: string
+  selfAvatarUrl?: string
   friendUsername: string
   friendName: string
+  friendAvatarUrl?: string
   firstChat: DualReportFirstChat | null
   firstChatMessages?: DualReportMessage[]
   yearFirstChat?: {
@@ -42,9 +53,19 @@ export interface DualReportData {
     isSentByMe: boolean
     friendName: string
     firstThreeMessages: DualReportMessage[]
+    localType?: number
+    emojiMd5?: string
+    emojiCdnUrl?: string
   } | null
   stats: DualReportStats
   topPhrases: Array<{ phrase: string; count: number }>
+  myExclusivePhrases: Array<{ phrase: string; count: number }>
+  friendExclusivePhrases: Array<{ phrase: string; count: number }>
+  heatmap?: number[][]
+  initiative?: { initiated: number; received: number }
+  response?: { avg: number; fastest: number; count: number }
+  monthly?: Record<string, number>
+  streak?: { days: number; startDate: string; endDate: string }
 }
 
 class DualReportService {
@@ -75,7 +96,7 @@ class DualReportService {
     }
     const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/)
     const cleaned = suffixMatch ? suffixMatch[1] : trimmed
-    
+
     return cleaned
   }
 
@@ -106,11 +127,15 @@ class DualReportService {
     if (!raw) return ''
     if (typeof raw === 'string') {
       if (raw.length === 0) return ''
-      if (this.looksLikeHex(raw)) {
+      // 只有当字符串足够长（超过16字符）且看起来像 hex 时才尝试解码
+      // 短字符串（如 "123456" 等纯数字）容易被误判为 hex
+      if (raw.length > 16 && this.looksLikeHex(raw)) {
         const bytes = Buffer.from(raw, 'hex')
         if (bytes.length > 0) return this.decodeBinaryContent(bytes)
       }
-      if (this.looksLikeBase64(raw)) {
+      // 只有当字符串足够长（超过16字符）且看起来像 base64 时才尝试解码
+      // 短字符串（如 "test", "home" 等）容易被误判为 base64
+      if (raw.length > 16 && this.looksLikeBase64(raw)) {
         try {
           const bytes = Buffer.from(raw, 'base64')
           return this.decodeBinaryContent(bytes)
@@ -164,26 +189,258 @@ class DualReportService {
     return `${month}/${day} ${hour}:${minute}`
   }
 
-  private extractEmojiUrl(content: string): string | undefined {
-    if (!content) return undefined
-    const attrMatch = /cdnurl\s*=\s*['"]([^'"]+)['"]/i.exec(content)
-    if (attrMatch) {
-      let url = attrMatch[1].replace(/&amp;/g, '&')
-      try {
-        if (url.includes('%')) {
-          url = decodeURIComponent(url)
-        }
-      } catch { }
-      return url
+  private getRecordField(record: Record<string, any> | undefined | null, keys: string[]): any {
+    if (!record) return undefined
+    for (const key of keys) {
+      if (Object.prototype.hasOwnProperty.call(record, key) && record[key] !== undefined && record[key] !== null) {
+        return record[key]
+      }
     }
-    const tagMatch = /cdnurl[^>]*>([^<]+)/i.exec(content)
-    return tagMatch?.[1]
+    return undefined
   }
 
-  private extractEmojiMd5(content: string): string | undefined {
+  private coerceNumber(raw: any): number {
+    if (raw === undefined || raw === null || raw === '') return NaN
+    if (typeof raw === 'number') return raw
+    if (typeof raw === 'bigint') return Number(raw)
+    if (Buffer.isBuffer(raw)) return parseInt(raw.toString('utf-8'), 10)
+    if (raw instanceof Uint8Array) return parseInt(Buffer.from(raw).toString('utf-8'), 10)
+    const parsed = parseInt(String(raw), 10)
+    return Number.isFinite(parsed) ? parsed : NaN
+  }
+
+  private coerceString(raw: any): string {
+    if (raw === undefined || raw === null) return ''
+    if (typeof raw === 'string') return raw
+    if (Buffer.isBuffer(raw)) return this.decodeBinaryContent(raw)
+    if (raw instanceof Uint8Array) return this.decodeBinaryContent(Buffer.from(raw))
+    return String(raw)
+  }
+
+  private coerceBoolean(raw: any): boolean | undefined {
+    if (raw === undefined || raw === null || raw === '') return undefined
+    if (typeof raw === 'boolean') return raw
+    if (typeof raw === 'number') return raw !== 0
+
+    const normalized = String(raw).trim().toLowerCase()
+    if (!normalized) return undefined
+
+    if (['1', 'true', 'yes', 'me', 'self', 'mine', 'sent', 'out', 'outgoing'].includes(normalized)) return true
+    if (['0', 'false', 'no', 'friend', 'peer', 'other', 'recv', 'received', 'in', 'incoming'].includes(normalized)) return false
+    return undefined
+  }
+
+  private normalizeEmojiMd5(raw: string): string | undefined {
+    if (!raw) return undefined
+    const trimmed = raw.trim()
+    if (!trimmed) return undefined
+    const match = /([a-fA-F0-9]{16,64})/.exec(trimmed)
+    return match ? match[1].toLowerCase() : undefined
+  }
+
+  private normalizeEmojiUrl(raw: string): string | undefined {
+    if (!raw) return undefined
+    let url = raw.trim().replace(/&amp;/g, '&')
+    if (!url) return undefined
+    try {
+      if (url.includes('%')) {
+        url = decodeURIComponent(url)
+      }
+    } catch { }
+    return url || undefined
+  }
+
+  private extractEmojiUrl(content: string | undefined): string | undefined {
     if (!content) return undefined
-    const match = /md5="([^"]+)"/i.exec(content) || /<md5>([^<]+)<\/md5>/i.exec(content)
-    return match?.[1]
+    const direct = this.normalizeEmojiUrl(content)
+    if (direct && /^https?:\/\//i.test(direct)) return direct
+
+    const attrMatch = /(?:cdnurl|thumburl)\s*=\s*['"]([^'"]+)['"]/i.exec(content)
+      || /(?:cdnurl|thumburl)\s*=\s*([^'"\s>]+)/i.exec(content)
+    if (attrMatch) return this.normalizeEmojiUrl(attrMatch[1])
+
+    const tagMatch = /<(?:cdnurl|thumburl)>([^<]+)<\/(?:cdnurl|thumburl)>/i.exec(content)
+      || /(?:cdnurl|thumburl)[^>]*>([^<]+)/i.exec(content)
+    return this.normalizeEmojiUrl(tagMatch?.[1] || '')
+  }
+
+  private extractEmojiMd5(content: string | undefined): string | undefined {
+    if (!content) return undefined
+    const direct = this.normalizeEmojiMd5(content)
+    if (direct && direct.length >= 24) return direct
+
+    const match = /md5\s*=\s*['"]([a-fA-F0-9]{16,64})['"]/i.exec(content)
+      || /md5\s*=\s*([a-fA-F0-9]{16,64})/i.exec(content)
+      || /<md5>([a-fA-F0-9]{16,64})<\/md5>/i.exec(content)
+    return this.normalizeEmojiMd5(match?.[1] || '')
+  }
+
+  private resolveEmojiOwner(item: any, content: string): boolean | undefined {
+    const sentFlag = this.coerceBoolean(this.getRecordField(item, [
+      'isMe',
+      'is_me',
+      'isSent',
+      'is_sent',
+      'isSend',
+      'is_send',
+      'fromMe',
+      'from_me'
+    ]))
+    if (sentFlag !== undefined) return sentFlag
+
+    const sideRaw = this.coerceString(this.getRecordField(item, ['side', 'sender', 'from', 'owner', 'role', 'direction'])).trim().toLowerCase()
+    if (sideRaw) {
+      if (['me', 'self', 'mine', 'out', 'outgoing', 'sent'].includes(sideRaw)) return true
+      if (['friend', 'peer', 'other', 'in', 'incoming', 'received', 'recv'].includes(sideRaw)) return false
+    }
+
+    const prefixMatch = /^\s*([01])\s*:\s*/.exec(content)
+    if (prefixMatch) return prefixMatch[1] === '1'
+    return undefined
+  }
+
+  private stripEmojiOwnerPrefix(content: string): string {
+    if (!content) return ''
+    return content.replace(/^\s*[01]\s*:\s*/, '')
+  }
+
+  private parseEmojiCandidate(item: any): { isMe?: boolean; md5?: string; url?: string; count: number } {
+    const rawContent = this.coerceString(this.getRecordField(item, [
+      'content',
+      'xml',
+      'message_content',
+      'messageContent',
+      'msg',
+      'payload',
+      'raw'
+    ]))
+    const content = this.stripEmojiOwnerPrefix(rawContent)
+
+    const countRaw = this.getRecordField(item, ['count', 'cnt', 'times', 'total', 'num'])
+    const parsedCount = this.coerceNumber(countRaw)
+    const count = Number.isFinite(parsedCount) && parsedCount > 0 ? parsedCount : 0
+
+    const directMd5 = this.normalizeEmojiMd5(this.coerceString(this.getRecordField(item, [
+      'md5',
+      'emojiMd5',
+      'emoji_md5',
+      'emd5'
+    ])))
+    const md5 = directMd5 || this.extractEmojiMd5(content)
+
+    const directUrl = this.normalizeEmojiUrl(this.coerceString(this.getRecordField(item, [
+      'cdnUrl',
+      'cdnurl',
+      'emojiUrl',
+      'emoji_url',
+      'url',
+      'thumbUrl',
+      'thumburl'
+    ])))
+    const url = directUrl || this.extractEmojiUrl(content)
+
+    return {
+      isMe: this.resolveEmojiOwner(item, rawContent),
+      md5,
+      url,
+      count
+    }
+  }
+
+  private getRowInt(row: Record<string, any>, keys: string[], fallback = 0): number {
+    const raw = this.getRecordField(row, keys)
+    const parsed = this.coerceNumber(raw)
+    return Number.isFinite(parsed) ? parsed : fallback
+  }
+
+  private decodeRowMessageContent(row: Record<string, any>): string {
+    const messageContent = this.getRecordField(row, [
+      'message_content',
+      'messageContent',
+      'content',
+      'msg_content',
+      'msgContent',
+      'WCDB_CT_message_content',
+      'WCDB_CT_messageContent'
+    ])
+    const compressContent = this.getRecordField(row, [
+      'compress_content',
+      'compressContent',
+      'compressed_content',
+      'WCDB_CT_compress_content',
+      'WCDB_CT_compressContent'
+    ])
+    return this.decodeMessageContent(messageContent, compressContent)
+  }
+
+  private async scanEmojiTopFallback(
+    sessionId: string,
+    beginTimestamp: number,
+    endTimestamp: number,
+    rawWxid: string,
+    cleanedWxid: string
+  ): Promise<{ my?: { md5: string; url?: string; count: number }; friend?: { md5: string; url?: string; count: number } }> {
+    const cursorResult = await wcdbService.openMessageCursor(sessionId, 500, true, beginTimestamp, endTimestamp)
+    if (!cursorResult.success || !cursorResult.cursor) return {}
+
+    const tallyMap = new Map<string, { isMe: boolean; md5: string; url?: string; count: number }>()
+    try {
+      let hasMore = true
+      while (hasMore) {
+        const batch = await wcdbService.fetchMessageBatch(cursorResult.cursor)
+        if (!batch.success || !Array.isArray(batch.rows)) break
+
+        for (const row of batch.rows) {
+          const localType = this.getRowInt(row, ['local_type', 'localType', 'type', 'msg_type', 'msgType', 'WCDB_CT_local_type'], 0)
+          if (localType !== 47) continue
+
+          const rawContent = this.decodeRowMessageContent(row)
+          const content = this.stripEmojiOwnerPrefix(rawContent)
+          const directMd5 = this.normalizeEmojiMd5(this.coerceString(this.getRecordField(row, ['emoji_md5', 'emojiMd5', 'md5'])))
+          const md5 = directMd5 || this.extractEmojiMd5(content)
+          if (!md5) continue
+
+          const directUrl = this.normalizeEmojiUrl(this.coerceString(this.getRecordField(row, [
+            'emoji_cdn_url',
+            'emojiCdnUrl',
+            'cdnurl',
+            'cdn_url',
+            'emoji_url',
+            'emojiUrl',
+            'url',
+            'thumburl',
+            'thumb_url'
+          ])))
+          const url = directUrl || this.extractEmojiUrl(content)
+          const isMe = this.resolveIsSent(row, rawWxid, cleanedWxid)
+          const mapKey = `${isMe ? '1' : '0'}:${md5}`
+          const existing = tallyMap.get(mapKey)
+          if (existing) {
+            existing.count += 1
+            if (!existing.url && url) existing.url = url
+          } else {
+            tallyMap.set(mapKey, { isMe, md5, url, count: 1 })
+          }
+        }
+        hasMore = batch.hasMore === true
+      }
+    } finally {
+      await wcdbService.closeMessageCursor(cursorResult.cursor)
+    }
+
+    let myTop: { md5: string; url?: string; count: number } | undefined
+    let friendTop: { md5: string; url?: string; count: number } | undefined
+    for (const entry of tallyMap.values()) {
+      if (entry.isMe) {
+        if (!myTop || entry.count > myTop.count) {
+          myTop = { md5: entry.md5, url: entry.url, count: entry.count }
+        }
+      } else if (!friendTop || entry.count > friendTop.count) {
+        friendTop = { md5: entry.md5, url: entry.url, count: entry.count }
+      }
+    }
+
+    return { my: myTop, friend: friendTop }
   }
 
   private async getDisplayName(username: string, fallback: string): Promise<string> {
@@ -245,10 +502,11 @@ class DualReportService {
     dbPath: string
     decryptKey: string
     wxid: string
+    excludeWords?: string[]
     onProgress?: (status: string, progress: number) => void
   }): Promise<{ success: boolean; data?: DualReportData; error?: string }> {
     try {
-      const { year, friendUsername, dbPath, decryptKey, wxid, onProgress } = params
+      const { year, friendUsername, dbPath, decryptKey, wxid, excludeWords, onProgress } = params
       this.reportProgress('正在连接数据库...', 5, onProgress)
       const conn = await this.ensureConnectedWithConfig(dbPath, decryptKey, wxid)
       if (!conn.success || !conn.cleanedWxid || !conn.rawWxid) return { success: false, error: conn.error }
@@ -267,189 +525,271 @@ class DualReportService {
       if (myName === rawWxid && cleanedWxid && cleanedWxid !== rawWxid) {
         myName = await this.getDisplayName(cleanedWxid, rawWxid)
       }
+      const avatarCandidates = Array.from(new Set([
+        friendUsername,
+        rawWxid,
+        cleanedWxid
+      ].filter(Boolean) as string[]))
+      let selfAvatarUrl: string | undefined
+      let friendAvatarUrl: string | undefined
+      const avatarResult = await wcdbService.getAvatarUrls(avatarCandidates)
+      if (avatarResult.success && avatarResult.map) {
+        selfAvatarUrl = avatarResult.map[rawWxid] || avatarResult.map[cleanedWxid]
+        friendAvatarUrl = avatarResult.map[friendUsername]
+      }
 
       this.reportProgress('获取首条聊天记录...', 15, onProgress)
-      const firstRows = await this.getFirstMessages(friendUsername, 3, 0, 0)
+      const firstRows = await this.getFirstMessages(friendUsername, 10, 0, 0)
       let firstChat: DualReportFirstChat | null = null
       if (firstRows.length > 0) {
         const row = firstRows[0]
         const createTime = parseInt(row.create_time || '0', 10) * 1000
-        const content = this.decodeMessageContent(row.message_content, row.compress_content)
+        const rawContent = this.decodeMessageContent(row.message_content, row.compress_content)
+        const localType = this.getRowInt(row, ['local_type', 'localType', 'type', 'msg_type', 'msgType'], 0)
+        let emojiMd5: string | undefined
+        let emojiCdnUrl: string | undefined
+        if (localType === 47) {
+          const stripped = this.stripEmojiOwnerPrefix(rawContent)
+          emojiMd5 = this.normalizeEmojiMd5(this.coerceString(this.getRecordField(row, ['emoji_md5', 'emojiMd5', 'md5']))) || this.extractEmojiMd5(stripped)
+          emojiCdnUrl = this.normalizeEmojiUrl(this.coerceString(this.getRecordField(row, ['emoji_cdn_url', 'emojiCdnUrl', 'cdnurl']))) || this.extractEmojiUrl(stripped)
+        }
+
         firstChat = {
           createTime,
           createTimeStr: this.formatDateTime(createTime),
-          content: String(content || ''),
+          content: String(rawContent || ''),
           isSentByMe: this.resolveIsSent(row, rawWxid, cleanedWxid),
-          senderUsername: row.sender_username || row.sender
+          senderUsername: row.sender_username || row.sender,
+          localType,
+          emojiMd5,
+          emojiCdnUrl
         }
       }
       const firstChatMessages: DualReportMessage[] = firstRows.map((row) => {
         const msgTime = parseInt(row.create_time || '0', 10) * 1000
-        const msgContent = this.decodeMessageContent(row.message_content, row.compress_content)
+        const rawContent = this.decodeMessageContent(row.message_content, row.compress_content)
+        const localType = this.getRowInt(row, ['local_type', 'localType', 'type', 'msg_type', 'msgType'], 0)
+        let emojiMd5: string | undefined
+        let emojiCdnUrl: string | undefined
+        if (localType === 47) {
+          const stripped = this.stripEmojiOwnerPrefix(rawContent)
+          emojiMd5 = this.normalizeEmojiMd5(this.coerceString(this.getRecordField(row, ['emoji_md5', 'emojiMd5', 'md5']))) || this.extractEmojiMd5(stripped)
+          emojiCdnUrl = this.normalizeEmojiUrl(this.coerceString(this.getRecordField(row, ['emoji_cdn_url', 'emojiCdnUrl', 'cdnurl']))) || this.extractEmojiUrl(stripped)
+        }
+
         return {
-          content: String(msgContent || ''),
+          content: String(rawContent || ''),
           isSentByMe: this.resolveIsSent(row, rawWxid, cleanedWxid),
           createTime: msgTime,
-          createTimeStr: this.formatDateTime(msgTime)
+          createTimeStr: this.formatDateTime(msgTime),
+          localType,
+          emojiMd5,
+          emojiCdnUrl
         }
       })
 
       let yearFirstChat: DualReportData['yearFirstChat'] = null
       if (!isAllTime) {
         this.reportProgress('获取今年首次聊天...', 20, onProgress)
-        const firstYearRows = await this.getFirstMessages(friendUsername, 3, startTime, endTime)
+        const firstYearRows = await this.getFirstMessages(friendUsername, 10, startTime, endTime)
         if (firstYearRows.length > 0) {
           const firstRow = firstYearRows[0]
           const createTime = parseInt(firstRow.create_time || '0', 10) * 1000
           const firstThreeMessages: DualReportMessage[] = firstYearRows.map((row) => {
             const msgTime = parseInt(row.create_time || '0', 10) * 1000
-            const msgContent = this.decodeMessageContent(row.message_content, row.compress_content)
+            const rawContent = this.decodeMessageContent(row.message_content, row.compress_content)
+            const localType = this.getRowInt(row, ['local_type', 'localType', 'type', 'msg_type', 'msgType'], 0)
+            let emojiMd5: string | undefined
+            let emojiCdnUrl: string | undefined
+            if (localType === 47) {
+              const stripped = this.stripEmojiOwnerPrefix(rawContent)
+              emojiMd5 = this.normalizeEmojiMd5(this.coerceString(this.getRecordField(row, ['emoji_md5', 'emojiMd5', 'md5']))) || this.extractEmojiMd5(stripped)
+              emojiCdnUrl = this.normalizeEmojiUrl(this.coerceString(this.getRecordField(row, ['emoji_cdn_url', 'emojiCdnUrl', 'cdnurl']))) || this.extractEmojiUrl(stripped)
+            }
+
             return {
-              content: String(msgContent || ''),
+              content: String(rawContent || ''),
               isSentByMe: this.resolveIsSent(row, rawWxid, cleanedWxid),
               createTime: msgTime,
-              createTimeStr: this.formatDateTime(msgTime)
+              createTimeStr: this.formatDateTime(msgTime),
+              localType,
+              emojiMd5,
+              emojiCdnUrl
             }
           })
+          const firstRowYear = firstYearRows[0]
+          const rawContentYear = this.decodeMessageContent(firstRowYear.message_content, firstRowYear.compress_content)
+          const localTypeYear = this.getRowInt(firstRowYear, ['local_type', 'localType', 'type', 'msg_type', 'msgType'], 0)
+          let emojiMd5Year: string | undefined
+          let emojiCdnUrlYear: string | undefined
+          if (localTypeYear === 47) {
+            const stripped = this.stripEmojiOwnerPrefix(rawContentYear)
+            emojiMd5Year = this.normalizeEmojiMd5(this.coerceString(this.getRecordField(firstRowYear, ['emoji_md5', 'emojiMd5', 'md5']))) || this.extractEmojiMd5(stripped)
+            emojiCdnUrlYear = this.normalizeEmojiUrl(this.coerceString(this.getRecordField(firstRowYear, ['emoji_cdn_url', 'emojiCdnUrl', 'cdnurl']))) || this.extractEmojiUrl(stripped)
+          }
+
           yearFirstChat = {
             createTime,
             createTimeStr: this.formatDateTime(createTime),
-            content: String(this.decodeMessageContent(firstRow.message_content, firstRow.compress_content) || ''),
-            isSentByMe: this.resolveIsSent(firstRow, rawWxid, cleanedWxid),
+            content: String(rawContentYear || ''),
+            isSentByMe: this.resolveIsSent(firstRowYear, rawWxid, cleanedWxid),
             friendName,
-            firstThreeMessages
+            firstThreeMessages,
+            localType: localTypeYear,
+            emojiMd5: emojiMd5Year,
+            emojiCdnUrl: emojiCdnUrlYear
           }
         }
       }
 
       this.reportProgress('统计聊天数据...', 30, onProgress)
+
+      const statsResult = await wcdbService.getDualReportStats(friendUsername, startTime, endTime)
+      if (!statsResult.success || !statsResult.data) {
+        return { success: false, error: statsResult.error || '获取双人报告统计失败' }
+      }
+
+      const cppData = statsResult.data
+      const counts = cppData.counts || {}
+
       const stats: DualReportStats = {
-        totalMessages: 0,
-        totalWords: 0,
-        imageCount: 0,
-        voiceCount: 0,
-        emojiCount: 0
-      }
-      const wordCountMap = new Map<string, number>()
-      const myEmojiCounts = new Map<string, number>()
-      const friendEmojiCounts = new Map<string, number>()
-      const myEmojiUrlMap = new Map<string, string>()
-      const friendEmojiUrlMap = new Map<string, string>()
-
-      const messageCountResult = await wcdbService.getMessageCount(friendUsername)
-      const totalForProgress = messageCountResult.success && messageCountResult.count
-        ? messageCountResult.count
-        : 0
-      let processed = 0
-      let lastProgressAt = 0
-
-      const cursorResult = await wcdbService.openMessageCursor(friendUsername, 1000, true, startTime, endTime)
-      if (!cursorResult.success || !cursorResult.cursor) {
-        return { success: false, error: cursorResult.error || '打开消息游标失败' }
+        totalMessages: counts.total || 0,
+        totalWords: counts.words || 0,
+        imageCount: counts.image || 0,
+        voiceCount: counts.voice || 0,
+        emojiCount: counts.emoji || 0
       }
 
-      try {
-        let hasMore = true
-        while (hasMore) {
-          const batch = await wcdbService.fetchMessageBatch(cursorResult.cursor)
-          if (!batch.success || !batch.rows) break
-          for (const row of batch.rows) {
-            const localType = parseInt(row.local_type || row.type || '1', 10)
-            const isSent = this.resolveIsSent(row, rawWxid, cleanedWxid)
-            stats.totalMessages += 1
+      // Process Emojis to find top for me and friend
+      let myTopEmojiMd5: string | undefined
+      let myTopEmojiUrl: string | undefined
+      let myTopCount = -1
 
-            if (localType === 3) stats.imageCount += 1
-            if (localType === 34) stats.voiceCount += 1
-            if (localType === 47) {
-              stats.emojiCount += 1
-              const content = this.decodeMessageContent(row.message_content, row.compress_content)
-              const md5 = this.extractEmojiMd5(content)
-              const url = this.extractEmojiUrl(content)
-              if (md5) {
-                const targetMap = isSent ? myEmojiCounts : friendEmojiCounts
-                targetMap.set(md5, (targetMap.get(md5) || 0) + 1)
-                if (url) {
-                  const urlMap = isSent ? myEmojiUrlMap : friendEmojiUrlMap
-                  if (!urlMap.has(md5)) urlMap.set(md5, url)
-                }
-              }
-            }
+      let friendTopEmojiMd5: string | undefined
+      let friendTopEmojiUrl: string | undefined
+      let friendTopCount = -1
 
-            if (localType === 1 || localType === 244813135921) {
-              const content = this.decodeMessageContent(row.message_content, row.compress_content)
-              const text = String(content || '').trim()
-              if (text.length > 0) {
-                stats.totalWords += text.replace(/\s+/g, '').length
-                const normalized = text.replace(/\s+/g, ' ').trim()
-                if (normalized.length >= 2 &&
-                  normalized.length <= 50 &&
-                  !normalized.includes('http') &&
-                  !normalized.includes('<') &&
-                  !normalized.startsWith('[') &&
-                  !normalized.startsWith('<?xml')) {
-                  wordCountMap.set(normalized, (wordCountMap.get(normalized) || 0) + 1)
-                }
-              }
-            }
+      if (cppData.emojis && Array.isArray(cppData.emojis)) {
+        for (const item of cppData.emojis) {
+          const candidate = this.parseEmojiCandidate(item)
+          if (!candidate.md5 || candidate.isMe === undefined || candidate.count <= 0) continue
 
-            if (totalForProgress > 0) {
-              processed++
+          if (candidate.isMe) {
+            if (candidate.count > myTopCount) {
+              myTopCount = candidate.count
+              myTopEmojiMd5 = candidate.md5
+              myTopEmojiUrl = candidate.url
             }
-          }
-          hasMore = batch.hasMore === true
-
-          const now = Date.now()
-          if (now - lastProgressAt > 200) {
-            if (totalForProgress > 0) {
-              const ratio = Math.min(1, processed / totalForProgress)
-              const progress = 30 + Math.floor(ratio * 50)
-              this.reportProgress('统计聊天数据...', progress, onProgress)
-            }
-            lastProgressAt = now
+          } else if (candidate.count > friendTopCount) {
+            friendTopCount = candidate.count
+            friendTopEmojiMd5 = candidate.md5
+            friendTopEmojiUrl = candidate.url
           }
         }
-      } finally {
-        await wcdbService.closeMessageCursor(cursorResult.cursor)
       }
 
-      const pickTop = (map: Map<string, number>): string | undefined => {
-        let topKey: string | undefined
-        let topCount = -1
-        for (const [key, count] of map.entries()) {
-          if (count > topCount) {
-            topCount = count
-            topKey = key
-          }
+      const needsEmojiFallback = stats.emojiCount > 0 && (!myTopEmojiMd5 || !friendTopEmojiMd5)
+      if (needsEmojiFallback) {
+        const fallback = await this.scanEmojiTopFallback(friendUsername, startTime, endTime, rawWxid, cleanedWxid)
+
+        if (!myTopEmojiMd5 && fallback.my?.md5) {
+          myTopEmojiMd5 = fallback.my.md5
+          myTopEmojiUrl = myTopEmojiUrl || fallback.my.url
+          myTopCount = fallback.my.count
+        }
+        if (!friendTopEmojiMd5 && fallback.friend?.md5) {
+          friendTopEmojiMd5 = fallback.friend.md5
+          friendTopEmojiUrl = friendTopEmojiUrl || fallback.friend.url
+          friendTopCount = fallback.friend.count
         }
-        return topKey
       }
 
-      const myTopEmojiMd5 = pickTop(myEmojiCounts)
-      const friendTopEmojiMd5 = pickTop(friendEmojiCounts)
+      const [myEmojiUrlResult, friendEmojiUrlResult] = await Promise.all([
+        myTopEmojiMd5 && !myTopEmojiUrl ? wcdbService.getEmoticonCdnUrl(dbPath, myTopEmojiMd5) : Promise.resolve(null),
+        friendTopEmojiMd5 && !friendTopEmojiUrl ? wcdbService.getEmoticonCdnUrl(dbPath, friendTopEmojiMd5) : Promise.resolve(null)
+      ])
+      if (myEmojiUrlResult?.success && myEmojiUrlResult.url) myTopEmojiUrl = myEmojiUrlResult.url
+      if (friendEmojiUrlResult?.success && friendEmojiUrlResult.url) friendTopEmojiUrl = friendEmojiUrlResult.url
 
       stats.myTopEmojiMd5 = myTopEmojiMd5
+      stats.myTopEmojiUrl = myTopEmojiUrl
       stats.friendTopEmojiMd5 = friendTopEmojiMd5
-      stats.myTopEmojiUrl = myTopEmojiMd5 ? myEmojiUrlMap.get(myTopEmojiMd5) : undefined
-      stats.friendTopEmojiUrl = friendTopEmojiMd5 ? friendEmojiUrlMap.get(friendTopEmojiMd5) : undefined
+      stats.friendTopEmojiUrl = friendTopEmojiUrl
+      if (myTopCount >= 0) stats.myTopEmojiCount = myTopCount
+      if (friendTopCount >= 0) stats.friendTopEmojiCount = friendTopCount
 
-      this.reportProgress('生成常用语词云...', 85, onProgress)
-      const topPhrases = Array.from(wordCountMap.entries())
-        .filter(([_, count]) => count >= 2)
-        .sort((a, b) => b[1] - a[1])
-        .slice(0, 50)
-        .map(([phrase, count]) => ({ phrase, count }))
+      if (friendTopCount >= 0) stats.friendTopEmojiCount = friendTopCount
+
+      const excludeSet = new Set(excludeWords || [])
+
+      const filterPhrases = (list: any[]) => {
+        return (list || []).filter((p: any) => !excludeSet.has(p.phrase))
+      }
+
+      const cleanPhrases = filterPhrases(cppData.phrases)
+      const cleanMyPhrases = filterPhrases(cppData.myPhrases)
+      const cleanFriendPhrases = filterPhrases(cppData.friendPhrases)
+
+      const topPhrases = cleanPhrases.map((p: any) => ({
+        phrase: p.phrase,
+        count: p.count
+      }))
+
+      // 计算专属词汇：一方频繁使用而另一方很少使用的词
+      const myPhraseMap = new Map<string, number>()
+      const friendPhraseMap = new Map<string, number>()
+      for (const p of cleanMyPhrases) {
+        myPhraseMap.set(p.phrase, p.count)
+      }
+      for (const p of cleanFriendPhrases) {
+        friendPhraseMap.set(p.phrase, p.count)
+      }
+
+      // 专属词汇：该方使用占比 >= 75% 且至少出现 2 次
+      const myExclusivePhrases: Array<{ phrase: string; count: number }> = []
+      const friendExclusivePhrases: Array<{ phrase: string; count: number }> = []
+
+      for (const [phrase, myCount] of myPhraseMap) {
+        const friendCount = friendPhraseMap.get(phrase) || 0
+        const total = myCount + friendCount
+        if (myCount >= 2 && total > 0 && myCount / total >= 0.75) {
+          myExclusivePhrases.push({ phrase, count: myCount })
+        }
+      }
+      for (const [phrase, friendCount] of friendPhraseMap) {
+        const myCount = myPhraseMap.get(phrase) || 0
+        const total = myCount + friendCount
+        if (friendCount >= 2 && total > 0 && friendCount / total >= 0.75) {
+          friendExclusivePhrases.push({ phrase, count: friendCount })
+        }
+      }
+
+      // 按频率排序，取前 20
+      myExclusivePhrases.sort((a, b) => b.count - a.count)
+      friendExclusivePhrases.sort((a, b) => b.count - a.count)
+      if (myExclusivePhrases.length > 20) myExclusivePhrases.length = 20
+      if (friendExclusivePhrases.length > 20) friendExclusivePhrases.length = 20
 
       const reportData: DualReportData = {
         year: reportYear,
         selfName: myName,
+        selfAvatarUrl,
         friendUsername,
         friendName,
+        friendAvatarUrl,
         firstChat,
         firstChatMessages,
         yearFirstChat,
         stats,
-        topPhrases
-      }
+        topPhrases,
+        myExclusivePhrases,
+        friendExclusivePhrases,
+        heatmap: cppData.heatmap,
+        initiative: cppData.initiative,
+        response: cppData.response,
+        monthly: cppData.monthly,
+        streak: cppData.streak
+      } as any
 
       this.reportProgress('双人报告生成完成', 100, onProgress)
       return { success: true, data: reportData }

electron/services/exportHtml.css

@@ -25,83 +25,87 @@ body {
 
 .page {
   max-width: 1080px;
-  margin: 32px auto 60px;
-  padding: 0 20px;
+  margin: 0 auto;
+  padding: 8px 20px;
+  height: 100vh;
+  display: flex;
+  flex-direction: column;
 }
 
 .header {
   background: var(--card);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow);
-  padding: 24px;
-  margin-bottom: 24px;
+  border-radius: 12px;
+  box-shadow: 0 2px 8px rgba(15, 23, 42, 0.06);
+  padding: 12px 20px;
+  flex-shrink: 0;
 }
 
 .title {
-  font-size: 24px;
+  font-size: 16px;
   font-weight: 600;
-  margin: 0 0 8px;
+  margin: 0;
+  display: inline;
 }
 
 .meta {
   color: var(--muted);
-  font-size: 14px;
-  display: flex;
-  flex-wrap: wrap;
-  gap: 12px;
+  font-size: 13px;
+  display: inline;
+  margin-left: 12px;
+}
+
+.meta span {
+  margin-right: 10px;
 }
 
 .controls {
-  display: grid;
-  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
-  gap: 16px;
-  margin-top: 20px;
-}
-
-.control {
   display: flex;
-  flex-direction: column;
-  gap: 6px;
+  align-items: center;
+  gap: 8px;
+  margin-top: 8px;
+  flex-wrap: wrap;
 }
 
-.control label {
-  font-size: 13px;
-  color: var(--muted);
-}
-
-.control input,
-.control select,
-.control button {
-  border-radius: 12px;
+.controls input,
+.controls button {
+  border-radius: 8px;
   border: 1px solid var(--border);
-  padding: 10px 12px;
-  font-size: 14px;
+  padding: 6px 10px;
+  font-size: 13px;
   font-family: inherit;
 }
 
-.control button {
+.controls input[type="search"] {
+  width: 200px;
+}
+
+.controls input[type="datetime-local"] {
+  width: 200px;
+}
+
+.controls button {
   background: var(--accent);
   color: #fff;
   border: none;
   cursor: pointer;
-  transition: transform 0.1s ease;
+  padding: 6px 14px;
 }
 
-.control button:active {
+.controls button:active {
   transform: scale(0.98);
 }
 
 .stats {
   font-size: 13px;
   color: var(--muted);
-  display: flex;
-  align-items: flex-end;
+  margin-left: auto;
 }
 
 .message-list {
   display: flex;
   flex-direction: column;
-  gap: 18px;
+  gap: 12px;
+  padding: 4px 0;
 }
 
 .message {
@@ -248,50 +252,11 @@ body {
   cursor: zoom-out;
 }
 
-body[data-theme="cloud-dancer"] {
-  --accent: #6b8cff;
-  --sent: #e0e7ff;
-  --received: #ffffff;
-  --border: #d8e0f7;
-  --bg: #f6f7fb;
-}
-
-body[data-theme="corundum-blue"] {
-  --accent: #2563eb;
-  --sent: #dbeafe;
-  --received: #ffffff;
-  --border: #c7d2fe;
-  --bg: #eef2ff;
-}
-
-body[data-theme="kiwi-green"] {
-  --accent: #16a34a;
-  --sent: #dcfce7;
-  --received: #ffffff;
-  --border: #bbf7d0;
-  --bg: #f0fdf4;
-}
-
-body[data-theme="spicy-red"] {
-  --accent: #e11d48;
-  --sent: #ffe4e6;
-  --received: #ffffff;
-  --border: #fecdd3;
-  --bg: #fff1f2;
-}
-
-body[data-theme="teal-water"] {
-  --accent: #0f766e;
-  --sent: #ccfbf1;
-  --received: #ffffff;
-  --border: #99f6e4;
-  --bg: #f0fdfa;
-}
-
 .highlight {
   outline: 2px solid var(--accent);
   outline-offset: 4px;
   border-radius: 18px;
+  transition: outline-color 0.3s;
 }
 
 .empty {
@@ -300,32 +265,29 @@ body[data-theme="teal-water"] {
   padding: 40px;
 }
 
-/* Virtual Scroll */
-.virtual-scroll-container {
-  height: calc(100vh - 180px);
-  /* Adjust based on header height */
+/* Scroll Container */
+.scroll-container {
+  flex: 1;
+  min-height: 0;
   overflow-y: auto;
-  position: relative;
   border: 1px solid var(--border);
   border-radius: var(--radius);
   background: var(--bg);
-  margin-top: 20px;
+  margin-top: 8px;
+  margin-bottom: 8px;
+  padding: 12px;
+  -webkit-overflow-scrolling: touch;
 }
 
-.virtual-scroll-spacer {
-  opacity: 0;
-  pointer-events: none;
-  width: 1px;
+.scroll-container::-webkit-scrollbar {
+  width: 6px;
 }
 
-.virtual-scroll-content {
-  position: absolute;
-  top: 0;
-  left: 0;
-  width: 100%;
+.scroll-container::-webkit-scrollbar-thumb {
+  background: #c1c1c1;
+  border-radius: 3px;
 }
 
-.message-list {
-  /* Override message-list to be inside virtual scroll */
-  display: block;
-}
+.load-sentinel {
+  height: 1px;
+}

electron/services/exportHtmlStyles.ts

@@ -25,83 +25,87 @@ body {
 
 .page {
   max-width: 1080px;
-  margin: 32px auto 60px;
-  padding: 0 20px;
+  margin: 0 auto;
+  padding: 8px 20px;
+  height: 100vh;
+  display: flex;
+  flex-direction: column;
 }
 
 .header {
   background: var(--card);
-  border-radius: var(--radius);
-  box-shadow: var(--shadow);
-  padding: 24px;
-  margin-bottom: 24px;
+  border-radius: 12px;
+  box-shadow: 0 2px 8px rgba(15, 23, 42, 0.06);
+  padding: 12px 20px;
+  flex-shrink: 0;
 }
 
 .title {
-  font-size: 24px;
+  font-size: 16px;
   font-weight: 600;
-  margin: 0 0 8px;
+  margin: 0;
+  display: inline;
 }
 
 .meta {
   color: var(--muted);
-  font-size: 14px;
-  display: flex;
-  flex-wrap: wrap;
-  gap: 12px;
+  font-size: 13px;
+  display: inline;
+  margin-left: 12px;
+}
+
+.meta span {
+  margin-right: 10px;
 }
 
 .controls {
-  display: grid;
-  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
-  gap: 16px;
-  margin-top: 20px;
-}
-
-.control {
   display: flex;
-  flex-direction: column;
-  gap: 6px;
+  align-items: center;
+  gap: 8px;
+  margin-top: 8px;
+  flex-wrap: wrap;
 }
 
-.control label {
-  font-size: 13px;
-  color: var(--muted);
-}
-
-.control input,
-.control select,
-.control button {
-  border-radius: 12px;
+.controls input,
+.controls button {
+  border-radius: 8px;
   border: 1px solid var(--border);
-  padding: 10px 12px;
-  font-size: 14px;
+  padding: 6px 10px;
+  font-size: 13px;
   font-family: inherit;
 }
 
-.control button {
+.controls input[type="search"] {
+  width: 200px;
+}
+
+.controls input[type="datetime-local"] {
+  width: 200px;
+}
+
+.controls button {
   background: var(--accent);
   color: #fff;
   border: none;
   cursor: pointer;
-  transition: transform 0.1s ease;
+  padding: 6px 14px;
 }
 
-.control button:active {
+.controls button:active {
   transform: scale(0.98);
 }
 
 .stats {
   font-size: 13px;
   color: var(--muted);
-  display: flex;
-  align-items: flex-end;
+  margin-left: auto;
 }
 
 .message-list {
   display: flex;
   flex-direction: column;
-  gap: 18px;
+  gap: 12px;
+  padding: 4px 0;
 }
 
 .message {
@@ -248,50 +252,11 @@ body {
   cursor: zoom-out;
 }
 
-body[data-theme="cloud-dancer"] {
-  --accent: #6b8cff;
-  --sent: #e0e7ff;
-  --received: #ffffff;
-  --border: #d8e0f7;
-  --bg: #f6f7fb;
-}
-
-body[data-theme="corundum-blue"] {
-  --accent: #2563eb;
-  --sent: #dbeafe;
-  --received: #ffffff;
-  --border: #c7d2fe;
-  --bg: #eef2ff;
-}
-
-body[data-theme="kiwi-green"] {
-  --accent: #16a34a;
-  --sent: #dcfce7;
-  --received: #ffffff;
-  --border: #bbf7d0;
-  --bg: #f0fdf4;
-}
-
-body[data-theme="spicy-red"] {
-  --accent: #e11d48;
-  --sent: #ffe4e6;
-  --received: #ffffff;
-  --border: #fecdd3;
-  --bg: #fff1f2;
-}
-
-body[data-theme="teal-water"] {
-  --accent: #0f766e;
-  --sent: #ccfbf1;
-  --received: #ffffff;
-  --border: #99f6e4;
-  --bg: #f0fdfa;
-}
-
 .highlight {
   outline: 2px solid var(--accent);
   outline-offset: 4px;
   border-radius: 18px;
+  transition: outline-color 0.3s;
 }
 
 .empty {
@@ -299,4 +264,32 @@ body[data-theme="teal-water"] {
   color: var(--muted);
   padding: 40px;
 }
+
+/* Scroll Container */
+.scroll-container {
+  flex: 1;
+  min-height: 0;
+  overflow-y: auto;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--bg);
+  margin-top: 8px;
+  margin-bottom: 8px;
+  padding: 12px;
+  -webkit-overflow-scrolling: touch;
+}
+
+.scroll-container::-webkit-scrollbar {
+  width: 6px;
+}
+
+.scroll-container::-webkit-scrollbar-thumb {
+  background: #c1c1c1;
+  border-radius: 3px;
+}
+
+.load-sentinel {
+  height: 1px;
+}
 `;
+

electron/services/groupAnalyticsService.ts

@@ -105,19 +105,166 @@ class GroupAnalyticsService {
   /**
    * 从 DLL 获取群成员的群昵称
    */
-  private async getGroupNicknamesForRoom(chatroomId: string): Promise<Map<string, string>> {
+  private async getGroupNicknamesForRoom(chatroomId: string, candidates: string[] = []): Promise<Map<string, string>> {
     try {
-      const result = await wcdbService.getGroupNicknames(chatroomId)
-      if (result.success && result.nicknames) {
-        return new Map(Object.entries(result.nicknames))
+      const escapedChatroomId = chatroomId.replace(/'/g, "''")
+      const sql = `SELECT ext_buffer FROM chat_room WHERE username='${escapedChatroomId}' LIMIT 1`
+      const result = await wcdbService.execQuery('contact', null, sql)
+      if (!result.success || !result.rows || result.rows.length === 0) {
+        return new Map<string, string>()
       }
-      return new Map<string, string>()
+
+      const extBuffer = this.decodeExtBuffer((result.rows[0] as any).ext_buffer)
+      if (!extBuffer) return new Map<string, string>()
+      return this.parseGroupNicknamesFromExtBuffer(extBuffer, candidates)
     } catch (e) {
       console.error('getGroupNicknamesForRoom error:', e)
       return new Map<string, string>()
     }
   }
 
+  private looksLikeHex(s: string): boolean {
+    if (s.length % 2 !== 0) return false
+    return /^[0-9a-fA-F]+$/.test(s)
+  }
+
+  private looksLikeBase64(s: string): boolean {
+    if (s.length % 4 !== 0) return false
+    return /^[A-Za-z0-9+/=]+$/.test(s)
+  }
+
+  private decodeExtBuffer(value: unknown): Buffer | null {
+    if (!value) return null
+    if (Buffer.isBuffer(value)) return value
+    if (value instanceof Uint8Array) return Buffer.from(value)
+
+    if (typeof value === 'string') {
+      const raw = value.trim()
+      if (!raw) return null
+
+      if (this.looksLikeHex(raw)) {
+        try { return Buffer.from(raw, 'hex') } catch { }
+      }
+      if (this.looksLikeBase64(raw)) {
+        try { return Buffer.from(raw, 'base64') } catch { }
+      }
+
+      try { return Buffer.from(raw, 'hex') } catch { }
+      try { return Buffer.from(raw, 'base64') } catch { }
+      try { return Buffer.from(raw, 'utf8') } catch { }
+      return null
+    }
+
+    return null
+  }
+
+  private readVarint(buffer: Buffer, offset: number, limit: number = buffer.length): { value: number; next: number } | null {
+    let value = 0
+    let shift = 0
+    let pos = offset
+    while (pos < limit && shift <= 53) {
+      const byte = buffer[pos]
+      value += (byte & 0x7f) * Math.pow(2, shift)
+      pos += 1
+      if ((byte & 0x80) === 0) return { value, next: pos }
+      shift += 7
+    }
+    return null
+  }
+
+  private isLikelyMemberId(value: string): boolean {
+    const id = String(value || '').trim()
+    if (!id) return false
+    if (id.includes('@chatroom')) return false
+    if (id.length < 4 || id.length > 80) return false
+    return /^[A-Za-z][A-Za-z0-9_.@-]*$/.test(id)
+  }
+
+  private isLikelyNickname(value: string): boolean {
+    const cleaned = this.normalizeGroupNickname(value)
+    if (!cleaned) return false
+    if (/^wxid_[a-z0-9_]+$/i.test(cleaned)) return false
+    if (cleaned.includes('@chatroom')) return false
+    if (!/[\u4E00-\u9FFF\u3400-\u4DBF\w]/.test(cleaned)) return false
+    if (cleaned.length === 1) {
+      const code = cleaned.charCodeAt(0)
+      const isCjk = code >= 0x3400 && code <= 0x9fff
+      if (!isCjk) return false
+    }
+    return true
+  }
+
+  private parseGroupNicknamesFromExtBuffer(buffer: Buffer, candidates: string[] = []): Map<string, string> {
+    const nicknameMap = new Map<string, string>()
+    if (!buffer || buffer.length === 0) return nicknameMap
+
+    try {
+      const candidateSet = new Set(this.buildIdCandidates(candidates).map((id) => id.toLowerCase()))
+
+      for (let i = 0; i < buffer.length - 2; i += 1) {
+        if (buffer[i] !== 0x0a) continue
+
+        const idLenInfo = this.readVarint(buffer, i + 1)
+        if (!idLenInfo) continue
+        const idLen = idLenInfo.value
+        if (!Number.isFinite(idLen) || idLen <= 0 || idLen > 96) continue
+
+        const idStart = idLenInfo.next
+        const idEnd = idStart + idLen
+        if (idEnd > buffer.length) continue
+
+        const memberId = buffer.toString('utf8', idStart, idEnd).trim()
+        if (!this.isLikelyMemberId(memberId)) continue
+
+        const memberIdLower = memberId.toLowerCase()
+        if (candidateSet.size > 0 && !candidateSet.has(memberIdLower)) {
+          i = idEnd - 1
+          continue
+        }
+
+        const cursor = idEnd
+        if (cursor >= buffer.length || buffer[cursor] !== 0x12) {
+          i = idEnd - 1
+          continue
+        }
+
+        const nickLenInfo = this.readVarint(buffer, cursor + 1)
+        if (!nickLenInfo) {
+          i = idEnd - 1
+          continue
+        }
+
+        const nickLen = nickLenInfo.value
+        if (!Number.isFinite(nickLen) || nickLen <= 0 || nickLen > 128) {
+          i = idEnd - 1
+          continue
+        }
+
+        const nickStart = nickLenInfo.next
+        const nickEnd = nickStart + nickLen
+        if (nickEnd > buffer.length) {
+          i = idEnd - 1
+          continue
+        }
+
+        const rawNick = buffer.toString('utf8', nickStart, nickEnd)
+        const nickname = this.normalizeGroupNickname(rawNick.replace(/[\x00-\x1F\x7F]/g, '').trim())
+        if (!this.isLikelyNickname(nickname)) {
+          i = nickEnd - 1
+          continue
+        }
+
+        if (!nicknameMap.has(memberId)) nicknameMap.set(memberId, nickname)
+        if (!nicknameMap.has(memberIdLower)) nicknameMap.set(memberIdLower, nickname)
+        i = nickEnd - 1
+      }
+    } catch (e) {
+      console.error('Failed to parse chat_room.ext_buffer:', e)
+    }
+
+    return nicknameMap
+  }
+
   private escapeCsvValue(value: string): string {
     if (value == null) return ''
     const str = String(value)
@@ -127,14 +274,54 @@ class GroupAnalyticsService {
     return str
   }
 
-  private normalizeGroupNickname(value: string, wxid: string, fallback: string): string {
+  private normalizeGroupNickname(value: string): string {
     const trimmed = (value || '').trim()
-    if (!trimmed) return fallback
-    if (/^["'@]+$/.test(trimmed)) return fallback
-    if (trimmed.toLowerCase() === (wxid || '').toLowerCase()) return fallback
+    if (!trimmed) return ''
+    if (/^["'@]+$/.test(trimmed)) return ''
     return trimmed
   }
 
+  private buildIdCandidates(values: Array<string | undefined | null>): string[] {
+    const set = new Set<string>()
+    for (const rawValue of values) {
+      const raw = String(rawValue || '').trim()
+      if (!raw) continue
+      set.add(raw)
+      const cleaned = this.cleanAccountDirName(raw)
+      if (cleaned && cleaned !== raw) {
+        set.add(cleaned)
+      }
+    }
+    return Array.from(set)
+  }
+
+  private resolveGroupNicknameByCandidates(groupNicknames: Map<string, string>, candidates: string[]): string {
+    const idCandidates = this.buildIdCandidates(candidates)
+    if (idCandidates.length === 0) return ''
+
+    for (const id of idCandidates) {
+      const exact = this.normalizeGroupNickname(groupNicknames.get(id) || '')
+      if (exact) return exact
+    }
+
+    for (const id of idCandidates) {
+      const lower = id.toLowerCase()
+      let found = ''
+      let matched = 0
+      for (const [key, value] of groupNicknames.entries()) {
+        if (String(key || '').toLowerCase() !== lower) continue
+        const normalized = this.normalizeGroupNickname(value || '')
+        if (!normalized) continue
+        found = normalized
+        matched += 1
+        if (matched > 1) return ''
+      }
+      if (matched === 1 && found) return found
+    }
+
+    return ''
+  }
+
   private sanitizeWorksheetName(name: string): string {
     const cleaned = (name || '').replace(/[*?:\\/\\[\\]]/g, '_').trim()
     const limited = cleaned.slice(0, 31)
@@ -219,15 +406,24 @@ class GroupAnalyticsService {
         return { success: false, error: result.error || '获取群成员失败' }
       }
 
-      const members = result.members as { username: string; avatarUrl?: string }[]
+      const members = result.members as Array<{
+        username: string
+        avatarUrl?: string
+        originalName?: string
+      }>
       const usernames = members.map((m) => m.username).filter(Boolean)
 
-      const [displayNames, groupNicknames] = await Promise.all([
-        wcdbService.getDisplayNames(usernames),
-        this.getGroupNicknamesForRoom(chatroomId)
-      ])
+      const displayNamesPromise = wcdbService.getDisplayNames(usernames)
 
-      const contactMap = new Map<string, { remark?: string; nickName?: string; alias?: string }>()
+      const contactMap = new Map<string, {
+        remark?: string
+        nickName?: string
+        alias?: string
+        username?: string
+        userName?: string
+        encryptUsername?: string
+        encryptUserName?: string
+      }>()
       const concurrency = 6
       await this.parallelLimit(usernames, concurrency, async (username) => {
         const contactResult = await wcdbService.getContact(username)
@@ -236,13 +432,29 @@ class GroupAnalyticsService {
           contactMap.set(username, {
             remark: contact.remark || '',
             nickName: contact.nickName || contact.nick_name || '',
-            alias: contact.alias || ''
+            alias: contact.alias || '',
+            username: contact.username || '',
+            userName: contact.userName || contact.user_name || '',
+            encryptUsername: contact.encryptUsername || contact.encrypt_username || '',
+            encryptUserName: contact.encryptUserName || ''
           })
         } else {
           contactMap.set(username, { remark: '', nickName: '', alias: '' })
         }
       })
 
+      const displayNames = await displayNamesPromise
+      const nicknameCandidates = this.buildIdCandidates([
+        ...members.map((m) => m.username),
+        ...members.map((m) => m.originalName),
+        ...Array.from(contactMap.values()).map((c) => c?.username),
+        ...Array.from(contactMap.values()).map((c) => c?.userName),
+        ...Array.from(contactMap.values()).map((c) => c?.encryptUsername),
+        ...Array.from(contactMap.values()).map((c) => c?.encryptUserName),
+        ...Array.from(contactMap.values()).map((c) => c?.alias)
+      ])
+      const groupNicknames = await this.getGroupNicknamesForRoom(chatroomId, nicknameCandidates)
+
       const myWxid = this.cleanAccountDirName(this.configService.get('myWxid') || '')
       const data: GroupMember[] = members.map((m) => {
         const wxid = m.username || ''
@@ -251,13 +463,20 @@ class GroupAnalyticsService {
         const nickname = contact?.nickName || ''
         const remark = contact?.remark || ''
         const alias = contact?.alias || ''
-        const rawGroupNickname = groupNicknames.get(wxid.toLowerCase()) || ''
         const normalizedWxid = this.cleanAccountDirName(wxid)
-        const groupNickname = this.normalizeGroupNickname(
-          rawGroupNickname,
-          normalizedWxid === myWxid ? myWxid : wxid,
-          ''
-        )
+        const lookupCandidates = this.buildIdCandidates([
+          wxid,
+          m.originalName,
+          contact?.username,
+          contact?.userName,
+          contact?.encryptUsername,
+          contact?.encryptUserName,
+          alias
+        ])
+        if (normalizedWxid === myWxid) {
+          lookupCandidates.push(myWxid)
+        }
+        const groupNickname = this.resolveGroupNicknameByCandidates(groupNicknames, lookupCandidates)
 
         return {
           username: wxid,
@@ -418,18 +637,27 @@ class GroupAnalyticsService {
         return { success: false, error: membersResult.error || '获取群成员失败' }
       }
 
-      const members = membersResult.members as { username: string; avatarUrl?: string }[]
+      const members = membersResult.members as Array<{
+        username: string
+        avatarUrl?: string
+        originalName?: string
+      }>
       if (members.length === 0) {
         return { success: false, error: '群成员为空' }
       }
 
       const usernames = members.map((m) => m.username).filter(Boolean)
-      const [displayNames, groupNicknames] = await Promise.all([
-        wcdbService.getDisplayNames(usernames),
-        this.getGroupNicknamesForRoom(chatroomId)
-      ])
+      const displayNamesPromise = wcdbService.getDisplayNames(usernames)
 
-      const contactMap = new Map<string, { remark?: string; nickName?: string; alias?: string }>()
+      const contactMap = new Map<string, {
+        remark?: string
+        nickName?: string
+        alias?: string
+        username?: string
+        userName?: string
+        encryptUsername?: string
+        encryptUserName?: string
+      }>()
       const concurrency = 6
       await this.parallelLimit(usernames, concurrency, async (username) => {
         const result = await wcdbService.getContact(username)
@@ -438,7 +666,11 @@ class GroupAnalyticsService {
           contactMap.set(username, {
             remark: contact.remark || '',
             nickName: contact.nickName || contact.nick_name || '',
-            alias: contact.alias || ''
+            alias: contact.alias || '',
+            username: contact.username || '',
+            userName: contact.userName || contact.user_name || '',
+            encryptUsername: contact.encryptUsername || contact.encrypt_username || '',
+            encryptUserName: contact.encryptUserName || ''
           })
         } else {
           contactMap.set(username, { remark: '', nickName: '', alias: '' })
@@ -453,6 +685,18 @@ class GroupAnalyticsService {
       const rows: string[][] = [infoTitleRow, infoRow, metaRow, header]
       const myWxid = this.cleanAccountDirName(this.configService.get('myWxid') || '')
 
+      const displayNames = await displayNamesPromise
+      const nicknameCandidates = this.buildIdCandidates([
+        ...members.map((m) => m.username),
+        ...members.map((m) => m.originalName),
+        ...Array.from(contactMap.values()).map((c) => c?.username),
+        ...Array.from(contactMap.values()).map((c) => c?.userName),
+        ...Array.from(contactMap.values()).map((c) => c?.encryptUsername),
+        ...Array.from(contactMap.values()).map((c) => c?.encryptUserName),
+        ...Array.from(contactMap.values()).map((c) => c?.alias)
+      ])
+      const groupNicknames = await this.getGroupNicknamesForRoom(chatroomId, nicknameCandidates)
+
       for (const member of members) {
         const wxid = member.username
         const normalizedWxid = this.cleanAccountDirName(wxid || '')
@@ -460,13 +704,20 @@ class GroupAnalyticsService {
         const fallbackName = displayNames.success && displayNames.map ? (displayNames.map[wxid] || '') : ''
         const nickName = contact?.nickName || fallbackName || ''
         const remark = contact?.remark || ''
-        const rawGroupNickname = groupNicknames.get(wxid.toLowerCase()) || ''
         const alias = contact?.alias || ''
-        const groupNickname = this.normalizeGroupNickname(
-          rawGroupNickname,
-          normalizedWxid === myWxid ? myWxid : wxid,
-          ''
-        )
+        const lookupCandidates = this.buildIdCandidates([
+          wxid,
+          member.originalName,
+          contact?.username,
+          contact?.userName,
+          contact?.encryptUsername,
+          contact?.encryptUserName,
+          alias
+        ])
+        if (normalizedWxid === myWxid) {
+          lookupCandidates.push(myWxid)
+        }
+        const groupNickname = this.resolveGroupNicknameByCandidates(groupNicknames, lookupCandidates)
 
         rows.push([nickName, remark, groupNickname, wxid, alias])
       }

electron/services/httpService.ts

@@ -0,0 +1,745 @@
+/**
+ * HTTP API 服务
+ * 提供 ChatLab 标准化格式的消息查询 API
+ */
+import * as http from 'http'
+import { URL } from 'url'
+import { chatService, Message } from './chatService'
+import { wcdbService } from './wcdbService'
+import { ConfigService } from './config'
+
+// ChatLab 格式定义
+interface ChatLabHeader {
+  version: string
+  exportedAt: number
+  generator: string
+  description?: string
+}
+
+interface ChatLabMeta {
+  name: string
+  platform: string
+  type: 'group' | 'private'
+  groupId?: string
+  groupAvatar?: string
+  ownerId?: string
+}
+
+interface ChatLabMember {
+  platformId: string
+  accountName: string
+  groupNickname?: string
+  aliases?: string[]
+  avatar?: string
+}
+
+interface ChatLabMessage {
+  sender: string
+  accountName: string
+  groupNickname?: string
+  timestamp: number
+  type: number
+  content: string | null
+  platformMessageId?: string
+  replyToMessageId?: string
+}
+
+interface ChatLabData {
+  chatlab: ChatLabHeader
+  meta: ChatLabMeta
+  members: ChatLabMember[]
+  messages: ChatLabMessage[]
+}
+
+// ChatLab 消息类型映射
+const ChatLabType = {
+  TEXT: 0,
+  IMAGE: 1,
+  VOICE: 2,
+  VIDEO: 3,
+  FILE: 4,
+  EMOJI: 5,
+  LINK: 7,
+  LOCATION: 8,
+  RED_PACKET: 20,
+  TRANSFER: 21,
+  POKE: 22,
+  CALL: 23,
+  SHARE: 24,
+  REPLY: 25,
+  FORWARD: 26,
+  CONTACT: 27,
+  SYSTEM: 80,
+  RECALL: 81,
+  OTHER: 99
+} as const
+
+class HttpService {
+  private server: http.Server | null = null
+  private configService: ConfigService
+  private port: number = 5031
+  private running: boolean = false
+  private connections: Set<import('net').Socket> = new Set()
+
+  constructor() {
+    this.configService = ConfigService.getInstance()
+  }
+
+  /**
+   * 启动 HTTP 服务
+   */
+  async start(port: number = 5031): Promise<{ success: boolean; port?: number; error?: string }> {
+    if (this.running && this.server) {
+      return { success: true, port: this.port }
+    }
+
+    this.port = port
+
+    return new Promise((resolve) => {
+      this.server = http.createServer((req, res) => this.handleRequest(req, res))
+
+      // 跟踪所有连接，以便关闭时能强制断开
+      this.server.on('connection', (socket) => {
+        this.connections.add(socket)
+        socket.on('close', () => {
+          this.connections.delete(socket)
+        })
+      })
+
+      this.server.on('error', (err: NodeJS.ErrnoException) => {
+        if (err.code === 'EADDRINUSE') {
+          console.error(`[HttpService] Port ${this.port} is already in use`)
+          resolve({ success: false, error: `Port ${this.port} is already in use` })
+        } else {
+          console.error('[HttpService] Server error:', err)
+          resolve({ success: false, error: err.message })
+        }
+      })
+
+      this.server.listen(this.port, '127.0.0.1', () => {
+        this.running = true
+        console.log(`[HttpService] HTTP API server started on http://127.0.0.1:${this.port}`)
+        resolve({ success: true, port: this.port })
+      })
+    })
+  }
+
+  /**
+   * 停止 HTTP 服务
+   */
+  async stop(): Promise<void> {
+    return new Promise((resolve) => {
+      if (this.server) {
+        // 强制关闭所有活动连接
+        for (const socket of this.connections) {
+          socket.destroy()
+        }
+        this.connections.clear()
+
+        this.server.close(() => {
+          this.running = false
+          this.server = null
+          console.log('[HttpService] HTTP API server stopped')
+          resolve()
+        })
+      } else {
+        this.running = false
+        resolve()
+      }
+    })
+  }
+
+  /**
+   * 检查服务是否运行
+   */
+  isRunning(): boolean {
+    return this.running
+  }
+
+  /**
+   * 获取当前端口
+   */
+  getPort(): number {
+    return this.port
+  }
+
+  /**
+   * 处理 HTTP 请求
+   */
+  private async handleRequest(req: http.IncomingMessage, res: http.ServerResponse): Promise<void> {
+    // 设置 CORS 头
+    res.setHeader('Access-Control-Allow-Origin', '*')
+    res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS')
+    res.setHeader('Access-Control-Allow-Headers', 'Content-Type')
+
+    if (req.method === 'OPTIONS') {
+      res.writeHead(204)
+      res.end()
+      return
+    }
+
+    const url = new URL(req.url || '/', `http://127.0.0.1:${this.port}`)
+    const pathname = url.pathname
+
+    try {
+      // 路由处理
+      if (pathname === '/health' || pathname === '/api/v1/health') {
+        this.sendJson(res, { status: 'ok' })
+      } else if (pathname === '/api/v1/messages') {
+        await this.handleMessages(url, res)
+      } else if (pathname === '/api/v1/sessions') {
+        await this.handleSessions(url, res)
+      } else if (pathname === '/api/v1/contacts') {
+        await this.handleContacts(url, res)
+      } else {
+        this.sendError(res, 404, 'Not Found')
+      }
+    } catch (error) {
+      console.error('[HttpService] Request error:', error)
+      this.sendError(res, 500, String(error))
+    }
+  }
+
+  /**
+   * 批量获取消息（循环游标直到满足 limit）
+   * 绕过 chatService 的单 batch 限制，直接操作 wcdbService 游标
+   */
+  private async fetchMessagesBatch(
+    talker: string,
+    offset: number,
+    limit: number,
+    startTime: number,
+    endTime: number,
+    ascending: boolean
+  ): Promise<{ success: boolean; messages?: Message[]; hasMore?: boolean; error?: string }> {
+    try {
+      // 使用固定 batch 大小（与 limit 相同或最大 500）来减少循环次数
+      const batchSize = Math.min(limit, 500)
+      const beginTimestamp = startTime > 10000000000 ? Math.floor(startTime / 1000) : startTime
+      const endTimestamp = endTime > 10000000000 ? Math.floor(endTime / 1000) : endTime
+
+      const cursorResult = await wcdbService.openMessageCursor(talker, batchSize, ascending, beginTimestamp, endTimestamp)
+      if (!cursorResult.success || !cursorResult.cursor) {
+        return { success: false, error: cursorResult.error || '打开消息游标失败' }
+      }
+
+      const cursor = cursorResult.cursor
+      try {
+        const allRows: Record<string, any>[] = []
+        let hasMore = true
+        let skipped = 0
+
+        // 循环获取消息，处理 offset 跳过 + limit 累积
+        while (allRows.length < limit && hasMore) {
+          const batch = await wcdbService.fetchMessageBatch(cursor)
+          if (!batch.success || !batch.rows || batch.rows.length === 0) {
+            hasMore = false
+            break
+          }
+
+          let rows = batch.rows
+          hasMore = batch.hasMore === true
+
+          // 处理 offset: 跳过前 N 条
+          if (skipped < offset) {
+            const remaining = offset - skipped
+            if (remaining >= rows.length) {
+              skipped += rows.length
+              continue
+            }
+            rows = rows.slice(remaining)
+            skipped = offset
+          }
+
+          allRows.push(...rows)
+        }
+
+        const trimmedRows = allRows.slice(0, limit)
+        const finalHasMore = hasMore || allRows.length > limit
+        const messages = this.mapRowsToMessagesSimple(trimmedRows)
+        return { success: true, messages, hasMore: finalHasMore }
+      } finally {
+        await wcdbService.closeMessageCursor(cursor)
+      }
+    } catch (e) {
+      console.error('[HttpService] fetchMessagesBatch error:', e)
+      return { success: false, error: String(e) }
+    }
+  }
+
+  /**
+   * 简单的行数据到 Message 映射（用于 API 输出）
+   */
+  private mapRowsToMessagesSimple(rows: Record<string, any>[]): Message[] {
+    const myWxid = this.configService.get('myWxid') || ''
+    const messages: Message[] = []
+
+    for (const row of rows) {
+      const content = this.getField(row, ['message_content', 'messageContent', 'content', 'msg_content', 'WCDB_CT_message_content']) || ''
+      const localType = parseInt(this.getField(row, ['local_type', 'localType', 'type', 'msg_type', 'WCDB_CT_local_type']) || '1', 10)
+      const isSendRaw = this.getField(row, ['computed_is_send', 'computedIsSend', 'is_send', 'isSend', 'WCDB_CT_is_send'])
+      const senderUsername = this.getField(row, ['sender_username', 'senderUsername', 'sender', 'WCDB_CT_sender_username']) || ''
+      const createTime = parseInt(this.getField(row, ['create_time', 'createTime', 'msg_create_time', 'WCDB_CT_create_time']) || '0', 10)
+      const localId = parseInt(this.getField(row, ['local_id', 'localId', 'WCDB_CT_local_id', 'rowid']) || '0', 10)
+      const serverId = this.getField(row, ['server_id', 'serverId', 'WCDB_CT_server_id']) || ''
+
+      let isSend: number
+      if (isSendRaw !== null && isSendRaw !== undefined) {
+        isSend = parseInt(isSendRaw, 10)
+      } else if (senderUsername && myWxid) {
+        isSend = senderUsername.toLowerCase() === myWxid.toLowerCase() ? 1 : 0
+      } else {
+        isSend = 0
+      }
+
+      // 解析消息内容中的特殊字段
+      let parsedContent = content
+      let xmlType: string | undefined
+      let linkTitle: string | undefined
+      let fileName: string | undefined
+      let emojiCdnUrl: string | undefined
+      let emojiMd5: string | undefined
+      let imageMd5: string | undefined
+      let videoMd5: string | undefined
+      let cardNickname: string | undefined
+
+      if (localType === 49 && content) {
+        // 提取 type 子标签
+        const typeMatch = /<type>(\d+)<\/type>/i.exec(content)
+        if (typeMatch) xmlType = typeMatch[1]
+        // 提取 title
+        const titleMatch = /<title>([^<]*)<\/title>/i.exec(content)
+        if (titleMatch) linkTitle = titleMatch[1]
+        // 提取文件名
+        const fnMatch = /<title>([^<]*)<\/title>/i.exec(content)
+        if (fnMatch) fileName = fnMatch[1]
+      }
+
+      if (localType === 47 && content) {
+        const cdnMatch = /cdnurl\s*=\s*"([^"]+)"/i.exec(content)
+        if (cdnMatch) emojiCdnUrl = cdnMatch[1]
+        const md5Match = /md5\s*=\s*"([^"]+)"/i.exec(content)
+        if (md5Match) emojiMd5 = md5Match[1]
+      }
+
+      messages.push({
+        localId,
+        talker: '',
+        localType,
+        createTime,
+        sortSeq: createTime,
+        content: parsedContent,
+        isSend,
+        senderUsername,
+        serverId: serverId ? parseInt(serverId, 10) || 0 : 0,
+        rawContent: content,
+        parsedContent: content,
+        emojiCdnUrl,
+        emojiMd5,
+        imageMd5,
+        videoMd5,
+        xmlType,
+        linkTitle,
+        fileName,
+        cardNickname
+      } as Message)
+    }
+
+    return messages
+  }
+
+  /**
+   * 从行数据中获取字段值（兼容多种字段名）
+   */
+  private getField(row: Record<string, any>, keys: string[]): string | null {
+    for (const key of keys) {
+      if (row[key] !== undefined && row[key] !== null) {
+        return String(row[key])
+      }
+    }
+    return null
+  }
+
+  /**
+   * 处理消息查询
+   * GET /api/v1/messages?talker=xxx&limit=100&start=20260101&chatlab=1
+   */
+  private async handleMessages(url: URL, res: http.ServerResponse): Promise<void> {
+    const talker = url.searchParams.get('talker')
+    const limit = Math.min(parseInt(url.searchParams.get('limit') || '100', 10), 10000)
+    const offset = parseInt(url.searchParams.get('offset') || '0', 10)
+    const startParam = url.searchParams.get('start')
+    const endParam = url.searchParams.get('end')
+    const chatlab = url.searchParams.get('chatlab') === '1'
+    const formatParam = url.searchParams.get('format')
+    const format = formatParam || (chatlab ? 'chatlab' : 'json')
+
+    if (!talker) {
+      this.sendError(res, 400, 'Missing required parameter: talker')
+      return
+    }
+
+    // 解析时间参数 (支持 YYYYMMDD 格式)
+    const startTime = this.parseTimeParam(startParam)
+    const endTime = this.parseTimeParam(endParam, true)
+
+    // 使用批量获取方法，绕过 chatService 的单 batch 限制
+    const result = await this.fetchMessagesBatch(talker, offset, limit, startTime, endTime, true)
+    if (!result.success || !result.messages) {
+      this.sendError(res, 500, result.error || 'Failed to get messages')
+      return
+    }
+
+    if (format === 'chatlab') {
+      // 获取会话显示名
+      const displayNames = await this.getDisplayNames([talker])
+      const talkerName = displayNames[talker] || talker
+
+      const chatLabData = await this.convertToChatLab(result.messages, talker, talkerName)
+      this.sendJson(res, chatLabData)
+    } else {
+      // 返回原始消息格式
+      this.sendJson(res, {
+        success: true,
+        talker,
+        count: result.messages.length,
+        hasMore: result.hasMore,
+        messages: result.messages
+      })
+    }
+  }
+
+  /**
+   * 处理会话列表查询
+   * GET /api/v1/sessions?keyword=xxx&limit=100
+   */
+  private async handleSessions(url: URL, res: http.ServerResponse): Promise<void> {
+    const keyword = url.searchParams.get('keyword') || ''
+    const limit = parseInt(url.searchParams.get('limit') || '100', 10)
+
+    try {
+      const sessions = await chatService.getSessions()
+      if (!sessions.success || !sessions.sessions) {
+        this.sendError(res, 500, sessions.error || 'Failed to get sessions')
+        return
+      }
+
+      let filteredSessions = sessions.sessions
+      if (keyword) {
+        const lowerKeyword = keyword.toLowerCase()
+        filteredSessions = sessions.sessions.filter(s => 
+          s.username.toLowerCase().includes(lowerKeyword) ||
+          (s.displayName && s.displayName.toLowerCase().includes(lowerKeyword))
+        )
+      }
+
+      // 应用 limit
+      const limitedSessions = filteredSessions.slice(0, limit)
+
+      this.sendJson(res, {
+        success: true,
+        count: limitedSessions.length,
+        sessions: limitedSessions.map(s => ({
+          username: s.username,
+          displayName: s.displayName,
+          type: s.type,
+          lastTimestamp: s.lastTimestamp,
+          unreadCount: s.unreadCount
+        }))
+      })
+    } catch (error) {
+      this.sendError(res, 500, String(error))
+    }
+  }
+
+  /**
+   * 处理联系人查询
+   * GET /api/v1/contacts?keyword=xxx&limit=100
+   */
+  private async handleContacts(url: URL, res: http.ServerResponse): Promise<void> {
+    const keyword = url.searchParams.get('keyword') || ''
+    const limit = parseInt(url.searchParams.get('limit') || '100', 10)
+
+    try {
+      const contacts = await chatService.getContacts()
+      if (!contacts.success || !contacts.contacts) {
+        this.sendError(res, 500, contacts.error || 'Failed to get contacts')
+        return
+      }
+
+      let filteredContacts = contacts.contacts
+      if (keyword) {
+        const lowerKeyword = keyword.toLowerCase()
+        filteredContacts = contacts.contacts.filter(c =>
+          c.username.toLowerCase().includes(lowerKeyword) ||
+          (c.nickname && c.nickname.toLowerCase().includes(lowerKeyword)) ||
+          (c.remark && c.remark.toLowerCase().includes(lowerKeyword)) ||
+          (c.displayName && c.displayName.toLowerCase().includes(lowerKeyword))
+        )
+      }
+
+      const limited = filteredContacts.slice(0, limit)
+
+      this.sendJson(res, {
+        success: true,
+        count: limited.length,
+        contacts: limited
+      })
+    } catch (error) {
+      this.sendError(res, 500, String(error))
+    }
+  }
+
+  /**
+   * 解析时间参数
+   * 支持 YYYYMMDD 格式，返回秒级时间戳
+   */
+  private parseTimeParam(param: string | null, isEnd: boolean = false): number {
+    if (!param) return 0
+
+    // 纯数字且长度为8，视为 YYYYMMDD
+    if (/^\d{8}$/.test(param)) {
+      const year = parseInt(param.slice(0, 4), 10)
+      const month = parseInt(param.slice(4, 6), 10) - 1
+      const day = parseInt(param.slice(6, 8), 10)
+      const date = new Date(year, month, day)
+      if (isEnd) {
+        // 结束时间设为当天 23:59:59
+        date.setHours(23, 59, 59, 999)
+      }
+      return Math.floor(date.getTime() / 1000)
+    }
+
+    // 纯数字，视为时间戳
+    if (/^\d+$/.test(param)) {
+      const ts = parseInt(param, 10)
+      // 如果是毫秒级时间戳，转为秒级
+      return ts > 10000000000 ? Math.floor(ts / 1000) : ts
+    }
+
+    return 0
+  }
+
+  /**
+   * 获取显示名称
+   */
+  private async getDisplayNames(usernames: string[]): Promise<Record<string, string>> {
+    try {
+      const result = await wcdbService.getDisplayNames(usernames)
+      if (result.success && result.map) {
+        return result.map
+      }
+    } catch (e) {
+      console.error('[HttpService] Failed to get display names:', e)
+    }
+    // 返回空对象，调用方会使用 username 作为备用
+    return {}
+  }
+
+  /**
+   * 转换为 ChatLab 格式
+   */
+  private async convertToChatLab(messages: Message[], talkerId: string, talkerName: string): Promise<ChatLabData> {
+    const isGroup = talkerId.endsWith('@chatroom')
+    const myWxid = this.configService.get('myWxid') || ''
+
+    // 收集所有发送者
+    const senderSet = new Set<string>()
+    for (const msg of messages) {
+      if (msg.senderUsername) {
+        senderSet.add(msg.senderUsername)
+      }
+    }
+
+    // 获取发送者显示名
+    const senderNames = await this.getDisplayNames(Array.from(senderSet))
+
+    // 获取群昵称（如果是群聊）
+    let groupNicknamesMap = new Map<string, string>()
+    if (isGroup) {
+      try {
+        const result = await wcdbService.getGroupNicknames(talkerId)
+        if (result.success && result.nicknames) {
+          groupNicknamesMap = new Map(Object.entries(result.nicknames))
+        }
+      } catch (e) {
+        console.error('[HttpService] Failed to get group nicknames:', e)
+      }
+    }
+
+    // 构建成员列表
+    const memberMap = new Map<string, ChatLabMember>()
+    for (const msg of messages) {
+      const sender = msg.senderUsername || ''
+      if (sender && !memberMap.has(sender)) {
+        const displayName = senderNames[sender] || sender
+        const isSelf = sender === myWxid || sender.toLowerCase() === myWxid.toLowerCase()
+        // 获取群昵称（尝试多种方式）
+        const groupNickname = isGroup 
+          ? (groupNicknamesMap.get(sender) || groupNicknamesMap.get(sender.toLowerCase()) || '')
+          : ''
+        memberMap.set(sender, {
+          platformId: sender,
+          accountName: isSelf ? '我' : displayName,
+          groupNickname: groupNickname || undefined
+        })
+      }
+    }
+
+    // 转换消息
+    const chatLabMessages: ChatLabMessage[] = messages.map(msg => {
+      const sender = msg.senderUsername || ''
+      const isSelf = msg.isSend === 1 || sender === myWxid
+      const accountName = isSelf ? '我' : (senderNames[sender] || sender)
+      // 获取该发送者的群昵称
+      const groupNickname = isGroup 
+        ? (groupNicknamesMap.get(sender) || groupNicknamesMap.get(sender.toLowerCase()) || '')
+        : ''
+
+      return {
+        sender,
+        accountName,
+        groupNickname: groupNickname || undefined,
+        timestamp: msg.createTime,
+        type: this.mapMessageType(msg.localType, msg),
+        content: this.getMessageContent(msg),
+        platformMessageId: msg.serverId ? String(msg.serverId) : undefined
+      }
+    })
+
+    return {
+      chatlab: {
+        version: '0.0.2',
+        exportedAt: Math.floor(Date.now() / 1000),
+        generator: 'WeFlow'
+      },
+      meta: {
+        name: talkerName,
+        platform: 'wechat',
+        type: isGroup ? 'group' : 'private',
+        groupId: isGroup ? talkerId : undefined,
+        ownerId: myWxid || undefined
+      },
+      members: Array.from(memberMap.values()),
+      messages: chatLabMessages
+    }
+  }
+
+  /**
+   * 映射 WeChat 消息类型到 ChatLab 类型
+   */
+  private mapMessageType(localType: number, msg: Message): number {
+    switch (localType) {
+      case 1: // 文本
+        return ChatLabType.TEXT
+      case 3: // 图片
+        return ChatLabType.IMAGE
+      case 34: // 语音
+        return ChatLabType.VOICE
+      case 43: // 视频
+        return ChatLabType.VIDEO
+      case 47: // 动画表情
+        return ChatLabType.EMOJI
+      case 48: // 位置
+        return ChatLabType.LOCATION
+      case 42: // 名片
+        return ChatLabType.CONTACT
+      case 50: // 语音/视频通话
+        return ChatLabType.CALL
+      case 10000: // 系统消息
+        return ChatLabType.SYSTEM
+      case 49: // 复合消息
+        return this.mapType49(msg)
+      case 244813135921: // 引用消息
+        return ChatLabType.REPLY
+      case 266287972401: // 拍一拍
+        return ChatLabType.POKE
+      case 8594229559345: // 红包
+        return ChatLabType.RED_PACKET
+      case 8589934592049: // 转账
+        return ChatLabType.TRANSFER
+      default:
+        return ChatLabType.OTHER
+    }
+  }
+
+  /**
+   * 映射 Type 49 子类型
+   */
+  private mapType49(msg: Message): number {
+    const xmlType = msg.xmlType
+
+    switch (xmlType) {
+      case '5': // 链接
+      case '49':
+        return ChatLabType.LINK
+      case '6': // 文件
+        return ChatLabType.FILE
+      case '19': // 聊天记录
+        return ChatLabType.FORWARD
+      case '33': // 小程序
+      case '36':
+        return ChatLabType.SHARE
+      case '57': // 引用消息
+        return ChatLabType.REPLY
+      case '2000': // 转账
+        return ChatLabType.TRANSFER
+      case '2001': // 红包
+        return ChatLabType.RED_PACKET
+      default:
+        return ChatLabType.OTHER
+    }
+  }
+
+  /**
+   * 获取消息内容
+   */
+  private getMessageContent(msg: Message): string | null {
+    // 优先使用已解析的内容
+    if (msg.parsedContent) {
+      return msg.parsedContent
+    }
+
+    // 根据类型返回占位符
+    switch (msg.localType) {
+      case 1:
+        return msg.rawContent || null
+      case 3:
+        return msg.imageMd5 || '[图片]'
+      case 34:
+        return '[语音]'
+      case 43:
+        return msg.videoMd5 || '[视频]'
+      case 47:
+        return msg.emojiCdnUrl || msg.emojiMd5 || '[表情]'
+      case 42:
+        return msg.cardNickname || '[名片]'
+      case 48:
+        return '[位置]'
+      case 49:
+        return msg.linkTitle || msg.fileName || '[消息]'
+      default:
+        return msg.rawContent || null
+    }
+  }
+
+  /**
+   * 发送 JSON 响应
+   */
+  private sendJson(res: http.ServerResponse, data: any): void {
+    res.setHeader('Content-Type', 'application/json; charset=utf-8')
+    res.writeHead(200)
+    res.end(JSON.stringify(data, null, 2))
+  }
+
+  /**
+   * 发送错误响应
+   */
+  private sendError(res: http.ServerResponse, code: number, message: string): void {
+    res.setHeader('Content-Type', 'application/json; charset=utf-8')
+    res.writeHead(code)
+    res.end(JSON.stringify({ error: message }))
+  }
+}
+
+export const httpService = new HttpService()

electron/services/wcdbCore.ts

@@ -44,7 +44,9 @@ export class WcdbCore {
   private wcdbGetAvailableYears: any = null
   private wcdbGetAnnualReportStats: any = null
   private wcdbGetAnnualReportExtras: any = null
+  private wcdbGetDualReportStats: any = null
   private wcdbGetGroupStats: any = null
+  private wcdbGetMessageDates: any = null
   private wcdbOpenMessageCursor: any = null
   private wcdbOpenMessageCursorLite: any = null
   private wcdbFetchMessageBatch: any = null
@@ -298,9 +300,6 @@ export class WcdbCore {
         return false
       }
 
-      // 关键修复：显式预加载依赖库 WCDB.dll 和 SDL2.dll
-      // Windows 加载器默认不会查找子目录中的依赖，必须先将其加载到内存
-      // 这可以解决部分用户因为 VC++ 运行时或 DLL 依赖问题导致的闪退
       const dllDir = dirname(dllPath)
       const wcdbCorePath = join(dllDir, 'WCDB.dll')
       if (existsSync(wcdbCorePath)) {
@@ -456,6 +455,13 @@ export class WcdbCore {
         this.wcdbGetAnnualReportExtras = null
       }
 
+      // wcdb_status wcdb_get_dual_report_stats(wcdb_handle handle, const char* session_id, int32_t begin_timestamp, int32_t end_timestamp, char** out_json)
+      try {
+        this.wcdbGetDualReportStats = this.lib.func('int32 wcdb_get_dual_report_stats(int64 handle, const char* sessionId, int32 begin, int32 end, _Out_ void** outJson)')
+      } catch {
+        this.wcdbGetDualReportStats = null
+      }
+
       // wcdb_status wcdb_get_logs(char** out_json)
       try {
         this.wcdbGetLogs = this.lib.func('int32 wcdb_get_logs(_Out_ void** outJson)')
@@ -470,6 +476,13 @@ export class WcdbCore {
         this.wcdbGetGroupStats = null
       }
 
+      // wcdb_status wcdb_get_message_dates(wcdb_handle handle, const char* session_id, char** out_json)
+      try {
+        this.wcdbGetMessageDates = this.lib.func('int32 wcdb_get_message_dates(int64 handle, const char* sessionId, _Out_ void** outJson)')
+      } catch {
+        this.wcdbGetMessageDates = null
+      }
+
       // wcdb_status wcdb_open_message_cursor(wcdb_handle handle, const char* session_id, int32_t batch_size, int32_t ascending, int32_t begin_timestamp, int32_t end_timestamp, wcdb_cursor* out_cursor)
       this.wcdbOpenMessageCursor = this.lib.func('int32 wcdb_open_message_cursor(int64 handle, const char* sessionId, int32 batchSize, int32 ascending, int32 beginTimestamp, int32 endTimestamp, _Out_ int64* outCursor)')
 
@@ -1186,6 +1199,29 @@ export class WcdbCore {
     }
   }
 
+  async getMessageDates(sessionId: string): Promise<{ success: boolean; dates?: string[]; error?: string }> {
+    if (!this.ensureReady()) {
+      return { success: false, error: 'WCDB 未连接' }
+    }
+    try {
+      if (!this.wcdbGetMessageDates) {
+        return { success: false, error: 'DLL 不支持 getMessageDates' }
+      }
+      const outPtr = [null as any]
+      const result = this.wcdbGetMessageDates(this.handle, sessionId, outPtr)
+      if (result !== 0 || !outPtr[0]) {
+        // 空结果也可能是正常的（无消息）
+        return { success: true, dates: [] }
+      }
+      const jsonStr = this.decodeJsonPtr(outPtr[0])
+      if (!jsonStr) return { success: false, error: '解析日期列表失败' }
+      const dates = JSON.parse(jsonStr)
+      return { success: true, dates }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
+
   async getMessageTableStats(sessionId: string): Promise<{ success: boolean; tables?: any[]; error?: string }> {
     if (!this.ensureReady()) {
       return { success: false, error: 'WCDB 未连接' }
@@ -1710,4 +1746,26 @@ export class WcdbCore {
       return { success: false, error: String(e) }
     }
   }
+  async getDualReportStats(sessionId: string, beginTimestamp: number = 0, endTimestamp: number = 0): Promise<{ success: boolean; data?: any; error?: string }> {
+    if (!this.ensureReady()) {
+      return { success: false, error: 'WCDB 未连接' }
+    }
+    if (!this.wcdbGetDualReportStats) {
+      return { success: false, error: '未支持双人报告统计' }
+    }
+    try {
+      const { begin, end } = this.normalizeRange(beginTimestamp, endTimestamp)
+      const outPtr = [null as any]
+      const result = this.wcdbGetDualReportStats(this.handle, sessionId, begin, end, outPtr)
+      if (result !== 0 || !outPtr[0]) {
+        return { success: false, error: `获取双人报告统计失败: ${result}` }
+      }
+      const jsonStr = this.decodeJsonPtr(outPtr[0])
+      if (!jsonStr) return { success: false, error: '解析双人报告统计失败' }
+      const data = JSON.parse(jsonStr)
+      return { success: true, data }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
 }

electron/services/wcdbService.ts

@@ -273,6 +273,10 @@ export class WcdbService {
     return this.callWorker('getMessageTableStats', { sessionId })
   }
 
+  async getMessageDates(sessionId: string): Promise<{ success: boolean; dates?: string[]; error?: string }> {
+    return this.callWorker('getMessageDates', { sessionId })
+  }
+
   /**
    * 获取消息元数据
    */
@@ -315,6 +319,13 @@ export class WcdbService {
     return this.callWorker('getAnnualReportExtras', { sessionIds, beginTimestamp, endTimestamp, peakDayBegin, peakDayEnd })
   }
 
+  /**
+   * 获取双人报告统计数据
+   */
+  async getDualReportStats(sessionId: string, beginTimestamp: number, endTimestamp: number): Promise<{ success: boolean; data?: any; error?: string }> {
+    return this.callWorker('getDualReportStats', { sessionId, beginTimestamp, endTimestamp })
+  }
+
   /**
    * 获取群聊统计
    */

electron/wcdbWorker.ts

@@ -78,6 +78,9 @@ if (parentPort) {
                 case 'getMessageTableStats':
                     result = await core.getMessageTableStats(payload.sessionId)
                     break
+                case 'getMessageDates':
+                    result = await core.getMessageDates(payload.sessionId)
+                    break
                 case 'getMessageMeta':
                     result = await core.getMessageMeta(payload.dbPath, payload.tableName, payload.limit, payload.offset)
                     break
@@ -96,6 +99,9 @@ if (parentPort) {
                 case 'getAnnualReportExtras':
                     result = await core.getAnnualReportExtras(payload.sessionIds, payload.beginTimestamp, payload.endTimestamp, payload.peakDayBegin, payload.peakDayEnd)
                     break
+                case 'getDualReportStats':
+                    result = await core.getDualReportStats(payload.sessionId, payload.beginTimestamp, payload.endTimestamp)
+                    break
                 case 'getGroupStats':
                     result = await core.getGroupStats(payload.chatroomId, payload.beginTimestamp, payload.endTimestamp)
                     break

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "weflow",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "weflow",
-      "version": "1.5.2",
+      "version": "1.5.4",
       "hasInstallScript": true,
       "dependencies": {
         "better-sqlite3": "^12.5.0",
@@ -11428,12 +11428,6 @@
         "sherpa-onnx-win-x64": "^1.12.23"
       }
     },
-    "node_modules/sherpa-onnx-node/node_modules/sherpa-onnx-darwin-x64": {
-      "optional": true
-    },
-    "node_modules/sherpa-onnx-node/node_modules/sherpa-onnx-linux-arm64": {
-      "optional": true
-    },
     "node_modules/sherpa-onnx-win-ia32": {
       "version": "1.12.23",
       "resolved": "https://registry.npmmirror.com/sherpa-onnx-win-ia32/-/sherpa-onnx-win-ia32-1.12.23.tgz",
@@ -13032,4 +13026,4 @@
       }
     }
   }
-}
+}

package.json

@@ -1,6 +1,6 @@
 {
   "name": "weflow",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "WeFlow",
   "main": "dist-electron/main.js",
   "author": "cc",

src/App.scss

@@ -6,6 +6,17 @@
   animation: appFadeIn 0.35s ease-out;
 }
 
+.window-drag-region {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 150px; // 预留系统最小化/最大化/关闭按钮区域
+  height: 40px;
+  -webkit-app-region: drag;
+  pointer-events: auto;
+  z-index: 2000;
+}
+
 .main-layout {
   flex: 1;
   display: flex;

src/App.tsx

@@ -34,6 +34,7 @@ import UpdateDialog from './components/UpdateDialog'
 import UpdateProgressCapsule from './components/UpdateProgressCapsule'
 import LockScreen from './components/LockScreen'
 import { GlobalSessionMonitor } from './components/GlobalSessionMonitor'
+import { BatchTranscribeGlobal } from './components/BatchTranscribeGlobal'
 
 function App() {
   const navigate = useNavigate()
@@ -345,6 +346,7 @@ function App() {
   // 主窗口 - 完整布局
   return (
     <div className="app-container">
+      <div className="window-drag-region" aria-hidden="true" />
       {isLocked && (
         <LockScreen
           onUnlock={() => setLocked(false)}
@@ -360,6 +362,9 @@ function App() {
       {/* 全局会话监听与通知 */}
       <GlobalSessionMonitor />
 
+      {/* 全局批量转写进度浮窗 */}
+      <BatchTranscribeGlobal />
+
       {/* 用户协议弹窗 */}
       {showAgreement && !agreementLoading && (
         <div className="agreement-overlay">

src/components/BatchTranscribeGlobal.tsx

@@ -0,0 +1,147 @@
+import React, { useEffect, useState } from 'react'
+import { createPortal } from 'react-dom'
+import { Loader2, X, CheckCircle, XCircle, AlertCircle, Clock } from 'lucide-react'
+import { useBatchTranscribeStore } from '../stores/batchTranscribeStore'
+import '../styles/batchTranscribe.scss'
+
+/**
+ * 全局批量转写进度浮窗 + 结果弹窗
+ * 挂载在 App 层，切换页面时不会消失
+ */
+export const BatchTranscribeGlobal: React.FC = () => {
+  const {
+    isBatchTranscribing,
+    progress,
+    showToast,
+    showResult,
+    result,
+    sessionName,
+    startTime,
+    setShowToast,
+    setShowResult
+  } = useBatchTranscribeStore()
+
+  const [eta, setEta] = useState<string>('')
+
+  // 计算剩余时间
+  useEffect(() => {
+    if (!isBatchTranscribing || !startTime || progress.current === 0) {
+      setEta('')
+      return
+    }
+
+    const timer = setInterval(() => {
+      const now = Date.now()
+      const elapsed = now - startTime
+      const rate = progress.current / elapsed // ms per item
+      const remainingItems = progress.total - progress.current
+
+      if (remainingItems <= 0) {
+        setEta('')
+        return
+      }
+
+      const remainingTimeMs = remainingItems / rate
+      const remainingSeconds = Math.ceil(remainingTimeMs / 1000)
+
+      if (remainingSeconds < 60) {
+        setEta(`${remainingSeconds}秒`)
+      } else {
+        const minutes = Math.floor(remainingSeconds / 60)
+        const seconds = remainingSeconds % 60
+        setEta(`${minutes}分${seconds}秒`)
+      }
+    }, 1000)
+
+    return () => clearInterval(timer)
+  }, [isBatchTranscribing, startTime, progress.current, progress.total])
+
+  return (
+    <>
+      {/* 批量转写进度浮窗（非阻塞） */}
+      {showToast && isBatchTranscribing && createPortal(
+        <div className="batch-progress-toast">
+          <div className="batch-progress-toast-header">
+            <div className="batch-progress-toast-title">
+              <Loader2 size={14} className="spin" />
+              <span>批量转写中{sessionName ? `（${sessionName}）` : ''}</span>
+            </div>
+            <button className="batch-progress-toast-close" onClick={() => setShowToast(false)} title="最小化">
+              <X size={14} />
+            </button>
+          </div>
+          <div className="batch-progress-toast-body">
+            <div className="progress-info-row">
+              <div className="progress-text">
+                <span>{progress.current} / {progress.total}</span>
+                <span className="progress-percent">
+                  {progress.total > 0
+                    ? Math.round((progress.current / progress.total) * 100)
+                    : 0}%
+                </span>
+              </div>
+              {eta && (
+                <div className="progress-eta">
+                  <Clock size={12} />
+                  <span>剩余 {eta}</span>
+                </div>
+              )}
+            </div>
+
+            <div className="progress-bar">
+              <div
+                className="progress-fill"
+                style={{
+                  width: `${progress.total > 0
+                    ? (progress.current / progress.total) * 100
+                    : 0}%`
+                }}
+              />
+            </div>
+          </div>
+        </div>,
+        document.body
+      )}
+
+      {/* 批量转写结果对话框 */}
+      {showResult && createPortal(
+        <div className="batch-modal-overlay" onClick={() => setShowResult(false)}>
+          <div className="batch-modal-content batch-result-modal" onClick={(e) => e.stopPropagation()}>
+            <div className="batch-modal-header">
+              <CheckCircle size={20} />
+              <h3>转写完成</h3>
+            </div>
+            <div className="batch-modal-body">
+              <div className="result-summary">
+                <div className="result-item success">
+                  <CheckCircle size={18} />
+                  <span className="label">成功:</span>
+                  <span className="value">{result.success} 条</span>
+                </div>
+                {result.fail > 0 && (
+                  <div className="result-item fail">
+                    <XCircle size={18} />
+                    <span className="label">失败:</span>
+                    <span className="value">{result.fail} 条</span>
+                  </div>
+                )}
+              </div>
+              {result.fail > 0 && (
+                <div className="result-tip">
+                  <AlertCircle size={16} />
+                  <span>部分语音转写失败，可能是语音文件损坏或网络问题</span>
+                </div>
+              )}
+            </div>
+            <div className="batch-modal-footer">
+              <button className="btn-primary" onClick={() => setShowResult(false)}>
+                确定
+              </button>
+            </div>
+          </div>
+        </div>,
+        document.body
+      )}
+    </>
+  )
+}

src/components/DateRangePicker.scss

@@ -70,6 +70,7 @@
       opacity: 0;
       transform: translateY(-8px);
     }
+
     to {
       opacity: 1;
       transform: translateY(0);
@@ -144,6 +145,7 @@
   .calendar-grid {
     display: grid;
     grid-template-columns: repeat(7, 1fr);
+    grid-template-rows: auto repeat(6, 32px);
     gap: 2px;
   }
 
@@ -156,7 +158,6 @@
   }
 
   .calendar-day {
-    aspect-ratio: 1;
     display: flex;
     align-items: center;
     justify-content: center;
@@ -211,4 +212,4 @@
     padding-top: 12px;
     border-top: 1px solid var(--border-color);
   }
-}
+}

src/components/DateRangePicker.tsx

@@ -86,7 +86,7 @@ function DateRangePicker({ startDate, endDate, onStartDateChange, onEndDateChang
 
   const handleDateClick = (day: number) => {
     const dateStr = `${currentMonth.getFullYear()}-${String(currentMonth.getMonth() + 1).padStart(2, '0')}-${String(day).padStart(2, '0')}`
-    
+
     if (selectingStart) {
       onStartDateChange(dateStr)
       if (endDate && dateStr > endDate) {
@@ -125,8 +125,8 @@ function DateRangePicker({ startDate, endDate, onStartDateChange, onEndDateChang
   const isToday = (day: number) => {
     const today = new Date()
     return currentMonth.getFullYear() === today.getFullYear() &&
-           currentMonth.getMonth() === today.getMonth() &&
-           day === today.getDate()
+      currentMonth.getMonth() === today.getMonth() &&
+      day === today.getDate()
   }
 
   const renderCalendar = () => {

src/components/GlobalSessionMonitor.tsx

@@ -81,6 +81,11 @@ export function GlobalSessionMonitor() {
     }
 
     const checkForNewMessages = async (oldSessions: ChatSession[], newSessions: ChatSession[]) => {
+        if (!oldSessions || oldSessions.length === 0) {
+            console.log('[NotificationFilter] Skipping check on initial load (empty baseline)')
+            return
+        }
+
         const oldMap = new Map(oldSessions.map(s => [s.username, s]))
 
         for (const newSession of newSessions) {
@@ -140,6 +145,14 @@ export function GlobalSessionMonitor() {
                     }
                 }
 
+                // 新增：如果未读数量没有增加，说明可能是自己在其他设备回复（或者已读），不弹通知
+                const oldUnread = oldSession ? oldSession.unreadCount : 0
+                const newUnread = newSession.unreadCount
+                if (newUnread <= oldUnread) {
+                    // 仅仅是状态同步（如自己在手机上发消息 or 已读），跳过通知
+                    continue
+                }
+
                 let title = newSession.displayName || newSession.username
                 let avatarUrl = newSession.avatarUrl
                 let content = newSession.summary || '[新消息]'

src/components/JumpToDateDialog.scss

@@ -100,6 +100,33 @@
 }
 
 .calendar-grid {
+    position: relative;
+
+    &.loading {
+
+        .weekdays,
+        .days {
+            pointer-events: none;
+        }
+    }
+
+    .calendar-loading {
+        position: absolute;
+        inset: 0;
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        gap: 8px;
+        color: var(--text-secondary);
+        font-size: 13px;
+
+        .spin {
+            color: var(--primary);
+            animation: spin 1s linear infinite;
+        }
+    }
+
     .weekdays {
         display: grid;
         grid-template-columns: repeat(7, 1fr);
@@ -117,10 +144,10 @@
     .days {
         display: grid;
         grid-template-columns: repeat(7, 1fr);
+        grid-template-rows: repeat(6, 36px);
         gap: 4px;
 
         .day-cell {
-            aspect-ratio: 1;
             display: flex;
             align-items: center;
             justify-content: center;
@@ -129,12 +156,13 @@
             border-radius: 8px;
             cursor: pointer;
             transition: all 0.2s;
+            position: relative;
 
             &.empty {
                 cursor: default;
             }
 
-            &:not(.empty):hover {
+            &:not(.empty):not(.no-message):hover {
                 background: var(--bg-hover);
             }
 
@@ -149,10 +177,43 @@
                 font-weight: 600;
                 background: var(--primary-light);
             }
+
+            // 无消息的日期 - 灰显且不可点击
+            &.no-message {
+                opacity: 0.3;
+                cursor: default;
+                pointer-events: none;
+            }
+
+            // 有消息的日期指示器小圆点
+            .message-dot {
+                position: absolute;
+                bottom: 3px;
+                left: 50%;
+                transform: translateX(-50%);
+                width: 4px;
+                height: 4px;
+                border-radius: 50%;
+                background: var(--primary);
+            }
+
+            &.selected .message-dot {
+                background: rgba(255, 255, 255, 0.7);
+            }
         }
     }
 }
 
+@keyframes spin {
+    from {
+        transform: rotate(0deg);
+    }
+
+    to {
+        transform: rotate(360deg);
+    }
+}
+
 .quick-options {
     display: flex;
     gap: 8px;

src/components/JumpToDateDialog.tsx

@@ -1,5 +1,5 @@
-import React, { useState } from 'react'
-import { X, ChevronLeft, ChevronRight, Calendar as CalendarIcon } from 'lucide-react'
+import React, { useState, useMemo } from 'react'
+import { X, ChevronLeft, ChevronRight, Calendar as CalendarIcon, Loader2 } from 'lucide-react'
 import './JumpToDateDialog.scss'
 
 interface JumpToDateDialogProps {
@@ -7,15 +7,22 @@ interface JumpToDateDialogProps {
     onClose: () => void
     onSelect: (date: Date) => void
     currentDate?: Date
+    /** 有消息的日期集合，格式为 YYYY-MM-DD */
+    messageDates?: Set<string>
+    /** 是否正在加载消息日期 */
+    loadingDates?: boolean
 }
 
 const JumpToDateDialog: React.FC<JumpToDateDialogProps> = ({
     isOpen,
     onClose,
     onSelect,
-    currentDate = new Date()
+    currentDate = new Date(),
+    messageDates,
+    loadingDates = false
 }) => {
-    const [calendarDate, setCalendarDate] = useState(new Date(currentDate))
+    const isValidDate = (d: any) => d instanceof Date && !isNaN(d.getTime())
+    const [calendarDate, setCalendarDate] = useState(isValidDate(currentDate) ? new Date(currentDate) : new Date())
     const [selectedDate, setSelectedDate] = useState(new Date(currentDate))
 
     if (!isOpen) return null
@@ -48,7 +55,20 @@ const JumpToDateDialog: React.FC<JumpToDateDialogProps> = ({
         return days
     }
 
+    /**
+     * 判断某天是否有消息
+     */
+    const hasMessage = (day: number): boolean => {
+        if (!messageDates || messageDates.size === 0) return true // 未加载时默认全部可点击
+        const year = calendarDate.getFullYear()
+        const month = calendarDate.getMonth() + 1
+        const dateStr = `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`
+        return messageDates.has(dateStr)
+    }
+
     const handleDateClick = (day: number) => {
+        // 如果已加载日期数据且该日期无消息，则不可点击
+        if (messageDates && messageDates.size > 0 && !hasMessage(day)) return
         const newDate = new Date(calendarDate.getFullYear(), calendarDate.getMonth(), day)
         setSelectedDate(newDate)
     }
@@ -71,6 +91,28 @@ const JumpToDateDialog: React.FC<JumpToDateDialogProps> = ({
             calendarDate.getFullYear() === selectedDate.getFullYear()
     }
 
+    /**
+     * 获取某天的 CSS 类名
+     */
+    const getDayClassName = (day: number | null): string => {
+        if (day === null) return 'day-cell empty'
+
+        const classes = ['day-cell']
+        if (isSelected(day)) classes.push('selected')
+        if (isToday(day)) classes.push('today')
+
+        // 仅在已加载消息日期数据时区分有/无消息
+        if (messageDates && messageDates.size > 0) {
+            if (hasMessage(day)) {
+                classes.push('has-message')
+            } else {
+                classes.push('no-message')
+            }
+        }
+
+        return classes.join(' ')
+    }
+
     const weekdays = ['日', '一', '二', '三', '四', '五', '六']
     const days = generateCalendar()
 
@@ -106,18 +148,28 @@ const JumpToDateDialog: React.FC<JumpToDateDialogProps> = ({
                         </button>
                     </div>
 
-                    <div className="calendar-grid">
-                        <div className="weekdays">
+                    <div className={`calendar-grid ${loadingDates ? 'loading' : ''}`}>
+                        {loadingDates && (
+                            <div className="calendar-loading">
+                                <Loader2 size={20} className="spin" />
+                                <span>正在加载...</span>
+                            </div>
+                        )}
+                        <div className="weekdays" style={{ visibility: loadingDates ? 'hidden' : 'visible' }}>
                             {weekdays.map(d => <div key={d} className="weekday">{d}</div>)}
                         </div>
-                        <div className="days">
+                        <div className="days" style={{ visibility: loadingDates ? 'hidden' : 'visible' }}>
                             {days.map((day, i) => (
                                 <div
                                     key={i}
-                                    className={`day-cell ${day === null ? 'empty' : ''} ${day !== null && isSelected(day) ? 'selected' : ''} ${day !== null && isToday(day) ? 'today' : ''}`}
+                                    className={getDayClassName(day)}
+                                    style={{ visibility: loadingDates ? 'hidden' : 'visible' }}
                                     onClick={() => day !== null && handleDateClick(day)}
                                 >
                                     {day}
+                                    {day !== null && messageDates && messageDates.size > 0 && hasMessage(day) && (
+                                        <span className="message-dot" />
+                                    )}
                                 </div>
                             ))}
                         </div>

src/components/ReportComponents.scss

@@ -0,0 +1,142 @@
+// Shared styles for Report components (Heatmap, WordCloud)
+
+// --- Heatmap ---
+.heatmap-wrapper {
+    margin-top: 24px;
+    width: 100%;
+}
+
+.heatmap-header {
+    display: grid;
+    grid-template-columns: 28px 1fr;
+    gap: 3px;
+    margin-bottom: 6px;
+    color: var(--ar-text-sub); // Assumes --ar-text-sub is defined in parent context or globally
+    font-size: 10px;
+}
+
+.time-labels {
+    display: grid;
+    grid-template-columns: repeat(24, 1fr);
+    gap: 3px;
+
+    span {
+        text-align: center;
+    }
+}
+
+.heatmap {
+    display: grid;
+    grid-template-columns: 28px 1fr;
+    gap: 3px;
+}
+
+.heatmap-week-col {
+    display: grid;
+    grid-template-rows: repeat(7, 1fr);
+    gap: 3px;
+    font-size: 10px;
+    color: var(--ar-text-sub);
+}
+
+.week-label {
+    display: flex;
+    align-items: center;
+}
+
+.heatmap-grid {
+    display: grid;
+    grid-template-columns: repeat(24, 1fr);
+    gap: 3px;
+}
+
+.h-cell {
+    aspect-ratio: 1;
+    border-radius: 2px;
+    min-height: 10px;
+    transition: transform 0.15s;
+
+    &:hover {
+        transform: scale(1.3);
+        z-index: 1;
+    }
+}
+
+
+// --- Word Cloud ---
+.word-cloud-wrapper {
+    margin: 24px auto 0;
+    padding: 0;
+    max-width: 520px;
+    display: flex;
+    justify-content: center;
+    --cloud-scale: clamp(0.72, 80vw / 520, 1);
+}
+
+.word-cloud-inner {
+    position: relative;
+    width: 520px;
+    height: 520px;
+    margin: 0;
+    border-radius: 50%;
+    transform: scale(var(--cloud-scale));
+    transform-origin: center;
+
+    &::before {
+        content: "";
+        position: absolute;
+        inset: -6%;
+        background:
+            radial-gradient(circle at 35% 45%, rgba(var(--ar-primary-rgb, 7, 193, 96), 0.12), transparent 55%),
+            radial-gradient(circle at 65% 50%, rgba(var(--ar-accent-rgb, 242, 170, 0), 0.10), transparent 58%),
+            radial-gradient(circle at 50% 65%, var(--bg-tertiary, rgba(0, 0, 0, 0.04)), transparent 60%);
+        filter: blur(18px);
+        border-radius: 50%;
+        pointer-events: none;
+        z-index: 0;
+    }
+}
+
+.word-tag {
+    display: inline-block;
+    padding: 0;
+    background: transparent;
+    border-radius: 0;
+    border: none;
+    line-height: 1.2;
+    white-space: nowrap;
+    transition: transform 0.2s ease, color 0.2s ease;
+    cursor: default;
+    color: var(--ar-text-main);
+    font-weight: 600;
+    opacity: 0;
+    animation: wordPopIn 0.55s ease forwards;
+    position: absolute;
+    z-index: 1;
+    transform: translate(-50%, -50%) scale(0.8);
+
+    &:hover {
+        transform: translate(-50%, -50%) scale(1.08);
+        color: var(--ar-primary);
+        z-index: 2;
+    }
+}
+
+@keyframes wordPopIn {
+    0% {
+        opacity: 0;
+        transform: translate(-50%, -50%) scale(0.6);
+    }
+
+    100% {
+        opacity: var(--final-opacity, 1);
+        transform: translate(-50%, -50%) scale(1);
+    }
+}
+
+.word-cloud-note {
+    margin-top: 24px;
+    font-size: 14px !important;
+    color: var(--ar-text-sub) !important;
+    text-align: center;
+}

src/components/ReportHeatmap.tsx

@@ -0,0 +1,51 @@
+import React from 'react'
+import './ReportComponents.scss'
+
+interface ReportHeatmapProps {
+    data: number[][]
+}
+
+const ReportHeatmap: React.FC<ReportHeatmapProps> = ({ data }) => {
+    if (!data || data.length === 0) return null
+
+    const maxHeat = Math.max(...data.flat())
+    const weekLabels = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
+
+    return (
+        <div className="heatmap-wrapper">
+            <div className="heatmap-header">
+                <div></div>
+                <div className="time-labels">
+                    {[0, 6, 12, 18].map(h => (
+                        <span key={h} style={{ gridColumn: h + 1 }}>{h}</span>
+                    ))}
+                </div>
+            </div>
+            <div className="heatmap">
+                <div className="heatmap-week-col">
+                    {weekLabels.map(w => <div key={w} className="week-label">{w}</div>)}
+                </div>
+                <div className="heatmap-grid">
+                    {data.map((row, wi) =>
+                        row.map((val, hi) => {
+                            const alpha = maxHeat > 0 ? (val / maxHeat * 0.85 + 0.1).toFixed(2) : '0.1'
+                            return (
+                                <div
+                                    key={`${wi}-${hi}`}
+                                    className="h-cell"
+                                    style={{
+                                        backgroundColor: 'var(--primary)',
+                                        opacity: alpha
+                                    }}
+                                    title={`${weekLabels[wi]} ${hi}:00 - ${val}条`}
+                                />
+                            )
+                        })
+                    )}
+                </div>
+            </div>
+        </div>
+    )
+}
+
+export default ReportHeatmap

src/components/ReportWordCloud.tsx

@@ -0,0 +1,113 @@
+import React from 'react'
+import './ReportComponents.scss'
+
+interface ReportWordCloudProps {
+    words: { phrase: string; count: number }[]
+}
+
+const ReportWordCloud: React.FC<ReportWordCloudProps> = ({ words }) => {
+    if (!words || words.length === 0) return null
+
+    const maxCount = words.length > 0 ? words[0].count : 1
+    const topWords = words.slice(0, 32)
+    const baseSize = 520
+
+    // 使用确定性随机数生成器
+    const seededRandom = (seed: number) => {
+        const x = Math.sin(seed) * 10000
+        return x - Math.floor(x)
+    }
+
+    // 计算词云位置
+    const placedItems: { x: number; y: number; w: number; h: number }[] = []
+
+    const canPlace = (x: number, y: number, w: number, h: number): boolean => {
+        const halfW = w / 2
+        const halfH = h / 2
+        const dx = x - 50
+        const dy = y - 50
+        const dist = Math.sqrt(dx * dx + dy * dy)
+        const maxR = 49 - Math.max(halfW, halfH)
+        if (dist > maxR) return false
+
+        const pad = 1.8
+        for (const p of placedItems) {
+            if ((x - halfW - pad) < (p.x + p.w / 2) &&
+                (x + halfW + pad) > (p.x - p.w / 2) &&
+                (y - halfH - pad) < (p.y + p.h / 2) &&
+                (y + halfH + pad) > (p.y - p.h / 2)) {
+                return false
+            }
+        }
+        return true
+    }
+
+    const wordItems = topWords.map((item, i) => {
+        const ratio = item.count / maxCount
+        const fontSize = Math.round(12 + Math.pow(ratio, 0.65) * 20)
+        const opacity = Math.min(1, Math.max(0.35, 0.35 + ratio * 0.65))
+        const delay = (i * 0.04).toFixed(2)
+
+        // 计算词语宽度
+        const charCount = Math.max(1, item.phrase.length)
+        const hasCjk = /[\u4e00-\u9fff]/.test(item.phrase)
+        const hasLatin = /[A-Za-z0-9]/.test(item.phrase)
+        const widthFactor = hasCjk && hasLatin ? 0.85 : hasCjk ? 0.98 : 0.6
+        const widthPx = fontSize * (charCount * widthFactor)
+        const heightPx = fontSize * 1.1
+        const widthPct = (widthPx / baseSize) * 100
+        const heightPct = (heightPx / baseSize) * 100
+
+        // 寻找位置
+        let x = 50, y = 50
+        let placedOk = false
+        const tries = i === 0 ? 1 : 420
+
+        for (let t = 0; t < tries; t++) {
+            if (i === 0) {
+                x = 50
+                y = 50
+            } else {
+                const idx = i + t * 0.28
+                const radius = Math.sqrt(idx) * 7.6 + (seededRandom(i * 1000 + t) * 1.2 - 0.6)
+                const angle = idx * 2.399963 + seededRandom(i * 2000 + t) * 0.35
+                x = 50 + radius * Math.cos(angle)
+                y = 50 + radius * Math.sin(angle)
+            }
+            if (canPlace(x, y, widthPct, heightPct)) {
+                placedOk = true
+                break
+            }
+        }
+
+        if (!placedOk) return null
+        placedItems.push({ x, y, w: widthPct, h: heightPct })
+
+        return (
+            <span
+                key={i}
+                className="word-tag"
+                style={{
+                    '--final-opacity': opacity,
+                    left: `${x.toFixed(2)}%`,
+                    top: `${y.toFixed(2)}%`,
+                    fontSize: `${fontSize}px`,
+                    animationDelay: `${delay}s`,
+                } as React.CSSProperties}
+                title={`${item.phrase} (出现 ${item.count} 次)`}
+            >
+                {item.phrase}
+            </span>
+        )
+    }).filter(Boolean)
+
+    return (
+        <div className="word-cloud-wrapper">
+            <div className="word-cloud-inner">
+                {wordItems}
+            </div>
+        </div>
+    )
+}
+
+export default ReportWordCloud

src/pages/AnnualReportWindow.scss

@@ -1,7 +1,9 @@
 .annual-report-window {
   // 使用全局主题变量，带回退值
   --ar-primary: var(--primary, #07C160);
+  --ar-primary-rgb: var(--primary-rgb, 7, 193, 96);
   --ar-accent: var(--accent, #F2AA00);
+  --ar-accent-rgb: 242, 170, 0;
   --ar-text-main: var(--text-primary, #222222);
   --ar-text-sub: var(--text-secondary, #555555);
   --ar-bg-color: var(--bg-primary, #F9F8F6);
@@ -43,7 +45,7 @@
 
 // 背景装饰圆点 - 毛玻璃效果
 .bg-decoration {
-  position: absolute; // Changed from fixed
+  position: absolute;
   inset: 0;
   pointer-events: none;
   z-index: 0;
@@ -53,10 +55,10 @@
 .deco-circle {
   position: absolute;
   border-radius: 50%;
-  background: rgba(0, 0, 0, 0.03);
+  background: rgba(var(--ar-primary-rgb), 0.03);
   backdrop-filter: blur(40px);
   -webkit-backdrop-filter: blur(40px);
-  border: 1px solid rgba(0, 0, 0, 0.05);
+  border: 1px solid var(--border-color);
 
   &.c1 {
     width: 280px;
@@ -243,6 +245,7 @@
 }
 
 .exporting-snapshot {
+
   .hero-title,
   .label-text,
   .hero-desc,
@@ -253,6 +256,11 @@
     background: transparent !important;
     box-shadow: none !important;
   }
+
+  .deco-circle {
+    background: transparent !important;
+    border: none !important;
+  }
 }
 
 .section {
@@ -1279,134 +1287,135 @@
   color: var(--ar-text-sub) !important;
   text-align: center;
 }
+
 // 曾经的好朋友 视觉效果
 .lost-friend-visual {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 32px;
+  margin: 64px auto 48px;
+  position: relative;
+  max-width: 480px;
+
+  .avatar-group {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 12px;
+    z-index: 2;
+
+    .avatar-label {
+      font-size: 13px;
+      color: var(--ar-text-sub);
+      font-weight: 500;
+      opacity: 0.6;
+    }
+
+    &.sender {
+      animation: fadeInRight 1s ease-out backwards;
+    }
+
+    &.receiver {
+      animation: fadeInLeft 1s ease-out backwards;
+    }
+  }
+
+  .fading-line {
+    position: relative;
+    flex: 1;
+    height: 2px;
+    min-width: 120px;
     display: flex;
     align-items: center;
     justify-content: center;
-    gap: 32px;
-    margin: 64px auto 48px;
-    position: relative;
-    max-width: 480px;
 
-    .avatar-group {
-        display: flex;
-        flex-direction: column;
-        align-items: center;
-        gap: 12px;
-        z-index: 2;
-
-        .avatar-label {
-            font-size: 13px;
-            color: var(--ar-text-sub);
-            font-weight: 500;
-            opacity: 0.6;
-        }
-
-        &.sender {
-            animation: fadeInRight 1s ease-out backwards;
-        }
-
-        &.receiver {
-            animation: fadeInLeft 1s ease-out backwards;
-        }
+    .line-path {
+      width: 100%;
+      height: 100%;
+      background: linear-gradient(to right,
+          var(--ar-primary) 0%,
+          rgba(var(--ar-primary-rgb), 0.4) 50%,
+          rgba(var(--ar-primary-rgb), 0.05) 100%);
+      border-radius: 2px;
     }
 
-    .fading-line {
-        position: relative;
-        flex: 1;
-        height: 2px;
-        min-width: 120px;
-        display: flex;
-        align-items: center;
-        justify-content: center;
-
-        .line-path {
-            width: 100%;
-            height: 100%;
-            background: linear-gradient(to right,
-                    var(--ar-primary) 0%,
-                    rgba(var(--ar-primary-rgb), 0.4) 50%,
-                    rgba(var(--ar-primary-rgb), 0.05) 100%);
-            border-radius: 2px;
-        }
-
-        .line-glow {
-            position: absolute;
-            inset: -4px 0;
-            background: linear-gradient(to right,
-                    rgba(var(--ar-primary-rgb), 0.2) 0%,
-                    transparent 100%);
-            filter: blur(8px);
-            pointer-events: none;
-        }
-
-        .flow-particle {
-            position: absolute;
-            width: 40px;
-            height: 2px;
-            background: linear-gradient(to right, transparent, var(--ar-primary), transparent);
-            border-radius: 2px;
-            opacity: 0;
-            animation: flowAcross 4s infinite linear;
-        }
+    .line-glow {
+      position: absolute;
+      inset: -4px 0;
+      background: linear-gradient(to right,
+          rgba(var(--ar-primary-rgb), 0.2) 0%,
+          transparent 100%);
+      filter: blur(8px);
+      pointer-events: none;
     }
+
+    .flow-particle {
+      position: absolute;
+      width: 40px;
+      height: 2px;
+      background: linear-gradient(to right, transparent, var(--ar-primary), transparent);
+      border-radius: 2px;
+      opacity: 0;
+      animation: flowAcross 4s infinite linear;
+    }
+  }
 }
 
 .hero-desc.fading {
-    opacity: 0.7;
-    font-style: italic;
-    font-size: 16px;
-    margin-top: 32px;
-    line-height: 1.8;
-    letter-spacing: 0.05em;
-    animation: fadeIn 1.5s ease-out 0.5s backwards;
+  opacity: 0.7;
+  font-style: italic;
+  font-size: 16px;
+  margin-top: 32px;
+  line-height: 1.8;
+  letter-spacing: 0.05em;
+  animation: fadeIn 1.5s ease-out 0.5s backwards;
 }
 
 @keyframes flowAcross {
-    0% {
-        left: -20%;
-        opacity: 0;
-    }
+  0% {
+    left: -20%;
+    opacity: 0;
+  }
 
-    10% {
-        opacity: 0.8;
-    }
+  10% {
+    opacity: 0.8;
+  }
 
-    50% {
-        opacity: 0.4;
-    }
+  50% {
+    opacity: 0.4;
+  }
 
-    90% {
-        opacity: 0.1;
-    }
+  90% {
+    opacity: 0.1;
+  }
 
-    100% {
-        left: 120%;
-        opacity: 0;
-    }
+  100% {
+    left: 120%;
+    opacity: 0;
+  }
 }
 
 @keyframes fadeInRight {
-    from {
-        opacity: 0;
-        transform: translateX(-20px);
-    }
+  from {
+    opacity: 0;
+    transform: translateX(-20px);
+  }
 
-    to {
-        opacity: 1;
-        transform: translateX(0);
-    }
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
 }
 
 @keyframes fadeInLeft {
-    from {
-        opacity: 0;
-        transform: translateX(20px);
-    }
+  from {
+    opacity: 0;
+    transform: translateX(20px);
+  }
 
-    to {
-        opacity: 1;
-        transform: translateX(0);
-    }
-}
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}

src/pages/AnnualReportWindow.tsx

@@ -109,148 +109,8 @@ const Avatar = ({ url, name, size = 'md' }: { url?: string; name: string; size?:
   )
 }
 
-// 热力图组件
-const Heatmap = ({ data }: { data: number[][] }) => {
-  const maxHeat = Math.max(...data.flat())
-  const weekLabels = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
-
-  return (
-    <div className="heatmap-wrapper">
-      <div className="heatmap-header">
-        <div></div>
-        <div className="time-labels">
-          {[0, 6, 12, 18].map(h => (
-            <span key={h} style={{ gridColumn: h + 1 }}>{h}</span>
-          ))}
-        </div>
-      </div>
-      <div className="heatmap">
-        <div className="heatmap-week-col">
-          {weekLabels.map(w => <div key={w} className="week-label">{w}</div>)}
-        </div>
-        <div className="heatmap-grid">
-          {data.map((row, wi) =>
-            row.map((val, hi) => {
-              const alpha = maxHeat > 0 ? (val / maxHeat * 0.85 + 0.1).toFixed(2) : '0.1'
-              return (
-                <div
-                  key={`${wi}-${hi}`}
-                  className="h-cell"
-                  style={{ background: `rgba(7, 193, 96, ${alpha})` }}
-                  title={`${weekLabels[wi]} ${hi}:00 - ${val}条`}
-                />
-              )
-            })
-          )}
-        </div>
-      </div>
-    </div>
-  )
-}
-
-// 词云组件
-const WordCloud = ({ words }: { words: { phrase: string; count: number }[] }) => {
-  const maxCount = words.length > 0 ? words[0].count : 1
-  const topWords = words.slice(0, 32)
-  const baseSize = 520
-
-  // 使用确定性随机数生成器
-  const seededRandom = (seed: number) => {
-    const x = Math.sin(seed) * 10000
-    return x - Math.floor(x)
-  }
-
-  // 计算词云位置
-  const placedItems: { x: number; y: number; w: number; h: number }[] = []
-
-  const canPlace = (x: number, y: number, w: number, h: number): boolean => {
-    const halfW = w / 2
-    const halfH = h / 2
-    const dx = x - 50
-    const dy = y - 50
-    const dist = Math.sqrt(dx * dx + dy * dy)
-    const maxR = 49 - Math.max(halfW, halfH)
-    if (dist > maxR) return false
-
-    const pad = 1.8
-    for (const p of placedItems) {
-      if ((x - halfW - pad) < (p.x + p.w / 2) &&
-        (x + halfW + pad) > (p.x - p.w / 2) &&
-        (y - halfH - pad) < (p.y + p.h / 2) &&
-        (y + halfH + pad) > (p.y - p.h / 2)) {
-        return false
-      }
-    }
-    return true
-  }
-
-  const wordItems = topWords.map((item, i) => {
-    const ratio = item.count / maxCount
-    const fontSize = Math.round(12 + Math.pow(ratio, 0.65) * 20)
-    const opacity = Math.min(1, Math.max(0.35, 0.35 + ratio * 0.65))
-    const delay = (i * 0.04).toFixed(2)
-
-    // 计算词语宽度
-    const charCount = Math.max(1, item.phrase.length)
-    const hasCjk = /[\u4e00-\u9fff]/.test(item.phrase)
-    const hasLatin = /[A-Za-z0-9]/.test(item.phrase)
-    const widthFactor = hasCjk && hasLatin ? 0.85 : hasCjk ? 0.98 : 0.6
-    const widthPx = fontSize * (charCount * widthFactor)
-    const heightPx = fontSize * 1.1
-    const widthPct = (widthPx / baseSize) * 100
-    const heightPct = (heightPx / baseSize) * 100
-
-    // 寻找位置
-    let x = 50, y = 50
-    let placedOk = false
-    const tries = i === 0 ? 1 : 420
-
-    for (let t = 0; t < tries; t++) {
-      if (i === 0) {
-        x = 50
-        y = 50
-      } else {
-        const idx = i + t * 0.28
-        const radius = Math.sqrt(idx) * 7.6 + (seededRandom(i * 1000 + t) * 1.2 - 0.6)
-        const angle = idx * 2.399963 + seededRandom(i * 2000 + t) * 0.35
-        x = 50 + radius * Math.cos(angle)
-        y = 50 + radius * Math.sin(angle)
-      }
-      if (canPlace(x, y, widthPct, heightPct)) {
-        placedOk = true
-        break
-      }
-    }
-
-    if (!placedOk) return null
-    placedItems.push({ x, y, w: widthPct, h: heightPct })
-
-    return (
-      <span
-        key={i}
-        className="word-tag"
-        style={{
-          '--final-opacity': opacity,
-          left: `${x.toFixed(2)}%`,
-          top: `${y.toFixed(2)}%`,
-          fontSize: `${fontSize}px`,
-          animationDelay: `${delay}s`,
-        } as React.CSSProperties}
-        title={`${item.phrase} (出现 ${item.count} 次)`}
-      >
-        {item.phrase}
-      </span>
-    )
-  }).filter(Boolean)
-
-  return (
-    <div className="word-cloud-wrapper">
-      <div className="word-cloud-inner">
-        {wordItems}
-      </div>
-    </div>
-  )
-}
+import Heatmap from '../components/ReportHeatmap'
+import WordCloud from '../components/ReportWordCloud'
 
 function AnnualReportWindow() {
   const [reportData, setReportData] = useState<AnnualReportData | null>(null)

src/pages/ChatPage.scss

@@ -2016,12 +2016,43 @@
       text-align: right;
       color: var(--text-primary);
       word-break: break-all;
+      user-select: text;
 
       &.highlight {
         color: var(--primary);
         font-weight: 600;
       }
     }
+
+    .copy-btn {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      width: 22px;
+      height: 22px;
+      padding: 0;
+      border: none;
+      border-radius: 4px;
+      background: transparent;
+      color: var(--text-tertiary);
+      cursor: pointer;
+      flex-shrink: 0;
+      opacity: 0;
+      transition: opacity 0.15s, color 0.15s, background 0.15s;
+
+      &:hover {
+        background: var(--bg-secondary);
+        color: var(--text-primary);
+      }
+
+      svg {
+        color: inherit;
+      }
+    }
+
+    &:hover .copy-btn {
+      opacity: 1;
+    }
   }
 
   .table-list {
@@ -2458,6 +2489,13 @@
       text-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
     }
 
+    .transfer-desc {
+      font-size: 12px;
+      margin-bottom: 4px;
+      opacity: 0.9;
+      line-height: 1.4;
+    }
+
     .transfer-memo {
       font-size: 13px;
       margin-bottom: 8px;
@@ -2572,3 +2610,210 @@
     }
   }
 }
+
+// 批量转写按钮
+.batch-transcribe-btn {
+  &:hover:not(:disabled) {
+    color: var(--primary-color);
+  }
+  &.transcribing {
+    color: var(--primary-color);
+    cursor: pointer;
+    opacity: 1 !important;
+  }
+}
+
+// 批量转写模态框基础样式（共享样式在 styles/batchTranscribe.scss）
+
+// 批量转写确认对话框
+.batch-confirm-modal {
+  width: 480px;
+  max-width: 90vw;
+
+  .batch-modal-header {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 1.5rem;
+    border-bottom: 1px solid var(--border-color);
+
+    svg { color: var(--primary-color); }
+
+    h3 {
+      margin: 0;
+      font-size: 18px;
+      font-weight: 600;
+      color: var(--text-primary);
+    }
+  }
+
+  .batch-modal-body {
+    padding: 1.5rem;
+
+    p {
+      margin: 0 0 1rem 0;
+      font-size: 14px;
+      color: var(--text-secondary);
+      line-height: 1.6;
+    }
+
+    .batch-dates-list-wrap {
+      margin-bottom: 1rem;
+      background: var(--bg-tertiary);
+      border: 1px solid var(--border-color);
+      border-radius: 8px;
+      overflow: hidden;
+
+      .batch-dates-actions {
+        display: flex;
+        gap: 0.5rem;
+        padding: 0.5rem 0.75rem;
+        border-bottom: 1px solid var(--border-color);
+        background: var(--bg-secondary);
+
+        .batch-dates-btn {
+          padding: 0.35rem 0.75rem;
+          font-size: 12px;
+          color: var(--primary-color);
+          background: transparent;
+          border: 1px solid var(--border-color);
+          border-radius: 6px;
+          cursor: pointer;
+          transition: all 0.2s;
+
+          &:hover {
+            background: var(--bg-hover);
+            border-color: var(--primary-color);
+          }
+        }
+      }
+
+      .batch-dates-list {
+        list-style: none;
+        margin: 0;
+        padding: 0;
+        max-height: 160px;
+        overflow-y: auto;
+
+        li {
+          border-bottom: 1px solid var(--border-color);
+          &:last-child { border-bottom: none; }
+        }
+
+        .batch-date-row {
+          display: flex;
+          align-items: center;
+          gap: 0.75rem;
+          padding: 0.6rem 0.75rem;
+          cursor: pointer;
+          transition: background 0.15s;
+
+          &:hover { background: var(--bg-hover); }
+
+          input[type="checkbox"] {
+            accent-color: var(--primary-color);
+            cursor: pointer;
+            flex-shrink: 0;
+          }
+
+          .batch-date-label {
+            flex: 1;
+            font-size: 14px;
+            color: var(--text-primary);
+            font-weight: 500;
+          }
+
+          .batch-date-count {
+            font-size: 12px;
+            color: var(--text-tertiary);
+            flex-shrink: 0;
+          }
+        }
+      }
+    }
+
+    .batch-info {
+      background: var(--bg-tertiary);
+      border-radius: 8px;
+      padding: 1rem;
+      margin-bottom: 1rem;
+
+      .info-item {
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        padding: 0.5rem 0;
+
+        &:not(:last-child) {
+          border-bottom: 1px solid var(--border-color);
+        }
+
+        .label {
+          font-size: 13px;
+          color: var(--text-secondary);
+        }
+
+        .value {
+          font-size: 14px;
+          font-weight: 600;
+          color: var(--primary-color);
+        }
+      }
+    }
+
+    .batch-warning {
+      display: flex;
+      align-items: flex-start;
+      gap: 0.5rem;
+      padding: 0.75rem;
+      background: rgba(255, 152, 0, 0.1);
+      border-radius: 8px;
+      border: 1px solid rgba(255, 152, 0, 0.3);
+
+      svg {
+        flex-shrink: 0;
+        margin-top: 2px;
+        color: #ff9800;
+      }
+
+      span {
+        font-size: 13px;
+        color: var(--text-secondary);
+        line-height: 1.5;
+      }
+    }
+  }
+
+  .batch-modal-footer {
+    display: flex;
+    justify-content: flex-end;
+    gap: 0.75rem;
+    padding: 1rem 1.5rem;
+    border-top: 1px solid var(--border-color);
+
+    button {
+      padding: 0.5rem 1.25rem;
+      border-radius: 8px;
+      font-size: 14px;
+      font-weight: 500;
+      cursor: pointer;
+      transition: all 0.2s;
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+      border: none;
+
+      &.btn-secondary {
+        background: var(--bg-tertiary);
+        color: var(--text-primary);
+        &:hover { background: var(--border-color); }
+      }
+
+      &.btn-primary, &.batch-transcribe-start-btn {
+        background: var(--primary-color);
+        color: white;
+        &:hover { opacity: 0.9; }
+      }
+    }
+  }
+}

src/pages/ChatPage.tsx

@@ -1,7 +1,9 @@
 import React, { useState, useEffect, useRef, useCallback, useMemo } from 'react'
-import { Search, MessageSquare, AlertCircle, Loader2, RefreshCw, X, ChevronDown, Info, Calendar, Database, Hash, Play, Pause, Image as ImageIcon, Link } from 'lucide-react'
+import { Search, MessageSquare, AlertCircle, Loader2, RefreshCw, X, ChevronDown, Info, Calendar, Database, Hash, Play, Pause, Image as ImageIcon, Link, Mic, CheckCircle, Copy, Check, Download, BarChart3 } from 'lucide-react'
+import { useNavigate } from 'react-router-dom'
 import { createPortal } from 'react-dom'
 import { useChatStore } from '../stores/chatStore'
+import { useBatchTranscribeStore } from '../stores/batchTranscribeStore'
 import type { ChatSession, Message } from '../types/models'
 import { getEmojiPath } from 'wechat-emojis'
 import { VoiceTranscribeDialog } from '../components/VoiceTranscribeDialog'
@@ -116,6 +118,8 @@ const SessionItem = React.memo(function SessionItem({
 
 
 function ChatPage(_props: ChatPageProps) {
+  const navigate = useNavigate()
+
   const {
     isConnected,
     isConnecting,
@@ -160,6 +164,9 @@ function ChatPage(_props: ChatPageProps) {
   const [jumpStartTime, setJumpStartTime] = useState(0)
   const [jumpEndTime, setJumpEndTime] = useState(0)
   const [showJumpDialog, setShowJumpDialog] = useState(false)
+  const [messageDates, setMessageDates] = useState<Set<string>>(new Set())
+  const [loadingDates, setLoadingDates] = useState(false)
+  const messageDatesCache = useRef<Map<string, Set<string>>>(new Map())
   const [myAvatarUrl, setMyAvatarUrl] = useState<string | undefined>(undefined)
   const [myWxid, setMyWxid] = useState<string | undefined>(undefined)
   const [showScrollToBottom, setShowScrollToBottom] = useState(false)
@@ -168,12 +175,21 @@ function ChatPage(_props: ChatPageProps) {
   const [showDetailPanel, setShowDetailPanel] = useState(false)
   const [sessionDetail, setSessionDetail] = useState<SessionDetail | null>(null)
   const [isLoadingDetail, setIsLoadingDetail] = useState(false)
+  const [copiedField, setCopiedField] = useState<string | null>(null)
   const [highlightedMessageKeys, setHighlightedMessageKeys] = useState<string[]>([])
   const [isRefreshingSessions, setIsRefreshingSessions] = useState(false)
   const [hasInitialMessages, setHasInitialMessages] = useState(false)
   const [showVoiceTranscribeDialog, setShowVoiceTranscribeDialog] = useState(false)
   const [pendingVoiceTranscriptRequest, setPendingVoiceTranscriptRequest] = useState<{ sessionId: string; messageId: string } | null>(null)
 
+  // 批量语音转文字相关状态（进度/结果 由全局 store 管理）
+  const { isBatchTranscribing, progress: batchTranscribeProgress, showToast: showBatchProgress, startTranscribe, updateProgress, finishTranscribe, setShowToast: setShowBatchProgress } = useBatchTranscribeStore()
+  const [showBatchConfirm, setShowBatchConfirm] = useState(false)
+  const [batchVoiceCount, setBatchVoiceCount] = useState(0)
+  const [batchVoiceMessages, setBatchVoiceMessages] = useState<Message[] | null>(null)
+  const [batchVoiceDates, setBatchVoiceDates] = useState<string[]>([])
+  const [batchSelectedDates, setBatchSelectedDates] = useState<Set<string>>(new Set())
+
   // 联系人信息加载控制
   const isEnrichingRef = useRef(false)
   const enrichCancelledRef = useRef(false)
@@ -231,6 +247,25 @@ function ChatPage(_props: ChatPageProps) {
     setShowDetailPanel(!showDetailPanel)
   }, [showDetailPanel, currentSessionId, loadSessionDetail])
 
+  // 复制字段值到剪贴板
+  const handleCopyField = useCallback(async (text: string, field: string) => {
+    try {
+      await navigator.clipboard.writeText(text)
+      setCopiedField(field)
+      setTimeout(() => setCopiedField(null), 1500)
+    } catch {
+      // fallback
+      const textarea = document.createElement('textarea')
+      textarea.value = text
+      document.body.appendChild(textarea)
+      textarea.select()
+      document.execCommand('copy')
+      document.body.removeChild(textarea)
+      setCopiedField(field)
+      setTimeout(() => setCopiedField(null), 1500)
+    }
+  }, [])
+
   // 连接数据库
   const connect = useCallback(async () => {
     setConnecting(true)
@@ -648,12 +683,32 @@ function ChatPage(_props: ChatPageProps) {
 
 
 
+  // 动态游标批量大小控制
+  const currentBatchSizeRef = useRef(50)
+
   // 加载消息
   const loadMessages = async (sessionId: string, offset = 0, startTime = 0, endTime = 0) => {
     const listEl = messageListRef.current
     const session = sessionMapRef.current.get(sessionId)
     const unreadCount = session?.unreadCount ?? 0
-    const messageLimit = offset === 0 && unreadCount > 99 ? 30 : 50
+
+    let messageLimit = 50
+
+    if (offset === 0) {
+      // 初始加载：重置批量大小
+      currentBatchSizeRef.current = 50
+      // 首屏优化：消息过多时限制数量
+      messageLimit = unreadCount > 99 ? 30 : 50
+    } else {
+      // 滚动加载：动态递增 (50 -> 100 -> 200)
+      if (currentBatchSizeRef.current < 100) {
+        currentBatchSizeRef.current = 100
+      } else {
+        currentBatchSizeRef.current = 200
+      }
+      messageLimit = currentBatchSizeRef.current
+    }
+
 
     if (offset === 0) {
       setLoadingMessages(true)
@@ -1183,6 +1238,167 @@ function ChatPage(_props: ChatPageProps) {
     setShowVoiceTranscribeDialog(true)
   }, [])
 
+  // 批量语音转文字
+  const handleBatchTranscribe = useCallback(async () => {
+    if (!currentSessionId) return
+    const session = sessions.find(s => s.username === currentSessionId)
+    if (!session) {
+      alert('未找到当前会话')
+      return
+    }
+    if (isBatchTranscribing) return
+
+    const result = await window.electronAPI.chat.getAllVoiceMessages(currentSessionId)
+    if (!result.success || !result.messages) {
+      alert(`获取语音消息失败: ${result.error || '未知错误'}`)
+      return
+    }
+
+    const voiceMessages: Message[] = result.messages
+    if (voiceMessages.length === 0) {
+      alert('当前会话没有语音消息')
+      return
+    }
+
+    const dateSet = new Set<string>()
+    voiceMessages.forEach(m => dateSet.add(new Date(m.createTime * 1000).toISOString().slice(0, 10)))
+    const sortedDates = Array.from(dateSet).sort((a, b) => b.localeCompare(a))
+
+    setBatchVoiceMessages(voiceMessages)
+    setBatchVoiceCount(voiceMessages.length)
+    setBatchVoiceDates(sortedDates)
+    setBatchSelectedDates(new Set(sortedDates))
+    setShowBatchConfirm(true)
+  }, [sessions, currentSessionId, isBatchTranscribing])
+
+  const handleExportCurrentSession = useCallback(() => {
+    if (!currentSessionId) return
+    navigate('/export', {
+      state: {
+        preselectSessionIds: [currentSessionId]
+      }
+    })
+  }, [currentSessionId, navigate])
+
+  const handleGroupAnalytics = useCallback(() => {
+    if (!currentSessionId || !isGroupChat(currentSessionId)) return
+    navigate('/group-analytics', {
+      state: {
+        preselectGroupIds: [currentSessionId]
+      }
+    })
+  }, [currentSessionId, navigate])
+
+  // 确认批量转写
+  const confirmBatchTranscribe = useCallback(async () => {
+    if (!currentSessionId) return
+
+    const selected = batchSelectedDates
+    if (selected.size === 0) {
+      alert('请至少选择一个日期')
+      return
+    }
+
+    const messages = batchVoiceMessages
+    if (!messages || messages.length === 0) {
+      setShowBatchConfirm(false)
+      return
+    }
+
+    const voiceMessages = messages.filter(m =>
+      selected.has(new Date(m.createTime * 1000).toISOString().slice(0, 10))
+    )
+    if (voiceMessages.length === 0) {
+      alert('所选日期下没有语音消息')
+      return
+    }
+
+    setShowBatchConfirm(false)
+    setBatchVoiceMessages(null)
+    setBatchVoiceDates([])
+    setBatchSelectedDates(new Set())
+
+    const session = sessions.find(s => s.username === currentSessionId)
+    if (!session) return
+
+    startTranscribe(voiceMessages.length, session.displayName || session.username)
+
+    // 检查模型状态
+    const modelStatus = await window.electronAPI.whisper.getModelStatus()
+    if (!modelStatus?.exists) {
+      alert('SenseVoice 模型未下载，请先在设置中下载模型')
+      finishTranscribe(0, 0)
+      return
+    }
+
+    let successCount = 0
+    let failCount = 0
+    let completedCount = 0
+    const concurrency = 10
+
+    const transcribeOne = async (msg: Message) => {
+      try {
+        const result = await window.electronAPI.chat.getVoiceTranscript(
+          session.username,
+          String(msg.localId),
+          msg.createTime
+        )
+        return { success: result.success }
+      } catch {
+        return { success: false }
+      }
+    }
+
+    for (let i = 0; i < voiceMessages.length; i += concurrency) {
+      const batch = voiceMessages.slice(i, i + concurrency)
+      const results = await Promise.all(batch.map(msg => transcribeOne(msg)))
+
+      results.forEach(result => {
+        if (result.success) successCount++
+        else failCount++
+        completedCount++
+        updateProgress(completedCount, voiceMessages.length)
+      })
+    }
+
+    finishTranscribe(successCount, failCount)
+  }, [sessions, currentSessionId, batchSelectedDates, batchVoiceMessages, startTranscribe, updateProgress, finishTranscribe])
+
+  // 批量转写：按日期的消息数量
+  const batchCountByDate = useMemo(() => {
+    const map = new Map<string, number>()
+    if (!batchVoiceMessages) return map
+    batchVoiceMessages.forEach(m => {
+      const d = new Date(m.createTime * 1000).toISOString().slice(0, 10)
+      map.set(d, (map.get(d) || 0) + 1)
+    })
+    return map
+  }, [batchVoiceMessages])
+
+  // 批量转写：选中日期对应的语音条数
+  const batchSelectedMessageCount = useMemo(() => {
+    if (!batchVoiceMessages) return 0
+    return batchVoiceMessages.filter(m =>
+      batchSelectedDates.has(new Date(m.createTime * 1000).toISOString().slice(0, 10))
+    ).length
+  }, [batchVoiceMessages, batchSelectedDates])
+
+  const toggleBatchDate = useCallback((date: string) => {
+    setBatchSelectedDates(prev => {
+      const next = new Set(prev)
+      if (next.has(date)) next.delete(date)
+      else next.add(date)
+      return next
+    })
+  }, [])
+  const selectAllBatchDates = useCallback(() => setBatchSelectedDates(new Set(batchVoiceDates)), [batchVoiceDates])
+  const clearAllBatchDates = useCallback(() => setBatchSelectedDates(new Set()), [])
+
+  const formatBatchDateLabel = useCallback((dateStr: string) => {
+    const [y, m, d] = dateStr.split('-').map(Number)
+    return `${y}年${m}月${d}日`
+  }, [])
+
   return (
     <div className={`chat-page ${isResizing ? 'resizing' : ''}`}>
       {/* 左侧会话列表 */}
@@ -1293,9 +1509,68 @@ function ChatPage(_props: ChatPageProps) {
                 )}
               </div>
               <div className="header-actions">
+                {isGroupChat(currentSession.username) && (
+                  <button
+                    className="icon-btn group-analytics-btn"
+                    onClick={handleGroupAnalytics}
+                    title="群聊分析"
+                  >
+                    <BarChart3 size={18} />
+                  </button>
+                )}
+                <button
+                  className="icon-btn export-session-btn"
+                  onClick={handleExportCurrentSession}
+                  disabled={!currentSessionId}
+                  title="导出当前会话"
+                >
+                  <Download size={18} />
+                </button>
+                <button
+                  className={`icon-btn batch-transcribe-btn${isBatchTranscribing ? ' transcribing' : ''}`}
+                  onClick={() => {
+                    if (isBatchTranscribing) {
+                      setShowBatchProgress(true)
+                    } else {
+                      handleBatchTranscribe()
+                    }
+                  }}
+                  disabled={!currentSessionId}
+                  title={isBatchTranscribing ? `批量转写中 (${batchTranscribeProgress.current}/${batchTranscribeProgress.total})，点击查看进度` : '批量语音转文字'}
+                >
+                  {isBatchTranscribing ? (
+                    <Loader2 size={18} className="spin" />
+                  ) : (
+                    <Mic size={18} />
+                  )}
+                </button>
                 <button
                   className="icon-btn jump-to-time-btn"
-                  onClick={() => setShowJumpDialog(true)}
+                  onClick={async () => {
+                    setShowJumpDialog(true)
+                    if (!currentSessionId) return
+                    // 检查缓存
+                    const cached = messageDatesCache.current.get(currentSessionId)
+                    if (cached) {
+                      setMessageDates(cached)
+                      return
+                    }
+                    // 获取消息日期
+                    setMessageDates(new Set()) // 清除旧数据
+                    setLoadingDates(true)
+                    try {
+                      const result = await (window as any).electronAPI.chat.getMessageDates(currentSessionId)
+                      if (result?.success && result.dates) {
+                        const dateSet = new Set<string>(result.dates)
+                        setMessageDates(dateSet)
+                        messageDatesCache.current.set(currentSessionId, dateSet)
+                      }
+                    } catch (e) {
+                      console.error('获取消息日期失败:', e)
+                    } finally {
+                      setLoadingDates(false)
+                    }
+                  }}
                   title="跳转到指定时间"
                 >
                   <Calendar size={18} />
@@ -1311,6 +1586,8 @@ function ChatPage(_props: ChatPageProps) {
                     setJumpEndTime(end)
                     loadMessages(currentSessionId, 0, 0, end)
                   }}
+                  messageDates={messageDates}
+                  loadingDates={loadingDates}
                 />
                 <button
                   className="icon-btn refresh-messages-btn"
@@ -1428,23 +1705,35 @@ function ChatPage(_props: ChatPageProps) {
                           <Hash size={14} />
                           <span className="label">微信ID</span>
                           <span className="value">{sessionDetail.wxid}</span>
+                          <button className="copy-btn" title="复制" onClick={() => handleCopyField(sessionDetail.wxid, 'wxid')}>
+                            {copiedField === 'wxid' ? <Check size={12} /> : <Copy size={12} />}
+                          </button>
                         </div>
                         {sessionDetail.remark && (
                           <div className="detail-item">
                             <span className="label">备注</span>
                             <span className="value">{sessionDetail.remark}</span>
+                            <button className="copy-btn" title="复制" onClick={() => handleCopyField(sessionDetail.remark!, 'remark')}>
+                              {copiedField === 'remark' ? <Check size={12} /> : <Copy size={12} />}
+                            </button>
                           </div>
                         )}
                         {sessionDetail.nickName && (
                           <div className="detail-item">
                             <span className="label">昵称</span>
                             <span className="value">{sessionDetail.nickName}</span>
+                            <button className="copy-btn" title="复制" onClick={() => handleCopyField(sessionDetail.nickName!, 'nickName')}>
+                              {copiedField === 'nickName' ? <Check size={12} /> : <Copy size={12} />}
+                            </button>
                           </div>
                         )}
                         {sessionDetail.alias && (
                           <div className="detail-item">
                             <span className="label">微信号</span>
                             <span className="value">{sessionDetail.alias}</span>
+                            <button className="copy-btn" title="复制" onClick={() => handleCopyField(sessionDetail.alias!, 'alias')}>
+                              {copiedField === 'alias' ? <Check size={12} /> : <Copy size={12} />}
+                            </button>
                           </div>
                         )}
                       </div>
@@ -1542,10 +1831,98 @@ function ChatPage(_props: ChatPageProps) {
           }}
         />
       )}
+
+      {/* 批量转写确认对话框 */}
+      {showBatchConfirm && createPortal(
+        <div className="batch-modal-overlay" onClick={() => setShowBatchConfirm(false)}>
+          <div className="batch-modal-content batch-confirm-modal" onClick={(e) => e.stopPropagation()}>
+            <div className="batch-modal-header">
+              <Mic size={20} />
+              <h3>批量语音转文字</h3>
+            </div>
+            <div className="batch-modal-body">
+              <p>选择要转写的日期（仅显示有语音的日期），然后开始转写。</p>
+              {batchVoiceDates.length > 0 && (
+                <div className="batch-dates-list-wrap">
+                  <div className="batch-dates-actions">
+                    <button type="button" className="batch-dates-btn" onClick={selectAllBatchDates}>全选</button>
+                    <button type="button" className="batch-dates-btn" onClick={clearAllBatchDates}>取消全选</button>
+                  </div>
+                  <ul className="batch-dates-list">
+                    {batchVoiceDates.map(dateStr => {
+                      const count = batchCountByDate.get(dateStr) ?? 0
+                      const checked = batchSelectedDates.has(dateStr)
+                      return (
+                        <li key={dateStr}>
+                          <label className="batch-date-row">
+                            <input
+                              type="checkbox"
+                              checked={checked}
+                              onChange={() => toggleBatchDate(dateStr)}
+                            />
+                            <span className="batch-date-label">{formatBatchDateLabel(dateStr)}</span>
+                            <span className="batch-date-count">{count} 条语音</span>
+                          </label>
+                        </li>
+                      )
+                    })}
+                  </ul>
+                </div>
+              )}
+              <div className="batch-info">
+                <div className="info-item">
+                  <span className="label">已选:</span>
+                  <span className="value">{batchSelectedDates.size} 天有语音，共 {batchSelectedMessageCount} 条语音</span>
+                </div>
+                <div className="info-item">
+                  <span className="label">预计耗时:</span>
+                  <span className="value">约 {Math.ceil(batchSelectedMessageCount * 2 / 60)} 分钟</span>
+                </div>
+              </div>
+              <div className="batch-warning">
+                <AlertCircle size={16} />
+                <span>批量转写可能需要较长时间，转写过程中可以继续使用其他功能。已转写过的语音会自动跳过。</span>
+              </div>
+            </div>
+            <div className="batch-modal-footer">
+              <button className="btn-secondary" onClick={() => setShowBatchConfirm(false)}>
+                取消
+              </button>
+              <button className="btn-primary batch-transcribe-start-btn" onClick={confirmBatchTranscribe}>
+                <Mic size={16} />
+                开始转写
+              </button>
+            </div>
+          </div>
+        </div>,
+        document.body
+      )}
     </div>
   )
 }
 
+// 全局语音播放管理器：同一时间只能播放一条语音
+const globalVoiceManager = {
+  currentAudio: null as HTMLAudioElement | null,
+  currentStopCallback: null as (() => void) | null,
+  play(audio: HTMLAudioElement, onStop: () => void) {
+    // 停止当前正在播放的语音
+    if (this.currentAudio && this.currentAudio !== audio) {
+      this.currentAudio.pause()
+      this.currentAudio.currentTime = 0
+      this.currentStopCallback?.()
+    }
+    this.currentAudio = audio
+    this.currentStopCallback = onStop
+  },
+  stop(audio: HTMLAudioElement) {
+    if (this.currentAudio === audio) {
+      this.currentAudio = null
+      this.currentStopCallback = null
+    }
+  },
+}
+
 // 前端表情包缓存
 const emojiDataUrlCache = new Map<string, string>()
 const imageDataUrlCache = new Map<string, string>()
@@ -1601,6 +1978,10 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
   const [voiceWaveform, setVoiceWaveform] = useState<number[]>([])
   const voiceAutoDecryptTriggered = useRef(false)
 
+  // 转账消息双方名称
+  const [transferPayerName, setTransferPayerName] = useState<string | undefined>(undefined)
+  const [transferReceiverName, setTransferReceiverName] = useState<string | undefined>(undefined)
+
   // 视频相关状态
   const [videoLoading, setVideoLoading] = useState(false)
   const [videoInfo, setVideoInfo] = useState<{ videoUrl?: string; coverUrl?: string; thumbUrl?: string; exists: boolean } | null>(null)
@@ -1765,6 +2146,26 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
     }
   }, [isGroupChat, isSent, message.senderUsername, myAvatarUrl])
 
+  // 解析转账消息的付款方和收款方显示名称
+  useEffect(() => {
+    const payerWxid = (message as any).transferPayerUsername
+    const receiverWxid = (message as any).transferReceiverUsername
+    if (!payerWxid && !receiverWxid) return
+    // 仅对转账消息类型处理
+    if (message.localType !== 49 && message.localType !== 8589934592049) return
+
+    window.electronAPI.chat.resolveTransferDisplayNames(
+      session.username,
+      payerWxid || '',
+      receiverWxid || ''
+    ).then((result: { payerName: string; receiverName: string }) => {
+      if (result) {
+        setTransferPayerName(result.payerName)
+        setTransferReceiverName(result.receiverName)
+      }
+    }).catch(() => { })
+  }, [(message as any).transferPayerUsername, (message as any).transferReceiverUsername, session.username])
+
   // 自动下载表情包
   useEffect(() => {
     if (emojiLocalPath) return
@@ -1985,6 +2386,7 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
     const handleEnded = () => {
       setIsVoicePlaying(false)
       setVoiceCurrentTime(0)
+      globalVoiceManager.stop(audio)
     }
     const handleTimeUpdate = () => {
       setVoiceCurrentTime(audio.currentTime)
@@ -1999,6 +2401,7 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
     audio.addEventListener('loadedmetadata', handleLoadedMetadata)
     return () => {
       audio.pause()
+      globalVoiceManager.stop(audio)
       audio.removeEventListener('play', handlePlay)
       audio.removeEventListener('pause', handlePause)
       audio.removeEventListener('ended', handleEnded)
@@ -2157,7 +2560,7 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
   // 视频懒加载
   const videoAutoLoadTriggered = useRef(false)
   const [videoClicked, setVideoClicked] = useState(false)
-  
+
   useEffect(() => {
     if (!isVideo || !videoContainerRef.current) return
 
@@ -2183,11 +2586,11 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
 
   // 视频加载中状态引用，避免依赖问题
   const videoLoadingRef = useRef(false)
-  
+
   // 加载视频信息（添加重试机制）
   const requestVideoInfo = useCallback(async () => {
     if (!videoMd5 || videoLoadingRef.current) return
-    
+
     videoLoadingRef.current = true
     setVideoLoading(true)
     try {
@@ -2209,13 +2612,13 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
       setVideoLoading(false)
     }
   }, [videoMd5])
-  
+
   // 视频进入视野时自动加载
   useEffect(() => {
     if (!isVideo || !isVideoVisible) return
     if (videoInfo?.exists) return // 已成功加载，不需要重试
     if (videoAutoLoadTriggered.current) return
-    
+
     videoAutoLoadTriggered.current = true
     void requestVideoInfo()
   }, [isVideo, isVideoVisible, videoInfo, requestVideoInfo])
@@ -2433,6 +2836,7 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
         if (isVoicePlaying) {
           audio.pause()
           audio.currentTime = 0
+          globalVoiceManager.stop(audio)
           return
         }
         if (!voiceDataUrl) {
@@ -2467,6 +2871,11 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
         }
         audio.src = source
         try {
+          // 停止其他正在播放的语音，确保同一时间只播放一条
+          globalVoiceManager.play(audio, () => {
+            audio.pause()
+            audio.currentTime = 0
+          })
           await audio.play()
         } catch {
           setVoiceError(true)
@@ -2623,6 +3032,7 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
       let url = ''
       let appMsgType = ''
       let textAnnouncement = ''
+      let parsedDoc: Document | null = null
 
       try {
         const content = message.rawContent || message.parsedContent || ''
@@ -2630,13 +3040,13 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
         const xmlContent = content.substring(content.indexOf('<msg>'))
 
         const parser = new DOMParser()
-        const doc = parser.parseFromString(xmlContent, 'text/xml')
+        parsedDoc = parser.parseFromString(xmlContent, 'text/xml')
 
-        title = doc.querySelector('title')?.textContent || '链接'
-        desc = doc.querySelector('des')?.textContent || ''
-        url = doc.querySelector('url')?.textContent || ''
-        appMsgType = doc.querySelector('appmsg > type')?.textContent || doc.querySelector('type')?.textContent || ''
-        textAnnouncement = doc.querySelector('textannouncement')?.textContent || ''
+        title = parsedDoc.querySelector('title')?.textContent || '链接'
+        desc = parsedDoc.querySelector('des')?.textContent || ''
+        url = parsedDoc.querySelector('url')?.textContent || ''
+        appMsgType = parsedDoc.querySelector('appmsg > type')?.textContent || parsedDoc.querySelector('type')?.textContent || ''
+        textAnnouncement = parsedDoc.querySelector('textannouncement')?.textContent || ''
       } catch (e) {
         console.error('解析 AppMsg 失败:', e)
       }
@@ -2764,19 +3174,10 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
       // 转账消息 (type=2000)
       if (appMsgType === '2000') {
         try {
-          const content = message.rawContent || message.content || message.parsedContent || ''
-
-          // 添加调试日志
-
-
-          const parser = new DOMParser()
-          const doc = parser.parseFromString(content, 'text/xml')
-
-          const feedesc = doc.querySelector('feedesc')?.textContent || ''
-          const payMemo = doc.querySelector('pay_memo')?.textContent || ''
-          const paysubtype = doc.querySelector('paysubtype')?.textContent || '1'
-
-
+          // 使用外层已解析好的 parsedDoc（已去除 wxid 前缀）
+          const feedesc = parsedDoc?.querySelector('feedesc')?.textContent || ''
+          const payMemo = parsedDoc?.querySelector('pay_memo')?.textContent || ''
+          const paysubtype = parsedDoc?.querySelector('paysubtype')?.textContent || '1'
 
           // paysubtype: 1=待收款, 3=已收款
           const isReceived = paysubtype === '3'
@@ -2784,16 +3185,29 @@ function MessageBubble({ message, session, showTime, myAvatarUrl, isGroupChat, o
           // 如果 feedesc 为空，使用 title 作为降级
           const displayAmount = feedesc || title || '微信转账'
 
+          // 构建转账描述：A 转账给 B
+          const transferDesc = transferPayerName && transferReceiverName
+            ? `${transferPayerName} 转账给 ${transferReceiverName}`
+            : undefined
+
           return (
             <div className={`transfer-message ${isReceived ? 'received' : ''}`}>
               <div className="transfer-icon">
-                <svg width="32" height="32" viewBox="0 0 40 40" fill="none">
-                  <circle cx="20" cy="20" r="18" stroke="white" strokeWidth="2" />
-                  <path d="M12 20h16M20 12l8 8-8 8" stroke="white" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
-                </svg>
+                {isReceived ? (
+                  <svg width="32" height="32" viewBox="0 0 40 40" fill="none">
+                    <circle cx="20" cy="20" r="18" stroke="white" strokeWidth="2" />
+                    <path d="M12 20l6 6 10-12" stroke="white" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" />
+                  </svg>
+                ) : (
+                  <svg width="32" height="32" viewBox="0 0 40 40" fill="none">
+                    <circle cx="20" cy="20" r="18" stroke="white" strokeWidth="2" />
+                    <path d="M12 20h16M20 12l8 8-8 8" stroke="white" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" />
+                  </svg>
+                )}
               </div>
               <div className="transfer-info">
                 <div className="transfer-amount">{displayAmount}</div>
+                {transferDesc && <div className="transfer-desc">{transferDesc}</div>}
                 {payMemo && <div className="transfer-memo">{payMemo}</div>}
                 <div className="transfer-label">{isReceived ? '已收款' : '微信转账'}</div>
               </div>

src/pages/DualReportPage.scss

@@ -132,26 +132,43 @@
 .info {
   display: flex;
   flex-direction: column;
-  gap: 4px;
+  gap: 2px;
+  min-width: 0; // 允许 flex 子项缩小，配合 ellipsis
 
   .name {
+    font-size: 15px;
     font-weight: 600;
+    color: var(--text-primary);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
   }
 
   .sub {
     font-size: 12px;
-    color: var(--text-tertiary);
+    color: var(--text-secondary); // 从 tertiary 改为 secondary 以增强对比度
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    opacity: 0.8;
   }
 }
 
 .meta {
   text-align: right;
   font-size: 12px;
-  color: var(--text-tertiary);
+  color: var(--text-secondary); // 改为 secondary
+  flex-shrink: 0;
 
   .count {
-    font-weight: 600;
-    color: var(--text-primary);
+    font-size: 14px;
+    font-weight: 700;
+    color: var(--primary); // 使用主题色更醒目
+    margin-bottom: 2px;
+  }
+
+  .hint {
+    opacity: 0.7;
   }
 }
 
@@ -166,6 +183,11 @@
 }
 
 @keyframes spin {
-  from { transform: rotate(0deg); }
-  to { transform: rotate(360deg); }
-}
+  from {
+    transform: rotate(0deg);
+  }
+
+  to {
+    transform: rotate(360deg);
+  }
+}

src/pages/DualReportPage.tsx

@@ -7,6 +7,7 @@ interface ContactRanking {
   username: string
   displayName: string
   avatarUrl?: string
+  wechatId?: string
   messageCount: number
   sentCount: number
   receivedCount: number
@@ -15,28 +16,29 @@ interface ContactRanking {
 
 function DualReportPage() {
   const navigate = useNavigate()
-  const [year, setYear] = useState<number>(0)
+  const [year] = useState<number>(() => {
+    const params = new URLSearchParams(window.location.hash.split('?')[1] || '')
+    const yearParam = params.get('year')
+    const parsedYear = yearParam ? parseInt(yearParam, 10) : 0
+    return Number.isNaN(parsedYear) ? 0 : parsedYear
+  })
   const [rankings, setRankings] = useState<ContactRanking[]>([])
   const [isLoading, setIsLoading] = useState(true)
   const [loadError, setLoadError] = useState<string | null>(null)
   const [keyword, setKeyword] = useState('')
 
   useEffect(() => {
-    const params = new URLSearchParams(window.location.hash.split('?')[1] || '')
-    const yearParam = params.get('year')
-    const parsedYear = yearParam ? parseInt(yearParam, 10) : 0
-    setYear(Number.isNaN(parsedYear) ? 0 : parsedYear)
-  }, [])
+    void loadRankings(year)
+  }, [year])
 
-  useEffect(() => {
-    loadRankings()
-  }, [])
-
-  const loadRankings = async () => {
+  const loadRankings = async (reportYear: number) => {
     setIsLoading(true)
     setLoadError(null)
     try {
-      const result = await window.electronAPI.analytics.getContactRankings(200)
+      const isAllTime = reportYear <= 0
+      const beginTimestamp = isAllTime ? 0 : Math.floor(new Date(reportYear, 0, 1).getTime() / 1000)
+      const endTimestamp = isAllTime ? 0 : Math.floor(new Date(reportYear, 11, 31, 23, 59, 59).getTime() / 1000)
+      const result = await window.electronAPI.analytics.getContactRankings(200, beginTimestamp, endTimestamp)
       if (result.success && result.data) {
         setRankings(result.data)
       } else {
@@ -55,7 +57,8 @@ function DualReportPage() {
     if (!keyword.trim()) return rankings
     const q = keyword.trim().toLowerCase()
     return rankings.filter((item) => {
-      return item.displayName.toLowerCase().includes(q) || item.username.toLowerCase().includes(q)
+      const wechatId = (item.wechatId || '').toLowerCase()
+      return item.displayName.toLowerCase().includes(q) || wechatId.includes(q)
     })
   }, [rankings, keyword])
 
@@ -99,7 +102,7 @@ function DualReportPage() {
         <input
           value={keyword}
           onChange={(e) => setKeyword(e.target.value)}
-          placeholder="搜索好友（昵称/备注/wxid）"
+          placeholder="搜索好友（昵称/微信号）"
         />
       </div>
 
@@ -119,7 +122,7 @@ function DualReportPage() {
             </div>
             <div className="info">
               <div className="name">{item.displayName}</div>
-              <div className="sub">{item.username}</div>
+              <div className="sub">{item.wechatId || '\u672A\u8bbe\u7f6e\u5fae\u4fe1\u53f7'}</div>
             </div>
             <div className="meta">
               <div className="count">{item.messageCount.toLocaleString()} 条</div>

src/pages/DualReportWindow.scss

@@ -8,6 +8,7 @@
     font-size: clamp(26px, 5vw, 44px);
     white-space: normal;
   }
+
   .dual-names {
     font-size: clamp(24px, 4vw, 40px);
     font-weight: 700;
@@ -30,9 +31,6 @@
   }
 
   .dual-info-card {
-    background: var(--ar-card-bg);
-    border: 1px solid var(--bg-tertiary, rgba(0, 0, 0, 0.05));
-    border-radius: 14px;
     padding: 16px;
 
     &.full {
@@ -60,14 +58,8 @@
   }
 
   .dual-message {
-    background: var(--ar-card-bg);
-    border-radius: 14px;
     padding: 14px;
 
-    &.received {
-      background: var(--ar-card-bg-hover);
-    }
-
     .message-meta {
       font-size: 12px;
       color: var(--ar-text-sub);
@@ -81,25 +73,15 @@
   }
 
   .first-chat-scene {
-    background: linear-gradient(180deg, #8f5b85 0%, #e38aa0 50%, #f6d0c8 100%);
-    border-radius: 20px;
-    padding: 28px 24px 24px;
-    color: #fff;
+    padding: 18px 16px 16px;
+    color: var(--ar-text-main);
     position: relative;
     overflow: hidden;
     margin-top: 16px;
   }
 
   .first-chat-scene::before {
-    content: "";
-    position: absolute;
-    inset: 0;
-    background-image:
-      radial-gradient(circle at 20% 20%, rgba(255, 255, 255, 0.2), transparent 40%),
-      radial-gradient(circle at 80% 10%, rgba(255, 255, 255, 0.15), transparent 35%),
-      radial-gradient(circle at 50% 80%, rgba(255, 255, 255, 0.12), transparent 45%);
-    opacity: 0.6;
-    pointer-events: none;
+    display: none;
   }
 
   .scene-title {
@@ -107,6 +89,7 @@
     font-weight: 700;
     text-align: center;
     margin-bottom: 8px;
+    color: var(--ar-text-main);
   }
 
   .scene-subtitle {
@@ -114,92 +97,192 @@
     font-weight: 500;
     text-align: center;
     margin-bottom: 20px;
-    opacity: 0.95;
+    opacity: 0.9;
+    color: var(--ar-text-sub);
   }
 
   .scene-messages {
     display: flex;
     flex-direction: column;
-    gap: 14px;
+    gap: 16px;
   }
 
   .scene-message {
     display: flex;
-    align-items: flex-end;
-    gap: 12px;
+    flex-direction: column;
+    align-items: center;
+    margin-bottom: 32px;
+    width: 100%;
 
-    &.sent {
+    &.system {
+      margin: 16px 0;
+
+      .system-msg-content {
+        background: rgba(255, 255, 255, 0.05);
+        padding: 4px 12px;
+        border-radius: 12px;
+        font-size: 12px;
+        color: rgba(255, 255, 255, 0.4);
+        text-align: center;
+        max-width: 80%;
+      }
+    }
+
+    .scene-meta {
+      font-size: 10px;
+      opacity: 0.65;
+      margin-bottom: 12px;
+      color: var(--text-tertiary);
+      text-align: center;
+      width: 100%;
+    }
+
+    .scene-body {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      width: 100%;
+      max-width: 100%;
+    }
+
+    &.sent .scene-body {
       flex-direction: row-reverse;
+      justify-content: flex-start;
+    }
+
+    &.received .scene-body {
+      flex-direction: row;
+      justify-content: flex-start;
     }
   }
 
   .scene-avatar {
-    width: 40px;
-    height: 40px;
-    border-radius: 12px;
-    background: rgba(255, 255, 255, 0.25);
+    width: 42px;
+    height: 42px;
+    border-radius: 50%;
+    background: var(--ar-card-bg);
     display: flex;
     align-items: center;
     justify-content: center;
     font-weight: 700;
-    color: #fff;
+    color: var(--ar-text-sub);
+    border: 1px solid var(--bg-tertiary, rgba(0, 0, 0, 0.08));
+    overflow: hidden;
+    flex-shrink: 0;
+
+    img {
+      width: 100%;
+      height: 100%;
+      object-fit: cover;
+      display: block;
+    }
+  }
+
+  .scene-content-wrapper {
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    max-width: min(78%, 720px);
+  }
+
+  .scene-message.sent .scene-content-wrapper {
+    align-items: flex-end;
   }
 
   .scene-bubble {
-    background: rgba(255, 255, 255, 0.85);
-    color: #5a4d5e;
+    color: var(--ar-text-main);
     padding: 10px 14px;
-    border-radius: 14px;
-    max-width: 60%;
-    box-shadow: 0 10px 24px rgba(0, 0, 0, 0.12);
-  }
+    width: fit-content;
+    min-width: 40px;
+    max-width: 100%;
+    background: var(--ar-card-bg);
+    border-radius: 12px;
+    position: relative;
 
-  .scene-message.sent .scene-bubble {
-    background: rgba(255, 224, 168, 0.9);
-    color: #4a3a2f;
-  }
-
-  .scene-meta {
-    font-size: 11px;
-    opacity: 0.7;
-    margin-bottom: 4px;
+    &.no-bubble {
+      background: transparent;
+      padding: 0;
+      box-shadow: none;
+    }
   }
 
   .scene-content {
+    line-height: 1.5;
+    font-size: clamp(14px, 1.8vw, 16px);
+    word-break: break-all;
+    white-space: pre-wrap;
+    overflow-wrap: break-word;
+    line-break: auto;
+
+    .report-emoji-container {
+      display: inline-block;
+      vertical-align: middle;
+      margin: 2px 0;
+
+      .report-emoji-img {
+        max-width: 120px;
+        max-height: 120px;
+        border-radius: 4px;
+        display: block;
+      }
+    }
+  }
+
+  .scene-avatar.fallback {
     font-size: 14px;
-    line-height: 1.4;
-    word-break: break-word;
+  }
+
+  .scene-avatar.with-image {
+    background: transparent;
+    color: transparent;
   }
 
   .scene-message.sent .scene-avatar {
-    background: rgba(255, 224, 168, 0.9);
-    color: #4a3a2f;
+    border-color: color-mix(in srgb, var(--primary) 30%, var(--bg-tertiary, rgba(0, 0, 0, 0.08)));
   }
 
   .dual-stat-grid {
-    display: grid;
-    grid-template-columns: repeat(5, minmax(140px, 1fr));
-    gap: 14px;
-    margin: 20px -28px 24px;
-    padding: 0 28px;
-    overflow: visible;
+    display: flex;
+    flex-wrap: nowrap;
+    gap: clamp(60px, 10vw, 120px);
+    margin: 48px 0 32px;
+    padding: 0;
+    justify-content: center;
+    align-items: flex-start;
+
+    &.bottom {
+      margin-top: 0;
+      margin-bottom: 48px;
+      gap: clamp(40px, 6vw, 80px);
+    }
   }
 
   .dual-stat-card {
-    background: var(--ar-card-bg);
-    border-radius: 14px;
-    padding: 14px 12px;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
     text-align: center;
+    min-width: 140px;
+    max-width: 280px;
   }
 
   .stat-num {
-    font-size: clamp(20px, 2.8vw, 30px);
+    font-size: clamp(36px, 6vw, 64px);
+    font-weight: 800;
     font-variant-numeric: tabular-nums;
+    color: var(--ar-primary);
+    line-height: 1;
     white-space: nowrap;
+
+    &.small {
+      font-size: clamp(24px, 4vw, 40px);
+    }
   }
 
   .stat-unit {
-    font-size: 12px;
+    font-size: 14px;
+    margin-top: 4px;
+    opacity: 0.8;
   }
 
   .dual-stat-card.long .stat-num {
@@ -215,15 +298,12 @@
   }
 
   .emoji-card {
-    border: 1px solid var(--bg-tertiary, rgba(0, 0, 0, 0.08));
-    border-radius: 16px;
     padding: 18px 16px;
     display: flex;
     flex-direction: column;
     gap: 10px;
     align-items: center;
     justify-content: center;
-    background: var(--ar-card-bg);
 
     img {
       width: 64px;
@@ -250,4 +330,655 @@
     text-align: center;
     padding: 24px 0;
   }
-}
+
+  .initiative-container {
+    padding: 32px 0;
+    width: 100%;
+    background: transparent;
+    border: none;
+  }
+
+  .initiative-bar-wrapper {
+    display: flex;
+    align-items: center;
+    gap: 32px;
+    width: 100%;
+    padding: 24px 0;
+    margin-bottom: 24px;
+    position: relative;
+  }
+
+  .initiative-side {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 12px;
+    min-width: 80px;
+    z-index: 2;
+
+    .avatar-placeholder {
+      width: 54px;
+      height: 54px;
+      border-radius: 18px;
+      background: var(--bg-tertiary);
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      font-weight: 700;
+      color: var(--ar-text-sub);
+      font-size: 16px;
+      border: 1.5px solid rgba(255, 255, 255, 0.15);
+      box-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
+      overflow: hidden;
+
+      img {
+        width: 100%;
+        height: 100%;
+        object-fit: cover;
+      }
+    }
+
+    .count {
+      font-size: 11px;
+      font-weight: 500;
+      opacity: 0.4;
+      color: var(--ar-text-sub);
+    }
+
+    .percent {
+      font-size: 14px;
+      color: var(--ar-text-main);
+      font-weight: 800;
+      opacity: 0.9;
+    }
+  }
+
+  .initiative-progress {
+    flex: 1;
+    height: 1px; // 线条样式
+    position: relative;
+    display: flex;
+    align-items: center;
+
+    .line-bg {
+      position: absolute;
+      left: 0;
+      right: 0;
+      height: 1px;
+      background: linear-gradient(90deg,
+          transparent 0%,
+          rgba(255, 255, 255, 0.1) 20%,
+          rgba(255, 255, 255, 0.1) 80%,
+          transparent 100%);
+    }
+
+    .initiative-indicator {
+      position: absolute;
+      width: 8px;
+      height: 8px;
+      background: #fff;
+      border-radius: 50%;
+      transform: translateX(-50%);
+      transition: left 1.5s cubic-bezier(0.16, 1, 0.3, 1);
+      box-shadow:
+        0 0 10px #fff,
+        0 0 20px rgba(255, 255, 255, 0.5),
+        0 0 30px var(--ar-primary);
+      z-index: 3;
+
+      &::before {
+        content: '';
+        position: absolute;
+        top: -4px;
+        left: -4px;
+        right: -4px;
+        bottom: -4px;
+        border: 1px solid rgba(255, 255, 255, 0.2);
+        border-radius: 50%;
+        animation: pulse 2s infinite;
+      }
+    }
+  }
+
+  .initiative-desc {
+    text-align: center;
+    font-size: 14px;
+    color: var(--ar-text-sub);
+    letter-spacing: 1px;
+    opacity: 0.6;
+    background: transparent;
+    padding: 0;
+    margin: 0 auto;
+    font-style: italic;
+  }
+
+  @keyframes pulse {
+    0% {
+      transform: scale(1);
+      opacity: 0.8;
+    }
+
+    100% {
+      transform: scale(2);
+      opacity: 0;
+    }
+  }
+
+
+  .response-pulse-container {
+    width: 100%;
+    padding: 80px 0;
+    display: flex;
+    justify-content: center;
+  }
+
+  .pulse-visual {
+    position: relative;
+    width: 420px;
+    height: 240px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+
+  .pulse-hub {
+    position: relative;
+    z-index: 5;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    width: 160px;
+    height: 160px;
+    background: radial-gradient(circle at center, rgba(255, 255, 255, 0.12) 0%, transparent 75%);
+    border-radius: 50%;
+    box-shadow: 0 0 40px rgba(255, 255, 255, 0.1);
+
+    .label {
+      font-size: 13px;
+      color: var(--ar-text-sub);
+      opacity: 0.6;
+      margin-bottom: 6px;
+      letter-spacing: 2px;
+    }
+
+    .value {
+      font-size: 54px;
+      font-weight: 950;
+      color: #fff;
+      line-height: 1;
+      text-shadow: 0 0 30px rgba(255, 255, 255, 0.5);
+
+      span {
+        font-size: 18px;
+        font-weight: 500;
+        margin-left: 4px;
+        opacity: 0.7;
+      }
+    }
+  }
+
+  .pulse-node {
+    position: absolute;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    z-index: 4;
+    animation: floatNode 4s ease-in-out infinite;
+
+    &.left {
+      left: 0;
+      transform: translateX(-15%);
+    }
+
+    &.right {
+      right: 0;
+      transform: translateX(15%);
+      animation-delay: -2s;
+    }
+
+    .label {
+      font-size: 12px;
+      color: var(--ar-text-sub);
+      opacity: 0.5;
+      margin-bottom: 4px;
+    }
+
+    .value {
+      font-size: 24px;
+      font-weight: 800;
+      color: var(--ar-text-main);
+      opacity: 0.95;
+
+      span {
+        font-size: 13px;
+        margin-left: 2px;
+        opacity: 0.6;
+      }
+    }
+  }
+
+  .pulse-ripple {
+    position: absolute;
+    top: 50%;
+    left: 50%;
+    transform: translate(-50%, -50%);
+    border: 1.5px solid rgba(255, 255, 255, 0.08);
+    border-radius: 50%;
+    animation: ripplePulse 8s linear infinite;
+    pointer-events: none;
+
+    &.one {
+      animation-delay: 0s;
+    }
+
+    &.two {
+      animation-delay: 2.5s;
+    }
+
+    &.three {
+      animation-delay: 5s;
+    }
+  }
+
+  @keyframes ripplePulse {
+    0% {
+      width: 140px;
+      height: 140px;
+      opacity: 0.5;
+    }
+
+    100% {
+      width: 700px;
+      height: 700px;
+      opacity: 0;
+    }
+  }
+
+  @keyframes floatNode {
+
+    0%,
+    100% {
+      transform: translateY(0);
+    }
+
+    50% {
+      transform: translateY(-16px);
+    }
+  }
+
+  .response-note {
+    text-align: center;
+    font-size: 14px;
+    color: var(--ar-text-sub);
+    opacity: 0.5;
+    margin-top: 32px;
+    font-style: italic;
+    max-width: none;
+    line-height: 1.6;
+  }
+
+  .streak-spark-visual.premium {
+    width: 100%;
+    height: 400px;
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    margin: 20px 0;
+    overflow: visible;
+
+    .spark-ambient-glow {
+      position: absolute;
+      top: 40%;
+      left: 50%;
+      transform: translate(-50%, -50%);
+      width: 600px;
+      height: 480px;
+      background: radial-gradient(circle at center, rgba(242, 170, 0, 0.04) 0%, transparent 70%);
+      filter: blur(60px);
+      z-index: 1;
+      pointer-events: none;
+    }
+  }
+
+  .spark-core-wrapper {
+    position: relative;
+    width: 220px;
+    height: 280px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    z-index: 5;
+    animation: flameSway 6s ease-in-out infinite;
+    transform-origin: bottom center;
+  }
+
+  .spark-flame-outer {
+    position: absolute;
+    width: 100%;
+    height: 100%;
+    background: radial-gradient(ellipse at 50% 85%, rgba(242, 170, 0, 0.15) 0%, transparent 75%);
+    border-radius: 50% 50% 20% 20% / 80% 80% 30% 30%;
+    filter: blur(25px);
+    animation: flickerOuter 4s infinite alternate;
+  }
+
+  .spark-flame-inner {
+    position: absolute;
+    bottom: 20%;
+    width: 140px;
+    height: 180px;
+    background: radial-gradient(ellipse at 50% 90%, rgba(255, 215, 0, 0.2) 0%, transparent 80%);
+    border-radius: 50% 50% 30% 30% / 85% 85% 25% 25%;
+    filter: blur(12px);
+    animation: flickerInner 3s infinite alternate-reverse;
+  }
+
+  .spark-core {
+    position: relative;
+    z-index: 10;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    padding-bottom: 20px;
+
+    .spark-days {
+      font-size: 84px;
+      font-weight: 800;
+      color: rgba(255, 255, 255, 0.9);
+      line-height: 1;
+      letter-spacing: -1px;
+      text-shadow:
+        0 0 15px rgba(255, 255, 255, 0.4),
+        0 8px 30px rgba(0, 0, 0, 0.3);
+    }
+
+    .spark-label {
+      font-size: 14px;
+      font-weight: 800;
+      color: rgba(255, 255, 255, 0.4);
+      letter-spacing: 6px;
+      margin-top: 12px;
+      text-indent: 6px;
+    }
+  }
+
+  .streak-bridge.premium {
+    width: 100%;
+    max-width: 500px;
+    display: flex;
+    align-items: center;
+    gap: 0;
+    margin-top: -20px;
+    z-index: 20;
+
+    .bridge-date {
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      position: relative;
+      width: 100px;
+
+      span {
+        font-size: 13px;
+        color: var(--ar-text-sub);
+        opacity: 0.6;
+        font-weight: 500;
+        letter-spacing: 0.2px;
+        position: absolute;
+        top: 24px;
+        white-space: nowrap;
+      }
+
+      .date-orb {
+        width: 6px;
+        height: 6px;
+        background: #fff;
+        border-radius: 50%;
+        box-shadow: 0 0 12px var(--ar-accent);
+        border: 1px solid rgba(252, 170, 0, 0.5);
+      }
+    }
+
+    .bridge-line {
+      flex: 1;
+      height: 40px;
+      position: relative;
+      display: flex;
+      align-items: center;
+
+      .line-string {
+        width: 100%;
+        height: 1.5px;
+        background: linear-gradient(90deg,
+            rgba(242, 170, 0, 0) 0%,
+            rgba(242, 170, 0, 0.6) 20%,
+            rgba(242, 170, 0, 0.6) 80%,
+            rgba(242, 170, 0, 0) 100%);
+        mask-image: radial-gradient(ellipse at center, black 60%, transparent 100%);
+      }
+
+      .line-glow {
+        position: absolute;
+        width: 100%;
+        height: 8px;
+        background: radial-gradient(ellipse at center, rgba(242, 170, 0, 0.2) 0%, transparent 80%);
+        filter: blur(4px);
+        animation: sparkFlicker 2s infinite alternate;
+      }
+    }
+  }
+
+  .spark-ember {
+    position: absolute;
+    background: #FFD700;
+    border-radius: 50%;
+    filter: blur(0.5px);
+    box-shadow: 0 0 6px #F2AA00;
+    opacity: 0;
+    z-index: 4;
+
+    &.one {
+      width: 3px;
+      height: 3px;
+      left: 46%;
+      animation: emberRise 5s infinite 0s;
+    }
+
+    &.two {
+      width: 2px;
+      height: 2px;
+      left: 53%;
+      animation: emberRise 4s infinite 1.2s;
+    }
+
+    &.three {
+      width: 4px;
+      height: 4px;
+      left: 50%;
+      animation: emberRise 6s infinite 2.5s;
+    }
+
+    &.four {
+      width: 2.5px;
+      height: 2.5px;
+      left: 48%;
+      animation: emberRise 5.5s infinite 3.8s;
+    }
+  }
+
+  @keyframes flameSway {
+
+    0%,
+    100% {
+      transform: rotate(-1deg) skewX(-1deg);
+    }
+
+    50% {
+      transform: rotate(1.5deg) skewX(1deg);
+    }
+  }
+
+  @keyframes flickerOuter {
+
+    0%,
+    100% {
+      opacity: 0.15;
+      filter: blur(25px);
+    }
+
+    50% {
+      opacity: 0.25;
+      filter: blur(30px);
+    }
+  }
+
+  @keyframes flickerInner {
+
+    0%,
+    100% {
+      transform: scale(1);
+      opacity: 0.2;
+    }
+
+    50% {
+      transform: scale(1.08);
+      opacity: 0.3;
+    }
+  }
+
+  @keyframes emberRise {
+    0% {
+      transform: translateY(100px) scale(1);
+      opacity: 0;
+    }
+
+    20% {
+      opacity: 0.8;
+    }
+
+    80% {
+      opacity: 0.3;
+    }
+
+    100% {
+      transform: translateY(-260px) scale(0.4);
+      opacity: 0;
+    }
+  }
+
+  @keyframes sparkFlicker {
+
+    0%,
+    100% {
+      transform: scale(1);
+      opacity: 0.9;
+      filter: brightness(1);
+    }
+
+    50% {
+      transform: scale(1.03);
+      opacity: 1;
+      filter: brightness(1.2);
+    }
+  }
+
+  @media (max-width: 960px) {
+    .pulse-visual {
+      transform: scale(0.85);
+    }
+
+    .scene-avatar {
+      width: 36px;
+      height: 36px;
+      font-size: 13px;
+    }
+
+    .scene-content-wrapper {
+      max-width: min(86%, 500px);
+    }
+
+    .scene-bubble {
+      max-width: 100%;
+      min-width: 56px;
+    }
+  }
+
+  // Word Cloud Tabs
+  .word-cloud-section {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    width: 100%;
+  }
+
+  .word-cloud-tabs {
+    display: flex;
+    gap: 8px;
+    background: rgba(255, 255, 255, 0.08);
+    padding: 4px;
+    border-radius: 12px;
+    margin: 0 auto 32px;
+    border: 1px solid rgba(255, 255, 255, 0.1);
+  }
+
+  .tab-item {
+    padding: 8px 16px;
+    border-radius: 8px;
+    border: none;
+    background: transparent;
+    color: var(--ar-text-sub);
+    font-size: 14px;
+    font-weight: 500;
+    cursor: pointer;
+    transition: all 0.2s ease;
+    white-space: nowrap;
+
+    &:hover {
+      color: var(--ar-text-main);
+      background: rgba(255, 255, 255, 0.05);
+    }
+
+    &.active {
+      background: var(--ar-card-bg);
+      color: var(--ar-primary);
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+      font-weight: 600;
+    }
+  }
+
+  .word-cloud-container {
+    width: 100%;
+
+    &.fade-in {
+      animation: fadeIn 0.4s ease-out;
+    }
+  }
+
+  .empty-state {
+    text-align: center;
+    padding: 40px 0;
+    color: var(--ar-text-sub);
+    opacity: 0.6;
+    font-size: 14px;
+    background: rgba(255, 255, 255, 0.03);
+    border-radius: 16px;
+    border: 1px dashed rgba(255, 255, 255, 0.1);
+    margin-top: 20px;
+  }
+
+  @keyframes fadeIn {
+    from {
+      opacity: 0;
+      transform: translateY(10px);
+    }
+
+    to {
+      opacity: 1;
+      transform: translateY(0);
+    }
+  }
+}

src/pages/DualReportWindow.tsx

@@ -1,4 +1,6 @@
-import { useEffect, useState, type CSSProperties } from 'react'
+import { useEffect, useState } from 'react'
+import ReportHeatmap from '../components/ReportHeatmap'
+import ReportWordCloud from '../components/ReportWordCloud'
 import './AnnualReportWindow.scss'
 import './DualReportWindow.scss'
 
@@ -7,19 +9,27 @@ interface DualReportMessage {
   isSentByMe: boolean
   createTime: number
   createTimeStr: string
+  localType?: number
+  emojiMd5?: string
+  emojiCdnUrl?: string
 }
 
 interface DualReportData {
   year: number
   selfName: string
+  selfAvatarUrl?: string
   friendUsername: string
   friendName: string
+  friendAvatarUrl?: string
   firstChat: {
     createTime: number
     createTimeStr: string
     content: string
     isSentByMe: boolean
     senderUsername?: string
+    localType?: number
+    emojiMd5?: string
+    emojiCdnUrl?: string
   } | null
   firstChatMessages?: DualReportMessage[]
   yearFirstChat?: {
@@ -29,6 +39,9 @@ interface DualReportData {
     isSentByMe: boolean
     friendName: string
     firstThreeMessages: DualReportMessage[]
+    localType?: number
+    emojiMd5?: string
+    emojiCdnUrl?: string
   } | null
   stats: {
     totalMessages: number
@@ -40,111 +53,17 @@ interface DualReportData {
     friendTopEmojiMd5?: string
     myTopEmojiUrl?: string
     friendTopEmojiUrl?: string
+    myTopEmojiCount?: number
+    friendTopEmojiCount?: number
   }
   topPhrases: Array<{ phrase: string; count: number }>
-}
-
-const WordCloud = ({ words }: { words: { phrase: string; count: number }[] }) => {
-  if (!words || words.length === 0) {
-    return <div className="word-cloud-empty">暂无高频语句</div>
-  }
-  const sortedWords = [...words].sort((a, b) => b.count - a.count)
-  const maxCount = sortedWords.length > 0 ? sortedWords[0].count : 1
-  const topWords = sortedWords.slice(0, 32)
-  const baseSize = 520
-
-  const seededRandom = (seed: number) => {
-    const x = Math.sin(seed) * 10000
-    return x - Math.floor(x)
-  }
-
-  const placedItems: { x: number; y: number; w: number; h: number }[] = []
-
-  const canPlace = (x: number, y: number, w: number, h: number): boolean => {
-    const halfW = w / 2
-    const halfH = h / 2
-    const dx = x - 50
-    const dy = y - 50
-    const dist = Math.sqrt(dx * dx + dy * dy)
-    const maxR = 49 - Math.max(halfW, halfH)
-    if (dist > maxR) return false
-
-    const pad = 1.8
-    for (const p of placedItems) {
-      if ((x - halfW - pad) < (p.x + p.w / 2) &&
-        (x + halfW + pad) > (p.x - p.w / 2) &&
-        (y - halfH - pad) < (p.y + p.h / 2) &&
-        (y + halfH + pad) > (p.y - p.h / 2)) {
-        return false
-      }
-    }
-    return true
-  }
-
-  const wordItems = topWords.map((item, i) => {
-    const ratio = item.count / maxCount
-    const fontSize = Math.round(12 + Math.pow(ratio, 0.65) * 20)
-    const opacity = Math.min(1, Math.max(0.35, 0.35 + ratio * 0.65))
-    const delay = (i * 0.04).toFixed(2)
-
-    const charCount = Math.max(1, item.phrase.length)
-    const hasCjk = /[\u4e00-\u9fff]/.test(item.phrase)
-    const hasLatin = /[A-Za-z0-9]/.test(item.phrase)
-    const widthFactor = hasCjk && hasLatin ? 0.85 : hasCjk ? 0.98 : 0.6
-    const widthPx = fontSize * (charCount * widthFactor)
-    const heightPx = fontSize * 1.1
-    const widthPct = (widthPx / baseSize) * 100
-    const heightPct = (heightPx / baseSize) * 100
-
-    let x = 50, y = 50
-    let placedOk = false
-    const tries = i === 0 ? 1 : 420
-
-    for (let t = 0; t < tries; t++) {
-      if (i === 0) {
-        x = 50
-        y = 50
-      } else {
-        const idx = i + t * 0.28
-        const radius = Math.sqrt(idx) * 7.6 + (seededRandom(i * 1000 + t) * 1.2 - 0.6)
-        const angle = idx * 2.399963 + seededRandom(i * 2000 + t) * 0.35
-        x = 50 + radius * Math.cos(angle)
-        y = 50 + radius * Math.sin(angle)
-      }
-      if (canPlace(x, y, widthPct, heightPct)) {
-        placedOk = true
-        break
-      }
-    }
-
-    if (!placedOk) return null
-    placedItems.push({ x, y, w: widthPct, h: heightPct })
-
-    return (
-      <span
-        key={i}
-        className="word-tag"
-        style={{
-          '--final-opacity': opacity,
-          left: `${x.toFixed(2)}%`,
-          top: `${y.toFixed(2)}%`,
-          fontSize: `${fontSize}px`,
-          animationDelay: `${delay}s`,
-        } as CSSProperties}
-        title={`${item.phrase} (出现 ${item.count} 次)`}
-      >
-        {item.phrase}
-      </span>
-    )
-  }).filter(Boolean)
-
-  return (
-    <div className="word-cloud-wrapper">
-      <div className="word-cloud-inner">
-        {wordItems}
-      </div>
-    </div>
-  )
+  myExclusivePhrases: Array<{ phrase: string; count: number }>
+  friendExclusivePhrases: Array<{ phrase: string; count: number }>
+  heatmap?: number[][]
+  initiative?: { initiated: number; received: number }
+  response?: { avg: number; fastest: number; slowest: number; count: number }
+  monthly?: Record<string, number>
+  streak?: { days: number; startDate: string; endDate: string }
 }
 
 function DualReportWindow() {
@@ -155,6 +74,7 @@ function DualReportWindow() {
   const [loadingProgress, setLoadingProgress] = useState(0)
   const [myEmojiUrl, setMyEmojiUrl] = useState<string | null>(null)
   const [friendEmojiUrl, setFriendEmojiUrl] = useState<string | null>(null)
+  const [activeWordCloudTab, setActiveWordCloudTab] = useState<'shared' | 'my' | 'friend'>('shared')
 
   useEffect(() => {
     const params = new URLSearchParams(window.location.hash.split('?')[1] || '')
@@ -203,6 +123,8 @@ function DualReportWindow() {
   useEffect(() => {
     const loadEmojis = async () => {
       if (!reportData) return
+      setMyEmojiUrl(null)
+      setFriendEmojiUrl(null)
       const stats = reportData.stats
       if (stats.myTopEmojiUrl) {
         const res = await window.electronAPI.chat.downloadEmoji(stats.myTopEmojiUrl, stats.myTopEmojiMd5)
@@ -273,12 +195,15 @@ function DualReportWindow() {
     : null
   const yearFirstChat = reportData.yearFirstChat
   const stats = reportData.stats
+  const initiativeTotal = (reportData.initiative?.initiated || 0) + (reportData.initiative?.received || 0)
+  const initiatedPercent = initiativeTotal > 0 ? (reportData.initiative!.initiated / initiativeTotal) * 100 : 0
+  const receivedPercent = initiativeTotal > 0 ? (reportData.initiative!.received / initiativeTotal) * 100 : 0
   const statItems = [
-    { label: '总消息数', value: stats.totalMessages },
-    { label: '总字数', value: stats.totalWords },
-    { label: '图片', value: stats.imageCount },
-    { label: '语音', value: stats.voiceCount },
-    { label: '表情', value: stats.emojiCount },
+    { label: '总消息数', value: stats.totalMessages, color: '#07C160' },
+    { label: '总字数', value: stats.totalWords, color: '#10AEFF' },
+    { label: '图片', value: stats.imageCount, color: '#FFC300' },
+    { label: '语音', value: stats.voiceCount, color: '#FA5151' },
+    { label: '表情', value: stats.emojiCount, color: '#FA9D3B' },
   ]
 
   const decodeEntities = (text: string) => (
@@ -290,7 +215,28 @@ function DualReportWindow() {
       .replace(/&apos;/g, "'")
   )
 
+  const filterDisplayMessages = (messages: DualReportMessage[], maxActual: number = 3) => {
+    let actualCount = 0
+    const result: DualReportMessage[] = []
+    for (const msg of messages) {
+      const isSystem = msg.localType === 10000 || msg.localType === 10002
+      if (!isSystem) {
+        if (actualCount >= maxActual) break
+        actualCount++
+      }
+      result.push(msg)
+    }
+    return result
+  }
+
   const stripCdata = (text: string) => text.replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, '$1')
+  const compactMessageText = (text: string) => (
+    text
+      .replace(/\r\n/g, '\n')
+      .replace(/\s*\n+\s*/g, ' ')
+      .replace(/\s{2,}/g, ' ')
+      .trim()
+  )
 
   const extractXmlText = (content: string) => {
     const titleMatch = content.match(/<title>([\s\S]*?)<\/title>/i)
@@ -304,16 +250,62 @@ function DualReportWindow() {
     return ''
   }
 
-  const formatMessageContent = (content?: string) => {
-    const raw = String(content || '').trim()
+  const formatMessageContent = (content?: string, localType?: number) => {
+    const isSystemMsg = localType === 10000 || localType === 10002
+    if (!isSystemMsg) {
+      if (localType === 3) return '[图片]'
+      if (localType === 34) return '[语音]'
+      if (localType === 43) return '[视频]'
+      if (localType === 47) return '[表情]'
+      if (localType === 42) return '[名片]'
+      if (localType === 48) return '[位置]'
+      if (localType === 49) return '[链接/文件]'
+    }
+
+    const raw = compactMessageText(String(content || '').trim())
     if (!raw) return '（空）'
+
+    // 1. 尝试提取 XML 关键字段
+    const titleMatch = raw.match(/<title>([\s\S]*?)<\/title>/i)
+    if (titleMatch?.[1]) return compactMessageText(decodeEntities(stripCdata(titleMatch[1]).trim()))
+
+    const descMatch = raw.match(/<des>([\s\S]*?)<\/des>/i)
+    if (descMatch?.[1]) return compactMessageText(decodeEntities(stripCdata(descMatch[1]).trim()))
+
+    const summaryMatch = raw.match(/<summary>([\s\S]*?)<\/summary>/i)
+    if (summaryMatch?.[1]) return compactMessageText(decodeEntities(stripCdata(summaryMatch[1]).trim()))
+
+    // 2. 检查是否是 XML 结构
     const hasXmlTag = /<\s*[a-zA-Z]+[^>]*>/.test(raw)
-    const looksLikeXml = /<\?xml|<msg\b|<appmsg\b|<sysmsg\b|<appattach\b|<emoji\b|<img\b|<voip\b/i.test(raw)
-      || hasXmlTag
+    const looksLikeXml = /<\?xml|<msg\b|<appmsg\b|<sysmsg\b|<appattach\b|<emoji\b|<img\b|<voip\b/i.test(raw) || hasXmlTag
+
     if (!looksLikeXml) return raw
-    const extracted = extractXmlText(raw)
-    if (!extracted) return '（XML消息）'
-    return decodeEntities(stripCdata(extracted).trim()) || '（XML消息）'
+
+    // 3. 最后的尝试：移除所有 XML 标签，看是否还有有意义的文本
+    const stripped = raw.replace(/<[^>]+>/g, '').trim()
+    if (stripped && stripped.length > 0 && stripped.length < 50) {
+      return compactMessageText(decodeEntities(stripped))
+    }
+
+    return '[多媒体消息]'
+  }
+
+  const ReportMessageItem = ({ msg }: { msg: DualReportMessage }) => {
+    if (msg.localType === 47 && (msg.emojiMd5 || msg.emojiCdnUrl)) {
+      const emojiUrl = msg.emojiCdnUrl || (msg.emojiMd5 ? `https://emoji.qpic.cn/wx_emoji/${msg.emojiMd5}/0` : '')
+      if (emojiUrl) {
+        return (
+          <div className="report-emoji-container">
+            <img src={emojiUrl} alt="表情" className="report-emoji-img" onError={(e) => {
+              (e.target as HTMLImageElement).style.display = 'none';
+              (e.target as HTMLImageElement).nextElementSibling?.removeAttribute('style');
+            }} />
+            <span style={{ display: 'none' }}>[表情]</span>
+          </div>
+        )
+      }
+    }
+    return <span>{formatMessageContent(msg.content, msg.localType)}</span>
   }
   const formatFullDate = (timestamp: number) => {
     const d = new Date(timestamp)
@@ -325,6 +317,87 @@ function DualReportWindow() {
     return `${year}/${month}/${day} ${hour}:${minute}`
   }
 
+  const getMostActiveTime = (data: number[][]) => {
+    let maxHour = 0
+    let maxWeekday = 0
+    let maxVal = -1
+    data.forEach((row, weekday) => {
+      row.forEach((value, hour) => {
+        if (value > maxVal) {
+          maxVal = value
+          maxHour = hour
+          maxWeekday = weekday
+        }
+      })
+    })
+    const weekdayNames = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']
+    return {
+      weekday: weekdayNames[maxWeekday] || '周一',
+      hour: maxHour,
+      value: Math.max(0, maxVal)
+    }
+  }
+
+  const mostActive = reportData.heatmap ? getMostActiveTime(reportData.heatmap) : null
+  const responseAvgMinutes = reportData.response ? Math.max(0, Math.round(reportData.response.avg / 60)) : 0
+  const getSceneAvatarUrl = (isSentByMe: boolean) => (isSentByMe ? reportData.selfAvatarUrl : reportData.friendAvatarUrl)
+  const getSceneAvatarFallback = (isSentByMe: boolean) => (isSentByMe ? '我' : reportData.friendName.substring(0, 1))
+  const renderSceneAvatar = (isSentByMe: boolean) => {
+    const avatarUrl = getSceneAvatarUrl(isSentByMe)
+    if (avatarUrl) {
+      return (
+        <div className="scene-avatar with-image">
+          <img src={avatarUrl} alt={isSentByMe ? 'me-avatar' : 'friend-avatar'} />
+        </div>
+      )
+    }
+    return <div className="scene-avatar fallback">{getSceneAvatarFallback(isSentByMe)}</div>
+  }
+
+  const renderMessageList = (messages: DualReportMessage[]) => {
+    const displayMsgs = filterDisplayMessages(messages)
+    let lastTime = 0
+    const TIME_THRESHOLD = 5 * 60 * 1000 // 5 分钟
+
+    return displayMsgs.map((msg, idx) => {
+      const isSystem = msg.localType === 10000 || msg.localType === 10002
+      const showTime = idx === 0 || (msg.createTime - lastTime > TIME_THRESHOLD)
+      lastTime = msg.createTime
+
+      if (isSystem) {
+        return (
+          <div key={idx} className="scene-message system">
+            {showTime && (
+              <div className="scene-meta">
+                {formatFullDate(msg.createTime).split(' ')[1]}
+              </div>
+            )}
+            <div className="system-msg-content">
+              <ReportMessageItem msg={msg} />
+            </div>
+          </div>
+        )
+      }
+      return (
+        <div key={idx} className={`scene-message ${msg.isSentByMe ? 'sent' : 'received'}`}>
+          {showTime && (
+            <div className="scene-meta">
+              {formatFullDate(msg.createTime).split(' ')[1]}
+            </div>
+          )}
+          <div className="scene-body">
+            {renderSceneAvatar(msg.isSentByMe)}
+            <div className="scene-content-wrapper">
+              <div className={`scene-bubble ${msg.localType === 47 ? 'no-bubble' : ''}`}>
+                <div className="scene-content"><ReportMessageItem msg={msg} /></div>
+              </div>
+            </div>
+          </div>
+        </div>
+      )
+    })
+  }
+
   return (
     <div className="annual-report-window dual-report-window">
       <div className="drag-region" />
@@ -344,7 +417,7 @@ function DualReportWindow() {
             <h1 className="hero-title dual-cover-title">{yearTitle}<br />双人聊天报告</h1>
             <hr className="divider" />
             <div className="dual-names">
-              <span>{reportData.selfName}</span>
+              <span>我</span>
               <span className="amp">&amp;</span>
               <span>{reportData.friendName}</span>
             </div>
@@ -355,105 +428,255 @@ function DualReportWindow() {
             <div className="label-text">首次聊天</div>
             <h2 className="hero-title">故事的开始</h2>
             {firstChat ? (
-              <>
-                <div className="dual-info-grid">
-                  <div className="dual-info-card">
-                    <div className="info-label">第一次聊天时间</div>
-                    <div className="info-value">{formatFullDate(firstChat.createTime)}</div>
-                  </div>
-                  <div className="dual-info-card">
-                    <div className="info-label">距今天数</div>
-                    <div className="info-value">{daysSince} 天</div>
-                  </div>
-                </div>
+              <div className="first-chat-scene">
+                <div className="scene-title">第一次遇见</div>
+                <div className="scene-subtitle">{formatFullDate(firstChat.createTime).split(' ')[0]}</div>
                 {firstChatMessages.length > 0 ? (
-                  <div className="dual-message-list">
-                    {firstChatMessages.map((msg, idx) => (
-                      <div
-                        key={idx}
-                        className={`dual-message ${msg.isSentByMe ? 'sent' : 'received'}`}
-                      >
-                        <div className="message-meta">
-                          {msg.isSentByMe ? reportData.selfName : reportData.friendName} · {formatFullDate(msg.createTime)}
-                        </div>
-                        <div className="message-content">{formatMessageContent(msg.content)}</div>
-                      </div>
-                    ))}
+                  <div className="scene-messages">
+                    {renderMessageList(firstChatMessages)}
                   </div>
-                ) : null}
-              </>
+                ) : (
+                  <div className="hero-desc" style={{ textAlign: 'center' }}>暂无消息详情</div>
+                )}
+                <div className="scene-footer" style={{ marginTop: '20px', textAlign: 'center', fontSize: '14px', opacity: 0.6 }}>
+                  距离今天已经 {daysSince} 天
+                </div>
+              </div>
             ) : (
               <p className="hero-desc">暂无首条消息</p>
             )}
           </section>
 
-          {yearFirstChat ? (
+          {yearFirstChat && (!firstChat || yearFirstChat.createTime !== firstChat.createTime) ? (
             <section className="section">
               <div className="label-text">第一段对话</div>
               <h2 className="hero-title">
                 {reportData.year === 0 ? '你们的第一段对话' : `${reportData.year}年的第一段对话`}
               </h2>
-              <div className="dual-info-grid">
-                <div className="dual-info-card">
-                  <div className="info-label">第一段对话时间</div>
-                  <div className="info-value">{formatFullDate(yearFirstChat.createTime)}</div>
+              <div className="first-chat-scene">
+                <div className="scene-title">久别重逢</div>
+                <div className="scene-subtitle">{formatFullDate(yearFirstChat.createTime).split(' ')[0]}</div>
+                <div className="scene-messages">
+                  {renderMessageList(yearFirstChat.firstThreeMessages)}
                 </div>
-                <div className="dual-info-card">
-                  <div className="info-label">发起者</div>
-                  <div className="info-value">{yearFirstChat.isSentByMe ? reportData.selfName : reportData.friendName}</div>
-                </div>
-              </div>
-              <div className="dual-message-list">
-                {yearFirstChat.firstThreeMessages.map((msg, idx) => (
-                  <div key={idx} className={`dual-message ${msg.isSentByMe ? 'sent' : 'received'}`}>
-                    <div className="message-meta">
-                      {msg.isSentByMe ? reportData.selfName : reportData.friendName} · {formatFullDate(msg.createTime)}
-                    </div>
-                    <div className="message-content">{formatMessageContent(msg.content)}</div>
-                  </div>
-                ))}
               </div>
             </section>
           ) : null}
 
-          <section className="section">
+          {reportData.heatmap && (
+            <section className="section">
+              <div className="label-text">聊天习惯</div>
+              <h2 className="hero-title">作息规律</h2>
+              {mostActive && (
+                <p className="hero-desc active-time dual-active-time">
+                  在 <span className="hl">{mostActive.weekday} {String(mostActive.hour).padStart(2, '0')}:00</span> 最活跃（{mostActive.value}条）
+                </p>
+              )}
+              <ReportHeatmap data={reportData.heatmap} />
+            </section>
+          )}
+
+          {reportData.initiative && (
+            <section className="section">
+              <div className="label-text">主动性</div>
+              <h2 className="hero-title">情感的天平</h2>
+              <div className="initiative-container">
+                <div className="initiative-bar-wrapper">
+                  <div className="initiative-side">
+                    <div className="avatar-placeholder">
+                      {reportData.selfAvatarUrl ? <img src={reportData.selfAvatarUrl} alt="me-avatar" /> : '我'}
+                    </div>
+                    <div className="count">{reportData.initiative.initiated}次</div>
+                    <div className="percent">{initiatedPercent.toFixed(1)}%</div>
+                  </div>
+                  <div className="initiative-progress">
+                    <div className="line-bg" />
+                    <div
+                      className="initiative-indicator"
+                      style={{ left: `${initiatedPercent}%` }}
+                    />
+                  </div>
+                  <div className="initiative-side">
+                    <div className="avatar-placeholder">
+                      {reportData.friendAvatarUrl ? <img src={reportData.friendAvatarUrl} alt="friend-avatar" /> : reportData.friendName.substring(0, 1)}
+                    </div>
+                    <div className="count">{reportData.initiative.received}次</div>
+                    <div className="percent">{receivedPercent.toFixed(1)}%</div>
+                  </div>
+                </div>
+                <div className="initiative-desc">
+                  {reportData.initiative.initiated > reportData.initiative.received ? '每一个话题都是你对TA的在意' : 'TA总是那个率先打破沉默的人'}
+                </div>
+              </div>
+            </section>
+          )}
+
+          {reportData.response && (
+            <section className="section">
+              <div className="label-text">回应速度</div>
+              <h2 className="hero-title">你说，我在</h2>
+              <div className="response-pulse-container">
+                <div className="pulse-visual">
+                  <div className="pulse-ripple one" />
+                  <div className="pulse-ripple two" />
+                  <div className="pulse-ripple three" />
+
+                  <div className="pulse-node left">
+                    <div className="label">最快回复</div>
+                    <div className="value">{reportData.response.fastest}<span>秒</span></div>
+                  </div>
+
+                  <div className="pulse-hub">
+                    <div className="label">平均回复</div>
+                    <div className="value">{Math.round(reportData.response.avg / 60)}<span>分</span></div>
+                  </div>
+
+                  <div className="pulse-node right">
+                    <div className="label">最慢回复</div>
+                    <div className="value">
+                      {reportData.response.slowest > 3600
+                        ? (reportData.response.slowest / 3600).toFixed(1)
+                        : Math.round(reportData.response.slowest / 60)}
+                      <span>{reportData.response.slowest > 3600 ? '时' : '分'}</span>
+                    </div>
+                  </div>
+                </div>
+              </div>
+              <p className="hero-desc response-note">
+                {`在 ${reportData.response.count} 次互动中，平均约 ${responseAvgMinutes} 分钟，最快 ${reportData.response.fastest} 秒。`}
+              </p>
+            </section>
+          )}
+
+          {reportData.streak && (
+            <section className="section">
+              <div className="label-text">聊天火花</div>
+              <h2 className="hero-title">最长连续聊天</h2>
+              <div className="streak-spark-visual premium">
+                <div className="spark-ambient-glow" />
+
+                <div className="spark-ember one" />
+                <div className="spark-ember two" />
+                <div className="spark-ember three" />
+                <div className="spark-ember four" />
+
+                <div className="spark-core-wrapper">
+                  <div className="spark-flame-outer" />
+                  <div className="spark-flame-inner" />
+                  <div className="spark-core">
+                    <div className="spark-days">{reportData.streak.days}</div>
+                    <div className="spark-label">DAYS</div>
+                  </div>
+                </div>
+
+                <div className="streak-bridge premium">
+                  <div className="bridge-date start">
+                    <div className="date-orb" />
+                    <span>{reportData.streak.startDate}</span>
+                  </div>
+                  <div className="bridge-line">
+                    <div className="line-glow" />
+                    <div className="line-string" />
+                  </div>
+                  <div className="bridge-date end">
+                    <span>{reportData.streak.endDate}</span>
+                    <div className="date-orb" />
+                  </div>
+                </div>
+              </div>
+            </section>
+          )}
+
+          <section className="section word-cloud-section">
             <div className="label-text">常用语</div>
             <h2 className="hero-title">{yearTitle}常用语</h2>
-            <WordCloud words={reportData.topPhrases} />
+
+            <div className="word-cloud-tabs">
+              <button
+                className={`tab-item ${activeWordCloudTab === 'shared' ? 'active' : ''}`}
+                onClick={() => setActiveWordCloudTab('shared')}
+              >
+                共用词汇
+              </button>
+              <button
+                className={`tab-item ${activeWordCloudTab === 'my' ? 'active' : ''}`}
+                onClick={() => setActiveWordCloudTab('my')}
+              >
+                我的专属
+              </button>
+              <button
+                className={`tab-item ${activeWordCloudTab === 'friend' ? 'active' : ''}`}
+                onClick={() => setActiveWordCloudTab('friend')}
+              >
+                TA的专属
+              </button>
+            </div>
+
+            <div className={`word-cloud-container fade-in ${activeWordCloudTab}`}>
+              {activeWordCloudTab === 'shared' && <ReportWordCloud words={reportData.topPhrases} />}
+              {activeWordCloudTab === 'my' && (
+                reportData.myExclusivePhrases && reportData.myExclusivePhrases.length > 0 ? (
+                  <ReportWordCloud words={reportData.myExclusivePhrases} />
+                ) : (
+                  <div className="empty-state">暂无专属词汇</div>
+                )
+              )}
+              {activeWordCloudTab === 'friend' && (
+                reportData.friendExclusivePhrases && reportData.friendExclusivePhrases.length > 0 ? (
+                  <ReportWordCloud words={reportData.friendExclusivePhrases} />
+                ) : (
+                  <div className="empty-state">暂无专属词汇</div>
+                )
+              )}
+            </div>
           </section>
 
           <section className="section">
             <div className="label-text">年度统计</div>
             <h2 className="hero-title">{yearTitle}数据概览</h2>
             <div className="dual-stat-grid">
-              {statItems.map((item) => {
-                const valueText = item.value.toLocaleString()
-                const isLong = valueText.length > 7
-                return (
-                  <div key={item.label} className={`dual-stat-card ${isLong ? 'long' : ''}`}>
-                    <div className="stat-num">{valueText}</div>
-                    <div className="stat-unit">{item.label}</div>
-                  </div>
-                )
-              })}
+              {statItems.slice(0, 2).map((item) => (
+                <div key={item.label} className="dual-stat-card">
+                  <div className="stat-num">{item.value.toLocaleString()}</div>
+                  <div className="stat-unit">{item.label}</div>
+                </div>
+              ))}
+            </div>
+            <div className="dual-stat-grid bottom">
+              {statItems.slice(2).map((item) => (
+                <div key={item.label} className="dual-stat-card">
+                  <div className="stat-num small">{item.value.toLocaleString()}</div>
+                  <div className="stat-unit">{item.label}</div>
+                </div>
+              ))}
             </div>
 
             <div className="emoji-row">
               <div className="emoji-card">
                 <div className="emoji-title">我常用的表情</div>
                 {myEmojiUrl ? (
-                  <img src={myEmojiUrl} alt="my-emoji" />
-                ) : (
-                  <div className="emoji-placeholder">{stats.myTopEmojiMd5 || '暂无'}</div>
-                )}
+                  <img src={myEmojiUrl} alt="my-emoji" onError={(e) => {
+                    (e.target as HTMLImageElement).nextElementSibling?.removeAttribute('style');
+                    (e.target as HTMLImageElement).style.display = 'none';
+                  }} />
+                ) : null}
+                <div className="emoji-placeholder" style={myEmojiUrl ? { display: 'none' } : undefined}>
+                  {stats.myTopEmojiMd5 || '暂无'}
+                </div>
+                <div className="emoji-count">{stats.myTopEmojiCount ? `${stats.myTopEmojiCount}次` : '暂无统计'}</div>
               </div>
               <div className="emoji-card">
                 <div className="emoji-title">{reportData.friendName}常用的表情</div>
                 {friendEmojiUrl ? (
-                  <img src={friendEmojiUrl} alt="friend-emoji" />
-                ) : (
-                  <div className="emoji-placeholder">{stats.friendTopEmojiMd5 || '暂无'}</div>
-                )}
+                  <img src={friendEmojiUrl} alt="friend-emoji" onError={(e) => {
+                    (e.target as HTMLImageElement).nextElementSibling?.removeAttribute('style');
+                    (e.target as HTMLImageElement).style.display = 'none';
+                  }} />
+                ) : null}
+                <div className="emoji-placeholder" style={friendEmojiUrl ? { display: 'none' } : undefined}>
+                  {stats.friendTopEmojiMd5 || '暂无'}
+                </div>
+                <div className="emoji-count">{stats.friendTopEmojiCount ? `${stats.friendTopEmojiCount}次` : '暂无统计'}</div>
               </div>
             </div>
           </section>

src/pages/ExportPage.scss

@@ -830,8 +830,7 @@
     padding: 28px 32px;
     border-radius: 16px;
     box-shadow: 0 20px 60px rgba(0, 0, 0, 0.25);
-    min-width: 420px;
-    max-width: 500px;
+    width: 420px;
 
     h3 {
       font-size: 18px;
@@ -977,10 +976,10 @@
     .calendar-days {
       display: grid;
       grid-template-columns: repeat(7, 1fr);
+      grid-template-rows: repeat(6, 40px);
       gap: 4px;
 
       .calendar-day {
-        aspect-ratio: 1;
         display: flex;
         align-items: center;
         justify-content: center;

src/pages/ExportPage.tsx

@@ -1,4 +1,5 @@
-import { useState, useEffect, useCallback, useRef } from 'react'
+import { useState, useEffect, useCallback, useRef, useMemo } from 'react'
+import { useLocation } from 'react-router-dom'
 import { Search, Download, FolderOpen, RefreshCw, Check, Calendar, FileJson, FileText, Table, Loader2, X, ChevronDown, ChevronLeft, ChevronRight, FileSpreadsheet, Database, FileCode, CheckCircle, XCircle, ExternalLink } from 'lucide-react'
 import * as configService from '../services/config'
 import './ExportPage.scss'
@@ -12,7 +13,7 @@ interface ChatSession {
 }
 
 interface ExportOptions {
-  format: 'chatlab' | 'chatlab-jsonl' | 'json' | 'html' | 'txt' | 'excel' | 'sql'
+  format: 'chatlab' | 'chatlab-jsonl' | 'json' | 'html' | 'txt' | 'excel' | 'weclone' | 'sql'
   dateRange: { start: Date; end: Date } | null
   useAllTime: boolean
   exportAvatars: boolean
@@ -38,6 +39,7 @@ interface ExportResult {
 type SessionLayout = 'shared' | 'per-session'
 
 function ExportPage() {
+  const location = useLocation()
   const defaultTxtColumns = ['index', 'time', 'senderRole', 'messageType', 'content']
   const [sessions, setSessions] = useState<ChatSession[]>([])
   const [filteredSessions, setFilteredSessions] = useState<ChatSession[]>([])
@@ -46,14 +48,36 @@ function ExportPage() {
   const [searchKeyword, setSearchKeyword] = useState('')
   const [exportFolder, setExportFolder] = useState<string>('')
   const [isExporting, setIsExporting] = useState(false)
-  const [exportProgress, setExportProgress] = useState({ current: 0, total: 0, currentName: '' })
+  const [exportProgress, setExportProgress] = useState({ current: 0, total: 0, currentName: '', phaseLabel: '', phaseProgress: 0, phaseTotal: 0 })
   const [exportResult, setExportResult] = useState<ExportResult | null>(null)
   const [showDatePicker, setShowDatePicker] = useState(false)
   const [calendarDate, setCalendarDate] = useState(new Date())
   const [selectingStart, setSelectingStart] = useState(true)
   const [showMediaLayoutPrompt, setShowMediaLayoutPrompt] = useState(false)
   const [showDisplayNameSelect, setShowDisplayNameSelect] = useState(false)
+  const [showPreExportDialog, setShowPreExportDialog] = useState(false)
+  const [preExportStats, setPreExportStats] = useState<{
+    totalMessages: number; voiceMessages: number; cachedVoiceCount: number;
+    needTranscribeCount: number; mediaMessages: number; estimatedSeconds: number
+  } | null>(null)
+  const [isLoadingStats, setIsLoadingStats] = useState(false)
+  const [pendingLayout, setPendingLayout] = useState<SessionLayout>('shared')
+  const exportStartTime = useRef<number>(0)
+  const [elapsedSeconds, setElapsedSeconds] = useState(0)
   const displayNameDropdownRef = useRef<HTMLDivElement>(null)
+  const preselectAppliedRef = useRef(false)
+
+  const preselectSessionIds = useMemo(() => {
+    const state = location.state as { preselectSessionIds?: unknown; preselectSessionId?: unknown } | null
+    const rawList = Array.isArray(state?.preselectSessionIds)
+      ? state?.preselectSessionIds
+      : (typeof state?.preselectSessionId === 'string' ? [state.preselectSessionId] : [])
+
+    return rawList
+      .filter((item): item is string => typeof item === 'string')
+      .map(item => item.trim())
+      .filter(Boolean)
+  }, [location.state])
 
   const [options, setOptions] = useState<ExportOptions>({
     format: 'excel',
@@ -68,7 +92,7 @@ function ExportPage() {
     exportVoices: true,
     exportVideos: true,
     exportEmojis: true,
-    exportVoiceAsText: true,
+    exportVoiceAsText: false,
     excelCompactColumns: true,
     txtColumns: defaultTxtColumns,
     displayNamePreference: 'remark',
@@ -159,7 +183,7 @@ function ExportPage() {
         useAllTime: rangeDefaults.useAllTime,
         dateRange: rangeDefaults.dateRange,
         exportMedia: savedMedia ?? false,
-        exportVoiceAsText: savedVoiceAsText ?? true,
+        exportVoiceAsText: savedVoiceAsText ?? false,
         excelCompactColumns: savedExcelCompactColumns ?? true,
         txtColumns,
         exportConcurrency: savedConcurrency ?? 2
@@ -175,6 +199,24 @@ function ExportPage() {
     loadExportDefaults()
   }, [loadSessions, loadExportPath, loadExportDefaults])
 
+  useEffect(() => {
+    preselectAppliedRef.current = false
+  }, [location.key, preselectSessionIds])
+
+  useEffect(() => {
+    if (preselectAppliedRef.current) return
+    if (sessions.length === 0 || preselectSessionIds.length === 0) return
+
+    const exists = new Set(sessions.map(session => session.username))
+    const matched = preselectSessionIds.filter(id => exists.has(id))
+    preselectAppliedRef.current = true
+
+    if (matched.length > 0) {
+      setSelectedSessions(new Set(matched))
+      setSearchKeyword('')
+    }
+  }, [sessions, preselectSessionIds])
+
   useEffect(() => {
     const handleChange = () => {
       setSelectedSessions(new Set())
@@ -189,17 +231,30 @@ function ExportPage() {
   }, [loadSessions])
 
   useEffect(() => {
-    const removeListener = window.electronAPI.export.onProgress?.((payload: { current: number; total: number; currentSession: string; phase: string }) => {
+    const removeListener = window.electronAPI.export.onProgress?.((payload: { current: number; total: number; currentSession: string; phase: string; phaseProgress?: number; phaseTotal?: number; phaseLabel?: string }) => {
       setExportProgress({
         current: payload.current,
         total: payload.total,
-        currentName: payload.currentSession
+        currentName: payload.currentSession,
+        phaseLabel: payload.phaseLabel || '',
+        phaseProgress: payload.phaseProgress || 0,
+        phaseTotal: payload.phaseTotal || 0
       })
     })
     return () => {
       removeListener?.()
     }
   }, [])
+
+  // 导出计时器
+  useEffect(() => {
+    if (!isExporting) return
+    const timer = setInterval(() => {
+      setElapsedSeconds(Math.floor((Date.now() - exportStartTime.current) / 1000))
+    }, 1000)
+    return () => clearInterval(timer)
+  }, [isExporting])
+
   useEffect(() => {
     const handleClickOutside = (event: MouseEvent) => {
       const target = event.target as Node
@@ -260,8 +315,7 @@ function ExportPage() {
           exportImages: true,
           exportVoices: true,
           exportVideos: true,
-          exportEmojis: true,
-          exportVoiceAsText: true
+          exportEmojis: true
         }
       }
       return next
@@ -278,8 +332,10 @@ function ExportPage() {
     if (selectedSessions.size === 0 || !exportFolder) return
 
     setIsExporting(true)
-    setExportProgress({ current: 0, total: selectedSessions.size, currentName: '' })
+    setExportProgress({ current: 0, total: selectedSessions.size, currentName: '', phaseLabel: '', phaseProgress: 0, phaseTotal: 0 })
     setExportResult(null)
+    exportStartTime.current = Date.now()
+    setElapsedSeconds(0)
 
     try {
       const sessionList = Array.from(selectedSessions)
@@ -304,7 +360,7 @@ function ExportPage() {
         } : null
       }
 
-      if (options.format === 'chatlab' || options.format === 'chatlab-jsonl' || options.format === 'json' || options.format === 'excel' || options.format === 'txt' || options.format === 'html') {
+      if (options.format === 'chatlab' || options.format === 'chatlab-jsonl' || options.format === 'json' || options.format === 'excel' || options.format === 'txt' || options.format === 'html' || options.format === 'weclone') {
         const result = await window.electronAPI.export.exportSessions(
           sessionList,
           exportFolder,
@@ -322,9 +378,41 @@ function ExportPage() {
     }
   }
 
-  const startExport = () => {
+  const startExport = async () => {
     if (selectedSessions.size === 0 || !exportFolder) return
 
+    // 先获取预估统计
+    setIsLoadingStats(true)
+    setShowPreExportDialog(true)
+    try {
+      const sessionList = Array.from(selectedSessions)
+      const exportOptions = {
+        format: options.format,
+        exportVoiceAsText: options.exportVoiceAsText,
+        exportMedia: options.exportMedia,
+        exportImages: options.exportMedia && options.exportImages,
+        exportVoices: options.exportMedia && options.exportVoices,
+        exportVideos: options.exportMedia && options.exportVideos,
+        exportEmojis: options.exportMedia && options.exportEmojis,
+        dateRange: options.useAllTime ? null : options.dateRange ? {
+          start: Math.floor(options.dateRange.start.getTime() / 1000),
+          end: Math.floor(new Date(options.dateRange.end.getFullYear(), options.dateRange.end.getMonth(), options.dateRange.end.getDate(), 23, 59, 59).getTime() / 1000)
+        } : null
+      }
+      const stats = await window.electronAPI.export.getExportStats(sessionList, exportOptions)
+      setPreExportStats(stats)
+    } catch (e) {
+      console.error('获取导出统计失败:', e)
+      setPreExportStats(null)
+    } finally {
+      setIsLoadingStats(false)
+    }
+  }
+
+  const confirmExport = () => {
+    setShowPreExportDialog(false)
+    setPreExportStats(null)
+
     if (options.exportMedia && selectedSessions.size > 1) {
       setShowMediaLayoutPrompt(true)
       return
@@ -425,6 +513,7 @@ function ExportPage() {
     { value: 'html', label: 'HTML', icon: FileText, desc: '网页格式，可直接浏览' },
     { value: 'txt', label: 'TXT', icon: Table, desc: '纯文本，通用格式' },
     { value: 'excel', label: 'Excel', icon: FileSpreadsheet, desc: '电子表格，适合统计分析' },
+    { value: 'weclone', label: 'WeClone CSV', icon: Table, desc: 'WeClone 兼容字段格式（CSV）' },
     { value: 'sql', label: 'PostgreSQL', icon: Database, desc: '数据库脚本，便于导入到数据库' }
   ]
   const displayNameOptions = [
@@ -814,6 +903,71 @@ function ExportPage() {
         </div>
       )}
 
+      {/* 导出前预估弹窗 */}
+      {showPreExportDialog && (
+        <div className="export-overlay">
+          <div className="export-layout-modal" onClick={e => e.stopPropagation()}>
+            <h3>导出预估</h3>
+            {isLoadingStats ? (
+              <div style={{ display: 'flex', alignItems: 'center', gap: 8, padding: '24px 0', justifyContent: 'center' }}>
+                <Loader2 size={20} className="spin" />
+                <span style={{ fontSize: 14, color: 'var(--text-secondary)' }}>正在统计消息...</span>
+              </div>
+            ) : preExportStats ? (
+              <div style={{ padding: '12px 0' }}>
+                <div style={{ display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '12px 24px', fontSize: 14 }}>
+                  <div>
+                    <span style={{ color: 'var(--text-secondary)' }}>会话数</span>
+                    <div style={{ fontWeight: 600, fontSize: 18, marginTop: 2 }}>{selectedSessions.size}</div>
+                  </div>
+                  <div>
+                    <span style={{ color: 'var(--text-secondary)' }}>总消息</span>
+                    <div style={{ fontWeight: 600, fontSize: 18, marginTop: 2 }}>{preExportStats.totalMessages.toLocaleString()}</div>
+                  </div>
+                  {options.exportVoiceAsText && preExportStats.voiceMessages > 0 && (
+                    <>
+                      <div>
+                        <span style={{ color: 'var(--text-secondary)' }}>语音消息</span>
+                        <div style={{ fontWeight: 600, fontSize: 18, marginTop: 2 }}>{preExportStats.voiceMessages}</div>
+                      </div>
+                      <div>
+                        <span style={{ color: 'var(--text-secondary)' }}>已有缓存</span>
+                        <div style={{ fontWeight: 600, fontSize: 18, marginTop: 2, color: 'var(--primary)' }}>{preExportStats.cachedVoiceCount}</div>
+                      </div>
+                    </>
+                  )}
+                </div>
+                {options.exportVoiceAsText && preExportStats.needTranscribeCount > 0 && (
+                  <div style={{ marginTop: 16, padding: '10px 12px', background: 'var(--bg-tertiary)', borderRadius: 8, fontSize: 13 }}>
+                    <span style={{ color: 'var(--text-warning, #e6a23c)' }}>⚠</span>
+                    {' '}需要转写 <b>{preExportStats.needTranscribeCount}</b> 条语音，预计耗时约 <b>{preExportStats.estimatedSeconds > 60
+                      ? `${Math.round(preExportStats.estimatedSeconds / 60)} 分钟`
+                      : `${preExportStats.estimatedSeconds} 秒`
+                    }</b>
+                  </div>
+                )}
+                {options.exportVoiceAsText && preExportStats.voiceMessages > 0 && preExportStats.needTranscribeCount === 0 && (
+                  <div style={{ marginTop: 16, padding: '10px 12px', background: 'var(--bg-tertiary)', borderRadius: 8, fontSize: 13 }}>
+                    <span style={{ color: 'var(--text-success, #67c23a)' }}>✓</span>
+                    {' '}所有 {preExportStats.voiceMessages} 条语音已有转写缓存，无需重新转写
+                  </div>
+                )}
+              </div>
+            ) : (
+              <p style={{ fontSize: 14, color: 'var(--text-secondary)', padding: '16px 0' }}>统计信息获取失败，仍可继续导出</p>
+            )}
+            <div className="layout-actions" style={{ display: 'flex', gap: 8, justifyContent: 'flex-end', marginTop: 8 }}>
+              <button className="layout-cancel-btn" onClick={() => { setShowPreExportDialog(false); setPreExportStats(null) }}>
+                取消
+              </button>
+              <button className="layout-option-btn primary" onClick={confirmExport} disabled={isLoadingStats}>
+                <span className="layout-title">开始导出</span>
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
+
       {/* 导出进度弹窗 */}
       {isExporting && (
         <div className="export-overlay">
@@ -823,13 +977,31 @@ function ExportPage() {
             </div>
             <h3>正在导出</h3>
             <p className="progress-text">{exportProgress.currentName}</p>
+            {exportProgress.phaseLabel && (
+              <p className="progress-phase-label" style={{ fontSize: 13, color: 'var(--text-secondary)', margin: '4px 0 8px' }}>
+                {exportProgress.phaseLabel}
+              </p>
+            )}
+            {exportProgress.phaseTotal > 0 && (
+              <div className="progress-bar" style={{ marginBottom: 8 }}>
+                <div
+                  className="progress-fill"
+                  style={{ width: `${(exportProgress.phaseProgress / exportProgress.phaseTotal) * 100}%`, background: 'var(--primary-light, #79bbff)' }}
+                />
+              </div>
+            )}
             <div className="progress-bar">
               <div
                 className="progress-fill"
-                style={{ width: `${(exportProgress.current / exportProgress.total) * 100}%` }}
+                style={{ width: `${exportProgress.total > 0 ? (exportProgress.current / exportProgress.total) * 100 : 0}%` }}
               />
             </div>
-            <p className="progress-count">{exportProgress.current} / {exportProgress.total}</p>
+            <p className="progress-count">
+              {exportProgress.current} / {exportProgress.total} 个会话
+              <span style={{ marginLeft: 12, fontSize: 12, color: 'var(--text-secondary)' }}>
+                {elapsedSeconds > 0 && `已用 ${elapsedSeconds >= 60 ? `${Math.floor(elapsedSeconds / 60)}分${elapsedSeconds % 60}秒` : `${elapsedSeconds}秒`}`}
+              </span>
+            </p>
           </div>
         </div>
       )}
@@ -912,7 +1084,7 @@ function ExportPage() {
               >
                 <span className="date-label">开始日期</span>
                 <span className="date-value">
-                  {options.dateRange?.start.toLocaleDateString('zh-CN', {
+                  {options.dateRange?.start?.toLocaleDateString('zh-CN', {
                     year: 'numeric',
                     month: '2-digit',
                     day: '2-digit'
@@ -926,7 +1098,7 @@ function ExportPage() {
               >
                 <span className="date-label">结束日期</span>
                 <span className="date-value">
-                  {options.dateRange?.end.toLocaleDateString('zh-CN', {
+                  {options.dateRange?.end?.toLocaleDateString('zh-CN', {
                     year: 'numeric',
                     month: '2-digit',
                     day: '2-digit'
@@ -964,9 +1136,9 @@ function ExportPage() {
                   }
 
                   const currentDate = new Date(calendarDate.getFullYear(), calendarDate.getMonth(), day)
-                  const isStart = options.dateRange?.start.toDateString() === currentDate.toDateString()
-                  const isEnd = options.dateRange?.end.toDateString() === currentDate.toDateString()
-                  const isInRange = options.dateRange && currentDate >= options.dateRange.start && currentDate <= options.dateRange.end
+                  const isStart = options.dateRange?.start?.toDateString() === currentDate.toDateString()
+                  const isEnd = options.dateRange?.end?.toDateString() === currentDate.toDateString()
+                  const isInRange = options.dateRange?.start && options.dateRange?.end && currentDate >= options.dateRange.start && currentDate <= options.dateRange.end
                   const today = new Date()
                   today.setHours(0, 0, 0, 0)
                   const isFuture = currentDate > today

src/pages/GroupAnalyticsPage.tsx

@@ -1,4 +1,5 @@
-import { useState, useEffect, useRef, useCallback } from 'react'
+import { useState, useEffect, useRef, useCallback, useMemo } from 'react'
+import { useLocation } from 'react-router-dom'
 import { Users, BarChart3, Clock, Image, Loader2, RefreshCw, User, Medal, Search, X, ChevronLeft, Copy, Check, Download } from 'lucide-react'
 import { Avatar } from '../components/Avatar'
 import ReactECharts from 'echarts-for-react'
@@ -30,6 +31,7 @@ interface GroupMessageRank {
 type AnalysisFunction = 'members' | 'ranking' | 'activeHours' | 'mediaStats'
 
 function GroupAnalyticsPage() {
+  const location = useLocation()
   const [groups, setGroups] = useState<GroupChatInfo[]>([])
   const [filteredGroups, setFilteredGroups] = useState<GroupChatInfo[]>([])
   const [isLoading, setIsLoading] = useState(true)
@@ -58,11 +60,28 @@ function GroupAnalyticsPage() {
   const [sidebarWidth, setSidebarWidth] = useState(300)
   const [isResizing, setIsResizing] = useState(false)
   const containerRef = useRef<HTMLDivElement>(null)
+  const preselectAppliedRef = useRef(false)
+
+  const preselectGroupIds = useMemo(() => {
+    const state = location.state as { preselectGroupIds?: unknown; preselectGroupId?: unknown } | null
+    const rawList = Array.isArray(state?.preselectGroupIds)
+      ? state.preselectGroupIds
+      : (typeof state?.preselectGroupId === 'string' ? [state.preselectGroupId] : [])
+
+    return rawList
+      .filter((item): item is string => typeof item === 'string')
+      .map(item => item.trim())
+      .filter(Boolean)
+  }, [location.state])
 
   useEffect(() => {
     loadGroups()
   }, [])
 
+  useEffect(() => {
+    preselectAppliedRef.current = false
+  }, [location.key, preselectGroupIds])
+
   useEffect(() => {
     if (searchQuery) {
       setFilteredGroups(groups.filter(g => g.displayName.toLowerCase().includes(searchQuery.toLowerCase())))
@@ -71,6 +90,20 @@ function GroupAnalyticsPage() {
     }
   }, [searchQuery, groups])
 
+  useEffect(() => {
+    if (preselectAppliedRef.current) return
+    if (groups.length === 0 || preselectGroupIds.length === 0) return
+
+    const matchedGroup = groups.find(group => preselectGroupIds.includes(group.username))
+    preselectAppliedRef.current = true
+
+    if (matchedGroup) {
+      setSelectedGroup(matchedGroup)
+      setSelectedFunction(null)
+      setSearchQuery('')
+    }
+  }, [groups, preselectGroupIds])
+
   // 拖动调整宽度
   useEffect(() => {
     const handleMouseMove = (e: MouseEvent) => {

src/pages/SettingsPage.scss

@@ -1191,6 +1191,111 @@
   }
 }
 
+// 通用弹窗覆盖层
+.modal-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.5);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+  animation: fadeIn 0.2s ease;
+}
+
+// API 警告弹窗
+.api-warning-modal {
+  width: 420px;
+  background: var(--bg-primary);
+  border-radius: 16px;
+  overflow: hidden;
+  box-shadow: 0 16px 48px rgba(0, 0, 0, 0.2);
+  animation: slideUp 0.25s ease;
+
+  .modal-header {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    padding: 20px 24px;
+    border-bottom: 1px solid var(--border-color);
+
+    svg {
+      color: var(--warning, #f59e0b);
+    }
+
+    h3 {
+      margin: 0;
+      font-size: 16px;
+      font-weight: 600;
+      color: var(--text-primary);
+    }
+  }
+
+  .modal-body {
+    padding: 20px 24px;
+
+    .warning-text {
+      margin: 0 0 16px;
+      font-size: 14px;
+      color: var(--text-secondary);
+      line-height: 1.6;
+    }
+
+    .warning-list {
+      display: flex;
+      flex-direction: column;
+      gap: 10px;
+
+      .warning-item {
+        display: flex;
+        align-items: flex-start;
+        gap: 8px;
+        font-size: 13px;
+        color: var(--text-secondary);
+        line-height: 1.5;
+
+        .bullet {
+          color: var(--warning, #f59e0b);
+          font-weight: bold;
+        }
+      }
+    }
+  }
+
+  .modal-footer {
+    display: flex;
+    justify-content: flex-end;
+    gap: 10px;
+    padding: 16px 24px;
+    border-top: 1px solid var(--border-color);
+    background: var(--bg-secondary);
+  }
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+@keyframes slideUp {
+  from {
+    opacity: 0;
+    transform: translateY(10px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
 
 // 协议弹窗
 .agreement-overlay {
@@ -1855,4 +1960,216 @@
   to {
     transform: rotate(360deg);
   }
+}
+
+// API 地址显示样式
+.api-url-display {
+  display: flex;
+  gap: 8px;
+  margin-top: 8px;
+
+  input {
+    flex: 1;
+    font-family: 'SF Mono', 'Consolas', monospace;
+    font-size: 13px;
+  }
+
+  .btn {
+    flex-shrink: 0;
+  }
+}
+
+// API 服务设置样式
+.status-badge {
+  display: inline-flex;
+  align-items: center;
+  padding: 4px 10px;
+  border-radius: 12px;
+  font-size: 12px;
+  font-weight: 500;
+
+  &.running {
+    background: rgba(34, 197, 94, 0.15);
+    color: #22c55e;
+  }
+
+  &.stopped {
+    background: rgba(156, 163, 175, 0.15);
+    color: var(--text-tertiary);
+  }
+}
+
+.api-url {
+  display: inline-block;
+  padding: 8px 14px;
+  background: var(--bg-tertiary);
+  border-radius: 6px;
+  font-family: 'SF Mono', 'Consolas', monospace;
+  font-size: 13px;
+  color: var(--text-primary);
+  border: 1px solid var(--border-color);
+}
+
+.api-docs {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.api-item {
+  padding: 12px 16px;
+  background: var(--bg-tertiary);
+  border-radius: 8px;
+  border: 1px solid var(--border-color);
+
+  .api-endpoint {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    margin-bottom: 6px;
+
+    .method {
+      display: inline-block;
+      padding: 2px 8px;
+      border-radius: 4px;
+      font-size: 11px;
+      font-weight: 600;
+      text-transform: uppercase;
+
+      &.get {
+        background: rgba(34, 197, 94, 0.15);
+        color: #22c55e;
+      }
+
+      &.post {
+        background: rgba(59, 130, 246, 0.15);
+        color: #3b82f6;
+      }
+    }
+
+    code {
+      font-family: 'SF Mono', 'Consolas', monospace;
+      font-size: 13px;
+      color: var(--text-primary);
+    }
+  }
+
+  .api-desc {
+    font-size: 12px;
+    color: var(--text-secondary);
+    margin: 0 0 8px 0;
+  }
+
+  .api-params {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 6px;
+
+    .param {
+      display: inline-block;
+      padding: 2px 8px;
+      background: var(--bg-secondary);
+      border-radius: 4px;
+      font-size: 11px;
+      color: var(--text-tertiary);
+
+      code {
+        color: var(--primary);
+        font-family: 'SF Mono', 'Consolas', monospace;
+      }
+    }
+  }
+}
+
+.code-block {
+  padding: 12px 16px;
+  background: var(--bg-tertiary);
+  border-radius: 8px;
+  border: 1px solid var(--border-color);
+  overflow-x: auto;
+
+  code {
+    font-family: 'SF Mono', 'Consolas', monospace;
+    font-size: 12px;
+    color: var(--text-primary);
+    white-space: nowrap;
+  }
+}
+
+.btn-sm {
+  padding: 4px 10px !important;
+  font-size: 12px !important;
+
+
+  svg {
+    width: 14px;
+    height: 14px;
+  }
+}
+
+// Analysis Settings Styling
+.settings-section {
+  h2 {
+    font-size: 18px;
+    font-weight: 600;
+    color: var(--text-primary);
+    margin: 0 0 16px;
+  }
+}
+
+.setting-item {
+  margin-bottom: 20px;
+}
+
+.setting-label {
+  display: flex;
+  flex-direction: column;
+  margin-bottom: 8px;
+
+  span:first-child {
+    font-size: 14px;
+    font-weight: 500;
+    color: var(--text-primary);
+  }
+
+  .setting-desc {
+    font-size: 13px;
+    color: var(--text-tertiary);
+    margin-top: 2px;
+  }
+}
+
+.setting-control {
+  display: flex;
+
+  // textarea specific
+  textarea.form-input {
+    width: 100%;
+    padding: 12px;
+    background: var(--bg-primary);
+    border: 1px solid var(--border-color);
+    border-radius: 12px;
+    color: var(--text-primary);
+    font-family: monospace;
+    font-size: 13px;
+    resize: vertical;
+    transition: all 0.2s;
+    outline: none;
+
+    &:focus {
+      border-color: var(--primary);
+      box-shadow: 0 0 0 3px color-mix(in srgb, var(--primary) 10%, transparent);
+    }
+
+    &::placeholder {
+      color: var(--text-tertiary);
+    }
+  }
+
+  .button-group {
+    display: flex;
+    gap: 12px;
+    width: 100%;
+    margin-top: 12px;
+  }
 }

src/pages/SettingsPage.tsx

@@ -9,12 +9,12 @@ import {
   Eye, EyeOff, FolderSearch, FolderOpen, Search, Copy,
   RotateCcw, Trash2, Plug, Check, Sun, Moon,
   Palette, Database, Download, HardDrive, Info, RefreshCw, ChevronDown, Mic,
-  ShieldCheck, Fingerprint, Lock, KeyRound, Bell
+  ShieldCheck, Fingerprint, Lock, KeyRound, Bell, Globe, BarChart2
 } from 'lucide-react'
 import { Avatar } from '../components/Avatar'
 import './SettingsPage.scss'
 
-type SettingsTab = 'appearance' | 'notification' | 'database' | 'models' | 'export' | 'cache' | 'security' | 'about'
+type SettingsTab = 'appearance' | 'notification' | 'database' | 'models' | 'export' | 'cache' | 'api' | 'security' | 'about' | 'analytics'
 
 const tabs: { id: SettingsTab; label: string; icon: React.ElementType }[] = [
   { id: 'appearance', label: '外观', icon: Palette },
@@ -23,6 +23,9 @@ const tabs: { id: SettingsTab; label: string; icon: React.ElementType }[] = [
   { id: 'models', label: '模型管理', icon: Mic },
   { id: 'export', label: '导出', icon: Download },
   { id: 'cache', label: '缓存', icon: HardDrive },
+  { id: 'api', label: 'API 服务', icon: Globe },
+
+  { id: 'analytics', label: '分析', icon: BarChart2 },
   { id: 'security', label: '安全', icon: ShieldCheck },
   { id: 'about', label: '关于', icon: Info }
 ]
@@ -96,7 +99,7 @@ function SettingsPage() {
   const [exportDefaultFormat, setExportDefaultFormat] = useState('excel')
   const [exportDefaultDateRange, setExportDefaultDateRange] = useState('today')
   const [exportDefaultMedia, setExportDefaultMedia] = useState(false)
-  const [exportDefaultVoiceAsText, setExportDefaultVoiceAsText] = useState(true)
+  const [exportDefaultVoiceAsText, setExportDefaultVoiceAsText] = useState(false)
   const [exportDefaultExcelCompactColumns, setExportDefaultExcelCompactColumns] = useState(true)
   const [exportDefaultConcurrency, setExportDefaultConcurrency] = useState(2)
 
@@ -108,6 +111,9 @@ function SettingsPage() {
   const [filterModeDropdownOpen, setFilterModeDropdownOpen] = useState(false)
   const [positionDropdownOpen, setPositionDropdownOpen] = useState(false)
 
+  const [wordCloudExcludeWords, setWordCloudExcludeWords] = useState<string[]>([])
+  const [excludeWordsInput, setExcludeWordsInput] = useState('')
+
 
 
 
@@ -137,6 +143,13 @@ function SettingsPage() {
   const [confirmPassword, setConfirmPassword] = useState('')
   const [isSettingHello, setIsSettingHello] = useState(false)
 
+  // HTTP API 设置 state
+  const [httpApiEnabled, setHttpApiEnabled] = useState(false)
+  const [httpApiPort, setHttpApiPort] = useState(5031)
+  const [httpApiRunning, setHttpApiRunning] = useState(false)
+  const [isTogglingApi, setIsTogglingApi] = useState(false)
+  const [showApiWarning, setShowApiWarning] = useState(false)
+
   const isClearingCache = isClearingAnalyticsCache || isClearingImageCache || isClearingAllCache
 
   // 检查 Hello 可用性
@@ -146,6 +159,22 @@ function SettingsPage() {
     }
   }, [])
 
+  // 检查 HTTP API 服务状态
+  useEffect(() => {
+    const checkApiStatus = async () => {
+      try {
+        const status = await window.electronAPI.http.status()
+        setHttpApiRunning(status.running)
+        if (status.port) {
+          setHttpApiPort(status.port)
+        }
+      } catch (e) {
+        console.error('检查 API 状态失败:', e)
+      }
+    }
+    checkApiStatus()
+  }, [])
+
   async function sha256(message: string) {
     const msgBuffer = new TextEncoder().encode(message)
     const hashBuffer = await crypto.subtle.digest('SHA-256', msgBuffer)
@@ -269,7 +298,7 @@ function SettingsPage() {
       setExportDefaultFormat(savedExportDefaultFormat || 'excel')
       setExportDefaultDateRange(savedExportDefaultDateRange || 'today')
       setExportDefaultMedia(savedExportDefaultMedia ?? false)
-      setExportDefaultVoiceAsText(savedExportDefaultVoiceAsText ?? true)
+      setExportDefaultVoiceAsText(savedExportDefaultVoiceAsText ?? false)
       setExportDefaultExcelCompactColumns(savedExportDefaultExcelCompactColumns ?? true)
       setExportDefaultConcurrency(savedExportDefaultConcurrency ?? 2)
 
@@ -278,6 +307,10 @@ function SettingsPage() {
       setNotificationFilterMode(savedNotificationFilterMode)
       setNotificationFilterList(savedNotificationFilterList)
 
+      const savedExcludeWords = await configService.getWordCloudExcludeWords()
+      setWordCloudExcludeWords(savedExcludeWords)
+      setExcludeWordsInput(savedExcludeWords.join('\n'))
+
       // 如果语言列表为空，保存默认值
       if (!savedTranscribeLanguages || savedTranscribeLanguages.length === 0) {
         const defaultLanguages = ['zh']
@@ -1541,6 +1574,7 @@ function SettingsPage() {
     { value: 'json', label: 'JSON', desc: '详细格式，包含完整消息信息' },
     { value: 'html', label: 'HTML', desc: '网页格式，可直接浏览' },
     { value: 'txt', label: 'TXT', desc: '纯文本，通用格式' },
+    { value: 'weclone', label: 'WeClone CSV', desc: 'WeClone 兼容字段格式（CSV）' },
     { value: 'sql', label: 'PostgreSQL', desc: '数据库脚本，便于导入到数据库' }
   ]
   const exportDateRangeOptions = [
@@ -1835,6 +1869,147 @@ function SettingsPage() {
     </div>
   )
 
+  // HTTP API 服务控制
+  const handleToggleApi = async () => {
+    if (isTogglingApi) return
+
+    // 启动时显示警告弹窗
+    if (!httpApiRunning) {
+      setShowApiWarning(true)
+      return
+    }
+
+    setIsTogglingApi(true)
+    try {
+      await window.electronAPI.http.stop()
+      setHttpApiRunning(false)
+      showMessage('API 服务已停止', true)
+    } catch (e: any) {
+      showMessage(`操作失败: ${e}`, false)
+    } finally {
+      setIsTogglingApi(false)
+    }
+  }
+
+  // 确认启动 API 服务
+  const confirmStartApi = async () => {
+    setShowApiWarning(false)
+    setIsTogglingApi(true)
+    try {
+      const result = await window.electronAPI.http.start(httpApiPort)
+      if (result.success) {
+        setHttpApiRunning(true)
+        if (result.port) setHttpApiPort(result.port)
+        showMessage(`API 服务已启动，端口 ${result.port}`, true)
+      } else {
+        showMessage(`启动失败: ${result.error}`, false)
+      }
+    } catch (e: any) {
+      showMessage(`操作失败: ${e}`, false)
+    } finally {
+      setIsTogglingApi(false)
+    }
+  }
+
+  const handleCopyApiUrl = () => {
+    const url = `http://127.0.0.1:${httpApiPort}`
+    navigator.clipboard.writeText(url)
+    showMessage('已复制 API 地址', true)
+  }
+
+  const renderApiTab = () => (
+    <div className="tab-content">
+      <div className="form-group">
+        <label>HTTP API 服务</label>
+        <span className="form-hint">启用后可通过 HTTP 接口查询消息数据（仅限本机访问）</span>
+        <div className="log-toggle-line">
+          <span className="log-status">
+            {httpApiRunning ? '运行中' : '已停止'}
+          </span>
+          <label className="switch">
+            <input
+              type="checkbox"
+              checked={httpApiRunning}
+              onChange={handleToggleApi}
+              disabled={isTogglingApi}
+            />
+            <span className="switch-slider" />
+          </label>
+        </div>
+      </div>
+
+      <div className="form-group">
+        <label>服务端口</label>
+        <span className="form-hint">API 服务监听的端口号（1024-65535）</span>
+        <input
+          type="number"
+          className="field-input"
+          value={httpApiPort}
+          onChange={(e) => setHttpApiPort(parseInt(e.target.value, 10) || 5031)}
+          disabled={httpApiRunning}
+          style={{ width: 120 }}
+          min={1024}
+          max={65535}
+        />
+      </div>
+
+      {httpApiRunning && (
+        <div className="form-group">
+          <label>API 地址</label>
+          <span className="form-hint">使用以下地址访问 API</span>
+          <div className="api-url-display">
+            <input
+              type="text"
+              className="field-input"
+              value={`http://127.0.0.1:${httpApiPort}`}
+              readOnly
+            />
+            <button className="btn btn-secondary" onClick={handleCopyApiUrl} title="复制">
+              <Copy size={16} />
+            </button>
+          </div>
+        </div>
+      )}
+
+      {/* API 安全警告弹窗 */}
+      {showApiWarning && (
+        <div className="modal-overlay" onClick={() => setShowApiWarning(false)}>
+          <div className="api-warning-modal" onClick={(e) => e.stopPropagation()}>
+            <div className="modal-header">
+              <ShieldCheck size={20} />
+              <h3>安全提示</h3>
+            </div>
+            <div className="modal-body">
+              <p className="warning-text">启用 HTTP API 服务后，本机上的其他程序可通过接口访问您的聊天记录数据。</p>
+              <div className="warning-list">
+                <div className="warning-item">
+                  <span className="bullet">•</span>
+                  <span>请确保您了解此功能的用途</span>
+                </div>
+                <div className="warning-item">
+                  <span className="bullet">•</span>
+                  <span>不要在公共或不信任的网络环境下使用</span>
+                </div>
+                <div className="warning-item">
+                  <span className="bullet">•</span>
+                  <span>此功能仅供高级用户或开发者使用</span>
+                </div>
+              </div>
+            </div>
+            <div className="modal-footer">
+              <button className="btn btn-secondary" onClick={() => setShowApiWarning(false)}>
+                取消
+              </button>
+              <button className="btn btn-primary" onClick={confirmStartApi}>
+                确认启动
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
+    </div>
+  )
+
   const handleSetupHello = async () => {
     setIsSettingHello(true)
     try {
@@ -1887,6 +2062,56 @@ function SettingsPage() {
     }
   }
 
+  const renderAnalyticsTab = () => (
+    <div className="tab-content">
+      <div className="settings-section">
+        <h2>分析设置</h2>
+        <div className="setting-item">
+          <div className="setting-label">
+            <span>词云排除词</span>
+            <span className="setting-desc">输入不需要在词云和常用语中显示的词语，用换行分隔</span>
+          </div>
+          <div className="setting-control" style={{ flexDirection: 'column', alignItems: 'flex-start', gap: '8px' }}>
+            <textarea
+              className="form-input"
+              style={{ width: '100%', height: '200px', fontFamily: 'monospace' }}
+              value={excludeWordsInput}
+              onChange={(e) => setExcludeWordsInput(e.target.value)}
+              placeholder="例如：
+第一个词
+第二个词
+第三个词"
+            />
+            <div className="button-group">
+              <button
+                className="btn btn-primary"
+                onClick={async () => {
+                  const words = excludeWordsInput.split('\n').map(w => w.trim()).filter(w => w.length > 0)
+                  // 去重
+                  const uniqueWords = Array.from(new Set(words))
+                  await configService.setWordCloudExcludeWords(uniqueWords)
+                  setWordCloudExcludeWords(uniqueWords)
+                  setExcludeWordsInput(uniqueWords.join('\n'))
+                  // Show success toast or feedback if needed (optional)
+                }}
+              >
+                保存排除列表
+              </button>
+              <button
+                className="btn btn-secondary"
+                onClick={() => {
+                  setExcludeWordsInput(wordCloudExcludeWords.join('\n'))
+                }}
+              >
+                重置
+              </button>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+
   const renderSecurityTab = () => (
     <div className="tab-content">
       <div className="form-group">
@@ -2075,6 +2300,8 @@ function SettingsPage() {
         {activeTab === 'models' && renderModelsTab()}
         {activeTab === 'export' && renderExportTab()}
         {activeTab === 'cache' && renderCacheTab()}
+        {activeTab === 'api' && renderApiTab()}
+        {activeTab === 'analytics' && renderAnalyticsTab()}
         {activeTab === 'security' && renderSecurityTab()}
         {activeTab === 'about' && renderAboutTab()}
       </div>

src/services/config.ts

@@ -44,7 +44,10 @@ export const CONFIG_KEYS = {
   NOTIFICATION_ENABLED: 'notificationEnabled',
   NOTIFICATION_POSITION: 'notificationPosition',
   NOTIFICATION_FILTER_MODE: 'notificationFilterMode',
-  NOTIFICATION_FILTER_LIST: 'notificationFilterList'
+  NOTIFICATION_FILTER_LIST: 'notificationFilterList',
+
+  // 词云
+  WORD_CLOUD_EXCLUDE_WORDS: 'wordCloudExcludeWords'
 } as const
 
 export interface WxidConfig {
@@ -465,3 +468,14 @@ export async function getNotificationFilterList(): Promise<string[]> {
 export async function setNotificationFilterList(list: string[]): Promise<void> {
   await config.set(CONFIG_KEYS.NOTIFICATION_FILTER_LIST, list)
 }
+
+// 获取词云排除词列表
+export async function getWordCloudExcludeWords(): Promise<string[]> {
+  const value = await config.get(CONFIG_KEYS.WORD_CLOUD_EXCLUDE_WORDS)
+  return Array.isArray(value) ? value : []
+}
+
+// 设置词云排除词列表
+export async function setWordCloudExcludeWords(words: string[]): Promise<void> {
+  await config.set(CONFIG_KEYS.WORD_CLOUD_EXCLUDE_WORDS, words)
+}

src/stores/batchTranscribeStore.ts

@@ -0,0 +1,70 @@
+import { create } from 'zustand'
+
+export interface BatchTranscribeState {
+  /** 是否正在批量转写 */
+  isBatchTranscribing: boolean
+  /** 转写进度 */
+  progress: { current: number; total: number }
+  /** 是否显示进度浮窗 */
+  showToast: boolean
+  /** 是否显示结果弹窗 */
+  showResult: boolean
+  /** 转写结果 */
+  result: { success: number; fail: number }
+  /** 当前转写的会话名 */
+  startTime: number
+  sessionName: string
+
+  // Actions
+  startTranscribe: (total: number, sessionName: string) => void
+  updateProgress: (current: number, total: number) => void
+  finishTranscribe: (success: number, fail: number) => void
+  setShowToast: (show: boolean) => void
+  setShowResult: (show: boolean) => void
+  reset: () => void
+}
+
+export const useBatchTranscribeStore = create<BatchTranscribeState>((set) => ({
+  isBatchTranscribing: false,
+  progress: { current: 0, total: 0 },
+  showToast: false,
+  showResult: false,
+  result: { success: 0, fail: 0 },
+  sessionName: '',
+  startTime: 0,
+
+  startTranscribe: (total, sessionName) => set({
+    isBatchTranscribing: true,
+    showToast: true,
+    progress: { current: 0, total },
+    showResult: false,
+    result: { success: 0, fail: 0 },
+    sessionName,
+    startTime: Date.now()
+  }),
+
+  updateProgress: (current, total) => set({
+    progress: { current, total }
+  }),
+
+  finishTranscribe: (success, fail) => set({
+    isBatchTranscribing: false,
+    showToast: false,
+    showResult: true,
+    result: { success, fail },
+    startTime: 0
+  }),
+
+  setShowToast: (show) => set({ showToast: show }),
+  setShowResult: (show) => set({ showResult: show }),
+
+  reset: () => set({
+    isBatchTranscribing: false,
+    progress: { current: 0, total: 0 },
+    showToast: false,
+    showResult: false,
+    result: { success: 0, fail: 0 },
+    sessionName: '',
+    startTime: 0
+  })
+}))

src/styles/batchTranscribe.scss

@@ -0,0 +1,296 @@
+// 批量转写 - 共享基础样式（overlay / modal-content / animations）
+// 被 ChatPage.scss 和 BatchTranscribeGlobal.tsx 同时使用
+
+.batch-modal-overlay {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.5);
+  backdrop-filter: blur(4px);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 10000;
+  animation: batchFadeIn 0.2s ease-out;
+}
+
+.batch-modal-content {
+  background: var(--bg-primary);
+  border-radius: 12px;
+  box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
+  max-height: 90vh;
+  overflow-y: auto;
+  animation: batchSlideUp 0.3s cubic-bezier(0.16, 1, 0.3, 1);
+}
+
+@keyframes batchFadeIn {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+@keyframes batchSlideUp {
+  from {
+    opacity: 0;
+    transform: translateY(20px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+// 批量转写进度浮窗（非阻塞 toast）
+.batch-progress-toast {
+  position: fixed;
+  bottom: 24px;
+  right: 24px;
+  width: 320px;
+  background: var(--bg-primary);
+  border-radius: 12px;
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.18);
+  border: 1px solid var(--border-color);
+  z-index: 10000;
+  animation: batchToastSlideIn 0.3s cubic-bezier(0.16, 1, 0.3, 1);
+  overflow: hidden;
+
+  .batch-progress-toast-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 10px 14px;
+    border-bottom: 1px solid var(--border-color);
+
+    .batch-progress-toast-title {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      font-size: 13px;
+      font-weight: 600;
+      color: var(--text-primary);
+
+      svg {
+        color: var(--primary);
+      }
+    }
+  }
+
+  .batch-progress-toast-close {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 24px;
+    height: 24px;
+    border: none;
+    background: transparent;
+    border-radius: 6px;
+    color: var(--text-secondary);
+    cursor: pointer;
+    transition: background 0.15s, color 0.15s;
+
+    &:hover {
+      background: var(--bg-tertiary);
+      color: var(--text-primary);
+    }
+  }
+
+  .batch-progress-toast-body {
+    padding: 12px 14px;
+
+    .progress-info-row {
+      display: flex;
+      flex-direction: column;
+      gap: 4px;
+      margin-bottom: 8px;
+
+      .progress-text {
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        font-size: 12px;
+        color: var(--text-secondary);
+
+        .progress-percent {
+          font-weight: 600;
+          color: var(--primary);
+          font-size: 13px;
+        }
+      }
+
+      .progress-eta {
+        display: flex;
+        align-items: center;
+        gap: 4px;
+        font-size: 11px; // 稍微小一点
+        color: var(--text-tertiary, #999); // 使用更淡的颜色
+
+        svg {
+          width: 12px;
+          height: 12px;
+          opacity: 0.8;
+        }
+      }
+    }
+
+    .progress-bar {
+      height: 6px;
+      background: var(--bg-tertiary);
+      border-radius: 3px;
+      overflow: hidden;
+
+      .progress-fill {
+        height: 100%;
+        background: linear-gradient(90deg, var(--primary), var(--primary));
+        border-radius: 3px;
+        transition: width 0.3s ease;
+      }
+    }
+  }
+}
+
+@keyframes batchToastSlideIn {
+  from {
+    opacity: 0;
+    transform: translateY(16px) scale(0.96);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateY(0) scale(1);
+  }
+}
+
+// 批量转写结果对话框
+.batch-result-modal {
+  width: 420px;
+  max-width: 90vw;
+
+  .batch-modal-header {
+    display: flex;
+    align-items: center;
+    gap: 0.75rem;
+    padding: 1.5rem;
+    border-bottom: 1px solid var(--border-color);
+
+    svg {
+      color: #4caf50;
+    }
+
+    h3 {
+      margin: 0;
+      font-size: 18px;
+      font-weight: 600;
+      color: var(--text-primary);
+    }
+  }
+
+  .batch-modal-body {
+    padding: 1.5rem;
+
+    .result-summary {
+      display: flex;
+      flex-direction: column;
+      gap: 0.75rem;
+      margin-bottom: 1rem;
+
+      .result-item {
+        display: flex;
+        align-items: center;
+        gap: 0.75rem;
+        padding: 1rem;
+        border-radius: 8px;
+        background: var(--bg-tertiary);
+
+        svg {
+          flex-shrink: 0;
+        }
+
+        .label {
+          font-size: 14px;
+          color: var(--text-secondary);
+        }
+
+        .value {
+          margin-left: auto;
+          font-size: 18px;
+          font-weight: 600;
+        }
+
+        &.success {
+          svg {
+            color: #4caf50;
+          }
+
+          .value {
+            color: #4caf50;
+          }
+        }
+
+        &.fail {
+          svg {
+            color: #f44336;
+          }
+
+          .value {
+            color: #f44336;
+          }
+        }
+      }
+    }
+
+    .result-tip {
+      display: flex;
+      align-items: flex-start;
+      gap: 0.5rem;
+      padding: 0.75rem;
+      background: rgba(255, 152, 0, 0.1);
+      border-radius: 8px;
+      border: 1px solid rgba(255, 152, 0, 0.3);
+
+      svg {
+        flex-shrink: 0;
+        margin-top: 2px;
+        color: #ff9800;
+      }
+
+      span {
+        font-size: 13px;
+        color: var(--text-secondary);
+        line-height: 1.5;
+      }
+    }
+  }
+
+  .batch-modal-footer {
+    display: flex;
+    justify-content: flex-end;
+    padding: 1rem 1.5rem;
+    border-top: 1px solid var(--border-color);
+
+    button {
+      padding: 0.5rem 1.5rem;
+      border-radius: 8px;
+      font-size: 14px;
+      font-weight: 500;
+      cursor: pointer;
+      transition: all 0.2s;
+      border: none;
+
+      &.btn-primary {
+        background: var(--primary);
+        color: white;
+
+        &:hover {
+          opacity: 0.9;
+        }
+      }
+    }
+  }
+}

src/styles/main.scss

@@ -45,6 +45,7 @@
 [data-theme="cloud-dancer"][data-mode="light"],
 [data-theme="cloud-dancer"]:not([data-mode]) {
   --primary: #8B7355;
+  --primary-rgb: 139, 115, 85;
   --primary-hover: #7A6548;
   --primary-light: rgba(139, 115, 85, 0.1);
   --bg-primary: #F0EEE9;
@@ -64,6 +65,7 @@
 [data-theme="corundum-blue"][data-mode="light"],
 [data-theme="corundum-blue"]:not([data-mode]) {
   --primary: #4A6670;
+  --primary-rgb: 74, 102, 112;
   --primary-hover: #3D565E;
   --primary-light: rgba(74, 102, 112, 0.1);
   --bg-primary: #E8EEF0;
@@ -83,6 +85,7 @@
 [data-theme="kiwi-green"][data-mode="light"],
 [data-theme="kiwi-green"]:not([data-mode]) {
   --primary: #7A9A5C;
+  --primary-rgb: 122, 154, 92;
   --primary-hover: #6A8A4C;
   --primary-light: rgba(122, 154, 92, 0.1);
   --bg-primary: #E8F0E4;
@@ -102,6 +105,7 @@
 [data-theme="spicy-red"][data-mode="light"],
 [data-theme="spicy-red"]:not([data-mode]) {
   --primary: #8B4049;
+  --primary-rgb: 139, 64, 73;
   --primary-hover: #7A3540;
   --primary-light: rgba(139, 64, 73, 0.1);
   --bg-primary: #F0E8E8;
@@ -121,6 +125,7 @@
 [data-theme="teal-water"][data-mode="light"],
 [data-theme="teal-water"]:not([data-mode]) {
   --primary: #5A8A8A;
+  --primary-rgb: 90, 138, 138;
   --primary-hover: #4A7A7A;
   --primary-light: rgba(90, 138, 138, 0.1);
   --bg-primary: #E4F0F0;
@@ -141,6 +146,7 @@
 // 云上舞白 - 深色
 [data-theme="cloud-dancer"][data-mode="dark"] {
   --primary: #C9A86C;
+  --primary-rgb: 201, 168, 108;
   --primary-hover: #D9B87C;
   --primary-light: rgba(201, 168, 108, 0.15);
   --bg-primary: #1a1816;
@@ -159,6 +165,7 @@
 // 刚玉蓝 - 深色
 [data-theme="corundum-blue"][data-mode="dark"] {
   --primary: #6A9AAA;
+  --primary-rgb: 106, 154, 170;
   --primary-hover: #7AAABA;
   --primary-light: rgba(106, 154, 170, 0.15);
   --bg-primary: #141a1c;
@@ -177,6 +184,7 @@
 // 冰猕猴桃汁绿 - 深色
 [data-theme="kiwi-green"][data-mode="dark"] {
   --primary: #9ABA7C;
+  --primary-rgb: 154, 186, 124;
   --primary-hover: #AACA8C;
   --primary-light: rgba(154, 186, 124, 0.15);
   --bg-primary: #161a14;
@@ -195,6 +203,7 @@
 // 辛辣红 - 深色
 [data-theme="spicy-red"][data-mode="dark"] {
   --primary: #C06068;
+  --primary-rgb: 192, 96, 104;
   --primary-hover: #D07078;
   --primary-light: rgba(192, 96, 104, 0.15);
   --bg-primary: #1a1416;
@@ -213,6 +222,7 @@
 // 明水鸭色 - 深色
 [data-theme="teal-water"][data-mode="dark"] {
   --primary: #7ABAAA;
+  --primary-rgb: 122, 186, 170;
   --primary-hover: #8ACABA;
   --primary-light: rgba(122, 186, 170, 0.15);
   --bg-primary: #121a1a;

src/types/electron.d.ts

@@ -85,6 +85,7 @@ export interface ElectronAPI {
     }>
     getContact: (username: string) => Promise<Contact | null>
     getContactAvatar: (username: string) => Promise<{ avatarUrl?: string; displayName?: string } | null>
+    resolveTransferDisplayNames: (chatroomId: string, payerUsername: string, receiverUsername: string) => Promise<{ payerName: string; receiverName: string }>
     getContacts: () => Promise<{
       success: boolean
       contacts?: ContactInfo[]
@@ -111,6 +112,7 @@ export interface ElectronAPI {
     }>
     getImageData: (sessionId: string, msgId: string) => Promise<{ success: boolean; data?: string; error?: string }>
     getVoiceData: (sessionId: string, msgId: string, createTime?: number, serverId?: string | number) => Promise<{ success: boolean; data?: string; error?: string }>
+    getAllVoiceMessages: (sessionId: string) => Promise<{ success: boolean; messages?: Message[]; error?: string }>
     resolveVoiceCache: (sessionId: string, msgId: string) => Promise<{ success: boolean; hasCache: boolean; data?: string }>
     getVoiceTranscript: (sessionId: string, msgId: string, createTime?: number) => Promise<{ success: boolean; transcript?: string; error?: string }>
     onVoiceTranscriptPartial: (callback: (payload: { msgId: string; text: string }) => void) => () => void
@@ -161,12 +163,13 @@ export interface ElectronAPI {
       }
       error?: string
     }>
-    getContactRankings: (limit?: number) => Promise<{
+    getContactRankings: (limit?: number, beginTimestamp?: number, endTimestamp?: number) => Promise<{
       success: boolean
       data?: Array<{
         username: string
         displayName: string
         avatarUrl?: string
+        wechatId?: string
         messageCount: number
         sentCount: number
         receivedCount: number
@@ -355,8 +358,10 @@ export interface ElectronAPI {
       data?: {
         year: number
         selfName: string
+        selfAvatarUrl?: string
         friendUsername: string
         friendName: string
+        friendAvatarUrl?: string
         firstChat: {
           createTime: number
           createTimeStr: string
@@ -392,15 +397,30 @@ export interface ElectronAPI {
           myTopEmojiMd5?: string
           friendTopEmojiMd5?: string
           myTopEmojiUrl?: string
-          friendTopEmojiUrl?: string
+          topPhrases: Array<{ phrase: string; count: number }>
+          myExclusivePhrases: Array<{ phrase: string; count: number }>
+          friendExclusivePhrases: Array<{ phrase: string; count: number }>
+          heatmap?: number[][]
+          initiative?: { initiated: number; received: number }
+          response?: { avg: number; fastest: number; count: number }
+          monthly?: Record<string, number>
+          streak?: { days: number; startDate: string; endDate: string }
         }
-        topPhrases: Array<{ phrase: string; count: number }>
       }
       error?: string
     }>
     onProgress: (callback: (payload: { status: string; progress: number }) => void) => () => void
   }
   export: {
+    getExportStats: (sessionIds: string[], options: any) => Promise<{
+      totalMessages: number
+      voiceMessages: number
+      cachedVoiceCount: number
+      needTranscribeCount: number
+      mediaMessages: number
+      estimatedSeconds: number
+      sessions: Array<{ sessionId: string; displayName: string; totalCount: number; voiceCount: number }>
+    }>
     exportSessions: (sessionIds: string[], outputDir: string, options: ExportOptions) => Promise<{
       success: boolean
       successCount?: number
@@ -492,7 +512,10 @@ export interface ExportProgress {
   current: number
   total: number
   currentSession: string
-  phase: 'preparing' | 'exporting' | 'writing' | 'complete'
+  phase: 'preparing' | 'exporting' | 'exporting-media' | 'exporting-voice' | 'writing' | 'complete'
+  phaseProgress?: number
+  phaseTotal?: number
+  phaseLabel?: string
 }
 
 export interface WxidInfo {

src/types/models.ts

@@ -64,6 +64,9 @@ export interface Message {
   fileSize?: number         // 文件大小
   fileExt?: string          // 文件扩展名
   xmlType?: string          // XML 中的 type 字段
+  // 转账消息
+  transferPayerUsername?: string    // 转账付款方 wxid
+  transferReceiverUsername?: string // 转账收款方 wxid
   // 名片消息
   cardUsername?: string     // 名片的微信ID
   cardNickname?: string     // 名片的昵称