koishi-plugin-chat-patch 2.4.0 → 2.4.4

package/lib/config.d.ts

@@ -3,7 +3,6 @@ export interface Config {
     loggerinfo: boolean;
     clearIndexedDBOnStart: boolean;
     maxMessagesPerChannel: number;
-    keepMessagesOnClear: number;
     maxPersistImages: number;
     blockedPlatforms: Array<{
         platformName: string;

package/lib/file-manager.d.ts

@@ -16,9 +16,10 @@ export declare class FileManager {
     private cleanupOldDataFiles;
     private ensureDir;
     private getChannelFilePath;
-    private readChannelMessages;
+    readChannelMessages(selfId: string, channelId: string): MessageInfo[];
     private writeChannelMessages;
     private readMetadata;
+    readMetadataOnly(): Omit<ChatData, 'messages'>;
     private writeMetadata;
     private loadAllChannelMessages;
     readChatDataFromFile(): ChatData;

package/lib/index.js

@@ -304,7 +304,8 @@ var MessageHandler = class {
   }
   async downloadAndCacheMedia(url, type) {
     try {
-      if (!url || url.startsWith("data:") || url.startsWith("file:")) return url;
+      if (!url || url.startsWith("data:")) return url;
+      if (url.includes("/vite/@fs/")) return url;
       let folder = "media";
       if (type === "image") folder = "images";
       else if (type === "avatar") folder = "avatars";
@@ -317,13 +318,14 @@ var MessageHandler = class {
       const ext = require("node:path").extname(new URL(url).pathname) || (type === "image" ? ".jpg" : ".mp4");
       const filename = `${hash}${ext}`;
       const filePath = require("node:path").join(dir, filename);
-      if (require("node:fs").existsSync(filePath)) {
-        return require("node:url").pathToFileURL(filePath).href;
+      if (!require("node:fs").existsSync(filePath)) {
+        const buffer = await this.ctx.http.get(url, { responseType: "arraybuffer" });
+        require("node:fs").writeFileSync(filePath, Buffer.from(buffer));
       }
-      const buffer = await this.ctx.http.get(url, { responseType: "arraybuffer" });
-      require("node:fs").writeFileSync(filePath, Buffer.from(buffer));
-      return require("node:url").pathToFileURL(filePath).href;
+      const normalizedPath = filePath.replace(/\\/g, "/");
+      return `/vite/@fs/${normalizedPath}`;
     } catch (e) {
+      this.logger.warn("下载并缓存媒体失败:", e);
       return url;
     }
   }
@@ -590,7 +592,7 @@ var FileManager = class {
     this.ensureDir(botDir);
     return import_node_path2.default.join(botDir, `${channelId}.json`);
   }
-  // 读取单个频道的消息
+  // 读取单个频道的消息（公共方法）
   readChannelMessages(selfId, channelId) {
     const filePath = this.getChannelFilePath(selfId, channelId);
     if (!import_node_fs2.default.existsSync(filePath)) {
@@ -645,6 +647,10 @@ var FileManager = class {
       };
     }
   }
+  // 只读取元数据，不加载消息（公共方法）
+  readMetadataOnly() {
+    return this.readMetadata();
+  }
   // 写入元数据
   writeMetadata(metadata) {
     try {
@@ -862,8 +868,8 @@ var ApiHandlers = class {
     });
     this.ctx.console.addListener("get-chat-data", async () => {
       try {
-        const data = this.fileManager.readChatDataFromFile();
-        this.logInfo("获取基础聊天数据");
+        const data = this.fileManager.readMetadataOnly();
+        this.logInfo("获取基础聊天数据（仅元数据）");
         return {
           success: true,
           data: {
@@ -871,6 +877,7 @@ var ApiHandlers = class {
             channels: data.channels || {},
             pinnedBots: data.pinnedBots || [],
             pinnedChannels: data.pinnedChannels || [],
+            // 不返回消息数据，由前端按需加载
             messages: {}
           }
         };
@@ -881,9 +888,7 @@ var ApiHandlers = class {
     });
     this.ctx.console.addListener("get-history-messages", async (requestData) => {
       try {
-        const data = this.fileManager.readChatDataFromFile();
-        const channelKey = `${requestData.selfId}:${requestData.channelId}`;
-        let messages = data.messages[channelKey] || [];
+        let messages = this.fileManager.readChannelMessages(requestData.selfId, requestData.channelId);
         const sortedMessages = messages.sort((a, b) => b.timestamp - a.timestamp);
         if (requestData.limit !== void 0) {
           const limit = requestData.limit;
@@ -893,7 +898,7 @@ var ApiHandlers = class {
         } else {
           messages = sortedMessages.sort((a, b) => a.timestamp - b.timestamp);
         }
-        this.logInfo("获取历史消息:", channelKey, "共", messages.length, "条消息");
+        this.logInfo("获取历史消息:", `${requestData.selfId}:${requestData.channelId}`, "共", messages.length, "条消息");
         return {
           success: true,
           messages,
@@ -926,61 +931,72 @@ var ApiHandlers = class {
     });
     this.ctx.console.addListener("fetch-image", async (data) => {
       try {
+        if (data.url.includes("/vite/@fs/")) {
+          return {
+            success: true,
+            viteUrl: data.url
+          };
+        }
         if (this.isFileUrl(data.url)) {
           this.logInfo("处理本地文件请求:", data.url);
-          return await this.handleLocalFileRequest(data.url);
+          const filePath2 = require("node:url").fileURLToPath(data.url);
+          const normalizedPath2 = filePath2.replace(/\\/g, "/");
+          return {
+            success: true,
+            viteUrl: `/vite/@fs/${normalizedPath2}`
+          };
+        }
+        const dir = require("node:path").join(this.ctx.baseDir, "data", "chat-patch", "persist-media", "images");
+        if (!require("node:fs").existsSync(dir)) {
+          require("node:fs").mkdirSync(dir, { recursive: true });
         }
-        const response = await fetch(data.url, {
-          headers: {
-            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
-            "Referer": ""
+        const crypto = require("node:crypto");
+        const hash = crypto.createHash("md5").update(data.url).digest("hex");
+        const ext = require("node:path").extname(new import_node_url2.URL(data.url).pathname) || ".jpg";
+        const filename = `${hash}${ext}`;
+        const filePath = require("node:path").join(dir, filename);
+        if (!require("node:fs").existsSync(filePath)) {
+          const response = await fetch(data.url, {
+            headers: {
+              "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
+              "Referer": ""
+            }
+          });
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
           }
-        });
-        if (!response.ok) {
-          throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+          const buffer = await response.arrayBuffer();
+          require("node:fs").writeFileSync(filePath, Buffer.from(buffer));
         }
-        const buffer = await response.arrayBuffer();
-        const base64 = Buffer.from(buffer).toString("base64");
-        const contentType = response.headers.get("content-type") || "image/jpeg";
+        const normalizedPath = filePath.replace(/\\/g, "/");
         return {
           success: true,
-          base64,
-          contentType,
-          dataUrl: `data:${contentType};base64,${base64}`
+          viteUrl: `/vite/@fs/${normalizedPath}`
         };
       } catch (error) {
+        this.logger.error("获取图片失败:", error);
         return { success: false, error: error?.message || String(error) };
       }
     });
     this.ctx.console.addListener("clear-channel-history", async (data) => {
       try {
-        this.logInfo("收到清理历史记录请求:", data);
+        this.logInfo("收到清理历史记录请求（已废弃，建议使用删除频道数据）:", data);
         const chatData = this.fileManager.readChatDataFromFile();
         const channelKey = `${data.selfId}:${data.channelId}`;
         if (!chatData.messages[channelKey]) {
           return { success: true, message: "频道没有历史消息" };
         }
-        const messages = chatData.messages[channelKey];
-        const originalCount = messages.length;
-        const keepCount = data.keepCount || this.config.keepMessagesOnClear;
-        if (keepCount > 0 && originalCount <= keepCount) {
-          return { success: true, message: `消息数量(${originalCount})未超过保留数量(${keepCount})，无需清理` };
-        }
-        const sortedMessages = [...messages].sort((a, b) => a.timestamp - b.timestamp);
-        const keptMessages = keepCount > 0 ? sortedMessages.slice(-keepCount) : [];
-        const clearedCount = originalCount - keptMessages.length;
-        chatData.messages[channelKey] = keptMessages;
+        const originalCount = chatData.messages[channelKey].length;
+        delete chatData.messages[channelKey];
         this.fileManager.writeChatDataToFile(chatData);
-        this.logInfo(`频道 ${channelKey} 历史记录清理完成:`, {
-          原始消息数: originalCount,
-          保留消息数: keptMessages.length,
-          清理消息数: clearedCount
+        this.logInfo(`频道 ${channelKey} 历史记录已清空:`, {
+          清理消息数: originalCount
         });
         return {
           success: true,
-          message: `成功清理 ${clearedCount} 条历史消息，保留最新 ${keptMessages.length} 条`,
-          clearedCount,
-          keptCount: keptMessages.length
+          message: `成功清理 ${originalCount} 条历史消息`,
+          clearedCount: originalCount,
+          keptCount: 0
         };
       } catch (error) {
         this.logger.error("清理频道历史记录失败:", error);
@@ -1192,7 +1208,6 @@ var ApiHandlers = class {
           success: true,
           config: {
             maxMessagesPerChannel: this.config.maxMessagesPerChannel,
-            keepMessagesOnClear: this.config.keepMessagesOnClear,
             maxPersistImages: this.config.maxPersistImages,
             loggerinfo: this.config.loggerinfo,
             blockedPlatforms: this.config.blockedPlatforms || [],
@@ -1277,29 +1292,47 @@ var ApiHandlers = class {
     this.ctx.console.addListener("fetch-video-temp", async (data) => {
       try {
         this.logInfo("收到视频临时加载请求:", data.url);
+        if (data.url.includes("/vite/@fs/")) {
+          return {
+            success: true,
+            viteUrl: data.url
+          };
+        }
         if (this.isFileUrl(data.url)) {
-          const result = await this.handleLocalFileRequest(data.url);
-          return result;
+          const filePath2 = require("node:url").fileURLToPath(data.url);
+          const normalizedPath2 = filePath2.replace(/\\/g, "/");
+          return {
+            success: true,
+            viteUrl: `/vite/@fs/${normalizedPath2}`
+          };
         }
-        const response = await fetch(data.url, {
-          headers: {
-            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
-            "Referer": ""
+        const dir = require("node:path").join(this.ctx.baseDir, "data", "chat-patch", "persist-media", "media");
+        if (!require("node:fs").existsSync(dir)) {
+          require("node:fs").mkdirSync(dir, { recursive: true });
+        }
+        const crypto = require("node:crypto");
+        const hash = crypto.createHash("md5").update(data.url).digest("hex");
+        const ext = require("node:path").extname(new import_node_url2.URL(data.url).pathname) || ".mp4";
+        const filename = `${hash}${ext}`;
+        const filePath = require("node:path").join(dir, filename);
+        if (!require("node:fs").existsSync(filePath)) {
+          const response = await fetch(data.url, {
+            headers: {
+              "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
+              "Referer": ""
+            }
+          });
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
           }
-        });
-        if (!response.ok) {
-          throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+          const buffer = await response.arrayBuffer();
+          require("node:fs").writeFileSync(filePath, Buffer.from(buffer));
+          this.logInfo("视频下载成功:", { size: buffer.byteLength, path: filePath });
         }
-        const buffer = await response.arrayBuffer();
-        const base64 = Buffer.from(buffer).toString("base64");
-        const contentType = response.headers.get("content-type") || "video/mp4";
-        this.logInfo("视频下载成功:", { size: buffer.byteLength, contentType });
+        const normalizedPath = filePath.replace(/\\/g, "/");
         return {
           success: true,
-          base64,
-          contentType,
-          dataUrl: `data:${contentType};base64,${base64}`,
-          size: buffer.byteLength
+          viteUrl: `/vite/@fs/${normalizedPath}`
         };
       } catch (error) {
         this.logger.error("视频临时加载失败:", error);
@@ -1384,7 +1417,6 @@ var import_koishi2 = require("koishi");
 var Config = import_koishi2.Schema.intersect([
   import_koishi2.Schema.object({
     maxMessagesPerChannel: import_koishi2.Schema.number().default(500).description("每个群组最大保存消息数量").min(50).max(1500).step(1),
-    keepMessagesOnClear: import_koishi2.Schema.number().default(50).description("手动清理历史记录时保留的消息数量").min(0).max(1e3).step(1),
     maxPersistImages: import_koishi2.Schema.number().default(100).description("持久化存储的图片缓存数量").min(10).max(500).step(1),
     blockedPlatforms: import_koishi2.Schema.array(import_koishi2.Schema.object({
       platformName: import_koishi2.Schema.string().description("平台名称或关键词"),

package/lib/message-handler.d.ts

@@ -15,7 +15,7 @@ export declare class MessageHandler {
     getCorrectChannelId(selfId: string): string | undefined;
     updateBotInfoToFile(session: Session): void;
     updateChannelInfoToFile(session: Session): string;
-    downloadAndCacheMedia(url: string, type: 'image' | 'media' | 'avatar'): Promise<any>;
+    downloadAndCacheMedia(url: string, type: 'image' | 'media' | 'avatar'): Promise<string>;
     private processMediaElementsAsync;
     private processUserMessage;
     private processBotMessage;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-chat-patch",
   "description": "[<ruby>chat-patch<rp>（</rp><rt>点我预览效果</rt><rp>）</rp></ruby>](https://i0.hdslb.com/bfs/openplatform/71074dfc9e5256fc3333d8bd8478bec1af874046.png) 视奸小插件((bushi( (低性能警告)。手机端适配。灵感来自 chat 插件。",
-  "version": "2.4.0",
+  "version": "2.4.4",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/src/api-handlers.ts

@@ -35,10 +35,10 @@ export class ApiHandlers {
 
     this.ctx.console.addListener('get-chat-data' as any, async () => {
       try {
+        // 只读取元数据，不加载消息到内存
+        const data = this.fileManager.readMetadataOnly()
 
-        const data = this.fileManager.readChatDataFromFile()
-
-        this.logInfo('获取基础聊天数据')
+        this.logInfo('获取基础聊天数据（仅元数据）')
 
         return {
           success: true,
@@ -47,7 +47,7 @@ export class ApiHandlers {
             channels: data.channels || {},
             pinnedBots: data.pinnedBots || [],
             pinnedChannels: data.pinnedChannels || [],
-
+            // 不返回消息数据，由前端按需加载
             messages: {}
           }
         }
@@ -64,9 +64,8 @@ export class ApiHandlers {
       offset?: number
     }) => {
       try {
-        const data = this.fileManager.readChatDataFromFile()
-        const channelKey = `${requestData.selfId}:${requestData.channelId}`
-        let messages = data.messages[channelKey] || []
+        // 直接从文件读取该频道的消息，不加载所有消息到内存
+        let messages = this.fileManager.readChannelMessages(requestData.selfId, requestData.channelId)
 
         const sortedMessages = messages.sort((a, b) => b.timestamp - a.timestamp)
 
@@ -77,11 +76,11 @@ export class ApiHandlers {
 
           messages = messages.sort((a, b) => a.timestamp - b.timestamp)
         } else {
-
+          // 如果没有指定limit，返回所有消息（按时间正序）
           messages = sortedMessages.sort((a, b) => a.timestamp - b.timestamp)
         }
 
-        this.logInfo('获取历史消息:', channelKey, '共', messages.length, '条消息')
+        this.logInfo('获取历史消息:', `${requestData.selfId}:${requestData.channelId}`, '共', messages.length, '条消息')
 
         return {
           success: true,
@@ -120,45 +119,75 @@ export class ApiHandlers {
 
     this.ctx.console.addListener('fetch-image' as any, async (data: { url: string }) => {
       try {
+        // 如果已经是 Vite @fs 路径，直接返回
+        if (data.url.includes('/vite/@fs/')) {
+          return {
+            success: true,
+            viteUrl: data.url
+          }
+        }
 
+        // 如果是本地文件 URL，转换为 Vite @fs 路径
         if (this.isFileUrl(data.url)) {
           this.logInfo('处理本地文件请求:', data.url)
-          return await this.handleLocalFileRequest(data.url)
+          const filePath = require('node:url').fileURLToPath(data.url)
+          const normalizedPath = filePath.replace(/\\/g, '/')
+          return {
+            success: true,
+            viteUrl: `/vite/@fs/${normalizedPath}`
+          }
+        }
+
+        // 网络图片：下载并缓存到本地，返回 Vite @fs 路径
+        const dir = require('node:path').join(this.ctx.baseDir, 'data', 'chat-patch', 'persist-media', 'images')
+        if (!require('node:fs').existsSync(dir)) {
+          require('node:fs').mkdirSync(dir, { recursive: true })
         }
 
-        const response = await fetch(data.url, {
-          headers: {
-            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
-            'Referer': ''
+        const crypto = require('node:crypto')
+        const hash = crypto.createHash('md5').update(data.url).digest('hex')
+        const ext = require('node:path').extname(new URL(data.url).pathname) || '.jpg'
+        const filename = `${hash}${ext}`
+        const filePath = require('node:path').join(dir, filename)
+
+        // 如果文件不存在，下载并保存
+        if (!require('node:fs').existsSync(filePath)) {
+          const response = await fetch(data.url, {
+            headers: {
+              'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36',
+              'Referer': ''
+            }
+          })
+
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`)
           }
-        })
 
-        if (!response.ok) {
-          throw new Error(`HTTP ${response.status}: ${response.statusText}`)
+          const buffer = await response.arrayBuffer()
+          require('node:fs').writeFileSync(filePath, Buffer.from(buffer))
         }
 
-        const buffer = await response.arrayBuffer()
-        const base64 = Buffer.from(buffer).toString('base64')
-        const contentType = response.headers.get('content-type') || 'image/jpeg'
+        // 返回 Vite @fs 路径
+        const normalizedPath = filePath.replace(/\\/g, '/')
         return {
           success: true,
-          base64: base64,
-          contentType: contentType,
-          dataUrl: `data:${contentType};base64,${base64}`
+          viteUrl: `/vite/@fs/${normalizedPath}`
         }
       } catch (error: any) {
+        this.logger.error('获取图片失败:', error)
         return { success: false, error: error?.message || String(error) }
       }
     })
 
+    // 清理历史记录 API 已废弃，现在直接通过右键删除频道数据
     this.ctx.console.addListener('clear-channel-history' as any, async (data: {
       selfId: string
       channelId: string
-      keepCount?: number
     }) => {
       try {
-        this.logInfo('收到清理历史记录请求:', data)
+        this.logInfo('收到清理历史记录请求（已废弃，建议使用删除频道数据）:', data)
 
+        // 直接删除该频道的所有消息
         const chatData = this.fileManager.readChatDataFromFile()
         const channelKey = `${data.selfId}:${data.channelId}`
 
@@ -166,33 +195,19 @@ export class ApiHandlers {
           return { success: true, message: '频道没有历史消息' }
         }
 
-        const messages = chatData.messages[channelKey]
-        const originalCount = messages.length
-
-        const keepCount = data.keepCount || this.config.keepMessagesOnClear
-
-        if (keepCount > 0 && originalCount <= keepCount) {
-          return { success: true, message: `消息数量(${originalCount})未超过保留数量(${keepCount})，无需清理` }
-        }
-
-        const sortedMessages = [...messages].sort((a, b) => a.timestamp - b.timestamp)
-        const keptMessages = keepCount > 0 ? sortedMessages.slice(-keepCount) : []
-        const clearedCount = originalCount - keptMessages.length
-
-        chatData.messages[channelKey] = keptMessages
+        const originalCount = chatData.messages[channelKey].length
+        delete chatData.messages[channelKey]
         this.fileManager.writeChatDataToFile(chatData)
 
-        this.logInfo(`频道 ${channelKey} 历史记录清理完成:`, {
-          原始消息数: originalCount,
-          保留消息数: keptMessages.length,
-          清理消息数: clearedCount
+        this.logInfo(`频道 ${channelKey} 历史记录已清空:`, {
+          清理消息数: originalCount
         })
 
         return {
           success: true,
-          message: `成功清理 ${clearedCount} 条历史消息，保留最新 ${keptMessages.length} 条`,
-          clearedCount: clearedCount,
-          keptCount: keptMessages.length
+          message: `成功清理 ${originalCount} 条历史消息`,
+          clearedCount: originalCount,
+          keptCount: 0
         }
       } catch (error: any) {
         this.logger.error('清理频道历史记录失败:', error)
@@ -478,7 +493,6 @@ export class ApiHandlers {
           success: true,
           config: {
             maxMessagesPerChannel: this.config.maxMessagesPerChannel,
-            keepMessagesOnClear: this.config.keepMessagesOnClear,
             maxPersistImages: this.config.maxPersistImages,
             loggerinfo: this.config.loggerinfo,
             blockedPlatforms: this.config.blockedPlatforms || [],
@@ -579,35 +593,59 @@ export class ApiHandlers {
       try {
         this.logInfo('收到视频临时加载请求:', data.url)
 
-        if (this.isFileUrl(data.url)) {
-          const result = await this.handleLocalFileRequest(data.url)
-          return result
+        // 如果已经是 Vite @fs 路径，直接返回
+        if (data.url.includes('/vite/@fs/')) {
+          return {
+            success: true,
+            viteUrl: data.url
+          }
         }
 
-        const response = await fetch(data.url, {
-          headers: {
-            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
-            'Referer': ''
+        // 如果是本地文件 URL，转换为 Vite @fs 路径
+        if (this.isFileUrl(data.url)) {
+          const filePath = require('node:url').fileURLToPath(data.url)
+          const normalizedPath = filePath.replace(/\\/g, '/')
+          return {
+            success: true,
+            viteUrl: `/vite/@fs/${normalizedPath}`
           }
-        })
+        }
 
-        if (!response.ok) {
-          throw new Error(`HTTP ${response.status}: ${response.statusText}`)
+        // 网络视频：下载并缓存到本地，返回 Vite @fs 路径
+        const dir = require('node:path').join(this.ctx.baseDir, 'data', 'chat-patch', 'persist-media', 'media')
+        if (!require('node:fs').existsSync(dir)) {
+          require('node:fs').mkdirSync(dir, { recursive: true })
         }
 
-        const buffer = await response.arrayBuffer()
-        const base64 = Buffer.from(buffer).toString('base64')
+        const crypto = require('node:crypto')
+        const hash = crypto.createHash('md5').update(data.url).digest('hex')
+        const ext = require('node:path').extname(new URL(data.url).pathname) || '.mp4'
+        const filename = `${hash}${ext}`
+        const filePath = require('node:path').join(dir, filename)
 
-        const contentType = response.headers.get('content-type') || 'video/mp4'
+        // 如果文件不存在，下载并保存
+        if (!require('node:fs').existsSync(filePath)) {
+          const response = await fetch(data.url, {
+            headers: {
+              'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
+              'Referer': ''
+            }
+          })
 
-        this.logInfo('视频下载成功:', { size: buffer.byteLength, contentType })
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`)
+          }
+
+          const buffer = await response.arrayBuffer()
+          require('node:fs').writeFileSync(filePath, Buffer.from(buffer))
+          this.logInfo('视频下载成功:', { size: buffer.byteLength, path: filePath })
+        }
 
+        // 返回 Vite @fs 路径
+        const normalizedPath = filePath.replace(/\\/g, '/')
         return {
           success: true,
-          base64: base64,
-          contentType: contentType,
-          dataUrl: `data:${contentType};base64,${base64}`,
-          size: buffer.byteLength
+          viteUrl: `/vite/@fs/${normalizedPath}`
         }
       } catch (error: any) {
         this.logger.error('视频临时加载失败:', error)

package/src/config.ts

@@ -4,7 +4,6 @@ export interface Config {
   loggerinfo: boolean
   clearIndexedDBOnStart: boolean
   maxMessagesPerChannel: number
-  keepMessagesOnClear: number
   maxPersistImages: number
   blockedPlatforms: Array<{
     platformName: string
@@ -15,7 +14,6 @@ export interface Config {
 export const Config: Schema<Config> = Schema.intersect([
   Schema.object({
     maxMessagesPerChannel: Schema.number().default(500).description('每个群组最大保存消息数量').min(50).max(1500).step(1),
-    keepMessagesOnClear: Schema.number().default(50).description('手动清理历史记录时保留的消息数量').min(0).max(1000).step(1),
     maxPersistImages: Schema.number().default(100).description('持久化存储的图片缓存数量').min(10).max(500).step(1),
     blockedPlatforms: Schema.array(Schema.object({
       platformName: Schema.string().description('平台名称或关键词'),

package/src/file-manager.ts

@@ -66,8 +66,8 @@ export class FileManager {
     return path.join(botDir, `${channelId}.json`)
   }
 
-  // 读取单个频道的消息
-  private readChannelMessages(selfId: string, channelId: string): MessageInfo[] {
+  // 读取单个频道的消息（公共方法）
+  readChannelMessages(selfId: string, channelId: string): MessageInfo[] {
     const filePath = this.getChannelFilePath(selfId, channelId)
     if (!fs.existsSync(filePath)) {
       return []
@@ -126,6 +126,11 @@ export class FileManager {
     }
   }
 
+  // 只读取元数据，不加载消息（公共方法）
+  readMetadataOnly(): Omit<ChatData, 'messages'> {
+    return this.readMetadata()
+  }
+
   // 写入元数据
   private writeMetadata(metadata: Omit<ChatData, 'messages'>) {
     try {

package/src/message-handler.ts

@@ -168,7 +168,10 @@ export class MessageHandler {
 
   public async downloadAndCacheMedia(url: string, type: 'image' | 'media' | 'avatar') {
     try {
-      if (!url || url.startsWith('data:') || url.startsWith('file:')) return url
+      if (!url || url.startsWith('data:')) return url
+
+      // 如果已经是 Vite @fs 路径，直接返回
+      if (url.includes('/vite/@fs/')) return url
 
       let folder = 'media'
       if (type === 'image') folder = 'images'
@@ -185,15 +188,17 @@ export class MessageHandler {
       const filename = `${hash}${ext}`
       const filePath = require('node:path').join(dir, filename)
 
-      if (require('node:fs').existsSync(filePath)) {
-        return require('node:url').pathToFileURL(filePath).href
+      if (!require('node:fs').existsSync(filePath)) {
+        const buffer = await this.ctx.http.get(url, { responseType: 'arraybuffer' })
+        require('node:fs').writeFileSync(filePath, Buffer.from(buffer))
       }
 
-      const buffer = await this.ctx.http.get(url, { responseType: 'arraybuffer' })
-      require('node:fs').writeFileSync(filePath, Buffer.from(buffer))
-
-      return require('node:url').pathToFileURL(filePath).href
+      // 返回 Vite @fs 路径格式，让浏览器通过 Vite 开发服务器加载本地文件
+      // Windows 路径需要转换为正斜杠
+      const normalizedPath = filePath.replace(/\\/g, '/')
+      return `/vite/@fs/${normalizedPath}`
     } catch (e) {
+      this.logger.warn('下载并缓存媒体失败:', e)
       return url
     }
   }