npm - koishi-plugin-video-parser-all - Versions diffs - 1.3.2 → 1.3.4 - Mend

koishi-plugin-video-parser-all 1.3.2 → 1.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/lib/index.d.ts CHANGED Viewed

@@ -10,12 +10,18 @@ export declare const Config: Schema<{
 } & {
     showImageText?: boolean | null | undefined;
     showCoverImage?: boolean | null | undefined;
+    showMusicCover?: boolean | null | undefined;
+    showImageFile?: boolean | null | undefined;
+    forceDownloadImage?: boolean | null | undefined;
+    imageDownloadTimeout?: number | null | undefined;
+    imageTempDir?: string | null | undefined;
+    maxImageSize?: number | null | undefined;
     showVideoFile?: boolean | null | undefined;
-    maxDescLength?: number | null | undefined;
+    forceDownloadVideo?: boolean | null | undefined;
     videoDownloadTimeout?: number | null | undefined;
     tempDir?: string | null | undefined;
     maxVideoSize?: number | null | undefined;
-    forceDownloadVideo?: boolean | null | undefined;
+    maxDescLength?: number | null | undefined;
     maxConcurrent?: number | null | undefined;
 } & {
     timeout?: number | null | undefined;
@@ -94,12 +100,18 @@ export declare const Config: Schema<{
 } & {
     showImageText: boolean;
     showCoverImage: boolean;
+    showMusicCover: boolean;
+    showImageFile: boolean;
+    forceDownloadImage: boolean;
+    imageDownloadTimeout: number;
+    imageTempDir: string;
+    maxImageSize: number;
     showVideoFile: boolean;
-    maxDescLength: number;
+    forceDownloadVideo: boolean;
     videoDownloadTimeout: number;
     tempDir: string;
     maxVideoSize: number;
-    forceDownloadVideo: boolean;
+    maxDescLength: number;
     maxConcurrent: number;
 } & {
     timeout: number;

package/lib/index.js CHANGED Viewed

@@ -76,78 +76,84 @@ exports.Config = koishi_1.Schema.intersect([
         debug: koishi_1.Schema.boolean().default(false).description('开启调试模式，在控制台输出详细日志'),
     }).description('基础设置'),
     koishi_1.Schema.object({
-        unifiedMessageFormat: koishi_1.Schema.string().role('textarea').default('标题：${标题}\n作者：${作者}\n简介：${简介}\n音乐标题：${音乐标题}\n音乐作者：${音乐作者}\n音乐封面：${音乐封面}\n音乐链接：${音乐链接}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}').description('统一消息格式，可用变量：${标题} ${作者} ${简介} ${点赞数} ${收藏数} ${转发数} ${播放数} ${评论数} ${视频时长} ${发布时间} ${图片数量} ${作者ID} ${音乐标题} ${音乐作者} ${音乐封面} ${音乐链接}'),
+        unifiedMessageFormat: koishi_1.Schema.string().role('textarea').default('标题：${标题}\n作者：${作者}\n简介：${简介}\n音乐标题：${音乐标题}\n音乐作者：${音乐作者}\n音乐链接：${音乐链接}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}').description('文字消息格式，支持变量。某行所有变量为空时自动隐藏。封面及媒体文件由独立开关控制，默认不包含在文字中'),
     }).description('消息格式设置'),
     koishi_1.Schema.object({
-        showImageText: koishi_1.Schema.boolean().default(true).description('是否发送解析后的文字内容'),
-        showCoverImage: koishi_1.Schema.boolean().default(true).description('是否发送封面图片'),
-        showVideoFile: koishi_1.Schema.boolean().default(true).description('是否发送视频文件（关闭则只发送视频链接）'),
-        maxDescLength: koishi_1.Schema.number().min(0).step(1).default(200).description('简介内容最大长度（字符），超出自动截断'),
+        showImageText: koishi_1.Schema.boolean().default(true).description('是否发送文字内容'),
+        showCoverImage: koishi_1.Schema.boolean().default(true).description('是否发送封面图片（视频/图集封面）'),
+        showMusicCover: koishi_1.Schema.boolean().default(true).description('是否发送音乐封面图片'),
+        showImageFile: koishi_1.Schema.boolean().default(true).description('封面/图片是否以文件形式发送（关闭则只发送链接）'),
+        forceDownloadImage: koishi_1.Schema.boolean().default(false).description('强制下载封面/图片后发送'),
+        imageDownloadTimeout: koishi_1.Schema.number().min(0).step(1).default(60000).description('图片下载超时（毫秒）'),
+        imageTempDir: koishi_1.Schema.string().default('./temp_images').description('临时封面/图片存储目录'),
+        maxImageSize: koishi_1.Schema.number().min(0).step(1).default(0).description('最大下载图片大小（MB），0 为不限制'),
+        showVideoFile: koishi_1.Schema.boolean().default(true).description('视频是否以文件形式发送（关闭则只发送链接）'),
+        forceDownloadVideo: koishi_1.Schema.boolean().default(false).description('强制下载视频后发送'),
         videoDownloadTimeout: koishi_1.Schema.number().min(0).step(1).default(120000).description('视频下载超时（毫秒）'),
         tempDir: koishi_1.Schema.string().default('./temp_videos').description('临时视频存储目录'),
-        maxVideoSize: koishi_1.Schema.number().min(0).step(1).default(0).description('最大下载视频大小（MB），0 为不限制大小'),
-        forceDownloadVideo: koishi_1.Schema.boolean().default(false).description('强制下载视频后发送'),
-        maxConcurrent: koishi_1.Schema.number().min(1).step(1).default(3).description('批量解析时最大并发数'),
+        maxVideoSize: koishi_1.Schema.number().min(0).step(1).default(0).description('最大下载视频大小（MB），0 为不限制'),
+        maxDescLength: koishi_1.Schema.number().min(0).step(1).default(200).description('简介最大长度（字符）'),
+        maxConcurrent: koishi_1.Schema.number().min(1).step(1).default(3).description('批量解析最大并发数'),
     }).description('内容显示设置'),
     koishi_1.Schema.object({
         timeout: koishi_1.Schema.number().min(0).step(1).default(180000).description('API 请求超时（毫秒）'),
-        videoSendTimeout: koishi_1.Schema.number().min(0).step(1).default(60000).description('视频消息发送超时（毫秒，0 为不限制）'),
-        userAgent: koishi_1.Schema.string().default('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36').description('API 请求 UA'),
+        videoSendTimeout: koishi_1.Schema.number().min(0).step(1).default(60000).description('消息发送超时（毫秒）'),
+        userAgent: koishi_1.Schema.string().default('Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36').description('User-Agent'),
         proxy: koishi_1.Schema.object({
-            enabled: koishi_1.Schema.boolean().default(false).description('是否启用 HTTP/HTTPS 代理'),
+            enabled: koishi_1.Schema.boolean().default(false).description('启用代理'),
             protocol: koishi_1.Schema.union([
                 koishi_1.Schema.const('http').description('HTTP'),
                 koishi_1.Schema.const('https').description('HTTPS'),
-            ]).default('http').description('代理协议'),
-            host: koishi_1.Schema.string().default('127.0.0.1').description('代理地址'),
-            port: koishi_1.Schema.number().default(7890).description('代理端口'),
+            ]).default('http').description('协议'),
+            host: koishi_1.Schema.string().default('127.0.0.1').description('地址'),
+            port: koishi_1.Schema.number().default(7890).description('端口'),
             auth: koishi_1.Schema.object({
-                username: koishi_1.Schema.string().default('').description('代理用户名'),
-                password: koishi_1.Schema.string().default('').description('代理密码'),
-            }).description('代理认证'),
-        }).description('HTTP/HTTPS 代理设置（需开启 enabled）'),
+                username: koishi_1.Schema.string().default('').description('用户名'),
+                password: koishi_1.Schema.string().default('').description('密码'),
+            }).description('认证'),
+        }).description('HTTP/HTTPS 代理'),
         customHeaders: koishi_1.Schema.array(koishi_1.Schema.object({
-            name: koishi_1.Schema.string().required().description('请求头名称'),
-            value: koishi_1.Schema.string().required().description('请求头值'),
-        })).default([]).description('自定义请求头，会附加到所有 API 请求中'),
-    }).description('网络与 API 设置'),
+            name: koishi_1.Schema.string().required().description('头名称'),
+            value: koishi_1.Schema.string().required().description('头值'),
+        })).default([]).description('自定义请求头'),
+    }).description('网络设置'),
     koishi_1.Schema.object({
-        ignoreSendError: koishi_1.Schema.boolean().default(true).description('忽略消息发送失败，避免插件崩溃'),
-        retryTimes: koishi_1.Schema.number().min(0).step(1).default(3).description('API 请求及消息发送失败时的重试次数'),
-        retryInterval: koishi_1.Schema.number().min(0).step(1).default(1000).description('重试间隔（毫秒，同时用于消息发送重试）'),
-    }).description('错误与重试设置'),
+        ignoreSendError: koishi_1.Schema.boolean().default(true).description('忽略发送失败'),
+        retryTimes: koishi_1.Schema.number().min(0).step(1).default(3).description('重试次数'),
+        retryInterval: koishi_1.Schema.number().min(0).step(1).default(1000).description('重试间隔（毫秒）'),
+    }).description('错误与重试'),
     koishi_1.Schema.object({
-        enableForward: koishi_1.Schema.boolean().default(false).description('启用合并转发（仅 OneBot 平台）'),
-    }).description('发送方式设置'),
+        enableForward: koishi_1.Schema.boolean().default(false).description('启用合并转发（仅 OneBot）'),
+    }).description('发送方式'),
     koishi_1.Schema.object({
-        deduplicationInterval: koishi_1.Schema.number().min(0).step(1).default(180).description('禁止重复解析时间间隔（秒），0 为不限制'),
-        cacheTTL: koishi_1.Schema.number().min(0).step(1).default(600).description('解析结果缓存时间（秒），0 为不缓存'),
-    }).description('缓存与去重设置'),
+        deduplicationInterval: koishi_1.Schema.number().min(0).step(1).default(180).description('去重间隔（秒）'),
+        cacheTTL: koishi_1.Schema.number().min(0).step(1).default(600).description('缓存时间（秒）'),
+    }).description('缓存与去重'),
     koishi_1.Schema.object({
-        primaryApiUrl: koishi_1.Schema.string().default('https://api.bugpk.com/api/short_videos').description('主 API 地址'),
-        backupApiUrl: koishi_1.Schema.string().default('https://api.bugpk.com/api/svparse').description('备用主 API 地址'),
+        primaryApiUrl: koishi_1.Schema.string().default('https://api.bugpk.com/api/short_videos').description('主 API'),
+        backupApiUrl: koishi_1.Schema.string().default('https://api.bugpk.com/api/svparse').description('备用主 API'),
         platformDedicatedFirst: koishi_1.Schema.object({
-            bilibili: koishi_1.Schema.boolean().default(false).description('哔哩哔哩 - 优先使用专属 API'),
-            douyin: koishi_1.Schema.boolean().default(false).description('抖音 - 优先使用专属 API'),
-            kuaishou: koishi_1.Schema.boolean().default(false).description('快手 - 优先使用专属 API'),
-            xiaohongshu: koishi_1.Schema.boolean().default(false).description('小红书 - 优先使用专属 API'),
-            weibo: koishi_1.Schema.boolean().default(false).description('微博 - 优先使用专属 API'),
-            xigua: koishi_1.Schema.boolean().default(false).description('西瓜视频 - 优先使用专属 API'),
-            youtube: koishi_1.Schema.boolean().default(false).description('YouTube - 优先使用专属 API'),
-            tiktok: koishi_1.Schema.boolean().default(false).description('TikTok - 优先使用专属 API'),
-            acfun: koishi_1.Schema.boolean().default(false).description('AcFun - 优先使用专属 API'),
-            zhihu: koishi_1.Schema.boolean().default(false).description('知乎 - 优先使用专属 API'),
-            weishi: koishi_1.Schema.boolean().default(false).description('微视 - 优先使用专属 API'),
-            huya: koishi_1.Schema.boolean().default(false).description('虎牙 - 优先使用专属 API'),
-            haokan: koishi_1.Schema.boolean().default(false).description('好看视频 - 优先使用专属 API'),
-            meipai: koishi_1.Schema.boolean().default(false).description('美拍 - 优先使用专属 API'),
-            twitter: koishi_1.Schema.boolean().default(false).description('Twitter/X - 优先使用专属 API'),
-            instagram: koishi_1.Schema.boolean().default(false).description('Instagram - 优先使用专属 API'),
-            doubao: koishi_1.Schema.boolean().default(false).description('豆包 - 优先使用专属 API'),
-            doubao_chat: koishi_1.Schema.boolean().default(false).description('豆包对话 - 优先使用专属 API'),
-            oasis: koishi_1.Schema.boolean().default(false).description('绿洲 - 优先使用专属 API'),
-            wechat_channel: koishi_1.Schema.boolean().default(false).description('视频号 - 优先使用专属 API'),
-        }).description('各平台独立开关：是否优先使用专属 API'),
+            bilibili: koishi_1.Schema.boolean().default(false).description('哔哩哔哩'),
+            douyin: koishi_1.Schema.boolean().default(false).description('抖音'),
+            kuaishou: koishi_1.Schema.boolean().default(false).description('快手'),
+            xiaohongshu: koishi_1.Schema.boolean().default(false).description('小红书'),
+            weibo: koishi_1.Schema.boolean().default(false).description('微博'),
+            xigua: koishi_1.Schema.boolean().default(false).description('西瓜视频'),
+            youtube: koishi_1.Schema.boolean().default(false).description('YouTube'),
+            tiktok: koishi_1.Schema.boolean().default(false).description('TikTok'),
+            acfun: koishi_1.Schema.boolean().default(false).description('AcFun'),
+            zhihu: koishi_1.Schema.boolean().default(false).description('知乎'),
+            weishi: koishi_1.Schema.boolean().default(false).description('微视'),
+            huya: koishi_1.Schema.boolean().default(false).description('虎牙'),
+            haokan: koishi_1.Schema.boolean().default(false).description('好看视频'),
+            meipai: koishi_1.Schema.boolean().default(false).description('美拍'),
+            twitter: koishi_1.Schema.boolean().default(false).description('Twitter/X'),
+            instagram: koishi_1.Schema.boolean().default(false).description('Instagram'),
+            doubao: koishi_1.Schema.boolean().default(false).description('豆包'),
+            doubao_chat: koishi_1.Schema.boolean().default(false).description('豆包对话'),
+            oasis: koishi_1.Schema.boolean().default(false).description('绿洲'),
+            wechat_channel: koishi_1.Schema.boolean().default(false).description('视频号'),
+        }).description('优先使用专属 API'),
         customApis: koishi_1.Schema.array(koishi_1.Schema.object({
             platform: koishi_1.Schema.union([
                 koishi_1.Schema.const('bilibili').description('哔哩哔哩'),
@@ -170,17 +176,17 @@ exports.Config = koishi_1.Schema.intersect([
                 koishi_1.Schema.const('doubao_chat').description('豆包对话'),
                 koishi_1.Schema.const('oasis').description('绿洲'),
                 koishi_1.Schema.const('wechat_channel').description('视频号'),
-            ]).description('选择平台'),
+            ]).description('平台'),
             apiUrl: koishi_1.Schema.string().description('API 地址'),
-            apiKey: koishi_1.Schema.string().description('API Key（可选）').default(''),
+            apiKey: koishi_1.Schema.string().description('API Key').default(''),
             authHeaderType: koishi_1.Schema.union([
-                koishi_1.Schema.const('Bearer').description('Bearer Token'),
+                koishi_1.Schema.const('Bearer').description('Bearer'),
                 koishi_1.Schema.const('X-API-Key').description('X-API-Key'),
-                koishi_1.Schema.const('Custom').description('自定义 Header 名称'),
+                koishi_1.Schema.const('Custom').description('自定义'),
             ]).default('Bearer').description('认证头类型'),
-            customHeaderName: koishi_1.Schema.string().description('自定义 Header 名称（仅当选择 Custom 时有效）').default('X-API-Key'),
-            fieldMapping: koishi_1.Schema.string().role('textarea').default('{}').description('字段映射 JSON，例如 {"title":"data.info.name"}，支持点号路径'),
-        })).default([]).description('自定义平台专属 API 地址，留空则使用内置默认专属 API'),
+            customHeaderName: koishi_1.Schema.string().default('X-API-Key').description('自定义头名称'),
+            fieldMapping: koishi_1.Schema.string().role('textarea').default('{}').description('字段映射 JSON'),
+        })).default([]).description('自定义专属 API'),
         globalFieldMapping: koishi_1.Schema.string().role('textarea').default('{\n' +
             '  "title": "data.title",\n' +
             '  "desc": "data.description",\n' +
@@ -203,15 +209,15 @@ exports.Config = koishi_1.Schema.intersect([
             '  "music_author": "data.music.author",\n' +
             '  "music_cover": "data.music.cover",\n' +
             '  "music_url": "data.music.url"\n' +
-            '}').description('全局字段映射 JSON，优先级低于专属 API 映射'),
-    }).description('API 选择设置'),
+            '}').description('全局字段映射 JSON'),
+    }).description('API 选择'),
     koishi_1.Schema.object({
-        waitingTipText: koishi_1.Schema.string().default('正在解析视频，请稍候...').description('解析等待提示文字'),
-        unsupportedPlatformText: koishi_1.Schema.string().default('不支持该平台链接').description('不支持的平台提示文字'),
-        invalidLinkText: koishi_1.Schema.string().default('无效的视频链接').description('无效链接提示（parse 指令）'),
-        parseErrorPrefix: koishi_1.Schema.string().default('❌ 解析失败：').description('解析失败消息前缀'),
-        parseErrorItemFormat: koishi_1.Schema.string().default('【${url}】: ${msg}').description('每条解析失败的展示格式，可用 ${url}（链接）和 ${msg}（错误信息）'),
-    }).description('界面文字设置'),
+        waitingTipText: koishi_1.Schema.string().default('正在解析视频，请稍候...').description('等待提示'),
+        unsupportedPlatformText: koishi_1.Schema.string().default('不支持该平台链接').description('不支持提示'),
+        invalidLinkText: koishi_1.Schema.string().default('无效的视频链接').description('无效链接提示'),
+        parseErrorPrefix: koishi_1.Schema.string().default('❌ 解析失败：').description('错误前缀'),
+        parseErrorItemFormat: koishi_1.Schema.string().default('【${url}】: ${msg}').description('错误项格式'),
+    }).description('界面文字'),
 ]);
 const logger = new koishi_1.Logger(exports.name);
 let debugEnabled = false;
