koishi-plugin-video-parser-all 0.8.1 → 0.8.2

package/lib/index.d.ts

@@ -13,6 +13,7 @@ export declare const Config: Schema<{
 } & {
     showImageText?: boolean | null | undefined;
     showVideoFile?: boolean | null | undefined;
+    sendLivePhotoVideos?: boolean | null | undefined;
 } & {
     maxDescLength?: number | null | undefined;
 } & {
@@ -45,6 +46,7 @@ export declare const Config: Schema<{
 } & {
     showImageText: boolean;
     showVideoFile: boolean;
+    sendLivePhotoVideos: boolean;
 } & {
     maxDescLength: number;
 } & {

package/lib/index.js

@@ -24,14 +24,12 @@ exports.Config = koishi_1.Schema.intersect([
         debugFile: koishi_1.Schema.boolean().default(false).description('调试日志写入文件'),
     }).description('基础设置'),
     koishi_1.Schema.object({
-        unifiedMessageFormat: koishi_1.Schema.string().role('textarea').default(`标题：${'${标题}'}
-作者：${'${作者}'}
-点赞：${'${点赞数}'}
-链接：${'${视频链接}'}`).description('统一消息格式'),
+        unifiedMessageFormat: koishi_1.Schema.string().role('textarea').default(`标题：\${标题}\n作者：\${作者}\n点赞：\${点赞数}\n视频链接：\${视频链接}`).description('统一消息格式，可用变量：${标题} ${作者} ${简介} ${视频时长} ${点赞数} ${收藏数} ${转发数} ${播放数} ${评论数} ${发布时间} ${图片数量} ${作者ID} ${视频链接} ${封面} ${音乐作者} ${音乐标题}'),
     }).description('统一消息格式'),
     koishi_1.Schema.object({
         showImageText: koishi_1.Schema.boolean().default(true).description('显示图文内容'),
         showVideoFile: koishi_1.Schema.boolean().default(true).description('发送视频文件（关闭则只发链接）'),
+        sendLivePhotoVideos: koishi_1.Schema.boolean().default(true).description('发送实况图片对应的视频'),
     }).description('内容显示设置'),
     koishi_1.Schema.object({
         maxDescLength: koishi_1.Schema.number().default(200).description('简介内容最大长度（字符）'),
@@ -111,7 +109,6 @@ const PLATFORM_KEYWORDS = {
     doubao: ['doubao', 'doubao.com'],
     jimeng: ['jimeng', 'jimeng.ai'],
 };
-const PLATFORM_TYPES = Object.keys(PLATFORM_KEYWORDS);
 function getErrorMessage(error) {
     if (error instanceof Error)
         return error.message;
@@ -262,94 +259,132 @@ async function resolveShortUrl(url) {
         return cleanUrl(url);
     }
 }
-function formatDuration(input) {
-    if (!input || input === 0 || input === '0' || input === '00:00')
+function formatDuration(seconds) {
+    if (!seconds || seconds <= 0)
         return '00:00:00';
-    if (typeof input === 'string') {
-        if (input.includes(':')) {
-            const parts = input.split(':');
-            if (parts.length === 2)
-                return `00:${parts[0].padStart(2, '0')}:${parts[1].padStart(2, '0')}`;
-            if (parts.length === 3)
-                return `${parts[0].padStart(2, '0')}:${parts[1].padStart(2, '0')}:${parts[2].padStart(2, '0')}`;
-            return '00:00:00';
-        }
-        input = Number(input);
-    }
-    const seconds = Math.floor(Number(input));
-    if (isNaN(seconds) || seconds <= 0 || seconds > 315360000)
-        return '00:00:00';
-    const hours = Math.floor(seconds / 3600);
-    const minutes = Math.floor((seconds % 3600) / 60);
-    const secs = Math.floor(seconds % 60);
-    return `${hours.toString().padStart(2, '0')}:${minutes.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = Math.floor(seconds % 60);
+    return `${h.toString().padStart(2, '0')}:${m.toString().padStart(2, '0')}:${s.toString().padStart(2, '0')}`;
 }
-function formatPublishTime(value) {
-    if (!value)
+function formatPublishTime(ms) {
+    if (!ms)
         return '';
-    const str = String(value).trim();
-    if (value === 'ctime')
-        return '';
-    if (/^\d{10}$/.test(str))
-        value = Number(str) * 1000;
-    if (/^\d{10,}$/.test(str) && Number(str) > 1e12) {
-        if (Number(str) > 1e15)
-            value = Number(str) / 1000;
+    const d = new Date(ms);
+    const y = d.getFullYear(), mo = (d.getMonth() + 1).toString().padStart(2, '0'), day = d.getDate().toString().padStart(2, '0'), H = d.getHours().toString().padStart(2, '0'), i = d.getMinutes().toString().padStart(2, '0');
+    return `${y}年${mo}月${day}日 ${H}:${i}`;
+}
+function pickBestQuality(videoBackup) {
+    if (!Array.isArray(videoBackup))
+        return [];
+    return videoBackup
+        .map(v => ({ quality: v.quality || v.label, url: v.url, bit_rate: v.bit_rate || 0 }))
+        .sort((a, b) => (b.bit_rate || 0) - (a.bit_rate || 0));
+}
+function parseApiResponse(raw, maxDescLen) {
+    const data = raw?.data || {};
+    const extra = data.extra || {};
+    let type = data.type || '';
+    if (!type) {
+        if (data.images?.length > 0 && !data.url)
+            type = 'image';
+        else if (data.live_photo?.length > 0)
+            type = 'live_photo';
+        else if (raw.msg === 'live' || data.live)
+            type = 'live';
+        else
+            type = 'video';
     }
-    try {
-        const d = new Date(/^\d+$/.test(str) ? Number(str) : str);
-        if (isNaN(d.getTime()))
-            return str;
-        const y = d.getFullYear(), m = (d.getMonth() + 1).toString().padStart(2, '0'), d_ = d.getDate().toString().padStart(2, '0'), H = d.getHours().toString().padStart(2, '0'), i = d.getMinutes().toString().padStart(2, '0');
-        const parts = [];
-        if (y > 2000)
-            parts.push(`${y}年`);
-        if (m)
-            parts.push(`${m}月`);
-        if (d_)
-            parts.push(`${d_}日`);
-        if (H && i)
-            parts.push(`${H}:${i}`);
-        return parts.join(' ').trim();
+    const authorObj = data.author;
+    let author = '', uid = '', avatar = '';
+    if (typeof authorObj === 'object' && authorObj) {
+        author = authorObj.name || authorObj.author || '';
+        uid = String(authorObj.id || data.uid || '');
+        avatar = authorObj.avatar || data.avatar || '';
     }
-    catch {
-        return str;
+    else {
+        author = data.author || data.auther || '';
+        uid = String(data.uid || '');
+        avatar = data.avatar || '';
+    }
+    const title = data.title || '';
+    const desc = (data.desc || data.description || '').slice(0, maxDescLen);
+    const cover = data.cover || '';
+    let video = '';
+    let videos = [];
+    if (data.video_backup?.length) {
+        const bestQ = pickBestQuality(data.video_backup);
+        videos = bestQ;
+        video = bestQ[0]?.url || data.url || '';
+    }
+    else if (data.videos?.length) {
+        video = data.videos[0]?.url || '';
+        videos = data.videos.map((v) => ({ quality: v.accept?.[0] || 'unknown', url: v.url }));
+    }
+    else {
+        video = data.url || '';
+    }
+    const images = Array.isArray(data.images) ? data.images : [];
+    const live_photo = Array.isArray(data.live_photo) ? data.live_photo : [];
+    const music = {
+        title: data.music?.title || data.music?.name || '',
+        author: data.music?.author || data.music?.artist || '',
+        cover: data.music?.cover || '',
+        url: data.music?.url || ''
+    };
+    const stats = extra.statistics || {};
+    const like = Number(data.like || stats.digg_count || 0);
+    const comment = Number(stats.comment_count || 0);
+    const collect = Number(stats.collect_count || 0);
+    const share = Number(stats.share_count || 0);
+    const play = Number(stats.play_count || 0);
+    let duration = 0;
+    if (data.duration) {
+        duration = typeof data.duration === 'string' ? parseInt(data.duration) : data.duration;
+        if (duration > 1000000)
+            duration = Math.floor(duration / 1000);
+    }
+    else if (extra.duration_ms) {
+        duration = Math.floor(extra.duration_ms / 1000);
+    }
+    let publishTime = 0;
+    if (data.time) {
+        publishTime = typeof data.time === 'number' ? data.time : parseInt(data.time);
+        if (publishTime < 1000000000000)
+            publishTime *= 1000;
+    }
+    else if (extra.create_time) {
+        publishTime = extra.create_time * 1000;
     }
-}
-function parseApiResponse(rawResponse) {
-    const data = rawResponse?.data || {};
     return {
-        author: data.author || '',
-        uid: data.uid || '',
-        avatar: data.avatar || '',
-        like: Number(data.like) || 0,
-        time: Number(data.time) || 0,
-        title: data.title || '',
-        cover: data.cover || '',
-        url: data.url || '',
-        music: data.music ? {
-            author: data.music.author || '',
-            avatar: data.music.avatar || '',
-            title: data.music.title || ''
-        } : undefined
+        type, title, desc, author, uid, avatar, cover,
+        video, videos, images, live_photo, music,
+        like, comment, collect, share, play,
+        duration, publishTime
     };
 }
-function generateFormattedText(info, config) {
-    const format = config.unifiedMessageFormat || `标题：${'${标题}'}\n作者：${'${作者}'}\n点赞：${'${点赞数}'}\n链接：${'${视频链接}'}`;
+function generateFormattedText(p, format) {
     const vars = {
-        '标题': info.title,
-        '作者': info.author,
-        '点赞数': String(info.like),
-        '作者ID': info.uid,
-        '视频链接': info.url,
-        '发布时间': info.time ? formatPublishTime(info.time) : '',
-        '封面': info.cover,
-        '音乐作者': info.music?.author || '',
-        '音乐封面': info.music?.avatar || '',
+        '标题': p.title,
+        '作者': p.author,
+        '简介': p.desc,
+        '视频时长': p.duration > 0 ? formatDuration(p.duration) : '',
+        '点赞数': String(p.like),
+        '收藏数': String(p.collect),
+        '转发数': String(p.share),
+        '播放数': String(p.play),
+        '评论数': String(p.comment),
+        '发布时间': p.publishTime ? formatPublishTime(p.publishTime) : '',
+        '图片数量': String(p.images.length || p.live_photo.length),
+        '作者ID': p.uid,
+        '视频链接': p.video,
+        '封面': p.cover,
+        '音乐作者': p.music.author || '',
+        '音乐标题': p.music.title || '',
     };
     let result = format;
     for (const [key, value] of Object.entries(vars)) {
-        result = result.replace(new RegExp('\\$\\{' + key + '\\}', 'g'), value);
+        result = result.replace(new RegExp(`\\$\\{${key}\\}`, 'g'), value);
     }
     return result.replace(/^\s*\n/gm, '').trim();
 }
@@ -391,7 +426,7 @@ function apply(ctx, config) {
             'Content-Type': 'application/x-www-form-urlencoded'
         }
     });
-    async function parseViaApi(url) {
+    async function fetchApi(url) {
         for (let i = 0; i <= config.retryTimes; i++) {
             try {
                 const res = await http.get('https://api.bugpk.com/api/short_videos', {
@@ -400,7 +435,7 @@ function apply(ctx, config) {
                 });
                 debugLog('INFO', `API响应: code=${res.data?.code}, msg=${res.data?.msg}`);
                 if (res.data && (res.data.code === 200 || res.data.code === 0)) {
-                    return parseApiResponse(res.data);
+                    return parseApiResponse(res.data, config.maxDescLength);
                 }
                 throw new Error(res.data?.msg || '解析失败');
             }
@@ -420,16 +455,16 @@ function apply(ctx, config) {
         const platform = getPlatformType(realUrl);
         if (!platform) {
             debugLog('WARN', `不支持的平台: ${realUrl}`);
-            return { info: null, success: false, msg: '不支持该平台链接' };
+            return { success: false, msg: '不支持该平台链接' };
         }
         try {
-            const info = await parseViaApi(realUrl);
+            const info = await fetchApi(realUrl);
             debugLog('INFO', `解析成功: ${info.title}`);
-            return { info, success: true, msg: '解析成功' };
+            return { success: true, data: info };
         }
         catch (error) {
             debugLog('ERROR', `解析失败: ${getErrorMessage(error)}`);
-            return { info: null, success: false, msg: getErrorMessage(error) };
+            return { success: false, msg: getErrorMessage(error) };
         }
     }
     async function processSingleUrl(session, url) {
@@ -442,22 +477,13 @@ function apply(ctx, config) {
         }
         processed.set(hash, now);
         const result = await parseUrl(url);
-        if (!result.info)
+        if (!result.success) {
             return { success: false, msg: result.msg };
-        const text = generateFormattedText(result.info, config);
+        }
+        const text = generateFormattedText(result.data, config.unifiedMessageFormat);
         return {
             success: true,
-            data: {
-                text,
-                cover: result.info.cover,
-                video: result.info.url,
-                music: result.info.music,
-                author: result.info.author,
-                uid: result.info.uid,
-                avatar: result.info.avatar,
-                like: result.info.like,
-                title: result.info.title
-            }
+            data: { text, parsed: result.data }
         };
     }
     async function sendWithTimeout(session, content) {
@@ -494,73 +520,99 @@ function apply(ctx, config) {
         const items = [];
         const errors = [];
         for (const url of urls) {
-            const result = await processSingleUrl(session, url);
-            if (result.success)
-                items.push(result.data);
-            else
-                errors.push({ url, msg: result.msg });
+            const res = await processSingleUrl(session, url);
+            if (res.success) {
+                items.push(res.data);
+            }
+            else {
+                errors.push(`【${url.slice(0, 50)}...】: ${res.msg}`);
+            }
         }
-        if (errors.length > 0) {
-            const errorMsg = `❌ 解析失败：\n${errors.map((e) => `【${e.url.slice(0, 50)}...】: ${e.msg}`).join('\n')}`;
-            await sendWithTimeout(session, errorMsg).catch(() => { });
+        if (errors.length) {
+            await sendWithTimeout(session, `❌ 解析失败：\n${errors.join('\n')}`).catch(() => { });
             await delay(500);
         }
-        if (items.length === 0)
+        if (!items.length)
             return;
         const enableForward = config.enableForward && session.platform === 'onebot';
         const botName = config.botName || '视频解析机器人';
         const forwardMessages = [];
         for (const item of items) {
-            try {
+            const p = item.parsed;
+            const text = item.text;
+            if (text) {
+                if (enableForward)
+                    forwardMessages.push(buildForwardNode(session, text, botName));
+                else {
+                    await sendWithTimeout(session, text);
+                    await delay(300);
+                }
+            }
+            if (p.cover && p.type !== 'live_photo') {
+                if (enableForward)
+                    forwardMessages.push(buildForwardNode(session, koishi_1.h.image(p.cover), botName));
+                else {
+                    await sendWithTimeout(session, koishi_1.h.image(p.cover)).catch(() => { });
+                    await delay(300);
+                }
+            }
+            if (p.video && config.showVideoFile && (p.type === 'video' || p.type === 'live')) {
+                const sendVideo = async () => {
+                    if (config.downloadVideoBeforeSend) {
+                        const fname = crypto_1.default.createHash('md5').update(p.video).digest('hex');
+                        const dl = await downloadVideo(p.video, fname, config.userAgent, config.maxVideoSize, config.downloadThreads);
+                        if (dl.success)
+                            return koishi_1.h.file(dl.filePath);
+                    }
+                    return koishi_1.h.video(p.video);
+                };
                 if (enableForward) {
-                    if (item.text)
-                        forwardMessages.push(buildForwardNode(session, item.text, botName));
-                    if (item.cover)
-                        forwardMessages.push(buildForwardNode(session, koishi_1.h.image(item.cover), botName));
-                    if (item.video && config.showVideoFile) {
-                        if (config.downloadVideoBeforeSend) {
-                            const fname = crypto_1.default.createHash('md5').update(item.video).digest('hex');
-                            const dl = await downloadVideo(item.video, fname, config.userAgent, config.maxVideoSize, config.downloadThreads);
-                            if (dl.success)
-                                forwardMessages.push(buildForwardNode(session, koishi_1.h.file(dl.filePath), botName));
-                            else
-                                forwardMessages.push(buildForwardNode(session, koishi_1.h.video(item.video), botName));
+                    const vMsg = await sendVideo();
+                    forwardMessages.push(buildForwardNode(session, vMsg, botName));
+                }
+                else {
+                    try {
+                        const vMsg = await sendVideo();
+                        await sendWithTimeout(session, vMsg);
+                    }
+                    catch {
+                        try {
+                            await sendWithTimeout(session, koishi_1.h.video(p.video));
                         }
-                        else
-                            forwardMessages.push(buildForwardNode(session, koishi_1.h.video(item.video), botName));
+                        catch { }
                     }
+                    await delay(500);
                 }
-                else {
-                    if (item.text) {
-                        await sendWithTimeout(session, item.text);
-                        await delay(300);
+            }
+            if (p.type === 'image' || p.type === 'live_photo') {
+                const mediaList = [];
+                if (p.type === 'live_photo' && p.live_photo?.length) {
+                    for (const lp of p.live_photo) {
+                        if (lp.image)
+                            mediaList.push({ type: 'image', url: lp.image });
+                        if (lp.video && config.sendLivePhotoVideos)
+                            mediaList.push({ type: 'video', url: lp.video });
                     }
-                    if (item.cover) {
-                        await sendWithTimeout(session, koishi_1.h.image(item.cover)).catch(() => { });
-                        await delay(300);
+                }
+                else if (p.images?.length) {
+                    p.images.forEach(url => mediaList.push({ type: 'image', url }));
+                }
+                if (enableForward) {
+                    for (const m of mediaList) {
+                        const msg = m.type === 'image' ? koishi_1.h.image(m.url) : koishi_1.h.video(m.url);
+                        forwardMessages.push(buildForwardNode(session, msg, botName));
                     }
-                    if (item.video && config.showVideoFile) {
+                }
+                else {
+                    for (const m of mediaList) {
                         try {
-                            if (config.downloadVideoBeforeSend) {
-                                const fname = crypto_1.default.createHash('md5').update(item.video).digest('hex');
-                                const dl = await downloadVideo(item.video, fname, config.userAgent, config.maxVideoSize, config.downloadThreads);
-                                await sendWithTimeout(session, dl.success ? koishi_1.h.file(dl.filePath) : koishi_1.h.video(item.video));
-                            }
-                            else {
-                                await sendWithTimeout(session, koishi_1.h.video(item.video));
-                            }
-                        }
-                        catch {
-                            try {
-                                await sendWithTimeout(session, koishi_1.h.video(item.video));
-                            }
-                            catch { }
+                            await sendWithTimeout(session, m.type === 'image' ? koishi_1.h.image(m.url) : koishi_1.h.video(m.url));
+                            await delay(200);
                         }
-                        await delay(500);
+                        catch { }
                     }
                 }
             }
-            catch (e) { }
         }
         if (enableForward && forwardMessages.length) {
             try {

package/package.json

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

package/readme.md

@@ -3,22 +3,24 @@
 ## 项目介绍 (Project Introduction)
 
 ### 中文
-这是一个为 Koishi 机器人框架开发的**全平台视频/图集解析插件**，使用统一API接口，支持自动识别并解析抖音、快手、B站、小红书、微博、YouTube、TikTok、剪映、AcFun、知乎、虎牙等20+主流平台的短视频/图集链接。核心特性：
+这是一个为 Koishi 机器人框架开发的**全平台视频/图集解析插件**，使用统一API接口，支持自动识别并解析抖音、快手、B站、小红书、微博、YouTube、TikTok、剪映、AcFun、知乎、虎牙等20+主流平台的短视频/图集/实况链接。核心特性：
 - 🌐 统一API解析，覆盖20+热门平台，无需繁琐配置
 - 🤖 自动识别链接来源，即丢即用
-- 🎨 完全自定义的解析结果格式，支持20+丰富变量替换
+- 🎨 完全自定义的解析结果格式，支持多项变量替换
 - 🐛 内置Debug调试模式，可详细记录所有操作与API交互日志
 - ⚡ 防重复解析、API重试、本地视频下载、多线程加速等实用功能
 - 📤 支持OneBot平台消息合并转发，优化多图文展示体验
+- 🧹 内置手动/自动双模式缓存清理，自动删除临时视频与冗余缓存
 
 ### 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 links from 20+ mainstream platforms such as Douyin, Kuaishou, Bilibili, Xiaohongshu, Weibo, YouTube, TikTok, Jianying, AcFun, Zhihu, Huya and more. Core features:
+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, just drop & go
-- 🎨 Fully customizable parsing result format with 20+ variable substitutions
+- 🎨 Fully customizable parsing result format with variable substitutions
 - 🐛 Built-in Debug mode, recording detailed operations and API interaction logs
 - ⚡ Duplicate parsing prevention, API retry, local video download, multithread acceleration
 - 📤 Support OneBot message forwarding for better image/video display
+- 🧹 Manual & automatic cache cleaning, auto delete temporary videos and redundant cache
 
 ## 项目仓库 (Repository)
 - GitHub: `https://github.com/Minecraft-1314/koishi-plugin-video-parser-all`
@@ -54,6 +56,7 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 |--------|------|--------|------|
 | `showImageText` | boolean | true | 是否显示解析后的图文内容 |
 | `showVideoFile` | boolean | true | 是否发送视频文件（关闭则只发送视频链接） |
+| `sendLivePhotoVideos` | boolean | true | 是否发送实况图片附带的短视频（仅 live_photo 类型） |
 
 ### 内容长度限制
 | 配置项 | 类型 | 默认值 | 说明 |
@@ -92,38 +95,40 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 |--------|------|--------|------|
 | `autoClearCacheInterval` | number | 0 | 自动清理缓存间隔（分钟，0为关闭自动清理） |
 
+## 缓存机制说明 (Cache Mechanism)
+- 临时视频默认存放目录：项目根目录 `temp_videos`
+- 支持定时自动清空缓存、手动执行 `clear-cache` 一键清理
+- 自动清理过期解析记录、残留分段下载文件，避免磁盘占用
+
 ## 支持的变量 (Supported Variables)
 在 `unifiedMessageFormat` 中可使用以下变量进行自定义格式化：
 
 | 变量名 | 说明 | 适用平台 |
 |--------|------|----------|
 | `${标题}` | 视频/图集标题 | 所有平台 |
-| `${作者}` | 作者/UP主/发布者名称 | 所有平台 |
-| `${简介}` | 内容简介/描述 | 部分平台 |
-| `${视频时长}` | 视频时长 | 部分平台 |
+| `${作者}` | 作者/发布者名称 | 所有平台 |
+| `${简介}` | 内容简介/描述 | 所有平台 |
+| `${视频时长}` | 视频时长（时:分:秒） | 视频/实况 |
 | `${点赞数}` | 点赞数量 | 所有平台 |
-| `${投币数}` | 投币数量 | 部分平台 (B站) |
 | `${收藏数}` | 收藏数量 | 所有平台 |
 | `${转发数}` | 转发/分享数量 | 所有平台 |
 | `${播放数}` | 播放量 | 部分平台 |
 | `${评论数}` | 评论数量 | 所有平台 |
-| `${IP属地}` | 作者IP属地 | 部分平台 |
 | `${发布时间}` | 发布时间（格式化） | 所有平台 |
-| `${粉丝数}` | 作者粉丝数量 | 部分平台 |
-| `${在线人数}` | 直播间在线人数 | 部分平台 |
-| `${关注数}` | 关注数 | 部分平台 |
-| `${文件大小}` | 文件大小（MB） | 部分平台 |
-| `${直播间地址}` | 直播间链接 | 部分平台 |
-| `${直播间ID}` | 直播间ID | 部分平台 |
-| `${直播间状态}` | 直播间状态（直播中/未开播） | 部分平台 |
-| `${图片数量}` | 图集图片数量 | 部分平台 |
+| `${图片数量}` | 图集/实况图片数量 | 图集/实况 |
 | `${作者ID}` | 作者唯一标识ID | 部分平台 |
+| `${视频链接}` | 视频直链地址 | 视频/实况 |
+| `${封面}` | 封面图片地址 | 所有平台 |
+| `${音乐作者}` | 背景音乐作者 | 部分平台 |
+| `${音乐标题}` | 背景音乐标题 | 部分平台 |
+
+> 注：部分变量可能因平台API返回数据不同而显示为空，请根据实际情况自定义格式。
 
 ## 支持的平台 (Supported Platforms)
 | 平台名称 | 关键词识别 | 解析能力 |
 |----------|------------|----------|
-| 哔哩哔哩 (B站) | bilibili, b23.tv, bilibili.com | 视频、直播、图文 |
-| 抖音 | douyin, v.douyin.com | 短视频、图集 |
+| 哔哩哔哩 (B站) | bilibili, b23.tv, bilibili.com | 视频（不含番剧/直播/图文） |
+| 抖音 | douyin, v.douyin.com | 短视频、图集、实况 |
 | 快手 | kuaishou, v.kuaishou.com | 短视频、图集 |
 | 小红书 | xiaohongshu, xhslink.com | 图文、视频 |
 | 微博 | weibo, video.weibo.com | 视频、图集 |