@anyul/koishi-plugin-rss 5.2.41 → 5.2.42

package/lib/utils/tdl.d.ts

@@ -0,0 +1,80 @@
+/**
+ * tdl (Telegram Downloader) 集成模块
+ *
+ * tdl 是 iyear/tdl 提供的 Go 编写独立 CLI 工具，**不是 npm 包**。
+ * 当 RSSHub 对 Telegram 超大视频返回 "Video is too big" 占位 blockquote 时，
+ * 通过 tdl 直接从 Telegram 拉取原始视频，再由 video-compress 模块按需压缩。
+ *
+ * 设计原则：
+ * - 所有外部调用都用 execFile（非 shell），参数数组化，避免注入。
+ * - 任何失败都返回 null 并打 debug 日志，**绝不抛错、绝不阻塞主流程**。
+ * - 二进制缺失走同一返回路径，上层无感知。
+ */
+import { Config, proxyAgent } from '../types';
+/**
+ * 探测某个可执行文件是否存在于 PATH 中。
+ *
+ * @param name 二进制名称，如 'tdl' / 'ffmpeg'
+ * @param testArgs 用于触发版本输出的参数，如 ['-v'] / ['-version']
+ * @returns 存在返回 true，否则 false
+ */
+export declare function detectBinary(name: string, testArgs?: string[]): Promise<boolean>;
+/** 重置二进制缓存（仅测试用） */
+export declare function _resetBinaryCacheForTest(): void;
+export interface TelegramLinkInfo {
+    /** 频道用户名或数字 ID（不带 -100 前缀） */
+    channel: string;
+    /** 频道内消息 ID */
+    messageId: number;
+}
+/**
+ * 从 Telegram 链接中解析频道与消息 ID。
+ *
+ * 支持形态：
+ *   https://t.me/anyul996/28          -> { channel: 'anyul996', messageId: 28 }
+ *   https://t.me/c/1234567890/28       -> { channel: 'c/1234567890', messageId: 28 }
+ *   t.me/anyul996/28                   -> 同上
+ *
+ * @param link 原始链接
+ * @returns 解析失败或非 Telegram 链接返回 null
+ */
+export declare function parseTelegramLink(link: string): TelegramLinkInfo | null;
+/**
+ * 检测 cheerio 文档中是否包含 Telegram 大视频占位符。
+ *
+ * RSSHub 对超大视频会渲染 `<blockquote><b>Video is too big</b><br><img.../></blockquote>`，
+ * 这里识别 blockquote 内是否含该文本。同时兜底检查全文，兼容个别 RSSHub 版本不包 blockquote 的情况。
+ *
+ * @param html cheerio 实例
+ * @returns 命中返回 true
+ */
+export declare function detectVideoTooBig(html: any): boolean;
+/**
+ * 从 cheerio 文档里提取 "Video is too big" 占位 blockquote 内的海报图地址。
+ *
+ * @param html cheerio 实例
+ * @returns 找到则返回图片 URL，否则空串
+ */
+export declare function extractTooBigPoster(html: any): string;
+export interface DownloadWithTdlOptions {
+    config: Config;
+    /** Telegram 消息链接，如 https://t.me/anyul996/28 */
+    link: string;
+    /** 订阅级代理配置，启用且 config.tdl.proxyByEnv!=false 时透传给子进程 */
+    proxyAgent?: proxyAgent;
+    /** 下载超时秒数（默认取 config.tdl.timeout 或 180） */
+    timeoutSeconds?: number;
+    /** 工作目录（默认系统临时目录下随机子目录） */
+    workDir?: string;
+}
+/**
+ * 调用 tdl 下载单条 Telegram 消息的视频。
+ *
+ * 命令形态：`tdl dl -u <link> -d <tmpDir> --descrition false -f`
+ * （-f 关闭覆盖确认；下载产物落在 -d 指定目录）
+ *
+ * @returns 成功返回 mp4 绝对路径；二进制缺失/未登录/超时/无产物时返回 null
+ */
+export declare function downloadWithTdl(opts: DownloadWithTdlOptions): Promise<string | null>;
+/** 静默删除目录，失败不抛错 */
+export declare function safeRemoveDir(dir: string): Promise<void>;

