Merge pull request #258 from hicccc77/dev

Dev

.github/workflows/release.yml

@@ -54,8 +54,8 @@ jobs:
           ## 更新日志
           修复了一些已知问题
 
-          ## 加入我们的群
-          [点击加入 Telegram 群](https://t.me/+hn3QzNc4DbA0MzNl)
+          ## 查看更多日志/获取最新动态
+          [点击加入 Telegram 频道](https://t.me/weflow_cc)
           EOF
           
           gh release edit "$GITHUB_REF_NAME" --notes-file release_notes.md

.gitignore

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

README.md

@@ -20,8 +20,8 @@ WeFlow 是一个**完全本地**的微信**实时**聊天记录查看、分析
 <a href="https://github.com/hicccc77/WeFlow/issues">
 <img src="https://img.shields.io/github/issues/hicccc77/WeFlow?style=flat-square" alt="Issues">
 </a>
-<a href="https://t.me/+hn3QzNc4DbA0MzNl">
-<img src="https://img.shields.io/badge/Telegram%20交流群-点击加入-0088cc?style=flat-square&logo=telegram&logoColor=0088cc&labelColor=white" alt="Telegram">
+<a href="https://t.me/weflow_cc">
+<img src="https://img.shields.io/badge/Telegram%20频道-0088cc?style=flat-square&logo=telegram&logoColor=0088cc&labelColor=white" alt="Telegram">
 </a>
 </p>
 
@@ -32,21 +32,28 @@ WeFlow 是一个**完全本地**的微信**实时**聊天记录查看、分析
 > [!NOTE]
 > 仅支持微信 **4.0 及以上**版本，确保你的微信版本符合要求
 
-
-# 加入微信交流群
-
-> 🎉 扫码加入微信群，与其他 WeFlow 用户一起交流问题和使用心得。
-
-<p align="center">
-  <img src="mdassets/us.png" alt="WeFlow 微信交流群二维码" width="220" style="margin-right: 16px;"
-</p>
-
 ## 主要功能
 
 - 本地实时查看聊天记录
 - 统计分析与群聊画像
 - 年度报告与可视化概览
 - 导出聊天记录为 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

@@ -0,0 +1,45 @@
+import { parentPort, workerData } from 'worker_threads'
+import { wcdbService } from './services/wcdbService'
+import { dualReportService } from './services/dualReportService'
+
+interface WorkerConfig {
+  year: number
+  friendUsername: string
+  dbPath: string
+  decryptKey: string
+  myWxid: string
+  resourcesPath?: string
+  userDataPath?: string
+  logEnabled?: boolean
+}
+
+const config = workerData as WorkerConfig
+process.env.WEFLOW_WORKER = '1'
+if (config.resourcesPath) {
+  process.env.WCDB_RESOURCES_PATH = config.resourcesPath
+}
+
+wcdbService.setPaths(config.resourcesPath || '', config.userDataPath || '')
+wcdbService.setLogEnabled(config.logEnabled === true)
+
+async function run() {
+  const result = await dualReportService.generateReportWithConfig({
+    year: config.year,
+    friendUsername: config.friendUsername,
+    dbPath: config.dbPath,
+    decryptKey: config.decryptKey,
+    wxid: config.myWxid,
+    onProgress: (status: string, progress: number) => {
+      parentPort?.postMessage({
+        type: 'dualReport:progress',
+        data: { status, progress }
+      })
+    }
+  })
+
+  parentPort?.postMessage({ type: 'dualReport:result', data: result })
+}
+
+run().catch((err) => {
+  parentPort?.postMessage({ type: 'dualReport:error', error: String(err) })
+})

electron/main.ts

@@ -21,6 +21,9 @@ import { videoService } from './services/videoService'
 import { snsService } from './services/snsService'
 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'
 
 
 // 配置自动更新
@@ -139,6 +142,14 @@ function createWindow(options: { autoShow?: boolean } = {}) {
     win.loadFile(join(__dirname, '../dist/index.html'))
   }
 
+  // Handle notification click navigation
+  ipcMain.on('notification-clicked', (_, sessionId) => {
+    if (win.isMinimized()) win.restore()
+    win.show()
+    win.focus()
+    win.webContents.send('navigate-to-session', sessionId)
+  })
+
   // 拦截请求，修改 Referer 和 User-Agent 以通过微信 CDN 鉴权
   session.defaultSession.webRequest.onBeforeSendHeaders(
     {
@@ -366,6 +377,64 @@ function createVideoPlayerWindow(videoPath: string, videoWidth?: number, videoHe
       hash: `/video-player-window?${videoParam}`
     })
   }
+}
+
+/**
+ * 创建独立的图片查看窗口
+ */
+function createImageViewerWindow(imagePath: string) {
+  const isDev = !!process.env.VITE_DEV_SERVER_URL
+  const iconPath = isDev
+    ? join(__dirname, '../public/icon.ico')
+    : join(process.resourcesPath, 'icon.ico')
+
+  const win = new BrowserWindow({
+    width: 900,
+    height: 700,
+    minWidth: 400,
+    minHeight: 300,
+    icon: iconPath,
+    webPreferences: {
+      preload: join(__dirname, 'preload.js'),
+      contextIsolation: true,
+      nodeIntegration: false,
+      webSecurity: false // 允许加载本地文件
+    },
+    titleBarStyle: 'hidden',
+    titleBarOverlay: {
+      color: '#00000000',
+      symbolColor: '#ffffff',
+      height: 40
+    },
+    show: false,
+    backgroundColor: '#000000',
+    autoHideMenuBar: true
+  })
+
+  win.once('ready-to-show', () => {
+    win.show()
+  })
+
+  const imageParam = `imagePath=${encodeURIComponent(imagePath)}`
+
+  if (process.env.VITE_DEV_SERVER_URL) {
+    win.loadURL(`${process.env.VITE_DEV_SERVER_URL}#/image-viewer-window?${imageParam}`)
+
+    win.webContents.on('before-input-event', (event, input) => {
+      if (input.key === 'F12' || (input.control && input.shift && input.key === 'I')) {
+        if (win.webContents.isDevToolsOpened()) {
+          win.webContents.closeDevTools()
+        } else {
+          win.webContents.openDevTools()
+        }
+        event.preventDefault()
+      }
+    })
+  } else {
+    win.loadFile(join(__dirname, '../dist/index.html'), {
+      hash: `/image-viewer-window?${imageParam}`
+    })
+  }
 
   return win
 }
@@ -439,6 +508,7 @@ function showMainWindow() {
 
 // 注册 IPC 处理器
 function registerIpcHandlers() {
+  registerNotificationHandlers()
   // 配置相关
   ipcMain.handle('config:get', async (_, key: string) => {
     return configService?.get(key as any)
@@ -552,6 +622,11 @@ function registerIpcHandlers() {
     }
   })
 
+  ipcMain.handle('app:ignoreUpdate', async (_, version: string) => {
+    configService?.set('ignoredUpdateVersion', version)
+    return { success: true }
+  })
+
   // 窗口控制
   ipcMain.on('window:minimize', (event) => {
     BrowserWindow.fromWebContents(event.sender)?.minimize()
@@ -674,6 +749,10 @@ function registerIpcHandlers() {
     return dbPathService.scanWxids(rootPath)
   })
 
+  ipcMain.handle('dbpath:scanWxidCandidates', async (_, rootPath: string) => {
+    return dbPathService.scanWxidCandidates(rootPath)
+  })
+
   ipcMain.handle('dbpath:getDefault', async () => {
     return dbPathService.getDefaultPath()
   })
@@ -715,14 +794,80 @@ function registerIpcHandlers() {
     return chatService.getLatestMessages(sessionId, limit)
   })
 
+  ipcMain.handle('chat:getNewMessages', async (_, sessionId: string, minTime: number, limit?: number) => {
+    return chatService.getNewMessages(sessionId, minTime, limit)
+  })
+
   ipcMain.handle('chat:getContact', async (_, username: string) => {
     return await chatService.getContact(username)
   })
 
+  // Llama AI
+  ipcMain.handle('llama:init', async () => {
+    return await llamaService.init()
+  })
+
+  ipcMain.handle('llama:loadModel', async (_, modelPath: string) => {
+    return llamaService.loadModel(modelPath)
+  })
+
+  ipcMain.handle('llama:createSession', async (_, systemPrompt?: string) => {
+    return llamaService.createSession(systemPrompt)
+  })
+
+  ipcMain.handle('llama:chat', async (event, message: string, options?: { thinking?: boolean }) => {
+    // We use a callback to stream back to the renderer
+    const webContents = event.sender
+    try {
+      if (!webContents) return { success: false, error: 'No sender' }
+
+      const response = await llamaService.chat(message, options, (token) => {
+        if (!webContents.isDestroyed()) {
+          webContents.send('llama:token', token)
+        }
+      })
+      return { success: true, response }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  })
+
+  ipcMain.handle('llama:downloadModel', async (event, url: string, savePath: string) => {
+    const webContents = event.sender
+    try {
+      await llamaService.downloadModel(url, savePath, (payload) => {
+        if (!webContents.isDestroyed()) {
+          webContents.send('llama:downloadProgress', payload)
+        }
+      })
+      return { success: true }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  })
+
+  ipcMain.handle('llama:getModelsPath', async () => {
+    return llamaService.getModelsPath()
+  })
+
+  ipcMain.handle('llama:checkFileExists', async (_, filePath: string) => {
+    const { existsSync } = await import('fs')
+    return existsSync(filePath)
+  })
+
+  ipcMain.handle('llama:getModelStatus', async (_, modelPath: string) => {
+    return llamaService.getModelStatus(modelPath)
+  })
+
+
   ipcMain.handle('chat:getContactAvatar', async (_, username: string) => {
     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()
   })
@@ -755,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)
   })
@@ -811,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()) {
@@ -833,14 +988,26 @@ 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 () => {
     return analyticsService.getTimeDistribution()
   })
 
+  ipcMain.handle('analytics:getExcludedUsernames', async () => {
+    return analyticsService.getExcludedUsernames()
+  })
+
+  ipcMain.handle('analytics:setExcludedUsernames', async (_, usernames: string[]) => {
+    return analyticsService.setExcludedUsernames(usernames)
+  })
+
+  ipcMain.handle('analytics:getExcludeCandidates', async () => {
+    return analyticsService.getExcludeCandidates()
+  })
+
   // 缓存管理
   ipcMain.handle('cache:clearAnalytics', async () => {
     return analyticsService.clearCache()
@@ -916,6 +1083,11 @@ function registerIpcHandlers() {
     return true
   })
 
+  // 打开图片查看窗口
+  ipcMain.handle('window:openImageViewerWindow', (_, imagePath: string) => {
+    createImageViewerWindow(imagePath)
+  })
+
   // 完成引导，关闭引导窗口并显示主窗口
   ipcMain.handle('window:completeOnboarding', async () => {
     try {
@@ -1013,6 +1185,73 @@ function registerIpcHandlers() {
     })
   })
 
+  ipcMain.handle('dualReport:generateReport', async (_, payload: { friendUsername: string; year: number }) => {
+    const cfg = configService || new ConfigService()
+    configService = cfg
+
+    const dbPath = cfg.get('dbPath')
+    const decryptKey = cfg.get('decryptKey')
+    const wxid = cfg.get('myWxid')
+    const logEnabled = cfg.get('logEnabled')
+    const friendUsername = payload?.friendUsername
+    const year = payload?.year ?? 0
+
+    if (!friendUsername) {
+      return { success: false, error: '缺少好友用户名' }
+    }
+
+    const resourcesPath = app.isPackaged
+      ? join(process.resourcesPath, 'resources')
+      : join(app.getAppPath(), 'resources')
+    const userDataPath = app.getPath('userData')
+
+    const workerPath = join(__dirname, 'dualReportWorker.js')
+
+    return await new Promise((resolve) => {
+      const worker = new Worker(workerPath, {
+        workerData: { year, friendUsername, dbPath, decryptKey, myWxid: wxid, resourcesPath, userDataPath, logEnabled }
+      })
+
+      const cleanup = () => {
+        worker.removeAllListeners()
+      }
+
+      worker.on('message', (msg: any) => {
+        if (msg && msg.type === 'dualReport:progress') {
+          for (const win of BrowserWindow.getAllWindows()) {
+            if (!win.isDestroyed()) {
+              win.webContents.send('dualReport:progress', msg.data)
+            }
+          }
+          return
+        }
+        if (msg && (msg.type === 'dualReport:result' || msg.type === 'done')) {
+          cleanup()
+          void worker.terminate()
+          resolve(msg.data ?? msg.result)
+          return
+        }
+        if (msg && (msg.type === 'dualReport:error' || msg.type === 'error')) {
+          cleanup()
+          void worker.terminate()
+          resolve({ success: false, error: msg.error || '双人报告生成失败' })
+        }
+      })
+
+      worker.on('error', (err) => {
+        cleanup()
+        resolve({ success: false, error: String(err) })
+      })
+
+      worker.on('exit', (code) => {
+        if (code !== 0) {
+          cleanup()
+          resolve({ success: false, error: `双人报告线程异常退出: ${code}` })
+        }
+      })
+    })
+  })
+
   ipcMain.handle('annualReport:exportImages', async (_, payload: { baseDir: string; folderName: string; images: Array<{ name: string; dataUrl: string }> }) => {
     try {
       const { baseDir, folderName, images } = payload
@@ -1058,6 +1297,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()
+    }
+  })
+
 }
 
 // 主窗口引用
@@ -1076,7 +1332,16 @@ function checkForUpdatesOnStartup() {
       if (result && result.updateInfo) {
         const currentVersion = app.getVersion()
         const latestVersion = result.updateInfo.version
+
+        // 检查是否有新版本
         if (latestVersion !== currentVersion && mainWindow) {
+          // 检查该版本是否被用户忽略
+          const ignoredVersion = configService?.get('ignoredUpdateVersion')
+          if (ignoredVersion === latestVersion) {
+
+            return
+          }
+
           // 通知渲染进程有新版本
           mainWindow.webContents.send('app:updateAvailable', {
             version: latestVersion,

electron/preload-env.ts

@@ -29,7 +29,7 @@ function enforceLocalDllPriority() {
         process.env.PATH = dllPaths
     }
 
-    console.log('[WeFlow] Environment PATH updated to enforce local DLL priority:', dllPaths)
+    
 }
 
 try {

electron/preload.ts

@@ -9,6 +9,19 @@ contextBridge.exposeInMainWorld('electronAPI', {
     clear: () => ipcRenderer.invoke('config:clear')
   },
 
+  // 通知
+  notification: {
+    show: (data: any) => ipcRenderer.invoke('notification:show', data),
+    close: () => ipcRenderer.invoke('notification:close'),
+    click: (sessionId: string) => ipcRenderer.send('notification-clicked', sessionId),
+    ready: () => ipcRenderer.send('notification:ready'),
+    resize: (width: number, height: number) => ipcRenderer.send('notification:resize', { width, height }),
+    onShow: (callback: (event: any, data: any) => void) => {
+      ipcRenderer.on('notification:show', callback)
+      return () => ipcRenderer.removeAllListeners('notification:show')
+    }
+  },
+
   // 认证
   auth: {
     hello: (message?: string) => ipcRenderer.invoke('auth:hello', message)
@@ -34,6 +47,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
     getVersion: () => ipcRenderer.invoke('app:getVersion'),
     checkForUpdates: () => ipcRenderer.invoke('app:checkForUpdates'),
     downloadAndInstall: () => ipcRenderer.invoke('app:downloadAndInstall'),
+    ignoreUpdate: (version: string) => ipcRenderer.invoke('app:ignoreUpdate', version),
     onDownloadProgress: (callback: (progress: any) => void) => {
       ipcRenderer.on('app:downloadProgress', (_, progress) => callback(progress))
       return () => ipcRenderer.removeAllListeners('app:downloadProgress')
@@ -47,7 +61,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
   // 日志
   log: {
     getPath: () => ipcRenderer.invoke('log:getPath'),
-    read: () => ipcRenderer.invoke('log:read')
+    read: () => ipcRenderer.invoke('log:read'),
+    debug: (data: any) => ipcRenderer.send('log:debug', data)
   },
 
   // 窗口控制
@@ -63,6 +78,8 @@ contextBridge.exposeInMainWorld('electronAPI', {
       ipcRenderer.invoke('window:openVideoPlayerWindow', videoPath, videoWidth, videoHeight),
     resizeToFitVideo: (videoWidth: number, videoHeight: number) =>
       ipcRenderer.invoke('window:resizeToFitVideo', videoWidth, videoHeight),
+    openImageViewerWindow: (imagePath: string) =>
+      ipcRenderer.invoke('window:openImageViewerWindow', imagePath),
     openChatHistoryWindow: (sessionId: string, messageId: number) =>
       ipcRenderer.invoke('window:openChatHistoryWindow', sessionId, messageId)
   },
@@ -71,6 +88,7 @@ contextBridge.exposeInMainWorld('electronAPI', {
   dbPath: {
     autoDetect: () => ipcRenderer.invoke('dbpath:autoDetect'),
     scanWxids: (rootPath: string) => ipcRenderer.invoke('dbpath:scanWxids', rootPath),
+    scanWxidCandidates: (rootPath: string) => ipcRenderer.invoke('dbpath:scanWxidCandidates', rootPath),
     getDefault: () => ipcRenderer.invoke('dbpath:getDefault')
   },
 
@@ -109,8 +127,12 @@ contextBridge.exposeInMainWorld('electronAPI', {
       ipcRenderer.invoke('chat:getMessages', sessionId, offset, limit, startTime, endTime, ascending),
     getLatestMessages: (sessionId: string, limit?: number) =>
       ipcRenderer.invoke('chat:getLatestMessages', sessionId, limit),
+    getNewMessages: (sessionId: string, minTime: number, limit?: number) =>
+      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),
@@ -119,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) => {
@@ -130,7 +154,11 @@ contextBridge.exposeInMainWorld('electronAPI', {
       ipcRenderer.invoke('chat:execQuery', kind, path, sql),
     getContacts: () => ipcRenderer.invoke('chat:getContacts'),
     getMessage: (sessionId: string, localId: number) =>
-      ipcRenderer.invoke('chat:getMessage', sessionId, localId)
+      ipcRenderer.invoke('chat:getMessage', sessionId, localId),
+    onWcdbChange: (callback: (event: any, data: { type: string; json: string }) => void) => {
+      ipcRenderer.on('wcdb-change', callback)
+      return () => ipcRenderer.removeListener('wcdb-change', callback)
+    }
   },
 
 
@@ -161,9 +189,13 @@ contextBridge.exposeInMainWorld('electronAPI', {
 
   // 数据分析
   analytics: {
-    getOverallStatistics: () => ipcRenderer.invoke('analytics:getOverallStatistics'),
-    getContactRankings: (limit?: number) => ipcRenderer.invoke('analytics:getContactRankings', limit),
+    getOverallStatistics: (force?: boolean) => ipcRenderer.invoke('analytics:getOverallStatistics', force),
+    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),
+    getExcludeCandidates: () => ipcRenderer.invoke('analytics:getExcludeCandidates'),
     onProgress: (callback: (payload: { status: string; progress: number }) => void) => {
       ipcRenderer.on('analytics:progress', (_, payload) => callback(payload))
       return () => ipcRenderer.removeAllListeners('analytics:progress')
@@ -198,9 +230,19 @@ contextBridge.exposeInMainWorld('electronAPI', {
       return () => ipcRenderer.removeAllListeners('annualReport:progress')
     }
   },
+  dualReport: {
+    generateReport: (payload: { friendUsername: string; year: number }) =>
+      ipcRenderer.invoke('dualReport:generateReport', payload),
+    onProgress: (callback: (payload: { status: string; progress: number }) => void) => {
+      ipcRenderer.on('dualReport:progress', (_, payload) => callback(payload))
+      return () => ipcRenderer.removeAllListeners('dualReport:progress')
+    }
+  },
 
   // 导出
   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) =>
@@ -230,5 +272,33 @@ contextBridge.exposeInMainWorld('electronAPI', {
       ipcRenderer.invoke('sns:getTimeline', limit, offset, usernames, keyword, startTime, endTime),
     debugResource: (url: string) => ipcRenderer.invoke('sns:debugResource', url),
     proxyImage: (url: string) => ipcRenderer.invoke('sns:proxyImage', url)
+  },
+
+  // Llama AI
+  llama: {
+    loadModel: (modelPath: string) => ipcRenderer.invoke('llama:loadModel', modelPath),
+    createSession: (systemPrompt?: string) => ipcRenderer.invoke('llama:createSession', systemPrompt),
+    chat: (message: string, options?: any) => ipcRenderer.invoke('llama:chat', message, options),
+    downloadModel: (url: string, savePath: string) => ipcRenderer.invoke('llama:downloadModel', url, savePath),
+    getModelsPath: () => ipcRenderer.invoke('llama:getModelsPath'),
+    checkFileExists: (filePath: string) => ipcRenderer.invoke('llama:checkFileExists', filePath),
+    getModelStatus: (modelPath: string) => ipcRenderer.invoke('llama:getModelStatus', modelPath),
+    onToken: (callback: (token: string) => void) => {
+      const listener = (_: any, token: string) => callback(token)
+      ipcRenderer.on('llama:token', listener)
+      return () => ipcRenderer.removeListener('llama:token', listener)
+    },
+    onDownloadProgress: (callback: (payload: { downloaded: number; total: number; speed: number }) => void) => {
+      const listener = (_: any, payload: { downloaded: number; total: number; speed: number }) => callback(payload)
+      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

@@ -3,6 +3,7 @@ import { wcdbService } from './wcdbService'
 import { join } from 'path'
 import { readFile, writeFile, rm } from 'fs/promises'
 import { app } from 'electron'
+import { createHash } from 'crypto'
 
 export interface ChatStatistics {
   totalMessages: number
@@ -30,6 +31,7 @@ export interface ContactRanking {
   username: string
   displayName: string
   avatarUrl?: string
+  wechatId?: string
   messageCount: number
   sentCount: number
   receivedCount: number
@@ -46,6 +48,58 @@ class AnalyticsService {
     this.configService = new ConfigService()
   }
 
+  private normalizeUsername(username: string): string {
+    return username.trim().toLowerCase()
+  }
+
+  private normalizeExcludedUsernames(value: unknown): string[] {
+    if (!Array.isArray(value)) return []
+    const normalized = value
+      .map((item) => typeof item === 'string' ? item.trim().toLowerCase() : '')
+      .filter((item) => item.length > 0)
+    return Array.from(new Set(normalized))
+  }
+
+  private getExcludedUsernamesList(): string[] {
+    return this.normalizeExcludedUsernames(this.configService.get('analyticsExcludedUsernames'))
+  }
+
+  private getExcludedUsernamesSet(): Set<string> {
+    return new Set(this.getExcludedUsernamesList())
+  }
+
+  private escapeSqlValue(value: string): string {
+    return value.replace(/'/g, "''")
+  }
+
+  private async getAliasMap(usernames: string[]): Promise<Record<string, string>> {
+    const map: Record<string, string> = {}
+    if (usernames.length === 0) return map
+
+    const chunkSize = 200
+    for (let i = 0; i < usernames.length; i += chunkSize) {
+      const chunk = usernames.slice(i, i + chunkSize)
+      const inList = chunk.map((u) => `'${this.escapeSqlValue(u)}'`).join(',')
+      if (!inList) continue
+      const sql = `
+        SELECT username, alias
+        FROM contact
+        WHERE username IN (${inList})
+      `
+      const result = await wcdbService.execQuery('contact', null, sql)
+      if (!result.success || !result.rows) continue
+      for (const row of result.rows as Record<string, any>[]) {
+        const username = row.username || ''
+        const alias = row.alias || ''
+        if (username && alias) {
+          map[username] = alias
+        }
+      }
+    }
+
+    return map
+  }
+
   private cleanAccountDirName(name: string): string {
     const trimmed = name.trim()
     if (!trimmed) return trimmed
@@ -54,7 +108,11 @@ class AnalyticsService {
       if (match) return match[1]
       return trimmed
     }
-    return trimmed
+
+    const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/)
+    const cleaned = suffixMatch ? suffixMatch[1] : trimmed
+    
+    return cleaned
   }
 
   private isPrivateSession(username: string, cleanedWxid: string): boolean {
@@ -97,13 +155,15 @@ class AnalyticsService {
   }
 
   private async getPrivateSessions(
-    cleanedWxid: string
+    cleanedWxid: string,
+    excludedUsernames?: Set<string>
   ): Promise<{ usernames: string[]; numericIds: string[] }> {
     const sessionResult = await wcdbService.getSessions()
     if (!sessionResult.success || !sessionResult.sessions) {
       return { usernames: [], numericIds: [] }
     }
     const rows = sessionResult.sessions as Record<string, any>[]
+    const excluded = excludedUsernames ?? this.getExcludedUsernamesSet()
 
     const sample = rows[0]
     void sample
@@ -124,7 +184,11 @@ class AnalyticsService {
       return { username, idValue }
     })
     const usernames = sessions.map((s) => s.username)
-    const privateSessions = sessions.filter((s) => this.isPrivateSession(s.username, cleanedWxid))
+    const privateSessions = sessions.filter((s) => {
+      if (!this.isPrivateSession(s.username, cleanedWxid)) return false
+      if (excluded.size === 0) return true
+      return !excluded.has(this.normalizeUsername(s.username))
+    })
     const privateUsernames = privateSessions.map((s) => s.username)
     const numericIds = privateSessions
       .map((s) => s.idValue)
@@ -177,11 +241,18 @@ class AnalyticsService {
   }
 
   private buildAggregateCacheKey(sessionIds: string[], beginTimestamp: number, endTimestamp: number): string {
-    const sample = sessionIds.slice(0, 5).join(',')
-    return `${beginTimestamp}-${endTimestamp}-${sessionIds.length}-${sample}`
+    if (sessionIds.length === 0) {
+      return `${beginTimestamp}-${endTimestamp}-0-empty`
+    }
+    const normalized = Array.from(new Set(sessionIds.map((id) => String(id)))).sort()
+    const hash = createHash('sha1').update(normalized.join('|')).digest('hex').slice(0, 12)
+    return `${beginTimestamp}-${endTimestamp}-${normalized.length}-${hash}`
   }
 
   private async computeAggregateByCursor(sessionIds: string[], beginTimestamp = 0, endTimestamp = 0): Promise<any> {
+    const wxid = this.configService.get('myWxid')
+    const cleanedWxid = wxid ? this.cleanAccountDirName(wxid) : ''
+
     const aggregate = {
       total: 0,
       sent: 0,
@@ -206,8 +277,22 @@ class AnalyticsService {
         if (endTimestamp > 0 && createTime > endTimestamp) return
 
         const localType = parseInt(row.local_type || row.type || '1', 10)
-        const isSendRaw = row.computed_is_send ?? row.is_send ?? row.isSend ?? 0
-        const isSend = String(isSendRaw) === '1' || isSendRaw === 1 || isSendRaw === true
+        const isSendRaw = row.computed_is_send ?? row.is_send ?? row.isSend
+        let isSend = String(isSendRaw) === '1' || isSendRaw === 1 || isSendRaw === true
+
+        // 如果底层没有提供 is_send，则根据发送者用户名推断
+        const senderUsername = row.sender_username || row.senderUsername || row.sender
+        if (isSendRaw === undefined || isSendRaw === null) {
+          if (senderUsername && (cleanedWxid)) {
+            const senderLower = String(senderUsername).toLowerCase()
+            const myWxidLower = cleanedWxid.toLowerCase()
+            isSend = (
+              senderLower === myWxidLower ||
+              // 兼容非 wxid 开头的账号（如果文件夹名带后缀，如 custom_backup，而 sender 是 custom）
+              (myWxidLower.startsWith(senderLower + '_'))
+            )
+          }
+        }
 
         aggregate.total += 1
         sessionStat.total += 1
@@ -369,6 +454,65 @@ class AnalyticsService {
     void results
   }
 
+  async getExcludedUsernames(): Promise<{ success: boolean; data?: string[]; error?: string }> {
+    try {
+      return { success: true, data: this.getExcludedUsernamesList() }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
+
+  async setExcludedUsernames(usernames: string[]): Promise<{ success: boolean; data?: string[]; error?: string }> {
+    try {
+      const normalized = this.normalizeExcludedUsernames(usernames)
+      this.configService.set('analyticsExcludedUsernames', normalized)
+      await this.clearCache()
+      return { success: true, data: normalized }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
+
+  async getExcludeCandidates(): Promise<{ success: boolean; data?: Array<{ username: string; displayName: string; avatarUrl?: string; wechatId?: string }>; error?: string }> {
+    try {
+      const conn = await this.ensureConnected()
+      if (!conn.success || !conn.cleanedWxid) return { success: false, error: conn.error }
+
+      const excluded = this.getExcludedUsernamesSet()
+      const sessionInfo = await this.getPrivateSessions(conn.cleanedWxid, new Set())
+
+      const usernames = new Set<string>(sessionInfo.usernames)
+      for (const name of excluded) usernames.add(name)
+
+      if (usernames.size === 0) {
+        return { success: true, data: [] }
+      }
+
+      const usernameList = Array.from(usernames)
+      const [displayNames, avatarUrls, aliasMap] = await Promise.all([
+        wcdbService.getDisplayNames(usernameList),
+        wcdbService.getAvatarUrls(usernameList),
+        this.getAliasMap(usernameList)
+      ])
+
+      const entries = usernameList.map((username) => {
+        const displayName = displayNames.success && displayNames.map
+          ? (displayNames.map[username] || username)
+          : username
+        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 }
+      })
+
+      return { success: true, data: entries }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
+
   async getOverallStatistics(force = false): Promise<{ success: boolean; data?: ChatStatistics; error?: string }> {
     try {
       const conn = await this.ensureConnected()
@@ -433,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 }
@@ -443,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 || '聚合统计失败' }
       }
@@ -451,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
@@ -465,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

@@ -69,6 +69,20 @@ export interface AnnualReportData {
     phrase: string
     count: number
   }[]
+  snsStats?: {
+    totalPosts: number
+    typeCounts?: Record<string, number>
+    topLikers: { username: string; displayName: string; avatarUrl?: string; count: number }[]
+    topLiked: { username: string; displayName: string; avatarUrl?: string; count: number }[]
+  }
+  lostFriend: {
+    username: string
+    displayName: string
+    avatarUrl?: string
+    earlyCount: number
+    lateCount: number
+    periodDesc: string
+  } | null
 }
 
 class AnnualReportService {
@@ -101,8 +115,9 @@ class AnnualReportService {
       return trimmed
     }
     const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/)
-    if (suffixMatch) return suffixMatch[1]
-    return trimmed
+    const cleaned = suffixMatch ? suffixMatch[1] : trimmed
+    
+    return cleaned
   }
 
   private async ensureConnectedWithConfig(
@@ -178,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)
@@ -397,8 +416,15 @@ class AnnualReportService {
 
       this.reportProgress('加载会话列表...', 15, onProgress)
 
-      const startTime = Math.floor(new Date(year, 0, 1).getTime() / 1000)
-      const endTime = Math.floor(new Date(year, 11, 31, 23, 59, 59).getTime() / 1000)
+      const isAllTime = year <= 0
+      const reportYear = isAllTime ? 0 : year
+      const startTime = isAllTime ? 0 : Math.floor(new Date(year, 0, 1).getTime() / 1000)
+      const endTime = isAllTime ? 0 : Math.floor(new Date(year, 11, 31, 23, 59, 59).getTime() / 1000)
+
+      const now = new Date()
+      // 全局统计始终使用自然年范围 (Jan 1st - Now/YearEnd)
+      const actualStartTime = startTime
+      const actualEndTime = endTime
 
       let totalMessages = 0
       const contactStats = new Map<string, { sent: number; received: number }>()
@@ -420,7 +446,7 @@ class AnnualReportService {
       const CONVERSATION_GAP = 3600
 
       this.reportProgress('统计会话消息...', 20, onProgress)
-      const result = await wcdbService.getAnnualReportStats(sessionIds, startTime, endTime)
+      const result = await wcdbService.getAnnualReportStats(sessionIds, actualStartTime, actualEndTime)
       if (!result.success || !result.data) {
         return { success: false, error: result.error ? `基础统计失败: ${result.error}` : '基础统计失败' }
       }
@@ -474,7 +500,7 @@ class AnnualReportService {
       }
 
       this.reportProgress('加载扩展统计... (初始化)', 30, onProgress)
-      const extras = await wcdbService.getAnnualReportExtras(sessionIds, startTime, endTime, peakDayBegin, peakDayEnd)
+      const extras = await wcdbService.getAnnualReportExtras(sessionIds, actualStartTime, actualEndTime, peakDayBegin, peakDayEnd)
       if (extras.success && extras.data) {
         this.reportProgress('加载扩展统计... (解析热力图)', 32, onProgress)
         const extrasData = extras.data as any
@@ -554,7 +580,7 @@ class AnnualReportService {
         // 为保持功能完整，我们进行深度集成的轻量遍历：
         for (let i = 0; i < sessionIds.length; i++) {
           const sessionId = sessionIds[i]
-          const cursor = await wcdbService.openMessageCursorLite(sessionId, 1000, true, startTime, endTime)
+          const cursor = await wcdbService.openMessageCursorLite(sessionId, 1000, true, actualStartTime, actualEndTime)
           if (!cursor.success || !cursor.cursor) continue
 
           let lastDayIndex: number | null = null
@@ -575,9 +601,22 @@ class AnnualReportService {
                 if (!createTime) continue
 
                 const isSendRaw = row.computed_is_send ?? row.is_send ?? '0'
-                const isSent = parseInt(isSendRaw, 10) === 1
+                let isSent = parseInt(isSendRaw, 10) === 1
                 const localType = parseInt(row.local_type || row.type || '1', 10)
 
+                // 兼容逻辑
+                if (isSendRaw === undefined || isSendRaw === null || isSendRaw === '0') {
+                  const sender = String(row.sender_username || row.sender || row.talker || '').toLowerCase()
+                  if (sender) {
+                    const rawLower = rawWxid.toLowerCase()
+                    const cleanedLower = cleanedWxid.toLowerCase()
+                    if (sender === rawLower || sender === cleanedLower ||
+                      rawLower.startsWith(sender + '_') || cleanedLower.startsWith(sender + '_')) {
+                      isSent = true
+                    }
+                  }
+                }
+
                 // 响应速度 & 对话发起
                 if (!conversationStarts.has(sessionId)) {
                   conversationStarts.set(sessionId, { initiated: 0, received: 0 })
@@ -689,7 +728,7 @@ class AnnualReportService {
 
       if (!streakComputedInLoop) {
         this.reportProgress('计算连续聊天...', 45, onProgress)
-        const streakResult = await this.computeLongestStreak(sessionIds, startTime, endTime, onProgress, 45, 75)
+        const streakResult = await this.computeLongestStreak(sessionIds, actualStartTime, actualEndTime, onProgress, 45, 75)
         if (streakResult.days > longestStreakDays) {
           longestStreakDays = streakResult.days
           longestStreakSessionId = streakResult.sessionId
@@ -698,6 +737,42 @@ class AnnualReportService {
         }
       }
 
+      // 获取朋友圈统计
+      this.reportProgress('分析朋友圈数据...', 75, onProgress)
+      let snsStatsResult: {
+        totalPosts: number
+        typeCounts?: Record<string, number>
+        topLikers: { username: string; displayName: string; avatarUrl?: string; count: number }[]
+        topLiked: { username: string; displayName: string; avatarUrl?: string; count: number }[]
+      } | undefined
+
+      const snsStats = await wcdbService.getSnsAnnualStats(actualStartTime, actualEndTime)
+
+      if (snsStats.success && snsStats.data) {
+        const d = snsStats.data
+        const usersToFetch = new Set<string>()
+        d.topLikers?.forEach((u: any) => usersToFetch.add(u.username))
+        d.topLiked?.forEach((u: any) => usersToFetch.add(u.username))
+
+        const snsUserIds = Array.from(usersToFetch)
+        const [snsDisplayNames, snsAvatarUrls] = await Promise.all([
+          wcdbService.getDisplayNames(snsUserIds),
+          wcdbService.getAvatarUrls(snsUserIds)
+        ])
+
+        const getSnsUserInfo = (username: string) => ({
+          displayName: snsDisplayNames.success && snsDisplayNames.map ? (snsDisplayNames.map[username] || username) : username,
+          avatarUrl: snsAvatarUrls.success && snsAvatarUrls.map ? snsAvatarUrls.map[username] : undefined
+        })
+
+        snsStatsResult = {
+          totalPosts: d.totalPosts || 0,
+          typeCounts: d.typeCounts,
+          topLikers: (d.topLikers || []).map((u: any) => ({ ...u, ...getSnsUserInfo(u.username) })),
+          topLiked: (d.topLiked || []).map((u: any) => ({ ...u, ...getSnsUserInfo(u.username) }))
+        }
+      }
+
       this.reportProgress('整理联系人信息...', 85, onProgress)
 
       const contactIds = Array.from(contactStats.keys())
@@ -901,8 +976,130 @@ class AnnualReportService {
           .slice(0, 32)
           .map(([phrase, count]) => ({ phrase, count }))
 
+      // 曾经的好朋友 (Once Best Friend / Lost Friend)
+      let lostFriend: AnnualReportData['lostFriend'] = null
+      let maxEarlyCount = 80  // 最低门槛
+      let bestEarlyCount = 0
+      let bestLateCount = 0
+      let bestSid = ''
+      let bestPeriodDesc = ''
+
+      const currentMonthIndex = new Date().getMonth() + 1 // 1-12
+
+      const currentYearNum = now.getFullYear()
+
+      if (isAllTime) {
+        const days = Object.keys(d.daily).sort()
+        if (days.length >= 2) {
+          const firstDay = Math.floor(new Date(days[0]).getTime() / 1000)
+          const lastDay = Math.floor(new Date(days[days.length - 1]).getTime() / 1000)
+          const midPoint = Math.floor((firstDay + lastDay) / 2)
+
+          this.reportProgress('分析历史趋势 (1/2)...', 86, onProgress)
+          const earlyRes = await wcdbService.getAggregateStats(sessionIds, 0, midPoint)
+          this.reportProgress('分析历史趋势 (2/2)...', 88, onProgress)
+          const lateRes = await wcdbService.getAggregateStats(sessionIds, midPoint, 0)
+
+          if (earlyRes.success && lateRes.success && earlyRes.data) {
+            const earlyData = earlyRes.data.sessions || {}
+            const lateData = (lateRes.data?.sessions) || {}
+            for (const sid of sessionIds) {
+              const e = earlyData[sid] || { sent: 0, received: 0 }
+              const l = lateData[sid] || { sent: 0, received: 0 }
+              const early = (e.sent || 0) + (e.received || 0)
+              const late = (l.sent || 0) + (l.received || 0)
+              if (early > 100 && early > late * 5) {
+                // 选择前期消息量最多的
+                if (early > maxEarlyCount) {
+                  maxEarlyCount = early
+                  bestEarlyCount = early
+                  bestLateCount = late
+                  bestSid = sid
+                  bestPeriodDesc = '这段时间以来'
+                }
+              }
+            }
+          }
+        }
+      } else if (year === currentYearNum) {
+        // 当前年份：独立获取过去12个月的滚动数据
+        this.reportProgress('分析近期好友趋势...', 86, onProgress)
+        // 往前数12个月的起点、中点、终点
+        const rollingStart = Math.floor(new Date(now.getFullYear(), now.getMonth() - 11, 1).getTime() / 1000)
+        const rollingMid = Math.floor(new Date(now.getFullYear(), now.getMonth() - 5, 1).getTime() / 1000)
+        const rollingEnd = Math.floor(now.getTime() / 1000)
+
+        const earlyRes = await wcdbService.getAggregateStats(sessionIds, rollingStart, rollingMid - 1)
+        const lateRes = await wcdbService.getAggregateStats(sessionIds, rollingMid, rollingEnd)
+
+        if (earlyRes.success && lateRes.success && earlyRes.data) {
+          const earlyData = earlyRes.data.sessions || {}
+          const lateData = lateRes.data?.sessions || {}
+          for (const sid of sessionIds) {
+            const e = earlyData[sid] || { sent: 0, received: 0 }
+            const l = lateData[sid] || { sent: 0, received: 0 }
+            const early = (e.sent || 0) + (e.received || 0)
+            const late = (l.sent || 0) + (l.received || 0)
+            if (early > 80 && early > late * 5) {
+              // 选择前期消息量最多的
+              if (early > maxEarlyCount) {
+                maxEarlyCount = early
+                bestEarlyCount = early
+                bestLateCount = late
+                bestSid = sid
+                bestPeriodDesc = '去年的这个时候'
+              }
+            }
+          }
+        }
+      } else {
+        // 指定完整年份 (1-6 vs 7-12)
+        for (const [sid, stat] of Object.entries(d.sessions)) {
+          const s = stat as any
+          const mWeights = s.monthly || {}
+          let early = 0
+          let late = 0
+          for (let m = 1; m <= 6; m++) early += mWeights[m] || 0
+          for (let m = 7; m <= 12; m++) late += mWeights[m] || 0
+
+          if (early > 80 && early > late * 5) {
+            // 选择前期消息量最多的
+            if (early > maxEarlyCount) {
+              maxEarlyCount = early
+              bestEarlyCount = early
+              bestLateCount = late
+              bestSid = sid
+              bestPeriodDesc = `${year}年上半年`
+            }
+          }
+        }
+      }
+
+      if (bestSid) {
+        let info = contactInfoMap.get(bestSid)
+        // 如果 contactInfoMap 中没有该联系人，则单独获取
+        if (!info) {
+          const [displayNameRes, avatarUrlRes] = await Promise.all([
+            wcdbService.getDisplayNames([bestSid]),
+            wcdbService.getAvatarUrls([bestSid])
+          ])
+          info = {
+            displayName: displayNameRes.success && displayNameRes.map ? (displayNameRes.map[bestSid] || bestSid) : bestSid,
+            avatarUrl: avatarUrlRes.success && avatarUrlRes.map ? avatarUrlRes.map[bestSid] : undefined
+          }
+        }
+        lostFriend = {
+          username: bestSid,
+          displayName: info?.displayName || bestSid,
+          avatarUrl: info?.avatarUrl,
+          earlyCount: bestEarlyCount,
+          lateCount: bestLateCount,
+          periodDesc: bestPeriodDesc
+        }
+      }
+
       const reportData: AnnualReportData = {
-        year,
+        year: reportYear,
         totalMessages,
         totalFriends: contactStats.size,
         coreFriends,
@@ -915,7 +1112,9 @@ class AnnualReportService {
         mutualFriend,
         socialInitiative,
         responseSpeed,
-        topPhrases
+        topPhrases,
+        snsStats: snsStatsResult,
+        lostFriend
       }
 
       return { success: true, data: reportData }

electron/services/chatService.ts

@@ -1,5 +1,5 @@
 import { join, dirname, basename, extname } from 'path'
-import { existsSync, mkdirSync, readdirSync, statSync, readFileSync, writeFileSync, copyFileSync, unlinkSync } from 'fs'
+import { existsSync, mkdirSync, readdirSync, statSync, readFileSync, writeFileSync, copyFileSync, unlinkSync, watch } from 'fs'
 import * as path from 'path'
 import * as fs from 'fs'
 import * as https from 'https'
@@ -7,7 +7,7 @@ import * as http from 'http'
 import * as fzstd from 'fzstd'
 import * as crypto from 'crypto'
 import Database from 'better-sqlite3'
-import { app } from 'electron'
+import { app, BrowserWindow } from 'electron'
 import { ConfigService } from './config'
 import { wcdbService } from './wcdbService'
 import { MessageCacheService } from './messageCacheService'
@@ -30,6 +30,9 @@ export interface ChatSession {
   lastMsgType: number
   displayName?: string
   avatarUrl?: string
+  lastMsgSender?: string
+  lastSenderDisplayName?: string
+  selfWxid?: string
 }
 
 export interface Message {
@@ -69,6 +72,9 @@ export interface Message {
   // 名片消息
   cardUsername?: string     // 名片的微信ID
   cardNickname?: string     // 名片的昵称
+  // 转账消息
+  transferPayerUsername?: string   // 转账付款人
+  transferReceiverUsername?: string // 转账收款人
   // 聊天记录
   chatRecordTitle?: string  // 聊天记录标题
   chatRecordList?: Array<{
@@ -114,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
@@ -152,9 +161,9 @@ class ChatService {
     }
 
     const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/)
-    if (suffixMatch) return suffixMatch[1]
+    const cleaned = suffixMatch ? suffixMatch[1] : trimmed
 
-    return trimmed
+    return cleaned
   }
 
   /**
@@ -186,6 +195,9 @@ class ChatService {
 
       this.connected = true
 
+      // 设置数据库监控
+      this.setupDbMonitor()
+
       // 预热 listMediaDbs 缓存（后台异步执行，不阻塞连接）
       this.warmupMediaDbsCache()
 
@@ -196,6 +208,24 @@ class ChatService {
     }
   }
 
+  private monitorSetup = false
+
+  private setupDbMonitor() {
+    if (this.monitorSetup) return
+    this.monitorSetup = true
+
+    // 使用 C++ DLL 内部的文件监控 (ReadDirectoryChangesW)
+    // 这种方式更高效，且不占用 JS 线程，并能直接监听 session/message 目录变更
+    wcdbService.setMonitor((type, json) => {
+      // 广播给所有渲染进程窗口
+      BrowserWindow.getAllWindows().forEach((win) => {
+        if (!win.isDestroyed()) {
+          win.webContents.send('wcdb-change', { type, json })
+        }
+      })
+    })
+  }
+
   /**
    * 预热 media 数据库列表缓存（后台异步执行）
    */
@@ -266,6 +296,7 @@ class ChatService {
       // 转换为 ChatSession（先加载缓存，但不等待数据库查询）
       const sessions: ChatSession[] = []
       const now = Date.now()
+      const myWxid = this.configService.get('myWxid')
 
       for (const row of rows) {
         const username =
@@ -319,7 +350,10 @@ class ChatService {
           lastTimestamp: lastTs,
           lastMsgType,
           displayName,
-          avatarUrl
+          avatarUrl,
+          lastMsgSender: row.last_msg_sender, // 数据库返回字段
+          lastSenderDisplayName: row.last_sender_display_name, // 数据库返回字段
+          selfWxid: myWxid
         })
       }
 
@@ -543,7 +577,7 @@ class ChatService {
         FROM contact
       `
 
-      console.log('查询contact.db...')
+
       const contactResult = await wcdbService.execQuery('contact', null, contactQuery)
 
       if (!contactResult.success || !contactResult.rows) {
@@ -551,13 +585,13 @@ class ChatService {
         return { success: false, error: contactResult.error || '查询联系人失败' }
       }
 
-      console.log('查询到', contactResult.rows.length, '条联系人记录')
+
       const rows = contactResult.rows as Record<string, any>[]
 
       // 调试：显示前5条数据样本
-      console.log('📋 前5条数据样本:')
+
       rows.slice(0, 5).forEach((row, idx) => {
-        console.log(`  ${idx + 1}. username: ${row.username}, local_type: ${row.local_type}, remark: ${row.remark || '无'}, nick_name: ${row.nick_name || '无'}`)
+
       })
 
       // 调试：统计local_type分布
@@ -566,7 +600,7 @@ class ChatService {
         const lt = row.local_type || 0
         localTypeStats.set(lt, (localTypeStats.get(lt) || 0) + 1)
       })
-      console.log('📊 local_type分布:', Object.fromEntries(localTypeStats))
+
 
       // 获取会话表的最后联系时间用于排序
       const lastContactTimeMap = new Map<string, number>()
@@ -642,13 +676,8 @@ class ChatService {
         })
       }
 
-      console.log('过滤后得到', contacts.length, '个有效联系人')
-      console.log('📊 按类型统计:', {
-        friends: contacts.filter(c => c.type === 'friend').length,
-        groups: contacts.filter(c => c.type === 'group').length,
-        officials: contacts.filter(c => c.type === 'official').length,
-        other: contacts.filter(c => c.type === 'other').length
-      })
+
+
 
       // 按最近联系时间排序
       contacts.sort((a, b) => {
@@ -665,7 +694,7 @@ class ChatService {
       // 移除临时的lastContactTime字段
       const result = contacts.map(({ lastContactTime, ...rest }) => rest)
 
-      console.log('返回', result.length, '个联系人')
+
       return { success: true, contacts: result }
     } catch (e) {
       console.error('ChatService: 获取通讯录失败:', e)
@@ -697,7 +726,7 @@ class ChatService {
       // 1. 没有游标状态
       // 2. offset 为 0 (重新加载会话)
       // 3. batchSize 改变
-      // 4. startTime 改变
+      // 4. startTime/endTime 改变（视为全新查询）
       // 5. ascending 改变
       const needNewCursor = !state ||
         offset === 0 ||
@@ -730,26 +759,34 @@ class ChatService {
         this.messageCursors.set(sessionId, state)
 
         // 如果需要跳过消息(offset > 0),逐批获取但不返回
+        // 注意：仅在 offset === 0 时重建游标最安全；
+        // 当 startTime/endTime 变化导致重建时，offset 应由前端重置为 0
         if (offset > 0) {
-          console.log(`[ChatService] 跳过消息: offset=${offset}`)
+          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.log('[ChatService] 跳过时没有更多消息')
+              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.log('[ChatService] 跳过时已到达末尾')
+              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) {
@@ -913,6 +950,40 @@ class ChatService {
     }
   }
 
+  async getNewMessages(sessionId: string, minTime: number, limit: number = this.messageBatchDefault): Promise<{ success: boolean; messages?: Message[]; error?: string }> {
+    try {
+      const connectResult = await this.ensureConnected()
+      if (!connectResult.success) {
+        return { success: false, error: connectResult.error || '数据库未连接' }
+      }
+
+      const res = await wcdbService.getNewMessages(sessionId, minTime, limit)
+      if (!res.success || !res.messages) {
+        return { success: false, error: res.error || '获取新消息失败' }
+      }
+
+      // 转换为 Message 对象
+      const messages = this.mapRowsToMessages(res.messages as Record<string, any>[])
+      const normalized = this.normalizeMessageOrder(messages)
+
+      // 并发检查并修复缺失 CDN URL 的表情包
+      const fixPromises: Promise<void>[] = []
+      for (const msg of normalized) {
+        if (msg.localType === 47 && !msg.emojiCdnUrl && msg.emojiMd5) {
+          fixPromises.push(this.fallbackEmoticon(msg))
+        }
+      }
+      if (fixPromises.length > 0) {
+        await Promise.allSettled(fixPromises)
+      }
+
+      return { success: true, messages: normalized }
+    } catch (e) {
+      console.error('ChatService: 获取增量消息失败:', e)
+      return { success: false, error: String(e) }
+    }
+  }
+
   private normalizeMessageOrder(messages: Message[]): Message[] {
     if (messages.length < 2) return messages
     const first = messages[0]
@@ -1019,13 +1090,19 @@ class ChatService {
 
       if (senderUsername && (myWxidLower || cleanedWxidLower)) {
         const senderLower = String(senderUsername).toLowerCase()
-        const expectedIsSend = (senderLower === myWxidLower || senderLower === cleanedWxidLower) ? 1 : 0
+        const expectedIsSend = (
+          senderLower === myWxidLower ||
+          senderLower === cleanedWxidLower ||
+          // 兼容非 wxid 开头的账号（如果文件夹名带后缀，如 custom_backup，而 sender 是 custom）
+          (myWxidLower && myWxidLower.startsWith(senderLower + '_')) ||
+          (cleanedWxidLower && cleanedWxidLower.startsWith(senderLower + '_'))
+        ) ? 1 : 0
         if (isSend === null) {
           isSend = expectedIsSend
           // [DEBUG] Issue #34: 记录 isSend 推断过程
           if (expectedIsSend === 0 && localType === 1) {
             // 仅在被判为接收且是文本消息时记录，避免刷屏
-            // console.log(`[ChatService] inferred isSend=0: sender=${senderUsername}, myWxid=${myWxid} (cleaned=${cleanedWxid})`)
+            // 
           }
         }
       } else if (senderUsername && !myWxid) {
@@ -1057,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<{
@@ -1088,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
@@ -1100,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
@@ -1136,6 +1218,8 @@ class ChatService {
         xmlType,
         cardUsername,
         cardNickname,
+        transferPayerUsername,
+        transferReceiverUsername,
         chatRecordTitle,
         chatRecordList
       })
@@ -1205,6 +1289,15 @@ class ChatService {
       case 8589934592049:
         return '[转账]'
       default:
+        // 检查是否是 type=87 的群公告消息
+        if (xmlType === '87') {
+          const textAnnouncement = this.extractXmlValue(content, 'textannouncement')
+          if (textAnnouncement) {
+            return `[群公告] ${textAnnouncement}`
+          }
+          return '[群公告]'
+        }
+
         // 检查是否是 type=57 的引用消息
         if (xmlType === '57') {
           const title = this.extractXmlValue(content, 'title')
@@ -1228,6 +1321,15 @@ class ChatService {
     const title = this.extractXmlValue(content, 'title')
     const type = this.extractXmlValue(content, 'type')
 
+    // 群公告消息（type 87）特殊处理
+    if (type === '87') {
+      const textAnnouncement = this.extractXmlValue(content, 'textannouncement')
+      if (textAnnouncement) {
+        return `[群公告] ${textAnnouncement}`
+      }
+      return '[群公告]'
+    }
+
     if (title) {
       switch (type) {
         case '5':
@@ -1261,6 +1363,8 @@ class ChatService {
         return '[小程序]'
       case '2000':
         return '[转账]'
+      case '87':
+        return '[群公告]'
       default:
         return '[消息]'
     }
@@ -1580,6 +1684,8 @@ class ChatService {
     fileName?: string
     fileSize?: number
     fileExt?: string
+    transferPayerUsername?: string
+    transferReceiverUsername?: string
     chatRecordTitle?: string
     chatRecordList?: Array<{
       datatype: number
@@ -1610,7 +1716,7 @@ class ChatService {
 
           // 提取文件大小
           const fileSizeStr = this.extractXmlValue(content, 'totallen') ||
-                             this.extractXmlValue(content, 'filesize')
+            this.extractXmlValue(content, 'filesize')
           if (fileSizeStr) {
             const size = parseInt(fileSizeStr, 10)
             if (!isNaN(size)) {
@@ -1683,7 +1789,7 @@ class ChatService {
 
           // 提取缩略图
           const thumbUrl = this.extractXmlValue(content, 'thumburl') ||
-                          this.extractXmlValue(content, 'cdnthumburl')
+            this.extractXmlValue(content, 'cdnthumburl')
           if (thumbUrl) {
             result.linkThumb = thumbUrl
           }
@@ -1703,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
         }
 
@@ -1712,7 +1828,7 @@ class ChatService {
           result.linkUrl = url
 
           const thumbUrl = this.extractXmlValue(content, 'thumburl') ||
-                          this.extractXmlValue(content, 'cdnthumburl')
+            this.extractXmlValue(content, 'cdnthumburl')
           if (thumbUrl) {
             result.linkThumb = thumbUrl
           }
@@ -2085,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, '') // 移除长数字
@@ -2132,7 +2261,7 @@ class ChatService {
   private decodeMaybeCompressed(raw: any, fieldName: string = 'unknown'): string {
     if (!raw) return ''
 
-    // console.log(`[ChatService] Decoding ${fieldName}: type=${typeof raw}`, raw)
+    // 
 
     // 如果是 Buffer/Uint8Array
     if (Buffer.isBuffer(raw) || raw instanceof Uint8Array) {
@@ -2144,17 +2273,21 @@ 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)
-          // console.log(`[ChatService] HEX decoded result: ${result}`)
+          // 
           return result
         }
       }
 
       // 检查是否是 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)
@@ -2200,7 +2333,7 @@ class ChatService {
 
       // 如果提供了 fallbackValue，且解码结果看起来像二进制垃圾，则返回 fallbackValue
       if (fallbackValue && replacementCount > 0) {
-        // console.log(`[ChatService] Binary garbage detected, using fallback: ${fallbackValue}`)
+        // 
         return fallbackValue
       }
 
@@ -2301,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
    */
@@ -2794,7 +2996,7 @@ class ChatService {
         const t1 = Date.now()
         const msgResult = await this.getMessageByLocalId(sessionId, localId)
         const t2 = Date.now()
-        console.log(`[Voice] getMessageByLocalId: ${t2 - t1}ms`)
+
 
         if (msgResult.success && msgResult.message) {
           const msg = msgResult.message as any
@@ -2813,7 +3015,7 @@ class ChatService {
       // 检查 WAV 内存缓存
       const wavCache = this.voiceWavCache.get(cacheKey)
       if (wavCache) {
-        console.log(`[Voice] 内存缓存命中，总耗时: ${Date.now() - startTime}ms`)
+
         return { success: true, data: wavCache.toString('base64') }
       }
 
@@ -2825,7 +3027,7 @@ class ChatService {
           const wavData = readFileSync(wavFilePath)
           // 同时缓存到内存
           this.cacheVoiceWav(cacheKey, wavData)
-          console.log(`[Voice] 文件缓存命中，总耗时: ${Date.now() - startTime}ms`)
+
           return { success: true, data: wavData.toString('base64') }
         } catch (e) {
           console.error('[Voice] 读取缓存文件失败:', e)
@@ -2855,7 +3057,7 @@ class ChatService {
       // 从数据库读取 silk 数据
       const silkData = await this.getVoiceDataFromMediaDb(msgCreateTime, candidates)
       const t4 = Date.now()
-      console.log(`[Voice] getVoiceDataFromMediaDb: ${t4 - t3}ms`)
+
 
       if (!silkData) {
         return { success: false, error: '未找到语音数据 (请确保已在微信中播放过该语音)' }
@@ -2865,7 +3067,7 @@ class ChatService {
       // 使用 silk-wasm 解码
       const pcmData = await this.decodeSilkToPcm(silkData, 24000)
       const t6 = Date.now()
-      console.log(`[Voice] decodeSilkToPcm: ${t6 - t5}ms`)
+
 
       if (!pcmData) {
         return { success: false, error: 'Silk 解码失败' }
@@ -2875,7 +3077,7 @@ class ChatService {
       // PCM -> WAV
       const wavData = this.createWavBuffer(pcmData, 24000)
       const t8 = Date.now()
-      console.log(`[Voice] createWavBuffer: ${t8 - t7}ms`)
+
 
       // 缓存 WAV 数据到内存
       this.cacheVoiceWav(cacheKey, wavData)
@@ -2883,7 +3085,7 @@ class ChatService {
       // 缓存 WAV 数据到文件（异步，不阻塞返回）
       this.cacheVoiceWavToFile(cacheKey, wavData)
 
-      console.log(`[Voice] 总耗时: ${Date.now() - startTime}ms`)
+
       return { success: true, data: wavData.toString('base64') }
     } catch (e) {
       console.error('ChatService: getVoiceData 失败:', e)
@@ -2920,11 +3122,11 @@ class ChatService {
       let mediaDbFiles: string[]
       if (this.mediaDbsCache) {
         mediaDbFiles = this.mediaDbsCache
-        console.log(`[Voice] listMediaDbs (缓存): 0ms`)
+
       } else {
         const mediaDbsResult = await wcdbService.listMediaDbs()
         const t2 = Date.now()
-        console.log(`[Voice] listMediaDbs: ${t2 - t1}ms`)
+
 
         let files = mediaDbsResult.success && mediaDbsResult.data ? (mediaDbsResult.data as string[]) : []
 
@@ -2956,7 +3158,7 @@ class ChatService {
               "SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'VoiceInfo%'"
             )
             const t4 = Date.now()
-            console.log(`[Voice] 查询VoiceInfo表: ${t4 - t3}ms`)
+
 
             if (!tablesResult.success || !tablesResult.rows || tablesResult.rows.length === 0) {
               continue
@@ -2969,7 +3171,7 @@ class ChatService {
               `PRAGMA table_info('${voiceTable}')`
             )
             const t6 = Date.now()
-            console.log(`[Voice] 查询表结构: ${t6 - t5}ms`)
+
 
             if (!columnsResult.success || !columnsResult.rows) {
               continue
@@ -3006,7 +3208,7 @@ class ChatService {
               "SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'Name2Id%'"
             )
             const t8 = Date.now()
-            console.log(`[Voice] 查询Name2Id表: ${t8 - t7}ms`)
+
 
             const name2IdTable = (name2IdTablesResult.success && name2IdTablesResult.rows && name2IdTablesResult.rows.length > 0)
               ? name2IdTablesResult.rows[0].name
@@ -3033,7 +3235,7 @@ class ChatService {
               `SELECT user_name, rowid FROM ${schema.name2IdTable} WHERE user_name IN (${candidatesStr})`
             )
             const t10 = Date.now()
-            console.log(`[Voice] 查询chat_name_id: ${t10 - t9}ms`)
+
 
             if (name2IdResult.success && name2IdResult.rows && name2IdResult.rows.length > 0) {
               // 构建 chat_name_id 列表
@@ -3046,13 +3248,13 @@ class ChatService {
                 `SELECT ${schema.dataColumn} AS data FROM ${schema.voiceTable} WHERE ${schema.chatNameIdColumn} IN (${chatNameIdsStr}) AND ${schema.timeColumn} = ${createTime} LIMIT 1`
               )
               const t12 = Date.now()
-              console.log(`[Voice] 策略1查询语音: ${t12 - t11}ms`)
+
 
               if (voiceResult.success && voiceResult.rows && voiceResult.rows.length > 0) {
                 const row = voiceResult.rows[0]
                 const silkData = this.decodeVoiceBlob(row.data)
                 if (silkData) {
-                  console.log(`[Voice] getVoiceDataFromMediaDb总耗时: ${Date.now() - startTime}ms`)
+
                   return silkData
                 }
               }
@@ -3066,13 +3268,13 @@ class ChatService {
               `SELECT ${schema.dataColumn} AS data FROM ${schema.voiceTable} WHERE ${schema.timeColumn} = ${createTime} LIMIT 1`
             )
             const t14 = Date.now()
-            console.log(`[Voice] 策略2查询语音: ${t14 - t13}ms`)
+
 
             if (voiceResult.success && voiceResult.rows && voiceResult.rows.length > 0) {
               const row = voiceResult.rows[0]
               const silkData = this.decodeVoiceBlob(row.data)
               if (silkData) {
-                console.log(`[Voice] getVoiceDataFromMediaDb总耗时: ${Date.now() - startTime}ms`)
+
                 return silkData
               }
             }
@@ -3085,13 +3287,13 @@ class ChatService {
               `SELECT ${schema.dataColumn} AS data FROM ${schema.voiceTable} WHERE ${schema.timeColumn} BETWEEN ${createTime - 5} AND ${createTime + 5} ORDER BY ABS(${schema.timeColumn} - ${createTime}) LIMIT 1`
             )
             const t16 = Date.now()
-            console.log(`[Voice] 策略3查询语音: ${t16 - t15}ms`)
+
 
             if (voiceResult.success && voiceResult.rows && voiceResult.rows.length > 0) {
               const row = voiceResult.rows[0]
               const silkData = this.decodeVoiceBlob(row.data)
               if (silkData) {
-                console.log(`[Voice] getVoiceDataFromMediaDb总耗时: ${Date.now() - startTime}ms`)
+
                 return silkData
               }
             }
@@ -3322,7 +3524,9 @@ class ChatService {
     senderWxid?: string
   ): Promise<{ success: boolean; transcript?: string; error?: string }> {
     const startTime = Date.now()
-    console.log(`[Transcribe] 开始转写: sessionId=${sessionId}, msgId=${msgId}, createTime=${createTime}`)
+
+    // 确保磁盘缓存已加载
+    this.loadTranscriptCacheIfNeeded()
 
     try {
       let msgCreateTime = createTime
@@ -3333,12 +3537,12 @@ class ChatService {
         const t1 = Date.now()
         const msgResult = await this.getMessageById(sessionId, parseInt(msgId, 10))
         const t2 = Date.now()
-        console.log(`[Transcribe] getMessageById: ${t2 - t1}ms`)
+
 
         if (msgResult.success && msgResult.message) {
           msgCreateTime = msgResult.message.createTime
           serverId = msgResult.message.serverId
-          console.log(`[Transcribe] 获取到 createTime=${msgCreateTime}, serverId=${serverId}`)
+
         }
       }
 
@@ -3349,19 +3553,19 @@ class ChatService {
 
       // 使用正确的 cacheKey（包含 createTime）
       const cacheKey = this.getVoiceCacheKey(sessionId, msgId, msgCreateTime)
-      console.log(`[Transcribe] cacheKey=${cacheKey}`)
+
 
       // 检查转写缓存
       const cached = this.voiceTranscriptCache.get(cacheKey)
       if (cached) {
-        console.log(`[Transcribe] 缓存命中，总耗时: ${Date.now() - startTime}ms`)
+
         return { success: true, transcript: cached }
       }
 
       // 检查是否正在转写
       const pending = this.voiceTranscriptPending.get(cacheKey)
       if (pending) {
-        console.log(`[Transcribe] 正在转写中，等待结果`)
+
         return pending
       }
 
@@ -3370,7 +3574,7 @@ class ChatService {
           // 检查内存中是否有 WAV 数据
           let wavData = this.voiceWavCache.get(cacheKey)
           if (wavData) {
-            console.log(`[Transcribe] WAV内存缓存命中，大小: ${wavData.length} bytes`)
+
           } else {
             // 检查文件缓存
             const voiceCacheDir = this.getVoiceCacheDir()
@@ -3378,7 +3582,7 @@ class ChatService {
             if (existsSync(wavFilePath)) {
               try {
                 wavData = readFileSync(wavFilePath)
-                console.log(`[Transcribe] WAV文件缓存命中，大小: ${wavData.length} bytes`)
+
                 // 同时缓存到内存
                 this.cacheVoiceWav(cacheKey, wavData)
               } catch (e) {
@@ -3388,39 +3592,39 @@ class ChatService {
           }
 
           if (!wavData) {
-            console.log(`[Transcribe] WAV缓存未命中，调用 getVoiceData`)
+
             const t3 = Date.now()
             // 调用 getVoiceData 获取并解码
             const voiceResult = await this.getVoiceData(sessionId, msgId, msgCreateTime, serverId, senderWxid)
             const t4 = Date.now()
-            console.log(`[Transcribe] getVoiceData: ${t4 - t3}ms, success=${voiceResult.success}`)
+
 
             if (!voiceResult.success || !voiceResult.data) {
               console.error(`[Transcribe] 语音解码失败: ${voiceResult.error}`)
               return { success: false, error: voiceResult.error || '语音解码失败' }
             }
             wavData = Buffer.from(voiceResult.data, 'base64')
-            console.log(`[Transcribe] WAV数据大小: ${wavData.length} bytes`)
+
           }
 
           // 转写
-          console.log(`[Transcribe] 开始调用 transcribeWavBuffer`)
+
           const t5 = Date.now()
           const result = await voiceTranscribeService.transcribeWavBuffer(wavData, (text) => {
-            console.log(`[Transcribe] 部分结果: ${text}`)
+
             onPartial?.(text)
           })
           const t6 = Date.now()
-          console.log(`[Transcribe] transcribeWavBuffer: ${t6 - t5}ms, success=${result.success}`)
+
 
           if (result.success && result.transcript) {
-            console.log(`[Transcribe] 转写成功: ${result.transcript}`)
+
             this.cacheVoiceTranscript(cacheKey, result.transcript)
           } else {
             console.error(`[Transcribe] 转写失败: ${result.error}`)
           }
 
-          console.log(`[Transcribe] 总耗时: ${Date.now() - startTime}ms`)
+
           return result
         } catch (error) {
           console.error(`[Transcribe] 异常:`, error)
@@ -3450,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

@@ -27,17 +27,39 @@ interface ConfigSchema {
   autoTranscribeVoice: boolean
   transcribeLanguages: string[]
   exportDefaultConcurrency: number
+  analyticsExcludedUsernames: string[]
 
   // 安全相关
   authEnabled: boolean
   authPassword: string // SHA-256 hash
   authUseHello: boolean
+
+  // 更新相关
+  ignoredUpdateVersion: string
+
+  // 通知
+  notificationEnabled: boolean
+  notificationPosition: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'
+  notificationFilterMode: 'all' | 'whitelist' | 'blacklist'
+  notificationFilterList: string[]
 }
 
 export class ConfigService {
-  private store: Store<ConfigSchema>
+  private static instance: ConfigService
+  private store!: Store<ConfigSchema>
+
+  static getInstance(): ConfigService {
+    if (!ConfigService.instance) {
+      ConfigService.instance = new ConfigService()
+    }
+    return ConfigService.instance
+  }
 
   constructor() {
+    if (ConfigService.instance) {
+      return ConfigService.instance
+    }
+    ConfigService.instance = this
     this.store = new Store<ConfigSchema>({
       name: 'WeFlow-config',
       defaults: {
@@ -62,10 +84,17 @@ export class ConfigService {
         autoTranscribeVoice: false,
         transcribeLanguages: ['zh'],
         exportDefaultConcurrency: 2,
+        analyticsExcludedUsernames: [],
 
         authEnabled: false,
         authPassword: '',
-        authUseHello: false
+        authUseHello: false,
+
+        ignoredUpdateVersion: '',
+        notificationEnabled: true,
+        notificationPosition: 'top-right',
+        notificationFilterMode: 'all',
+        notificationFilterList: []
       }
     })
   }

electron/services/dbPathService.ts

@@ -118,6 +118,48 @@ export class DbPathService {
     }
   }
 
+  /**
+   * 扫描目录名候选（仅包含下划线的文件夹，排除 all_users）
+   */
+  scanWxidCandidates(rootPath: string): WxidInfo[] {
+    const wxids: WxidInfo[] = []
+
+    try {
+      if (existsSync(rootPath)) {
+        const entries = readdirSync(rootPath)
+        for (const entry of entries) {
+          const entryPath = join(rootPath, entry)
+          let stat: ReturnType<typeof statSync>
+          try {
+            stat = statSync(entryPath)
+          } catch {
+            continue
+          }
+
+          if (!stat.isDirectory()) continue
+          const lower = entry.toLowerCase()
+          if (lower === 'all_users') continue
+          if (!entry.includes('_')) continue
+
+          wxids.push({ wxid: entry, modifiedTime: stat.mtimeMs })
+        }
+      }
+
+      if (wxids.length === 0) {
+        const rootName = basename(rootPath)
+        if (rootName.includes('_') && rootName.toLowerCase() !== 'all_users') {
+          const rootStat = statSync(rootPath)
+          wxids.push({ wxid: rootName, modifiedTime: rootStat.mtimeMs })
+        }
+      }
+    } catch { }
+
+    return wxids.sort((a, b) => {
+      if (b.modifiedTime !== a.modifiedTime) return b.modifiedTime - a.modifiedTime
+      return a.wxid.localeCompare(b.wxid)
+    })
+  }
+
   /**
    * 扫描 wxid 列表
    */

electron/services/dualReportService.ts

@@ -0,0 +1,749 @@
+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 {
+  createTime: number
+  createTimeStr: string
+  content: string
+  isSentByMe: boolean
+  senderUsername?: string
+  localType?: number
+  emojiMd5?: string
+  emojiCdnUrl?: string
+}
+
+export interface DualReportStats {
+  totalMessages: number
+  totalWords: number
+  imageCount: number
+  voiceCount: number
+  emojiCount: number
+  myTopEmojiMd5?: string
+  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?: {
+    createTime: number
+    createTimeStr: string
+    content: string
+    isSentByMe: boolean
+    friendName: string
+    firstThreeMessages: DualReportMessage[]
+    localType?: number
+    emojiMd5?: string
+    emojiCdnUrl?: string
+  } | null
+  stats: DualReportStats
+  topPhrases: 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 {
+  private broadcastProgress(status: string, progress: number) {
+    if (parentPort) {
+      parentPort.postMessage({
+        type: 'dualReport:progress',
+        data: { status, progress }
+      })
+    }
+  }
+
+  private reportProgress(status: string, progress: number, onProgress?: (status: string, progress: number) => void) {
+    if (onProgress) {
+      onProgress(status, progress)
+      return
+    }
+    this.broadcastProgress(status, progress)
+  }
+
+  private cleanAccountDirName(dirName: string): string {
+    const trimmed = dirName.trim()
+    if (!trimmed) return trimmed
+    if (trimmed.toLowerCase().startsWith('wxid_')) {
+      const match = trimmed.match(/^(wxid_[^_]+)/i)
+      if (match) return match[1]
+      return trimmed
+    }
+    const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/)
+    const cleaned = suffixMatch ? suffixMatch[1] : trimmed
+
+    return cleaned
+  }
+
+  private async ensureConnectedWithConfig(
+    dbPath: string,
+    decryptKey: string,
+    wxid: string
+  ): Promise<{ success: boolean; cleanedWxid?: string; rawWxid?: string; error?: string }> {
+    if (!wxid) return { success: false, error: '未配置微信ID' }
+    if (!dbPath) return { success: false, error: '未配置数据库路径' }
+    if (!decryptKey) return { success: false, error: '未配置解密密钥' }
+
+    const cleanedWxid = this.cleanAccountDirName(wxid)
+    const ok = await wcdbService.open(dbPath, decryptKey, cleanedWxid)
+    if (!ok) return { success: false, error: 'WCDB 打开失败' }
+    return { success: true, cleanedWxid, rawWxid: wxid }
+  }
+
+  private decodeMessageContent(messageContent: any, compressContent: any): string {
+    let content = this.decodeMaybeCompressed(compressContent)
+    if (!content || content.length === 0) {
+      content = this.decodeMaybeCompressed(messageContent)
+    }
+    return content
+  }
+
+  private decodeMaybeCompressed(raw: any): string {
+    if (!raw) return ''
+    if (typeof raw === 'string') {
+      if (raw.length === 0) return ''
+      // 只有当字符串足够长（超过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)
+      }
+      // 只有当字符串足够长（超过16字符）且看起来像 base64 时才尝试解码
+      // 短字符串（如 "test", "home" 等）容易被误判为 base64
+      if (raw.length > 16 && this.looksLikeBase64(raw)) {
+        try {
+          const bytes = Buffer.from(raw, 'base64')
+          return this.decodeBinaryContent(bytes)
+        } catch {
+          return raw
+        }
+      }
+      return raw
+    }
+    return ''
+  }
+
+  private decodeBinaryContent(data: Buffer): string {
+    if (data.length === 0) return ''
+    try {
+      if (data.length >= 4) {
+        const magic = data.readUInt32LE(0)
+        if (magic === 0xFD2FB528) {
+          const fzstd = require('fzstd')
+          const decompressed = fzstd.decompress(data)
+          return Buffer.from(decompressed).toString('utf-8')
+        }
+      }
+      const decoded = data.toString('utf-8')
+      const replacementCount = (decoded.match(/\uFFFD/g) || []).length
+      if (replacementCount < decoded.length * 0.2) {
+        return decoded.replace(/\uFFFD/g, '')
+      }
+      return data.toString('latin1')
+    } catch {
+      return ''
+    }
+  }
+
+  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 formatDateTime(milliseconds: number): string {
+    const dt = new Date(milliseconds)
+    const month = String(dt.getMonth() + 1).padStart(2, '0')
+    const day = String(dt.getDate()).padStart(2, '0')
+    const hour = String(dt.getHours()).padStart(2, '0')
+    const minute = String(dt.getMinutes()).padStart(2, '0')
+    return `${month}/${day} ${hour}:${minute}`
+  }
+
+  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]
+      }
+    }
+    return 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 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> {
+    const result = await wcdbService.getDisplayNames([username])
+    if (result.success && result.map) {
+      return result.map[username] || fallback
+    }
+    return fallback
+  }
+
+  private resolveIsSent(row: any, rawWxid?: string, cleanedWxid?: string): boolean {
+    const isSendRaw = row.computed_is_send ?? row.is_send
+    if (isSendRaw !== undefined && isSendRaw !== null) {
+      return parseInt(isSendRaw, 10) === 1
+    }
+    const sender = String(row.sender_username || row.sender || row.talker || '').toLowerCase()
+    if (!sender) return false
+    const rawLower = rawWxid ? rawWxid.toLowerCase() : ''
+    const cleanedLower = cleanedWxid ? cleanedWxid.toLowerCase() : ''
+    return !!(
+      sender === rawLower ||
+      sender === cleanedLower ||
+      (rawLower && rawLower.startsWith(sender + '_')) ||
+      (cleanedLower && cleanedLower.startsWith(sender + '_'))
+    )
+  }
+
+  private async getFirstMessages(
+    sessionId: string,
+    limit: number,
+    beginTimestamp: number,
+    endTimestamp: number
+  ): Promise<any[]> {
+    const safeBegin = Math.max(0, beginTimestamp || 0)
+    const safeEnd = endTimestamp && endTimestamp > 0 ? endTimestamp : Math.floor(Date.now() / 1000)
+    const cursorResult = await wcdbService.openMessageCursor(sessionId, Math.max(1, limit), true, safeBegin, safeEnd)
+    if (!cursorResult.success || !cursorResult.cursor) return []
+    try {
+      const rows: any[] = []
+      let hasMore = true
+      while (hasMore && rows.length < limit) {
+        const batch = await wcdbService.fetchMessageBatch(cursorResult.cursor)
+        if (!batch.success || !batch.rows) break
+        for (const row of batch.rows) {
+          rows.push(row)
+          if (rows.length >= limit) break
+        }
+        hasMore = batch.hasMore === true
+      }
+      return rows.slice(0, limit)
+    } finally {
+      await wcdbService.closeMessageCursor(cursorResult.cursor)
+    }
+  }
+
+  async generateReportWithConfig(params: {
+    year: number
+    friendUsername: string
+    dbPath: string
+    decryptKey: string
+    wxid: string
+    onProgress?: (status: string, progress: number) => void
+  }): Promise<{ success: boolean; data?: DualReportData; error?: string }> {
+    try {
+      const { year, friendUsername, dbPath, decryptKey, wxid, 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 }
+
+      const cleanedWxid = conn.cleanedWxid
+      const rawWxid = conn.rawWxid
+
+      const reportYear = year <= 0 ? 0 : year
+      const isAllTime = reportYear === 0
+      const startTime = isAllTime ? 0 : Math.floor(new Date(reportYear, 0, 1).getTime() / 1000)
+      const endTime = isAllTime ? 0 : Math.floor(new Date(reportYear, 11, 31, 23, 59, 59).getTime() / 1000)
+
+      this.reportProgress('加载联系人信息...', 10, onProgress)
+      const friendName = await this.getDisplayName(friendUsername, friendUsername)
+      let myName = await this.getDisplayName(rawWxid, rawWxid)
+      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, 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 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(rawContent || ''),
+          isSentByMe: this.resolveIsSent(row, rawWxid, cleanedWxid),
+          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 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(rawContent || ''),
+          isSentByMe: this.resolveIsSent(row, rawWxid, cleanedWxid),
+          createTime: 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, 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 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(rawContent || ''),
+              isSentByMe: this.resolveIsSent(row, rawWxid, cleanedWxid),
+              createTime: 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(rawContentYear || ''),
+            isSentByMe: this.resolveIsSent(firstRowYear, rawWxid, cleanedWxid),
+            friendName,
+            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: counts.total || 0,
+        totalWords: counts.words || 0,
+        imageCount: counts.image || 0,
+        voiceCount: counts.voice || 0,
+        emojiCount: counts.emoji || 0
+      }
+
+      // Process Emojis to find top for me and friend
+      let myTopEmojiMd5: string | undefined
+      let myTopEmojiUrl: string | undefined
+      let myTopCount = -1
+
+      let friendTopEmojiMd5: string | undefined
+      let friendTopEmojiUrl: string | undefined
+      let friendTopCount = -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 (candidate.isMe) {
+            if (candidate.count > myTopCount) {
+              myTopCount = candidate.count
+              myTopEmojiMd5 = candidate.md5
+              myTopEmojiUrl = candidate.url
+            }
+          } else if (candidate.count > friendTopCount) {
+            friendTopCount = candidate.count
+            friendTopEmojiMd5 = candidate.md5
+            friendTopEmojiUrl = candidate.url
+          }
+        }
+      }
+
+      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
+        }
+      }
+
+      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.friendTopEmojiUrl = friendTopEmojiUrl
+      if (myTopCount >= 0) stats.myTopEmojiCount = myTopCount
+      if (friendTopCount >= 0) stats.friendTopEmojiCount = friendTopCount
+
+      const topPhrases = (cppData.phrases || []).map((p: any) => ({
+        phrase: p.phrase,
+        count: p.count
+      }))
+
+      const reportData: DualReportData = {
+        year: reportYear,
+        selfName: myName,
+        selfAvatarUrl,
+        friendUsername,
+        friendName,
+        friendAvatarUrl,
+        firstChat,
+        firstChatMessages,
+        yearFirstChat,
+        stats,
+        topPhrases,
+        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 }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
+}
+
+export const dualReportService = new DualReportService()

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 {
@@ -299,3 +264,30 @@ 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/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

@@ -16,6 +16,10 @@ export interface GroupMember {
   username: string
   displayName: string
   avatarUrl?: string
+  nickname?: string
+  alias?: string
+  remark?: string
+  groupNickname?: string
 }
 
 export interface GroupMessageRank {
@@ -75,8 +79,13 @@ class GroupAnalyticsService {
     if (trimmed.toLowerCase().startsWith('wxid_')) {
       const match = trimmed.match(/^(wxid_[^_]+)/i)
       if (match) return match[1]
+      return trimmed
     }
-    return trimmed
+
+    const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/)
+    const cleaned = suffixMatch ? suffixMatch[1] : trimmed
+    
+    return cleaned
   }
 
   private async ensureConnected(): Promise<{ success: boolean; error?: string }> {
@@ -93,6 +102,27 @@ class GroupAnalyticsService {
     return { success: true }
   }
 
+  /**
+   * 从 DLL 获取群成员的群昵称
+   */
+  private async getGroupNicknamesForRoom(chatroomId: string, candidates: string[] = []): Promise<Map<string, string>> {
+    try {
+      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>()
+      }
+
+      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)
@@ -103,95 +133,138 @@ class GroupAnalyticsService {
     return /^[A-Za-z0-9+/=]+$/.test(s)
   }
 
-  /**
-   * 解析 ext_buffer 二进制数据，提取群成员的群昵称
-   */
-  private parseGroupNicknamesFromExtBuffer(buffer: Buffer): Map<string, string> {
+  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 raw = buffer.toString('utf8')
-      const wxidPattern = /wxid_[a-z0-9_]+/gi
-      const wxids = raw.match(wxidPattern) || []
+      const candidateSet = new Set(this.buildIdCandidates(candidates).map((id) => id.toLowerCase()))
 
-      for (const wxid of wxids) {
-        const wxidLower = wxid.toLowerCase()
-        const wxidIndex = raw.toLowerCase().indexOf(wxidLower)
-        if (wxidIndex === -1) continue
+      for (let i = 0; i < buffer.length - 2; i += 1) {
+        if (buffer[i] !== 0x0a) continue
 
-        const afterWxid = raw.slice(wxidIndex + wxid.length)
-        let nickname = ''
-        let foundStart = false
+        const idLenInfo = this.readVarint(buffer, i + 1)
+        if (!idLenInfo) continue
+        const idLen = idLenInfo.value
+        if (!Number.isFinite(idLen) || idLen <= 0 || idLen > 96) continue
 
-        for (let i = 0; i < afterWxid.length && i < 100; i++) {
-          const char = afterWxid[i]
-          const code = char.charCodeAt(0)
-          const isPrintable = (
-            (code >= 0x4E00 && code <= 0x9FFF) ||
-            (code >= 0x3000 && code <= 0x303F) ||
-            (code >= 0xFF00 && code <= 0xFFEF) ||
-            (code >= 0x20 && code <= 0x7E)
-          )
+        const idStart = idLenInfo.next
+        const idEnd = idStart + idLen
+        if (idEnd > buffer.length) continue
 
-          if (isPrintable && code !== 0x01 && code !== 0x18) {
-            foundStart = true
-            nickname += char
-          } else if (foundStart) {
-            break
-          }
+        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
         }
 
-        nickname = nickname.trim().replace(/[\x00-\x1F\x7F]/g, '')
-        if (nickname && nickname.length < 50) {
-          nicknameMap.set(wxidLower, nickname)
+        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 ext_buffer:', e)
+      console.error('Failed to parse chat_room.ext_buffer:', e)
     }
 
     return nicknameMap
   }
 
-  /**
-   * 从 contact.db 的 chat_room 表获取群成员的群昵称
-   */
-  private async getGroupNicknamesForRoom(chatroomId: string): Promise<Map<string, string>> {
-    try {
-      const sql = `SELECT ext_buffer FROM chat_room WHERE username = '${chatroomId.replace(/'/g, "''")}'`
-      const result = await wcdbService.execQuery('contact', null, sql)
-
-      if (!result.success || !result.rows || result.rows.length === 0) {
-        return new Map<string, string>()
-      }
-
-      let extBuffer = result.rows[0].ext_buffer
-
-      if (typeof extBuffer === 'string') {
-        if (this.looksLikeHex(extBuffer)) {
-          extBuffer = Buffer.from(extBuffer, 'hex')
-        } else if (this.looksLikeBase64(extBuffer)) {
-          extBuffer = Buffer.from(extBuffer, 'base64')
-        } else {
-          try {
-            extBuffer = Buffer.from(extBuffer, 'hex')
-          } catch {
-            extBuffer = Buffer.from(extBuffer, 'base64')
-          }
-        }
-      }
-
-      if (!extBuffer || !Buffer.isBuffer(extBuffer)) {
-        return new Map<string, string>()
-      }
-
-      return this.parseGroupNicknamesFromExtBuffer(extBuffer)
-    } catch (e) {
-      console.error('getGroupNicknamesForRoom error:', e)
-      return new Map<string, string>()
-    }
-  }
-
   private escapeCsvValue(value: string): string {
     if (value == null) return ''
     const str = String(value)
@@ -201,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)
@@ -293,15 +406,88 @@ class GroupAnalyticsService {
         return { success: false, error: result.error || '获取群成员失败' }
       }
 
-      const members = result.members as { username: string; avatarUrl?: string }[]
-      const usernames = members.map((m) => m.username)
-      const displayNames = await wcdbService.getDisplayNames(usernames)
+      const members = result.members as Array<{
+        username: string
+        avatarUrl?: string
+        originalName?: string
+      }>
+      const usernames = members.map((m) => m.username).filter(Boolean)
 
-      const data: GroupMember[] = members.map((m) => ({
-        username: m.username,
-        displayName: displayNames.success && displayNames.map ? (displayNames.map[m.username] || m.username) : m.username,
-        avatarUrl: m.avatarUrl
-      }))
+      const displayNamesPromise = wcdbService.getDisplayNames(usernames)
+
+      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)
+        if (contactResult.success && contactResult.contact) {
+          const contact = contactResult.contact as any
+          contactMap.set(username, {
+            remark: contact.remark || '',
+            nickName: contact.nickName || contact.nick_name || '',
+            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 || ''
+        const displayName = displayNames.success && displayNames.map ? (displayNames.map[wxid] || wxid) : wxid
+        const contact = contactMap.get(wxid)
+        const nickname = contact?.nickName || ''
+        const remark = contact?.remark || ''
+        const alias = contact?.alias || ''
+        const normalizedWxid = this.cleanAccountDirName(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,
+          displayName,
+          nickname,
+          alias,
+          remark,
+          groupNickname,
+          avatarUrl: m.avatarUrl
+        }
+      })
 
       return { success: true, data }
     } catch (e) {
@@ -451,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)
@@ -471,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: '' })
@@ -486,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 || '')
@@ -493,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/imageDecryptService.ts

@@ -11,7 +11,16 @@ import { wcdbService } from './wcdbService'
 // 获取 ffmpeg-static 的路径
 function getStaticFfmpegPath(): string | null {
   try {
-    // 方法1: 直接 require ffmpeg-static
+    // 优先处理打包后的路径
+    if (app.isPackaged) {
+      const resourcesPath = process.resourcesPath
+      const packedPath = join(resourcesPath, 'app.asar.unpacked', 'node_modules', 'ffmpeg-static', 'ffmpeg.exe')
+      if (existsSync(packedPath)) {
+        return packedPath
+      }
+    }
+
+    // 方法1: 直接 require ffmpeg-static（开发环境）
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     const ffmpegStatic = require('ffmpeg-static')
 
@@ -19,21 +28,12 @@ function getStaticFfmpegPath(): string | null {
       return ffmpegStatic
     }
 
-    // 方法2: 手动构建路径（开发环境）
+    // 方法2: 手动构建路径（开发环境备用）
     const devPath = join(process.cwd(), 'node_modules', 'ffmpeg-static', 'ffmpeg.exe')
     if (existsSync(devPath)) {
       return devPath
     }
 
-    // 方法3: 打包后的路径
-    if (app.isPackaged) {
-      const resourcesPath = process.resourcesPath
-      const packedPath = join(resourcesPath, 'app.asar.unpacked', 'node_modules', 'ffmpeg-static', 'ffmpeg.exe')
-      if (existsSync(packedPath)) {
-        return packedPath
-      }
-    }
-
     return null
   } catch {
     return null
@@ -380,9 +380,9 @@ export class ImageDecryptService {
     }
 
     const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/)
-    if (suffixMatch) return suffixMatch[1]
+    const cleaned = suffixMatch ? suffixMatch[1] : trimmed
     
-    return trimmed
+    return cleaned
   }
 
   private async resolveDatPath(
@@ -415,10 +415,16 @@ export class ImageDecryptService {
           if (imageDatName) this.cacheDatPath(accountDir, imageDatName, hardlinkPath)
           return hardlinkPath
         }
-        // hardlink 找到的是缩略图，但要求高清图，直接返回 null，不再搜索
-        if (!allowThumbnail && isThumb) {
-          return null
+        // hardlink 找到的是缩略图，但要求高清图
+        // 尝试在同一目录下查找高清图变体（快速查找，不遍历）
+        const hdPath = this.findHdVariantInSameDir(hardlinkPath)
+        if (hdPath) {
+          this.cacheDatPath(accountDir, imageMd5, hdPath)
+          if (imageDatName) this.cacheDatPath(accountDir, imageDatName, hdPath)
+          return hdPath
         }
+        // 没找到高清图，返回 null（不进行全局搜索）
+        return null
       }
       this.logInfo('[ImageDecrypt] hardlink miss (md5)', { imageMd5 })
       if (imageDatName && this.looksLikeMd5(imageDatName) && imageDatName !== imageMd5) {
@@ -431,9 +437,13 @@ export class ImageDecryptService {
             this.cacheDatPath(accountDir, imageDatName, fallbackPath)
             return fallbackPath
           }
-          if (!allowThumbnail && isThumb) {
-            return null
+          // 找到缩略图但要求高清图，尝试同目录查找高清图变体
+          const hdPath = this.findHdVariantInSameDir(fallbackPath)
+          if (hdPath) {
+            this.cacheDatPath(accountDir, imageDatName, hdPath)
+            return hdPath
           }
+          return null
         }
         this.logInfo('[ImageDecrypt] hardlink miss (datName)', { imageDatName })
       }
@@ -449,10 +459,13 @@ export class ImageDecryptService {
           this.cacheDatPath(accountDir, imageDatName, hardlinkPath)
           return hardlinkPath
         }
-        // hardlink 找到的是缩略图，但要求高清图，直接返回 null
-        if (!allowThumbnail && isThumb) {
-          return null
+        // hardlink 找到的是缩略图，但要求高清图
+        const hdPath = this.findHdVariantInSameDir(hardlinkPath)
+        if (hdPath) {
+          this.cacheDatPath(accountDir, imageDatName, hdPath)
+          return hdPath
         }
+        return null
       }
       this.logInfo('[ImageDecrypt] hardlink miss (datName)', { imageDatName })
     }
@@ -467,6 +480,9 @@ export class ImageDecryptService {
       const cached = this.resolvedCache.get(imageDatName)
       if (cached && existsSync(cached)) {
         if (allowThumbnail || !this.isThumbnailPath(cached)) return cached
+        // 缓存的是缩略图，尝试找高清图
+        const hdPath = this.findHdVariantInSameDir(cached)
+        if (hdPath) return hdPath
       }
     }
 
@@ -761,6 +777,17 @@ export class ImageDecryptService {
 
     const root = join(accountDir, 'msg', 'attach')
     if (!existsSync(root)) return null
+
+    // 优化1：快速概率性查找
+    // 包含：1. 基于文件名的前缀猜测 (旧版)
+    //       2. 基于日期的最近月份扫描 (新版无索引时)
+    const fastHit = await this.fastProbabilisticSearch(root, datName)
+    if (fastHit) {
+      this.resolvedCache.set(key, fastHit)
+      return fastHit
+    }
+
+    // 优化2：兜底扫描 (异步非阻塞)
     const found = await this.walkForDatInWorker(root, datName.toLowerCase(), 8, allowThumbnail, thumbOnly)
     if (found) {
       this.resolvedCache.set(key, found)
@@ -769,6 +796,134 @@ export class ImageDecryptService {
     return null
   }
 
+  /**
+   * 基于文件名的哈希特征猜测可能的路径
+   * 包含：1. 微信旧版结构 filename.substr(0, 2)/...
+   *       2. 微信新版结构 msg/attach/{hash}/{YYYY-MM}/Img/filename
+   */
+  private async fastProbabilisticSearch(root: string, datName: string): Promise<string | null> {
+    const { promises: fs } = require('fs')
+    const { join } = require('path')
+
+    try {
+      // --- 策略 A: 旧版路径猜测 (msg/attach/xx/yy/...) ---
+      const lowerName = datName.toLowerCase()
+      let baseName = lowerName
+      if (baseName.endsWith('.dat')) {
+        baseName = baseName.slice(0, -4)
+        if (baseName.endsWith('_t') || baseName.endsWith('.t') || baseName.endsWith('_hd')) {
+          baseName = baseName.slice(0, -3)
+        } else if (baseName.endsWith('_thumb')) {
+          baseName = baseName.slice(0, -6)
+        }
+      }
+
+      const candidates: string[] = []
+      if (/^[a-f0-9]{32}$/.test(baseName)) {
+        const dir1 = baseName.substring(0, 2)
+        const dir2 = baseName.substring(2, 4)
+        candidates.push(
+          join(root, dir1, dir2, datName),
+          join(root, dir1, dir2, 'Img', datName),
+          join(root, dir1, dir2, 'mg', datName),
+          join(root, dir1, dir2, 'Image', datName)
+        )
+      }
+
+      for (const path of candidates) {
+        try {
+          await fs.access(path)
+          return path
+        } catch { }
+      }
+
+      // --- 策略 B: 新版 Session 哈希路径猜测 ---
+      try {
+        const entries = await fs.readdir(root, { withFileTypes: true })
+        const sessionDirs = entries
+          .filter((e: any) => e.isDirectory() && e.name.length === 32 && /^[a-f0-9]+$/i.test(e.name))
+          .map((e: any) => e.name)
+
+        if (sessionDirs.length === 0) return null
+
+        const now = new Date()
+        const months: string[] = []
+        for (let i = 0; i < 2; i++) {
+          const d = new Date(now.getFullYear(), now.getMonth() - i, 1)
+          const mStr = `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}`
+          months.push(mStr)
+        }
+
+        const targetNames = [datName]
+        if (baseName !== lowerName) {
+          targetNames.push(`${baseName}.dat`)
+          targetNames.push(`${baseName}_t.dat`)
+          targetNames.push(`${baseName}_thumb.dat`)
+        }
+
+        const batchSize = 20
+        for (let i = 0; i < sessionDirs.length; i += batchSize) {
+          const batch = sessionDirs.slice(i, i + batchSize)
+          const tasks = batch.map(async (sessDir: string) => {
+            for (const month of months) {
+              const subDirs = ['Img', 'Image']
+              for (const sub of subDirs) {
+                const dirPath = join(root, sessDir, month, sub)
+                try { await fs.access(dirPath) } catch { continue }
+                for (const name of targetNames) {
+                  const p = join(dirPath, name)
+                  try { await fs.access(p); return p } catch { }
+                }
+              }
+            }
+            return null
+          })
+          const results = await Promise.all(tasks)
+          const hit = results.find(r => r !== null)
+          if (hit) return hit
+        }
+      } catch { }
+
+    } catch { }
+    return null
+  }
+
+  /**
+   * 在同一目录下查找高清图变体
+   * 缩略图: xxx_t.dat -> 高清图: xxx_h.dat 或 xxx.dat
+   */
+  private findHdVariantInSameDir(thumbPath: string): string | null {
+    try {
+      const dir = dirname(thumbPath)
+      const fileName = basename(thumbPath).toLowerCase()
+
+      // 提取基础名称（去掉 _t.dat 或 .t.dat）
+      let baseName = fileName
+      if (baseName.endsWith('_t.dat')) {
+        baseName = baseName.slice(0, -6)
+      } else if (baseName.endsWith('.t.dat')) {
+        baseName = baseName.slice(0, -6)
+      } else {
+        return null
+      }
+
+      // 尝试查找高清图变体
+      const variants = [
+        `${baseName}_h.dat`,
+        `${baseName}.h.dat`,
+        `${baseName}.dat`
+      ]
+
+      for (const variant of variants) {
+        const variantPath = join(dir, variant)
+        if (existsSync(variantPath)) {
+          return variantPath
+        }
+      }
+    } catch { }
+    return null
+  }
+
   private async searchDatFileInDir(
     dirPath: string,
     datName: string,

electron/services/keyService.ts

@@ -43,6 +43,7 @@ export class KeyService {
   private GetWindowThreadProcessId: any = null
   private IsWindowVisible: any = null
   private EnumChildWindows: any = null
+  private PostMessageW: any = null
   private WNDENUMPROC_PTR: any = null
 
   // Advapi32
@@ -57,6 +58,7 @@ export class KeyService {
   private readonly HKEY_LOCAL_MACHINE = 0x80000002
   private readonly HKEY_CURRENT_USER = 0x80000001
   private readonly ERROR_SUCCESS = 0
+  private readonly WM_CLOSE = 0x0010
 
   private getDllPath(): string {
     const isPackaged = typeof app !== 'undefined' && app ? app.isPackaged : process.env.NODE_ENV === 'production'
@@ -114,13 +116,13 @@ export class KeyService {
 
       // 检查是否已经有本地副本，如果有就使用它
       if (existsSync(localPath)) {
-        console.log(`使用已存在的 DLL 本地副本: ${localPath}`)
+        
         return localPath
       }
 
-      console.log(`检测到网络路径 DLL，正在复制到本地: ${originalPath} -> ${localPath}`)
+      
       copyFileSync(originalPath, localPath)
-      console.log('DLL 本地化成功')
+      
       return localPath
     } catch (e) {
       console.error('DLL 本地化失败:', e)
@@ -144,7 +146,7 @@ export class KeyService {
 
       // 检查是否为网络路径，如果是则本地化
       if (this.isNetworkPath(dllPath)) {
-        console.log('检测到网络路径，将进行本地化处理')
+        
         dllPath = this.localizeNetworkDll(dllPath)
       }
 
@@ -224,6 +226,7 @@ export class KeyService {
 
       this.EnumWindows = this.user32.func('EnumWindows', 'bool', [this.WNDENUMPROC_PTR, 'intptr_t'])
       this.EnumChildWindows = this.user32.func('EnumChildWindows', 'bool', ['void*', this.WNDENUMPROC_PTR, 'intptr_t'])
+      this.PostMessageW = this.user32.func('PostMessageW', 'bool', ['void*', 'uint32', 'uintptr_t', 'intptr_t'])
 
       this.GetWindowTextW = this.user32.func('GetWindowTextW', 'int', ['void*', this.koffi.out('uint16*'), 'int'])
       this.GetWindowTextLengthW = this.user32.func('GetWindowTextLengthW', 'int', ['void*'])
@@ -344,7 +347,7 @@ export class KeyService {
       if (pid) {
         const runPath = await this.getProcessExecutablePath(pid)
         if (runPath && existsSync(runPath)) {
-          console.log('发现正在运行的微信进程，使用路径:', runPath)
+          
           return runPath
         }
       }
@@ -437,16 +440,60 @@ export class KeyService {
     return fallbackPid ?? null
   }
 
-  private async killWeChatProcesses() {
+  private async waitForWeChatExit(timeoutMs = 8000): Promise<boolean> {
+    const start = Date.now()
+    while (Date.now() - start < timeoutMs) {
+      const weixinPid = await this.findPidByImageName('Weixin.exe')
+      const wechatPid = await this.findPidByImageName('WeChat.exe')
+      if (!weixinPid && !wechatPid) return true
+      await new Promise(r => setTimeout(r, 400))
+    }
+    return false
+  }
+
+  private async closeWeChatWindows(): Promise<boolean> {
+    if (!this.ensureUser32()) return false
+    let requested = false
+
+    const enumWindowsCallback = this.koffi.register((hWnd: any, lParam: any) => {
+      if (!this.IsWindowVisible(hWnd)) return true
+      const title = this.getWindowTitle(hWnd)
+      const className = this.getClassName(hWnd)
+      const classLower = (className || '').toLowerCase()
+      const isWeChatWindow = this.isWeChatWindowTitle(title) || classLower.includes('wechat') || classLower.includes('weixin')
+      if (!isWeChatWindow) return true
+
+      requested = true
+      try {
+        this.PostMessageW?.(hWnd, this.WM_CLOSE, 0, 0)
+      } catch { }
+      return true
+    }, this.WNDENUMPROC_PTR)
+
+    this.EnumWindows(enumWindowsCallback, 0)
+    this.koffi.unregister(enumWindowsCallback)
+
+    return requested
+  }
+
+  private async killWeChatProcesses(): Promise<boolean> {
+    const requested = await this.closeWeChatWindows()
+    if (requested) {
+      const gracefulOk = await this.waitForWeChatExit(1500)
+      if (gracefulOk) return true
+    }
+
     try {
-      await execFileAsync('taskkill', ['/F', '/IM', 'Weixin.exe'])
-      await execFileAsync('taskkill', ['/F', '/IM', 'WeChat.exe'])
+      await execFileAsync('taskkill', ['/F', '/T', '/IM', 'Weixin.exe'])
+      await execFileAsync('taskkill', ['/F', '/T', '/IM', 'WeChat.exe'])
     } catch (e) {
       // Ignore if not found
     }
-    await new Promise(r => setTimeout(r, 1000))
+
+    return await this.waitForWeChatExit(5000)
   }
 
+
   // --- Window Detection ---
 
   private getWindowTitle(hWnd: any): string {
@@ -605,15 +652,24 @@ export class KeyService {
     }
 
     // 2. Restart WeChat
-    onStatus?.('正在重启微信以进行获取...', 0)
-    await this.killWeChatProcesses()
+    onStatus?.('正在关闭微信以进行获取...', 0)
+    const closed = await this.killWeChatProcesses()
+    if (!closed) {
+      const err = '无法自动关闭微信，请手动退出后重试'
+      onStatus?.(err, 2)
+      return { success: false, error: err }
+    }
 
-    // 3. Launch
+// 3. Launch
     onStatus?.('正在启动微信...', 0)
-    const sub = spawn(wechatPath, { detached: true, stdio: 'ignore' })
+    const sub = spawn(wechatPath, {
+      detached: true,
+      stdio: 'ignore',
+      cwd: dirname(wechatPath)
+    })
     sub.unref()
 
-    // 4. Wait for Window & Get PID (Crucial change: discover PID from window)
+// 4. Wait for Window & Get PID (Crucial change: discover PID from window)
     onStatus?.('等待微信界面就绪...', 0)
     const pid = await this.waitForWeChatWindow()
     if (!pid) {

electron/services/llamaService.ts

@@ -0,0 +1,371 @@
+import fs from "fs";
+import { app, BrowserWindow } from "electron";
+import path from "path";
+import { ConfigService } from './config';
+
+// Define interfaces locally to avoid static import of types that might not be available or cause issues
+type LlamaModel = any;
+type LlamaContext = any;
+type LlamaChatSession = any;
+
+export class LlamaService {
+    private _model: LlamaModel | null = null;
+    private _context: LlamaContext | null = null;
+    private _sequence: any = null;
+    private _session: LlamaChatSession | null = null;
+    private _llama: any = null;
+    private _nodeLlamaCpp: any = null;
+    private configService = new ConfigService();
+    private _initialized = false;
+
+    constructor() {
+        // 延迟初始化，只在需要时初始化
+    }
+
+    public async init() {
+        if (this._initialized) return;
+        
+        try {
+            // Dynamic import to handle ESM module in CJS context
+            this._nodeLlamaCpp = await import("node-llama-cpp");
+            this._llama = await this._nodeLlamaCpp.getLlama();
+            this._initialized = true;
+            console.log("[LlamaService] Llama initialized");
+        } catch (error) {
+            console.error("[LlamaService] Failed to initialize Llama:", error);
+        }
+    }
+
+    public async loadModel(modelPath: string) {
+        if (!this._llama) await this.init();
+
+        try {
+            console.log("[LlamaService] Loading model from:", modelPath);
+            if (!this._llama) {
+                throw new Error("Llama not initialized");
+            }
+            this._model = await this._llama.loadModel({
+                modelPath: modelPath,
+                gpuLayers: 'max', // Offload all layers to GPU if possible
+                useMlock: false   // Disable mlock to avoid "VirtualLock" errors (common on Windows)
+            });
+
+            if (!this._model) throw new Error("Failed to load model");
+
+            this._context = await this._model.createContext({
+                contextSize: 8192, // Balanced context size for better performance
+                batchSize: 2048    // Increase batch size for better prompt processing speed
+            });
+
+            if (!this._context) throw new Error("Failed to create context");
+
+            this._sequence = this._context.getSequence();
+
+            const { LlamaChatSession } = this._nodeLlamaCpp;
+            this._session = new LlamaChatSession({
+                contextSequence: this._sequence
+            });
+
+            console.log("[LlamaService] Model loaded successfully");
+            return true;
+        } catch (error) {
+            console.error("[LlamaService] Failed to load model:", error);
+            throw error;
+        }
+    }
+
+    public async createSession(systemPrompt?: string) {
+        if (!this._context) throw new Error("Model not loaded");
+        if (!this._nodeLlamaCpp) await this.init();
+
+        const { LlamaChatSession } = this._nodeLlamaCpp;
+
+        if (!this._sequence) {
+            this._sequence = this._context.getSequence();
+        }
+
+        this._session = new LlamaChatSession({
+            contextSequence: this._sequence,
+            systemPrompt: systemPrompt
+        });
+
+        return true;
+    }
+
+    public async chat(message: string, options: { thinking?: boolean } = {}, onToken: (token: string) => void) {
+        if (!this._session) throw new Error("Session not initialized");
+
+        const thinking = options.thinking ?? false;
+
+        // Sampling parameters based on mode
+        const samplingParams = thinking ? {
+            temperature: 0.6,
+            topP: 0.95,
+            topK: 20,
+            repeatPenalty: 1.5 // PresencePenalty=1.5
+        } : {
+            temperature: 0.7,
+            topP: 0.8,
+            topK: 20,
+            repeatPenalty: 1.5
+        };
+
+        try {
+            const response = await this._session.prompt(message, {
+                ...samplingParams,
+                onTextChunk: (chunk: string) => {
+                    onToken(chunk);
+                }
+            });
+            return response;
+        } catch (error) {
+            console.error("[LlamaService] Chat error:", error);
+            throw error;
+        }
+    }
+
+    public async getModelStatus(modelPath: string) {
+        try {
+            const exists = fs.existsSync(modelPath);
+            if (!exists) {
+                return { exists: false, path: modelPath };
+            }
+            const stats = fs.statSync(modelPath);
+            return {
+                exists: true,
+                path: modelPath,
+                size: stats.size
+            };
+        } catch (error) {
+            return { exists: false, error: String(error) };
+        }
+    }
+
+    private resolveModelDir(): string {
+        const configured = this.configService.get('whisperModelDir') as string | undefined;
+        if (configured) return configured;
+        return path.join(app.getPath('documents'), 'WeFlow', 'models');
+    }
+
+    public async downloadModel(url: string, savePath: string, onProgress: (payload: { downloaded: number; total: number; speed: number }) => void): Promise<void> {
+        // Ensure directory exists
+        const dir = path.dirname(savePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+
+        console.info(`[LlamaService] Multi-threaded download check for: ${savePath}`);
+
+        if (fs.existsSync(savePath)) {
+            fs.unlinkSync(savePath);
+        }
+
+        // 1. Get total size and check range support
+        let probeResult;
+        try {
+            probeResult = await this.probeUrl(url);
+        } catch (err) {
+            console.warn("[LlamaService] Probe failed, falling back to single-thread.", err);
+            return this.downloadSingleThread(url, savePath, onProgress);
+        }
+
+        const { totalSize, acceptRanges, finalUrl } = probeResult;
+        console.log(`[LlamaService] Total size: ${totalSize}, Accept-Ranges: ${acceptRanges}`);
+
+        if (totalSize <= 0 || !acceptRanges) {
+            console.warn("[LlamaService] Ranges not supported or size unknown, falling back to single-thread.");
+            return this.downloadSingleThread(finalUrl, savePath, onProgress);
+        }
+
+        const threadCount = 4;
+        const chunkSize = Math.ceil(totalSize / threadCount);
+        const fd = fs.openSync(savePath, 'w');
+
+        let downloadedLength = 0;
+        let lastDownloadedLength = 0;
+        let lastTime = Date.now();
+        let speed = 0;
+
+        const speedInterval = setInterval(() => {
+            const now = Date.now();
+            const duration = (now - lastTime) / 1000;
+            if (duration > 0) {
+                speed = (downloadedLength - lastDownloadedLength) / duration;
+                lastDownloadedLength = downloadedLength;
+                lastTime = now;
+                onProgress({ downloaded: downloadedLength, total: totalSize, speed });
+            }
+        }, 1000);
+
+        try {
+            const promises = [];
+            for (let i = 0; i < threadCount; i++) {
+                const start = i * chunkSize;
+                const end = i === threadCount - 1 ? totalSize - 1 : (i + 1) * chunkSize - 1;
+
+                promises.push(this.downloadChunk(finalUrl, fd, start, end, (bytes) => {
+                    downloadedLength += bytes;
+                }));
+            }
+
+            await Promise.all(promises);
+            console.log("[LlamaService] Multi-threaded download complete");
+
+            // Final progress update
+            onProgress({ downloaded: totalSize, total: totalSize, speed: 0 });
+        } catch (err) {
+            console.error("[LlamaService] Multi-threaded download failed:", err);
+            throw err;
+        } finally {
+            clearInterval(speedInterval);
+            fs.closeSync(fd);
+        }
+    }
+
+    private async probeUrl(url: string): Promise<{ totalSize: number, acceptRanges: boolean, finalUrl: string }> {
+        const protocol = url.startsWith('https') ? require('https') : require('http');
+        const options = {
+            method: 'GET',
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                'Referer': 'https://www.modelscope.cn/',
+                'Range': 'bytes=0-0'
+            }
+        };
+
+        return new Promise((resolve, reject) => {
+            const req = protocol.get(url, options, (res: any) => {
+                if ([301, 302, 307, 308].includes(res.statusCode)) {
+                    const location = res.headers.location;
+                    const nextUrl = new URL(location, url).href;
+                    this.probeUrl(nextUrl).then(resolve).catch(reject);
+                    return;
+                }
+
+                if (res.statusCode !== 206 && res.statusCode !== 200) {
+                    reject(new Error(`Probe failed: HTTP ${res.statusCode}`));
+                    return;
+                }
+
+                const contentRange = res.headers['content-range'];
+                let totalSize = 0;
+                if (contentRange) {
+                    const parts = contentRange.split('/');
+                    totalSize = parseInt(parts[parts.length - 1], 10);
+                } else {
+                    totalSize = parseInt(res.headers['content-length'] || '0', 10);
+                }
+
+                const acceptRanges = res.headers['accept-ranges'] === 'bytes' || !!contentRange;
+                resolve({ totalSize, acceptRanges, finalUrl: url });
+                res.destroy();
+            });
+            req.on('error', reject);
+        });
+    }
+
+    private async downloadChunk(url: string, fd: number, start: number, end: number, onData: (bytes: number) => void): Promise<void> {
+        const protocol = url.startsWith('https') ? require('https') : require('http');
+        const options = {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                'Referer': 'https://www.modelscope.cn/',
+                'Range': `bytes=${start}-${end}`
+            }
+        };
+
+        return new Promise((resolve, reject) => {
+            const req = protocol.get(url, options, (res: any) => {
+                if (res.statusCode !== 206) {
+                    reject(new Error(`Chunk download failed: HTTP ${res.statusCode}`));
+                    return;
+                }
+
+                let currentOffset = start;
+                res.on('data', (chunk: Buffer) => {
+                    try {
+                        fs.writeSync(fd, chunk, 0, chunk.length, currentOffset);
+                        currentOffset += chunk.length;
+                        onData(chunk.length);
+                    } catch (err) {
+                        reject(err);
+                        res.destroy();
+                    }
+                });
+
+                res.on('end', () => resolve());
+                res.on('error', reject);
+            });
+            req.on('error', reject);
+        });
+    }
+
+    private async downloadSingleThread(url: string, savePath: string, onProgress: (payload: { downloaded: number; total: number; speed: number }) => void): Promise<void> {
+        return new Promise((resolve, reject) => {
+            const protocol = url.startsWith('https') ? require('https') : require('http');
+            const options = {
+                headers: {
+                    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                    'Referer': 'https://www.modelscope.cn/'
+                }
+            };
+
+            const request = protocol.get(url, options, (response: any) => {
+                if ([301, 302, 307, 308].includes(response.statusCode)) {
+                    const location = response.headers.location;
+                    const nextUrl = new URL(location, url).href;
+                    this.downloadSingleThread(nextUrl, savePath, onProgress).then(resolve).catch(reject);
+                    return;
+                }
+
+                if (response.statusCode !== 200) {
+                    reject(new Error(`Fallback download failed: HTTP ${response.statusCode}`));
+                    return;
+                }
+
+                const totalLength = parseInt(response.headers['content-length'] || '0', 10);
+                let downloadedLength = 0;
+                let lastDownloadedLength = 0;
+                let lastTime = Date.now();
+                let speed = 0;
+
+                const fileStream = fs.createWriteStream(savePath);
+                response.pipe(fileStream);
+
+                const speedInterval = setInterval(() => {
+                    const now = Date.now();
+                    const duration = (now - lastTime) / 1000;
+                    if (duration > 0) {
+                        speed = (downloadedLength - lastDownloadedLength) / duration;
+                        lastDownloadedLength = downloadedLength;
+                        lastTime = now;
+                        onProgress({ downloaded: downloadedLength, total: totalLength, speed });
+                    }
+                }, 1000);
+
+                response.on('data', (chunk: any) => {
+                    downloadedLength += chunk.length;
+                });
+
+                fileStream.on('finish', () => {
+                    clearInterval(speedInterval);
+                    fileStream.close();
+                    resolve();
+                });
+
+                fileStream.on('error', (err: any) => {
+                    clearInterval(speedInterval);
+                    fs.unlink(savePath, () => { });
+                    reject(err);
+                });
+            });
+            request.on('error', reject);
+        });
+    }
+
+    public getModelsPath() {
+        return this.resolveModelDir();
+    }
+}
+
+export const llamaService = new LlamaService();

electron/services/snsService.ts

@@ -57,15 +57,11 @@ class SnsService {
     }
 
     async getTimeline(limit: number = 20, offset: number = 0, usernames?: string[], keyword?: string, startTime?: number, endTime?: number): Promise<{ success: boolean; timeline?: SnsPost[]; error?: string }> {
-        console.log('[SnsService] getTimeline called with:', { limit, offset, usernames, keyword, startTime, endTime })
+        
 
         const result = await wcdbService.getSnsTimeline(limit, offset, usernames, keyword, startTime, endTime)
 
-        console.log('[SnsService] getSnsTimeline result:', {
-            success: result.success,
-            timelineCount: result.timeline?.length,
-            error: result.error
-        })
+        
 
         if (result.success && result.timeline) {
             const enrichedTimeline = result.timeline.map((post: any, index: number) => {
@@ -121,11 +117,11 @@ class SnsService {
                 }
             })
 
-            console.log('[SnsService] Returning enriched timeline with', enrichedTimeline.length, 'posts')
+            
             return { ...result, timeline: enrichedTimeline }
         }
 
-        console.log('[SnsService] Returning result:', result)
+        
         return result
     }
     async debugResource(url: string): Promise<{ success: boolean; status?: number; headers?: any; error?: string }> {

electron/services/videoService.ts

@@ -97,7 +97,7 @@ class VideoService {
                             return realMd5
                         }
                     } catch (e) {
-                        // Silently fail
+                        // 忽略错误
                     }
                 }
             }
@@ -105,10 +105,21 @@ class VideoService {
 
         // 方法2：使用 wcdbService.execQuery 查询加密的 hardlink.db
         if (dbPath) {
-            const encryptedDbPaths = [
-                join(dbPath, wxid, 'db_storage', 'hardlink', 'hardlink.db'),
-                join(dbPath, cleanedWxid, 'db_storage', 'hardlink', 'hardlink.db')
-            ]
+            // 检查 dbPath 是否已经包含 wxid
+            const dbPathLower = dbPath.toLowerCase()
+            const wxidLower = wxid.toLowerCase()
+            const cleanedWxidLower = cleanedWxid.toLowerCase()
+            const dbPathContainsWxid = dbPathLower.includes(wxidLower) || dbPathLower.includes(cleanedWxidLower)
+            
+            const encryptedDbPaths: string[] = []
+            if (dbPathContainsWxid) {
+                // dbPath 已包含 wxid，不需要再拼接
+                encryptedDbPaths.push(join(dbPath, 'db_storage', 'hardlink', 'hardlink.db'))
+            } else {
+                // dbPath 不包含 wxid，需要拼接
+                encryptedDbPaths.push(join(dbPath, wxid, 'db_storage', 'hardlink', 'hardlink.db'))
+                encryptedDbPaths.push(join(dbPath, cleanedWxid, 'db_storage', 'hardlink', 'hardlink.db'))
+            }
             
             for (const p of encryptedDbPaths) {
                 if (existsSync(p)) {
@@ -129,6 +140,7 @@ class VideoService {
                             }
                         }
                     } catch (e) {
+                        // 忽略错误
                     }
                 }
             }
@@ -155,7 +167,6 @@ class VideoService {
      * 文件命名: {md5}.mp4, {md5}.jpg, {md5}_thumb.jpg
      */
     async getVideoInfo(videoMd5: string): Promise<VideoInfo> {
-
         const dbPath = this.getDbPath()
         const wxid = this.getMyWxid()
 
@@ -166,7 +177,19 @@ class VideoService {
         // 先尝试从数据库查询真正的视频文件名
         const realVideoMd5 = await this.queryVideoFileName(videoMd5) || videoMd5
 
-        const videoBaseDir = join(dbPath, wxid, 'msg', 'video')
+        // 检查 dbPath 是否已经包含 wxid，避免重复拼接
+        const dbPathLower = dbPath.toLowerCase()
+        const wxidLower = wxid.toLowerCase()
+        const cleanedWxid = this.cleanWxid(wxid)
+        
+        let videoBaseDir: string
+        if (dbPathLower.includes(wxidLower) || dbPathLower.includes(cleanedWxid.toLowerCase())) {
+            // dbPath 已经包含 wxid，直接使用
+            videoBaseDir = join(dbPath, 'msg', 'video')
+        } else {
+            // dbPath 不包含 wxid，需要拼接
+            videoBaseDir = join(dbPath, wxid, 'msg', 'video')
+        }
 
         if (!existsSync(videoBaseDir)) {
             return { exists: false }
@@ -202,7 +225,7 @@ class VideoService {
                 }
             }
         } catch (e) {
-            console.error('[VideoService] Error searching for video:', e)
+            // 忽略错误
         }
 
         return { exists: false }

electron/services/voiceTranscribeService.ts

@@ -1,5 +1,5 @@
 import { app } from 'electron'
-import { existsSync, mkdirSync, statSync, unlinkSync, createWriteStream } from 'fs'
+import { existsSync, mkdirSync, statSync, unlinkSync, createWriteStream, openSync, writeSync, closeSync } from 'fs'
 import { join } from 'path'
 import * as https from 'https'
 import * as http from 'http'
@@ -24,6 +24,7 @@ type DownloadProgress = {
   downloadedBytes: number
   totalBytes?: number
   percent?: number
+  speed?: number
 }
 
 const SENSEVOICE_MODEL: ModelInfo = {
@@ -123,44 +124,44 @@ export class VoiceTranscribeService {
           percent: 0
         })
 
-        // 下载模型文件 (40%)
+        // 下载模型文件 (80% 权重)
         console.info('[VoiceTranscribe] 开始下载模型文件...')
         await this.downloadToFile(
           MODEL_DOWNLOAD_URLS.model,
           modelPath,
           'model',
-          (downloaded, total) => {
-            const percent = total ? (downloaded / total) * 40 : undefined
+          (downloaded, total, speed) => {
+            const percent = total ? (downloaded / total) * 80 : 0
             onProgress?.({
               modelName: SENSEVOICE_MODEL.name,
               downloadedBytes: downloaded,
               totalBytes: SENSEVOICE_MODEL.sizeBytes,
-              percent
+              percent,
+              speed
             })
           }
         )
 
-        // 下载 tokens 文件 (30%)
+        // 下载 tokens 文件 (20% 权重)
         console.info('[VoiceTranscribe] 开始下载 tokens 文件...')
         await this.downloadToFile(
           MODEL_DOWNLOAD_URLS.tokens,
           tokensPath,
           'tokens',
-          (downloaded, total) => {
+          (downloaded, total, speed) => {
             const modelSize = existsSync(modelPath) ? statSync(modelPath).size : 0
-            const percent = total ? 40 + (downloaded / total) * 30 : 40
+            const percent = total ? 80 + (downloaded / total) * 20 : 80
             onProgress?.({
               modelName: SENSEVOICE_MODEL.name,
               downloadedBytes: modelSize + downloaded,
               totalBytes: SENSEVOICE_MODEL.sizeBytes,
-              percent
+              percent,
+              speed
             })
           }
         )
 
         console.info('[VoiceTranscribe] 模型下载完成')
-
-        console.info('[VoiceTranscribe] 所有文件下载完成')
         return { success: true, modelPath, tokensPath }
       } catch (error) {
         const modelPath = this.resolveModelPath(SENSEVOICE_MODEL.files.model)
@@ -180,7 +181,7 @@ export class VoiceTranscribeService {
   }
 
   /**
-   * 转写 WAV 音频数据 (后台 Worker Threads 版本)
+   * 转写 WAV 音频数据
    */
   async transcribeWavBuffer(
     wavData: Buffer,
@@ -197,18 +198,15 @@ export class VoiceTranscribeService {
           return
         }
 
-        // 获取配置的语言列表，如果没有传入则从配置读取
         let supportedLanguages = languages
         if (!supportedLanguages || supportedLanguages.length === 0) {
           supportedLanguages = this.configService.get('transcribeLanguages')
-          // 如果配置中也没有或为空，使用默认值
           if (!supportedLanguages || supportedLanguages.length === 0) {
             supportedLanguages = ['zh', 'yue']
           }
         }
 
         const { Worker } = require('worker_threads')
-        // main.js 和 transcribeWorker.js 同在 dist-electron 目录下
         const workerPath = join(__dirname, 'transcribeWorker.js')
 
         const worker = new Worker(workerPath, {
@@ -224,12 +222,10 @@ export class VoiceTranscribeService {
         let finalTranscript = ''
 
         worker.on('message', (msg: any) => {
-          console.log('[VoiceTranscribe] Worker 消息:', msg)
           if (msg.type === 'partial') {
             onPartial?.(msg.text)
           } else if (msg.type === 'final') {
             finalTranscript = msg.text
-            console.log('[VoiceTranscribe] 最终文本:', finalTranscript)
             resolve({ success: true, transcript: finalTranscript })
             worker.terminate()
           } else if (msg.type === 'error') {
@@ -239,15 +235,9 @@ export class VoiceTranscribeService {
           }
         })
 
-        worker.on('error', (err: Error) => {
-          resolve({ success: false, error: String(err) })
-        })
-
+        worker.on('error', (err: Error) => resolve({ success: false, error: String(err) }))
         worker.on('exit', (code: number) => {
-          if (code !== 0) {
-            console.error(`[VoiceTranscribe] Worker stopped with exit code ${code}`)
-            resolve({ success: false, error: `Worker exited with code ${code}` })
-          }
+          if (code !== 0) resolve({ success: false, error: `Worker exited with code ${code}` })
         })
 
       } catch (error) {
@@ -257,121 +247,230 @@ export class VoiceTranscribeService {
   }
 
   /**
-   * 下载文件
+   * 下载文件 (支持多线程)
    */
-  private downloadToFile(
+  private async downloadToFile(
     url: string,
     targetPath: string,
     fileName: string,
-    onProgress?: (downloaded: number, total?: number) => void,
-    remainingRedirects = 5
+    onProgress?: (downloaded: number, total?: number, speed?: number) => void
   ): Promise<void> {
-    return new Promise((resolve, reject) => {
-      const protocol = url.startsWith('https') ? https : http
-      console.info(`[VoiceTranscribe] 下载 ${fileName}:`, url)
+    if (existsSync(targetPath)) {
+      unlinkSync(targetPath)
+    }
 
-      const options = {
-        headers: {
-          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'
-        },
-        timeout: 30000 // 30秒连接超时
+    console.info(`[VoiceTranscribe] 准备下载 ${fileName}: ${url}`)
+
+    // 1. 探测支持情况
+    let probeResult
+    try {
+      probeResult = await this.probeUrl(url)
+    } catch (err) {
+      console.warn(`[VoiceTranscribe] ${fileName} 探测失败，使用单线程`, err)
+      return this.downloadSingleThread(url, targetPath, fileName, onProgress)
+    }
+
+    const { totalSize, acceptRanges, finalUrl } = probeResult
+
+    // 如果文件太小 (< 2MB) 或者不支持 Range，使用单线程
+    if (totalSize < 2 * 1024 * 1024 || !acceptRanges) {
+      return this.downloadSingleThread(finalUrl, targetPath, fileName, onProgress)
+    }
+
+    console.info(`[VoiceTranscribe] ${fileName} 开始多线程下载 (4 线程), 大小: ${(totalSize / 1024 / 1024).toFixed(2)} MB`)
+
+    const threadCount = 4
+    const chunkSize = Math.ceil(totalSize / threadCount)
+    const fd = openSync(targetPath, 'w')
+
+    let downloadedTotal = 0
+    let lastDownloaded = 0
+    let lastTime = Date.now()
+    let speed = 0
+
+    const speedInterval = setInterval(() => {
+      const now = Date.now()
+      const duration = (now - lastTime) / 1000
+      if (duration > 0) {
+        speed = (downloadedTotal - lastDownloaded) / duration
+        lastDownloaded = downloadedTotal
+        lastTime = now
+        onProgress?.(downloadedTotal, totalSize, speed)
+      }
+    }, 1000)
+
+    try {
+      const promises = []
+      for (let i = 0; i < threadCount; i++) {
+        const start = i * chunkSize
+        const end = i === threadCount - 1 ? totalSize - 1 : (i + 1) * chunkSize - 1
+
+        promises.push(this.downloadChunk(finalUrl, fd, start, end, (bytes) => {
+          downloadedTotal += bytes
+        }))
       }
 
-      const request = protocol.get(url, options, (response) => {
-        console.info(`[VoiceTranscribe] ${fileName} 响应状态:`, response.statusCode)
+      await Promise.all(promises)
+      // Final progress update
+      onProgress?.(totalSize, totalSize, 0)
+      console.info(`[VoiceTranscribe] ${fileName} 多线程下载完成`)
+    } catch (err) {
+      console.error(`[VoiceTranscribe] ${fileName} 多线程下载失败:`, err)
+      throw err
+    } finally {
+      clearInterval(speedInterval)
+      closeSync(fd)
+    }
+  }
 
-        // 处理重定向
-        if ([301, 302, 303, 307, 308].includes(response.statusCode || 0) && response.headers.location) {
-          if (remainingRedirects <= 0) {
-            reject(new Error('重定向次数过多'))
+  private async probeUrl(url: string, remainingRedirects = 5): Promise<{ totalSize: number, acceptRanges: boolean, finalUrl: string }> {
+    return new Promise((resolve, reject) => {
+      const protocol = url.startsWith('https') ? https : http
+      const options = {
+        method: 'GET',
+        headers: {
+          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+          'Referer': 'https://modelscope.cn/',
+          'Range': 'bytes=0-0'
+        }
+      }
+
+      const req = protocol.get(url, options, (res) => {
+        if ([301, 302, 303, 307, 308].includes(res.statusCode || 0)) {
+          const location = res.headers.location
+          if (location && remainingRedirects > 0) {
+            const nextUrl = new URL(location, url).href
+            this.probeUrl(nextUrl, remainingRedirects - 1).then(resolve).catch(reject)
             return
           }
-          console.info(`[VoiceTranscribe] 重定向到:`, response.headers.location)
-          this.downloadToFile(response.headers.location, targetPath, fileName, onProgress, remainingRedirects - 1)
-            .then(resolve)
-            .catch(reject)
+        }
+
+        if (res.statusCode !== 206 && res.statusCode !== 200) {
+          reject(new Error(`Probe failed: HTTP ${res.statusCode}`))
           return
         }
 
+        const contentRange = res.headers['content-range']
+        let totalSize = 0
+        if (contentRange) {
+          const parts = contentRange.split('/')
+          totalSize = parseInt(parts[parts.length - 1], 10)
+        } else {
+          totalSize = parseInt(res.headers['content-length'] || '0', 10)
+        }
+
+        const acceptRanges = res.headers['accept-ranges'] === 'bytes' || !!contentRange
+        resolve({ totalSize, acceptRanges, finalUrl: url })
+        res.destroy()
+      })
+      req.on('error', reject)
+    })
+  }
+
+  private async downloadChunk(url: string, fd: number, start: number, end: number, onData: (bytes: number) => void): Promise<void> {
+    return new Promise((resolve, reject) => {
+      const protocol = url.startsWith('https') ? https : http
+      const options = {
+        headers: {
+          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+          'Referer': 'https://modelscope.cn/',
+          'Range': `bytes=${start}-${end}`
+        }
+      }
+
+      const req = protocol.get(url, options, (res) => {
+        if (res.statusCode !== 206) {
+          reject(new Error(`Chunk download failed: HTTP ${res.statusCode}`))
+          return
+        }
+
+        let currentOffset = start
+        res.on('data', (chunk: Buffer) => {
+          try {
+            writeSync(fd, chunk, 0, chunk.length, currentOffset)
+            currentOffset += chunk.length
+            onData(chunk.length)
+          } catch (err) {
+            reject(err)
+            res.destroy()
+          }
+        })
+
+        res.on('end', () => resolve())
+        res.on('error', reject)
+      })
+      req.on('error', reject)
+    })
+  }
+
+  private async downloadSingleThread(url: string, targetPath: string, fileName: string, onProgress?: (downloaded: number, total?: number, speed?: number) => void, remainingRedirects = 5): Promise<void> {
+    return new Promise((resolve, reject) => {
+      const protocol = url.startsWith('https') ? https : http
+      const options = {
+        headers: {
+          'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+          'Referer': 'https://modelscope.cn/'
+        }
+      }
+
+      const request = protocol.get(url, options, (response) => {
+        if ([301, 302, 303, 307, 308].includes(response.statusCode || 0)) {
+          const location = response.headers.location
+          if (location && remainingRedirects > 0) {
+            const nextUrl = new URL(location, url).href
+            this.downloadSingleThread(nextUrl, targetPath, fileName, onProgress, remainingRedirects - 1).then(resolve).catch(reject)
+            return
+          }
+        }
+
         if (response.statusCode !== 200) {
-          reject(new Error(`下载失败: HTTP ${response.statusCode}`))
+          reject(new Error(`Fallback download failed: HTTP ${response.statusCode}`))
           return
         }
 
         const totalBytes = Number(response.headers['content-length'] || 0) || undefined
         let downloadedBytes = 0
+        let lastDownloaded = 0
+        let lastTime = Date.now()
+        let speed = 0
 
-        console.info(`[VoiceTranscribe] ${fileName} 文件大小:`, totalBytes ? `${(totalBytes / 1024 / 1024).toFixed(2)} MB` : '未知')
+        const speedInterval = setInterval(() => {
+          const now = Date.now()
+          const duration = (now - lastTime) / 1000
+          if (duration > 0) {
+            speed = (downloadedBytes - lastDownloaded) / duration
+            lastDownloaded = downloadedBytes
+            lastTime = now
+            onProgress?.(downloadedBytes, totalBytes, speed)
+          }
+        }, 1000)
 
         const writer = createWriteStream(targetPath)
-
-        // 设置数据接收超时（60秒没有数据则超时）
-        let lastDataTime = Date.now()
-        const dataTimeout = setInterval(() => {
-          if (Date.now() - lastDataTime > 60000) {
-            clearInterval(dataTimeout)
-            response.destroy()
-            writer.close()
-            reject(new Error('下载超时：60秒内未收到数据'))
-          }
-        }, 5000)
-
         response.on('data', (chunk) => {
-          lastDataTime = Date.now()
           downloadedBytes += chunk.length
-          onProgress?.(downloadedBytes, totalBytes)
-        })
-
-        response.on('error', (error) => {
-          clearInterval(dataTimeout)
-          try { writer.close() } catch { }
-          console.error(`[VoiceTranscribe] ${fileName} 响应错误:`, error)
-          reject(error)
-        })
-
-        writer.on('error', (error) => {
-          clearInterval(dataTimeout)
-          try { writer.close() } catch { }
-          console.error(`[VoiceTranscribe] ${fileName} 写入错误:`, error)
-          reject(error)
         })
 
         writer.on('finish', () => {
-          clearInterval(dataTimeout)
+          clearInterval(speedInterval)
           writer.close()
-          console.info(`[VoiceTranscribe] ${fileName} 下载完成:`, targetPath)
           resolve()
         })
 
+        writer.on('error', (err) => {
+          clearInterval(speedInterval)
+          reject(err)
+        })
         response.pipe(writer)
       })
-
-      request.on('timeout', () => {
-        request.destroy()
-        console.error(`[VoiceTranscribe] ${fileName} 连接超时`)
-        reject(new Error('连接超时'))
-      })
-
-      request.on('error', (error) => {
-        console.error(`[VoiceTranscribe] ${fileName} 请求错误:`, error)
-        reject(error)
-      })
+      request.on('error', reject)
     })
   }
 
-  /**
-   * 清理资源
-   */
   dispose() {
     if (this.recognizer) {
-      try {
-        // sherpa-onnx 的 recognizer 可能需要手动释放
-        this.recognizer = null
-      } catch (error) {
-      }
+      this.recognizer = null
     }
   }
 }
 
 export const voiceTranscribeService = new VoiceTranscribeService()
-

electron/services/wcdbCore.ts

@@ -35,6 +35,7 @@ export class WcdbCore {
   private wcdbGetGroupMemberCount: any = null
   private wcdbGetGroupMemberCounts: any = null
   private wcdbGetGroupMembers: any = null
+  private wcdbGetGroupNicknames: any = null
   private wcdbGetMessageTables: any = null
   private wcdbGetMessageMeta: any = null
   private wcdbGetContact: any = null
@@ -43,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
@@ -57,7 +60,12 @@ export class WcdbCore {
   private wcdbGetDbStatus: any = null
   private wcdbGetVoiceData: any = null
   private wcdbGetSnsTimeline: any = null
+  private wcdbGetSnsAnnualStats: any = null
   private wcdbVerifyUser: any = null
+  private wcdbStartMonitorPipe: any = null
+  private wcdbStopMonitorPipe: any = null
+  private monitorPipeClient: any = null
+
   private avatarUrlCache: Map<string, { url?: string; updatedAt: number }> = new Map()
   private readonly avatarCacheTtlMs = 10 * 60 * 1000
   private logTimer: NodeJS.Timeout | null = null
@@ -77,6 +85,80 @@ export class WcdbCore {
     }
   }
 
+  // 使用命名管道 IPC
+  startMonitor(callback: (type: string, json: string) => void): boolean {
+    if (!this.wcdbStartMonitorPipe) {
+      this.writeLog('startMonitor: wcdbStartMonitorPipe not available')
+      return false
+    }
+
+    try {
+      const result = this.wcdbStartMonitorPipe()
+      if (result !== 0) {
+        this.writeLog(`startMonitor: wcdbStartMonitorPipe failed with ${result}`)
+        return false
+      }
+
+      const net = require('net')
+      const PIPE_PATH = '\\\\.\\pipe\\weflow_monitor'
+
+      setTimeout(() => {
+        this.monitorPipeClient = net.createConnection(PIPE_PATH, () => {
+          this.writeLog('Monitor pipe connected')
+        })
+
+        let buffer = ''
+        this.monitorPipeClient.on('data', (data: Buffer) => {
+          buffer += data.toString('utf8')
+          const lines = buffer.split('\n')
+          buffer = lines.pop() || ''
+          for (const line of lines) {
+            if (line.trim()) {
+              try {
+                const parsed = JSON.parse(line)
+                callback(parsed.action || 'update', line)
+              } catch {
+                callback('update', line)
+              }
+            }
+          }
+        })
+
+        this.monitorPipeClient.on('error', (err: Error) => {
+          this.writeLog(`Monitor pipe error: ${err.message}`)
+        })
+
+        this.monitorPipeClient.on('close', () => {
+          this.writeLog('Monitor pipe closed')
+          this.monitorPipeClient = null
+        })
+      }, 100)
+
+      this.writeLog('Monitor started via named pipe IPC')
+      return true
+    } catch (e) {
+      console.error('startMonitor failed:', e)
+      return false
+    }
+  }
+
+  stopMonitor(): void {
+    if (this.monitorPipeClient) {
+      this.monitorPipeClient.destroy()
+      this.monitorPipeClient = null
+    }
+    if (this.wcdbStopMonitorPipe) {
+      this.wcdbStopMonitorPipe()
+    }
+  }
+
+  // 保留旧方法签名以兼容
+  setMonitor(callback: (type: string, json: string) => void): boolean {
+    return this.startMonitor(callback)
+  }
+
+
+
   /**
    * 获取 DLL 路径
    */
@@ -111,7 +193,7 @@ export class WcdbCore {
   }
 
   private isLogEnabled(): boolean {
-    if (process.env.WEFLOW_WORKER === '1') return false
+    // 移除 Worker 线程的日志禁用逻辑，允许在 Worker 中记录日志
     if (process.env.WCDB_LOG_ENABLED === '1') return true
     return this.logEnabled
   }
@@ -120,7 +202,7 @@ export class WcdbCore {
     if (!force && !this.isLogEnabled()) return
     const line = `[${new Date().toISOString()}] ${message}`
     // 同时输出到控制台和文件
-    console.log('[WCDB]', message)
+
     try {
       const base = this.userDataPath || process.env.WCDB_LOG_DIR || process.cwd()
       const dir = join(base, 'logs')
@@ -218,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)) {
@@ -260,10 +339,10 @@ export class WcdbCore {
         let protectionOk = false
         for (const resPath of resourcePaths) {
           try {
-            // console.log(`[WCDB] 尝试 InitProtection: ${resPath}`)
+            // 
             protectionOk = this.wcdbInitProtection(resPath)
             if (protectionOk) {
-              // console.log(`[WCDB] InitProtection 成功: ${resPath}`)
+              // 
               break
             }
           } catch (e) {
@@ -333,6 +412,13 @@ export class WcdbCore {
       // wcdb_status wcdb_get_group_members(wcdb_handle handle, const char* chatroom_id, char** out_json)
       this.wcdbGetGroupMembers = this.lib.func('int32 wcdb_get_group_members(int64 handle, const char* chatroomId, _Out_ void** outJson)')
 
+      // wcdb_status wcdb_get_group_nicknames(wcdb_handle handle, const char* chatroom_id, char** out_json)
+      try {
+        this.wcdbGetGroupNicknames = this.lib.func('int32 wcdb_get_group_nicknames(int64 handle, const char* chatroomId, _Out_ void** outJson)')
+      } catch {
+        this.wcdbGetGroupNicknames = null
+      }
+
       // wcdb_status wcdb_get_message_tables(wcdb_handle handle, const char* session_id, char** out_json)
       this.wcdbGetMessageTables = this.lib.func('int32 wcdb_get_message_tables(int64 handle, const char* sessionId, _Out_ void** outJson)')
 
@@ -369,6 +455,20 @@ 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)')
+      } catch {
+        this.wcdbGetLogs = null
+      }
+
       // wcdb_status wcdb_get_group_stats(wcdb_handle handle, const char* chatroom_id, int32_t begin_timestamp, int32_t end_timestamp, char** out_json)
       try {
         this.wcdbGetGroupStats = this.lib.func('int32 wcdb_get_group_stats(int64 handle, const char* chatroomId, int32 begin, int32 end, _Out_ void** outJson)')
@@ -376,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)')
 
@@ -431,6 +538,24 @@ export class WcdbCore {
         this.wcdbGetSnsTimeline = null
       }
 
+      // wcdb_status wcdb_get_sns_annual_stats(wcdb_handle handle, int32_t begin_timestamp, int32_t end_timestamp, char** out_json)
+      try {
+        this.wcdbGetSnsAnnualStats = this.lib.func('int32 wcdb_get_sns_annual_stats(int64 handle, int32 begin, int32 end, _Out_ void** outJson)')
+      } catch {
+        this.wcdbGetSnsAnnualStats = null
+      }
+
+      // Named pipe IPC for monitoring (replaces callback)
+      try {
+        this.wcdbStartMonitorPipe = this.lib.func('int32 wcdb_start_monitor_pipe()')
+        this.wcdbStopMonitorPipe = this.lib.func('void wcdb_stop_monitor_pipe()')
+        this.writeLog('Monitor pipe functions loaded')
+      } catch (e) {
+        console.warn('Failed to load monitor pipe functions:', e)
+        this.wcdbStartMonitorPipe = null
+        this.wcdbStopMonitorPipe = null
+      }
+
       // void VerifyUser(int64_t hwnd_ptr, const char* message, char* out_result, int max_len)
       try {
         this.wcdbVerifyUser = this.lib.func('void VerifyUser(int64 hwnd, const char* message, _Out_ char* outResult, int maxLen)')
@@ -831,6 +956,37 @@ export class WcdbCore {
     }
   }
 
+  /**
+   * 获取指定时间之后的新消息
+   */
+  async getNewMessages(sessionId: string, minTime: number, limit: number = 1000): Promise<{ success: boolean; messages?: any[]; error?: string }> {
+    if (!this.ensureReady()) {
+      return { success: false, error: 'WCDB 未连接' }
+    }
+    try {
+      // 1. 打开游标 (使用 Ascending=1 从指定时间往后查)
+      const openRes = await this.openMessageCursorLite(sessionId, limit, true, minTime, 0)
+      if (!openRes.success || !openRes.cursor) {
+        return { success: false, error: openRes.error }
+      }
+
+      const cursor = openRes.cursor
+      try {
+        // 2. 获取批次
+        const fetchRes = await this.fetchMessageBatch(cursor)
+        if (!fetchRes.success) {
+          return { success: false, error: fetchRes.error }
+        }
+        return { success: true, messages: fetchRes.rows }
+      } finally {
+        // 3. 关闭游标
+        await this.closeMessageCursor(cursor)
+      }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
+
   async getMessageCount(sessionId: string): Promise<{ success: boolean; count?: number; error?: string }> {
     if (!this.ensureReady()) {
       return { success: false, error: 'WCDB 未连接' }
@@ -1002,6 +1158,28 @@ export class WcdbCore {
     }
   }
 
+  async getGroupNicknames(chatroomId: string): Promise<{ success: boolean; nicknames?: Record<string, string>; error?: string }> {
+    if (!this.ensureReady()) {
+      return { success: false, error: 'WCDB 未连接' }
+    }
+    if (!this.wcdbGetGroupNicknames) {
+      return { success: false, error: '当前 DLL 版本不支持获取群昵称接口' }
+    }
+    try {
+      const outPtr = [null as any]
+      const result = this.wcdbGetGroupNicknames(this.handle, chatroomId, outPtr)
+      if (result !== 0 || !outPtr[0]) {
+        return { success: false, error: `获取群昵称失败: ${result}` }
+      }
+      const jsonStr = this.decodeJsonPtr(outPtr[0])
+      if (!jsonStr) return { success: false, error: '解析群昵称失败' }
+      const nicknames = JSON.parse(jsonStr)
+      return { success: true, nicknames }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
+
   async getMessageTables(sessionId: string): Promise<{ success: boolean; tables?: any[]; error?: string }> {
     if (!this.ensureReady()) {
       return { success: false, error: 'WCDB 未连接' }
@@ -1021,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 未连接' }
@@ -1343,13 +1544,31 @@ export class WcdbCore {
     }
   }
 
+  async getLogs(): Promise<{ success: boolean; logs?: string[]; error?: string }> {
+    if (!this.lib) return { success: false, error: 'DLL 未加载' }
+    if (!this.wcdbGetLogs) return { success: false, error: '接口未就绪' }
+    try {
+      const outPtr = [null as any]
+      const result = this.wcdbGetLogs(outPtr)
+      if (result !== 0 || !outPtr[0]) {
+        return { success: false, error: `获取日志失败: ${result}` }
+      }
+      const jsonStr = this.decodeJsonPtr(outPtr[0])
+      if (!jsonStr) return { success: false, error: '解析日志失败' }
+      return { success: true, logs: JSON.parse(jsonStr) }
+    } catch (e) {
+      return { success: false, error: String(e) }
+    }
+  }
+
   async execQuery(kind: string, path: string | null, sql: string): Promise<{ success: boolean; rows?: any[]; error?: string }> {
     if (!this.ensureReady()) {
       return { success: false, error: 'WCDB 未连接' }
     }
     try {
+      if (!this.wcdbExecQuery) return { success: false, error: '接口未就绪' }
       const outPtr = [null as any]
-      const result = this.wcdbExecQuery(this.handle, kind, path, sql, outPtr)
+      const result = this.wcdbExecQuery(this.handle, kind, path || '', sql, outPtr)
       if (result !== 0 || !outPtr[0]) {
         return { success: false, error: `执行查询失败: ${result}` }
       }
@@ -1502,4 +1721,51 @@ export class WcdbCore {
       return { success: false, error: String(e) }
     }
   }
+
+  async getSnsAnnualStats(beginTimestamp: number, endTimestamp: number): Promise<{ success: boolean; data?: any; error?: string }> {
+    if (!this.ensureReady()) {
+      return { success: false, error: 'WCDB 未连接' }
+    }
+    try {
+      if (!this.wcdbGetSnsAnnualStats) {
+        return { success: false, error: 'wcdbGetSnsAnnualStats 未找到' }
+      }
+      await new Promise(resolve => setImmediate(resolve))
+      const outPtr = [null as any]
+      const result = this.wcdbGetSnsAnnualStats(this.handle, beginTimestamp, endTimestamp, outPtr)
+      await new Promise(resolve => setImmediate(resolve))
+
+      if (result !== 0 || !outPtr[0]) {
+        return { success: false, error: `getSnsAnnualStats failed: ${result}` }
+      }
+      const jsonStr = this.decodeJsonPtr(outPtr[0])
+      if (!jsonStr) return { success: false, error: 'Failed to decode JSON' }
+      return { success: true, data: JSON.parse(jsonStr) }
+    } catch (e) {
+      console.error('getSnsAnnualStats 异常:', e)
+      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

@@ -23,6 +23,7 @@ export class WcdbService {
   private resourcesPath: string | null = null
   private userDataPath: string | null = null
   private logEnabled = false
+  private monitorListener: ((type: string, json: string) => void) | null = null
 
   constructor() {
     this.initWorker()
@@ -47,8 +48,16 @@ export class WcdbService {
     try {
       this.worker = new Worker(finalPath)
 
-      this.worker.on('message', (msg: WorkerMessage) => {
-        const { id, result, error } = msg
+      this.worker.on('message', (msg: any) => {
+        const { id, result, error, type, payload } = msg
+
+        if (type === 'monitor') {
+          if (this.monitorListener) {
+            this.monitorListener(payload.type, payload.json)
+          }
+          return
+        }
+
         const p = this.pending.get(id)
         if (p) {
           this.pending.delete(id)
@@ -122,6 +131,15 @@ export class WcdbService {
     this.callWorker('setLogEnabled', { enabled }).catch(() => { })
   }
 
+  /**
+   * 设置数据库监控回调
+   */
+  setMonitor(callback: (type: string, json: string) => void): void {
+    this.monitorListener = callback;
+    // Notify worker to enable monitor
+    this.callWorker('setMonitor').catch(() => { });
+  }
+
   /**
    * 检查服务是否就绪
    */
@@ -187,6 +205,13 @@ export class WcdbService {
     return this.callWorker('getMessages', { sessionId, limit, offset })
   }
 
+  /**
+   * 获取新消息（增量刷新）
+   */
+  async getNewMessages(sessionId: string, minTime: number, limit: number = 1000): Promise<{ success: boolean; messages?: any[]; error?: string }> {
+    return this.callWorker('getNewMessages', { sessionId, minTime, limit })
+  }
+
   /**
    * 获取消息总数
    */
@@ -229,6 +254,11 @@ export class WcdbService {
     return this.callWorker('getGroupMembers', { chatroomId })
   }
 
+  // 获取群成员群名片昵称
+  async getGroupNicknames(chatroomId: string): Promise<{ success: boolean; nicknames?: Record<string, string>; error?: string }> {
+    return this.callWorker('getGroupNicknames', { chatroomId })
+  }
+
   /**
    * 获取消息表列表
    */
@@ -243,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 })
+  }
+
   /**
    * 获取消息元数据
    */
@@ -285,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 })
+  }
+
   /**
    * 获取群聊统计
    */
@@ -369,6 +410,20 @@ export class WcdbService {
     return this.callWorker('getSnsTimeline', { limit, offset, usernames, keyword, startTime, endTime })
   }
 
+  /**
+   * 获取朋友圈年度统计
+   */
+  async getSnsAnnualStats(beginTimestamp: number, endTimestamp: number): Promise<{ success: boolean; data?: any; error?: string }> {
+    return this.callWorker('getSnsAnnualStats', { beginTimestamp, endTimestamp })
+  }
+
+  /**
+   * 获取 DLL 内部日志
+   */
+  async getLogs(): Promise<{ success: boolean; logs?: string[]; error?: string }> {
+    return this.callWorker('getLogs')
+  }
+
   /**
    * 验证 Windows Hello
    */

electron/transcribeWorker.ts

@@ -80,17 +80,17 @@ function isLanguageAllowed(result: any, allowedLanguages: string[]): boolean {
     }
 
     const langTag = result.lang
-    console.log('[TranscribeWorker] 检测到语言标记:', langTag)
+    
 
     // 检查是否在允许的语言列表中
     for (const lang of allowedLanguages) {
         if (LANGUAGE_TAGS[lang] === langTag) {
-            console.log('[TranscribeWorker] 语言匹配，允许:', lang)
+            
             return true
         }
     }
 
-    console.log('[TranscribeWorker] 语言不在白名单中，过滤掉')
+    
     return false
 }
 
@@ -117,7 +117,7 @@ async function run() {
             allowedLanguages = ['zh']
         }
 
-        console.log('[TranscribeWorker] 使用的语言白名单:', allowedLanguages)
+        
 
         // 1. 初始化识别器 (SenseVoiceSmall)
         const recognizerConfig = {
@@ -145,15 +145,15 @@ async function run() {
         recognizer.decode(stream)
         const result = recognizer.getResult(stream)
 
-        console.log('[TranscribeWorker] 识别完成 - 结果对象:', JSON.stringify(result, null, 2))
+        
 
         // 3. 检查语言是否在白名单中
         if (isLanguageAllowed(result, allowedLanguages)) {
             const processedText = richTranscribePostProcess(result.text)
-            console.log('[TranscribeWorker] 语言匹配，返回文本:', processedText)
+            
             parentPort.postMessage({ type: 'final', text: processedText })
         } else {
-            console.log('[TranscribeWorker] 语言不匹配，返回空文本')
+            
             parentPort.postMessage({ type: 'final', text: '' })
         }
 

electron/wcdbWorker.ts

@@ -19,6 +19,16 @@ if (parentPort) {
                     core.setLogEnabled(payload.enabled)
                     result = { success: true }
                     break
+                case 'setMonitor':
+                    core.setMonitor((type, json) => {
+                        parentPort!.postMessage({
+                            id: -1,
+                            type: 'monitor',
+                            payload: { type, json }
+                        })
+                    })
+                    result = { success: true }
+                    break
                 case 'testConnection':
                     result = await core.testConnection(payload.dbPath, payload.hexKey, payload.wxid)
                     break
@@ -38,6 +48,9 @@ if (parentPort) {
                 case 'getMessages':
                     result = await core.getMessages(payload.sessionId, payload.limit, payload.offset)
                     break
+                case 'getNewMessages':
+                    result = await core.getNewMessages(payload.sessionId, payload.minTime, payload.limit)
+                    break
                 case 'getMessageCount':
                     result = await core.getMessageCount(payload.sessionId)
                     break
@@ -56,12 +69,18 @@ if (parentPort) {
                 case 'getGroupMembers':
                     result = await core.getGroupMembers(payload.chatroomId)
                     break
+                case 'getGroupNicknames':
+                    result = await core.getGroupNicknames(payload.chatroomId)
+                    break
                 case 'getMessageTables':
                     result = await core.getMessageTables(payload.sessionId)
                     break
                 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
@@ -80,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
@@ -119,6 +141,12 @@ if (parentPort) {
                 case 'getSnsTimeline':
                     result = await core.getSnsTimeline(payload.limit, payload.offset, payload.usernames, payload.keyword, payload.startTime, payload.endTime)
                     break
+                case 'getSnsAnnualStats':
+                    result = await core.getSnsAnnualStats(payload.beginTimestamp, payload.endTimestamp)
+                    break
+                case 'getLogs':
+                    result = await core.getLogs()
+                    break
                 case 'verifyUser':
                     result = await core.verifyUser(payload.message, payload.hwnd)
                     break

electron/windows/notificationWindow.ts

@@ -0,0 +1,200 @@
+import { BrowserWindow, ipcMain, screen } from 'electron'
+import { join } from 'path'
+import { ConfigService } from '../services/config'
+
+let notificationWindow: BrowserWindow | null = null
+let closeTimer: NodeJS.Timeout | null = null
+
+export function createNotificationWindow() {
+    if (notificationWindow && !notificationWindow.isDestroyed()) {
+        return notificationWindow
+    }
+
+    const isDev = !!process.env.VITE_DEV_SERVER_URL
+    const iconPath = isDev
+        ? join(__dirname, '../../public/icon.ico')
+        : join(process.resourcesPath, 'icon.ico')
+
+    console.log('[NotificationWindow] Creating window...')
+    const width = 344
+    const height = 114
+
+    // Update default creation size
+    notificationWindow = new BrowserWindow({
+        width: width,
+        height: height,
+        type: 'toolbar', // 有助于在某些操作系统上保持置顶
+        frame: false,
+        transparent: true,
+        resizable: false,
+        show: false,
+        alwaysOnTop: true,
+        skipTaskbar: true,
+        focusable: false, // 不抢占焦点
+        icon: iconPath,
+        webPreferences: {
+            preload: join(__dirname, 'preload.js'), // FIX: Use correct relative path (same dir in dist)
+            contextIsolation: true,
+            nodeIntegration: false,
+            // devTools: true // Enable DevTools
+        }
+    })
+
+    // notificationWindow.webContents.openDevTools({ mode: 'detach' }) // DEBUG: Force Open DevTools
+    notificationWindow.setIgnoreMouseEvents(true, { forward: true }) // 初始点击穿透
+
+    // 处理鼠标事件 (如果需要从渲染进程转发，但目前特定区域处理?)
+    // 实际上，我们希望窗口可点击。
+    // 我们将在显示时将忽略鼠标事件设为 false。
+
+    const loadUrl = isDev
+        ? `${process.env.VITE_DEV_SERVER_URL}#/notification-window`
+        : `file://${join(__dirname, '../dist/index.html')}#/notification-window`
+
+    console.log('[NotificationWindow] Loading URL:', loadUrl)
+    notificationWindow.loadURL(loadUrl)
+
+    notificationWindow.on('closed', () => {
+        notificationWindow = null
+    })
+
+    return notificationWindow
+}
+
+export async function showNotification(data: any) {
+    // 先检查配置
+    const config = ConfigService.getInstance()
+    const enabled = await config.get('notificationEnabled')
+    if (enabled === false) return // 默认为 true
+
+    // 检查会话过滤
+    const filterMode = config.get('notificationFilterMode') || 'all'
+    const filterList = config.get('notificationFilterList') || []
+    const sessionId = data.sessionId
+
+    if (sessionId && filterMode !== 'all' && filterList.length > 0) {
+        const isInList = filterList.includes(sessionId)
+        if (filterMode === 'whitelist' && !isInList) {
+            // 白名单模式：不在列表中则不显示
+            console.log('[NotificationWindow] Filtered by whitelist:', sessionId)
+            return
+        }
+        if (filterMode === 'blacklist' && isInList) {
+            // 黑名单模式：在列表中则不显示
+            console.log('[NotificationWindow] Filtered by blacklist:', sessionId)
+            return
+        }
+    }
+
+    let win = notificationWindow
+    if (!win || win.isDestroyed()) {
+        win = createNotificationWindow()
+    }
+
+    if (!win) return
+
+    // 确保加载完成
+    if (win.webContents.isLoading()) {
+        win.once('ready-to-show', () => {
+            showAndSend(win!, data)
+        })
+    } else {
+        showAndSend(win, data)
+    }
+}
+
+let lastNotificationData: any = null
+
+async function showAndSend(win: BrowserWindow, data: any) {
+    lastNotificationData = data
+    const config = ConfigService.getInstance()
+    const position = (await config.get('notificationPosition')) || 'top-right'
+
+    // 更新位置
+    const { width: screenWidth, height: screenHeight } = screen.getPrimaryDisplay().workAreaSize
+    const winWidth = 344
+    const winHeight = 114
+    const padding = 20
+
+    let x = 0
+    let y = 0
+
+    switch (position) {
+        case 'top-right':
+            x = screenWidth - winWidth - padding
+            y = padding
+            break
+        case 'bottom-right':
+            x = screenWidth - winWidth - padding
+            y = screenHeight - winHeight - padding
+            break
+        case 'top-left':
+            x = padding
+            y = padding
+            break
+        case 'bottom-left':
+            x = padding
+            y = screenHeight - winHeight - padding
+            break
+    }
+
+    win.setPosition(Math.floor(x), Math.floor(y))
+    win.setSize(winWidth, winHeight) // 确保尺寸
+
+    // 设为可交互
+    win.setIgnoreMouseEvents(false)
+    win.showInactive() // 显示但不聚焦
+    win.setAlwaysOnTop(true, 'screen-saver') // 最高层级
+
+    win.webContents.send('notification:show', data)
+
+    // 自动关闭计时器通常由渲染进程管理
+    // 渲染进程发送 'notification:close' 来隐藏窗口
+}
+
+export function registerNotificationHandlers() {
+    ipcMain.handle('notification:show', (_, data) => {
+        showNotification(data)
+    })
+
+    ipcMain.handle('notification:close', () => {
+        if (notificationWindow && !notificationWindow.isDestroyed()) {
+            notificationWindow.hide()
+            notificationWindow.setIgnoreMouseEvents(true, { forward: true })
+        }
+    })
+
+    // Handle renderer ready event (fix race condition)
+    ipcMain.on('notification:ready', (event) => {
+        console.log('[NotificationWindow] Renderer ready, checking cached data')
+        if (lastNotificationData && notificationWindow && !notificationWindow.isDestroyed()) {
+            console.log('[NotificationWindow] Re-sending cached data')
+            notificationWindow.webContents.send('notification:show', lastNotificationData)
+        }
+    })
+
+    // Handle resize request from renderer
+    ipcMain.on('notification:resize', (event, { width, height }) => {
+        if (notificationWindow && !notificationWindow.isDestroyed()) {
+            // Enforce max-height if needed, or trust renderer
+            // Ensure it doesn't go off screen bottom? 
+            // Logic in showAndSend handles position, but we need to keep anchor point (top-right usually).
+            // If we resize, we should re-calculate position to keep it anchored?
+            // Actually, setSize changes size. If it's top-right, x/y stays same -> window grows down. That's fine for top-right.
+            // If bottom-right, growing down pushes it off screen.
+
+            // Simple version: just setSize. For V1 we assume Top-Right.
+            // But wait, the config supports bottom-right.
+            // We can re-call setPosition or just let it be.
+            // If bottom-right, y needs to prevent overflow.
+
+            // Ideally we get current config position
+            const bounds = notificationWindow.getBounds()
+            // Check if we need to adjust Y?
+            // For now, let's just set the size as requested.
+            notificationWindow.setSize(Math.round(width), Math.round(height))
+        }
+    })
+
+    // 'notification-clicked' 在 main.ts 中处理 (导航)
+}

package.json

@@ -1,9 +1,13 @@
 {
   "name": "weflow",
-  "version": "1.4.3",
+  "version": "1.5.4",
   "description": "WeFlow",
   "main": "dist-electron/main.js",
   "author": "cc",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hicccc77/WeFlow"
+  },
   "//": "二改不应改变此处的作者与应用信息",
   "scripts": {
     "postinstall": "echo 'No native modules to rebuild'",
@@ -28,9 +32,13 @@
     "jszip": "^3.10.1",
     "koffi": "^2.9.0",
     "lucide-react": "^0.562.0",
+    "node-llama-cpp": "^3.15.1",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
+    "react-markdown": "^10.1.0",
     "react-router-dom": "^7.1.1",
+    "react-virtuoso": "^4.18.1",
+    "remark-gfm": "^4.0.1",
     "sherpa-onnx-node": "^1.10.38",
     "silk-wasm": "^3.7.1",
     "wechat-emojis": "^1.0.2",
@@ -55,6 +63,8 @@
     "appId": "com.WeFlow.app",
     "publish": {
       "provider": "github",
+      "owner": "hicccc77",
+      "repo": "WeFlow",
       "releaseType": "release"
     },
     "productName": "WeFlow",
@@ -105,7 +115,8 @@
     ],
     "asarUnpack": [
       "node_modules/silk-wasm/**/*",
-      "node_modules/sherpa-onnx-node/**/*"
+      "node_modules/sherpa-onnx-node/**/*",
+      "node_modules/ffmpeg-static/**/*"
     ],
     "extraFiles": [
       {

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

@@ -10,14 +10,19 @@ import AnalyticsPage from './pages/AnalyticsPage'
 import AnalyticsWelcomePage from './pages/AnalyticsWelcomePage'
 import AnnualReportPage from './pages/AnnualReportPage'
 import AnnualReportWindow from './pages/AnnualReportWindow'
+import DualReportPage from './pages/DualReportPage'
+import DualReportWindow from './pages/DualReportWindow'
 import AgreementPage from './pages/AgreementPage'
 import GroupAnalyticsPage from './pages/GroupAnalyticsPage'
 import SettingsPage from './pages/SettingsPage'
 import ExportPage from './pages/ExportPage'
 import VideoWindow from './pages/VideoWindow'
+import ImageWindow from './pages/ImageWindow'
 import SnsPage from './pages/SnsPage'
 import ContactsPage from './pages/ContactsPage'
 import ChatHistoryPage from './pages/ChatHistoryPage'
+import NotificationWindow from './pages/NotificationWindow'
+import AIChatPage from './pages/AIChatPage'
 
 import { useAppStore } from './stores/appStore'
 import { themes, useThemeStore, type ThemeId } from './stores/themeStore'
@@ -28,10 +33,13 @@ import './App.scss'
 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()
   const location = useLocation()
+
   const {
     setDbConnected,
     updateInfo,
@@ -52,6 +60,7 @@ function App() {
   const isOnboardingWindow = location.pathname === '/onboarding-window'
   const isVideoPlayerWindow = location.pathname === '/video-player-window'
   const isChatHistoryWindow = location.pathname.startsWith('/chat-history/')
+  const isNotificationWindow = location.pathname === '/notification-window'
   const [themeHydrated, setThemeHydrated] = useState(false)
 
   // 锁定状态
@@ -71,7 +80,7 @@ function App() {
     const body = document.body
     const appRoot = document.getElementById('app')
 
-    if (isOnboardingWindow) {
+    if (isOnboardingWindow || isNotificationWindow) {
       root.style.background = 'transparent'
       body.style.background = 'transparent'
       body.style.overflow = 'hidden'
@@ -97,10 +106,10 @@ function App() {
 
     // 更新窗口控件颜色以适配主题
     const symbolColor = themeMode === 'dark' ? '#ffffff' : '#1a1a1a'
-    if (!isOnboardingWindow) {
+    if (!isOnboardingWindow && !isNotificationWindow) {
       window.electronAPI.window.setTitleBarOverlay({ symbolColor })
     }
-  }, [currentTheme, themeMode, isOnboardingWindow])
+  }, [currentTheme, themeMode, isOnboardingWindow, isNotificationWindow])
 
   // 读取已保存的主题设置
   useEffect(() => {
@@ -170,21 +179,23 @@ function App() {
 
   // 监听启动时的更新通知
   useEffect(() => {
-    const removeUpdateListener = window.electronAPI.app.onUpdateAvailable?.((info: any) => {
+    if (isNotificationWindow) return // Skip updates in notification window
+
+    const removeUpdateListener = window.electronAPI?.app?.onUpdateAvailable?.((info: any) => {
       // 发现新版本时自动打开更新弹窗
       if (info) {
         setUpdateInfo({ ...info, hasUpdate: true })
         setShowUpdateDialog(true)
       }
     })
-    const removeProgressListener = window.electronAPI.app.onDownloadProgress?.((progress: any) => {
+    const removeProgressListener = window.electronAPI?.app?.onDownloadProgress?.((progress: any) => {
       setDownloadProgress(progress)
     })
     return () => {
       removeUpdateListener?.()
       removeProgressListener?.()
     }
-  }, [setUpdateInfo, setDownloadProgress, setShowUpdateDialog])
+  }, [setUpdateInfo, setDownloadProgress, setShowUpdateDialog, isNotificationWindow])
 
   const handleUpdateNow = async () => {
     setShowUpdateDialog(false)
@@ -201,6 +212,18 @@ function App() {
     }
   }
 
+  const handleIgnoreUpdate = async () => {
+    if (!updateInfo || !updateInfo.version) return
+
+    try {
+      await window.electronAPI.app.ignoreUpdate(updateInfo.version)
+      setShowUpdateDialog(false)
+      setUpdateInfo(null)
+    } catch (e: any) {
+      console.error('忽略更新失败:', e)
+    }
+  }
+
   const dismissUpdate = () => {
     setUpdateInfo(null)
   }
@@ -227,18 +250,18 @@ function App() {
           if (!onboardingDone) {
             await configService.setOnboardingDone(true)
           }
-          console.log('检测到已保存的配置，正在自动连接...')
+
           const result = await window.electronAPI.chat.connect()
 
           if (result.success) {
-            console.log('自动连接成功')
+
             setDbConnected(true, dbPath)
             // 如果当前在欢迎页，跳转到首页
             if (window.location.hash === '#/' || window.location.hash === '') {
               navigate('/home')
             }
           } else {
-            console.log('自动连接失败:', result.error)
+
             // 如果错误信息包含 VC++ 或 DLL 相关内容，不清除配置，只提示用户
             // 其他错误可能需要重新配置
             const errorMsg = result.error || ''
@@ -304,14 +327,26 @@ function App() {
     return <VideoWindow />
   }
 
+  // 独立图片查看窗口
+  const isImageViewerWindow = location.pathname === '/image-viewer-window'
+  if (isImageViewerWindow) {
+    return <ImageWindow />
+  }
+
   // 独立聊天记录窗口
   if (isChatHistoryWindow) {
     return <ChatHistoryPage />
   }
 
+  // 独立通知窗口
+  if (isNotificationWindow) {
+    return <NotificationWindow />
+  }
+
   // 主窗口 - 完整布局
   return (
     <div className="app-container">
+      <div className="window-drag-region" aria-hidden="true" />
       {isLocked && (
         <LockScreen
           onUnlock={() => setLocked(false)}
@@ -324,6 +359,12 @@ function App() {
       {/* 全局悬浮进度胶囊 (处理：新版本提示、下载进度、错误提示) */}
       <UpdateProgressCapsule />
 
+      {/* 全局会话监听与通知 */}
+      <GlobalSessionMonitor />
+
+      {/* 全局批量转写进度浮窗 */}
+      <BatchTranscribeGlobal />
+
       {/* 用户协议弹窗 */}
       {showAgreement && !agreementLoading && (
         <div className="agreement-overlay">
@@ -381,6 +422,7 @@ function App() {
         updateInfo={updateInfo}
         onClose={() => setShowUpdateDialog(false)}
         onUpdate={handleUpdateNow}
+        onIgnore={handleIgnoreUpdate}
         isDownloading={isDownloading}
         progress={downloadProgress}
       />
@@ -393,11 +435,14 @@ function App() {
               <Route path="/" element={<HomePage />} />
               <Route path="/home" element={<HomePage />} />
               <Route path="/chat" element={<ChatPage />} />
+              <Route path="/ai-chat" element={<AIChatPage />} />
               <Route path="/analytics" element={<AnalyticsWelcomePage />} />
               <Route path="/analytics/view" element={<AnalyticsPage />} />
               <Route path="/group-analytics" element={<GroupAnalyticsPage />} />
               <Route path="/annual-report" element={<AnnualReportPage />} />
               <Route path="/annual-report/view" element={<AnnualReportWindow />} />
+              <Route path="/dual-report" element={<DualReportPage />} />
+              <Route path="/dual-report/view" element={<DualReportWindow />} />
 
               <Route path="/settings" element={<SettingsPage />} />
               <Route path="/export" element={<ExportPage />} />

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;

src/components/DateRangePicker.tsx

@@ -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

@@ -0,0 +1,271 @@
+import { useEffect, useRef } from 'react'
+import { useChatStore } from '../stores/chatStore'
+import type { ChatSession } from '../types/models'
+import { useNavigate } from 'react-router-dom'
+
+export function GlobalSessionMonitor() {
+    const navigate = useNavigate()
+    const {
+        sessions,
+        setSessions,
+        currentSessionId,
+        appendMessages,
+        messages
+    } = useChatStore()
+
+    const sessionsRef = useRef(sessions)
+
+    // 保持 ref 同步
+    useEffect(() => {
+        sessionsRef.current = sessions
+    }, [sessions])
+
+    // 去重辅助函数：获取消息 key
+    const getMessageKey = (msg: any) => {
+        if (msg.localId && msg.localId > 0) return `l:${msg.localId}`
+        return `t:${msg.createTime}:${msg.sortSeq || 0}:${msg.serverId || 0}`
+    }
+
+    // 处理数据库变更
+    useEffect(() => {
+        const handleDbChange = (_event: any, data: { type: string; json: string }) => {
+            try {
+                const payload = JSON.parse(data.json)
+                const tableName = payload.table
+
+                // 只关注 Session 表
+                if (tableName === 'Session' || tableName === 'session') {
+                    refreshSessions()
+                }
+            } catch (e) {
+                console.error('解析数据库变更失败:', e)
+            }
+        }
+
+        if (window.electronAPI.chat.onWcdbChange) {
+            const removeListener = window.electronAPI.chat.onWcdbChange(handleDbChange)
+            return () => {
+                removeListener()
+            }
+        }
+        return () => { }
+    }, []) // 空依赖数组 - 主要是静态的
+
+    const refreshSessions = async () => {
+        try {
+            const result = await window.electronAPI.chat.getSessions()
+            if (result.success && result.sessions && Array.isArray(result.sessions)) {
+                const newSessions = result.sessions as ChatSession[]
+                const oldSessions = sessionsRef.current
+
+                // 1. 检测变更并通知
+                checkForNewMessages(oldSessions, newSessions)
+
+                // 2. 更新 store
+                setSessions(newSessions)
+
+                // 3. 如果在活跃会话中，增量刷新消息
+                const currentId = useChatStore.getState().currentSessionId
+                if (currentId) {
+                    const currentSessionNew = newSessions.find(s => s.username === currentId)
+                    const currentSessionOld = oldSessions.find(s => s.username === currentId)
+
+                    if (currentSessionNew && (!currentSessionOld || currentSessionNew.lastTimestamp > currentSessionOld.lastTimestamp)) {
+                        void handleActiveSessionRefresh(currentId)
+                    }
+                }
+            }
+        } catch (e) {
+            console.error('全局会话刷新失败:', e)
+        }
+    }
+
+    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) {
+            const oldSession = oldMap.get(newSession.username)
+
+            // 条件: 新会话或时间戳更新
+            const isCurrentSession = newSession.username === useChatStore.getState().currentSessionId
+
+            if (!isCurrentSession && (!oldSession || newSession.lastTimestamp > oldSession.lastTimestamp)) {
+                // 这是新消息事件
+
+                // 1. 群聊过滤自己发送的消息
+                if (newSession.username.includes('@chatroom')) {
+                    // 如果是自己发的消息，不弹通知
+                    // 注意：lastMsgSender 需要后端支持返回
+                    // 使用宽松比较以处理 wxid_ 前缀差异
+                    if (newSession.lastMsgSender && newSession.selfWxid) {
+                        const sender = newSession.lastMsgSender.replace(/^wxid_/, '');
+                        const self = newSession.selfWxid.replace(/^wxid_/, '');
+
+                        // 使用主进程日志打印，方便用户查看
+                        const debugInfo = {
+                            type: 'NotificationFilter',
+                            username: newSession.username,
+                            lastMsgSender: newSession.lastMsgSender,
+                            selfWxid: newSession.selfWxid,
+                            senderClean: sender,
+                            selfClean: self,
+                            match: sender === self
+                        };
+
+                        if (window.electronAPI.log?.debug) {
+                            window.electronAPI.log.debug(debugInfo);
+                        } else {
+                            console.log('[NotificationFilter]', debugInfo);
+                        }
+
+                        if (sender === self) {
+                            if (window.electronAPI.log?.debug) {
+                                window.electronAPI.log.debug('[NotificationFilter] Filtered own message');
+                            } else {
+                                console.log('[NotificationFilter] Filtered own message');
+                            }
+                            continue;
+                        }
+                    } else {
+                        const missingInfo = {
+                            type: 'NotificationFilter Missing info',
+                            lastMsgSender: newSession.lastMsgSender,
+                            selfWxid: newSession.selfWxid
+                        };
+                        if (window.electronAPI.log?.debug) {
+                            window.electronAPI.log.debug(missingInfo);
+                        } else {
+                            console.log('[NotificationFilter] Missing info:', missingInfo);
+                        }
+                    }
+                }
+
+                // 新增：如果未读数量没有增加，说明可能是自己在其他设备回复（或者已读），不弹通知
+                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 || '[新消息]'
+
+                if (newSession.username.includes('@chatroom')) {
+                    // 1. 群聊过滤自己发送的消息
+                    // 辅助函数：清理 wxid 后缀 (如 _8602)
+                    const cleanWxid = (id: string) => {
+                        if (!id) return '';
+                        const trimmed = id.trim();
+                        // 仅移除末尾的 _xxxx (4位字母数字)
+                        const suffixMatch = trimmed.match(/^(.+)_([a-zA-Z0-9]{4})$/);
+                        return suffixMatch ? suffixMatch[1] : trimmed;
+                    }
+
+                    if (newSession.lastMsgSender && newSession.selfWxid) {
+                        const senderClean = cleanWxid(newSession.lastMsgSender);
+                        const selfClean = cleanWxid(newSession.selfWxid);
+                        const match = senderClean === selfClean;
+
+                        if (match) {
+                            continue;
+                        }
+                    }
+
+                    // 2. 群聊显示发送者名字 (放在内容中: "Name: Message")
+                    // 标题保持为群聊名称 (title 变量)
+                    if (newSession.lastSenderDisplayName) {
+                        content = `${newSession.lastSenderDisplayName}: ${content}`
+                    }
+                }
+
+                // 修复 "Random User" 的逻辑 (缺少具体信息)
+                // 如果标题看起来像 wxid 或没有头像，尝试获取信息
+                const needsEnrichment = !newSession.displayName || !newSession.avatarUrl || newSession.displayName === newSession.username
+
+                if (needsEnrichment && newSession.username) {
+                    try {
+                        // 尝试丰富或获取联系人详情
+                        const contact = await window.electronAPI.chat.getContact(newSession.username)
+                        if (contact) {
+                            if (contact.remark || contact.nickname) {
+                                title = contact.remark || contact.nickname
+                            }
+                            if (contact.avatarUrl) {
+                                avatarUrl = contact.avatarUrl
+                            }
+                        } else {
+                            // 如果不在缓存/数据库中
+                            const enrichResult = await window.electronAPI.chat.enrichSessionsContactInfo([newSession.username])
+                            if (enrichResult.success && enrichResult.contacts) {
+                                const enrichedContact = enrichResult.contacts[newSession.username]
+                                if (enrichedContact) {
+                                    if (enrichedContact.displayName) {
+                                        title = enrichedContact.displayName
+                                    }
+                                    if (enrichedContact.avatarUrl) {
+                                        avatarUrl = enrichedContact.avatarUrl
+                                    }
+                                }
+                            }
+                            // 如果仍然没有有效名称，再尝试一次获取
+                            if (title === newSession.username || title.startsWith('wxid_')) {
+                                const retried = await window.electronAPI.chat.getContact(newSession.username)
+                                if (retried) {
+                                    title = retried.remark || retried.nickname || title
+                                    avatarUrl = retried.avatarUrl || avatarUrl
+                                }
+                            }
+                        }
+                    } catch (e) {
+                        console.warn('获取通知的联系人信息失败', e)
+                    }
+                }
+
+                // 最终检查：如果标题仍是 wxid 格式，则跳过通知（避免显示乱跳用户）
+                // 群聊例外，因为群聊 username 包含 @chatroom
+                const isGroupChat = newSession.username.includes('@chatroom')
+                const isWxidTitle = title.startsWith('wxid_') && title === newSession.username
+                if (isWxidTitle && !isGroupChat) {
+                    console.warn('[NotificationFilter] 跳过无法识别的用户通知:', newSession.username)
+                    continue
+                }
+
+                // 调用 IPC 以显示独立窗口通知
+                window.electronAPI.notification?.show({
+                    title: title,
+                    content: content,
+                    avatarUrl: avatarUrl,
+                    sessionId: newSession.username
+                })
+
+                // 我们不再为 Toast 设置本地状态
+            }
+        }
+    }
+
+    const handleActiveSessionRefresh = async (sessionId: string) => {
+        // 从 ChatPage 复制/调整的逻辑，以保持集中
+        const state = useChatStore.getState()
+        const lastMsg = state.messages[state.messages.length - 1]
+        const minTime = lastMsg?.createTime || 0
+
+        try {
+            const result = await (window.electronAPI.chat as any).getNewMessages(sessionId, minTime)
+            if (result.success && result.messages && result.messages.length > 0) {
+                appendMessages(result.messages, false) // 追加到末尾
+            }
+        } catch (e) {
+            console.warn('后台活跃会话刷新失败:', e)
+        }
+    }
+
+    // 此组件不再渲染 UI
+    return null
+}

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/MessageBubble.tsx

@@ -0,0 +1,36 @@
+import React from 'react'
+import { Bot, User } from 'lucide-react'
+
+interface ChatMessage {
+    id: string;
+    role: 'user' | 'ai';
+    content: string;
+    timestamp: number;
+}
+
+interface MessageBubbleProps {
+    message: ChatMessage;
+}
+
+/**
+ * 优化后的消息气泡组件
+ * 使用 React.memo 避免不必要的重新渲染
+ */
+export const MessageBubble = React.memo<MessageBubbleProps>(({ message }) => {
+    return (
+        <div className={`message-row ${message.role}`}>
+            <div className="avatar">
+                {message.role === 'ai' ? <Bot size={24} /> : <User size={24} />}
+            </div>
+            <div className="bubble">
+                <div className="content">{message.content}</div>
+            </div>
+        </div>
+    )
+}, (prevProps, nextProps) => {
+    // 自定义比较函数：只有内容或ID变化时才重新渲染
+    return prevProps.message.content === nextProps.message.content &&
+        prevProps.message.id === nextProps.message.id
+})
+
+MessageBubble.displayName = 'MessageBubble'

src/components/NotificationToast.scss

@@ -0,0 +1,200 @@
+.notification-toast-container {
+    position: fixed;
+    z-index: 9999;
+    width: 320px;
+    background: var(--bg-secondary);
+    backdrop-filter: blur(20px);
+    -webkit-backdrop-filter: blur(20px);
+    border: 1px solid var(--border-light);
+    border-radius: 12px;
+    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.12);
+    padding: 12px;
+    cursor: pointer;
+    transition: all 0.3s cubic-bezier(0.4, 0, 0.2, 1);
+    opacity: 0;
+    transform: scale(0.95);
+    pointer-events: none; // Allow clicking through when hidden
+
+    &.visible {
+        opacity: 1;
+        transform: scale(1);
+        pointer-events: auto;
+    }
+
+    &.static {
+        position: relative !important;
+        width: calc(100% - 4px) !important; // Leave 2px margin for anti-aliasing saftey
+        height: auto !important; // Fits content
+        min-height: 0;
+        top: 0 !important;
+        bottom: 0 !important;
+        left: 0 !important;
+        right: 0 !important;
+        transform: none !important;
+        margin: 2px !important; // 2px centered margin
+        border-radius: 12px !important; // Rounded corners
+
+
+        // Disable backdrop filter
+        backdrop-filter: none !important;
+        -webkit-backdrop-filter: none !important;
+
+        // Ensure background is solid
+        background: var(--bg-secondary, #2c2c2c);
+        color: var(--text-primary, #ffffff);
+
+        box-shadow: none !important; // NO SHADOW
+        border: 1px solid var(--border-light, rgba(255, 255, 255, 0.1));
+
+        display: flex;
+        padding: 16px;
+        padding-right: 32px; // Make space for close button
+        box-sizing: border-box;
+
+        // Force close button to be visible but transparent background
+        .notification-close {
+            opacity: 1 !important;
+            top: 12px;
+            right: 12px;
+            background: transparent !important; // Transparent per user request
+
+            &:hover {
+                color: var(--text-primary);
+                background: rgba(255, 255, 255, 0.1) !important; // Subtle hover effect
+            }
+        }
+
+        .notification-time {
+            top: 24px; // Match padding
+            right: 40px; // Left of close button (12px + 20px + 8px)
+        }
+    }
+
+    // Position variants
+    &.bottom-right {
+        bottom: 24px;
+        right: 24px;
+        transform: translate(0, 20px) scale(0.95);
+
+        &.visible {
+            transform: translate(0, 0) scale(1);
+        }
+    }
+
+    &.top-right {
+        top: 24px;
+        right: 24px;
+        transform: translate(0, -20px) scale(0.95);
+
+        &.visible {
+            transform: translate(0, 0) scale(1);
+        }
+    }
+
+    &.bottom-left {
+        bottom: 24px;
+        left: 24px;
+        transform: translate(0, 20px) scale(0.95);
+
+        &.visible {
+            transform: translate(0, 0) scale(1);
+        }
+    }
+
+    &.top-left {
+        top: 24px;
+        left: 24px;
+        transform: translate(0, -20px) scale(0.95);
+
+        &.visible {
+            transform: translate(0, 0) scale(1);
+        }
+    }
+
+    &:hover {
+        box-shadow: 0 12px 48px rgba(0, 0, 0, 0.16) !important;
+    }
+
+    .notification-content {
+        display: flex;
+        align-items: flex-start;
+        gap: 12px;
+    }
+
+    .notification-avatar {
+        flex-shrink: 0;
+    }
+
+    .notification-text {
+        flex: 1;
+        min-width: 0;
+
+        .notification-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 4px;
+
+            .notification-title {
+                font-weight: 600;
+                font-size: 14px;
+                color: var(--text-primary);
+                white-space: nowrap;
+                overflow: hidden;
+                text-overflow: ellipsis;
+                max-width: 100%; // 允许缩放
+                flex: 1; // 占据剩余空间
+                min-width: 0; // 关键：允许 flex 子项收缩到内容以下
+                margin-right: 60px; // Make space for absolute time + close button
+            }
+
+            .notification-time {
+                font-size: 12px;
+                color: var(--text-tertiary);
+                position: absolute;
+                top: 16px;
+                right: 36px; // Left of close button (8px + 20px + 8px)
+                font-variant-numeric: tabular-nums;
+            }
+        }
+
+        .notification-body {
+            font-size: 13px;
+            color: var(--text-secondary);
+            line-height: 1.4;
+            display: -webkit-box;
+            -webkit-line-clamp: 2;
+            line-clamp: 2;
+            -webkit-box-orient: vertical;
+            overflow: hidden;
+            word-break: break-all;
+        }
+    }
+
+    .notification-close {
+        position: absolute;
+        top: 8px;
+        right: 8px;
+        width: 20px;
+        height: 20px;
+        border-radius: 50%;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        border: none;
+        background: transparent;
+        color: var(--text-tertiary);
+        cursor: pointer;
+        opacity: 0;
+        transition: all 0.2s;
+
+        &:hover {
+            background: var(--bg-tertiary);
+            color: var(--text-primary);
+        }
+    }
+
+    &:hover .notification-close {
+        opacity: 1;
+    }
+}

src/components/NotificationToast.tsx

@@ -0,0 +1,108 @@
+import React, { useEffect, useState } from 'react'
+import { createPortal } from 'react-dom'
+import { X } from 'lucide-react'
+import { Avatar } from './Avatar'
+import './NotificationToast.scss'
+
+export interface NotificationData {
+    id: string
+    sessionId: string
+    avatarUrl?: string
+    title: string
+    content: string
+    timestamp: number
+}
+
+interface NotificationToastProps {
+    data: NotificationData | null
+    onClose: () => void
+    onClick: (sessionId: string) => void
+    duration?: number
+    position?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'
+    isStatic?: boolean
+    initialVisible?: boolean
+}
+
+export function NotificationToast({
+    data,
+    onClose,
+    onClick,
+    duration = 5000,
+    position = 'top-right',
+    isStatic = false,
+    initialVisible = false
+}: NotificationToastProps) {
+    const [isVisible, setIsVisible] = useState(initialVisible)
+    const [currentData, setCurrentData] = useState<NotificationData | null>(null)
+
+    useEffect(() => {
+        if (data) {
+            setCurrentData(data)
+            setIsVisible(true)
+
+            const timer = setTimeout(() => {
+                setIsVisible(false)
+                // clean up data after animation
+                setTimeout(onClose, 300)
+            }, duration)
+
+            return () => clearTimeout(timer)
+        } else {
+            setIsVisible(false)
+        }
+    }, [data, duration, onClose])
+
+    if (!currentData) return null
+
+    const handleClose = (e: React.MouseEvent) => {
+        e.stopPropagation()
+        setIsVisible(false)
+        setTimeout(onClose, 300)
+    }
+
+    const handleClick = () => {
+        setIsVisible(false)
+        setTimeout(() => {
+            onClose()
+            onClick(currentData.sessionId)
+        }, 300)
+    }
+
+    const content = (
+        <div
+            className={`notification-toast-container ${position} ${isVisible ? 'visible' : ''} ${isStatic ? 'static' : ''}`}
+            onClick={handleClick}
+        >
+            <div className="notification-content">
+                <div className="notification-avatar">
+                    <Avatar
+                        src={currentData.avatarUrl}
+                        name={currentData.title}
+                        size={40}
+                    />
+                </div>
+                <div className="notification-text">
+                    <div className="notification-header">
+                        <span className="notification-title">{currentData.title}</span>
+                        <span className="notification-time">
+                            {new Date(currentData.timestamp * 1000).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })}
+                        </span>
+                    </div>
+                    <div className="notification-body">
+                        {currentData.content}
+                    </div>
+                </div>
+                <button className="notification-close" onClick={handleClose}>
+                    <X size={14} />
+                </button>
+            </div>
+        </div>
+    )
+
+    if (isStatic) {
+        return content
+    }
+
+    // Portal to document.body to ensure it's on top
+    return createPortal(content, document.body)
+}

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%, color-mix(in srgb, var(--primary, #07C160) 12%, transparent), transparent 55%),
+            radial-gradient(circle at 65% 50%, color-mix(in srgb, var(--accent, #F2AA00) 10%, transparent), 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/components/Sidebar.tsx

@@ -1,6 +1,6 @@
 import { useState, useEffect } from 'react'
 import { NavLink, useLocation } from 'react-router-dom'
-import { Home, MessageSquare, BarChart3, Users, FileText, Database, Settings, ChevronLeft, ChevronRight, Download, Bot, Aperture, UserCircle, Lock } from 'lucide-react'
+import { Home, MessageSquare, BarChart3, Users, FileText, Database, Settings, ChevronLeft, ChevronRight, Download, Aperture, UserCircle, Lock } from 'lucide-react'
 import { useAppStore } from '../stores/appStore'
 import * as configService from '../services/config'
 import './Sidebar.scss'

src/components/UpdateDialog.scss

@@ -171,6 +171,29 @@
             .actions {
                 display: flex;
                 justify-content: center;
+                gap: 12px;
+
+                .btn-ignore {
+                    background: transparent;
+                    color: #666666;
+                    border: 1px solid #d0d0d0;
+                    padding: 16px 32px;
+                    border-radius: 20px;
+                    font-size: 16px;
+                    font-weight: 600;
+                    cursor: pointer;
+                    transition: all 0.2s;
+
+                    &:hover {
+                        background: #f5f5f5;
+                        border-color: #999999;
+                        color: #333333;
+                    }
+
+                    &:active {
+                        transform: scale(0.98);
+                    }
+                }
 
                 .btn-update {
                     background: #000000;

src/components/UpdateDialog.tsx

@@ -12,6 +12,7 @@ interface UpdateDialogProps {
     updateInfo: UpdateInfo | null
     onClose: () => void
     onUpdate: () => void
+    onIgnore?: () => void
     isDownloading: boolean
     progress: number | {
         percent: number
@@ -27,6 +28,7 @@ const UpdateDialog: React.FC<UpdateDialogProps> = ({
     updateInfo,
     onClose,
     onUpdate,
+    onIgnore,
     isDownloading,
     progress
 }) => {
@@ -118,6 +120,11 @@ const UpdateDialog: React.FC<UpdateDialogProps> = ({
                         </div>
                     ) : (
                         <div className="actions">
+                            {onIgnore && (
+                                <button className="btn-ignore" onClick={onIgnore}>
+                                    忽略本次更新
+                                </button>
+                            )}
                             <button className="btn-update" onClick={onUpdate}>
                                 开启新旅程
                             </button>

src/pages/AIChatPage.scss

@@ -0,0 +1,552 @@
+// AI 对话页面 - 简约大气风格
+.ai-chat-page {
+    display: flex;
+    height: 100%;
+    width: 100%;
+    background: var(--bg-gradient);
+    color: var(--text-primary);
+    overflow: hidden;
+
+    .chat-container {
+        flex: 1;
+        display: flex;
+        flex-direction: column;
+        max-width: 1200px;
+        margin: 0 auto;
+        width: 100%;
+    }
+
+    // ========== 顶部 Header - 已移除 ==========
+    // 模型选择器现已集成到输入框
+
+
+
+    // ========== 聊天区域 ==========
+    .chat-main {
+        flex: 1;
+        display: flex;
+        flex-direction: column;
+        background: var(--bg-secondary);
+        position: relative;
+        overflow: hidden;
+
+        // 空状态
+        .empty-state {
+            flex: 1;
+            display: flex;
+            flex-direction: column;
+            align-items: center;
+            justify-content: center;
+            padding: 40px;
+
+            .icon {
+                width: 80px;
+                height: 80px;
+                border-radius: 50%;
+                background: var(--primary-light);
+                display: flex;
+                align-items: center;
+                justify-content: center;
+                margin-bottom: 24px;
+
+                svg {
+                    width: 40px;
+                    height: 40px;
+                    color: var(--primary);
+                }
+            }
+
+            h2 {
+                font-size: 20px;
+                font-weight: 600;
+                color: var(--text-primary);
+                margin: 0 0 8px;
+            }
+
+            p {
+                font-size: 14px;
+                color: var(--text-tertiary);
+                margin: 0;
+            }
+        }
+
+        // 消息列表
+        .messages-list {
+            flex: 1;
+            overflow-y: auto;
+            padding: 24px 32px;
+            display: flex;
+            flex-direction: column;
+            gap: 20px;
+
+            &::-webkit-scrollbar {
+                width: 6px;
+            }
+
+            &::-webkit-scrollbar-track {
+                background: transparent;
+            }
+
+            &::-webkit-scrollbar-thumb {
+                background: var(--border-color);
+                border-radius: 3px;
+            }
+
+            .message-row {
+                display: flex;
+                gap: 12px;
+                max-width: 80%;
+                animation: messageIn 0.3s ease-out;
+
+                // 用户消息
+                &.user {
+                    align-self: flex-end;
+                    flex-direction: row-reverse;
+
+                    .avatar {
+                        background: var(--primary-light);
+                        color: var(--primary);
+                    }
+
+                    .bubble {
+                        background: var(--primary-gradient);
+                        color: white;
+                        border-radius: 18px 18px 4px 18px;
+                        box-shadow: 0 2px 10px color-mix(in srgb, var(--primary) 20%, transparent);
+
+                        .content {
+                            color: white;
+                        }
+                    }
+                }
+
+                // AI 消息
+                &.ai {
+                    align-self: flex-start;
+
+                    .avatar {
+                        background: var(--bg-tertiary);
+                        color: var(--text-secondary);
+                    }
+
+                    .bubble {
+                        background: var(--card-bg);
+                        border: 1px solid var(--border-color);
+                        border-radius: 18px 18px 18px 4px;
+                        backdrop-filter: blur(10px);
+                        -webkit-backdrop-filter: blur(10px);
+                    }
+                }
+
+                .avatar {
+                    flex-shrink: 0;
+                    width: 32px;
+                    height: 32px;
+                    border-radius: 50%;
+                    display: flex;
+                    align-items: center;
+                    justify-content: center;
+                }
+
+                .bubble {
+                    padding: 12px 16px;
+                    flex: 1;
+                    min-width: 0;
+
+                    .content,
+                    .markdown-content {
+                        font-size: 14px;
+                        line-height: 1.6;
+                        color: var(--text-primary);
+                        word-wrap: break-word;
+                        overflow-wrap: break-word;
+                    }
+
+                    // Markdown 样式
+                    .markdown-content {
+                        p {
+                            margin: 0 0 0.8em;
+
+                            &:last-child {
+                                margin-bottom: 0;
+                            }
+                        }
+
+                        h1,
+                        h2,
+                        h3,
+                        h4,
+                        h5,
+                        h6 {
+                            margin: 1em 0 0.5em;
+                            font-weight: 600;
+                            line-height: 1.3;
+                            color: var(--text-primary);
+
+                            &:first-child {
+                                margin-top: 0;
+                            }
+                        }
+
+                        h1 {
+                            font-size: 1.5em;
+                        }
+
+                        h2 {
+                            font-size: 1.3em;
+                        }
+
+                        h3 {
+                            font-size: 1.1em;
+                        }
+
+                        ul,
+                        ol {
+                            margin: 0.5em 0;
+                            padding-left: 1.5em;
+                        }
+
+                        li {
+                            margin: 0.3em 0;
+                        }
+
+                        code {
+                            background: var(--bg-tertiary);
+                            padding: 2px 6px;
+                            border-radius: 4px;
+                            font-family: 'Consolas', 'Monaco', monospace;
+                            font-size: 0.9em;
+                        }
+
+                        pre {
+                            background: var(--bg-tertiary);
+                            padding: 12px;
+                            border-radius: 8px;
+                            overflow-x: auto;
+                            margin: 0.8em 0;
+
+                            code {
+                                background: none;
+                                padding: 0;
+                            }
+                        }
+
+                        blockquote {
+                            border-left: 3px solid var(--primary);
+                            padding-left: 12px;
+                            margin: 0.8em 0;
+                            color: var(--text-secondary);
+                        }
+
+                        a {
+                            color: var(--primary);
+                            text-decoration: none;
+
+                            &:hover {
+                                text-decoration: underline;
+                            }
+                        }
+
+                        strong {
+                            font-weight: 600;
+                            color: var(--text-primary);
+                        }
+
+                        hr {
+                            border: none;
+                            border-top: 1px solid var(--border-color);
+                            margin: 1em 0;
+                        }
+
+                        table {
+                            border-collapse: collapse;
+                            width: 100%;
+                            margin: 0.8em 0;
+
+                            th,
+                            td {
+                                border: 1px solid var(--border-color);
+                                padding: 8px 12px;
+                                text-align: left;
+                            }
+
+                            th {
+                                background: var(--bg-tertiary);
+                                font-weight: 600;
+                            }
+                        }
+                    }
+                }
+            }
+
+            .list-spacer {
+                height: 100px;
+                flex-shrink: 0;
+            }
+        }
+
+        // 输入区域
+        .input-area {
+            position: absolute;
+            bottom: 24px;
+            left: 50%;
+            transform: translateX(-50%);
+            width: calc(100% - 64px);
+            max-width: 800px;
+            z-index: 10;
+
+            .input-wrapper {
+                display: flex;
+                align-items: flex-end;
+                gap: 10px;
+                background: var(--card-bg);
+                backdrop-filter: blur(20px);
+                -webkit-backdrop-filter: blur(20px);
+                border: 1px solid var(--border-color);
+                border-radius: 20px;
+                padding: 10px 14px;
+                box-shadow: 0 8px 32px rgba(0, 0, 0, 0.08);
+                transition: all 0.2s ease;
+
+                &:focus-within {
+                    border-color: var(--primary);
+                    box-shadow: 0 8px 32px rgba(0, 0, 0, 0.1),
+                        0 0 0 3px color-mix(in srgb, var(--primary) 15%, transparent);
+                }
+
+                textarea {
+                    flex: 1;
+                    min-height: 24px;
+                    max-height: 120px;
+                    padding: 8px 0;
+                    background: transparent;
+                    border: none;
+                    resize: none;
+                    color: var(--text-primary);
+                    font-size: 14px;
+                    font-family: inherit;
+                    line-height: 1.5;
+
+                    &:focus {
+                        outline: none;
+                    }
+
+                    &::placeholder {
+                        color: var(--text-tertiary);
+                    }
+
+                    &:disabled {
+                        cursor: not-allowed;
+                    }
+                }
+
+                .input-actions {
+                    display: flex;
+                    align-items: center;
+                    gap: 8px;
+                    flex-shrink: 0;
+
+                    // 模型选择器
+                    .model-selector {
+                        position: relative;
+
+                        .model-btn {
+                            display: flex;
+                            align-items: center;
+                            justify-content: center;
+                            gap: 6px;
+                            width: auto;
+                            height: 36px;
+                            padding: 6px 12px;
+                            background: transparent;
+                            border: 1px solid var(--border-color);
+                            border-radius: 10px;
+                            cursor: pointer;
+                            color: var(--text-secondary);
+                            font-size: 12px;
+                            font-weight: 500;
+                            white-space: nowrap;
+                            transition: all 0.2s ease;
+                            flex-shrink: 0;
+
+                            svg {
+                                flex-shrink: 0;
+
+                                &.spin {
+                                    animation: spin 1s linear infinite;
+                                }
+                            }
+
+                            &:hover:not(:disabled) {
+                                background: var(--bg-hover);
+                                border-color: var(--text-tertiary);
+                                color: var(--text-primary);
+                            }
+
+                            &.loaded {
+                                background: color-mix(in srgb, var(--primary) 15%, transparent);
+                                border-color: var(--primary);
+                                color: var(--primary);
+                            }
+
+                            &.loading {
+                                opacity: 0.7;
+                            }
+
+                            &.disabled {
+                                opacity: 0.5;
+                                cursor: not-allowed;
+                            }
+                        }
+
+                        .model-dropdown {
+                            position: absolute;
+                            bottom: 100%;
+                            right: 0;
+                            margin-bottom: 8px;
+                            background: var(--card-bg);
+                            backdrop-filter: blur(20px);
+                            -webkit-backdrop-filter: blur(20px);
+                            border: 1px solid var(--border-color);
+                            border-radius: 12px;
+                            box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
+                            z-index: 100;
+                            overflow: hidden;
+                            animation: dropdownIn 0.2s ease-out;
+                            min-width: 140px;
+
+                            .model-option {
+                                display: flex;
+                                align-items: center;
+                                justify-content: space-between;
+                                padding: 10px 14px;
+                                cursor: pointer;
+                                font-size: 13px;
+                                color: var(--text-primary);
+                                transition: background 0.15s ease;
+                                white-space: nowrap;
+
+                                &:hover:not(.disabled) {
+                                    background: var(--bg-hover);
+                                }
+
+                                &.active {
+                                    background: color-mix(in srgb, var(--primary) 20%, transparent);
+                                    color: var(--primary);
+                                    font-weight: 600;
+
+                                    .check {
+                                        color: var(--primary);
+                                    }
+                                }
+
+                                .check {
+                                    margin-left: 8px;
+                                    color: var(--text-tertiary);
+                                    font-weight: 600;
+                                }
+                            }
+                        }
+                    }
+
+                    .mode-toggle {
+                        width: 36px;
+                        height: 36px;
+                        display: flex;
+                        align-items: center;
+                        justify-content: center;
+                        background: transparent;
+                        border: 1px solid var(--border-color);
+                        border-radius: 10px;
+                        cursor: pointer;
+                        color: var(--text-tertiary);
+                        transition: all 0.2s ease;
+                        flex-shrink: 0;
+
+                        &:hover:not(:disabled) {
+                            background: var(--bg-hover);
+                            color: var(--text-primary);
+                        }
+
+                        &.active {
+                            background: color-mix(in srgb, var(--primary) 15%, transparent);
+                            border-color: var(--primary);
+                            color: var(--primary);
+                        }
+
+                        &:disabled {
+                            opacity: 0.4;
+                            cursor: not-allowed;
+                        }
+                    }
+
+                    .send-btn {
+                        width: 36px;
+                        height: 36px;
+                        display: flex;
+                        align-items: center;
+                        justify-content: center;
+                        background: var(--primary-gradient);
+                        border: none;
+                        border-radius: 10px;
+                        cursor: pointer;
+                        color: white;
+                        transition: all 0.2s ease;
+                        flex-shrink: 0;
+                        box-shadow: 0 2px 8px color-mix(in srgb, var(--primary) 25%, transparent);
+
+                        &:hover:not(:disabled) {
+                            transform: scale(1.05);
+                            box-shadow: 0 4px 12px color-mix(in srgb, var(--primary) 35%, transparent);
+                        }
+
+                        &:active:not(:disabled) {
+                            transform: scale(0.98);
+                        }
+
+                        &:disabled {
+                            background: var(--bg-tertiary);
+                            color: var(--text-tertiary);
+                            box-shadow: none;
+                            cursor: not-allowed;
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+
+@keyframes messageIn {
+    from {
+        opacity: 0;
+        transform: translateY(8px);
+    }
+
+    to {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}
+
+@keyframes dropdownIn {
+    from {
+        opacity: 0;
+        transform: translateY(-8px);
+    }
+
+    to {
+        opacity: 1;
+        transform: translateY(0);
+    }
+}
+
+@keyframes spin {
+    from {
+        transform: rotate(0deg);
+    }
+
+    to {
+        transform: rotate(360deg);
+    }
+}

src/pages/AIChatPage.tsx

@@ -0,0 +1,391 @@
+import { useState, useEffect, useRef, useCallback } from 'react'
+import { Send, Bot, User, Cpu, ChevronDown, Loader2 } from 'lucide-react'
+import { Virtuoso, VirtuosoHandle } from 'react-virtuoso'
+import { engineService, PRESET_MODELS, ModelInfo } from '../services/EngineService'
+import { MessageBubble } from '../components/MessageBubble'
+import './AIChatPage.scss'
+
+interface ChatMessage {
+    id: string;
+    role: 'user' | 'ai';
+    content: string;
+    timestamp: number;
+}
+
+// 消息数量限制，避免内存过载
+const MAX_MESSAGES = 200
+
+export default function AIChatPage() {
+    const [input, setInput] = useState('')
+    const [messages, setMessages] = useState<ChatMessage[]>([])
+    const [isTyping, setIsTyping] = useState(false)
+    const [models, setModels] = useState<ModelInfo[]>([...PRESET_MODELS])
+    const [selectedModel, setSelectedModel] = useState<string | null>(null)
+    const [modelLoaded, setModelLoaded] = useState(false)
+    const [loadingModel, setLoadingModel] = useState(false)
+    const [isThinkingMode, setIsThinkingMode] = useState(true)
+    const [showModelDropdown, setShowModelDropdown] = useState(false)
+
+    const textareaRef = useRef<HTMLTextAreaElement>(null)
+    const virtuosoRef = useRef<VirtuosoHandle>(null)
+    const dropdownRef = useRef<HTMLDivElement>(null)
+
+    // 流式渲染优化：使用 ref 缓存内容，使用 RAF 批量更新
+    const streamingContentRef = useRef('')
+    const streamingMessageIdRef = useRef<string | null>(null)
+    const rafIdRef = useRef<number | null>(null)
+
+    useEffect(() => {
+        checkModelsStatus()
+
+        // 初始化Llama服务（延迟初始化，用户进入此页面时启动）
+        const initLlama = async () => {
+            try {
+                await window.electronAPI.llama?.init()
+                console.log('[AIChatPage] Llama service initialized')
+            } catch (e) {
+                console.error('[AIChatPage] Failed to initialize Llama:', e)
+            }
+        }
+        initLlama()
+
+        // 清理函数：组件卸载时释放所有资源
+        return () => {
+            // 取消未完成的 RAF
+            if (rafIdRef.current !== null) {
+                cancelAnimationFrame(rafIdRef.current)
+                rafIdRef.current = null
+            }
+
+            // 清理 engine service 的回调引用
+            engineService.clearCallbacks()
+        }
+    }, [])
+
+    // 监听页面卸载事件，确保资源释放
+    useEffect(() => {
+        const handleBeforeUnload = () => {
+            // 清理回调和监听器
+            engineService.dispose()
+        }
+
+        window.addEventListener('beforeunload', handleBeforeUnload)
+        return () => window.removeEventListener('beforeunload', handleBeforeUnload)
+    }, [])
+
+    // 点击外部关闭下拉框
+    useEffect(() => {
+        const handleClickOutside = (event: MouseEvent) => {
+            if (dropdownRef.current && !dropdownRef.current.contains(event.target as Node)) {
+                setShowModelDropdown(false)
+            }
+        }
+
+        document.addEventListener('mousedown', handleClickOutside)
+        return () => document.removeEventListener('mousedown', handleClickOutside)
+    }, [])
+
+    const scrollToBottom = useCallback(() => {
+        // 使用 virtuoso 的 scrollToIndex 方法滚动到底部
+        if (virtuosoRef.current && messages.length > 0) {
+            virtuosoRef.current.scrollToIndex({
+                index: messages.length - 1,
+                behavior: 'smooth'
+            })
+        }
+    }, [messages.length])
+
+    const checkModelsStatus = async () => {
+        const updatedModels = await Promise.all(models.map(async (m) => {
+            const exists = await engineService.checkModelExists(m.path)
+            return { ...m, downloaded: exists }
+        }))
+        setModels(updatedModels)
+
+        // Auto-select first available model
+        if (!selectedModel) {
+            const available = updatedModels.find(m => m.downloaded)
+            if (available) {
+                setSelectedModel(available.path)
+            }
+        }
+    }
+
+    // 自动加载模型
+    const handleLoadModel = async (modelPath?: string) => {
+        const pathToLoad = modelPath || selectedModel
+        if (!pathToLoad) return false
+
+        setLoadingModel(true)
+        try {
+            await engineService.loadModel(pathToLoad)
+            // Initialize session with system prompt
+            await engineService.createSession("You are a helpful AI assistant.")
+            setModelLoaded(true)
+            return true
+        } catch (e) {
+            console.error("Load failed", e)
+            alert("模型加载失败: " + String(e))
+            return false
+        } finally {
+            setLoadingModel(false)
+        }
+    }
+
+    // 选择模型（如果有多个）
+    const handleSelectModel = (modelPath: string) => {
+        setSelectedModel(modelPath)
+        setShowModelDropdown(false)
+    }
+
+    // 获取可用的已下载模型
+    const availableModels = models.filter(m => m.downloaded)
+    const selectedModelInfo = models.find(m => m.path === selectedModel)
+
+    // 优化的流式更新函数：使用 RAF 批量更新
+    const updateStreamingMessage = useCallback(() => {
+        if (!streamingMessageIdRef.current) return
+
+        setMessages(prev => prev.map(msg =>
+            msg.id === streamingMessageIdRef.current
+                ? { ...msg, content: streamingContentRef.current }
+                : msg
+        ))
+
+        rafIdRef.current = null
+    }, [])
+
+    // Token 回调：使用 RAF 批量更新 UI
+    const handleToken = useCallback((token: string) => {
+        streamingContentRef.current += token
+
+        // 使用 requestAnimationFrame 批量更新，避免频繁渲染
+        if (rafIdRef.current === null) {
+            rafIdRef.current = requestAnimationFrame(updateStreamingMessage)
+        }
+    }, [updateStreamingMessage])
+
+    const handleSend = async () => {
+        if (!input.trim() || isTyping) return
+
+        // 如果模型未加载，先自动加载
+        if (!modelLoaded) {
+            if (!selectedModel) {
+                alert("请先下载模型（设置页面）")
+                return
+            }
+            const loaded = await handleLoadModel()
+            if (!loaded) return
+        }
+
+        const userMsg: ChatMessage = {
+            id: Date.now().toString(),
+            role: 'user',
+            content: input,
+            timestamp: Date.now()
+        }
+
+        setMessages(prev => {
+            const newMessages = [...prev, userMsg]
+            // 限制消息数量，避免内存过载
+            return newMessages.length > MAX_MESSAGES
+                ? newMessages.slice(-MAX_MESSAGES)
+                : newMessages
+        })
+        setInput('')
+        setIsTyping(true)
+
+        // Reset textarea height
+        if (textareaRef.current) {
+            textareaRef.current.style.height = 'auto'
+        }
+
+        const aiMsgId = (Date.now() + 1).toString()
+        streamingContentRef.current = ''
+        streamingMessageIdRef.current = aiMsgId
+
+        // Optimistic update for AI message start
+        setMessages(prev => {
+            const newMessages = [...prev, {
+                id: aiMsgId,
+                role: 'ai' as const,
+                content: '',
+                timestamp: Date.now()
+            }]
+            return newMessages.length > MAX_MESSAGES
+                ? newMessages.slice(-MAX_MESSAGES)
+                : newMessages
+        })
+
+        // Append thinking command based on mode
+        const msgWithSuffix = input + (isThinkingMode ? " /think" : " /no_think")
+
+        try {
+            await engineService.chat(msgWithSuffix, handleToken, { thinking: isThinkingMode })
+        } catch (e) {
+            console.error("Chat failed", e)
+            setMessages(prev => [...prev, {
+                id: Date.now().toString(),
+                role: 'ai',
+                content: "❌ Error: Failed to get response from AI.",
+                timestamp: Date.now()
+            }])
+        } finally {
+            setIsTyping(false)
+            streamingMessageIdRef.current = null
+
+            // 确保最终状态同步
+            if (rafIdRef.current !== null) {
+                cancelAnimationFrame(rafIdRef.current)
+                updateStreamingMessage()
+            }
+        }
+    }
+
+    // 渲染模型选择按钮（集成在输入框作为下拉项）
+    const renderModelSelector = () => {
+        // 没有可用模型
+        if (availableModels.length === 0) {
+            return (
+                <button
+                    className="model-btn disabled"
+                    title="请先在设置页面下载模型"
+                >
+                    <Bot size={16} />
+                    <span>无模型</span>
+                </button>
+            )
+        }
+
+        // 只有一个模型，直接显示
+        if (availableModels.length === 1) {
+            return (
+                <button
+                    className={`model-btn ${modelLoaded ? 'loaded' : ''} ${loadingModel ? 'loading' : ''}`}
+                    title={modelLoaded ? "模型已就绪" : "发送消息时自动加载"}
+                >
+                    {loadingModel ? (
+                        <Loader2 size={16} className="spin" />
+                    ) : (
+                        <Bot size={16} />
+                    )}
+                    <span>{loadingModel ? '加载中' : selectedModelInfo?.name || '模型'}</span>
+                </button>
+            )
+        }
+
+        // 多个模型，显示下拉选择
+        return (
+            <div className="model-selector" ref={dropdownRef}>
+                <button
+                    className={`model-btn ${modelLoaded ? 'loaded' : ''} ${loadingModel ? 'loading' : ''}`}
+                    onClick={() => !loadingModel && setShowModelDropdown(!showModelDropdown)}
+                    title="点击选择模型"
+                >
+                    {loadingModel ? (
+                        <Loader2 size={16} className="spin" />
+                    ) : (
+                        <Bot size={16} />
+                    )}
+                    <span>{loadingModel ? '加载中' : selectedModelInfo?.name || '选择模型'}</span>
+                    <ChevronDown size={13} className={showModelDropdown ? 'rotate' : ''} />
+                </button>
+
+                {showModelDropdown && (
+                    <div className="model-dropdown">
+                        {availableModels.map(model => (
+                            <div
+                                key={model.path}
+                                className={`model-option ${selectedModel === model.path ? 'active' : ''}`}
+                                onClick={() => handleSelectModel(model.path)}
+                            >
+                                <span>{model.name}</span>
+                                {selectedModel === model.path && (
+                                    <span className="check">✓</span>
+                                )}
+                            </div>
+                        ))}
+                    </div>
+                )}
+            </div>
+        )
+    }
+
+    return (
+        <div className="ai-chat-page">
+            <div className="chat-main">
+                {messages.length === 0 ? (
+                    <div className="empty-state">
+                        <div className="icon">
+                            <Bot size={40} />
+                        </div>
+                        <h2>AI 为你服务</h2>
+                        <p>
+                            {availableModels.length === 0
+                                ? "请先在设置页面下载模型"
+                                : "输入消息开始对话，模型将自动加载"
+                            }
+                        </p>
+                    </div>
+                ) : (
+                    <Virtuoso
+                        ref={virtuosoRef}
+                        data={messages}
+                        className="messages-list"
+                        initialTopMostItemIndex={messages.length - 1}
+                        followOutput="smooth"
+                        itemContent={(index, message) => (
+                            <MessageBubble key={message.id} message={message} />
+                        )}
+                        components={{
+                            Footer: () => <div className="list-spacer" />
+                        }}
+                    />
+                )}
+
+                <div className="input-area">
+                    <div className="input-wrapper">
+                        <textarea
+                            ref={textareaRef}
+                            value={input}
+                            onChange={e => {
+                                setInput(e.target.value)
+                                e.target.style.height = 'auto'
+                                e.target.style.height = `${Math.min(e.target.scrollHeight, 120)}px`
+                            }}
+                            onKeyDown={e => {
+                                if (e.key === 'Enter' && !e.shiftKey) {
+                                    e.preventDefault()
+                                    handleSend()
+                                    // Reset height after send
+                                    if (textareaRef.current) textareaRef.current.style.height = 'auto'
+                                }
+                            }}
+                            placeholder={availableModels.length === 0 ? "请先下载模型..." : "输入消息..."}
+                            disabled={availableModels.length === 0 || loadingModel}
+                            rows={1}
+                        />
+                        <div className="input-actions">
+                            {renderModelSelector()}
+                            <button
+                                className={`mode-toggle ${isThinkingMode ? 'active' : ''}`}
+                                onClick={() => setIsThinkingMode(!isThinkingMode)}
+                                title={isThinkingMode ? "深度思考模式已开启" : "深度思考模式已关闭"}
+                                disabled={availableModels.length === 0}
+                            >
+                                <Cpu size={18} />
+                            </button>
+                            <button
+                                className="send-btn"
+                                onClick={handleSend}
+                                disabled={!input.trim() || availableModels.length === 0 || isTyping || loadingModel}
+                            >
+                                <Send size={18} />
+                            </button>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    )
+}

src/pages/AnalyticsPage.scss

@@ -47,6 +47,24 @@
   }
 }
 
+.page-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  margin-bottom: 16px;
+
+  h1 {
+    margin: 0;
+  }
+
+  .header-actions {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+  }
+}
+
 @keyframes spin {
   from {
     transform: rotate(0deg);
@@ -293,3 +311,184 @@
     }
   }
 }
+
+// 排除好友弹窗
+.exclude-modal-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.45);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+  backdrop-filter: blur(4px);
+}
+
+.exclude-modal {
+  width: 560px;
+  max-width: calc(100vw - 48px);
+  background: var(--card-bg);
+  border-radius: 16px;
+  border: 1px solid var(--border-color);
+  padding: 20px;
+  box-shadow: 0 20px 60px rgba(0, 0, 0, 0.2);
+
+  .exclude-modal-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: 12px;
+
+    h3 {
+      margin: 0;
+      font-size: 16px;
+      color: var(--text-primary);
+    }
+  }
+
+  .modal-close {
+    width: 32px;
+    height: 32px;
+    border-radius: 50%;
+    border: none;
+    background: var(--bg-tertiary);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    cursor: pointer;
+    color: var(--text-secondary);
+    transition: all 0.15s;
+
+    &:hover {
+      background: var(--bg-hover);
+      color: var(--text-primary);
+    }
+  }
+
+  .exclude-modal-search {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 8px 12px;
+    border-radius: 10px;
+    border: 1px solid var(--border-color);
+    background: var(--bg-primary);
+    margin-bottom: 12px;
+    color: var(--text-tertiary);
+
+    input {
+      flex: 1;
+      border: none;
+      outline: none;
+      background: transparent;
+      color: var(--text-primary);
+      font-size: 13px;
+    }
+
+    .clear-search {
+      background: none;
+      border: none;
+      cursor: pointer;
+      color: var(--text-tertiary);
+      padding: 2px;
+
+      &:hover {
+        color: var(--text-primary);
+      }
+    }
+  }
+
+  .exclude-modal-body {
+    max-height: 420px;
+    overflow: auto;
+    padding-right: 4px;
+  }
+
+  .exclude-loading,
+  .exclude-error,
+  .exclude-empty {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: 8px;
+    color: var(--text-secondary);
+    padding: 24px 0;
+    font-size: 13px;
+  }
+
+  .exclude-list {
+    display: flex;
+    flex-direction: column;
+    gap: 6px;
+  }
+
+  .exclude-item {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    padding: 8px 10px;
+    border-radius: 10px;
+    cursor: pointer;
+    border: 1px solid transparent;
+    transition: all 0.15s;
+    background: var(--bg-primary);
+
+    &:hover {
+      background: var(--bg-tertiary);
+    }
+
+    &.active {
+      border-color: rgba(7, 193, 96, 0.4);
+      background: rgba(7, 193, 96, 0.08);
+    }
+
+    input {
+      margin: 0;
+    }
+  }
+
+  .exclude-avatar {
+    flex-shrink: 0;
+  }
+
+  .exclude-info {
+    display: flex;
+    flex-direction: column;
+    min-width: 0;
+    gap: 2px;
+  }
+
+  .exclude-name {
+    font-size: 14px;
+    color: var(--text-primary);
+    font-weight: 500;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .exclude-username {
+    font-size: 12px;
+    color: var(--text-tertiary);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .exclude-modal-footer {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-top: 16px;
+  }
+
+  .exclude-count {
+    font-size: 12px;
+    color: var(--text-tertiary);
+  }
+
+  .exclude-actions {
+    display: flex;
+    gap: 8px;
+  }
+}

src/pages/AnalyticsPage.tsx

@@ -1,20 +1,51 @@
 import { useState, useEffect, useCallback } from 'react'
 import { useLocation } from 'react-router-dom'
-import { Users, Clock, MessageSquare, Send, Inbox, Calendar, Loader2, RefreshCw, User, Medal } from 'lucide-react'
+import { Users, Clock, MessageSquare, Send, Inbox, Calendar, Loader2, RefreshCw, Medal, UserMinus, Search, X } from 'lucide-react'
 import ReactECharts from 'echarts-for-react'
 import { useAnalyticsStore } from '../stores/analyticsStore'
 import { useThemeStore } from '../stores/themeStore'
 import './AnalyticsPage.scss'
 import { Avatar } from '../components/Avatar'
 
+interface ExcludeCandidate {
+  username: string
+  displayName: string
+  avatarUrl?: string
+  wechatId?: string
+}
+
+const normalizeUsername = (value: string) => value.trim().toLowerCase()
+
 function AnalyticsPage() {
   const [isLoading, setIsLoading] = useState(false)
   const [loadingStatus, setLoadingStatus] = useState('')
   const [error, setError] = useState<string | null>(null)
   const [progress, setProgress] = useState(0)
+  const [isExcludeDialogOpen, setIsExcludeDialogOpen] = useState(false)
+  const [excludeCandidates, setExcludeCandidates] = useState<ExcludeCandidate[]>([])
+  const [excludeQuery, setExcludeQuery] = useState('')
+  const [excludeLoading, setExcludeLoading] = useState(false)
+  const [excludeError, setExcludeError] = useState<string | null>(null)
+  const [excludedUsernames, setExcludedUsernames] = useState<Set<string>>(new Set())
+  const [draftExcluded, setDraftExcluded] = useState<Set<string>>(new Set())
 
   const themeMode = useThemeStore((state) => state.themeMode)
-  const { statistics, rankings, timeDistribution, isLoaded, setStatistics, setRankings, setTimeDistribution, markLoaded } = useAnalyticsStore()
+  const { statistics, rankings, timeDistribution, isLoaded, setStatistics, setRankings, setTimeDistribution, markLoaded, clearCache } = useAnalyticsStore()
+
+  const loadExcludedUsernames = useCallback(async () => {
+    try {
+      const result = await window.electronAPI.analytics.getExcludedUsernames()
+      if (result.success && result.data) {
+        setExcludedUsernames(new Set(result.data.map(normalizeUsername)))
+      } else {
+        setExcludedUsernames(new Set())
+      }
+    } catch (e) {
+      console.warn('加载排除名单失败', e)
+      setExcludedUsernames(new Set())
+    }
+  }, [])
+
   const loadData = useCallback(async (forceRefresh = false) => {
     if (isLoaded && !forceRefresh) return
     setIsLoading(true)
@@ -65,14 +96,89 @@ function AnalyticsPage() {
 
   useEffect(() => {
     const handleChange = () => {
+      loadExcludedUsernames()
       loadData(true)
     }
     window.addEventListener('wxid-changed', handleChange as EventListener)
     return () => window.removeEventListener('wxid-changed', handleChange as EventListener)
-  }, [loadData])
+  }, [loadData, loadExcludedUsernames])
+
+  useEffect(() => {
+    loadExcludedUsernames()
+  }, [loadExcludedUsernames])
 
   const handleRefresh = () => loadData(true)
 
+  const loadExcludeCandidates = useCallback(async () => {
+    setExcludeLoading(true)
+    setExcludeError(null)
+    try {
+      const result = await window.electronAPI.analytics.getExcludeCandidates()
+      if (result.success && result.data) {
+        setExcludeCandidates(result.data)
+      } else {
+        setExcludeError(result.error || '加载好友列表失败')
+      }
+    } catch (e) {
+      setExcludeError(String(e))
+    } finally {
+      setExcludeLoading(false)
+    }
+  }, [])
+
+  const openExcludeDialog = async () => {
+    setExcludeQuery('')
+    setDraftExcluded(new Set(excludedUsernames))
+    setIsExcludeDialogOpen(true)
+    await loadExcludeCandidates()
+  }
+
+  const toggleExcluded = (username: string) => {
+    const key = normalizeUsername(username)
+    setDraftExcluded((prev) => {
+      const next = new Set(prev)
+      if (next.has(key)) {
+        next.delete(key)
+      } else {
+        next.add(key)
+      }
+      return next
+    })
+  }
+
+  const handleApplyExcluded = async () => {
+    const payload = Array.from(draftExcluded)
+    setIsExcludeDialogOpen(false)
+    try {
+      const result = await window.electronAPI.analytics.setExcludedUsernames(payload)
+      if (!result.success) {
+        alert(result.error || '更新排除名单失败')
+        return
+      }
+      setExcludedUsernames(new Set((result.data || payload).map(normalizeUsername)))
+      clearCache()
+      await window.electronAPI.cache.clearAnalytics()
+      await loadData(true)
+    } catch (e) {
+      alert(`更新排除名单失败：${String(e)}`)
+    }
+  }
+
+  const visibleExcludeCandidates = excludeCandidates
+    .filter((candidate) => {
+      const query = excludeQuery.trim().toLowerCase()
+      if (!query) return true
+      const wechatId = candidate.wechatId || ''
+      const haystack = `${candidate.displayName} ${candidate.username} ${wechatId}`.toLowerCase()
+      return haystack.includes(query)
+    })
+    .sort((a, b) => {
+      const aSelected = draftExcluded.has(normalizeUsername(a.username))
+      const bSelected = draftExcluded.has(normalizeUsername(b.username))
+      if (aSelected !== bSelected) return aSelected ? -1 : 1
+      return a.displayName.localeCompare(b.displayName, 'zh')
+    })
+
   const formatDate = (timestamp: number | null) => {
     if (!timestamp) return '-'
     const date = new Date(timestamp * 1000)
@@ -247,10 +353,16 @@ function AnalyticsPage() {
     <>
       <div className="page-header">
         <h1>私聊分析</h1>
-        <button className="btn btn-secondary" onClick={handleRefresh} disabled={isLoading}>
-          <RefreshCw size={16} className={isLoading ? 'spin' : ''} />
-          {isLoading ? '刷新中...' : '刷新'}
-        </button>
+        <div className="header-actions">
+          <button className="btn btn-secondary" onClick={handleRefresh} disabled={isLoading}>
+            <RefreshCw size={16} className={isLoading ? 'spin' : ''} />
+            {isLoading ? '刷新中...' : '刷新'}
+          </button>
+          <button className="btn btn-secondary" onClick={openExcludeDialog}>
+            <UserMinus size={16} />
+            排除好友{excludedUsernames.size > 0 ? ` (${excludedUsernames.size})` : ''}
+          </button>
+        </div>
       </div>
       <div className="page-scroll">
         <section className="page-section">
@@ -316,6 +428,84 @@ function AnalyticsPage() {
           </div>
         </section>
       </div>
+      {isExcludeDialogOpen && (
+        <div className="exclude-modal-overlay" onClick={() => setIsExcludeDialogOpen(false)}>
+          <div className="exclude-modal" onClick={e => e.stopPropagation()}>
+            <div className="exclude-modal-header">
+              <h3>选择不统计的好友</h3>
+              <button className="modal-close" onClick={() => setIsExcludeDialogOpen(false)}>
+                <X size={18} />
+              </button>
+            </div>
+            <div className="exclude-modal-search">
+              <Search size={16} />
+              <input
+                type="text"
+                placeholder="搜索好友"
+                value={excludeQuery}
+                onChange={e => setExcludeQuery(e.target.value)}
+                disabled={excludeLoading}
+              />
+              {excludeQuery && (
+                <button className="clear-search" onClick={() => setExcludeQuery('')}>
+                  <X size={14} />
+                </button>
+              )}
+            </div>
+            <div className="exclude-modal-body">
+              {excludeLoading && (
+                <div className="exclude-loading">
+                  <Loader2 size={20} className="spin" />
+                  <span>正在加载好友列表...</span>
+                </div>
+              )}
+              {!excludeLoading && excludeError && (
+                <div className="exclude-error">{excludeError}</div>
+              )}
+              {!excludeLoading && !excludeError && (
+                <div className="exclude-list">
+                  {visibleExcludeCandidates.map((candidate) => {
+                    const isChecked = draftExcluded.has(normalizeUsername(candidate.username))
+                    const wechatId = candidate.wechatId?.trim() || candidate.username
+                    return (
+                      <label key={candidate.username} className={`exclude-item ${isChecked ? 'active' : ''}`}>
+                        <input
+                          type="checkbox"
+                          checked={isChecked}
+                          onChange={() => toggleExcluded(candidate.username)}
+                        />
+                        <div className="exclude-avatar">
+                          <Avatar src={candidate.avatarUrl} name={candidate.displayName} size={32} />
+                        </div>
+                        <div className="exclude-info">
+                          <span className="exclude-name">{candidate.displayName}</span>
+                          <span className="exclude-username">{wechatId}</span>
+                        </div>
+                      </label>
+                    )
+                  })}
+                  {visibleExcludeCandidates.length === 0 && (
+                    <div className="exclude-empty">
+                      {excludeQuery.trim() ? '未找到匹配好友' : '暂无可选好友'}
+                    </div>
+                  )}
+                </div>
+              )}
+            </div>
+            <div className="exclude-modal-footer">
+              <span className="exclude-count">已排除 {draftExcluded.size} 人</span>
+              <div className="exclude-actions">
+                <button className="btn btn-secondary" onClick={() => setIsExcludeDialogOpen(false)}>
+                  取消
+                </button>
+                <button className="btn btn-primary" onClick={handleApplyExcluded} disabled={excludeLoading}>
+                  应用
+                </button>
+              </div>
+            </div>
+          </div>
+        </div>
+      )}
     </>
   )
 }

src/pages/AnnualReportPage.scss

@@ -5,6 +5,7 @@
   justify-content: center;
   min-height: 100%;
   text-align: center;
+  padding: 40px 24px;
 }
 
 .header-icon {
@@ -25,6 +26,63 @@
   margin: 0 0 48px;
 }
 
+.report-sections {
+  display: flex;
+  flex-direction: column;
+  gap: 32px;
+  width: min(760px, 100%);
+}
+
+.report-section {
+  width: 100%;
+  background: var(--card-bg);
+  border: 1px solid var(--border-color);
+  border-radius: 20px;
+  padding: 28px;
+  text-align: left;
+}
+
+.section-header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 20px;
+}
+
+.section-title {
+  margin: 0;
+  font-size: 20px;
+  font-weight: 700;
+  color: var(--text-primary);
+}
+
+.section-desc {
+  margin: 8px 0 0;
+  font-size: 14px;
+  color: var(--text-tertiary);
+}
+
+.section-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 10px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--primary) 12%, transparent);
+  color: var(--primary);
+  border: 1px solid color-mix(in srgb, var(--primary) 30%, transparent);
+  font-size: 12px;
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.section-hint {
+  margin: 12px 0 0;
+  font-size: 12px;
+  color: var(--text-tertiary);
+}
+
 .year-grid {
   display: flex;
   flex-wrap: wrap;
@@ -34,6 +92,12 @@
   margin-bottom: 48px;
 }
 
+.report-section .year-grid {
+  justify-content: flex-start;
+  max-width: none;
+  margin-bottom: 24px;
+}
+
 .year-card {
   width: 120px;
   height: 100px;
@@ -104,6 +168,13 @@
     opacity: 0.6;
     cursor: not-allowed;
   }
+
+  &.secondary {
+    background: var(--card-bg);
+    color: var(--text-primary);
+    border: 1px solid var(--border-color);
+    box-shadow: none;
+  }
 }
 
 .spin {

src/pages/AnnualReportPage.tsx

@@ -1,12 +1,15 @@
 import { useState, useEffect } from 'react'
 import { useNavigate } from 'react-router-dom'
-import { Calendar, Loader2, Sparkles } from 'lucide-react'
+import { Calendar, Loader2, Sparkles, Users } from 'lucide-react'
 import './AnnualReportPage.scss'
 
+type YearOption = number | 'all'
+
 function AnnualReportPage() {
   const navigate = useNavigate()
   const [availableYears, setAvailableYears] = useState<number[]>([])
-  const [selectedYear, setSelectedYear] = useState<number | null>(null)
+  const [selectedYear, setSelectedYear] = useState<YearOption | null>(null)
+  const [selectedPairYear, setSelectedPairYear] = useState<YearOption | null>(null)
   const [isLoading, setIsLoading] = useState(true)
   const [isGenerating, setIsGenerating] = useState(false)
   const [loadError, setLoadError] = useState<string | null>(null)
@@ -22,7 +25,8 @@ function AnnualReportPage() {
       const result = await window.electronAPI.annualReport.getAvailableYears()
       if (result.success && result.data && result.data.length > 0) {
         setAvailableYears(result.data)
-        setSelectedYear(result.data[0])
+        setSelectedYear((prev) => prev ?? result.data[0])
+        setSelectedPairYear((prev) => prev ?? result.data[0])
       } else if (!result.success) {
         setLoadError(result.error || '加载年度数据失败')
       }
@@ -35,10 +39,11 @@ function AnnualReportPage() {
   }
 
   const handleGenerateReport = async () => {
-    if (!selectedYear) return
+    if (selectedYear === null) return
     setIsGenerating(true)
     try {
-      navigate(`/annual-report/view?year=${selectedYear}`)
+      const yearParam = selectedYear === 'all' ? 0 : selectedYear
+      navigate(`/annual-report/view?year=${yearParam}`)
     } catch (e) {
       console.error('生成报告失败:', e)
     } finally {
@@ -46,6 +51,12 @@ function AnnualReportPage() {
     }
   }
 
+  const handleGenerateDualReport = () => {
+    if (selectedPairYear === null) return
+    const yearParam = selectedPairYear === 'all' ? 0 : selectedPairYear
+    navigate(`/dual-report?year=${yearParam}`)
+  }
+
   if (isLoading) {
     return (
       <div className="annual-report-page">
@@ -67,42 +78,98 @@ function AnnualReportPage() {
     )
   }
 
+  const yearOptions: YearOption[] = availableYears.length > 0
+    ? ['all', ...availableYears]
+    : []
+
+  const getYearLabel = (value: YearOption | null) => {
+    if (!value) return ''
+    return value === 'all' ? '全部时间' : `${value} 年`
+  }
+
   return (
     <div className="annual-report-page">
       <Sparkles size={32} className="header-icon" />
       <h1 className="page-title">年度报告</h1>
-      <p className="page-desc">选择年份，生成你的微信聊天年度回顾</p>
+      <p className="page-desc">选择年份，回顾你在微信里的点点滴滴</p>
 
-      <div className="year-grid">
-        {availableYears.map(year => (
-          <div
-            key={year}
-            className={`year-card ${selectedYear === year ? 'selected' : ''}`}
-            onClick={() => setSelectedYear(year)}
-          >
-            <span className="year-number">{year}</span>
-            <span className="year-label">年</span>
+      <div className="report-sections">
+        <section className="report-section">
+          <div className="section-header">
+            <div>
+              <h2 className="section-title">总年度报告</h2>
+              <p className="section-desc">包含所有会话与消息</p>
+            </div>
           </div>
-        ))}
-      </div>
 
-      <button
-        className="generate-btn"
-        onClick={handleGenerateReport}
-        disabled={!selectedYear || isGenerating}
-      >
-        {isGenerating ? (
-          <>
-            <Loader2 size={20} className="spin" />
-            <span>正在生成...</span>
-          </>
-        ) : (
-          <>
-            <Sparkles size={20} />
-            <span>生成 {selectedYear} 年度报告</span>
-          </>
-        )}
-      </button>
+          <div className="year-grid">
+            {yearOptions.map(option => (
+              <div
+                key={option}
+                className={`year-card ${option === 'all' ? 'all-time' : ''} ${selectedYear === option ? 'selected' : ''}`}
+                onClick={() => setSelectedYear(option)}
+              >
+                <span className="year-number">{option === 'all' ? '全部' : option}</span>
+                <span className="year-label">{option === 'all' ? '时间' : '年'}</span>
+              </div>
+            ))}
+          </div>
+
+          <button
+            className="generate-btn"
+            onClick={handleGenerateReport}
+            disabled={!selectedYear || isGenerating}
+          >
+            {isGenerating ? (
+              <>
+                <Loader2 size={20} className="spin" />
+                <span>正在生成...</span>
+              </>
+            ) : (
+              <>
+                <Sparkles size={20} />
+                <span>生成 {getYearLabel(selectedYear)} 年度报告</span>
+              </>
+            )}
+          </button>
+        </section>
+
+        <section className="report-section">
+          <div className="section-header">
+            <div>
+              <h2 className="section-title">双人年度报告</h2>
+              <p className="section-desc">选择一位好友，只看你们的私聊</p>
+            </div>
+            <div className="section-badge">
+              <Users size={16} />
+              <span>私聊</span>
+            </div>
+          </div>
+
+          <div className="year-grid">
+            {yearOptions.map(option => (
+              <div
+                key={`pair-${option}`}
+                className={`year-card ${option === 'all' ? 'all-time' : ''} ${selectedPairYear === option ? 'selected' : ''}`}
+                onClick={() => setSelectedPairYear(option)}
+              >
+                <span className="year-number">{option === 'all' ? '全部' : option}</span>
+                <span className="year-label">{option === 'all' ? '时间' : '年'}</span>
+              </div>
+            ))}
+          </div>
+
+          <button
+            className="generate-btn secondary"
+            onClick={handleGenerateDualReport}
+            disabled={!selectedPairYear}
+          >
+            <Users size={20} />
+            <span>选择好友并生成报告</span>
+          </button>
+          <p className="section-hint">从聊天排行中选择好友生成双人报告</p>
+        </section>
+      </div>
     </div>
   )
 }

src/pages/AnnualReportWindow.scss

@@ -43,7 +43,7 @@
 
 // 背景装饰圆点 - 毛玻璃效果
 .bg-decoration {
-  position: absolute; // Changed from fixed
+  position: absolute;
   inset: 0;
   pointer-events: none;
   z-index: 0;
@@ -53,10 +53,10 @@
 .deco-circle {
   position: absolute;
   border-radius: 50%;
-  background: rgba(0, 0, 0, 0.03);
+  background: color-mix(in srgb, var(--primary) 3%, transparent);
   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 +243,7 @@
 }
 
 .exporting-snapshot {
+
   .hero-title,
   .label-text,
   .hero-desc,
@@ -1279,3 +1280,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;
+
+    .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;
+    }
+  }
+}
+
+.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;
+}
+
+@keyframes flowAcross {
+  0% {
+    left: -20%;
+    opacity: 0;
+  }
+
+  10% {
+    opacity: 0.8;
+  }
+
+  50% {
+    opacity: 0.4;
+  }
+
+  90% {
+    opacity: 0.1;
+  }
+
+  100% {
+    left: 120%;
+    opacity: 0;
+  }
+}
+
+@keyframes fadeInRight {
+  from {
+    opacity: 0;
+    transform: translateX(-20px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+
+@keyframes fadeInLeft {
+  from {
+    opacity: 0;
+    transform: translateX(20px);
+  }
+
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}

src/pages/AnnualReportWindow.tsx

@@ -71,6 +71,20 @@ interface AnnualReportData {
   socialInitiative?: { initiatedChats: number; receivedChats: number; initiativeRate: number } | null
   responseSpeed?: { avgResponseTime: number; fastestFriend: string; fastestTime: number } | null
   topPhrases?: { phrase: string; count: number }[]
+  snsStats?: {
+    totalPosts: number
+    typeCounts?: Record<string, number>
+    topLikers: { username: string; displayName: string; avatarUrl?: string; count: number }[]
+    topLiked: { username: string; displayName: string; avatarUrl?: string; count: number }[]
+  }
+  lostFriend: {
+    username: string
+    displayName: string
+    avatarUrl?: string
+    earlyCount: number
+    lateCount: number
+    periodDesc: string
+  } | null
 }
 
 interface SectionInfo {
@@ -95,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)
@@ -274,6 +148,8 @@ function AnnualReportWindow() {
     responseSpeed: useRef<HTMLElement>(null),
     topPhrases: useRef<HTMLElement>(null),
     ranking: useRef<HTMLElement>(null),
+    sns: useRef<HTMLElement>(null),
+    lostFriend: useRef<HTMLElement>(null),
     ending: useRef<HTMLElement>(null),
   }
 
@@ -282,7 +158,8 @@ function AnnualReportWindow() {
   useEffect(() => {
     const params = new URLSearchParams(window.location.hash.split('?')[1] || '')
     const yearParam = params.get('year')
-    const year = yearParam ? parseInt(yearParam) : new Date().getFullYear()
+    const parsedYear = yearParam ? parseInt(yearParam, 10) : new Date().getFullYear()
+    const year = Number.isNaN(parsedYear) ? new Date().getFullYear() : parsedYear
     generateReport(year)
   }, [])
 
@@ -337,6 +214,11 @@ function AnnualReportWindow() {
     return `${Math.round(seconds / 3600)}小时`
   }
 
+  const formatYearLabel = (value: number, withSuffix: boolean = true) => {
+    if (value === 0) return '历史以来'
+    return withSuffix ? `${value}年` : `${value}`
+  }
+
   // 获取可用的板块列表
   const getAvailableSections = (): SectionInfo[] => {
     if (!reportData) return []
@@ -367,10 +249,16 @@ function AnnualReportWindow() {
     if (reportData.responseSpeed) {
       sections.push({ id: 'responseSpeed', name: '回应速度', ref: sectionRefs.responseSpeed })
     }
+    if (reportData.lostFriend) {
+      sections.push({ id: 'lostFriend', name: '曾经的好朋友', ref: sectionRefs.lostFriend })
+    }
     if (reportData.topPhrases && reportData.topPhrases.length > 0) {
       sections.push({ id: 'topPhrases', name: '年度常用语', ref: sectionRefs.topPhrases })
     }
     sections.push({ id: 'ranking', name: '好友排行', ref: sectionRefs.ranking })
+    if (reportData.snsStats && reportData.snsStats.totalPosts > 0) {
+      sections.push({ id: 'sns', name: '朋友圈', ref: sectionRefs.sns })
+    }
     sections.push({ id: 'ending', name: '尾声', ref: sectionRefs.ending })
     return sections
   }
@@ -595,7 +483,8 @@ function AnnualReportWindow() {
 
       const dataUrl = outputCanvas.toDataURL('image/png')
       const link = document.createElement('a')
-      link.download = `${reportData?.year}年度报告${filterIds ? '_自定义' : ''}.png`
+      const yearFilePrefix = reportData ? formatYearLabel(reportData.year, false) : ''
+      link.download = `${yearFilePrefix}年度报告${filterIds ? '_自定义' : ''}.png`
       link.href = dataUrl
       document.body.appendChild(link)
       link.click()
@@ -658,11 +547,12 @@ function AnnualReportWindow() {
     }
 
     setExportProgress('正在写入文件...')
+    const yearFilePrefix = reportData ? formatYearLabel(reportData.year, false) : ''
     const exportResult = await window.electronAPI.annualReport.exportImages({
       baseDir: dirResult.filePaths[0],
-      folderName: `${reportData?.year}年度报告_分模块`,
+      folderName: `${yearFilePrefix}年度报告_分模块`,
       images: exportedImages.map((img) => ({
-        name: `${reportData?.year}年度报告_${img.name}.png`,
+        name: `${yearFilePrefix}年度报告_${img.name}.png`,
         dataUrl: img.data
       }))
     })
@@ -733,10 +623,14 @@ function AnnualReportWindow() {
     )
   }
 
-  const { year, totalMessages, totalFriends, coreFriends, monthlyTopFriends, peakDay, longestStreak, activityHeatmap, midnightKing, selfAvatarUrl, mutualFriend, socialInitiative, responseSpeed, topPhrases } = reportData
+  const { year, totalMessages, totalFriends, coreFriends, monthlyTopFriends, peakDay, longestStreak, activityHeatmap, midnightKing, selfAvatarUrl, mutualFriend, socialInitiative, responseSpeed, topPhrases, lostFriend } = reportData
   const topFriend = coreFriends[0]
   const mostActive = getMostActiveTime(activityHeatmap.data)
   const socialStoryName = topFriend?.displayName || '好友'
+  const yearTitle = formatYearLabel(year, true)
+  const yearTitleShort = formatYearLabel(year, false)
+  const monthlyTitle = year === 0 ? '历史以来月度好友' : `${year}年月度好友`
+  const phrasesTitle = year === 0 ? '你在历史以来的常用语' : `你在${year}年的年度常用语`
 
   return (
     <div className="annual-report-window">
@@ -827,7 +721,7 @@ function AnnualReportWindow() {
           {/* 封面 */}
           <section className="section" ref={sectionRefs.cover}>
             <div className="label-text">WEFLOW · ANNUAL REPORT</div>
-            <h1 className="hero-title">{year}年<br />微信聊天报告</h1>
+            <h1 className="hero-title">{yearTitle}<br />微信聊天报告</h1>
             <hr className="divider" />
             <p className="hero-desc">每一条消息背后<br />都藏着一段独特的故事</p>
           </section>
@@ -869,7 +763,7 @@ function AnnualReportWindow() {
           {/* 月度好友 */}
           <section className="section" ref={sectionRefs.monthlyFriends}>
             <div className="label-text">月度好友</div>
-            <h2 className="hero-title">{year}年月度好友</h2>
+            <h2 className="hero-title">{monthlyTitle}</h2>
             <p className="hero-desc">根据12个月的聊天习惯</p>
             <div className="monthly-orbit">
               {monthlyTopFriends.map((m, i) => (
@@ -883,7 +777,7 @@ function AnnualReportWindow() {
                 <Avatar url={selfAvatarUrl} name="我" size="lg" />
               </div>
             </div>
-            <p className="hero-desc">只要你想<br />我一直在</p>
+            <p className="hero-desc">你只管说<br />我一直在</p>
           </section>
 
           {/* 双向奔赴 */}
@@ -983,15 +877,15 @@ function AnnualReportWindow() {
           {midnightKing && (
             <section className="section" ref={sectionRefs.midnightKing}>
               <div className="label-text">深夜好友</div>
-              <h2 className="hero-title">当城市睡去</h2>
-              <p className="hero-desc">这一年你留下了</p>
+              <h2 className="hero-title">月光下的你</h2>
+              <p className="hero-desc">在这一年你留下了</p>
               <div className="big-stat">
                 <span className="stat-num">{midnightKing.count}</span>
                 <span className="stat-unit">条深夜的消息</span>
               </div>
               <p className="hero-desc">
-                其中 <span className="hl">{midnightKing.displayName}</span> 常常在深夜中陪着你。
-                <br />你和Ta的对话占深夜期间聊天的 <span className="gold">{midnightKing.percentage}%</span>。
+                其中 <span className="hl">{midnightKing.displayName}</span> 常常在深夜中陪着你胡思乱想。
+                <br />你和Ta的对话占你深夜期间聊天的 <span className="gold">{midnightKing.percentage}%</span>。
               </p>
             </section>
           )}
@@ -1012,11 +906,46 @@ function AnnualReportWindow() {
             </section>
           )}
 
+          {/* 曾经的好朋友 */}
+          {lostFriend && (
+            <section className="section" ref={sectionRefs.lostFriend}>
+              <div className="label-text">曾经的好朋友</div>
+              <h2 className="hero-title">{lostFriend.displayName}</h2>
+              <div className="big-stat">
+                <span className="stat-num">{formatNumber(lostFriend.earlyCount)}</span>
+                <span className="stat-unit">条消息</span>
+              </div>
+              <p className="hero-desc">
+                在 <span className="hl">{lostFriend.periodDesc}</span>
+                <br />你们曾有聊不完的话题
+              </p>
+              <div className="lost-friend-visual">
+                <div className="avatar-group sender">
+                  <Avatar url={lostFriend.avatarUrl} name={lostFriend.displayName} size="lg" />
+                  <span className="avatar-label">TA</span>
+                </div>
+                <div className="fading-line">
+                  <div className="line-path" />
+                  <div className="line-glow" />
+                  <div className="flow-particle" />
+                </div>
+                <div className="avatar-group receiver">
+                  <Avatar url={selfAvatarUrl} name="我" size="lg" />
+                  <span className="avatar-label">我</span>
+                </div>
+              </div>
+              <p className="hero-desc fading">
+                人类发明后悔
+                <br />来证明拥有的珍贵
+              </p>
+            </section>
+          )}
+
           {/* 年度常用语 - 词云 */}
           {topPhrases && topPhrases.length > 0 && (
             <section className="section" ref={sectionRefs.topPhrases}>
               <div className="label-text">年度常用语</div>
-              <h2 className="hero-title">你在{year}年的年度常用语</h2>
+              <h2 className="hero-title">{phrasesTitle}</h2>
               <p className="hero-desc">
                 这一年，你说得最多的是：
                 <br />
@@ -1029,6 +958,57 @@ function AnnualReportWindow() {
             </section>
           )}
 
+          {/* 朋友圈 */}
+          {reportData.snsStats && reportData.snsStats.totalPosts > 0 && (
+            <section className="section" ref={sectionRefs.sns}>
+              <div className="label-text">朋友圈</div>
+              <h2 className="hero-title">记录生活时刻</h2>
+              <p className="hero-desc">
+                这一年，你发布了
+              </p>
+              <div className="big-stat">
+                <span className="stat-num">{reportData.snsStats.totalPosts}</span>
+                <span className="stat-unit">条朋友圈</span>
+              </div>
+
+              <div className="sns-stats-container" style={{ display: 'flex', gap: '60px', marginTop: '40px', justifyContent: 'center' }}>
+                {reportData.snsStats.topLikers.length > 0 && (
+                  <div className="sns-sub-stat" style={{ textAlign: 'left' }}>
+                    <h3 className="sub-title" style={{ fontSize: '18px', marginBottom: '16px', opacity: 0.8, borderBottom: '1px solid currentColor', paddingBottom: '8px' }}>更关心你的Ta</h3>
+                    <div className="mini-ranking">
+                      {reportData.snsStats.topLikers.slice(0, 3).map((u, i) => (
+                        <div key={i} className="mini-rank-item" style={{ display: 'flex', alignItems: 'center', gap: '12px', marginBottom: '14px' }}>
+                          <Avatar url={u.avatarUrl} name={u.displayName} size="sm" />
+                          <div style={{ display: 'flex', flexDirection: 'column' }}>
+                            <span className="name" style={{ fontSize: '15px', fontWeight: 500, maxWidth: '120px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}>{u.displayName}</span>
+                          </div>
+                          <span className="count hl" style={{ fontSize: '14px', marginLeft: 'auto' }}>{u.count}赞</span>
+                        </div>
+                      ))}
+                    </div>
+                  </div>
+                )}
+
+                {reportData.snsStats.topLiked.length > 0 && (
+                  <div className="sns-sub-stat" style={{ textAlign: 'left' }}>
+                    <h3 className="sub-title" style={{ fontSize: '18px', marginBottom: '16px', opacity: 0.8, borderBottom: '1px solid currentColor', paddingBottom: '8px' }}>你最关心的Ta</h3>
+                    <div className="mini-ranking">
+                      {reportData.snsStats.topLiked.slice(0, 3).map((u, i) => (
+                        <div key={i} className="mini-rank-item" style={{ display: 'flex', alignItems: 'center', gap: '12px', marginBottom: '14px' }}>
+                          <Avatar url={u.avatarUrl} name={u.displayName} size="sm" />
+                          <div style={{ display: 'flex', flexDirection: 'column' }}>
+                            <span className="name" style={{ fontSize: '15px', fontWeight: 500, maxWidth: '120px', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}>{u.displayName}</span>
+                          </div>
+                          <span className="count hl" style={{ fontSize: '14px', marginLeft: 'auto' }}>{u.count}赞</span>
+                        </div>
+                      ))}
+                    </div>
+                  </div>
+                )}
+              </div>
+            </section>
+          )}
+
           {/* 好友排行 */}
           <section className="section" ref={sectionRefs.ranking}>
             <div className="label-text">好友排行</div>
@@ -1085,7 +1065,7 @@ function AnnualReportWindow() {
               <br />愿新的一年，
               <br />所有期待，皆有回声。
             </p>
-            <div className="ending-year">{year}</div>
+            <div className="ending-year">{yearTitleShort}</div>
             <div className="ending-brand">WEFLOW</div>
           </section>
         </div>

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 {
@@ -2146,8 +2177,7 @@
 }
 
 .video-placeholder,
-.video-loading,
-.video-unavailable {
+.video-loading {
   min-width: 120px;
   min-height: 80px;
   display: flex;
@@ -2167,6 +2197,46 @@
   }
 }
 
+.video-unavailable {
+  min-width: 160px;
+  min-height: 120px;
+  border-radius: 12px;
+  background: var(--bg-tertiary);
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  color: var(--text-tertiary);
+  font-size: 12px;
+  border: none;
+  cursor: pointer;
+  text-align: center;
+  -webkit-app-region: no-drag;
+  transition: transform 0.15s ease, box-shadow 0.15s ease;
+
+  svg {
+    width: 24px;
+    height: 24px;
+    opacity: 0.6;
+  }
+
+  &.clicked {
+    transform: scale(0.98);
+    box-shadow: 0 0 0 2px var(--primary-light);
+  }
+
+  &:disabled {
+    cursor: default;
+    opacity: 0.7;
+  }
+}
+
+.video-action {
+  font-size: 11px;
+  color: var(--text-quaternary);
+}
+
 .video-loading {
   .spin {
     animation: spin 1s linear infinite;
@@ -2419,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;
@@ -2471,4 +2548,272 @@
       color: white;
     }
   }
+
+  .announcement-message {
+    background: rgba(255, 255, 255, 0.15);
+    
+    .announcement-label {
+      color: rgba(255, 255, 255, 0.8);
+    }
+    
+    .announcement-text {
+      color: white;
+    }
+    
+    .announcement-icon {
+      color: white;
+    }
+  }
+}
+
+// 群公告消息
+.announcement-message {
+  display: flex;
+  gap: 12px;
+  align-items: flex-start;
+  padding: 12px 14px;
+  background: var(--hover-color);
+  border-radius: 12px;
+  max-width: 320px;
+  
+  .announcement-icon {
+    flex-shrink: 0;
+    width: 28px;
+    height: 28px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: #f59e42;
+    
+    svg {
+      width: 20px;
+      height: 20px;
+    }
+  }
+  
+  .announcement-content {
+    flex: 1;
+    min-width: 0;
+    
+    .announcement-label {
+      font-size: 12px;
+      color: var(--text-tertiary);
+      margin-bottom: 4px;
+    }
+    
+    .announcement-text {
+      font-size: 14px;
+      color: var(--text-primary);
+      line-height: 1.5;
+      word-break: break-word;
+      white-space: pre-wrap;
+    }
+  }
+}
+
+// 批量转写按钮
+.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/ContactsPage.tsx

@@ -41,15 +41,10 @@ function ContactsPage() {
                 return
             }
             const contactsResult = await window.electronAPI.chat.getContacts()
-            console.log('📞 getContacts结果:', contactsResult)
+            
             if (contactsResult.success && contactsResult.contacts) {
-                console.log('📊 总联系人数:', contactsResult.contacts.length)
-                console.log('📊 按类型统计:', {
-                    friends: contactsResult.contacts.filter((c: ContactInfo) => c.type === 'friend').length,
-                    groups: contactsResult.contacts.filter((c: ContactInfo) => c.type === 'group').length,
-                    officials: contactsResult.contacts.filter((c: ContactInfo) => c.type === 'official').length,
-                    other: contactsResult.contacts.filter((c: ContactInfo) => c.type === 'other').length
-                })
+                
+                
 
                 // 获取头像URL
                 const usernames = contactsResult.contacts.map((c: ContactInfo) => c.username)

src/pages/DualReportPage.scss

@@ -0,0 +1,193 @@
+.dual-report-page {
+  padding: 32px 28px;
+  color: var(--text-primary);
+}
+
+.dual-report-page.loading {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  min-height: 60vh;
+  gap: 12px;
+  color: var(--text-tertiary);
+}
+
+.page-header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 20px;
+
+  h1 {
+    margin: 0;
+    font-size: 24px;
+    font-weight: 700;
+  }
+
+  p {
+    margin: 8px 0 0;
+    color: var(--text-secondary);
+  }
+}
+
+.year-badge {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 10px;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--primary) 12%, transparent);
+  color: var(--primary);
+  border: 1px solid color-mix(in srgb, var(--primary) 30%, transparent);
+  font-size: 12px;
+  font-weight: 600;
+  white-space: nowrap;
+}
+
+.search-bar {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 12px;
+  background: var(--card-bg);
+  border: 1px solid var(--border-color);
+  border-radius: 12px;
+  margin-bottom: 20px;
+
+  input {
+    flex: 1;
+    border: none;
+    outline: none;
+    background: transparent;
+    color: var(--text-primary);
+    font-size: 14px;
+  }
+}
+
+.ranking-list {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.ranking-item {
+  display: grid;
+  grid-template-columns: auto auto 1fr auto;
+  align-items: center;
+  gap: 12px;
+  padding: 12px 16px;
+  background: var(--card-bg);
+  border: 1px solid var(--border-color);
+  border-radius: 14px;
+  text-align: left;
+  cursor: pointer;
+  transition: all 0.2s;
+
+  &:hover {
+    border-color: var(--primary);
+    box-shadow: 0 8px 20px rgba(0, 0, 0, 0.08);
+    transform: translateY(-1px);
+  }
+}
+
+.rank-badge {
+  width: 28px;
+  height: 28px;
+  border-radius: 8px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  background: var(--border-color);
+  color: var(--text-secondary);
+  font-size: 12px;
+  font-weight: 700;
+
+  &.top {
+    background: color-mix(in srgb, var(--primary) 18%, transparent);
+    color: var(--primary);
+  }
+}
+
+.avatar {
+  width: 40px;
+  height: 40px;
+  border-radius: 50%;
+  overflow: hidden;
+  background: var(--primary-light);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--primary);
+  font-weight: 700;
+
+  img {
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+  }
+}
+
+.info {
+  display: flex;
+  flex-direction: column;
+  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-secondary); // 从 tertiary 改为 secondary 以增强对比度
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    opacity: 0.8;
+  }
+}
+
+.meta {
+  text-align: right;
+  font-size: 12px;
+  color: var(--text-secondary); // 改为 secondary
+  flex-shrink: 0;
+
+  .count {
+    font-size: 14px;
+    font-weight: 700;
+    color: var(--primary); // 使用主题色更醒目
+    margin-bottom: 2px;
+  }
+
+  .hint {
+    opacity: 0.7;
+  }
+}
+
+.empty {
+  text-align: center;
+  color: var(--text-tertiary);
+  padding: 40px 0;
+}
+
+.spin {
+  animation: spin 1s linear infinite;
+}
+
+@keyframes spin {
+  from {
+    transform: rotate(0deg);
+  }
+
+  to {
+    transform: rotate(360deg);
+  }
+}

src/pages/DualReportPage.tsx

@@ -0,0 +1,141 @@
+import { useEffect, useMemo, useState } from 'react'
+import { useNavigate } from 'react-router-dom'
+import { Loader2, Search, Users } from 'lucide-react'
+import './DualReportPage.scss'
+
+interface ContactRanking {
+  username: string
+  displayName: string
+  avatarUrl?: string
+  wechatId?: string
+  messageCount: number
+  sentCount: number
+  receivedCount: number
+  lastMessageTime?: number | null
+}
+
+function DualReportPage() {
+  const navigate = useNavigate()
+  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(() => {
+    void loadRankings(year)
+  }, [year])
+
+  const loadRankings = async (reportYear: number) => {
+    setIsLoading(true)
+    setLoadError(null)
+    try {
+      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 {
+        setLoadError(result.error || '加载好友列表失败')
+      }
+    } catch (e) {
+      setLoadError(String(e))
+    } finally {
+      setIsLoading(false)
+    }
+  }
+
+  const yearLabel = year === 0 ? '全部时间' : `${year}年`
+
+  const filteredRankings = useMemo(() => {
+    if (!keyword.trim()) return rankings
+    const q = keyword.trim().toLowerCase()
+    return rankings.filter((item) => {
+      const wechatId = (item.wechatId || '').toLowerCase()
+      return item.displayName.toLowerCase().includes(q) || wechatId.includes(q)
+    })
+  }, [rankings, keyword])
+
+  const handleSelect = (username: string) => {
+    const yearParam = year === 0 ? 0 : year
+    navigate(`/dual-report/view?username=${encodeURIComponent(username)}&year=${yearParam}`)
+  }
+
+  if (isLoading) {
+    return (
+      <div className="dual-report-page loading">
+        <Loader2 size={32} className="spin" />
+        <p>正在加载聊天排行...</p>
+      </div>
+    )
+  }
+
+  if (loadError) {
+    return (
+      <div className="dual-report-page loading">
+        <p>加载失败：{loadError}</p>
+      </div>
+    )
+  }
+
+  return (
+    <div className="dual-report-page">
+      <div className="page-header">
+        <div>
+          <h1>双人年度报告</h1>
+          <p>选择一位好友，生成你们的专属聊天报告</p>
+        </div>
+        <div className="year-badge">
+          <Users size={14} />
+          <span>{yearLabel}</span>
+        </div>
+      </div>
+
+      <div className="search-bar">
+        <Search size={16} />
+        <input
+          value={keyword}
+          onChange={(e) => setKeyword(e.target.value)}
+          placeholder="搜索好友（昵称/微信号）"
+        />
+      </div>
+
+      <div className="ranking-list">
+        {filteredRankings.map((item, index) => (
+          <button
+            key={item.username}
+            className="ranking-item"
+            onClick={() => handleSelect(item.username)}
+          >
+            <span className={`rank-badge ${index < 3 ? 'top' : ''}`}>{index + 1}</span>
+            <div className="avatar">
+              {item.avatarUrl
+                ? <img src={item.avatarUrl} alt={item.displayName} />
+                : <span>{item.displayName.slice(0, 1) || '?'}</span>
+              }
+            </div>
+            <div className="info">
+              <div className="name">{item.displayName}</div>
+              <div className="sub">{item.wechatId || '\u672A\u8bbe\u7f6e\u5fae\u4fe1\u53f7'}</div>
+            </div>
+            <div className="meta">
+              <div className="count">{item.messageCount.toLocaleString()} 条</div>
+              <div className="hint">总消息</div>
+            </div>
+          </button>
+        ))}
+        {filteredRankings.length === 0 ? (
+          <div className="empty">没有匹配的好友</div>
+        ) : null}
+      </div>
+    </div>
+  )
+}
+
+export default DualReportPage

src/pages/DualReportWindow.scss

@@ -0,0 +1,909 @@
+.annual-report-window.dual-report-window {
+  .hero-title {
+    font-size: clamp(22px, 4vw, 34px);
+    white-space: nowrap;
+  }
+
+  .dual-cover-title {
+    font-size: clamp(26px, 5vw, 44px);
+    white-space: normal;
+  }
+
+  .dual-names {
+    font-size: clamp(24px, 4vw, 40px);
+    font-weight: 700;
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    margin: 8px 0 16px;
+    color: var(--ar-text-main);
+
+    .amp {
+      color: var(--ar-primary);
+    }
+  }
+
+  .dual-info-grid {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+    gap: 16px;
+    margin-top: 16px;
+  }
+
+  .dual-info-card {
+    padding: 16px;
+
+    &.full {
+      grid-column: 1 / -1;
+    }
+
+    .info-label {
+      font-size: 12px;
+      color: var(--ar-text-sub);
+      margin-bottom: 8px;
+    }
+
+    .info-value {
+      font-size: 16px;
+      font-weight: 600;
+      color: var(--ar-text-main);
+    }
+  }
+
+  .dual-message-list {
+    margin-top: 16px;
+    display: flex;
+    flex-direction: column;
+    gap: 12px;
+  }
+
+  .dual-message {
+    padding: 14px;
+
+    .message-meta {
+      font-size: 12px;
+      color: var(--ar-text-sub);
+      margin-bottom: 6px;
+    }
+
+    .message-content {
+      font-size: 14px;
+      color: var(--ar-text-main);
+    }
+  }
+
+  .first-chat-scene {
+    padding: 18px 16px 16px;
+    color: var(--ar-text-main);
+    position: relative;
+    overflow: hidden;
+    margin-top: 16px;
+  }
+
+  .first-chat-scene::before {
+    display: none;
+  }
+
+  .scene-title {
+    font-size: 24px;
+    font-weight: 700;
+    text-align: center;
+    margin-bottom: 8px;
+    color: var(--ar-text-main);
+  }
+
+  .scene-subtitle {
+    font-size: 18px;
+    font-weight: 500;
+    text-align: center;
+    margin-bottom: 20px;
+    opacity: 0.9;
+    color: var(--ar-text-sub);
+  }
+
+  .scene-messages {
+    display: flex;
+    flex-direction: column;
+    gap: 16px;
+  }
+
+  .scene-message {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    margin-bottom: 32px;
+    width: 100%;
+
+    &.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: 42px;
+    height: 42px;
+    border-radius: 50%;
+    background: var(--ar-card-bg);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-weight: 700;
+    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 {
+    color: var(--ar-text-main);
+    padding: 10px 14px;
+    width: fit-content;
+    min-width: 40px;
+    max-width: 100%;
+    background: var(--ar-card-bg);
+    border-radius: 12px;
+    position: relative;
+
+    &.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;
+  }
+
+  .scene-avatar.with-image {
+    background: transparent;
+    color: transparent;
+  }
+
+  .scene-message.sent .scene-avatar {
+    border-color: color-mix(in srgb, var(--primary) 30%, var(--bg-tertiary, rgba(0, 0, 0, 0.08)));
+  }
+
+  .dual-stat-grid {
+    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 {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    text-align: center;
+    min-width: 140px;
+    max-width: 280px;
+  }
+
+  .stat-num {
+    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: 14px;
+    margin-top: 4px;
+    opacity: 0.8;
+  }
+
+  .dual-stat-card.long .stat-num {
+    font-size: clamp(18px, 2.4vw, 26px);
+    letter-spacing: -0.02em;
+  }
+
+  .emoji-row {
+    display: grid;
+    grid-template-columns: repeat(2, minmax(260px, 1fr));
+    gap: 20px;
+    margin: 0 -12px;
+  }
+
+  .emoji-card {
+    padding: 18px 16px;
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+    align-items: center;
+    justify-content: center;
+
+    img {
+      width: 64px;
+      height: 64px;
+      object-fit: contain;
+    }
+  }
+
+  .emoji-title {
+    font-size: 12px;
+    color: var(--ar-text-sub);
+  }
+
+  .emoji-placeholder {
+    font-size: 12px;
+    color: var(--ar-text-sub);
+    word-break: break-all;
+    text-align: center;
+  }
+
+  .word-cloud-empty {
+    color: var(--ar-text-sub);
+    font-size: 14px;
+    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;
+    }
+  }
+}

src/pages/DualReportWindow.tsx

@@ -0,0 +1,654 @@
+import { useEffect, useState } from 'react'
+import ReportHeatmap from '../components/ReportHeatmap'
+import ReportWordCloud from '../components/ReportWordCloud'
+import './AnnualReportWindow.scss'
+import './DualReportWindow.scss'
+
+interface DualReportMessage {
+  content: string
+  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?: {
+    createTime: number
+    createTimeStr: string
+    content: string
+    isSentByMe: boolean
+    friendName: string
+    firstThreeMessages: DualReportMessage[]
+    localType?: number
+    emojiMd5?: string
+    emojiCdnUrl?: string
+  } | null
+  stats: {
+    totalMessages: number
+    totalWords: number
+    imageCount: number
+    voiceCount: number
+    emojiCount: number
+    myTopEmojiMd5?: string
+    friendTopEmojiMd5?: string
+    myTopEmojiUrl?: string
+    friendTopEmojiUrl?: string
+    myTopEmojiCount?: number
+    friendTopEmojiCount?: number
+  }
+  topPhrases: 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() {
+  const [reportData, setReportData] = useState<DualReportData | null>(null)
+  const [isLoading, setIsLoading] = useState(true)
+  const [error, setError] = useState<string | null>(null)
+  const [loadingStage, setLoadingStage] = useState('准备中')
+  const [loadingProgress, setLoadingProgress] = useState(0)
+  const [myEmojiUrl, setMyEmojiUrl] = useState<string | null>(null)
+  const [friendEmojiUrl, setFriendEmojiUrl] = useState<string | null>(null)
+
+  useEffect(() => {
+    const params = new URLSearchParams(window.location.hash.split('?')[1] || '')
+    const username = params.get('username')
+    const yearParam = params.get('year')
+    const parsedYear = yearParam ? parseInt(yearParam, 10) : 0
+    const year = Number.isNaN(parsedYear) ? 0 : parsedYear
+    if (!username) {
+      setError('缺少好友信息')
+      setIsLoading(false)
+      return
+    }
+    generateReport(username, year)
+  }, [])
+
+  const generateReport = async (friendUsername: string, year: number) => {
+    setIsLoading(true)
+    setError(null)
+    setLoadingProgress(0)
+
+    const removeProgressListener = window.electronAPI.dualReport.onProgress?.((payload: { status: string; progress: number }) => {
+      setLoadingProgress(payload.progress)
+      setLoadingStage(payload.status)
+    })
+
+    try {
+      const result = await window.electronAPI.dualReport.generateReport({ friendUsername, year })
+      removeProgressListener?.()
+      setLoadingProgress(100)
+      setLoadingStage('完成')
+
+      if (result.success && result.data) {
+        setReportData(result.data)
+        setIsLoading(false)
+      } else {
+        setError(result.error || '生成报告失败')
+        setIsLoading(false)
+      }
+    } catch (e) {
+      removeProgressListener?.()
+      setError(String(e))
+      setIsLoading(false)
+    }
+  }
+
+  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)
+        if (res.success && res.localPath) {
+          setMyEmojiUrl(res.localPath)
+        }
+      }
+      if (stats.friendTopEmojiUrl) {
+        const res = await window.electronAPI.chat.downloadEmoji(stats.friendTopEmojiUrl, stats.friendTopEmojiMd5)
+        if (res.success && res.localPath) {
+          setFriendEmojiUrl(res.localPath)
+        }
+      }
+    }
+    void loadEmojis()
+  }, [reportData])
+
+  if (isLoading) {
+    return (
+      <div className="annual-report-window loading">
+        <div className="loading-ring">
+          <svg viewBox="0 0 100 100">
+            <circle className="ring-bg" cx="50" cy="50" r="42" />
+            <circle
+              className="ring-progress"
+              cx="50" cy="50" r="42"
+              style={{ strokeDashoffset: 264 - (264 * loadingProgress / 100) }}
+            />
+          </svg>
+          <span className="ring-text">{loadingProgress}%</span>
+        </div>
+        <p className="loading-stage">{loadingStage}</p>
+        <p className="loading-hint">进行中</p>
+      </div>
+    )
+  }
+
+  if (error) {
+    return (
+      <div className="annual-report-window error">
+        <p>生成报告失败: {error}</p>
+      </div>
+    )
+  }
+
+  if (!reportData) {
+    return (
+      <div className="annual-report-window error">
+        <p>暂无数据</p>
+      </div>
+    )
+  }
+
+  const yearTitle = reportData.year === 0 ? '全部时间' : `${reportData.year}年`
+  const firstChat = reportData.firstChat
+  const firstChatMessages = (reportData.firstChatMessages && reportData.firstChatMessages.length > 0)
+    ? reportData.firstChatMessages.slice(0, 3)
+    : firstChat
+      ? [{
+        content: firstChat.content,
+        isSentByMe: firstChat.isSentByMe,
+        createTime: firstChat.createTime,
+        createTimeStr: firstChat.createTimeStr
+      }]
+      : []
+  const daysSince = firstChat
+    ? Math.max(0, Math.floor((Date.now() - firstChat.createTime) / 86400000))
+    : 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, 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) => (
+    text
+      .replace(/&amp;/g, '&')
+      .replace(/&lt;/g, '<')
+      .replace(/&gt;/g, '>')
+      .replace(/&quot;/g, '"')
+      .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)
+    if (titleMatch?.[1]) return titleMatch[1]
+    const descMatch = content.match(/<des>([\s\S]*?)<\/des>/i)
+    if (descMatch?.[1]) return descMatch[1]
+    const summaryMatch = content.match(/<summary>([\s\S]*?)<\/summary>/i)
+    if (summaryMatch?.[1]) return summaryMatch[1]
+    const contentMatch = content.match(/<content>([\s\S]*?)<\/content>/i)
+    if (contentMatch?.[1]) return contentMatch[1]
+    return ''
+  }
+
+  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
+
+    if (!looksLikeXml) return raw
+
+    // 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)
+    const year = d.getFullYear()
+    const month = String(d.getMonth() + 1).padStart(2, '0')
+    const day = String(d.getDate()).padStart(2, '0')
+    const hour = String(d.getHours()).padStart(2, '0')
+    const minute = String(d.getMinutes()).padStart(2, '0')
+    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" />
+
+      <div className="bg-decoration">
+        <div className="deco-circle c1" />
+        <div className="deco-circle c2" />
+        <div className="deco-circle c3" />
+        <div className="deco-circle c4" />
+        <div className="deco-circle c5" />
+      </div>
+
+      <div className="report-scroll-view">
+        <div className="report-container">
+          <section className="section">
+            <div className="label-text">WEFLOW · DUAL REPORT</div>
+            <h1 className="hero-title dual-cover-title">{yearTitle}<br />双人聊天报告</h1>
+            <hr className="divider" />
+            <div className="dual-names">
+              <span>我</span>
+              <span className="amp">&amp;</span>
+              <span>{reportData.friendName}</span>
+            </div>
+            <p className="hero-desc">每一次对话都值得被珍藏</p>
+          </section>
+
+          <section className="section">
+            <div className="label-text">首次聊天</div>
+            <h2 className="hero-title">故事的开始</h2>
+            {firstChat ? (
+              <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="scene-messages">
+                    {renderMessageList(firstChatMessages)}
+                  </div>
+                ) : (
+                  <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 && (!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="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>
+            </section>
+          ) : null}
+
+          {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">
+            <div className="label-text">常用语</div>
+            <h2 className="hero-title">{yearTitle}常用语</h2>
+            <ReportWordCloud words={reportData.topPhrases} />
+          </section>
+
+          <section className="section">
+            <div className="label-text">年度统计</div>
+            <h2 className="hero-title">{yearTitle}数据概览</h2>
+            <div className="dual-stat-grid">
+              {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" 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" 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>
+
+          <section className="section">
+            <div className="label-text">尾声</div>
+            <h2 className="hero-title">谢谢你一直在</h2>
+            <p className="hero-desc">愿我们继续把故事写下去</p>
+          </section>
+        </div>
+      </div>
+    </div>
+  )
+}
+
+export default DualReportWindow

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'
@@ -16,6 +17,10 @@ interface GroupMember {
   username: string
   displayName: string
   avatarUrl?: string
+  nickname?: string
+  alias?: string
+  remark?: string
+  groupNickname?: string
 }
 
 interface GroupMessageRank {
@@ -26,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)
@@ -54,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())))
@@ -67,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) => {
@@ -298,6 +335,10 @@ function GroupAnalyticsPage() {
 
   const renderMemberModal = () => {
     if (!selectedMember) return null
+    const nickname = (selectedMember.nickname || '').trim()
+    const alias = (selectedMember.alias || '').trim()
+    const remark = (selectedMember.remark || '').trim()
+    const groupNickname = (selectedMember.groupNickname || '').trim()
 
     return (
       <div className="member-modal-overlay" onClick={() => setSelectedMember(null)}>
@@ -320,11 +361,40 @@ function GroupAnalyticsPage() {
               </div>
               <div className="detail-row">
                 <span className="detail-label">昵称</span>
-                <span className="detail-value">{selectedMember.displayName}</span>
-                <button className="copy-btn" onClick={() => handleCopy(selectedMember.displayName, 'displayName')}>
-                  {copiedField === 'displayName' ? <Check size={14} /> : <Copy size={14} />}
-                </button>
+                <span className="detail-value">{nickname || '未设置'}</span>
+                {nickname && (
+                  <button className="copy-btn" onClick={() => handleCopy(nickname, 'nickname')}>
+                    {copiedField === 'nickname' ? <Check size={14} /> : <Copy size={14} />}
+                  </button>
+                )}
               </div>
+              {alias && (
+                <div className="detail-row">
+                  <span className="detail-label">微信号</span>
+                  <span className="detail-value">{alias}</span>
+                  <button className="copy-btn" onClick={() => handleCopy(alias, 'alias')}>
+                    {copiedField === 'alias' ? <Check size={14} /> : <Copy size={14} />}
+                  </button>
+                </div>
+              )}
+              {groupNickname && (
+                <div className="detail-row">
+                  <span className="detail-label">群昵称</span>
+                  <span className="detail-value">{groupNickname}</span>
+                  <button className="copy-btn" onClick={() => handleCopy(groupNickname, 'groupNickname')}>
+                    {copiedField === 'groupNickname' ? <Check size={14} /> : <Copy size={14} />}
+                  </button>
+                </div>
+              )}
+              {remark && (
+                <div className="detail-row">
+                  <span className="detail-label">备注</span>
+                  <span className="detail-value">{remark}</span>
+                  <button className="copy-btn" onClick={() => handleCopy(remark, 'remark')}>
+                    {copiedField === 'remark' ? <Check size={14} /> : <Copy size={14} />}
+                  </button>
+                </div>
+              )}
             </div>
           </div>
         </div>

src/pages/ImageWindow.scss

@@ -0,0 +1,99 @@
+.image-window-container {
+    width: 100vw;
+    height: 100vh;
+    background-color: var(--bg-primary);
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    user-select: none;
+
+    .title-bar {
+        height: 40px;
+        min-height: 40px;
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+        background: var(--bg-secondary);
+        border-bottom: 1px solid var(--border-color);
+        padding-right: 140px; // 为原生窗口控件留出空间
+
+        .window-drag-area {
+            flex: 1;
+            height: 100%;
+            -webkit-app-region: drag;
+        }
+
+        .title-bar-controls {
+            display: flex;
+            align-items: center;
+            gap: 8px;
+            -webkit-app-region: no-drag;
+            margin-right: 16px;
+
+            button {
+                background: transparent;
+                border: none;
+                color: var(--text-secondary);
+                cursor: pointer;
+                padding: 6px;
+                border-radius: 4px;
+                display: flex;
+                align-items: center;
+                justify-content: center;
+                transition: all 0.2s;
+
+                &:hover {
+                    background: var(--bg-tertiary);
+                    color: var(--text-primary);
+                }
+            }
+
+            .scale-text {
+                min-width: 50px;
+                text-align: center;
+                color: var(--text-secondary);
+                font-size: 12px;
+                font-variant-numeric: tabular-nums;
+            }
+
+            .divider {
+                width: 1px;
+                height: 14px;
+                background: var(--border-color);
+                margin: 0 4px;
+            }
+        }
+    }
+
+    .image-viewport {
+        flex: 1;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        overflow: hidden;
+        position: relative;
+        cursor: grab;
+
+        &:active {
+            cursor: grabbing;
+        }
+
+        img {
+            max-width: none;
+            max-height: none;
+            object-fit: contain;
+            will-change: transform;
+            box-shadow: 0 4px 20px rgba(0, 0, 0, 0.15);
+            pointer-events: auto;
+        }
+    }
+}
+
+.image-window-empty {
+    height: 100vh;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: var(--text-secondary);
+    background-color: var(--bg-primary);
+}

src/pages/ImageWindow.tsx

@@ -0,0 +1,162 @@
+
+import { useState, useEffect, useRef, useCallback } from 'react'
+import { useSearchParams } from 'react-router-dom'
+import { ZoomIn, ZoomOut, RotateCw, RotateCcw } from 'lucide-react'
+import './ImageWindow.scss'
+
+export default function ImageWindow() {
+    const [searchParams] = useSearchParams()
+    const imagePath = searchParams.get('imagePath')
+    const [scale, setScale] = useState(1)
+    const [rotation, setRotation] = useState(0)
+    const [position, setPosition] = useState({ x: 0, y: 0 })
+    const [initialScale, setInitialScale] = useState(1)
+    const viewportRef = useRef<HTMLDivElement>(null)
+    
+    // 使用 ref 存储拖动状态，避免闭包问题
+    const dragStateRef = useRef({
+        isDragging: false,
+        startX: 0,
+        startY: 0,
+        startPosX: 0,
+        startPosY: 0
+    })
+
+    const handleZoomIn = () => setScale(prev => Math.min(prev + 0.25, 10))
+    const handleZoomOut = () => setScale(prev => Math.max(prev - 0.25, 0.1))
+    const handleRotate = () => setRotation(prev => (prev + 90) % 360)
+    const handleRotateCcw = () => setRotation(prev => (prev - 90 + 360) % 360)
+    
+    // 重置视图
+    const handleReset = useCallback(() => {
+        setScale(1)
+        setRotation(0)
+        setPosition({ x: 0, y: 0 })
+    }, [])
+
+    // 图片加载完成后计算初始缩放
+    const handleImageLoad = useCallback((e: React.SyntheticEvent<HTMLImageElement>) => {
+        const img = e.currentTarget
+        const naturalWidth = img.naturalWidth
+        const naturalHeight = img.naturalHeight
+        
+        if (viewportRef.current) {
+            const viewportWidth = viewportRef.current.clientWidth * 0.9
+            const viewportHeight = viewportRef.current.clientHeight * 0.9
+            const scaleX = viewportWidth / naturalWidth
+            const scaleY = viewportHeight / naturalHeight
+            const fitScale = Math.min(scaleX, scaleY, 1)
+            setInitialScale(fitScale)
+            setScale(1)
+        }
+    }, [])
+
+    // 使用原生事件监听器处理拖动
+    useEffect(() => {
+        const handleMouseMove = (e: MouseEvent) => {
+            if (!dragStateRef.current.isDragging) return
+            
+            const dx = e.clientX - dragStateRef.current.startX
+            const dy = e.clientY - dragStateRef.current.startY
+            
+            setPosition({
+                x: dragStateRef.current.startPosX + dx,
+                y: dragStateRef.current.startPosY + dy
+            })
+        }
+
+        const handleMouseUp = () => {
+            dragStateRef.current.isDragging = false
+            document.body.style.cursor = ''
+        }
+
+        document.addEventListener('mousemove', handleMouseMove)
+        document.addEventListener('mouseup', handleMouseUp)
+
+        return () => {
+            document.removeEventListener('mousemove', handleMouseMove)
+            document.removeEventListener('mouseup', handleMouseUp)
+        }
+    }, [])
+
+    const handleMouseDown = (e: React.MouseEvent) => {
+        if (e.button !== 0) return
+        e.preventDefault()
+        
+        dragStateRef.current = {
+            isDragging: true,
+            startX: e.clientX,
+            startY: e.clientY,
+            startPosX: position.x,
+            startPosY: position.y
+        }
+        document.body.style.cursor = 'grabbing'
+    }
+
+    const handleWheel = useCallback((e: React.WheelEvent) => {
+        const delta = -Math.sign(e.deltaY) * 0.15
+        setScale(prev => Math.min(Math.max(prev + delta, 0.1), 10))
+    }, [])
+
+    // 双击重置
+    const handleDoubleClick = useCallback(() => {
+        handleReset()
+    }, [handleReset])
+
+    // 快捷键支持
+    useEffect(() => {
+        const handleKeyDown = (e: KeyboardEvent) => {
+            if (e.key === 'Escape') window.electronAPI.window.close()
+            if (e.key === '=' || e.key === '+') handleZoomIn()
+            if (e.key === '-') handleZoomOut()
+            if (e.key === 'r' || e.key === 'R') handleRotate()
+            if (e.key === '0') handleReset()
+        }
+        window.addEventListener('keydown', handleKeyDown)
+        return () => window.removeEventListener('keydown', handleKeyDown)
+    }, [handleReset])
+
+    if (!imagePath) {
+        return (
+            <div className="image-window-empty">
+                <span>无效的图片路径</span>
+            </div>
+        )
+    }
+
+    const displayScale = initialScale * scale
+
+    return (
+        <div className="image-window-container">
+            <div className="title-bar">
+                <div className="window-drag-area"></div>
+                <div className="title-bar-controls">
+                    <button onClick={handleZoomOut} title="缩小 (-)"><ZoomOut size={16} /></button>
+                    <span className="scale-text">{Math.round(displayScale * 100)}%</span>
+                    <button onClick={handleZoomIn} title="放大 (+)"><ZoomIn size={16} /></button>
+                    <div className="divider"></div>
+                    <button onClick={handleRotateCcw} title="逆时针旋转"><RotateCcw size={16} /></button>
+                    <button onClick={handleRotate} title="顺时针旋转 (R)"><RotateCw size={16} /></button>
+                </div>
+            </div>
+
+            <div 
+                className="image-viewport" 
+                ref={viewportRef}
+                onWheel={handleWheel}
+                onDoubleClick={handleDoubleClick}
+                onMouseDown={handleMouseDown}
+            >
+                <img
+                    src={imagePath}
+                    alt="Preview"
+                    style={{
+                        transform: `translate(${position.x}px, ${position.y}px) scale(${displayScale}) rotate(${rotation}deg)`
+                    }}
+                    onLoad={handleImageLoad}
+                    draggable={false}
+                />
+            </div>
+        </div>
+    )
+}

src/pages/NotificationWindow.scss

@@ -0,0 +1,54 @@
+@keyframes noti-enter {
+    0% {
+        opacity: 0;
+        transform: translateY(-20px) scale(0.96);
+    }
+
+    100% {
+        opacity: 1;
+        transform: translateY(0) scale(1);
+    }
+}
+
+@keyframes noti-exit {
+    0% {
+        opacity: 1;
+        transform: scale(1) translateY(0);
+        filter: blur(0);
+    }
+
+    100% {
+        opacity: 0;
+        transform: scale(0.92) translateY(4px);
+        filter: blur(2px);
+    }
+}
+
+body {
+    // Ensure the body background is transparent to let the rounded corners show
+    background: transparent;
+    overflow: hidden;
+    margin: 0;
+    padding: 0;
+}
+
+#notification-root {
+    // Ensure the container allows 3D transforms
+    perspective: 1000px;
+}
+
+#notification-current {
+    // New notification slides in
+    animation: noti-enter 0.4s cubic-bezier(0.16, 1, 0.3, 1) forwards;
+    will-change: transform, opacity;
+}
+
+#notification-prev {
+    // Old notification scales out
+    animation: noti-exit 0.35s cubic-bezier(0.33, 1, 0.68, 1) forwards;
+    transform-origin: center top;
+    will-change: transform, opacity, filter;
+
+    // Ensure it stays behind
+    z-index: 0 !important;
+}

src/pages/NotificationWindow.tsx

@@ -0,0 +1,165 @@
+import { useEffect, useState, useRef } from 'react'
+import { NotificationToast, type NotificationData } from '../components/NotificationToast'
+import '../components/NotificationToast.scss'
+import './NotificationWindow.scss'
+
+export default function NotificationWindow() {
+    const [notification, setNotification] = useState<NotificationData | null>(null)
+    const [prevNotification, setPrevNotification] = useState<NotificationData | null>(null)
+
+    // We need a ref to access the current notification inside the callback 
+    // without satisfying the dependency array which would recreate the listener
+    // Actually, setNotification(prev => ...) pattern is better, but we need the VALUE of current to set as prev.
+    // So we use setNotification callback: setNotification(current => { ... return newNode })
+    // But we need to update TWO states.
+    // So we use a ref to track "current displayed" for the event handler.
+    // Or just use functional updates, but we need to setPrev(current).
+
+    const notificationRef = useRef<NotificationData | null>(null)
+
+    useEffect(() => {
+        notificationRef.current = notification
+    }, [notification])
+
+    useEffect(() => {
+        const handleShow = (_event: any, data: any) => {
+            // data: { title, content, avatarUrl, sessionId }
+            const timestamp = Math.floor(Date.now() / 1000)
+            const newNoti: NotificationData = {
+                id: `noti_${timestamp}_${Math.random().toString(36).substr(2, 9)}`,
+                sessionId: data.sessionId,
+                title: data.title,
+                content: data.content,
+                timestamp: timestamp,
+                avatarUrl: data.avatarUrl
+            }
+
+            // Set previous to current (ref)
+            if (notificationRef.current) {
+                setPrevNotification(notificationRef.current)
+            }
+            setNotification(newNoti)
+        }
+
+        if (window.electronAPI) {
+            const remove = window.electronAPI.notification?.onShow?.(handleShow)
+            window.electronAPI.notification?.ready?.()
+            return () => remove?.()
+        }
+    }, [])
+
+    // Clean up prevNotification after transition
+    useEffect(() => {
+        if (prevNotification) {
+            const timer = setTimeout(() => {
+                setPrevNotification(null)
+            }, 400)
+            return () => clearTimeout(timer)
+        }
+    }, [prevNotification])
+
+    const handleClose = () => {
+        setNotification(null)
+        setPrevNotification(null)
+        window.electronAPI.notification?.close()
+    }
+
+    const handleClick = (sessionId: string) => {
+        window.electronAPI.notification?.click(sessionId)
+        setNotification(null)
+        setPrevNotification(null)
+        // Main process handles window hide/close
+    }
+
+    useEffect(() => {
+        // Measure only if we have a notification (current or prev)
+        if (!notification && !prevNotification) return
+
+        // Prefer measuring the NEW one
+        const targetId = notification ? 'notification-current' : 'notification-prev'
+
+        const timer = setTimeout(() => {
+            // Find the wrapper of the content
+            // Since we wrap them, we should measure the content inside
+            // But getting root is easier if size is set by relative child
+            const root = document.getElementById('notification-root')
+            if (root) {
+                const height = root.offsetHeight
+                const width = 344
+                if (window.electronAPI?.notification?.resize) {
+                    const finalHeight = Math.min(height + 4, 300)
+                    window.electronAPI.notification.resize(width, finalHeight)
+                }
+            }
+        }, 50)
+
+        return () => clearTimeout(timer)
+    }, [notification, prevNotification])
+
+    if (!notification && !prevNotification) return null
+
+    return (
+        <div
+            id="notification-root"
+            style={{
+                width: '100vw',
+                height: 'auto',
+                minHeight: '10px',
+                background: 'transparent',
+                position: 'relative', // Context for absolute children
+                overflow: 'hidden', // Prevent scrollbars during transition
+                padding: '2px', // Margin safe
+                boxSizing: 'border-box'
+            }}>
+
+            {/* Previous Notification (Background / Fading Out) */}
+            {prevNotification && (
+                <div
+                    id="notification-prev"
+                    key={prevNotification.id}
+                    style={{
+                        position: 'absolute',
+                        top: 2, // Match padding
+                        left: 2,
+                        width: 'calc(100% - 4px)', // Match width logic
+                        zIndex: 1,
+                        pointerEvents: 'none' // Disable interaction on old one
+                    }}
+                >
+                    <NotificationToast
+                        key={prevNotification.id}
+                        data={prevNotification}
+                        onClose={() => { }} // No-op for background item
+                        onClick={() => { }}
+                        position="top-right"
+                        isStatic={true}
+                        initialVisible={true}
+                    />
+                </div>
+            )}
+
+            {/* Current Notification (Foreground / Fading In) */}
+            {notification && (
+                <div
+                    id="notification-current"
+                    key={notification.id}
+                    style={{
+                        position: 'relative', // Takes up space
+                        zIndex: 2,
+                        width: '100%'
+                    }}
+                >
+                    <NotificationToast
+                        key={notification.id} // Ensure remount for animation
+                        data={notification}
+                        onClose={handleClose}
+                        onClick={handleClick}
+                        position="top-right"
+                        isStatic={true}
+                        initialVisible={true}
+                    />
+                </div>
+            )}
+        </div>
+    )
+}

src/pages/SettingsPage.scss

@@ -180,7 +180,7 @@
     animation: pulse 1.5s ease-in-out infinite;
   }
 
-  input {
+  input:not(.filter-search-box input) {
     width: 100%;
     padding: 10px 16px;
     border: 1px solid var(--border-color);
@@ -207,6 +207,7 @@
   select {
     width: 100%;
     padding: 10px 16px;
+    padding-right: 36px;
     border: 1px solid var(--border-color);
     border-radius: 9999px;
     font-size: 14px;
@@ -214,6 +215,9 @@
     color: var(--text-primary);
     margin-bottom: 10px;
     cursor: pointer;
+    appearance: none;
+    -webkit-appearance: none;
+    -moz-appearance: none;
 
     &:focus {
       outline: none;
@@ -221,6 +225,124 @@
     }
   }
 
+  .select-wrapper {
+    position: relative;
+    margin-bottom: 10px;
+
+    select {
+      margin-bottom: 0;
+    }
+
+    >svg {
+      position: absolute;
+      right: 14px;
+      top: 50%;
+      transform: translateY(-50%);
+      color: var(--text-tertiary);
+      pointer-events: none;
+    }
+  }
+
+  // 自定义下拉选择框
+  .custom-select {
+    position: relative;
+    margin-bottom: 10px;
+  }
+
+  .custom-select-trigger {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    width: 100%;
+    padding: 10px 16px;
+    border: 1px solid var(--border-color);
+    border-radius: 9999px;
+    font-size: 14px;
+    background: var(--bg-primary);
+    color: var(--text-primary);
+    cursor: pointer;
+    transition: all 0.2s;
+
+    &:hover {
+      border-color: var(--text-tertiary);
+    }
+
+    &.open {
+      border-color: var(--primary);
+      box-shadow: 0 0 0 3px color-mix(in srgb, var(--primary) 15%, transparent);
+    }
+  }
+
+  .custom-select-value {
+    flex: 1;
+  }
+
+  .custom-select-arrow {
+    color: var(--text-tertiary);
+    transition: transform 0.2s ease;
+
+    &.rotate {
+      transform: rotate(180deg);
+    }
+  }
+
+  .custom-select-dropdown {
+    position: absolute;
+    top: calc(100% + 6px);
+    left: 0;
+    right: 0;
+    background: color-mix(in srgb, var(--bg-primary) 90%, var(--bg-secondary));
+    border: 1px solid var(--border-color);
+    border-radius: 12px;
+    box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
+    overflow: hidden;
+    z-index: 100;
+    backdrop-filter: blur(12px);
+    -webkit-backdrop-filter: blur(12px);
+
+    // 展开收起动画
+    opacity: 0;
+    visibility: hidden;
+    transform: translateY(-8px) scaleY(0.95);
+    transform-origin: top center;
+    transition: all 0.2s cubic-bezier(0.2, 0, 0.2, 1);
+
+    &.open {
+      opacity: 1;
+      visibility: visible;
+      transform: translateY(0) scaleY(1);
+    }
+  }
+
+  .custom-select-option {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 12px 16px;
+    font-size: 14px;
+    color: var(--text-primary);
+    cursor: pointer;
+    transition: background 0.15s;
+
+    &:hover {
+      background: var(--bg-tertiary);
+    }
+
+    &.selected {
+      color: var(--primary);
+      font-weight: 500;
+
+      svg {
+        color: var(--primary);
+      }
+    }
+
+    svg {
+      flex-shrink: 0;
+    }
+  }
+
+
   .select-field {
     position: relative;
     margin-bottom: 10px;
@@ -529,14 +651,80 @@
   align-items: center;
   justify-content: space-between;
   gap: 12px;
-  margin-top: 6px;
+  margin-top: 10px;
+  padding: 12px 16px;
+  background: var(--bg-primary);
+  border-radius: 12px;
+  border: 1px solid var(--border-color);
+  transition: all 0.2s;
+
+  &:hover {
+    border-color: var(--text-tertiary);
+    background: color-mix(in srgb, var(--bg-primary) 98%, var(--primary));
+  }
 }
 
 .log-status {
   font-size: 13px;
+  font-weight: 500;
   color: var(--text-secondary);
 }
 
+/* Premium Switch Style */
+.switch {
+  position: relative;
+  display: inline-block;
+  width: 44px;
+  height: 24px;
+  flex-shrink: 0;
+
+  input {
+    opacity: 0;
+    width: 0;
+    height: 0;
+
+    &:checked+.switch-slider {
+      background-color: var(--primary);
+      box-shadow: 0 0 8px color-mix(in srgb, var(--primary) 30%, transparent);
+
+      &::before {
+        transform: translateX(18px);
+        background-color: white;
+      }
+    }
+
+    &:focus+.switch-slider {
+      box-shadow: 0 0 1px var(--primary);
+    }
+  }
+
+  .switch-slider {
+    position: absolute;
+    cursor: pointer;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    background-color: var(--bg-tertiary);
+    transition: .4s cubic-bezier(0.4, 0, 0.2, 1);
+    border-radius: 24px;
+    border: 1px solid var(--border-color);
+
+    &::before {
+      position: absolute;
+      content: "";
+      height: 18px;
+      width: 18px;
+      left: 2px;
+      bottom: 2px;
+      background-color: var(--text-tertiary);
+      transition: .4s cubic-bezier(0.4, 0, 0.2, 1);
+      border-radius: 50%;
+      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+    }
+  }
+}
+
 .language-checkboxes {
   display: flex;
   flex-wrap: wrap;
@@ -1003,6 +1191,109 @@
   }
 }
 
+// 通用弹窗覆盖层
+.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 {
@@ -1265,3 +1556,550 @@
   display: flex;
   justify-content: flex-end;
 }
+
+// 通知过滤双列表容器
+.notification-filter-container {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 16px;
+  margin-top: 12px;
+}
+
+.filter-panel {
+  display: flex;
+  flex-direction: column;
+  background: var(--bg-tertiary);
+  border-radius: 12px;
+  overflow: hidden;
+  border: 1px solid var(--border-color);
+}
+
+.filter-panel-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  padding: 8px 12px;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--text-secondary);
+  background: var(--bg-primary);
+  border-bottom: 1px solid var(--border-color);
+
+  >span {
+    flex-shrink: 0;
+  }
+}
+
+.filter-search-box {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  flex: 1;
+  max-width: 140px;
+  padding: 4px 8px;
+  background: var(--bg-tertiary);
+  border: 1px solid var(--border-color);
+  border-radius: 6px;
+  transition: all 0.2s;
+
+  &:focus-within {
+    border-color: var(--primary);
+    background: var(--bg-primary);
+  }
+
+  svg {
+    flex-shrink: 0;
+    width: 12px;
+    height: 12px;
+    color: var(--text-tertiary);
+  }
+
+  input {
+    flex: 1;
+    min-width: 0;
+    border: none;
+    background: transparent;
+    font-size: 12px;
+    color: var(--text-primary);
+    outline: none;
+
+    &::placeholder {
+      color: var(--text-tertiary);
+    }
+  }
+}
+
+.filter-panel-count {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 20px;
+  height: 20px;
+  padding: 0 6px;
+  font-size: 12px;
+  font-weight: 600;
+  color: white;
+  background: var(--primary);
+  border-radius: 10px;
+}
+
+.filter-panel-list {
+  flex: 1;
+  min-height: 200px;
+  max-height: 300px;
+  overflow-y: auto;
+  padding: 8px;
+
+  &::-webkit-scrollbar {
+    width: 6px;
+  }
+
+  &::-webkit-scrollbar-track {
+    background: transparent;
+  }
+
+  &::-webkit-scrollbar-thumb {
+    background: var(--border-color);
+    border-radius: 3px;
+  }
+}
+
+.filter-panel-item {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 10px;
+  margin-bottom: 4px;
+  background: var(--bg-primary);
+  border-radius: 8px;
+  cursor: pointer;
+  transition: all 0.15s;
+
+  &:last-child {
+    margin-bottom: 0;
+  }
+
+  &:hover {
+    background: var(--bg-secondary);
+
+    .filter-item-action {
+      opacity: 1;
+      color: var(--primary);
+    }
+  }
+
+  &.selected {
+    background: color-mix(in srgb, var(--primary) 8%, var(--bg-primary));
+    border: 1px solid color-mix(in srgb, var(--primary) 20%, transparent);
+
+    &:hover .filter-item-action {
+      color: var(--danger);
+    }
+  }
+
+  .filter-item-name {
+    flex: 1;
+    font-size: 14px;
+    color: var(--text-primary);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .filter-item-action {
+    font-size: 18px;
+    font-weight: 500;
+    color: var(--text-tertiary);
+    opacity: 0.5;
+    transition: all 0.15s;
+  }
+}
+
+.filter-panel-empty {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  height: 100%;
+  min-height: 100px;
+  font-size: 13px;
+  color: var(--text-tertiary);
+
+  // Add styles for the new model cards
+}
+
+.setting-control.vertical.has-border {
+  border: 1px solid var(--border-color);
+  border-radius: 12px;
+  padding: 16px;
+  background: var(--bg-primary);
+}
+
+.model-status-card {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: 16px;
+}
+
+.model-info {
+  flex: 1;
+  min-width: 0;
+
+  .model-name {
+    font-size: 15px;
+    font-weight: 600;
+    color: var(--text-primary);
+    margin-bottom: 6px;
+  }
+
+  .model-path {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+
+    .status-indicator {
+      display: inline-flex;
+      align-items: center;
+      gap: 4px;
+      font-size: 12px;
+      font-weight: 500;
+
+      &.success {
+        color: #10b981;
+      }
+
+      &.warning {
+        color: #f59e0b;
+      }
+    }
+
+    .path-text {
+      font-size: 12px;
+      color: var(--text-tertiary);
+      font-family: monospace;
+      word-break: break-all;
+    }
+  }
+}
+
+.model-actions {
+  flex-shrink: 0;
+
+  .btn-download {
+    display: inline-flex;
+    align-items: center;
+    gap: 8px;
+    padding: 8px 16px;
+    background: var(--primary);
+    color: white;
+    border: none;
+    border-radius: 999px;
+    font-size: 13px;
+    font-weight: 600;
+    cursor: pointer;
+    transition: all 0.2s cubic-bezier(0.4, 0, 0.2, 1);
+    box-shadow: 0 4px 12px color-mix(in srgb, var(--primary) 25%, transparent);
+
+    &:hover {
+      background: var(--primary-hover);
+      transform: translateY(-1px);
+      box-shadow: 0 6px 16px color-mix(in srgb, var(--primary) 35%, transparent);
+    }
+
+    &:active {
+      transform: translateY(0);
+    }
+
+    svg {
+      flex-shrink: 0;
+    }
+  }
+
+  .download-status {
+    display: flex;
+    flex-direction: column;
+    gap: 6px;
+    width: 280px;
+
+    .status-header,
+    .progress-info {
+      // specific layout class
+      display: flex;
+      justify-content: space-between;
+      align-items: center; // Align vertically
+      width: 100%;
+    }
+
+    .percent {
+      font-size: 14px;
+      font-weight: 700;
+      color: var(--primary);
+      font-family: 'Inter', system-ui, sans-serif;
+    }
+
+    .metrics,
+    .details {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      font-size: 12px;
+      color: var(--text-secondary);
+      font-family: var(--font-mono);
+
+      .speed {
+        color: var(--text-primary);
+        font-weight: 600;
+        opacity: 0.8;
+      }
+    }
+  }
+
+  .progress-bar-mini {
+    width: 100%;
+    height: 6px;
+    background: var(--bg-tertiary);
+    border-radius: 3px;
+    overflow: hidden;
+    border: 1px solid var(--border-color);
+
+    .fill {
+      height: 100%;
+      background: linear-gradient(90deg, var(--primary) 0%, color-mix(in srgb, var(--primary) 80%, white) 100%);
+      border-radius: 3px;
+      transition: width 0.3s ease;
+      position: relative;
+
+      &::after {
+        content: '';
+        position: absolute;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        background: linear-gradient(90deg,
+            transparent,
+            rgba(255, 255, 255, 0.2),
+            transparent);
+        animation: progress-shimmer 2s infinite;
+      }
+    }
+  }
+
+  .spin {
+    animation: spin 1s linear infinite;
+  }
+}
+
+@keyframes progress-shimmer {
+  0% {
+    transform: translateX(-100%);
+  }
+
+  100% {
+    transform: translateX(100%);
+  }
+}
+
+.sub-setting {
+  margin-top: 16px;
+  padding-top: 16px;
+  border-top: 1px solid var(--border-color);
+
+  .sub-label {
+    font-size: 13px;
+    color: var(--text-secondary);
+    margin-bottom: 8px;
+  }
+}
+
+.path-selector {
+  display: flex;
+  gap: 8px;
+
+  input {
+    margin-bottom: 0 !important;
+    flex: 1;
+    font-family: monospace;
+    font-size: 12px;
+  }
+
+  .btn-icon {
+    width: 38px;
+    height: 38px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    border-radius: 999px; // Circle
+    border: 1px solid var(--border-color);
+    background: var(--bg-primary);
+    color: var(--text-secondary);
+    cursor: pointer;
+    transition: all 0.2s;
+
+    &:hover {
+      color: var(--text-primary);
+      background: var(--bg-tertiary);
+    }
+
+    &.danger:hover {
+      color: var(--danger);
+      background: rgba(220, 38, 38, 0.1);
+      border-color: rgba(220, 38, 38, 0.2);
+    }
+  }
+}
+
+@keyframes spin {
+  from {
+    transform: rotate(0deg);
+  }
+
+  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;
+  }
+}

src/pages/SettingsPage.tsx

@@ -9,22 +9,26 @@ 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
+  ShieldCheck, Fingerprint, Lock, KeyRound, Bell, Globe
 } from 'lucide-react'
+import { Avatar } from '../components/Avatar'
 import './SettingsPage.scss'
 
-type SettingsTab = 'appearance' | 'database' | 'whisper' | 'export' | 'cache' | 'security' | 'about'
+type SettingsTab = 'appearance' | 'notification' | 'database' | 'models' | 'export' | 'cache' | 'api' | 'security' | 'about'
 
 const tabs: { id: SettingsTab; label: string; icon: React.ElementType }[] = [
   { id: 'appearance', label: '外观', icon: Palette },
+  { id: 'notification', label: '通知', icon: Bell },
   { id: 'database', label: '数据库连接', icon: Database },
-  { id: 'whisper', label: '语音识别模型', icon: Mic },
+  { id: 'models', label: '模型管理', icon: Mic },
   { id: 'export', label: '导出', icon: Download },
   { id: 'cache', label: '缓存', icon: HardDrive },
+  { id: 'api', label: 'API 服务', icon: Globe },
   { id: 'security', label: '安全', icon: ShieldCheck },
   { id: 'about', label: '关于', icon: Info }
 ]
 
+
 interface WxidOption {
   wxid: string
   modifiedTime: number
@@ -73,16 +77,42 @@ function SettingsPage() {
   const [whisperModelDir, setWhisperModelDir] = useState('')
   const [isWhisperDownloading, setIsWhisperDownloading] = useState(false)
   const [whisperDownloadProgress, setWhisperDownloadProgress] = useState(0)
+  const [whisperProgressData, setWhisperProgressData] = useState<{ downloaded: number; total: number; speed: number }>({ downloaded: 0, total: 0, speed: 0 })
   const [whisperModelStatus, setWhisperModelStatus] = useState<{ exists: boolean; modelPath?: string; tokensPath?: string } | null>(null)
+  const [llamaModelStatus, setLlamaModelStatus] = useState<{ exists: boolean; path?: string; size?: number } | null>(null)
+  const [isLlamaDownloading, setIsLlamaDownloading] = useState(false)
+  const [llamaDownloadProgress, setLlamaDownloadProgress] = useState(0)
+  const [llamaProgressData, setLlamaProgressData] = useState<{ downloaded: number; total: number; speed: number }>({ downloaded: 0, total: 0, speed: 0 })
+
+  const formatBytes = (bytes: number) => {
+    if (bytes === 0) return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+  };
+
   const [autoTranscribeVoice, setAutoTranscribeVoice] = useState(false)
   const [transcribeLanguages, setTranscribeLanguages] = useState<string[]>(['zh'])
   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)
 
+  const [notificationEnabled, setNotificationEnabled] = useState(true)
+  const [notificationPosition, setNotificationPosition] = useState<'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'>('top-right')
+  const [notificationFilterMode, setNotificationFilterMode] = useState<'all' | 'whitelist' | 'blacklist'>('all')
+  const [notificationFilterList, setNotificationFilterList] = useState<string[]>([])
+  const [filterSearchKeyword, setFilterSearchKeyword] = useState('')
+  const [filterModeDropdownOpen, setFilterModeDropdownOpen] = useState(false)
+  const [positionDropdownOpen, setPositionDropdownOpen] = useState(false)
+
+
+
+
+
   const [isLoading, setIsLoadingState] = useState(false)
   const [isTesting, setIsTesting] = useState(false)
   const [isDetectingPath, setIsDetectingPath] = useState(false)
@@ -108,6 +138,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 可用性
@@ -117,6 +154,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)
@@ -167,6 +220,24 @@ function SettingsPage() {
     }
   }, [])
 
+  // 点击外部关闭自定义下拉框
+  useEffect(() => {
+    const handleClickOutside = (e: MouseEvent) => {
+      const target = e.target as HTMLElement
+      if (!target.closest('.custom-select')) {
+        setFilterModeDropdownOpen(false)
+        setPositionDropdownOpen(false)
+      }
+    }
+    if (filterModeDropdownOpen || positionDropdownOpen) {
+      document.addEventListener('click', handleClickOutside)
+    }
+    return () => {
+      document.removeEventListener('click', handleClickOutside)
+    }
+  }, [filterModeDropdownOpen, positionDropdownOpen])
+
+
   const loadConfig = async () => {
     try {
       const savedKey = await configService.getDecryptKey()
@@ -188,6 +259,11 @@ function SettingsPage() {
       const savedExportDefaultExcelCompactColumns = await configService.getExportDefaultExcelCompactColumns()
       const savedExportDefaultConcurrency = await configService.getExportDefaultConcurrency()
 
+      const savedNotificationEnabled = await configService.getNotificationEnabled()
+      const savedNotificationPosition = await configService.getNotificationPosition()
+      const savedNotificationFilterMode = await configService.getNotificationFilterMode()
+      const savedNotificationFilterList = await configService.getNotificationFilterList()
+
       const savedAuthEnabled = await configService.getAuthEnabled()
       const savedAuthUseHello = await configService.getAuthUseHello()
       setAuthEnabled(savedAuthEnabled)
@@ -217,10 +293,15 @@ function SettingsPage() {
       setExportDefaultFormat(savedExportDefaultFormat || 'excel')
       setExportDefaultDateRange(savedExportDefaultDateRange || 'today')
       setExportDefaultMedia(savedExportDefaultMedia ?? false)
-      setExportDefaultVoiceAsText(savedExportDefaultVoiceAsText ?? true)
+      setExportDefaultVoiceAsText(savedExportDefaultVoiceAsText ?? false)
       setExportDefaultExcelCompactColumns(savedExportDefaultExcelCompactColumns ?? true)
       setExportDefaultConcurrency(savedExportDefaultConcurrency ?? 2)
 
+      setNotificationEnabled(savedNotificationEnabled)
+      setNotificationPosition(savedNotificationPosition)
+      setNotificationFilterMode(savedNotificationFilterMode)
+      setNotificationFilterList(savedNotificationFilterList)
+
       // 如果语言列表为空，保存默认值
       if (!savedTranscribeLanguages || savedTranscribeLanguages.length === 0) {
         const defaultLanguages = ['zh']
@@ -230,6 +311,9 @@ function SettingsPage() {
 
 
       if (savedWhisperModelDir) setWhisperModelDir(savedWhisperModelDir)
+
+      // Load Llama status after config
+      void checkLlamaModelStatus()
     } catch (e: any) {
       console.error('加载配置失败:', e)
     }
@@ -270,7 +354,12 @@ function SettingsPage() {
   }, [])
 
   useEffect(() => {
-    const removeListener = window.electronAPI.whisper?.onDownloadProgress?.((payload: { modelName: string; downloadedBytes: number; totalBytes?: number; percent?: number }) => {
+    const removeListener = window.electronAPI.whisper?.onDownloadProgress?.((payload: { modelName: string; downloadedBytes: number; totalBytes?: number; percent?: number; speed?: number }) => {
+      setWhisperProgressData({
+        downloaded: payload.downloadedBytes,
+        total: payload.totalBytes || 0,
+        speed: payload.speed || 0
+      })
       if (typeof payload.percent === 'number') {
         setWhisperDownloadProgress(payload.percent)
       }
@@ -316,6 +405,19 @@ function SettingsPage() {
     }
   }
 
+  const handleIgnoreUpdate = async () => {
+    if (!updateInfo || !updateInfo.version) return
+
+    try {
+      await window.electronAPI.app.ignoreUpdate(updateInfo.version)
+      setShowUpdateDialog(false)
+      setUpdateInfo(null)
+      showMessage(`已忽略版本 ${updateInfo.version}`, true)
+    } catch (e: any) {
+      showMessage(`操作失败: ${e}`, false)
+    }
+  }
+
 
 
   const showMessage = (text: string, success: boolean) => {
@@ -526,6 +628,7 @@ function SettingsPage() {
         setWhisperModelDir(dir)
         await configService.setWhisperModelDir(dir)
         showMessage('已选择 Whisper 模型目录', true)
+        await checkLlamaModelStatus()
       }
     } catch (e: any) {
       showMessage('选择目录失败', false)
@@ -561,6 +664,68 @@ function SettingsPage() {
   const handleResetWhisperModelDir = async () => {
     setWhisperModelDir('')
     await configService.setWhisperModelDir('')
+    await checkLlamaModelStatus()
+  }
+
+  const checkLlamaModelStatus = async () => {
+    try {
+      // @ts-ignore
+      const modelsPath = await window.electronAPI.llama?.getModelsPath()
+      if (!modelsPath) return
+      const modelName = "Qwen3-4B-Q4_K_M.gguf" // Hardcoded preset for now
+      const fullPath = `${modelsPath}\\${modelName}`
+      // @ts-ignore
+      const status = await window.electronAPI.llama?.getModelStatus(fullPath)
+      if (status) {
+        setLlamaModelStatus({
+          exists: status.exists,
+          path: status.path,
+          size: status.size
+        })
+      }
+    } catch (e) {
+      console.error("Check llama model status failed", e)
+    }
+  }
+
+  useEffect(() => {
+    const handleLlamaProgress = (payload: { downloaded: number; total: number; speed: number }) => {
+      setLlamaProgressData(payload)
+      if (payload.total > 0) {
+        setLlamaDownloadProgress((payload.downloaded / payload.total) * 100)
+      }
+    }
+    // @ts-ignore
+    const removeListener = window.electronAPI.llama?.onDownloadProgress(handleLlamaProgress)
+    return () => {
+      if (typeof removeListener === 'function') removeListener()
+    }
+  }, [])
+
+  const handleDownloadLlamaModel = async () => {
+    if (isLlamaDownloading) return
+    setIsLlamaDownloading(true)
+    setLlamaDownloadProgress(0)
+    try {
+      const modelUrl = "https://www.modelscope.cn/models/Qwen/Qwen3-4B-GGUF/resolve/master/Qwen3-4B-Q4_K_M.gguf"
+      // @ts-ignore
+      const modelsPath = await window.electronAPI.llama?.getModelsPath()
+      const modelName = "Qwen3-4B-Q4_K_M.gguf"
+      const fullPath = `${modelsPath}\\${modelName}`
+
+      // @ts-ignore
+      const result = await window.electronAPI.llama?.downloadModel(modelUrl, fullPath)
+      if (result?.success) {
+        showMessage('Qwen3 模型下载完成', true)
+        await checkLlamaModelStatus()
+      } else {
+        showMessage(`模型下载失败: ${result?.error || '未知错误'}`, false)
+      }
+    } catch (e: any) {
+      showMessage(`模型下载失败: ${e}`, false)
+    } finally {
+      setIsLlamaDownloading(false)
+    }
   }
 
   const handleAutoGetDbKey = async () => {
@@ -829,6 +994,245 @@ function SettingsPage() {
     </div>
   )
 
+  const renderNotificationTab = () => {
+    const { sessions } = useChatStore.getState()
+
+    // 获取已过滤会话的信息
+    const getSessionInfo = (username: string) => {
+      const session = sessions.find(s => s.username === username)
+      return {
+        displayName: session?.displayName || username,
+        avatarUrl: session?.avatarUrl || ''
+      }
+    }
+
+    // 添加会话到过滤列表
+    const handleAddToFilterList = async (username: string) => {
+      if (notificationFilterList.includes(username)) return
+      const newList = [...notificationFilterList, username]
+      setNotificationFilterList(newList)
+      await configService.setNotificationFilterList(newList)
+      showMessage('已添加到过滤列表', true)
+    }
+
+    // 从过滤列表移除会话
+    const handleRemoveFromFilterList = async (username: string) => {
+      const newList = notificationFilterList.filter(u => u !== username)
+      setNotificationFilterList(newList)
+      await configService.setNotificationFilterList(newList)
+      showMessage('已从过滤列表移除', true)
+    }
+
+    // 过滤掉已在列表中的会话，并根据搜索关键字过滤
+    const availableSessions = sessions.filter(s => {
+      if (notificationFilterList.includes(s.username)) return false
+      if (filterSearchKeyword) {
+        const keyword = filterSearchKeyword.toLowerCase()
+        const displayName = (s.displayName || '').toLowerCase()
+        const username = s.username.toLowerCase()
+        return displayName.includes(keyword) || username.includes(keyword)
+      }
+      return true
+    })
+
+    return (
+      <div className="tab-content">
+        <div className="form-group">
+          <label>新消息通知</label>
+          <span className="form-hint">开启后，收到新消息时将显示桌面弹窗通知</span>
+          <div className="log-toggle-line">
+            <span className="log-status">{notificationEnabled ? '已开启' : '已关闭'}</span>
+            <label className="switch" htmlFor="notification-enabled-toggle">
+              <input
+                id="notification-enabled-toggle"
+                className="switch-input"
+                type="checkbox"
+                checked={notificationEnabled}
+                onChange={async (e) => {
+                  const val = e.target.checked
+                  setNotificationEnabled(val)
+                  await configService.setNotificationEnabled(val)
+                  showMessage(val ? '已开启通知' : '已关闭通知', true)
+                }}
+              />
+              <span className="switch-slider" />
+            </label>
+          </div>
+        </div>
+
+        <div className="form-group">
+          <label>通知显示位置</label>
+          <span className="form-hint">选择通知弹窗在屏幕上的显示位置</span>
+          <div className="custom-select">
+            <div
+              className={`custom-select-trigger ${positionDropdownOpen ? 'open' : ''}`}
+              onClick={() => setPositionDropdownOpen(!positionDropdownOpen)}
+            >
+              <span className="custom-select-value">
+                {notificationPosition === 'top-right' ? '右上角' :
+                  notificationPosition === 'bottom-right' ? '右下角' :
+                    notificationPosition === 'top-left' ? '左上角' : '左下角'}
+              </span>
+              <ChevronDown size={14} className={`custom-select-arrow ${positionDropdownOpen ? 'rotate' : ''}`} />
+            </div>
+            <div className={`custom-select-dropdown ${positionDropdownOpen ? 'open' : ''}`}>
+              {[
+                { value: 'top-right', label: '右上角' },
+                { value: 'bottom-right', label: '右下角' },
+                { value: 'top-left', label: '左上角' },
+                { value: 'bottom-left', label: '左下角' }
+              ].map(option => (
+                <div
+                  key={option.value}
+                  className={`custom-select-option ${notificationPosition === option.value ? 'selected' : ''}`}
+                  onClick={async () => {
+                    const val = option.value as 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'
+                    setNotificationPosition(val)
+                    setPositionDropdownOpen(false)
+                    await configService.setNotificationPosition(val)
+                    showMessage('通知位置已更新', true)
+                  }}
+                >
+                  {option.label}
+                  {notificationPosition === option.value && <Check size={14} />}
+                </div>
+              ))}
+            </div>
+          </div>
+        </div>
+
+        <div className="form-group">
+          <label>会话过滤</label>
+          <span className="form-hint">选择只接收特定会话的通知，或屏蔽特定会话的通知</span>
+          <div className="custom-select">
+            <div
+              className={`custom-select-trigger ${filterModeDropdownOpen ? 'open' : ''}`}
+              onClick={() => setFilterModeDropdownOpen(!filterModeDropdownOpen)}
+            >
+              <span className="custom-select-value">
+                {notificationFilterMode === 'all' ? '接收所有通知' :
+                  notificationFilterMode === 'whitelist' ? '仅接收白名单' : '屏蔽黑名单'}
+              </span>
+              <ChevronDown size={14} className={`custom-select-arrow ${filterModeDropdownOpen ? 'rotate' : ''}`} />
+            </div>
+            <div className={`custom-select-dropdown ${filterModeDropdownOpen ? 'open' : ''}`}>
+              {[
+                { value: 'all', label: '接收所有通知' },
+                { value: 'whitelist', label: '仅接收白名单' },
+                { value: 'blacklist', label: '屏蔽黑名单' }
+              ].map(option => (
+                <div
+                  key={option.value}
+                  className={`custom-select-option ${notificationFilterMode === option.value ? 'selected' : ''}`}
+                  onClick={async () => {
+                    const val = option.value as 'all' | 'whitelist' | 'blacklist'
+                    setNotificationFilterMode(val)
+                    setFilterModeDropdownOpen(false)
+                    await configService.setNotificationFilterMode(val)
+                    showMessage(
+                      val === 'all' ? '已设为接收所有通知' :
+                        val === 'whitelist' ? '已设为仅接收白名单通知' : '已设为屏蔽黑名单通知',
+                      true
+                    )
+                  }}
+                >
+                  {option.label}
+                  {notificationFilterMode === option.value && <Check size={14} />}
+                </div>
+              ))}
+            </div>
+          </div>
+        </div>
+
+        {notificationFilterMode !== 'all' && (
+          <div className="form-group">
+            <label>{notificationFilterMode === 'whitelist' ? '白名单会话' : '黑名单会话'}</label>
+            <span className="form-hint">
+              {notificationFilterMode === 'whitelist'
+                ? '点击左侧会话添加到白名单，点击右侧会话从白名单移除'
+                : '点击左侧会话添加到黑名单，点击右侧会话从黑名单移除'}
+            </span>
+
+            <div className="notification-filter-container">
+              {/* 可选会话列表 */}
+              <div className="filter-panel">
+                <div className="filter-panel-header">
+                  <span>可选会话</span>
+                  <div className="filter-search-box">
+                    <Search size={14} />
+                    <input
+                      type="text"
+                      placeholder="搜索会话..."
+                      value={filterSearchKeyword}
+                      onChange={(e) => setFilterSearchKeyword(e.target.value)}
+                    />
+                  </div>
+                </div>
+                <div className="filter-panel-list">
+                  {availableSessions.length > 0 ? (
+                    availableSessions.map(session => (
+                      <div
+                        key={session.username}
+                        className="filter-panel-item"
+                        onClick={() => handleAddToFilterList(session.username)}
+                      >
+                        <Avatar
+                          src={session.avatarUrl}
+                          name={session.displayName || session.username}
+                          size={28}
+                        />
+                        <span className="filter-item-name">{session.displayName || session.username}</span>
+                        <span className="filter-item-action">+</span>
+                      </div>
+                    ))
+                  ) : (
+                    <div className="filter-panel-empty">
+                      {filterSearchKeyword ? '没有匹配的会话' : '暂无可添加的会话'}
+                    </div>
+                  )}
+                </div>
+              </div>
+
+              {/* 已选会话列表 */}
+              <div className="filter-panel">
+                <div className="filter-panel-header">
+                  <span>{notificationFilterMode === 'whitelist' ? '白名单' : '黑名单'}</span>
+                  {notificationFilterList.length > 0 && (
+                    <span className="filter-panel-count">{notificationFilterList.length}</span>
+                  )}
+                </div>
+                <div className="filter-panel-list">
+                  {notificationFilterList.length > 0 ? (
+                    notificationFilterList.map(username => {
+                      const info = getSessionInfo(username)
+                      return (
+                        <div
+                          key={username}
+                          className="filter-panel-item selected"
+                          onClick={() => handleRemoveFromFilterList(username)}
+                        >
+                          <Avatar
+                            src={info.avatarUrl}
+                            name={info.displayName}
+                            size={28}
+                          />
+                          <span className="filter-item-name">{info.displayName}</span>
+                          <span className="filter-item-action">×</span>
+                        </div>
+                      )
+                    })
+                  ) : (
+                    <div className="filter-panel-empty">尚未添加任何会话</div>
+                  )}
+                </div>
+              </div>
+            </div>
+          </div>
+        )}
+      </div>
+    )
+  }
+
   const renderDatabaseTab = () => (
     <div className="tab-content">
       <div className="form-group">
@@ -1014,113 +1418,142 @@ function SettingsPage() {
       </div>
     </div>
   )
-  const renderWhisperTab = () => (
+  const renderModelsTab = () => (
     <div className="tab-content">
       <div className="form-group">
-        <label>自动语音转文字</label>
-        <span className="form-hint">语音解密后自动转写为文字（需下载模型）</span>
-        <div className="log-toggle-line">
-          <span className="log-status">{autoTranscribeVoice ? '已开启' : '已关闭'}</span>
-          <label className="switch" htmlFor="auto-transcribe-toggle">
-            <input
-              id="auto-transcribe-toggle"
-              className="switch-input"
-              type="checkbox"
-              checked={autoTranscribeVoice}
-              onChange={async (e) => {
-                const enabled = e.target.checked
-                setAutoTranscribeVoice(enabled)
-                await configService.setAutoTranscribeVoice(enabled)
-                showMessage(enabled ? '已开启自动转文字' : '已关闭自动转文字', true)
-              }}
-            />
-            <span className="switch-slider" />
-          </label>
-        </div>
+        <label>模型管理</label>
+        <span className="form-hint">管理语音识别和 AI 对话模型</span>
       </div>
+
       <div className="form-group">
-        <label>支持的语言</label>
-        <span className="form-hint">选择需要识别的语言（至少选择一种）</span>
-        <div className="language-checkboxes">
-          {[
-            { code: 'zh', name: '中文' },
-            { code: 'yue', name: '粤语' },
-            { code: 'en', name: '英文' },
-            { code: 'ja', name: '日文' },
-            { code: 'ko', name: '韩文' }
-          ].map((lang) => (
-            <label key={lang.code} className="language-checkbox">
-              <input
-                type="checkbox"
-                checked={transcribeLanguages.includes(lang.code)}
-                onChange={async (e) => {
-                  const checked = e.target.checked
-                  let newLanguages: string[]
+        <label>语音识别模型 (Whisper)</label>
+        <span className="form-hint">用于语音消息转文字功能</span>
 
-                  if (checked) {
-                    newLanguages = [...transcribeLanguages, lang.code]
-                  } else {
-                    if (transcribeLanguages.length <= 1) {
-                      showMessage('至少需要选择一种语言', false)
-                      return
-                    }
-                    newLanguages = transcribeLanguages.filter(l => l !== lang.code)
-                  }
-
-                  setTranscribeLanguages(newLanguages)
-                  await configService.setTranscribeLanguages(newLanguages)
-                  showMessage(`已${checked ? '添加' : '移除'}${lang.name}`, true)
-                }}
-              />
-              <div className="checkbox-custom">
-                <Check size={14} />
-                <span>{lang.name}</span>
+        <div className="setting-control vertical has-border">
+          <div className="model-status-card">
+            <div className="model-info">
+              <div className="model-name">SenseVoiceSmall (245 MB)</div>
+              <div className="model-path">
+                {whisperModelStatus?.exists ? (
+                  <span className="status-indicator success"><Check size={14} /> 已安装</span>
+                ) : (
+                  <span className="status-indicator warning">未安装</span>
+                )}
+                {whisperModelDir && <div className="path-text" title={whisperModelDir}>{whisperModelDir}</div>}
               </div>
-            </label>
-          ))}
-        </div>
-      </div>
-      <div className="form-group whisper-section">
-        <label>语音识别模型 (SenseVoiceSmall)</label>
-        <span className="form-hint">基于 Sherpa-onnx，支持中、粤、英、日、韩及情感/事件识别</span>
-        <span className="form-hint">模型下载目录</span>
-        <input
-          type="text"
-          placeholder="留空使用默认目录"
-          value={whisperModelDir}
-          onChange={(e) => {
-            const value = e.target.value
-            setWhisperModelDir(value)
-            scheduleConfigSave('whisperModelDir', () => configService.setWhisperModelDir(value))
-          }}
-        />
-        <div className="btn-row">
-          <button className="btn btn-secondary" onClick={handleSelectWhisperModelDir}><FolderOpen size={16} /> 选择目录</button>
-          <button className="btn btn-secondary" onClick={handleResetWhisperModelDir}><RotateCcw size={16} /> 默认目录</button>
-        </div>
-        <div className="whisper-status-line">
-          <span className={`status ${whisperModelStatus?.exists ? 'ok' : 'warn'}`}>
-            {whisperModelStatus?.exists ? '已下载 (240 MB)' : '未下载 (240 MB)'}
-          </span>
-          {whisperModelStatus?.modelPath && <span className="path">{whisperModelStatus.modelPath}</span>}
-        </div>
-        {isWhisperDownloading ? (
-          <div className="whisper-progress">
-            <div className="progress-info">
-              <span>正在准备模型文件...</span>
-              <span className="percent">{whisperDownloadProgress.toFixed(0)}%</span>
             </div>
-            <div className="progress-bar-container">
-              <div className="progress-bar">
-                <div className="progress-fill" style={{ width: `${whisperDownloadProgress}%` }} />
-              </div>
+            <div className="model-actions">
+              {!whisperModelStatus?.exists && !isWhisperDownloading && (
+                <button
+                  className="btn-download"
+                  onClick={handleDownloadWhisperModel}
+                >
+                  <Download size={16} /> 下载模型
+                </button>
+              )}
+              {isWhisperDownloading && (
+                <div className="download-status">
+                  <div className="status-header">
+                    <span className="percent">{Math.round(whisperDownloadProgress)}%</span>
+                    {whisperProgressData.total > 0 && (
+                      <span className="details">
+                        {formatBytes(whisperProgressData.downloaded)} / {formatBytes(whisperProgressData.total)}
+                        <span className="speed">({formatBytes(whisperProgressData.speed)}/s)</span>
+                      </span>
+                    )}
+                  </div>
+                  <div className="progress-bar-mini">
+                    <div className="fill" style={{ width: `${whisperDownloadProgress}%` }}></div>
+                  </div>
+                </div>
+              )}
             </div>
           </div>
-        ) : (
-          <button className="btn btn-primary btn-download-model" onClick={handleDownloadWhisperModel}>
-            <Download size={18} /> 下载模型
-          </button>
-        )}
+
+          <div className="sub-setting">
+            <div className="sub-label">自定义模型目录</div>
+            <div className="path-selector">
+              <input
+                type="text"
+                value={whisperModelDir}
+                readOnly
+                placeholder="默认目录"
+              />
+              <button className="btn-icon" onClick={handleSelectWhisperModelDir} title="选择目录">
+                <FolderOpen size={18} />
+              </button>
+              {whisperModelDir && (
+                <button className="btn-icon danger" onClick={handleResetWhisperModelDir} title="重置为默认">
+                  <RotateCcw size={18} />
+                </button>
+              )}
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <div className="form-group">
+        <label>AI 对话模型 (Llama)</label>
+        <span className="form-hint">用于 AI 助手对话功能</span>
+        <div className="setting-control vertical has-border">
+          <div className="model-status-card">
+            <div className="model-info">
+              <div className="model-name">Qwen3 4B (Preset) (~2.6GB)</div>
+              <div className="model-path">
+                {llamaModelStatus?.exists ? (
+                  <span className="status-indicator success"><Check size={14} /> 已安装</span>
+                ) : (
+                  <span className="status-indicator warning">未安装</span>
+                )}
+                {llamaModelStatus?.path && <div className="path-text" title={llamaModelStatus.path}>{llamaModelStatus.path}</div>}
+              </div>
+            </div>
+            <div className="model-actions">
+              {!llamaModelStatus?.exists && !isLlamaDownloading && (
+                <button
+                  className="btn-download"
+                  onClick={handleDownloadLlamaModel}
+                >
+                  <Download size={16} /> 下载模型
+                </button>
+              )}
+              {isLlamaDownloading && (
+                <div className="download-status">
+                  <div className="status-header">
+                    <span className="percent">{Math.floor(llamaDownloadProgress)}%</span>
+                    <span className="metrics">
+                      {formatBytes(llamaProgressData.downloaded)} / {formatBytes(llamaProgressData.total)}
+                      <span className="speed">({formatBytes(llamaProgressData.speed)}/s)</span>
+                    </span>
+                  </div>
+                  <div className="progress-bar-mini">
+                    <div className="fill" style={{ width: `${llamaDownloadProgress}%` }}></div>
+                  </div>
+                </div>
+              )}
+            </div>
+          </div>
+        </div>
+      </div>
+
+      <div className="form-group">
+        <label>自动转文字</label>
+        <span className="form-hint">收到语音消息时自动转换为文字</span>
+        <div className="log-toggle-line">
+          <span className="log-status">{autoTranscribeVoice ? '已开启' : '已关闭'}</span>
+          <label className="switch">
+            <input
+              type="checkbox"
+              className="switch-input"
+              checked={autoTranscribeVoice}
+              onChange={(e) => {
+                setAutoTranscribeVoice(e.target.checked)
+                configService.setAutoTranscribeVoice(e.target.checked)
+              }}
+            />
+            <span className="switch-slider"></span>
+          </label>
+        </div>
       </div>
     </div>
   )
@@ -1132,6 +1565,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 = [
@@ -1426,6 +1860,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 {
@@ -1661,10 +2236,12 @@ function SettingsPage() {
 
       <div className="settings-body">
         {activeTab === 'appearance' && renderAppearanceTab()}
+        {activeTab === 'notification' && renderNotificationTab()}
         {activeTab === 'database' && renderDatabaseTab()}
-        {activeTab === 'whisper' && renderWhisperTab()}
+        {activeTab === 'models' && renderModelsTab()}
         {activeTab === 'export' && renderExportTab()}
         {activeTab === 'cache' && renderCacheTab()}
+        {activeTab === 'api' && renderApiTab()}
         {activeTab === 'security' && renderSecurityTab()}
         {activeTab === 'about' && renderAboutTab()}
       </div>

src/pages/SnsPage.scss

@@ -547,10 +547,41 @@
         .sns-content-wrapper {
             flex: 1;
             display: flex;
+            flex-direction: column;
             overflow: hidden;
             position: relative;
         }
 
+        .sns-notice-banner {
+            margin: 16px 24px 0 24px;
+            padding: 10px 16px;
+            background: rgba(var(--accent-color-rgb), 0.08);
+            border-radius: 10px;
+            border: 1px solid rgba(var(--accent-color-rgb), 0.2);
+            display: flex;
+            align-items: center;
+            gap: 10px;
+            color: var(--accent-color);
+            font-size: 13px;
+            font-weight: 500;
+            animation: banner-slide-down 0.4s cubic-bezier(0.175, 0.885, 0.32, 1.275);
+
+            svg {
+                flex-shrink: 0;
+            }
+        }
+
+        @keyframes banner-slide-down {
+            from {
+                opacity: 0;
+                transform: translateY(-10px);
+            }
+
+            to {
+                opacity: 1;
+                transform: translateY(0);
+            }
+        }
 
         .sns-content {
             flex: 1;

src/pages/SnsPage.tsx

@@ -1,5 +1,5 @@
 import { useEffect, useState, useRef, useCallback, useMemo } from 'react'
-import { RefreshCw, Heart, Search, Calendar, User, X, Filter, Play, ImageIcon, Zap, Download, ChevronRight } from 'lucide-react'
+import { RefreshCw, Heart, Search, Calendar, User, X, Filter, Play, ImageIcon, Zap, Download, ChevronRight, AlertTriangle } from 'lucide-react'
 import { Avatar } from '../components/Avatar'
 import { ImagePreview } from '../components/ImagePreview'
 import JumpToDateDialog from '../components/JumpToDateDialog'
@@ -149,7 +149,7 @@ export default function SnsPage() {
                 const currentPosts = postsRef.current
                 if (currentPosts.length > 0) {
                     const topTs = currentPosts[0].createTime
-                    console.log('[SnsPage] Fetching newer posts starts from:', topTs + 1);
+                    
 
                     const result = await window.electronAPI.sns.getTimeline(
                         limit,
@@ -281,10 +281,10 @@ export default function SnsPage() {
         const checkSchema = async () => {
             try {
                 const schema = await window.electronAPI.chat.execQuery('sns', null, "PRAGMA table_info(SnsTimeLine)");
-                console.log('[SnsPage] SnsTimeLine Schema:', schema);
+                
                 if (schema.success && schema.rows) {
                     const columns = schema.rows.map((r: any) => r.name);
-                    console.log('[SnsPage] Available columns:', columns);
+                    
                 }
             } catch (e) {
                 console.error('[SnsPage] Failed to check schema:', e);
@@ -335,7 +335,7 @@ export default function SnsPage() {
 
         // deltaY < 0 表示向上滚，scrollTop === 0 表示已经在最顶端
         if (e.deltaY < -20 && container.scrollTop <= 0 && hasNewer && !loading && !loadingNewer) {
-            console.log('[SnsPage] Wheel-up detected at top, loading newer posts...');
+            
             loadPosts({ direction: 'newer' })
         }
     }
@@ -412,6 +412,10 @@ export default function SnsPage() {
                     </div>
 
                     <div className="sns-content-wrapper">
+                        <div className="sns-notice-banner">
+                            <AlertTriangle size={16} />
+                            <span>由于技术限制，当前无法解密显示部分图片与视频等加密资源文件</span>
+                        </div>
                         <div className="sns-content custom-scrollbar" onScroll={handleScroll} onWheel={handleWheel} ref={postsContainerRef}>
                             <div className="posts-list">
                                 {loadingNewer && (

src/pages/WelcomePage.scss

@@ -435,6 +435,58 @@
   }
 }
 
+.wxid-select {
+  position: relative;
+}
+
+.wxid-dropdown {
+  position: absolute;
+  top: calc(100% + 6px);
+  left: 0;
+  right: 0;
+  background: var(--bg-primary);
+  border: 1px solid var(--border-color);
+  border-radius: 12px;
+  padding: 6px;
+  max-height: 220px;
+  overflow: auto;
+  z-index: 20;
+  box-shadow: 0 12px 24px rgba(0, 0, 0, 0.08);
+}
+
+.wxid-option {
+  width: 100%;
+  border: none;
+  background: transparent;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 10px 12px;
+  border-radius: 8px;
+  cursor: pointer;
+  color: var(--text-primary);
+  font-size: 13px;
+
+  &:hover {
+    background: var(--bg-hover);
+  }
+
+  &.active {
+    background: var(--primary-light);
+  }
+}
+
+.wxid-name {
+  font-weight: 600;
+}
+
+.wxid-time {
+  color: var(--text-tertiary);
+  font-size: 12px;
+  white-space: nowrap;
+}
+
 .field-with-toggle {
   position: relative;
 }

src/pages/WelcomePage.tsx

@@ -1,4 +1,4 @@
-import { useState, useEffect } from 'react'
+import { useState, useEffect, useRef } from 'react'
 import { useNavigate } from 'react-router-dom'
 import { useAppStore } from '../stores/appStore'
 import { dialog } from '../services/ipc'
@@ -35,6 +35,8 @@ function WelcomePage({ standalone = false }: WelcomePageProps) {
   const [cachePath, setCachePath] = useState('')
   const [wxid, setWxid] = useState('')
   const [wxidOptions, setWxidOptions] = useState<Array<{ wxid: string; modifiedTime: number }>>([])
+  const [showWxidSelect, setShowWxidSelect] = useState(false)
+  const wxidSelectRef = useRef<HTMLDivElement>(null)
   const [error, setError] = useState('')
   const [isConnecting, setIsConnecting] = useState(false)
   const [isDetectingPath, setIsDetectingPath] = useState(false)
@@ -127,8 +129,22 @@ function WelcomePage({ standalone = false }: WelcomePageProps) {
   useEffect(() => {
     setWxidOptions([])
     setWxid('')
+    setShowWxidSelect(false)
   }, [dbPath])
 
+  useEffect(() => {
+    const handleClickOutside = (event: MouseEvent) => {
+      if (!showWxidSelect) return
+      const target = event.target as Node
+      if (wxidSelectRef.current && !wxidSelectRef.current.contains(target)) {
+        setShowWxidSelect(false)
+      }
+    }
+
+    document.addEventListener('mousedown', handleClickOutside)
+    return () => document.removeEventListener('mousedown', handleClickOutside)
+  }, [showWxidSelect])
+
   const currentStep = steps[stepIndex]
   const rootClassName = `welcome-page${isClosing ? ' is-closing' : ''}${standalone ? ' is-standalone' : ''}`
   const showWindowControls = standalone
@@ -217,6 +233,28 @@ function WelcomePage({ standalone = false }: WelcomePageProps) {
     }
   }
 
+  const handleScanWxidCandidates = async () => {
+    if (!dbPath) {
+      setError('请先选择数据库目录')
+      return
+    }
+    if (isScanningWxid) return
+    setIsScanningWxid(true)
+    setError('')
+    try {
+      const wxids = await window.electronAPI.dbPath.scanWxidCandidates(dbPath)
+      setWxidOptions(wxids)
+      setShowWxidSelect(true)
+      if (!wxids.length) {
+        setError('未检测到可用的账号目录，请检查路径')
+      }
+    } catch (e) {
+      setError(`扫描失败: ${e}`)
+    } finally {
+      setIsScanningWxid(false)
+    }
+  }
+
   const handleAutoGetDbKey = async () => {
     if (isFetchingDbKey) return
     setIsFetchingDbKey(true)
@@ -556,14 +594,35 @@ function WelcomePage({ standalone = false }: WelcomePageProps) {
             {currentStep.id === 'key' && (
               <div className="form-group">
                 <label className="field-label">微信账号 (Wxid)</label>
-                <input
-                  type="text"
-                  className="field-input"
-                  placeholder="等待获取..."
-                  value={wxid}
-                  readOnly
-                  onChange={(e) => setWxid(e.target.value)}
-                />
+                <div className="wxid-select" ref={wxidSelectRef}>
+                  <input
+                    type="text"
+                    className="field-input"
+                    placeholder="点击选择..."
+                    value={wxid}
+                    readOnly
+                    onClick={handleScanWxidCandidates}
+                    onChange={(e) => setWxid(e.target.value)}
+                  />
+                  {showWxidSelect && wxidOptions.length > 0 && (
+                    <div className="wxid-dropdown">
+                      {wxidOptions.map((opt) => (
+                        <button
+                          key={opt.wxid}
+                          type="button"
+                          className={`wxid-option ${opt.wxid === wxid ? 'active' : ''}`}
+                          onClick={() => {
+                            setWxid(opt.wxid)
+                            setShowWxidSelect(false)
+                          }}
+                        >
+                          <span className="wxid-name">{opt.wxid}</span>
+                          <span className="wxid-time">{formatModifiedTime(opt.modifiedTime)}</span>
+                        </button>
+                      ))}
+                    </div>
+                  )}
+                </div>
 
                 <label className="field-label mt-4">解密密钥</label>
                 <div className="field-with-toggle">
@@ -733,4 +792,3 @@ function WelcomePage({ standalone = false }: WelcomePageProps) {
 }
 
 export default WelcomePage
-

src/services/EngineService.ts

@@ -0,0 +1,108 @@
+
+export interface ModelInfo {
+    name: string;
+    path: string;
+    downloadUrl?: string; // If it's a known preset
+    size?: number;
+    downloaded: boolean;
+}
+
+export const PRESET_MODELS: ModelInfo[] = [
+    {
+        name: "Qwen3 4B (Preset)",
+        path: "Qwen3-4B-Q4_K_M.gguf",
+        downloadUrl: "https://www.modelscope.cn/models/Qwen/Qwen3-4B-GGUF/resolve/master/Qwen3-4B-Q4_K_M.gguf",
+        downloaded: false
+    }
+];
+
+class EngineService {
+    private onTokenCallback: ((token: string) => void) | null = null;
+    private onProgressCallback: ((percent: number) => void) | null = null;
+    private _removeTokenListener: (() => void) | null = null;
+    private _removeProgressListener: (() => void) | null = null;
+
+    constructor() {
+        // Initialize listeners
+        this._removeTokenListener = window.electronAPI.llama.onToken((token: string) => {
+            if (this.onTokenCallback) {
+                this.onTokenCallback(token);
+            }
+        });
+
+        this._removeProgressListener = window.electronAPI.llama.onDownloadProgress((percent: number) => {
+            if (this.onProgressCallback) {
+                this.onProgressCallback(percent);
+            }
+        });
+    }
+
+    public async checkModelExists(filename: string): Promise<boolean> {
+        const modelsPath = await window.electronAPI.llama.getModelsPath();
+        const fullPath = `${modelsPath}\\${filename}`; // Windows path separator
+        // We might need to handle path separator properly or let main process handle it
+        // Updated preload to take full path or handling in main?
+        // Let's rely on main process exposing join or just checking relative to models dir if implemented
+        // Actually main process `checkFileExists` takes a path.
+        // Let's assume we construct path here or Main helps. 
+        // Better: getModelsPath returns the directory.
+        return await window.electronAPI.llama.checkFileExists(fullPath);
+    }
+
+    public async getModelsPath(): Promise<string> {
+        return await window.electronAPI.llama.getModelsPath();
+    }
+
+    public async loadModel(filename: string) {
+        const modelsPath = await this.getModelsPath();
+        const fullPath = `${modelsPath}\\${filename}`;
+        console.log("Loading model:", fullPath);
+        return await window.electronAPI.llama.loadModel(fullPath);
+    }
+
+    public async createSession(systemPrompt?: string) {
+        return await window.electronAPI.llama.createSession(systemPrompt);
+    }
+
+    public async chat(message: string, onToken: (token: string) => void, options?: { thinking?: boolean }) {
+        this.onTokenCallback = onToken;
+        return await window.electronAPI.llama.chat(message, options);
+    }
+
+    public async downloadModel(url: string, filename: string, onProgress: (percent: number) => void) {
+        const modelsPath = await this.getModelsPath();
+        const fullPath = `${modelsPath}\\${filename}`;
+        this.onProgressCallback = onProgress;
+        return await window.electronAPI.llama.downloadModel(url, fullPath);
+    }
+
+    /**
+     * 清除当前的回调函数引用
+     * 用于避免内存泄漏
+     */
+    public clearCallbacks() {
+        this.onTokenCallback = null;
+        this.onProgressCallback = null;
+    }
+
+    /**
+     * 释放所有资源
+     * 包括事件监听器和回调引用
+     */
+    public dispose() {
+        // 清除回调
+        this.clearCallbacks();
+
+        // 移除事件监听器
+        if (this._removeTokenListener) {
+            this._removeTokenListener();
+            this._removeTokenListener = null;
+        }
+        if (this._removeProgressListener) {
+            this._removeProgressListener();
+            this._removeProgressListener = null;
+        }
+    }
+}
+
+export const engineService = new EngineService();

src/services/config.ts

@@ -35,7 +35,16 @@ export const CONFIG_KEYS = {
   // 安全
   AUTH_ENABLED: 'authEnabled',
   AUTH_PASSWORD: 'authPassword',
-  AUTH_USE_HELLO: 'authUseHello'
+  AUTH_USE_HELLO: 'authUseHello',
+
+  // 更新
+  IGNORED_UPDATE_VERSION: 'ignoredUpdateVersion',
+
+  // 通知
+  NOTIFICATION_ENABLED: 'notificationEnabled',
+  NOTIFICATION_POSITION: 'notificationPosition',
+  NOTIFICATION_FILTER_MODE: 'notificationFilterMode',
+  NOTIFICATION_FILTER_LIST: 'notificationFilterList'
 } as const
 
 export interface WxidConfig {
@@ -399,3 +408,60 @@ export async function getAuthUseHello(): Promise<boolean> {
 export async function setAuthUseHello(useHello: boolean): Promise<void> {
   await config.set(CONFIG_KEYS.AUTH_USE_HELLO, useHello)
 }
+
+// === 更新相关 ===
+
+// 获取被忽略的更新版本
+export async function getIgnoredUpdateVersion(): Promise<string | null> {
+  const value = await config.get(CONFIG_KEYS.IGNORED_UPDATE_VERSION)
+  return (value as string) || null
+}
+
+// 设置被忽略的更新版本
+export async function setIgnoredUpdateVersion(version: string): Promise<void> {
+  await config.set(CONFIG_KEYS.IGNORED_UPDATE_VERSION, version)
+}
+
+// 获取通知开关
+export async function getNotificationEnabled(): Promise<boolean> {
+  const value = await config.get(CONFIG_KEYS.NOTIFICATION_ENABLED)
+  return value !== false // 默认为 true
+}
+
+// 设置通知开关
+export async function setNotificationEnabled(enabled: boolean): Promise<void> {
+  await config.set(CONFIG_KEYS.NOTIFICATION_ENABLED, enabled)
+}
+
+// 获取通知位置
+export async function getNotificationPosition(): Promise<'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'> {
+  const value = await config.get(CONFIG_KEYS.NOTIFICATION_POSITION)
+  return (value as any) || 'top-right'
+}
+
+// 设置通知位置
+export async function setNotificationPosition(position: string): Promise<void> {
+  await config.set(CONFIG_KEYS.NOTIFICATION_POSITION, position)
+}
+
+// 获取通知过滤模式
+export async function getNotificationFilterMode(): Promise<'all' | 'whitelist' | 'blacklist'> {
+  const value = await config.get(CONFIG_KEYS.NOTIFICATION_FILTER_MODE)
+  return (value as any) || 'all'
+}
+
+// 设置通知过滤模式
+export async function setNotificationFilterMode(mode: 'all' | 'whitelist' | 'blacklist'): Promise<void> {
+  await config.set(CONFIG_KEYS.NOTIFICATION_FILTER_MODE, mode)
+}
+
+// 获取通知过滤列表
+export async function getNotificationFilterList(): Promise<string[]> {
+  const value = await config.get(CONFIG_KEYS.NOTIFICATION_FILTER_LIST)
+  return Array.isArray(value) ? value : []
+}
+
+// 设置通知过滤列表
+export async function setNotificationFilterList(list: string[]): Promise<void> {
+  await config.set(CONFIG_KEYS.NOTIFICATION_FILTER_LIST, list)
+}

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/stores/chatStore.ts

@@ -80,11 +80,23 @@ export const useChatStore = create<ChatState>((set, get) => ({
 
   setMessages: (messages) => set({ messages }),
 
-  appendMessages: (newMessages, prepend = false) => set((state) => ({
-    messages: prepend
-      ? [...newMessages, ...state.messages]
-      : [...state.messages, ...newMessages]
-  })),
+  appendMessages: (newMessages, prepend = false) => set((state) => {
+    // 强制去重逻辑
+    const getMsgKey = (m: Message) => {
+      if (m.localId && m.localId > 0) return `l:${m.localId}`
+      return `t:${m.createTime}:${m.sortSeq || 0}:${m.serverId || 0}`
+    }
+    const existingKeys = new Set(state.messages.map(getMsgKey))
+    const filtered = newMessages.filter(m => !existingKeys.has(getMsgKey(m)))
+
+    if (filtered.length === 0) return state
+
+    return {
+      messages: prepend
+        ? [...filtered, ...state.messages]
+        : [...state.messages, ...filtered]
+    }
+  }),
 
   setLoadingMessages: (loading) => set({ isLoadingMessages: loading }),
   setLoadingMore: (loading) => set({ isLoadingMore: loading }),

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/types/electron.d.ts

@@ -11,6 +11,7 @@ export interface ElectronAPI {
     setTitleBarOverlay: (options: { symbolColor: string }) => void
     openVideoPlayerWindow: (videoPath: string, videoWidth?: number, videoHeight?: number) => Promise<void>
     resizeToFitVideo: (videoWidth: number, videoHeight: number) => Promise<void>
+    openImageViewerWindow: (imagePath: string) => Promise<void>
     openChatHistoryWindow: (sessionId: string, messageId: number) => Promise<boolean>
   }
   config: {
@@ -32,6 +33,7 @@ export interface ElectronAPI {
     getVersion: () => Promise<string>
     checkForUpdates: () => Promise<{ hasUpdate: boolean; version?: string; releaseNotes?: string }>
     downloadAndInstall: () => Promise<void>
+    ignoreUpdate: (version: string) => Promise<{ success: boolean }>
     onDownloadProgress: (callback: (progress: number) => void) => () => void
     onUpdateAvailable: (callback: (info: { version: string; releaseNotes: string }) => void) => () => void
   }
@@ -42,6 +44,7 @@ export interface ElectronAPI {
   dbPath: {
     autoDetect: () => Promise<{ success: boolean; path?: string; error?: string }>
     scanWxids: (rootPath: string) => Promise<WxidInfo[]>
+    scanWxidCandidates: (rootPath: string) => Promise<WxidInfo[]>
     getDefault: () => Promise<string>
   }
   wcdb: {
@@ -75,8 +78,14 @@ export interface ElectronAPI {
       messages?: Message[]
       error?: string
     }>
+    getNewMessages: (sessionId: string, minTime: number, limit?: number) => Promise<{
+      success: boolean
+      messages?: Message[]
+      error?: string
+    }>
     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[]
@@ -103,11 +112,13 @@ 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
     execQuery: (kind: string, path: string | null, sql: string) => Promise<{ success: boolean; rows?: any[]; error?: string }>
     getMessage: (sessionId: string, localId: number) => Promise<{ success: boolean; message?: Message; error?: string }>
+    onWcdbChange: (callback: (event: any, data: { type: string; json: string }) => void) => () => void
   }
 
   image: {
@@ -152,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
@@ -174,6 +186,26 @@ export interface ElectronAPI {
       }
       error?: string
     }>
+    getExcludedUsernames: () => Promise<{
+      success: boolean
+      data?: string[]
+      error?: string
+    }>
+    setExcludedUsernames: (usernames: string[]) => Promise<{
+      success: boolean
+      data?: string[]
+      error?: string
+    }>
+    getExcludeCandidates: () => Promise<{
+      success: boolean
+      data?: Array<{
+        username: string
+        displayName: string
+        avatarUrl?: string
+        wechatId?: string
+      }>
+      error?: string
+    }>
     onProgress: (callback: (payload: { status: string; progress: number }) => void) => () => void
   }
   cache: {
@@ -198,6 +230,10 @@ export interface ElectronAPI {
         username: string
         displayName: string
         avatarUrl?: string
+        nickname?: string
+        alias?: string
+        remark?: string
+        groupNickname?: string
       }>
       error?: string
     }>
@@ -316,7 +352,76 @@ export interface ElectronAPI {
     }>
     onProgress: (callback: (payload: { status: string; progress: number }) => void) => () => void
   }
+  dualReport: {
+    generateReport: (payload: { friendUsername: string; year: number }) => Promise<{
+      success: boolean
+      data?: {
+        year: number
+        selfName: string
+        selfAvatarUrl?: string
+        friendUsername: string
+        friendName: string
+        friendAvatarUrl?: string
+        firstChat: {
+          createTime: number
+          createTimeStr: string
+          content: string
+          isSentByMe: boolean
+          senderUsername?: string
+        } | null
+        firstChatMessages?: Array<{
+          content: string
+          isSentByMe: boolean
+          createTime: number
+          createTimeStr: string
+        }>
+        yearFirstChat?: {
+          createTime: number
+          createTimeStr: string
+          content: string
+          isSentByMe: boolean
+          friendName: string
+          firstThreeMessages: Array<{
+            content: string
+            isSentByMe: boolean
+            createTime: number
+            createTimeStr: string
+          }>
+        } | null
+        stats: {
+          totalMessages: number
+          totalWords: number
+          imageCount: number
+          voiceCount: number
+          emojiCount: number
+          myTopEmojiMd5?: string
+          friendTopEmojiMd5?: string
+          myTopEmojiUrl?: string
+          friendTopEmojiUrl?: string
+          myTopEmojiCount?: number
+          friendTopEmojiCount?: number
+        }
+        topPhrases: 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 }
+      }
+      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
@@ -375,6 +480,17 @@ export interface ElectronAPI {
     debugResource: (url: string) => Promise<{ success: boolean; status?: number; headers?: any; error?: string }>
     proxyImage: (url: string) => Promise<{ success: boolean; dataUrl?: string; error?: string }>
   }
+  llama: {
+    loadModel: (modelPath: string) => Promise<boolean>
+    createSession: (systemPrompt?: string) => Promise<boolean>
+    chat: (message: string) => Promise<{ success: boolean; response?: any; error?: string }>
+    downloadModel: (url: string, savePath: string) => Promise<void>
+    getModelsPath: () => Promise<string>
+    checkFileExists: (filePath: string) => Promise<boolean>
+    getModelStatus: (modelPath: string) => Promise<{ exists: boolean; path?: string; size?: number; error?: string }>
+    onToken: (callback: (token: string) => void) => () => void
+    onDownloadProgress: (callback: (payload: { downloaded: number; total: number; speed: number }) => void) => () => void
+  }
 }
 
 export interface ExportOptions {
@@ -397,7 +513,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

@@ -9,6 +9,9 @@ export interface ChatSession {
   lastMsgType: number
   displayName?: string
   avatarUrl?: string
+  lastMsgSender?: string
+  lastSenderDisplayName?: string
+  selfWxid?: string // Helper field to avoid extra API calls
 }
 
 // 联系人
@@ -61,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     // 名片的昵称

vite.config.ts

@@ -33,7 +33,8 @@ export default defineConfig({
                 'fsevents',
                 'whisper-node',
                 'shelljs',
-                'exceljs'
+                'exceljs',
+                'node-llama-cpp'
               ]
             }
           }
@@ -57,6 +58,24 @@ export default defineConfig({
           }
         }
       },
+      {
+        entry: 'electron/dualReportWorker.ts',
+        vite: {
+          build: {
+            outDir: 'dist-electron',
+            rollupOptions: {
+              external: [
+                'koffi',
+                'fsevents'
+              ],
+              output: {
+                entryFileNames: 'dualReportWorker.js',
+                inlineDynamicImports: true
+              }
+            }
+          }
+        }
+      },
       {
         entry: 'electron/imageSearchWorker.ts',
         vite: {