@@ -523,7 +529,6 @@ function generateFormattedText(p, format) {
         '发布时间': p.publishTime ? formatPublishTime(p.publishTime) : '',
         '图片数量': String(imageCount),
         '作者ID': p.uid,
-        '封面': p.cover,
         '视频链接': p.video,
         '音乐标题': p.music.title || '',
         '音乐作者': p.music.author || '',
@@ -724,113 +729,125 @@ function apply(ctx, config) {
             throw new Error(`写入视频文件失败: ${getErrorMessage(e)}`);
         }
     }
-    async function fetchApi(url, type, fieldMapping) {
-        const cacheKey = url;
-        const cached = urlCacheLocal.get(cacheKey);
-        if (cached && cached.expire > Date.now())
-            return cached.data;
-        const { apiUrl: dedicatedUrl, dedicatedFirst, apiKey, authHeaderType, customHeaderName } = getPlatformConfig(type);
-        const primaryApi = config.primaryApiUrl || 'https://api.bugpk.com/api/short_videos';
-        const backupApi = config.backupApiUrl || 'https://api.bugpk.com/api/svparse';
-        const backupAllowed = backupSupportedPlatforms.has(type);
-        const apiList = [];
-        if (dedicatedFirst && dedicatedUrl) {
-            apiList.push({ url: dedicatedUrl, label: `专属API(${type})`, apiKey, authHeaderType, customHeaderName, fieldMapping });
-            apiList.push({ url: primaryApi, label: '默认主API', fieldMapping });
-            if (backupAllowed)
-                apiList.push({ url: backupApi, label: '备用主API', fieldMapping });
+    async function downloadImageFile(imageUrl) {
+        if (!imageUrl)
+            throw new Error('图片链接为空');
+        const imgTempDir = config.imageTempDir || './temp_images';
+        await promises_1.default.mkdir(imgTempDir, { recursive: true });
+        const ext = imageUrl.match(/\.(png|jpg|jpeg|gif|webp)(\?|$)/i)?.[1] || 'jpg';
+        const fileName = `img_${Date.now()}_${(0, crypto_1.randomBytes)(4).toString('hex')}.${ext}`;
+        const filePath = path_1.default.resolve(imgTempDir, fileName);
+        const writer = (0, fs_1.createWriteStream)(filePath);
+        let response;
+        try {
+            response = await http({
+                method: 'GET',
+                url: imageUrl,
+                responseType: 'stream',
+                timeout: config.imageDownloadTimeout || 60000,
+                headers: { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36', 'Referer': 'https://www.baidu.com/' },
+                maxRedirects: 5,
+                validateStatus: (status) => status >= 200 && status < 300,
+            });
         }
-        else {
-            apiList.push({ url: primaryApi, label: '默认主API', fieldMapping });
-            if (backupAllowed)
-                apiList.push({ url: backupApi, label: '备用主API', fieldMapping });
-            if (dedicatedUrl)
-                apiList.push({ url: dedicatedUrl, label: `专属API(${type})`, apiKey, authHeaderType, customHeaderName, fieldMapping });
+        catch (e) {
+            writer.destroy();
+            await promises_1.default.unlink(filePath).catch(() => { });
+            throw new Error(`下载图片失败: ${getErrorMessage(e)}`);
         }
-        const customHeaders = config.customHeaders || [];
-        let lastError = null;
-        for (const api of apiList) {
-            for (let attempt = 0; attempt <= config.retryTimes; attempt++) {
+        const maxSizeBytes = (config.maxImageSize ?? 0) * 1024 * 1024;
+        const contentLength = Number(response.headers['content-length'] || 0);
+        if (maxSizeBytes > 0 && contentLength > maxSizeBytes) {
+            writer.destroy();
+            await promises_1.default.unlink(filePath).catch(() => { });
+            throw new Error(`图片文件过大(${Math.round(contentLength / 1024 / 1024)}MB)，超过限制(${config.maxImageSize}MB)`);
+        }
+        try {
+            await (0, promises_2.pipeline)(response.data, writer);
+            return filePath;
+        }
+        catch (e) {
+            await promises_1.default.unlink(filePath).catch(() => { });
+            throw new Error(`写入图片文件失败: ${getErrorMessage(e)}`);
+        }
+    }
+    async function sendImage(session, imageUrl) {
+        if (!config.showCoverImage)
+            return;
+        const sendLink = async () => { await sendWithTimeout(session, `图片链接：${imageUrl}`).catch(() => { }); };
+        if (config.forceDownloadImage) {
+            try {
+                const localPath = await downloadImageFile(imageUrl);
+                await sendWithTimeout(session, koishi_1.h.image(`file://${localPath}`));
+                return;
+            }
+            catch (e) {
+                debugLog('ERROR', '强制下载图片失败，尝试URL发送:', getErrorMessage(e));
                 try {
-                    const headers = {
-                        'User-Agent': config.userAgent,
-                        'Referer': 'https://www.baidu.com/',
-                        'Content-Type': 'application/x-www-form-urlencoded'
-                    };
-                    for (const h of customHeaders) {
-                        if (h.name && h.value)
-                            headers[h.name] = h.value;
-                    }
-                    if (api.apiKey) {
-                        const authHeaders = buildAuthHeaders(api.apiKey, api.authHeaderType || 'Bearer', api.customHeaderName || 'X-API-Key');
-                        Object.assign(headers, authHeaders);
-                    }
-                    const res = await http.get(api.url, { params: { url }, timeout: config.timeout, headers });
-                    if (res.data && (res.data.code === 200 || res.data.code === 0)) {
-                        const parsed = parseApiResponse(res.data, config.maxDescLength, api.fieldMapping);
-                        urlCacheLocal.set(cacheKey, { data: parsed, expire: Date.now() + cacheTTL });
-                        return parsed;
-                    }
-                    throw new Error(res.data?.msg || `API返回错误码: ${res.data?.code}`);
+                    await sendWithTimeout(session, koishi_1.h.image(imageUrl));
+                    return;
                 }
-                catch (error) {
-                    lastError = error instanceof Error ? error : new Error(String(error));
-                    debugLog('ERROR', `${api.label} attempt ${attempt + 1} failed: ${lastError.message}`);
-                    if (attempt < config.retryTimes)
-                        await delay(config.retryInterval);
+                catch {
+                    await sendLink();
                 }
             }
-            debugLog('WARN', `${api.label} all retries failed`);
+            return;
         }
-        throw lastError || new Error('所有API请求全部失败');
-    }
-    async function parseUrl(url, type, fieldMapping) {
-        const realUrl = await resolveShortUrl(url);
-        const candidates = [...new Set([realUrl, url])];
-        for (const candidate of candidates) {
+        if (!config.showImageFile) {
+            await sendLink();
+            return;
+        }
+        try {
+            await sendWithTimeout(session, koishi_1.h.image(imageUrl));
+        }
+        catch {
             try {
-                const info = await fetchApi(candidate, type, fieldMapping);
-                if (info.video || info.images.length > 0 || info.live_photo.length > 0)
-                    return { success: true, data: info };
-                debugLog('WARN', `解析成功但无内容: ${candidate}`);
+                const localPath = await downloadImageFile(imageUrl);
+                await sendWithTimeout(session, koishi_1.h.image(`file://${localPath}`));
             }
-            catch (error) {
-                debugLog('ERROR', `候选链接失败: ${candidate}`, getErrorMessage(error));
+            catch {
+                await sendLink();
             }
         }
-        return { success: false, msg: texts.unsupportedPlatformText };
     }
-    async function processSingleUrl(url, type, fieldMapping) {
-        const result = await parseUrl(url, type, fieldMapping);
-        if (!result.success)
-            return { success: false, msg: result.msg, url };
-        const text = generateFormattedText(result.data, config.unifiedMessageFormat);
-        return { success: true, data: { text, parsed: result.data } };
-    }
-    async function sendWithTimeout(session, content, customRetries) {
-        const maxRetries = customRetries ?? config.retryTimes ?? 3;
-        const retryDelay = config.retryInterval || 1000;
-        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    async function sendMusicCover(session, imageUrl) {
+        if (!config.showMusicCover)
+            return;
+        const sendLink = async () => { await sendWithTimeout(session, `图片链接：${imageUrl}`).catch(() => { }); };
+        if (config.forceDownloadImage) {
             try {
-                let sendPromise = session.send(content);
-                if (config.videoSendTimeout > 0) {
-                    const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('发送超时')), config.videoSendTimeout));
-                    return await Promise.race([sendPromise, timeoutPromise]);
+                const localPath = await downloadImageFile(imageUrl);
+                await sendWithTimeout(session, koishi_1.h.image(`file://${localPath}`));
+                return;
+            }
+            catch (e) {
+                debugLog('ERROR', '强制下载音乐封面失败，尝试URL发送:', getErrorMessage(e));
+                try {
+                    await sendWithTimeout(session, koishi_1.h.image(imageUrl));
+                    return;
                 }
-                else {
-                    return await sendPromise;
+                catch {
+                    await sendLink();
                 }
             }
-            catch (err) {
-                const errMsg = getErrorMessage(err);
-                debugLog('ERROR', `发送失败尝试 ${attempt + 1}: ${errMsg}`);
-                if (attempt < maxRetries)
-                    await delay(retryDelay);
-                else if (!config.ignoreSendError)
-                    throw err;
+            return;
+        }
+        if (!config.showImageFile) {
+            await sendLink();
+            return;
+        }
+        try {
+            await sendWithTimeout(session, koishi_1.h.image(imageUrl));
+        }
+        catch {
+            try {
+                const localPath = await downloadImageFile(imageUrl);
+                await sendWithTimeout(session, koishi_1.h.image(`file://${localPath}`));
+            }
+            catch {
+                await sendLink();
             }
         }
-        return null;
     }
     async function sendVideoFile(session, videoUrl) {
         if (!videoUrl)
@@ -845,7 +862,7 @@ function apply(ctx, config) {
                 return;
             }
             catch (e) {
-                debugLog('ERROR', '强制下载失败，尝试URL发送:', getErrorMessage(e));
+                debugLog('ERROR', '强制下载视频失败，尝试URL发送:', getErrorMessage(e));
                 try {
                     await sendWithTimeout(session, koishi_1.h.video(videoUrl));
                     return;
@@ -917,8 +934,12 @@ function apply(ctx, config) {
                 const text = item.text;
                 if (text && config.showImageText)
                     forwardMessages.push(buildForwardNode(session, text, botName));
-                if (config.showCoverImage && p.cover && p.type !== 'live_photo' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length)))
+                if (p.cover && config.showCoverImage && p.type !== 'live_photo' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
                     forwardMessages.push(buildForwardNode(session, koishi_1.h.image(p.cover), botName));
+                }
+                if (config.showMusicCover && p.music.cover) {
+                    forwardMessages.push(buildForwardNode(session, koishi_1.h.image(p.music.cover), botName));
+                }
                 if (p.type === 'image' || p.type === 'live_photo' || (p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
                     const imageUrls = p.images?.length ? p.images : (p.live_photo?.map(lp => lp.image) ?? []);
                     for (const imgUrl of imageUrls)
@@ -948,21 +969,22 @@ function apply(ctx, config) {
                     await sendWithTimeout(session, text);
                     await delay(300);
                 }
-                if (config.showCoverImage && p.cover && p.type !== 'live_photo' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
-                    await sendWithTimeout(session, koishi_1.h.image(p.cover)).catch(() => { });
+                if (p.cover && config.showCoverImage && p.type !== 'live_photo' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
+                    await sendImage(session, p.cover).catch(() => { });
+                    await delay(300);
+                }
+                if (config.showMusicCover && p.music.cover) {
+                    await sendMusicCover(session, p.music.cover).catch(() => { });
                     await delay(300);
                 }
                 if (p.video && (p.type === 'video' || (p.type === 'live' && !p.live_photo?.length && !p.images?.length))) {
-                    if (config.showVideoFile)
-                        await sendVideoFile(session, p.video);
-                    else
-                        await sendWithTimeout(session, `视频链接：${p.video}`);
+                    await sendVideoFile(session, p.video);
                     await delay(500);
                 }
                 if (p.type === 'image' || p.type === 'live_photo' || (p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
                     const imageUrls = p.images?.length ? p.images : (p.live_photo?.map(lp => lp.image) ?? []);
                     for (const imgUrl of imageUrls) {
-                        await sendWithTimeout(session, koishi_1.h.image(imgUrl)).catch(() => { });
+                        await sendImage(session, imgUrl).catch(() => { });
                         await delay(200);
                     }
                 }
@@ -970,6 +992,114 @@ function apply(ctx, config) {
         }
         debugLog('INFO', '处理完成');
     }
+    async function fetchApi(url, type, fieldMapping) {
+        const cacheKey = url;
+        const cached = urlCacheLocal.get(cacheKey);
+        if (cached && cached.expire > Date.now())
+            return cached.data;
+        const { apiUrl: dedicatedUrl, dedicatedFirst, apiKey, authHeaderType, customHeaderName } = getPlatformConfig(type);
+        const primaryApi = config.primaryApiUrl || 'https://api.bugpk.com/api/short_videos';
+        const backupApi = config.backupApiUrl || 'https://api.bugpk.com/api/svparse';
+        const backupAllowed = backupSupportedPlatforms.has(type);
+        const apiList = [];
+        if (dedicatedFirst && dedicatedUrl) {
+            apiList.push({ url: dedicatedUrl, label: `专属API(${type})`, apiKey, authHeaderType, customHeaderName, fieldMapping });
+            apiList.push({ url: primaryApi, label: '默认主API', fieldMapping });
+            if (backupAllowed)
+                apiList.push({ url: backupApi, label: '备用主API', fieldMapping });
+        }
+        else {
+            apiList.push({ url: primaryApi, label: '默认主API', fieldMapping });
+            if (backupAllowed)
+                apiList.push({ url: backupApi, label: '备用主API', fieldMapping });
+            if (dedicatedUrl)
+                apiList.push({ url: dedicatedUrl, label: `专属API(${type})`, apiKey, authHeaderType, customHeaderName, fieldMapping });
+        }
+        const customHeaders = config.customHeaders || [];
+        let lastError = null;
+        for (const api of apiList) {
+            for (let attempt = 0; attempt <= config.retryTimes; attempt++) {
+                try {
+                    const headers = {
+                        'User-Agent': config.userAgent,
+                        'Referer': 'https://www.baidu.com/',
+                        'Content-Type': 'application/x-www-form-urlencoded'
+                    };
+                    for (const h of customHeaders) {
+                        if (h.name && h.value)
+                            headers[h.name] = h.value;
+                    }
+                    if (api.apiKey) {
+                        const authHeaders = buildAuthHeaders(api.apiKey, api.authHeaderType || 'Bearer', api.customHeaderName || 'X-API-Key');
+                        Object.assign(headers, authHeaders);
+                    }
+                    const res = await http.get(api.url, { params: { url }, timeout: config.timeout, headers });
+                    if (res.data && (res.data.code === 200 || res.data.code === 0)) {
+                        const parsed = parseApiResponse(res.data, config.maxDescLength, api.fieldMapping);
+                        urlCacheLocal.set(cacheKey, { data: parsed, expire: Date.now() + cacheTTL });
+                        return parsed;
+                    }
+                    throw new Error(res.data?.msg || `API返回错误码: ${res.data?.code}`);
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error : new Error(String(error));
+                    debugLog('ERROR', `${api.label} attempt ${attempt + 1} failed: ${lastError.message}`);
+                    if (attempt < config.retryTimes)
+                        await delay(config.retryInterval);
+                }
+            }
+            debugLog('WARN', `${api.label} all retries failed`);
+        }
+        throw lastError || new Error('所有API请求全部失败');
+    }
+    async function parseUrl(url, type, fieldMapping) {
+        const realUrl = await resolveShortUrl(url);
+        const candidates = [...new Set([realUrl, url])];
+        for (const candidate of candidates) {
+            try {
+                const info = await fetchApi(candidate, type, fieldMapping);
+                if (info.video || info.images.length > 0 || info.live_photo.length > 0)
+                    return { success: true, data: info };
+                debugLog('WARN', `解析成功但无内容: ${candidate}`);
+            }
+            catch (error) {
+                debugLog('ERROR', `候选链接失败: ${candidate}`, getErrorMessage(error));
+            }
+        }
+        return { success: false, msg: texts.unsupportedPlatformText };
+    }
+    async function processSingleUrl(url, type, fieldMapping) {
+        const result = await parseUrl(url, type, fieldMapping);
+        if (!result.success)
+            return { success: false, msg: result.msg, url };
+        const text = generateFormattedText(result.data, config.unifiedMessageFormat);
+        return { success: true, data: { text, parsed: result.data } };
+    }
+    async function sendWithTimeout(session, content, customRetries) {
+        const maxRetries = customRetries ?? config.retryTimes ?? 3;
+        const retryDelay = config.retryInterval || 1000;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                let sendPromise = session.send(content);
+                if (config.videoSendTimeout > 0) {
+                    const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error('发送超时')), config.videoSendTimeout));
+                    return await Promise.race([sendPromise, timeoutPromise]);
+                }
+                else {
+                    return await sendPromise;
+                }
+            }
+            catch (err) {
+                const errMsg = getErrorMessage(err);
+                debugLog('ERROR', `发送失败尝试 ${attempt + 1}: ${errMsg}`);
+                if (attempt < maxRetries)
+                    await delay(retryDelay);
+                else if (!config.ignoreSendError)
+                    throw err;
+            }
+        }
+        return null;
+    }
     ctx.on('message', async (session) => {
         if (!config.enable)
             return;
@@ -1013,22 +1143,20 @@ function apply(ctx, config) {
     });
     const tempCleanupInterval = setInterval(async () => {
         try {
-            const tempDir = config.tempDir || './temp_videos';
-            const files = await promises_1.default.readdir(tempDir);
-            const now = Date.now();
-            let deleted = 0;
-            for (const file of files) {
-                if (file.startsWith('video_') && file.endsWith('.mp4')) {
-                    const filePath = path_1.default.join(tempDir, file);
-                    const stats = await promises_1.default.stat(filePath);
-                    if (now - stats.mtimeMs > 3600000) {
-                        await promises_1.default.unlink(filePath).catch(() => { });
-                        deleted++;
+            const dirs = [config.tempDir || './temp_videos', config.imageTempDir || './temp_images'];
+            for (const dir of dirs) {
+                const files = await promises_1.default.readdir(dir);
+                const now = Date.now();
+                for (const file of files) {
+                    if ((file.startsWith('video_') && file.endsWith('.mp4')) || (file.startsWith('img_') && file.match(/\.(png|jpg|jpeg|gif|webp)$/i))) {
+                        const filePath = path_1.default.join(dir, file);
+                        const stats = await promises_1.default.stat(filePath);
+                        if (now - stats.mtimeMs > 3600000) {
+                            await promises_1.default.unlink(filePath).catch(() => { });
+                        }
                     }
                 }
             }
-            if (deleted)
-                debugLog('INFO', `清理了 ${deleted} 个过期临时视频文件`);
         }
         catch (e) {
             debugLog('WARN', '清理临时文件失败:', e);
@@ -1042,11 +1170,14 @@ function apply(ctx, config) {
     });
     process.on('beforeExit', async () => {
         try {
-            const tempDir = config.tempDir || './temp_videos';
-            const files = await promises_1.default.readdir(tempDir);
-            for (const file of files) {
-                if (file.startsWith('video_') && file.endsWith('.mp4'))
-                    await promises_1.default.unlink(path_1.default.join(tempDir, file)).catch(() => { });
+            const dirs = [config.tempDir || './temp_videos', config.imageTempDir || './temp_images'];
+            for (const dir of dirs) {
+                const files = await promises_1.default.readdir(dir);
+                for (const file of files) {
+                    if ((file.startsWith('video_') && file.endsWith('.mp4')) || (file.startsWith('img_') && file.match(/\.(png|jpg|jpeg|gif|webp)$/i))) {
+                        await promises_1.default.unlink(path_1.default.join(dir, file)).catch(() => { });
+                    }
+                }
             }
         }
         catch { }

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-video-parser-all",
-  "description": "Koishi 全平台视频解析插件，支持抖音/快手/B站/微博/小红书/剪映/YouTube/TikTok等20+平台",
-  "version": "1.3.2",
+  "description": "Koishi 全平台视频/图集解析插件，支持抖音/快手/B站/微博/小红书/剪映/YouTube/TikTok等20+平台",
+  "version": "1.3.4",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -45,10 +45,45 @@
     "twitter",
     "instagram",
     "doubao",
+    "doubao_chat",
     "jimeng",
+    "oasis",
+    "wechat_channel",
     "debug",
     "unified-api",
-    "视频解析"
+    "proxy",
+    "field-mapping",
+    "image-download",
+    "视频解析",
+    "多平台",
+    "图集解析",
+    "去水印",
+    "哔哩哔哩",
+    "抖音",
+    "快手",
+    "微博",
+    "头条",
+    "西瓜视频",
+    "小红书",
+    "剪映",
+    "A站",
+    "知乎",
+    "微视",
+    "虎牙",
+    "油管",
+    "国际版抖音",
+    "好看视频",
+    "美拍",
+    "全民直播",
+    "推特",
+    "照片墙",
+    "豆包",
+    "即梦",
+    "绿洲",
+    "视频号",
+    "皮皮搞笑",
+    "皮皮虾",
+    "最右"
   ],
   "devDependencies": {
     "@koishijs/client": "^5.30.4",
@@ -58,8 +93,7 @@
   },
   "dependencies": {
     "axios": "^1.16.1",
-    "fast-xml-parser": "^4.5.6",
-    "stream": "^0.0.3"
+    "fast-xml-parser": "^4.5.6"
   },
   "peerDependencies": {
     "@koishijs/plugin-console": "^5.30.4",
@@ -76,4 +110,4 @@
   "engines": {
     "node": ">=16.0.0"
   }
-}
+}

package/readme.md CHANGED Viewed

@@ -31,95 +31,100 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 ### 统一消息格式 (Unified Message Format)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `unifiedMessageFormat` | string | `标题：${标题}\n作者：${作者}\n简介：${简介}\n音乐标题：${音乐标题}\n音乐作者：${音乐作者}\n音乐封面：${音乐封面}\n音乐链接：${音乐链接}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}` | 自定义解析结果的输出格式，支持变量替换。某行所有变量均为空（或为"0"）时自动隐藏该行 |
+| `unifiedMessageFormat` | string | `标题：${标题}\n作者：${作者}\n简介：${简介}\n音乐标题：${音乐标题}\n音乐作者：${音乐作者}\n音乐链接：${音乐链接}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}` | 文字消息格式，支持变量替换。空行自动隐藏。封面及媒体由独立开关控制，默认不包含在文字中 |
 ### 内容显示设置 (Content Display Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `showImageText` | boolean | true | 是否发送解析后的文字内容 |
-| `showCoverImage` | boolean | true | 是否发送封面图片（关闭后不再自动发送封面） |
-| `showVideoFile` | boolean | true | 是否发送视频文件（关闭则只发送视频链接） |
-| `maxDescLength` | number | 200 | 简介内容最大长度（字符），超出自动截断 |
+| `showImageText` | boolean | true | 是否发送文字内容 |
+| `showCoverImage` | boolean | true | 是否发送封面图片（视频/图集封面） |
+| `showMusicCover` | boolean | true | 是否发送音乐封面图片 |
+| `showImageFile` | boolean | true | 封面/图片是否以文件形式发送（关闭则只发链接） |
+| `forceDownloadImage` | boolean | false | 强制下载封面/图片后发送 |
+| `imageDownloadTimeout` | number | 60000 | 图片下载超时（毫秒） |
+| `imageTempDir` | string | `./temp_images` | 临时封面/图片存储目录 |
+| `maxImageSize` | number | 0 | 最大下载图片大小（MB），0 不限制 |
+| `showVideoFile` | boolean | true | 视频是否以文件形式发送（关闭则只发链接） |
+| `forceDownloadVideo` | boolean | false | 强制下载视频后发送 |
 | `videoDownloadTimeout` | number | 120000 | 视频下载超时（毫秒） |
 | `tempDir` | string | `./temp_videos` | 临时视频存储目录 |
-| `maxVideoSize` | number | 0 | 最大下载视频大小（MB），0 为不限制大小 |
-| `forceDownloadVideo` | boolean | false | 强制下载视频后发送 |
-| `maxConcurrent` | number | 3 | 批量解析时最大并发数，避免同时下载过多 |
+| `maxVideoSize` | number | 0 | 最大下载视频大小（MB），0 不限制 |
+| `maxDescLength` | number | 200 | 简介最大长度（字符） |
+| `maxConcurrent` | number | 3 | 批量解析最大并发数 |
 ### 网络与 API 设置 (Network & API Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `timeout` | number | 180000 | API 请求超时时间（毫秒） |
-| `videoSendTimeout` | number | 60000 | 视频消息发送超时时间（毫秒，0 为不限制） |
-| `userAgent` | string | `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36` | API 请求使用的 User-Agent |
-| `proxy` | object | `{ enabled: false, protocol: "http", host: "127.0.0.1", port: 7890, auth: { username: "", password: "" } }` | HTTP/HTTPS 代理设置。`enabled` 开关（默认关闭），`protocol` 下拉选择 `http` 或 `https`。需开启 `enabled` 并填写 `host` 后生效 |
-| `customHeaders` | array | [] | 自定义请求头，会附加到所有 API 请求中。每项包含 `name`（头名称）和 `value`（头值） |
+| `videoSendTimeout` | number | 60000 | 消息发送超时时间（毫秒，0 为不限制） |
+| `userAgent` | string | `Mozilla/5.0 ...` | User-Agent |
+| `proxy` | object | `{ enabled: false, protocol: "http", host: "127.0.0.1", port: 7890, auth: { username: "", password: "" } }` | HTTP/HTTPS 代理。`enabled` 开关（默认关闭），`protocol` 下拉选择 `http` 或 `https` |
+| `customHeaders` | array | [] | 自定义请求头，每项含 `name` 和 `value` |
 ### API 选择与回退设置 (API Selection & Fallback)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `primaryApiUrl` | string | `https://api.bugpk.com/api/short_videos` | 主 API 地址，解析时优先使用 |
-| `backupApiUrl` | string | `https://api.bugpk.com/api/svparse` | 备用主 API 地址，仅支持抖音、小红书、Instagram、即梦平台解析 |
-| `platformDedicatedFirst` | object | 各平台均为 `false` | 各平台独立开关：是否优先使用平台专属 API。对象键为平台标识（英文），值为布尔值。支持的键：`bilibili`、`douyin`、`kuaishou`、`xiaohongshu`、`weibo`、`xigua`、`youtube`、`tiktok`、`acfun`、`zhihu`、`weishi`、`huya`、`haokan`、`meipai`、`twitter`、`instagram`、`doubao`、`doubao_chat`、`oasis`、`wechat_channel` |
-| `customApis` | array | [] | 自定义平台专属 API 列表。每项包含：`platform`（平台类型）、`apiUrl`（API 地址）、`apiKey`（API Key，可选）、`authHeaderType`（认证头类型，可选：`Bearer` / `X-API-Key` / `Custom`）、`customHeaderName`（自定义 Header 名称，仅当 `authHeaderType` 为 `Custom` 时有效）、`fieldMapping`（字段映射 JSON 字符串，用于适配非标准 API 响应，支持点号路径） |
-| `globalFieldMapping` | string | 预设完整字段映射JSON（见下方示例） | 全局字段映射 JSON，优先级低于专属 API 映射。用于统一适配所有平台的 API 响应格式，默认已包含常用路径示例 |
+| `primaryApiUrl` | string | `https://api.bugpk.com/api/short_videos` | 主 API 地址 |
+| `backupApiUrl` | string | `https://api.bugpk.com/api/svparse` | 备用主 API，仅支持部分平台 |
+| `platformDedicatedFirst` | object | 各平台均为 `false` | 平台专属 API 优先开关，键：`bilibili` 等 |
+| `customApis` | array | [] | 自定义平台专属 API，含 `platform`, `apiUrl`, `apiKey`, `authHeaderType`, `customHeaderName`, `fieldMapping` |
+| `globalFieldMapping` | string | 预设字段映射 JSON | 全局字段映射，支持点号路径 |
 ### 错误与重试设置 (Error & Retry Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `ignoreSendError` | boolean | true | 是否忽略消息发送失败，避免插件崩溃 |
-| `retryTimes` | number | 3 | API 请求及消息发送失败时的重试次数 |
-| `retryInterval` | number | 1000 | API 请求及消息发送重试的间隔时间（毫秒） |
+| `ignoreSendError` | boolean | true | 忽略发送失败 |
+| `retryTimes` | number | 3 | 重试次数 |
+| `retryInterval` | number | 1000 | 重试间隔（毫秒） |
 ### 发送方式设置 (Send Mode Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `enableForward` | boolean | false | 是否启用合并转发（仅 OneBot 平台），启用后视频与图文将整合进同一条合并消息 |
+| `enableForward` | boolean | false | 启用合并转发（仅 OneBot 平台） |
 ### 缓存与去重设置 (Cache & Deduplication Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `deduplicationInterval` | number | 180 | 禁止重复解析时间间隔（秒），0 为不限制。同一个链接在间隔内不会重复解析。 |
-| `cacheTTL` | number | 600 | 解析结果缓存时间（秒），0 为不缓存。缓存可减少重复 API 请求。 |
+| `deduplicationInterval` | number | 180 | 去重间隔（秒） |
+| `cacheTTL` | number | 600 | 缓存时间（秒） |
 ### 界面文字设置 (UI Text Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `waitingTipText` | string | 正在解析视频，请稍候... | 解析等待提示文字 |
-| `unsupportedPlatformText` | string | 不支持该平台链接 | 不支持的平台提示 |
-| `invalidLinkText` | string | 无效的视频链接 | 无效链接提示（parse 指令） |
-| `parseErrorPrefix` | string | ❌ 解析失败： | 解析失败消息前缀 |
-| `parseErrorItemFormat` | string | `【${url}】: ${msg}` | 每条解析失败的展示格式，可用 ${url}（链接）和 ${msg}（错误信息） |
+| `waitingTipText` | string | 正在解析视频，请稍候... | 等待提示 |
+| `unsupportedPlatformText` | string | 不支持该平台链接 | 不支持平台提示 |
+| `invalidLinkText` | string | 无效的视频链接 | 无效链接提示 |
+| `parseErrorPrefix` | string | ❌ 解析失败： | 错误前缀 |
+| `parseErrorItemFormat` | string | `【${url}】: ${msg}` | 错误项格式 |
 ## 支持的变量 (Supported Variables)
-在 `unifiedMessageFormat` 中可使用以下变量进行自定义格式化，某行所有变量均为空（或为"0"）时该行不显示：
-| 变量名 | 说明 | 适用平台 |
-|--------|------|----------|
-| `${标题}` | 视频/图集标题 | 所有平台 |
-| `${作者}` | 作者/发布者名称 | 所有平台 |
-| `${简介}` | 内容简介/描述 | 所有平台 |
-| `${视频时长}` | 视频时长（时:分:秒） | 视频 |
-| `${点赞数}` | 点赞数量 | 所有平台 |
-| `${收藏数}` | 收藏数量 | 所有平台 |
-| `${转发数}` | 转发/分享数量 | 所有平台 |
-| `${播放数}` | 播放量 | 部分平台 |
-| `${评论数}` | 评论数量 | 所有平台 |
-| `${发布时间}` | 发布时间（格式化） | 所有平台 |
-| `${图片数量}` | 图集/实况图片数量 | 图集/实况 |
-| `${作者ID}` | 作者唯一标识ID | 部分平台 |
-| `${视频链接}` | 视频原始链接 | 视频 |
-| `${音乐标题}` | 音乐标题 | 部分平台 |
-| `${音乐作者}` | 音乐作者 | 部分平台 |
-| `${音乐封面}` | 音乐封面图片地址 | 部分平台 |
-| `${音乐链接}` | 音乐原始链接 | 部分平台 |
-> 注：部分变量可能因平台API返回数据不同而显示为空，某行所有变量为空（或为"0"）时该行会自动隐藏。
+在 `unifiedMessageFormat` 中可使用以下变量，空行自动隐藏：
+| 变量名 | 说明 |
+|--------|------|
+| `${标题}` | 视频/图集标题 |
+| `${作者}` | 作者名称 |
+| `${简介}` | 内容简介 |
+| `${视频时长}` | 视频时长（时:分:秒） |
+| `${点赞数}` | 点赞数量 |
+| `${收藏数}` | 收藏数量 |
+| `${转发数}` | 转发/分享数量 |
+| `${播放数}` | 播放量 |
+| `${评论数}` | 评论数量 |
+| `${发布时间}` | 发布时间（格式化） |
+| `${图片数量}` | 图集/实况图片数量 |
+| `${作者ID}` | 作者唯一标识ID |
+| `${视频链接}` | 视频原始链接 |
+| `${音乐标题}` | 音乐标题 |
+| `${音乐作者}` | 音乐作者 |
+| `${音乐链接}` | 音乐原始链接 |
+> 注：音乐封面已转为独立图片发送，不再作为文字变量。其余封面图片均通过对应开关控制。
 ## 支持的平台 (Supported Platforms)
 | 平台名称 | 关键词识别 | 解析能力 |
 |----------|------------|----------|
-| 哔哩哔哩 (B站) | bilibili, b23.tv, bilibili.com | 视频（不含番剧/直播/图文） |
+| 哔哩哔哩 (B站) | bilibili, b23.tv, bilibili.com | 视频 |
 | 抖音 | douyin, v.douyin.com | 短视频、图集、实况 |
 | 快手 | kuaishou, v.kuaishou.com | 短视频、图集 |
 | 小红书 | xiaohongshu, xhslink.com | 图文、视频 |
@@ -146,7 +151,7 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 | 绿洲 (Oasis) | oasis.weibo.com | 视频、图文 |
 | 视频号 (WeChat Channels) | channels.weixin.qq.com, weixin.qq.com/sph/ | 短视频 |
-> 注：部分平台解析能力可能因API限制有所差异，具体以实际解析结果为准。
+> 注：部分平台解析能力可能因API限制有所差异。
 ## 项目贡献者 (Contributors)
@@ -170,6 +175,6 @@ This project is licensed under the MIT License, see the [LICENSE](LICENSE) file
 ## 支持我们 (Support Us)
-如果这个项目对您有帮助，欢迎点亮右上角的 Star ⭐ 支持我们，这将是对所有贡献者最大的鼓励！
+如果这个项目对您有帮助，欢迎点亮右上角的 Star ⭐ 支持我们！
-If this project is helpful to you, please feel free to star it in the upper right corner ⭐ to support us, which will be the greatest encouragement to all contributors!
+If this project is helpful to you, please feel free to star it in the upper right corner ⭐ to support us!