@anyul/koishi-plugin-rss 5.2.47 → 5.3.0

package/lib/utils/message-cache.d.ts

@@ -70,6 +70,10 @@ export declare class MessageCacheManager {
     }): Promise<CacheStats>;
     /**
      * 清理缓存
+     *
+     * 注意：Koishi 的 database.remove 接受查询条件对象，会批量删除所有匹配行。
+     * 这里先查出保留部分的边界 id，再用 `< 边界` 的条件一次批量删除，
+     * 避免逐条 remove 造成的 N 次往返与中途失败留下半清理状态。
      */
     cleanup(options?: {
         guildId?: string;
@@ -84,6 +88,11 @@ export declare class MessageCacheManager {
         guildId?: string;
         platform?: string;
     }): Promise<number>;
+    /**
+     * 批量删除辅助：先按 where 统计条数，再一次 remove 删除全部匹配行。
+     * 用于 clearAll / cleanup，避免逐条往返与整表入内存。
+     */
+    private batchRemove;
     /**
      * 检查并自动清理
      */

package/lib/utils/message-cache.js

@@ -122,6 +122,10 @@ class MessageCacheManager {
     }
     /**
      * 清理缓存
+     *
+     * 注意：Koishi 的 database.remove 接受查询条件对象，会批量删除所有匹配行。
+     * 这里先查出保留部分的边界 id，再用 `< 边界` 的条件一次批量删除，
+     * 避免逐条 remove 造成的 N 次往返与中途失败留下半清理状态。
      */
     async cleanup(options = {}) {
         const { guildId, rssId, platform, keepLatest = this.maxCacheSize } = options;
@@ -133,21 +137,22 @@ class MessageCacheManager {
             where.rssId = rssId;
         if (platform)
             where.platform = platform;
-        // 获取所有匹配的消息
-        const messages = await this.ctx.database.get('rss_message_cache', where, {
-            sort: { createdAt: 'desc' }
+        // 只查到"要保留的最新 N 条"对应的边界，无需把整表拉进内存
+        const keepBoundary = await this.ctx.database.get('rss_message_cache', where, {
+            sort: { createdAt: 'desc' },
+            limit: 1,
+            offset: Math.max(0, keepLatest - 1),
         });
-        // 如果消息数量超过限制，删除旧消息
-        if (messages.length > keepLatest) {
-            const toDelete = messages.slice(keepLatest);
-            const idsToDelete = toDelete.map(m => m.id);
-            for (const id of idsToDelete) {
-                await this.ctx.database.remove('rss_message_cache', { id });
-            }
-            logger.info(`清理了 ${toDelete.length} 条缓存消息`);
-            return toDelete.length;
-        }
-        return 0;
+        // 没有边界行，说明总量 ≤ keepLatest，无需清理
+        if (keepBoundary.length === 0)
+            return 0;
+        const boundaryCreatedAt = keepBoundary[0].createdAt;
+        // 删除比边界更旧（含同时间戳但靠后）的消息：createdAt < 边界
+        const deleteWhere = { ...where, createdAt: { $lt: boundaryCreatedAt } };
+        const removed = await this.batchRemove(deleteWhere);
+        if (removed > 0)
+            logger.info(`清理了 ${removed} 条缓存消息`);
+        return removed;
     }
     /**
      * 清空所有缓存
@@ -160,14 +165,24 @@ class MessageCacheManager {
             where.guildId = guildId;
         if (platform)
             where.platform = platform;
-        // 获取所有消息
+        const removed = await this.batchRemove(where);
+        if (removed > 0)
+            logger.info(`清空了 ${removed} 条缓存消息`);
+        return removed;
+    }
+    /**
+     * 批量删除辅助：先按 where 统计条数，再一次 remove 删除全部匹配行。
+     * 用于 clearAll / cleanup，避免逐条往返与整表入内存。
+     */
+    async batchRemove(where) {
+        // Koishi database.get 不直接支持 count，先取一次总数
         const messages = await this.ctx.database.get('rss_message_cache', where);
-        // 删除所有消息
-        for (const msg of messages) {
-            await this.ctx.database.remove('rss_message_cache', { id: msg.id });
-        }
-        logger.info(`清空了 ${messages.length} 条缓存消息`);
-        return messages.length;
+        const count = messages.length;
+        if (count === 0)
+            return 0;
+        // remove 接受查询条件，会删除所有匹配行（批量语义）
+        await this.ctx.database.remove('rss_message_cache', where);
+        return count;
     }
     /**
      * 检查并自动清理

package/lib/utils/tdl.d.ts

@@ -80,10 +80,23 @@ export declare function detectVideoTooBig(html: any): boolean;
 /**
  * 从 cheerio 文档里提取 "Video is too big" 占位 blockquote 内的海报图地址。
  *
+ * 多视频 album 时，返回**第一个**匹配 blockquote 的 poster（向后兼容）。
+ * 如需全部，用 extractTooBigPosters。
+ *
  * @param html cheerio 实例
  * @returns 找到则返回图片 URL，否则空串
  */
 export declare function extractTooBigPoster(html: any): string;
+/**
+ * 提取所有 "Video is too big" 占位 blockquote 的海报图地址，按文档出现顺序返回。
+ *
+ * 多视频 album 场景：3 个 blockquote 各带一张 poster，
+ * 返回顺序与 blockquote 顺序一致，用于按位置配对注入视频。
+ *
+ * @param html cheerio 实例
+ * @returns poster URL 数组（无图位置返回空串占位，长度 = too-big blockquote 数）
+ */
+export declare function extractTooBigPosters(html: any): string[];
 export interface DownloadWithTdlOptions {
     config: Config;
     /** Telegram 消息链接，如 https://t.me/anyul996/28 */
@@ -96,17 +109,18 @@ export interface DownloadWithTdlOptions {
     workDir?: string;
 }
 /**
- * 调用 tdl 下载单条 Telegram 消息的视频。
+ * 调用 tdl 下载 Telegram 消息的视频（支持多视频 album）。
  *
- * 命令形态：`tdl [--storage ...] [--proxy ...] dl -u <link> -d <tmpDir>`
- * （全局 flag 必须在子命令 dl 之前；下载产物落在 -d 指定目录）
+ * 命令形态：`tdl [--storage ...] [--proxy ...] dl -u <link> -d <tmpDir> --group`
+ * （全局 flag 必须在子命令 dl 之前；--group 自动检测相册/分组消息，下载全部媒体；
+ *  对单视频无副作用——自动检测到 1 项）
  *
  * 代理与会话解析优先级：
  * - `--proxy`：config.tdl.proxy（专用）→ 订阅级代理（proxyByEnv != false）
  * - `--storage`：config.tdl.storage（登录与下载必须一致，否则找不到会话）
  *
- * @returns 成功返回 mp4 绝对路径；二进制缺失/未登录/超时/无产物时返回 null
+ * @returns 成功返回视频绝对路径数组（按文件名排序 = 专辑顺序）；二进制缺失/未登录/超时/无产物时返回 null
  */
-export declare function downloadWithTdl(opts: DownloadWithTdlOptions): Promise<string | null>;
+export declare function downloadWithTdl(opts: DownloadWithTdlOptions): Promise<string[] | null>;
 /** 静默删除目录，失败不抛错 */
 export declare function safeRemoveDir(dir: string): Promise<void>;

package/lib/utils/tdl.js

@@ -52,6 +52,7 @@ exports._resetBinaryCacheForTest = _resetBinaryCacheForTest;
 exports.parseTelegramLink = parseTelegramLink;
 exports.detectVideoTooBig = detectVideoTooBig;
 exports.extractTooBigPoster = extractTooBigPoster;
+exports.extractTooBigPosters = extractTooBigPosters;
 exports.downloadWithTdl = downloadWithTdl;
 exports.safeRemoveDir = safeRemoveDir;
 const child_process_1 = require("child_process");
@@ -262,42 +263,55 @@ function detectVideoTooBig(html) {
 /**
  * 从 cheerio 文档里提取 "Video is too big" 占位 blockquote 内的海报图地址。
  *
+ * 多视频 album 时，返回**第一个**匹配 blockquote 的 poster（向后兼容）。
+ * 如需全部，用 extractTooBigPosters。
+ *
  * @param html cheerio 实例
  * @returns 找到则返回图片 URL，否则空串
  */
 function extractTooBigPoster(html) {
+    return extractTooBigPosters(html)[0] || '';
+}
+/**
+ * 提取所有 "Video is too big" 占位 blockquote 的海报图地址，按文档出现顺序返回。
+ *
+ * 多视频 album 场景：3 个 blockquote 各带一张 poster，
+ * 返回顺序与 blockquote 顺序一致，用于按位置配对注入视频。
+ *
+ * @param html cheerio 实例
+ * @returns poster URL 数组（无图位置返回空串占位，长度 = too-big blockquote 数）
+ */
+function extractTooBigPosters(html) {
     if (!html)
-        return '';
+        return [];
+    const posters = [];
     try {
-        let poster = '';
         html('blockquote').each((_, el) => {
-            if (poster)
-                return;
             const $el = html(el);
             const text = $el.text() || '';
             if (VIDEO_TOO_BIG_PATTERN.test(text)) {
                 const img = $el.find('img').first().attr('src') || '';
-                if (img)
-                    poster = img;
+                posters.push(img);
             }
         });
-        return poster;
     }
     catch {
-        return '';
+        return [];
     }
+    return posters;
 }
 /**
- * 调用 tdl 下载单条 Telegram 消息的视频。
+ * 调用 tdl 下载 Telegram 消息的视频（支持多视频 album）。
  *
- * 命令形态：`tdl [--storage ...] [--proxy ...] dl -u <link> -d <tmpDir>`
- * （全局 flag 必须在子命令 dl 之前；下载产物落在 -d 指定目录）
+ * 命令形态：`tdl [--storage ...] [--proxy ...] dl -u <link> -d <tmpDir> --group`
+ * （全局 flag 必须在子命令 dl 之前；--group 自动检测相册/分组消息，下载全部媒体；
+ *  对单视频无副作用——自动检测到 1 项）
  *
  * 代理与会话解析优先级：
  * - `--proxy`：config.tdl.proxy（专用）→ 订阅级代理（proxyByEnv != false）
  * - `--storage`：config.tdl.storage（登录与下载必须一致，否则找不到会话）
  *
- * @returns 成功返回 mp4 绝对路径；二进制缺失/未登录/超时/无产物时返回 null
+ * @returns 成功返回视频绝对路径数组（按文件名排序 = 专辑顺序）；二进制缺失/未登录/超时/无产物时返回 null
  */
 async function downloadWithTdl(opts) {
     const { config, link, proxyAgent } = opts;
@@ -332,7 +346,7 @@ async function downloadWithTdl(opts) {
         args.push('--proxy', proxyUrl);
         (0, logger_1.debug)(config, `tdl 使用代理: ${maskProxyUrl(proxyUrl)}`, 'tdl', 'details');
     }
-    args.push('dl', '-u', link, '-d', workDir);
+    args.push('dl', '-u', link, '-d', workDir, '--group');
     const label = tdlBin === 'tdl' ? 'tdl' : tdlBin;
     (0, logger_1.debug)(config, `调用 tdl 下载: ${label} ${args.join(' ')}（超时 ${timeoutSeconds}s）`, 'tdl', 'info');
     try {
@@ -352,23 +366,24 @@ async function downloadWithTdl(opts) {
         await safeRemoveDir(workDir);
         return null;
     }
-    // 5. 扫描产物，挑体积最大的视频文件
-    const videoPath = pickLargestVideo(workDir);
-    if (!videoPath) {
+    // 5. 扫描产物，收集全部视频文件（按文件名排序，对齐专辑顺序）
+    const videoPaths = pickVideoFiles(workDir);
+    if (videoPaths.length === 0) {
         (0, logger_1.debug)(config, `tdl 下载完成但目录内未发现视频文件: ${workDir}`, 'tdl', 'info');
         await safeRemoveDir(workDir);
         return null;
     }
-    (0, logger_1.debug)(config, `tdl 下载成功: ${videoPath}`, 'tdl', 'info');
-    return videoPath;
+    (0, logger_1.debug)(config, `tdl 下载成功（${videoPaths.length} 个视频）: ${videoPaths.join(', ')}`, 'tdl', 'info');
+    return videoPaths;
 }
-/** 在目录中挑选体积最大的视频文件。
- *  Telegram 频道视频几乎都是 mp4；tdl 也会下载同消息的配图(.jpg)和描述(.json)，
- *  白名单只认视频扩展名。若想更严格可只认 .mp4（Telegram 视频 99% 是 mp4）。 */
-function pickLargestVideo(dir) {
-    // Telegram 视频 = mp4；保留 mov/webm/mkv/m4v 兼容极少数转码产物
+/** 在目录中挑选全部视频文件，按文件名升序排列。
+ *
+ *  tdl --group 下文件名形如 `{dialogID}_{msgID}_{name}.mp4`，msgID 递增 = 专辑顺序，
+ *  按文件名排序即可对齐 RSS 描述里 blockquote 的出现顺序。
+ *  过滤掉 tdl 同时下载的配图(.jpg)、描述(.json)；跳过 0 字节半成品。 */
+function pickVideoFiles(dir) {
     const videoExts = new Set(['.mp4', '.mov', '.webm', '.mkv', '.m4v']);
-    let best = null;
+    const found = [];
     try {
         const entries = fs.readdirSync(dir, { withFileTypes: true });
         for (const entry of entries) {
@@ -377,21 +392,24 @@ function pickLargestVideo(dir) {
             const ext = path.extname(entry.name).toLowerCase();
             if (!videoExts.has(ext))
                 continue;
-            const full = path.join(dir, entry.name);
+            // 校验非空文件（跳过 0 字节半成品）
             try {
-                const stat = fs.statSync(full);
-                if (!best || stat.size > best.size)
-                    best = { path: full, size: stat.size };
+                const stat = fs.statSync(path.join(dir, entry.name));
+                if (stat.size === 0)
+                    continue;
             }
             catch {
-                // 单文件 stat 失败忽略
+                continue;
             }
+            found.push({ path: path.join(dir, entry.name), name: entry.name });
         }
     }
     catch {
-        return null;
+        return [];
     }
-    return best?.path ?? null;
+    // 按文件名升序，保证多视频与 blockquote 顺序一致
+    found.sort((a, b) => a.name.localeCompare(b.name, 'en'));
+    return found.map(f => f.path);
 }
 /** 静默删除目录，失败不抛错 */
 async function safeRemoveDir(dir) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@anyul/koishi-plugin-rss",
   "description": "Koishi RSS订阅器，支持多种RSS源、图片渲染、AI摘要等高级功能",
-  "version": "5.2.47",
+  "version": "5.3.0",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "author": "Anyuluo <anyul@email.com>",