koishi-plugin-video-parser-all 1.2.8 → 1.2.9

package/lib/index.d.ts

@@ -9,16 +9,31 @@ export declare const Config: Schema<{
     unifiedMessageFormat?: string | null | undefined;
 } & {
     showImageText?: boolean | null | undefined;
+    showCoverImage?: boolean | null | undefined;
     showVideoFile?: boolean | null | undefined;
     maxDescLength?: number | null | undefined;
     videoDownloadTimeout?: number | null | undefined;
     tempDir?: string | null | undefined;
     maxVideoSize?: number | null | undefined;
     forceDownloadVideo?: boolean | null | undefined;
+    maxConcurrent?: number | null | undefined;
 } & {
     timeout?: number | null | undefined;
     videoSendTimeout?: number | null | undefined;
     userAgent?: string | null | undefined;
+    proxy?: ({
+        protocol?: string | null | undefined;
+        host?: string | null | undefined;
+        port?: number | null | undefined;
+        auth?: ({
+            username?: string | null | undefined;
+            password?: string | null | undefined;
+        } & import("cosmokit").Dict) | null | undefined;
+    } & import("cosmokit").Dict) | null | undefined;
+    customHeaders?: ({
+        name?: string | null | undefined;
+        value?: string | null | undefined;
+    } & import("cosmokit").Dict)[] | null | undefined;
 } & {
     ignoreSendError?: boolean | null | undefined;
     retryTimes?: number | null | undefined;
@@ -27,6 +42,7 @@ export declare const Config: Schema<{
     enableForward?: boolean | null | undefined;
 } & {
     deduplicationInterval?: number | null | undefined;
+    cacheTTL?: number | null | undefined;
 } & {
     primaryApiUrl?: string | null | undefined;
     backupApiUrl?: string | null | undefined;
@@ -57,7 +73,9 @@ export declare const Config: Schema<{
         apiKey?: string | null | undefined;
         authHeaderType?: "Bearer" | "X-API-Key" | "Custom" | null | undefined;
         customHeaderName?: string | null | undefined;
+        fieldMapping?: string | null | undefined;
     } & import("cosmokit").Dict)[] | null | undefined;
+    globalFieldMapping?: string | null | undefined;
 } & {
     waitingTipText?: string | null | undefined;
     unsupportedPlatformText?: string | null | undefined;
@@ -73,16 +91,34 @@ export declare const Config: Schema<{
     unifiedMessageFormat: string;
 } & {
     showImageText: boolean;
+    showCoverImage: boolean;
     showVideoFile: boolean;
     maxDescLength: number;
     videoDownloadTimeout: number;
     tempDir: string;
     maxVideoSize: number;
     forceDownloadVideo: boolean;
+    maxConcurrent: number;
 } & {
     timeout: number;
     videoSendTimeout: number;
     userAgent: string;
+    proxy: Schemastery.ObjectT<{
+        protocol: Schema<string, string>;
+        host: Schema<string, string>;
+        port: Schema<number, number>;
+        auth: Schema<Schemastery.ObjectS<{
+            username: Schema<string, string>;
+            password: Schema<string, string>;
+        }>, Schemastery.ObjectT<{
+            username: Schema<string, string>;
+            password: Schema<string, string>;
+        }>>;
+    }>;
+    customHeaders: Schemastery.ObjectT<{
+        name: Schema<string, string>;
+        value: Schema<string, string>;
+    }>[];
 } & {
     ignoreSendError: boolean;
     retryTimes: number;
@@ -91,6 +127,7 @@ export declare const Config: Schema<{
     enableForward: boolean;
 } & {
     deduplicationInterval: number;
+    cacheTTL: number;
 } & {
     primaryApiUrl: string;
     backupApiUrl: string;
@@ -121,7 +158,9 @@ export declare const Config: Schema<{
         apiKey: Schema<string, string>;
         authHeaderType: Schema<"Bearer" | "X-API-Key" | "Custom", "Bearer" | "X-API-Key" | "Custom">;
         customHeaderName: Schema<string, string>;
+        fieldMapping: Schema<string, string>;
     }>[];
+    globalFieldMapping: string;
 } & {
     waitingTipText: string;
     unsupportedPlatformText: string;

package/lib/index.js

@@ -42,6 +42,31 @@ class SimpleLRUCache {
         this.map.clear();
     }
 }
+class ConcurrencyLimiter {
+    constructor(max) {
+        this.max = max;
+        this.running = 0;
+        this.queue = [];
+    }
+    async acquire() {
+        if (this.running < this.max) {
+            this.running++;
+            return;
+        }
+        return new Promise(resolve => {
+            this.queue.push(() => {
+                this.running++;
+                resolve();
+            });
+        });
+    }
+    release() {
+        this.running--;
+        const next = this.queue.shift();
+        if (next)
+            next();
+    }
+}
 exports.name = 'video-parser-all';
 exports.Config = koishi_1.Schema.intersect([
     koishi_1.Schema.object({
@@ -55,17 +80,32 @@ exports.Config = koishi_1.Schema.intersect([
     }).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('简介内容最大长度（字符），超出自动截断'),
         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('批量解析时最大并发数'),
     }).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'),
+        proxy: koishi_1.Schema.object({
+            protocol: koishi_1.Schema.string().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 代理设置'),
+        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 设置'),
     koishi_1.Schema.object({
         ignoreSendError: koishi_1.Schema.boolean().default(true).description('忽略消息发送失败，避免插件崩溃'),
@@ -77,7 +117,8 @@ exports.Config = koishi_1.Schema.intersect([
     }).description('发送方式设置'),
     koishi_1.Schema.object({
         deduplicationInterval: koishi_1.Schema.number().min(0).step(1).default(180).description('禁止重复解析时间间隔（秒），0 为不限制'),
-    }).description('去重设置'),
+        cacheTTL: koishi_1.Schema.number().min(0).step(1).default(600).description('解析结果缓存时间（秒），0 为不缓存'),
+    }).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 地址'),
@@ -132,7 +173,9 @@ exports.Config = koishi_1.Schema.intersect([
                 koishi_1.Schema.const('Custom').description('自定义 Header 名称'),
             ]).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'),
+        globalFieldMapping: koishi_1.Schema.string().role('textarea').default('{}').description('全局字段映射 JSON，优先级低于专属 API 映射'),
     }).description('API 选择设置'),
     koishi_1.Schema.object({
         waitingTipText: koishi_1.Schema.string().default('正在解析视频，请稍候...').description('解析等待提示文字'),
@@ -149,7 +192,6 @@ function debugLog(level, ...args) {
         return;
     logger.info(`[${new Date().toISOString()}] [${level}] ${args.map(a => typeof a === 'object' ? JSON.stringify(a) : String(a)).join(' ')}`);
 }
-const urlCache = new SimpleLRUCache(500, 10 * 60 * 1000);
 const LINK_RULES = [
     { pattern: /https?:\/\/(?:www\.)?bilibili\.com\/video\/([ab]v[0-9a-zA-Z_-]+)/gi, type: 'bilibili' },
     { pattern: /https?:\/\/b23\.tv\/[0-9a-zA-Z_-]{5,}/gi, type: 'bilibili' },
@@ -288,22 +330,45 @@ function pickBestQuality(videoBackup) {
         bit_rate: Number(v.bit_rate || 0)
     })).sort((a, b) => b.bit_rate - a.bit_rate);
 }
-function parseApiResponse(raw, maxDescLen) {
+function getNestedValue(obj, path) {
+    if (!path)
+        return obj;
+    const keys = path.split('.');
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || current === undefined)
+            return undefined;
+        current = current[key];
+    }
+    return current;
+}
+function parseApiResponse(raw, maxDescLen, fieldMapping) {
     debugLog('DEBUG', 'API raw response', raw);
     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';
-    }
-    const authorObj = data.author;
+    const mapField = (name, fallback) => {
+        if (fieldMapping && fieldMapping[name]) {
+            const value = getNestedValue(raw, fieldMapping[name]);
+            if (value !== undefined)
+                return value;
+        }
+        return fallback();
+    };
+    let type = mapField('type', () => {
+        let t = data.type || '';
+        if (!t) {
+            if (data.images?.length > 0 && !data.url)
+                t = 'image';
+            else if (data.live_photo?.length > 0)
+                t = 'live_photo';
+            else if (raw.msg === 'live' || data.live)
+                t = 'live';
+            else
+                t = 'video';
+        }
+        return t;
+    });
+    const authorObj = mapField('author', () => data.author);
     let author = '', uid = '', avatar = '';
     if (authorObj && typeof authorObj === 'object') {
         author = authorObj.name || authorObj.author || '';
@@ -311,29 +376,34 @@ function parseApiResponse(raw, maxDescLen) {
         avatar = authorObj.avatar || data.avatar || '';
     }
     else {
-        author = data.author || data.auther || '';
-        uid = String(data.uid || '');
-        avatar = data.avatar || '';
+        author = mapField('author', () => data.author || data.auther || '');
+        uid = String(mapField('uid', () => data.uid || ''));
+        avatar = mapField('avatar', () => data.avatar || '');
     }
-    const title = data.title || '';
-    const desc = (data.desc || data.description || '').slice(0, maxDescLen).trim();
-    const cover = data.cover || '';
+    const title = mapField('title', () => data.title || '');
+    const desc = mapField('desc', () => data.desc || data.description || '').slice(0, maxDescLen).trim();
+    const coverRaw = mapField('cover', () => data.cover || '');
+    const cover = coverRaw ? (String(coverRaw).startsWith('http') ? String(coverRaw) : 'https:' + coverRaw) : '';
     let video = '';
     let videos = [];
-    if (Array.isArray(data.video_backup) && data.video_backup.length) {
-        const bestQ = pickBestQuality(data.video_backup);
+    const videoBackup = mapField('video_backup', () => data.video_backup);
+    if (Array.isArray(videoBackup) && videoBackup.length) {
+        const bestQ = pickBestQuality(videoBackup);
         videos = bestQ;
         video = bestQ[0]?.url || '';
     }
-    if (!video && Array.isArray(data.videos) && data.videos.length) {
-        const validVideos = data.videos.filter((v) => v && v.url);
-        if (validVideos.length) {
-            video = validVideos[0].url;
-            videos = validVideos.map((v) => ({ quality: v.accept?.[0] || 'unknown', url: v.url }));
+    if (!video) {
+        const rawVideos = mapField('videos', () => data.videos);
+        if (Array.isArray(rawVideos) && rawVideos.length) {
+            const validVideos = rawVideos.filter((v) => v && v.url);
+            if (validVideos.length) {
+                video = validVideos[0].url;
+                videos = validVideos.map((v) => ({ quality: v.accept?.[0] || 'unknown', url: v.url }));
+            }
         }
     }
-    if (!video && data.url)
-        video = data.url;
+    if (!video)
+        video = mapField('video', () => data.url || '');
     if (video && !video.startsWith('http'))
         video = 'https:' + video;
     const images = Array.isArray(data.images) ? data.images.filter((img) => img && typeof img === 'string').map((img) => img.startsWith('http') ? img : 'https:' + img) : [];
@@ -342,34 +412,36 @@ function parseApiResponse(raw, maxDescLen) {
         video: lp.video ? (lp.video.startsWith('http') ? lp.video : 'https:' + lp.video) : ''
     })) : [];
     const music = {
-        title: data.music?.title || data.music?.name || '',
-        author: data.music?.author || data.music?.artist || '',
-        cover: data.music?.cover || '',
-        url: data.music?.url || ''
+        title: mapField('music_title', () => data.music?.title || data.music?.name || ''),
+        author: mapField('music_author', () => data.music?.author || data.music?.artist || ''),
+        cover: mapField('music_cover', () => data.music?.cover || ''),
+        url: mapField('music_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);
+    const stats = { ...(data.statistics || {}), ...(extra.statistics || {}) };
+    const like = Number(mapField('like', () => data.like ?? stats.digg_count ?? stats.like_count ?? stats.likes ?? 0));
+    const comment = Number(mapField('comment', () => data.comment ?? stats.comment_count ?? stats.comments ?? stats.comment ?? 0));
+    const collect = Number(mapField('collect', () => data.collect ?? stats.collect_count ?? stats.favorite_count ?? stats.favorites ?? 0));
+    const share = Number(mapField('share', () => data.share ?? stats.share_count ?? stats.forward_count ?? stats.shares ?? 0));
+    const play = Number(mapField('play', () => data.play ?? stats.play_count ?? stats.view_count ?? stats.plays ?? 0));
     let duration = 0;
-    if (data.duration) {
-        duration = typeof data.duration === 'string' ? parseInt(data.duration, 10) : data.duration;
+    const durRaw = mapField('duration', () => data.duration);
+    if (durRaw) {
+        duration = typeof durRaw === 'string' ? parseInt(durRaw, 10) : Number(durRaw);
         if (duration > 1000000)
             duration = Math.floor(duration / 1000);
     }
     else if (extra.duration_ms) {
-        duration = Math.floor(extra.duration_ms / 1000);
+        duration = Math.floor(Number(extra.duration_ms) / 1000);
     }
     let publishTime = 0;
-    if (data.time) {
-        publishTime = typeof data.time === 'number' ? data.time : parseInt(data.time, 10);
+    const timeRaw = mapField('publishTime', () => data.time);
+    if (timeRaw) {
+        publishTime = typeof timeRaw === 'number' ? timeRaw : parseInt(timeRaw, 10);
         if (publishTime < 1000000000000)
             publishTime *= 1000;
     }
     else if (extra.create_time) {
-        publishTime = extra.create_time * 1000;
+        publishTime = Number(extra.create_time) * 1000;
     }
     return { type, title, desc, author, uid, avatar, cover, video, videos, images, live_photo, music, like, comment, collect, share, play, duration, publishTime };
 }
@@ -395,24 +467,13 @@ function generateFormattedText(p, format) {
     const lines = format.split('\n');
     const resultLines = [];
     for (const line of lines) {
-        const varMatches = line.match(formatVarRegex);
-        if (varMatches) {
-            let allEmpty = true;
-            for (const match of varMatches) {
-                const varName = match.slice(2, -1);
-                const val = vars[varName];
-                if (val && val !== '0') {
-                    allEmpty = false;
-                    break;
-                }
-            }
-            if (allEmpty)
-                continue;
-        }
         let newLine = line;
         for (const [key, val] of Object.entries(vars)) {
             newLine = newLine.replace(new RegExp(`\\$\\{${key}\\}`, 'g'), val);
         }
+        const stripped = newLine.replace(/[\s：:，,。.、；;！!？?【】\[\]「」『』（）()《》""''""·—\-_/\\|@#$%^&*+=~`]/g, '').trim();
+        if (stripped.length === 0)
+            continue;
         resultLines.push(newLine);
     }
     return resultLines.join('\n').trim();
@@ -435,10 +496,25 @@ function getErrorMessage(error) {
         return String(error.message);
     return String(error);
 }
+function parseFieldMapping(mappingStr) {
+    if (!mappingStr || mappingStr.trim() === '{}' || mappingStr.trim() === '')
+        return undefined;
+    try {
+        const obj = JSON.parse(mappingStr);
+        if (typeof obj === 'object' && !Array.isArray(obj))
+            return obj;
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 function apply(ctx, config) {
     debugEnabled = config.debug || false;
     debugLog('INFO', 'plugin start');
     const dedupCache = new SimpleLRUCache(1000, config.deduplicationInterval * 1000);
+    const cacheTTL = (config.cacheTTL || 600) * 1000;
+    const urlCacheLocal = new SimpleLRUCache(500, cacheTTL);
     const texts = {
         waitingTipText: config.waitingTipText || '正在解析视频，请稍候...',
         unsupportedPlatformText: config.unsupportedPlatformText || '不支持该平台链接',
@@ -446,14 +522,27 @@ function apply(ctx, config) {
         parseErrorPrefix: config.parseErrorPrefix || '❌ 解析失败：',
         parseErrorItemFormat: config.parseErrorItemFormat || '【${url}】: ${msg}',
     };
-    const http = axios_1.default.create({
+    const proxyConfig = config.proxy || {};
+    const axiosConfig = {
         timeout: config.timeout,
         headers: {
             'User-Agent': config.userAgent,
             'Referer': 'https://www.baidu.com/',
             'Content-Type': 'application/x-www-form-urlencoded'
         }
-    });
+    };
+    if (proxyConfig.host) {
+        axiosConfig.proxy = {
+            protocol: proxyConfig.protocol || 'http',
+            host: proxyConfig.host,
+            port: proxyConfig.port || 7890,
+            auth: proxyConfig.auth?.username ? {
+                username: proxyConfig.auth.username,
+                password: proxyConfig.auth.password || ''
+            } : undefined
+        };
+    }
+    const http = axios_1.default.create(axiosConfig);
     const defaultDedicatedApis = {
         bilibili: 'https://api.bugpk.com/api/bilibili',
         douyin: 'https://api.bugpk.com/api/douyin',
@@ -476,14 +565,19 @@ function apply(ctx, config) {
         let apiKey = '';
         let authHeaderType = 'Bearer';
         let customHeaderName = 'X-API-Key';
+        let fieldMapping = undefined;
         if (custom && custom.apiUrl) {
             apiUrl = custom.apiUrl;
             apiKey = custom.apiKey || '';
             authHeaderType = custom.authHeaderType || 'Bearer';
             customHeaderName = custom.customHeaderName || 'X-API-Key';
+            fieldMapping = parseFieldMapping(custom.fieldMapping);
         }
         const dedicatedFirst = config.platformDedicatedFirst?.[type] ?? false;
-        return { apiUrl, dedicatedFirst, apiKey, authHeaderType, customHeaderName };
+        if (!fieldMapping) {
+            fieldMapping = parseFieldMapping(config.globalFieldMapping);
+        }
+        return { apiUrl, dedicatedFirst, apiKey, authHeaderType, customHeaderName, fieldMapping };
     }
     function buildAuthHeaders(apiKey, authHeaderType, customHeaderName) {
         if (!apiKey)
@@ -552,9 +646,9 @@ function apply(ctx, config) {
             throw new Error(`写入视频文件失败: ${getErrorMessage(e)}`);
         }
     }
-    async function fetchApi(url, type) {
+    async function fetchApi(url, type, fieldMapping) {
         const cacheKey = url;
-        const cached = urlCache.get(cacheKey);
+        const cached = urlCacheLocal.get(cacheKey);
         if (cached && cached.expire > Date.now())
             return cached.data;
         const { apiUrl: dedicatedUrl, dedicatedFirst, apiKey, authHeaderType, customHeaderName } = getPlatformConfig(type);
@@ -563,18 +657,19 @@ function apply(ctx, config) {
         const backupAllowed = backupSupportedPlatforms.has(type);
         const apiList = [];
         if (dedicatedFirst && dedicatedUrl) {
-            apiList.push({ url: dedicatedUrl, label: `专属API(${type})`, apiKey, authHeaderType, customHeaderName });
-            apiList.push({ url: primaryApi, label: '默认主API' });
+            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' });
+                apiList.push({ url: backupApi, label: '备用主API', fieldMapping });
         }
         else {
-            apiList.push({ url: primaryApi, label: '默认主API' });
+            apiList.push({ url: primaryApi, label: '默认主API', fieldMapping });
             if (backupAllowed)
-                apiList.push({ url: backupApi, label: '备用主API' });
+                apiList.push({ url: backupApi, label: '备用主API', fieldMapping });
             if (dedicatedUrl)
-                apiList.push({ url: dedicatedUrl, label: `专属API(${type})`, apiKey, authHeaderType, customHeaderName });
+                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++) {
@@ -584,14 +679,18 @@ function apply(ctx, config) {
                         '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);
-                        urlCache.set(cacheKey, { data: parsed, expire: Date.now() + 10 * 60 * 1000 });
+                        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}`);
@@ -607,12 +706,12 @@ function apply(ctx, config) {
         }
         throw lastError || new Error('所有API请求全部失败');
     }
-    async function parseUrl(url, type) {
+    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);
+                const info = await fetchApi(candidate, type, fieldMapping);
                 if (info.video || info.images.length > 0)
                     return { success: true, data: info };
                 debugLog('WARN', `解析成功但无内容: ${candidate}`);
@@ -623,8 +722,8 @@ function apply(ctx, config) {
         }
         return { success: false, msg: texts.unsupportedPlatformText };
     }
-    async function processSingleUrl(url, type) {
-        const result = await parseUrl(url, type);
+    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);
@@ -696,31 +795,37 @@ function apply(ctx, config) {
         debugLog('INFO', `开始解析 ${matches.length} 个链接`);
         const items = [];
         const errors = [];
-        for (let i = 0; i < matches.length; i++) {
-            const match = matches[i];
-            if (config.deduplicationInterval > 0) {
-                const lastTime = dedupCache.get(match.url);
-                if (lastTime && (Date.now() - lastTime < config.deduplicationInterval * 1000)) {
-                    debugLog('INFO', `跳过重复链接: ${match.url}`);
-                    const shortUrl = match.url.length > 50 ? match.url.slice(0, 50) + '...' : match.url;
-                    await sendWithTimeout(session, `链接 ${shortUrl} 在最近 ${config.deduplicationInterval} 秒内已解析过，已跳过。`).catch(() => { });
-                    continue;
+        const limiter = new ConcurrencyLimiter(config.maxConcurrent || 3);
+        const promises = matches.map(async (match) => {
+            await limiter.acquire();
+            try {
+                if (config.deduplicationInterval > 0) {
+                    const lastTime = dedupCache.get(match.url);
+                    if (lastTime && (Date.now() - lastTime < config.deduplicationInterval * 1000)) {
+                        debugLog('INFO', `跳过重复链接: ${match.url}`);
+                        const shortUrl = match.url.length > 50 ? match.url.slice(0, 50) + '...' : match.url;
+                        await sendWithTimeout(session, `链接 ${shortUrl} 在最近 ${config.deduplicationInterval} 秒内已解析过，已跳过。`).catch(() => { });
+                        return;
+                    }
+                }
+                debugLog('INFO', `解析链接: ${match.url} (${match.type})`);
+                const fieldMapping = getPlatformConfig(match.type).fieldMapping;
+                const result = await processSingleUrl(match.url, match.type, fieldMapping);
+                if (result.success) {
+                    items.push(result.data);
+                    if (config.deduplicationInterval > 0)
+                        dedupCache.set(match.url, Date.now());
+                }
+                else {
+                    const item = texts.parseErrorItemFormat.replace(/\$\{url\}/g, match.url.length > 50 ? match.url.slice(0, 50) + '...' : match.url).replace(/\$\{msg\}/g, result.msg);
+                    errors.push(item);
                 }
             }
-            debugLog('INFO', `解析第 ${i + 1}/${matches.length} 个链接: ${match.url} (${match.type})`);
-            const result = await processSingleUrl(match.url, match.type);
-            if (result.success) {
-                items.push(result.data);
-                if (config.deduplicationInterval > 0)
-                    dedupCache.set(match.url, Date.now());
-            }
-            else {
-                const item = texts.parseErrorItemFormat.replace(/\$\{url\}/g, match.url.length > 50 ? match.url.slice(0, 50) + '...' : match.url).replace(/\$\{msg\}/g, result.msg);
-                errors.push(item);
+            finally {
+                limiter.release();
             }
-            if (i < matches.length - 1)
-                await delay(500);
-        }
+        });
+        await Promise.all(promises);
         if (errors.length)
             await sendWithTimeout(session, `${texts.parseErrorPrefix}\n${errors.join('\n')}`);
         if (!items.length)
@@ -734,7 +839,7 @@ function apply(ctx, config) {
                 const text = item.text;
                 if (text && config.showImageText)
                     forwardMessages.push(buildForwardNode(session, text, botName));
-                if (p.cover && p.type !== 'live_photo' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length)))
+                if (config.showCoverImage && p.cover && 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 (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) ?? []);
@@ -765,7 +870,7 @@ function apply(ctx, config) {
                     await sendWithTimeout(session, text);
                     await delay(300);
                 }
-                if (p.cover && p.type !== 'live_photo' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
+                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(() => { });
                     await delay(300);
                 }
@@ -853,7 +958,7 @@ function apply(ctx, config) {
     }, 3600000);
     ctx.on('dispose', () => {
         clearInterval(tempCleanupInterval);
-        urlCache.clear();
+        urlCacheLocal.clear();
         dedupCache.clear();
         debugLog('INFO', '插件已卸载');
     });

package/package.json

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

package/readme.md

@@ -6,7 +6,7 @@
 这是一个为 Koishi 机器人框架开发的**全平台视频/图集解析插件**，使用统一API接口，支持自动识别并解析抖音、快手、B站、小红书、微博、YouTube、TikTok、剪映、AcFun、知乎、虎牙、绿洲、视频号等20+主流平台的短视频/图集/实况链接。
 
 ### 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, Oasis, WeChat Channels and more. 
+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, Oasis, WeChat Channels and more.
 
 ## 项目仓库 (Repository)
 - GitHub: `https://github.com/Minecraft-1314/koishi-plugin-video-parser-all`
@@ -20,7 +20,7 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 
 ## 配置项说明 (Configuration)
 
-### 基础设置
+### 基础设置 (Basic Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `enable` | boolean | true | 是否启用视频解析插件 |
@@ -28,55 +28,69 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 | `showWaitingTip` | boolean | true | 解析时是否显示等待提示 |
 | `debug` | boolean | false | 是否开启 Debug 模式，在控制台输出详细日志 |
 
-### 统一消息格式
+### 统一消息格式 (Unified Message Format)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `unifiedMessageFormat` | string | `标题：${标题}\n作者：${作者}\n简介：${简介}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}` | 自定义解析结果的输出格式，支持变量替换。某行所有变量为空（或为"0"）时自动隐藏该行 |
-
-### 内容显示设置
+| `unifiedMessageFormat` | string | `标题：${标题}
+作者：${作者}
+简介：${简介}
+点赞：${点赞数}
+收藏：${收藏数}
+转发：${转发数}
+播放：${播放数}
+评论：${评论数}
+图片数量：${图片数量}` | 自定义解析结果的输出格式，支持变量替换。某行所有变量均为空（或为"0"）时自动隐藏该行 |
+
+### 内容显示设置 (Content Display Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `showImageText` | boolean | true | 是否发送解析后的文字内容 |
+| `showCoverImage` | boolean | true | 是否发送封面图片（关闭后不再自动发送封面） |
 | `showVideoFile` | boolean | true | 是否发送视频文件（关闭则只发送视频链接） |
 | `maxDescLength` | number | 200 | 简介内容最大长度（字符），超出自动截断 |
 | `videoDownloadTimeout` | number | 120000 | 视频下载超时（毫秒） |
 | `tempDir` | string | `./temp_videos` | 临时视频存储目录 |
 | `maxVideoSize` | number | 0 | 最大下载视频大小（MB），0 为不限制大小 |
 | `forceDownloadVideo` | boolean | false | 强制下载视频后发送 |
+| `maxConcurrent` | number | 3 | 批量解析时最大并发数，避免同时下载过多 |
 
-### 网络与 API 设置
+### 网络与 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 | `{ protocol: "http", host: "127.0.0.1", port: 7890, auth: { username: "", password: "" } }` | HTTP 代理设置，支持认证。不填 `host` 则不启用代理 |
+| `customHeaders` | array | [] | 自定义请求头，会附加到所有 API 请求中。每项包含 `name`（头名称）和 `value`（头值） |
 
-### API 选择与回退设置
+### 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`、`oasis`、`wechat_channel` |
-| `customApis` | array | [] | 自定义平台专属 API 列表。每项包含：`platform`（平台类型）、`apiUrl`（API 地址）、`apiKey`（API Key，可选）、`authHeaderType`（认证头类型，可选：`Bearer` / `X-API-Key` / `Custom`）、`customHeaderName`（自定义 Header 名称，仅当 `authHeaderType` 为 `Custom` 时有效）。可覆盖内置默认专属 API |
+| `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 字符串，优先级低于专属 API 映射。用于统一适配所有平台的 API 响应格式，例如 `{"title":"data.info.title"}` |
 
-### 错误与重试设置
+### 错误与重试设置 (Error & Retry Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `ignoreSendError` | boolean | true | 是否忽略消息发送失败，避免插件崩溃 |
 | `retryTimes` | number | 3 | API 请求及消息发送失败时的重试次数 |
 | `retryInterval` | number | 1000 | API 请求及消息发送重试的间隔时间（毫秒） |
 
-### 发送方式设置
+### 发送方式设置 (Send Mode Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `enableForward` | boolean | false | 是否启用合并转发（仅 OneBot 平台），启用后视频与图文将整合进同一条合并消息 |
 
-### 去重设置
+### 缓存与去重设置 (Cache & Deduplication Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `deduplicationInterval` | number | 180 | 禁止重复解析时间间隔（秒），0 为不限制。同一个链接在间隔内不会重复解析。 |
+| `cacheTTL` | number | 600 | 解析结果缓存时间（秒），0 为不缓存。缓存可减少重复 API 请求。 |
 
-### 界面文字设置
+### 界面文字设置 (UI Text Settings)
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `waitingTipText` | string | 正在解析视频，请稍候... | 解析等待提示文字 |