package/lib/utils/tdl.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * tdl (Telegram Downloader) 集成模块
+ *
+ * tdl 是 iyear/tdl 提供的 Go 编写独立 CLI 工具，**不是 npm 包**。
+ * 当 RSSHub 对 Telegram 超大视频返回 "Video is too big" 占位 blockquote 时，
+ * 通过 tdl 直接从 Telegram 拉取原始视频，再由 video-compress 模块按需压缩。
+ *
+ * 设计原则：
+ * - 所有外部调用都用 execFile（非 shell），参数数组化，避免注入。
+ * - 任何失败都返回 null 并打 debug 日志，**绝不抛错、绝不阻塞主流程**。
+ * - 二进制缺失走同一返回路径，上层无感知。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectBinary = detectBinary;
+exports._resetBinaryCacheForTest = _resetBinaryCacheForTest;
+exports.parseTelegramLink = parseTelegramLink;
+exports.detectVideoTooBig = detectVideoTooBig;
+exports.extractTooBigPoster = extractTooBigPoster;
+exports.downloadWithTdl = downloadWithTdl;
+exports.safeRemoveDir = safeRemoveDir;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const crypto = __importStar(require("crypto"));
+const logger_1 = require("./logger");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+/** 进程内二进制探测结果缓存，避免每条 RSS 都 fork 探测 */
+const binaryCache = {};
+/**
+ * 探测某个可执行文件是否存在于 PATH 中。
+ *
+ * @param name 二进制名称，如 'tdl' / 'ffmpeg'
+ * @param testArgs 用于触发版本输出的参数，如 ['-v'] / ['-version']
+ * @returns 存在返回 true，否则 false
+ */
+async function detectBinary(name, testArgs = ['-v']) {
+    if (binaryCache[name] !== undefined)
+        return binaryCache[name];
+    try {
+        await execFileAsync(name, testArgs, { timeout: 10000, windowsHide: true });
+        binaryCache[name] = true;
+        return true;
+    }
+    catch {
+        binaryCache[name] = false;
+        return false;
+    }
+}
+/** 重置二进制缓存（仅测试用） */
+function _resetBinaryCacheForTest() {
+    for (const k of Object.keys(binaryCache))
+        delete binaryCache[k];
+}
+/**
+ * 从 Telegram 链接中解析频道与消息 ID。
+ *
+ * 支持形态：
+ *   https://t.me/anyul996/28          -> { channel: 'anyul996', messageId: 28 }
+ *   https://t.me/c/1234567890/28       -> { channel: 'c/1234567890', messageId: 28 }
+ *   t.me/anyul996/28                   -> 同上
+ *
+ * @param link 原始链接
+ * @returns 解析失败或非 Telegram 链接返回 null
+ */
+function parseTelegramLink(link) {
+    if (!link || typeof link !== 'string')
+        return null;
+    const trimmed = link.trim();
+    // t.me/<channel>/<msgId>，协议可选
+    // 私有频道形如 t.me/c/1234567890/28，保留 c/<id> 段以便 tdl 直接消费
+    const match = trimmed.match(/^(?:https?:\/\/)?t\.me\/(c\/\d+|[A-Za-z0-9_]+)\/(\d+)\/?$/i);
+    if (!match)
+        return null;
+    const messageId = parseInt(match[2], 10);
+    if (!Number.isFinite(messageId) || messageId <= 0)
+        return null;
+    return { channel: match[1], messageId };
+}
+/** "Video is too big" 占位文本的匹配正则（大小写不敏感） */
+const VIDEO_TOO_BIG_PATTERN = /video\s+is\s+too\s+big/i;
+/**
+ * 检测 cheerio 文档中是否包含 Telegram 大视频占位符。
+ *
+ * RSSHub 对超大视频会渲染 `<blockquote><b>Video is too big</b><br><img.../></blockquote>`，
+ * 这里识别 blockquote 内是否含该文本。同时兜底检查全文，兼容个别 RSSHub 版本不包 blockquote 的情况。
+ *
+ * @param html cheerio 实例
+ * @returns 命中返回 true
+ */
+function detectVideoTooBig(html) {
+    if (!html)
+        return false;
+    try {
+        // 优先在 blockquote 内查找
+        let hit = false;
+        html('blockquote').each((_, el) => {
+            if (hit)
+                return;
+            const text = html(el).text() || '';
+            if (VIDEO_TOO_BIG_PATTERN.test(text))
+                hit = true;
+        });
+        if (hit)
+            return true;
+        // 兜底：全文（极少数 RSSHub 版本不包 blockquote）
+        const fullText = html('body').text() || html.root().text() || '';
+        return VIDEO_TOO_BIG_PATTERN.test(fullText);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 从 cheerio 文档里提取 "Video is too big" 占位 blockquote 内的海报图地址。
+ *
+ * @param html cheerio 实例
+ * @returns 找到则返回图片 URL，否则空串
+ */
+function extractTooBigPoster(html) {
+    if (!html)
+        return '';
+    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;
+            }
+        });
+        return poster;
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * 调用 tdl 下载单条 Telegram 消息的视频。
+ *
+ * 命令形态：`tdl dl -u <link> -d <tmpDir> --descrition false -f`
+ * （-f 关闭覆盖确认；下载产物落在 -d 指定目录）
+ *
+ * @returns 成功返回 mp4 绝对路径；二进制缺失/未登录/超时/无产物时返回 null
+ */
+async function downloadWithTdl(opts) {
+    const { config, link, proxyAgent } = opts;
+    const timeoutSeconds = opts.timeoutSeconds ?? config.tdl?.timeout ?? 180;
+    // 1. 探测 tdl 二进制
+    const hasTdl = await detectBinary('tdl', ['-v']);
+    if (!hasTdl) {
+        (0, logger_1.debug)(config, '未在 PATH 中检测到 tdl，跳过 Telegram 大视频下载（请安装 iyear/tdl 并执行 tdl login）', 'tdl', 'info');
+        return null;
+    }
+    // 2. 准备临时目录
+    const workDir = opts.workDir || path.join(os.tmpdir(), `rss-owl-tdl-${crypto.randomBytes(6).toString('hex')}`);
+    try {
+        fs.mkdirSync(workDir, { recursive: true });
+    }
+    catch (err) {
+        (0, logger_1.debug)(config, `tdl 临时目录创建失败: ${err}`, 'tdl', 'error');
+        return null;
+    }
+    // 3. 构造子进程环境（按需透传代理）
+    const childEnv = { ...process.env };
+    const proxyByEnv = config.tdl?.proxyByEnv !== false;
+    if (proxyByEnv && proxyAgent?.enabled && proxyAgent.host && proxyAgent.port) {
+        const proxyUrl = `${proxyAgent.protocol || 'http'}://${proxyAgent.auth?.enabled
+            ? `${encodeURIComponent(proxyAgent.auth.username)}:${encodeURIComponent(proxyAgent.auth.password)}@`
+            : ''}${proxyAgent.host}:${proxyAgent.port}`;
+        childEnv.HTTPS_PROXY = proxyUrl;
+        childEnv.HTTP_PROXY = proxyUrl;
+        (0, logger_1.debug)(config, `tdl 子进程已透传代理: ${proxyAgent.protocol}://${proxyAgent.host}:${proxyAgent.port}`, 'tdl', 'details');
+    }
+    const args = ['dl', '-u', link, '-d', workDir, '-f'];
+    (0, logger_1.debug)(config, `调用 tdl 下载: tdl ${args.join(' ')}（超时 ${timeoutSeconds}s）`, 'tdl', 'info');
+    try {
+        await execFileAsync('tdl', args, {
+            env: childEnv,
+            timeout: timeoutSeconds * 1000,
+            maxBuffer: 10 * 1024 * 1024,
+            windowsHide: true,
+        });
+    }
+    catch (err) {
+        (0, logger_1.debug)(config, `tdl 下载失败: ${err?.message || err}（可能未登录 tdl login，或消息不含可下载媒体）`, 'tdl', 'error');
+        // 即便失败也清理临时目录
+        await safeRemoveDir(workDir);
+        return null;
+    }
+    // 4. 扫描产物，挑体积最大的视频文件
+    const videoPath = pickLargestVideo(workDir);
+    if (!videoPath) {
+        (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;
+}
+/** 在目录中挑选体积最大的视频文件（mp4/mov/webm/mkv） */
+function pickLargestVideo(dir) {
+    const videoExts = new Set(['.mp4', '.mov', '.webm', '.mkv', '.m4v']);
+    let best = null;
+    try {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            const ext = path.extname(entry.name).toLowerCase();
+            if (!videoExts.has(ext))
+                continue;
+            const full = path.join(dir, entry.name);
+            try {
+                const stat = fs.statSync(full);
+                if (!best || stat.size > best.size)
+                    best = { path: full, size: stat.size };
+            }
+            catch {
+                // 单文件 stat 失败忽略
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return best?.path ?? null;
+}
+/** 静默删除目录，失败不抛错 */
+async function safeRemoveDir(dir) {
+    try {
+        await fs.promises.rm(dir, { recursive: true, force: true });
+    }
+    catch {
+        // 忽略清理失败
+    }
+}

package/lib/utils/video-compress.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 视频压缩模块（基于外部 ffmpeg）
+ *
+ * 仅在 tdl 下载产物超过阈值时触发，调用 ffmpeg 重新编码以降低体积，
+ * 便于通过 OneBot / Telegram 等适配器发送。
+ *
+ * ffmpeg 也是外部二进制（非 npm 包）。按用户决策：
+ * - ffmpeg 缺失 → 整条视频跳过（返回 null），上游按"无视频"处理。
+ * - 压缩失败 → 同样返回 null。
+ *
+ * 所有外部调用使用 execFile（非 shell），参数数组化。
+ */
+import { Config } from '../types';
+export interface CompressVideoResult {
+    /** 最终可发送的视频绝对路径（原始或压缩后） */
+    path: string;
+    /** 是否真的执行了压缩 */
+    compressed: boolean;
+    /** 原始字节数 */
+    originalSize: number;
+    /** 最终字节数 */
+    finalSize: number;
+}
+/**
+ * 判断是否需要压缩：体积超过阈值即触发。
+ *
+ * @param config 全局配置
+ */
+export declare function shouldCompress(filePath: string, config: Config): boolean;
+/**
+ * 按需压缩：体积超过阈值则压缩，否则原样返回。
+ *
+ * 调用方负责在发送完成后清理临时文件（含原始下载目录）。
+ *
+ * @returns 成功（压缩或无需压缩）返回结果对象；ffmpeg 缺失/失败导致整条跳过时返回 null
+ */
+export declare function compressVideoIfNeeded(inputPath: string, config: Config): Promise<CompressVideoResult | null>;
+/**
+ * 清理一次 tdl+压缩流程产生的临时文件。
+ *
+ * - 若 finalPath 与 originalDir 不在同目录（压缩后产物在原目录内），则只需删 originalDir。
+ * - 调用方传入 tdl 下载目录与最终发送路径即可。
+ */
+export declare function cleanupTdlArtifacts(downloadDir: string, finalPath?: string): Promise<void>;

package/lib/utils/video-compress.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * 视频压缩模块（基于外部 ffmpeg）
+ *
+ * 仅在 tdl 下载产物超过阈值时触发，调用 ffmpeg 重新编码以降低体积，
+ * 便于通过 OneBot / Telegram 等适配器发送。
+ *
+ * ffmpeg 也是外部二进制（非 npm 包）。按用户决策：
+ * - ffmpeg 缺失 → 整条视频跳过（返回 null），上游按"无视频"处理。
+ * - 压缩失败 → 同样返回 null。
+ *
+ * 所有外部调用使用 execFile（非 shell），参数数组化。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldCompress = shouldCompress;
+exports.compressVideoIfNeeded = compressVideoIfNeeded;
+exports.cleanupTdlArtifacts = cleanupTdlArtifacts;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("./logger");
+const tdl_1 = require("./tdl");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+const DEFAULT_COMPRESS_THRESHOLD_MB = 30;
+const DEFAULT_CRF = 30;
+/** ffmpeg 单次压缩超时（ms） */
+const COMPRESS_TIMEOUT_MS = 5 * 60 * 1000;
+/**
+ * 读取文件字节数，失败返回 0。
+ */
+function fileSize(filePath) {
+    try {
+        return fs.statSync(filePath).size;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * 判断是否需要压缩：体积超过阈值即触发。
+ *
+ * @param config 全局配置
+ */
+function shouldCompress(filePath, config) {
+    const thresholdMB = config.tdl?.compressThreshold ?? config.basic?.maxVideoSize ?? DEFAULT_COMPRESS_THRESHOLD_MB;
+    const thresholdBytes = thresholdMB * 1024 * 1024;
+    const size = fileSize(filePath);
+    return size > thresholdBytes;
+}
+/**
+ * 调用 ffmpeg 压缩单个视频文件。
+ *
+ * 编码参数：libx264 + CRF(默认30) + veryfast + AAC 96k + faststart
+ * 产物落在原文件同目录，文件名加 `.cmp` 后缀，避免覆盖原文件。
+ *
+ * @returns 压缩成功返回新文件路径；失败返回 null
+ */
+async function runFfmpegCompress(inputPath, config) {
+    const hasFfmpeg = await (0, tdl_1.detectBinary)('ffmpeg', ['-version']);
+    if (!hasFfmpeg) {
+        (0, logger_1.debug)(config, '未在 PATH 中检测到 ffmpeg，按策略跳过整条大视频（请安装 ffmpeg 或调高 maxVideoSize/compressThreshold）', 'compress', 'info');
+        return null;
+    }
+    const crf = clampCrf(config.tdl?.crf ?? DEFAULT_CRF);
+    const parsed = path.parse(inputPath);
+    const outputPath = path.join(parsed.dir, `${parsed.name}.cmp${parsed.ext}`);
+    // 清理可能残留的输出文件
+    try {
+        fs.rmSync(outputPath, { force: true });
+    }
+    catch { /* ignore */ }
+    const args = [
+        '-y',
+        '-i', inputPath,
+        '-c:v', 'libx264',
+        '-crf', String(crf),
+        '-preset', 'veryfast',
+        '-c:a', 'aac',
+        '-b:a', '96k',
+        '-movflags', '+faststart',
+        outputPath,
+    ];
+    (0, logger_1.debug)(config, `调用 ffmpeg 压缩: ffmpeg ${args.join(' ')}（CRF=${crf}）`, 'compress', 'info');
+    try {
+        await execFileAsync('ffmpeg', args, {
+            timeout: COMPRESS_TIMEOUT_MS,
+            maxBuffer: 10 * 1024 * 1024,
+            windowsHide: true,
+        });
+    }
+    catch (err) {
+        (0, logger_1.debug)(config, `ffmpeg 压缩失败: ${err?.message || err}`, 'compress', 'error');
+        try {
+            fs.rmSync(outputPath, { force: true });
+        }
+        catch { /* ignore */ }
+        return null;
+    }
+    if (!fs.existsSync(outputPath) || fileSize(outputPath) === 0) {
+        (0, logger_1.debug)(config, 'ffmpeg 压缩完成但产物无效（空文件或不存在）', 'compress', 'error');
+        try {
+            fs.rmSync(outputPath, { force: true });
+        }
+        catch { /* ignore */ }
+        return null;
+    }
+    return outputPath;
+}
+/**
+ * 按需压缩：体积超过阈值则压缩，否则原样返回。
+ *
+ * 调用方负责在发送完成后清理临时文件（含原始下载目录）。
+ *
+ * @returns 成功（压缩或无需压缩）返回结果对象；ffmpeg 缺失/失败导致整条跳过时返回 null
+ */
+async function compressVideoIfNeeded(inputPath, config) {
+    const originalSize = fileSize(inputPath);
+    if (originalSize === 0) {
+        (0, logger_1.debug)(config, `待处理的视频文件为空或不存在: ${inputPath}`, 'compress', 'error');
+        return null;
+    }
+    if (!shouldCompress(inputPath, config)) {
+        (0, logger_1.debug)(config, `视频体积 ${(originalSize / 1024 / 1024).toFixed(2)} MB 未超阈值，无需压缩`, 'compress', 'details');
+        return { path: inputPath, compressed: false, originalSize, finalSize: originalSize };
+    }
+    const compressedPath = await runFfmpegCompress(inputPath, config);
+    if (!compressedPath) {
+        // ffmpeg 缺失或压缩失败 → 按用户策略跳过整条视频
+        return null;
+    }
+    const finalSize = fileSize(compressedPath);
+    const ratio = originalSize > 0 ? ((1 - finalSize / originalSize) * 100).toFixed(1) : '0';
+    (0, logger_1.debug)(config, `视频压缩完成: ${(originalSize / 1024 / 1024).toFixed(2)} MB -> ${(finalSize / 1024 / 1024).toFixed(2)} MB（节省 ${ratio}%）`, 'compress', 'info');
+    return { path: compressedPath, compressed: true, originalSize, finalSize };
+}
+/**
+ * 把 CRF 限定到合理区间 [18, 32]。
+ *
+ * 18 接近视觉无损、体积大；32 体积小但质量下降明显。
+ */
+function clampCrf(crf) {
+    if (!Number.isFinite(crf))
+        return DEFAULT_CRF;
+    return Math.min(32, Math.max(18, Math.round(crf)));
+}
+/**
+ * 清理一次 tdl+压缩流程产生的临时文件。
+ *
+ * - 若 finalPath 与 originalDir 不在同目录（压缩后产物在原目录内），则只需删 originalDir。
+ * - 调用方传入 tdl 下载目录与最终发送路径即可。
+ */
+async function cleanupTdlArtifacts(downloadDir, finalPath) {
+    // 删除整个下载目录（压缩产物也在其内）
+    await (0, tdl_1.safeRemoveDir)(downloadDir);
+    // finalPath 无需单独删，因为它就在 downloadDir 内
+    void finalPath;
+}

package/package.json

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