koishi-plugin-video-parser-all 0.9.9 → 1.0.1

package/lib/index.d.ts

@@ -14,6 +14,7 @@ export declare const Config: Schema<{
     videoDownloadTimeout?: number | null | undefined;
     tempDir?: string | null | undefined;
     maxVideoSize?: number | null | undefined;
+    forceDownloadVideo?: boolean | null | undefined;
 } & {
     timeout?: number | null | undefined;
     videoSendTimeout?: number | null | undefined;
@@ -44,6 +45,7 @@ export declare const Config: Schema<{
     videoDownloadTimeout: number;
     tempDir: string;
     maxVideoSize: number;
+    forceDownloadVideo: boolean;
 } & {
     timeout: number;
     videoSendTimeout: number;

package/lib/index.js

@@ -28,7 +28,8 @@ exports.Config = koishi_1.Schema.intersect([
         maxDescLength: koishi_1.Schema.number().default(200).description('简介内容最大长度（字符），超出自动截断'),
         videoDownloadTimeout: koishi_1.Schema.number().default(120000).description('视频下载超时（毫秒）'),
         tempDir: koishi_1.Schema.string().default('./temp_videos').description('临时视频存储目录'),
-        maxVideoSize: koishi_1.Schema.number().default(100 * 1024 * 1024).description('最大下载视频大小（字节），默认100MB'),
+        maxVideoSize: koishi_1.Schema.number().min(0).step(1).default(0).description('最大下载视频大小（MB），0 为不限制大小'),
+        forceDownloadVideo: koishi_1.Schema.boolean().default(true).description('强制下载视频后发送（解决部分平台URL无法直接发送的问题）'),
     }).description('内容显示设置'),
     koishi_1.Schema.object({
         timeout: koishi_1.Schema.number().min(0).default(180000).description('API 请求超时（毫秒）'),
@@ -41,7 +42,7 @@ exports.Config = koishi_1.Schema.intersect([
         retryInterval: koishi_1.Schema.number().min(0).default(1000).description('重试间隔（毫秒，同时用于消息发送重试）'),
     }).description('错误与重试设置'),
     koishi_1.Schema.object({
-        enableForward: koishi_1.Schema.boolean().default(false).description('启用合并转发（仅 OneBot 平台）'),
+        enableForward: koishi_1.Schema.boolean().default(false).description('启用合并转发（仅 OneBot 平台），视频会单独发送'),
     }).description('发送方式设置'),
     koishi_1.Schema.object({
         waitingTipText: koishi_1.Schema.string().default('正在解析视频，请稍候...').description('解析等待提示'),
@@ -208,7 +209,7 @@ function formatDuration(seconds) {
     const s = Math.floor(seconds % 60);
     if (h > 0)
         return `${h}:${m.toString().padStart(2, '0')}:${s.toString().padStart(2, '0')}`;
-    return `${m}:${s.toString().padStart(2, '0')}`;
+    return `${m}:${s.toString().padStart(2, '0')}:${s.toString().padStart(2, '0')}`;
 }
 function formatPublishTime(ms) {
     if (!ms)
@@ -362,7 +363,7 @@ function buildForwardNode(session, content, botName) {
 }
 const urlCache = new Map();
 const CACHE_TTL = 10 * 60 * 1000;
-async function downloadVideoFile(videoUrl, tempDir, timeout, maxSize) {
+async function downloadVideoFile(videoUrl, tempDir, timeout, maxSizeMB) {
     await promises_1.default.mkdir(tempDir, { recursive: true });
     const fileName = `video_${Date.now()}_${Math.random().toString(36).substring(2, 8)}.mp4`;
     const filePath = path_1.default.join(tempDir, fileName);
@@ -376,20 +377,21 @@ async function downloadVideoFile(videoUrl, tempDir, timeout, maxSize) {
             'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
         }
     });
+    const maxSizeBytes = maxSizeMB * 1024 * 1024;
     const contentLength = Number(response.headers['content-length'] || 0);
-    if (contentLength > maxSize) {
+    if (maxSizeMB > 0 && contentLength > maxSizeBytes) {
         writer.destroy();
         await promises_1.default.unlink(filePath).catch(() => { });
-        throw new Error(`视频文件过大(${Math.round(contentLength / 1024 / 1024)}MB)，超过限制(${Math.round(maxSize / 1024 / 1024)}MB)`);
+        throw new Error(`视频文件过大(${Math.round(contentLength / 1024 / 1024)}MB)，超过限制(${maxSizeMB}MB)`);
     }
     let downloadedSize = 0;
     response.data.on('data', (chunk) => {
         downloadedSize += chunk.length;
-        if (downloadedSize > maxSize) {
+        if (maxSizeMB > 0 && downloadedSize > maxSizeBytes) {
             response.data.destroy();
             writer.destroy();
             promises_1.default.unlink(filePath).catch(() => { });
-            throw new Error(`视频文件过大，超过限制(${Math.round(maxSize / 1024 / 1024)}MB)`);
+            throw new Error(`视频文件过大，超过限制(${maxSizeMB}MB)`);
         }
     });
     await (0, promises_2.pipeline)(response.data, writer);
@@ -400,6 +402,19 @@ function getErrorMessage(error) {
         return error.message;
     return String(error);
 }
+function isSpecialPlatformVideo(url) {
+    const specialHosts = [
+        'bilibili.com',
+        'akamaized.net',
+        'hdslb.com',
+        'xiaohongshu.com',
+        'xhslink.com',
+        'zhihu.com',
+        'weibo.com',
+        'sinaimg.cn'
+    ];
+    return specialHosts.some(host => url.includes(host));
+}
 function apply(ctx, config) {
     debugEnabled = config.debug || false;
     debugLog('INFO', '插件初始化开始');
@@ -513,23 +528,29 @@ function apply(ctx, config) {
     async function sendVideoFile(session, videoUrl) {
         if (!videoUrl)
             throw new Error('视频链接为空');
-        try {
-            debugLog('INFO', `尝试直接发送视频URL: ${videoUrl.substring(0, 100)}...`);
-            return await sendWithTimeout(session, koishi_1.h.video(videoUrl));
-        }
-        catch (err) {
-            debugLog('ERROR', `直接发送URL失败，开始下载视频: ${getErrorMessage(err)}`);
-            let tempFilePath = null;
+        const shouldForceDownload = config.forceDownloadVideo || isSpecialPlatformVideo(videoUrl);
+        if (!shouldForceDownload) {
             try {
-                tempFilePath = await downloadVideoFile(videoUrl, config.tempDir || './temp_videos', config.videoDownloadTimeout || 120000, config.maxVideoSize || 100 * 1024 * 1024);
-                const localFile = `file://${path_1.default.resolve(tempFilePath)}`;
-                debugLog('INFO', `视频下载完成，发送本地文件: ${localFile}`);
-                return await sendWithTimeout(session, koishi_1.h.video(localFile));
+                debugLog('INFO', `尝试直接发送视频URL: ${videoUrl.substring(0, 100)}...`);
+                return await sendWithTimeout(session, koishi_1.h.video(videoUrl));
             }
-            finally {
-                if (tempFilePath) {
-                    promises_1.default.unlink(tempFilePath).catch(e => debugLog('WARN', `删除临时文件失败: ${e}`));
-                }
+            catch (err) {
+                debugLog('ERROR', `直接发送URL失败，开始下载视频: ${getErrorMessage(err)}`);
+            }
+        }
+        else {
+            debugLog('INFO', `检测到特殊平台视频，强制下载后发送: ${videoUrl.substring(0, 100)}...`);
+        }
+        let tempFilePath = null;
+        try {
+            tempFilePath = await downloadVideoFile(videoUrl, config.tempDir || './temp_videos', config.videoDownloadTimeout || 120000, config.maxVideoSize || 0);
+            const localFile = `file://${path_1.default.resolve(tempFilePath)}`;
+            debugLog('INFO', `视频下载完成，发送本地文件: ${localFile}`);
+            return await sendWithTimeout(session, koishi_1.h.video(localFile));
+        }
+        finally {
+            if (tempFilePath) {
+                promises_1.default.unlink(tempFilePath).catch(e => debugLog('WARN', `删除临时文件失败: ${e}`));
             }
         }
     }
@@ -566,6 +587,7 @@ function apply(ctx, config) {
             return;
         const enableForward = config.enableForward && session.platform === 'onebot';
         const botName = config.botName || '视频解析机器人';
+        const videoItems = [];
         if (enableForward) {
             const forwardMessages = [];
             for (const item of items) {
@@ -583,6 +605,9 @@ function apply(ctx, config) {
                         forwardMessages.push(buildForwardNode(session, koishi_1.h.image(imgUrl), botName));
                     }
                 }
+                if (p.video && config.showVideoFile && (p.type === 'video' || (p.type === 'live' && !p.live_photo?.length && !p.images?.length))) {
+                    videoItems.push(p);
+                }
             }
             if (forwardMessages.length) {
                 const forwardMsg = (0, koishi_1.h)('message', { forward: true }, forwardMessages.slice(0, 100));
@@ -597,18 +622,15 @@ function apply(ctx, config) {
                     }
                 }
             }
-            for (const item of items) {
-                const p = item.parsed;
-                if (p.video && config.showVideoFile && (p.type === 'video' || (p.type === 'live' && !p.live_photo?.length && !p.images?.length))) {
-                    try {
-                        await sendVideoFile(session, p.video);
-                    }
-                    catch (err) {
-                        debugLog('ERROR', `视频发送失败（降级发送链接）: ${getErrorMessage(err)}`);
-                        await sendWithTimeout(session, `视频链接：${p.video}`).catch(() => { });
-                    }
-                    await delay(500);
+            for (const p of videoItems) {
+                try {
+                    await sendVideoFile(session, p.video);
+                }
+                catch (err) {
+                    debugLog('ERROR', `视频发送失败（降级发送链接）: ${getErrorMessage(err)}`);
+                    await sendWithTimeout(session, `视频链接：${p.video}`).catch(() => { });
                 }
+                await delay(500);
             }
         }
         else {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-video-parser-all",
   "description": "Koishi 全平台视频解析插件，支持抖音/快手/B站/微博/小红书/剪映/YouTube/TikTok等20+平台",
-  "version": "0.9.9",
+  "version": "1.0.1",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -5,24 +5,28 @@
 ### 中文
 这是一个为 Koishi 机器人框架开发的**全平台视频/图集解析插件**，使用统一API接口，支持自动识别并解析抖音、快手、B站、小红书、微博、YouTube、TikTok、剪映、AcFun、知乎、虎牙等20+主流平台的短视频/图集/实况链接。核心特性：
 - 🌐 统一API解析，覆盖20+热门平台，无需繁琐配置
-- 🤖 自动识别链接来源，即丢即用，并支持解析 XML 卡片消息中的链接（如 QQ/OneBot 平台的分享卡片）
+- 🤖 自动识别链接来源，即丢即用，并支持解析 XML/JSON 卡片消息中的链接（如 QQ/OneBot 平台的分享卡片）
 - 🎨 完全自定义的解析结果格式，支持多项变量替换，变量无值自动隐藏行
 - 🐛 内置Debug调试模式，可详细记录所有操作与API交互日志
 - 📤 支持OneBot平台消息合并转发，优化多图文展示体验
 - 💬 所有提示文案均可自定义，适配多语言场景
 - 🔁 消息发送支持自动重试，与API重试配置联动，增强稳定性
 - 🚀 内置内存缓存，避免短时间内重复解析同一链接；并发控制，防止资源耗尽
+- ⚡ 智能视频发送策略：普通平台优先直接发送URL，特殊平台自动降级为本地文件发送
+- 🛡️ 可选视频大小限制，防止超大文件占满服务器磁盘；自动清理所有临时文件
 
 ### English
 This is a **multi-platform video/image parsing plugin** developed for the Koishi bot framework, using a unified API interface to automatically recognize and parse short video/image/live photo links from 20+ mainstream platforms such as Douyin, Kuaishou, Bilibili, Xiaohongshu, Weibo, YouTube, TikTok, Jianying, AcFun, Zhihu, Huya and more. Core features:
 - 🌐 Unified API parsing, covering 20+ popular platforms without complex configuration
-- 🤖 Auto-detection of link sources, drop & go, and support for extracting links from XML card messages (e.g., share cards on QQ/OneBot)
+- 🤖 Auto-detection of link sources, drop & go, and support for extracting links from XML/JSON card messages (e.g., share cards on QQ/OneBot)
 - 🎨 Fully customizable parsing result format with variable substitutions, empty variables hide the line automatically
 - 🐛 Built-in Debug mode, recording detailed operations and API interaction logs
 - 📤 Support OneBot message forwarding for better image/video display
 - 💬 All prompt texts are customizable for multilingual scenarios
 - 🔁 Message sending supports automatic retries, linked with API retry configuration for improved stability
 - 🚀 Built-in memory cache to avoid repeated parsing of the same URL; concurrency control to prevent resource exhaustion
+- ⚡ Smart video sending strategy: priority to send URL directly for common platforms, auto downgrade to local file for special platforms
+- 🛡️ Optional video size limit to prevent oversized files from filling up server disk; automatic cleanup of all temporary files
 
 ## 项目仓库 (Repository)
 - GitHub: `https://github.com/Minecraft-1314/koishi-plugin-video-parser-all`
@@ -55,13 +59,17 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 | `showImageText` | boolean | true | 是否发送解析后的文字内容 |
 | `showVideoFile` | boolean | true | 是否发送视频文件（关闭则只发送视频链接） |
 | `maxDescLength` | number | 200 | 简介内容最大长度（字符），超出自动截断 |
+| `videoDownloadTimeout` | number | 120000 | 视频下载超时（毫秒） |
+| `tempDir` | string | `./temp_videos` | 临时视频存储目录 |
+| `maxVideoSize` | number | 0 | 最大下载视频大小（MB），0 为不限制大小 |
+| `forceDownloadVideo` | boolean | true | 强制下载视频后发送（解决B站、小红书等平台URL无法直接发送的问题） |
 
 ### 网络与 API 设置
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `timeout` | number | 180000 | API 请求超时时间（毫秒） |
 | `videoSendTimeout` | number | 60000 | 视频消息发送超时时间（毫秒，0 为不限制） |
-| `userAgent` | string | Chrome 124 UA | API 请求使用的 User-Agent |
+| `userAgent` | string | `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36` | API 请求使用的 User-Agent |
 
 ### 错误与重试设置
 | 配置项 | 类型 | 默认值 | 说明 |
@@ -73,7 +81,7 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 ### 发送方式设置
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `enableForward` | boolean | false | 是否启用合并转发（仅 OneBot 平台） |
+| `enableForward` | boolean | false | 是否启用合并转发（仅 OneBot 平台），视频会单独发送 |
 
 ### 界面文字设置
 | 配置项 | 类型 | 默认值 | 说明 |
@@ -82,7 +90,7 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 | `unsupportedPlatformText` | string | 不支持该平台链接 | 不支持的平台提示 |
 | `invalidLinkText` | string | 无效的视频链接 | 无效链接提示（parse 指令） |
 | `parseErrorPrefix` | string | ❌ 解析失败： | 解析失败消息前缀 |
-| `parseErrorItemFormat` | string | 【${url}】: ${msg} | 每条解析失败的展示格式，可用 ${url}（链接）和 ${msg}（错误信息） |
+| `parseErrorItemFormat` | string | `【${url}】: ${msg}` | 每条解析失败的展示格式，可用 ${url}（链接）和 ${msg}（错误信息） |
 
 ## 支持的变量 (Supported Variables)
 在 `unifiedMessageFormat` 中可使用以下变量进行自定义格式化，某行所有变量均为空（或为"0"）时该行不显示：