koishi-plugin-video-parser-all 1.3.5 → 1.3.6

package/lib/index.d.ts

@@ -1,4 +1,11 @@
 import { Context, Schema } from 'koishi';
+declare module 'koishi' {
+    interface Context {
+        downloads?: {
+            download(url: string, dest: string, options?: Record<string, unknown>): Promise<string>;
+        };
+    }
+}
 export declare const name = "video-parser-all";
 export declare const Config: Schema<{
     enable?: boolean | null | undefined;
@@ -23,9 +30,13 @@ export declare const Config: Schema<{
         twitter?: boolean | null | undefined;
         instagram?: boolean | null | undefined;
         doubao?: boolean | null | undefined;
-        doubao_chat?: boolean | null | undefined;
         oasis?: boolean | null | undefined;
         wechat_channel?: boolean | null | undefined;
+        lishi?: boolean | null | undefined;
+        quanmin?: boolean | null | undefined;
+        pipigx?: boolean | null | undefined;
+        pipixia?: boolean | null | undefined;
+        zuiyou?: boolean | null | undefined;
     } & import("cosmokit").Dict) | null | undefined;
 } & import("cosmokit").Dict & {
     unifiedMessageFormat?: string | null | undefined;
@@ -34,24 +45,24 @@ export declare const Config: Schema<{
     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;
+    forceDownloadImage?: boolean | null | undefined;
     forceDownloadVideo?: boolean | null | undefined;
-    videoDownloadTimeout?: number | null | undefined;
-    tempDir?: string | null | undefined;
-    maxVideoSize?: number | null | undefined;
-    maxDescLength?: number | null | undefined;
-    maxConcurrent?: number | null | undefined;
-    downloadConcurrency?: number | null | undefined;
+} & {
     showMusicVoice?: boolean | null | undefined;
     showMusicVoiceFile?: boolean | null | undefined;
     forceDownloadMusicVoice?: boolean | null | undefined;
-    musicDownloadTimeout?: number | null | undefined;
-    musicTempDir?: string | null | undefined;
-    maxMusicSize?: number | null | undefined;
+} & {
+    maxDescLength?: number | null | undefined;
+    maxConcurrent?: number | null | undefined;
+    downloadConcurrency?: number | null | undefined;
+    mediaDownloadTimeout?: number | null | undefined;
+    maxMediaSize?: number | null | undefined;
+    downloadEngine?: "internal" | "aria2" | null | undefined;
+    aria2Host?: string | null | undefined;
+    aria2Port?: number | null | undefined;
+    aria2Secret?: string | null | undefined;
+    resumeDownload?: boolean | null | undefined;
 } & {
     timeout?: number | null | undefined;
     videoSendTimeout?: number | null | undefined;
@@ -74,14 +85,19 @@ export declare const Config: Schema<{
     ignoreSendError?: boolean | null | undefined;
     retryTimes?: number | null | undefined;
     retryInterval?: number | null | undefined;
-} & {
     enableForward?: boolean | null | undefined;
 } & {
     deduplicationInterval?: number | null | undefined;
     cacheTTL?: number | null | undefined;
+    cacheDir?: string | null | undefined;
 } & {
     primaryApiUrl?: string | null | undefined;
     backupApiUrl?: string | null | undefined;
+    apiKeys?: ({
+        key?: string | null | undefined;
+        weight?: number | null | undefined;
+    } & import("cosmokit").Dict)[] | null | undefined;
+    rotationMode?: "sequential" | "load_balance" | null | undefined;
     platformDedicatedFirst?: ({
         bilibili?: boolean | null | undefined;
         douyin?: boolean | null | undefined;
@@ -100,12 +116,16 @@ export declare const Config: Schema<{
         twitter?: boolean | null | undefined;
         instagram?: boolean | null | undefined;
         doubao?: boolean | null | undefined;
-        doubao_chat?: boolean | null | undefined;
         oasis?: boolean | null | undefined;
         wechat_channel?: boolean | null | undefined;
+        lishi?: boolean | null | undefined;
+        quanmin?: boolean | null | undefined;
+        pipigx?: boolean | null | undefined;
+        pipixia?: boolean | null | undefined;
+        zuiyou?: boolean | null | undefined;
     } & import("cosmokit").Dict) | null | undefined;
     customApis?: ({
-        platform?: "bilibili" | "douyin" | "kuaishou" | "xiaohongshu" | "weibo" | "xigua" | "youtube" | "tiktok" | "acfun" | "zhihu" | "weishi" | "huya" | "haokan" | "meipai" | "twitter" | "instagram" | "doubao" | "doubao_chat" | "oasis" | "wechat_channel" | null | undefined;
+        platform?: "bilibili" | "douyin" | "kuaishou" | "xiaohongshu" | "weibo" | "xigua" | "youtube" | "tiktok" | "acfun" | "zhihu" | "weishi" | "huya" | "haokan" | "meipai" | "twitter" | "instagram" | "doubao" | "oasis" | "wechat_channel" | null | undefined;
         apiUrl?: string | null | undefined;
         apiKey?: string | null | undefined;
         authHeaderType?: "Bearer" | "X-API-Key" | "Custom" | null | undefined;
@@ -162,9 +182,13 @@ export declare const Config: Schema<{
         twitter: Schema<boolean, boolean>;
         instagram: Schema<boolean, boolean>;
         doubao: Schema<boolean, boolean>;
-        doubao_chat: Schema<boolean, boolean>;
         oasis: Schema<boolean, boolean>;
         wechat_channel: Schema<boolean, boolean>;
+        lishi: Schema<boolean, boolean>;
+        quanmin: Schema<boolean, boolean>;
+        pipigx: Schema<boolean, boolean>;
+        pipixia: Schema<boolean, boolean>;
+        zuiyou: Schema<boolean, boolean>;
     }>;
 } & import("cosmokit").Dict & {
     unifiedMessageFormat: string;
@@ -173,24 +197,24 @@ export declare const Config: Schema<{
     showCoverImage: boolean;
     showMusicCover: boolean;
     showImageFile: boolean;
-    forceDownloadImage: boolean;
-    imageDownloadTimeout: number;
-    imageTempDir: string;
-    maxImageSize: number;
     showVideoFile: boolean;
+    forceDownloadImage: boolean;
     forceDownloadVideo: boolean;
-    videoDownloadTimeout: number;
-    tempDir: string;
-    maxVideoSize: number;
-    maxDescLength: number;
-    maxConcurrent: number;
-    downloadConcurrency: number;
+} & {
     showMusicVoice: boolean;
     showMusicVoiceFile: boolean;
     forceDownloadMusicVoice: boolean;
-    musicDownloadTimeout: number;
-    musicTempDir: string;
-    maxMusicSize: number;
+} & {
+    maxDescLength: number;
+    maxConcurrent: number;
+    downloadConcurrency: number;
+    mediaDownloadTimeout: number;
+    maxMediaSize: number;
+    downloadEngine: "internal" | "aria2";
+    aria2Host: string;
+    aria2Port: number;
+    aria2Secret: string;
+    resumeDownload: boolean;
 } & {
     timeout: number;
     videoSendTimeout: number;
@@ -216,14 +240,19 @@ export declare const Config: Schema<{
     ignoreSendError: boolean;
     retryTimes: number;
     retryInterval: number;
-} & {
     enableForward: boolean;
 } & {
     deduplicationInterval: number;
     cacheTTL: number;
+    cacheDir: string;
 } & {
     primaryApiUrl: string;
     backupApiUrl: string;
+    apiKeys: Schemastery.ObjectT<{
+        key: Schema<string, string>;
+        weight: Schema<number, number>;
+    }>[];
+    rotationMode: "sequential" | "load_balance";
     platformDedicatedFirst: Schemastery.ObjectT<{
         bilibili: Schema<boolean, boolean>;
         douyin: Schema<boolean, boolean>;
@@ -242,12 +271,16 @@ export declare const Config: Schema<{
         twitter: Schema<boolean, boolean>;
         instagram: Schema<boolean, boolean>;
         doubao: Schema<boolean, boolean>;
-        doubao_chat: Schema<boolean, boolean>;
         oasis: Schema<boolean, boolean>;
         wechat_channel: Schema<boolean, boolean>;
+        lishi: Schema<boolean, boolean>;
+        quanmin: Schema<boolean, boolean>;
+        pipigx: Schema<boolean, boolean>;
+        pipixia: Schema<boolean, boolean>;
+        zuiyou: Schema<boolean, boolean>;
     }>;
     customApis: Schemastery.ObjectT<{
-        platform: Schema<"bilibili" | "douyin" | "kuaishou" | "xiaohongshu" | "weibo" | "xigua" | "youtube" | "tiktok" | "acfun" | "zhihu" | "weishi" | "huya" | "haokan" | "meipai" | "twitter" | "instagram" | "doubao" | "doubao_chat" | "oasis" | "wechat_channel", "bilibili" | "douyin" | "kuaishou" | "xiaohongshu" | "weibo" | "xigua" | "youtube" | "tiktok" | "acfun" | "zhihu" | "weishi" | "huya" | "haokan" | "meipai" | "twitter" | "instagram" | "doubao" | "doubao_chat" | "oasis" | "wechat_channel">;
+        platform: Schema<"bilibili" | "douyin" | "kuaishou" | "xiaohongshu" | "weibo" | "xigua" | "youtube" | "tiktok" | "acfun" | "zhihu" | "weishi" | "huya" | "haokan" | "meipai" | "twitter" | "instagram" | "doubao" | "oasis" | "wechat_channel", "bilibili" | "douyin" | "kuaishou" | "xiaohongshu" | "weibo" | "xigua" | "youtube" | "tiktok" | "acfun" | "zhihu" | "weishi" | "huya" | "haokan" | "meipai" | "twitter" | "instagram" | "doubao" | "oasis" | "wechat_channel">;
         apiUrl: Schema<string, string>;
         apiKey: Schema<string, string>;
         authHeaderType: Schema<"Bearer" | "X-API-Key" | "Custom", "Bearer" | "X-API-Key" | "Custom">;

package/lib/index.js

@@ -71,9 +71,9 @@ exports.name = 'video-parser-all';
 exports.Config = koishi_1.Schema.intersect([
     koishi_1.Schema.object({
         enable: koishi_1.Schema.boolean().default(true).description('是否启用视频解析插件'),
-        botName: koishi_1.Schema.string().default('视频解析机器人').description('合并转发消息中显示的机器人名称'),
+        botName: koishi_1.Schema.string().default('视频解析机器人').description('合并转发中显示的昵称'),
         showWaitingTip: koishi_1.Schema.boolean().default(true).description('解析时显示等待提示'),
-        debug: koishi_1.Schema.boolean().default(false).description('开启调试模式，在控制台输出详细日志'),
+        debug: koishi_1.Schema.boolean().default(false).description('开启调试日志'),
         platformEnabled: koishi_1.Schema.object({
             bilibili: koishi_1.Schema.boolean().default(true).description('哔哩哔哩'),
             douyin: koishi_1.Schema.boolean().default(true).description('抖音'),
@@ -92,41 +92,50 @@ exports.Config = koishi_1.Schema.intersect([
             twitter: koishi_1.Schema.boolean().default(true).description('Twitter/X'),
             instagram: koishi_1.Schema.boolean().default(true).description('Instagram'),
             doubao: koishi_1.Schema.boolean().default(true).description('豆包'),
-            doubao_chat: koishi_1.Schema.boolean().default(true).description('豆包对话'),
             oasis: koishi_1.Schema.boolean().default(true).description('绿洲'),
             wechat_channel: koishi_1.Schema.boolean().default(true).description('视频号'),
+            lishi: koishi_1.Schema.boolean().default(true).description('梨视频'),
+            quanmin: koishi_1.Schema.boolean().default(true).description('全民直播'),
+            pipigx: koishi_1.Schema.boolean().default(true).description('皮皮搞笑'),
+            pipixia: koishi_1.Schema.boolean().default(true).description('皮皮虾'),
+            zuiyou: koishi_1.Schema.boolean().default(true).description('最右'),
         }).description('各平台解析开关'),
-    }).description('基础设置'),
+    }).description('基本设置'),
     koishi_1.Schema.object({
-        unifiedMessageFormat: koishi_1.Schema.string().role('textarea').default('标题：${标题}\n作者：${作者}\n简介：${简介}\n音乐标题：${音乐标题}\n音乐作者：${音乐作者}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}').description('文字消息格式，支持变量。某行所有变量为空时自动隐藏。封面及媒体文件由独立开关控制，默认不包含在文字中'),
-    }).description('消息格式设置'),
+        unifiedMessageFormat: koishi_1.Schema.string().role('textarea').default('标题：${标题}\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('是否发送封面图片（视频/图集封面）'),
-        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 为不限制'),
-        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('封面/图片是否以图片形式发送（关闭则只发送链接）'),
+        showVideoFile: koishi_1.Schema.boolean().default(true).description('视频是否以视频形式发送（关闭则只发送链接）'),
+        forceDownloadImage: koishi_1.Schema.boolean().default(false).description('强制下载封面/图片'),
+        forceDownloadVideo: koishi_1.Schema.boolean().default(false).description('强制下载视频'),
+    }).description('媒体发送'),
+    koishi_1.Schema.object({
+        showMusicVoice: koishi_1.Schema.boolean().default(false).description('音乐链接以语音形式发送'),
+        showMusicVoiceFile: koishi_1.Schema.boolean().default(true).description('音乐语音是否以文件形式发送（关闭则只发送链接）'),
+        forceDownloadMusicVoice: koishi_1.Schema.boolean().default(false).description('强制下载音乐语音'),
+    }).description('音乐语音（需 silk 和 ffmpeg）'),
+    koishi_1.Schema.object({
+        maxDescLength: koishi_1.Schema.number().min(0).step(1).default(200).description('简介长度上限'),
         maxConcurrent: koishi_1.Schema.number().min(1).step(1).default(3).description('解析最大并发数'),
         downloadConcurrency: koishi_1.Schema.number().min(1).step(1).default(3).description('下载线程数'),
-        showMusicVoice: koishi_1.Schema.boolean().default(false).description('是否发送音乐（转语音）'),
-        showMusicVoiceFile: koishi_1.Schema.boolean().default(true).description('音乐语音是否以文件形式发送（关闭则只发送链接）'),
-        forceDownloadMusicVoice: koishi_1.Schema.boolean().default(false).description('强制下载音乐语音后发送'),
-        musicDownloadTimeout: koishi_1.Schema.number().min(0).step(1).default(120000).description('音乐下载超时（毫秒）'),
-        musicTempDir: koishi_1.Schema.string().default('./temp_music').description('临时音乐存储目录'),
-        maxMusicSize: koishi_1.Schema.number().min(0).step(1).default(0).description('最大下载音乐大小（MB），0 为不限制'),
-    }).description('内容显示设置'),
+        mediaDownloadTimeout: koishi_1.Schema.number().min(0).step(1).default(120000).description('统一下载超时 (ms)'),
+        maxMediaSize: koishi_1.Schema.number().min(0).step(1).default(0).description('最大下载文件大小 (MB)，0 为不限制'),
+        downloadEngine: koishi_1.Schema.union([
+            koishi_1.Schema.const('internal').description('内置下载'),
+            koishi_1.Schema.const('aria2').description('aria2 下载'),
+        ]).default('internal').description('下载引擎'),
+        aria2Host: koishi_1.Schema.string().default('127.0.0.1').description('aria2 RPC 地址'),
+        aria2Port: koishi_1.Schema.number().default(6800).description('aria2 RPC 端口'),
+        aria2Secret: koishi_1.Schema.string().default('').description('aria2 RPC 密钥'),
+        resumeDownload: koishi_1.Schema.boolean().default(true).description('启用断点续传（仅 aria2 模式）'),
+    }).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('消息发送超时（毫秒）'),
+        timeout: koishi_1.Schema.number().min(0).step(1).default(180000).description('API 请求超时 (ms)'),
+        videoSendTimeout: koishi_1.Schema.number().min(0).step(1).default(180000).description('消息发送超时 (ms)'),
         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('启用代理'),
@@ -145,22 +154,29 @@ exports.Config = koishi_1.Schema.intersect([
             name: koishi_1.Schema.string().required().description('头名称'),
             value: koishi_1.Schema.string().required().description('头值'),
         })).default([]).description('自定义请求头'),
-    }).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('重试次数'),
-        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、Satori 平台）'),
-    }).description('发送方式'),
+        retryInterval: koishi_1.Schema.number().min(0).step(1).default(1000).description('重试间隔 (ms)'),
+        enableForward: koishi_1.Schema.boolean().default(false).description('合并转发（OneBot/Satori）'),
+    }).description('发送与重试'),
     koishi_1.Schema.object({
-        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('缓存与去重'),
+        deduplicationInterval: koishi_1.Schema.number().min(0).step(1).default(180).description('去重间隔 (s)'),
+        cacheTTL: koishi_1.Schema.number().min(0).step(1).default(600).description('缓存时间 (s)'),
+        cacheDir: koishi_1.Schema.string().default('./temp_cache').description('统一临时目录'),
+    }).description('缓存与临时文件'),
     koishi_1.Schema.object({
         primaryApiUrl: koishi_1.Schema.string().default('https://api.bugpk.com/api/short_videos').hidden(),
         backupApiUrl: koishi_1.Schema.string().default('https://api.bugpk.com/api/svparse').hidden(),
+        apiKeys: koishi_1.Schema.array(koishi_1.Schema.object({
+            key: koishi_1.Schema.string().required().description('API Key'),
+            weight: koishi_1.Schema.number().min(1).default(1).description('权重（负载均衡模式）'),
+        })).default([]).description('多 API 密钥（轮换使用）'),
+        rotationMode: koishi_1.Schema.union([
+            koishi_1.Schema.const('sequential').description('顺序模式（无效时切换）'),
+            koishi_1.Schema.const('load_balance').description('负载均衡模式（轮询）'),
+        ]).default('sequential').description('密钥轮换模式'),
         platformDedicatedFirst: koishi_1.Schema.object({
             bilibili: koishi_1.Schema.boolean().default(false).description('哔哩哔哩'),
             douyin: koishi_1.Schema.boolean().default(false).description('抖音'),
@@ -179,9 +195,13 @@ exports.Config = koishi_1.Schema.intersect([
             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('视频号'),
+            lishi: koishi_1.Schema.boolean().default(false).description('梨视频'),
+            quanmin: koishi_1.Schema.boolean().default(false).description('全民直播'),
+            pipigx: koishi_1.Schema.boolean().default(false).description('皮皮搞笑'),
+            pipixia: koishi_1.Schema.boolean().default(false).description('皮皮虾'),
+            zuiyou: koishi_1.Schema.boolean().default(false).description('最右'),
         }).description('优先使用专属 API'),
         customApis: koishi_1.Schema.array(koishi_1.Schema.object({
             platform: koishi_1.Schema.union([
@@ -202,7 +222,6 @@ exports.Config = koishi_1.Schema.intersect([
                 koishi_1.Schema.const('twitter').description('Twitter/X'),
                 koishi_1.Schema.const('instagram').description('Instagram'),
                 koishi_1.Schema.const('doubao').description('豆包'),
-                koishi_1.Schema.const('doubao_chat').description('豆包对话'),
                 koishi_1.Schema.const('oasis').description('绿洲'),
                 koishi_1.Schema.const('wechat_channel').description('视频号'),
             ]).description('平台'),
@@ -215,12 +234,12 @@ exports.Config = koishi_1.Schema.intersect([
             ]).default('Bearer').description('认证头类型'),
             customHeaderName: koishi_1.Schema.string().default('X-API-Key').description('自定义头名称'),
             fieldMapping: koishi_1.Schema.string().role('textarea').default('{}').description('字段映射 JSON'),
-        })).default([]).description('自定义内置平台专属 API'),
+        })).default([]).description('覆盖内置平台 API'),
         customPlatforms: koishi_1.Schema.array(koishi_1.Schema.object({
             name: koishi_1.Schema.string().required().description('平台名称'),
-            exampleUrl: koishi_1.Schema.string().description('示例视频链接'),
-            keywords: koishi_1.Schema.string().required().description('匹配关键词，逗号分隔'),
-            apiUrl: koishi_1.Schema.string().required().description('解析 API 地址'),
+            exampleUrl: koishi_1.Schema.string().description('示例链接'),
+            keywords: koishi_1.Schema.string().required().description('关键词（逗号分隔）'),
+            apiUrl: koishi_1.Schema.string().required().description('解析 API'),
             apiKey: koishi_1.Schema.string().default('').description('API Key'),
             authHeaderType: koishi_1.Schema.union([
                 koishi_1.Schema.const('Bearer').description('Bearer'),
@@ -266,14 +285,14 @@ exports.Config = koishi_1.Schema.intersect([
             '  "music_cover": "data.music.cover",\n' +
             '  "music_url": "data.music.url"\n' +
             '}').description('全局字段映射 JSON'),
-    }).description('API 选择'),
+    }).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('无效链接提示'),
         parseErrorPrefix: koishi_1.Schema.string().default('❌ 解析失败：').description('错误前缀'),
-        parseErrorItemFormat: koishi_1.Schema.string().default('【${url}】: ${msg}').description('错误项格式'),
-    }).description('界面文字'),
+        parseErrorItemFormat: koishi_1.Schema.string().default('【${url}】: ${msg}').description('错误格式'),
+    }).description('界面文本'),
 ]);
 const logger = new koishi_1.Logger(exports.name);
 let debugEnabled = false;
@@ -309,10 +328,19 @@ const BUILTIN_LINK_RULES = [
     { pattern: /https?:\/\/x\.com\/\w+\/status\/\d{10,}/gi, type: 'twitter' },
     { pattern: /https?:\/\/(?:www\.)?instagram\.com\/p\/[0-9a-zA-Z_-]{10,}/gi, type: 'instagram' },
     { pattern: /https?:\/\/(?:www\.)?doubao\.com\/video\/\d{10,}/gi, type: 'doubao' },
-    { pattern: /https?:\/\/(?:www\.)?doubao\.com\/thread\/[0-9a-zA-Z_-]+/gi, type: 'doubao_chat' },
     { pattern: /https?:\/\/(?:www\.)?oasis\.weibo\.com\/v\/[0-9a-zA-Z_-]+/gi, type: 'oasis' },
     { pattern: /https?:\/\/channels\.weixin\.qq\.com\/[0-9a-zA-Z_-]+/gi, type: 'wechat_channel' },
     { pattern: /https?:\/\/weixin\.qq\.com\/sph\/[0-9a-zA-Z_-]+/gi, type: 'wechat_channel' },
+    { pattern: /https?:\/\/(?:www\.)?pearvideo\.com\/video_\d+/gi, type: 'lishi' },
+    { pattern: /https?:\/\/video\.li\/[0-9a-zA-Z_-]{3,}/gi, type: 'lishi' },
+    { pattern: /https?:\/\/(?:www\.)?quanmin\.tv\/\w+/gi, type: 'quanmin' },
+    { pattern: /https?:\/\/(?:www\.)?quanmintv\.cn\/\w+/gi, type: 'quanmin' },
+    { pattern: /https?:\/\/h5\.pipigx\.com\/pp\/post\/\d+/gi, type: 'pipigx' },
+    { pattern: /https?:\/\/(?:www\.)?ippzone\.com\/\w+/gi, type: 'pipigx' },
+    { pattern: /https?:\/\/(?:h5|www)\.pipix\.com\/\w+/gi, type: 'pipixia' },
+    { pattern: /https?:\/\/(?:www\.)?pipixia\.com\/\w+/gi, type: 'pipixia' },
+    { pattern: /https?:\/\/share\.xiaochuankeji\.cn\/hybrid\/share\/post\?pid=\d+/gi, type: 'zuiyou' },
+    { pattern: /https?:\/\/(?:h5|www)\.izuiyou\.com\/\w+/gi, type: 'zuiyou' },
 ];
 function buildCustomLinkRules(customPlatforms) {
     if (!Array.isArray(customPlatforms) || customPlatforms.length === 0)
@@ -604,6 +632,10 @@ function generateFormattedText(p, format) {
         '音乐作者': p.music.author || '',
         '音乐封面': p.music.cover || '',
     };
+    const varReplacements = Object.entries(vars).map(([key, val]) => ({
+        regex: new RegExp(`\\$\\{${key}\\}`, 'g'),
+        value: val,
+    }));
     const lines = format.split('\n');
     const resultLines = [];
     for (const line of lines) {
@@ -622,8 +654,8 @@ function generateFormattedText(p, format) {
                 continue;
         }
         let newLine = line;
-        for (const [key, val] of Object.entries(vars)) {
-            newLine = newLine.replace(new RegExp(`\\$\\{${key}\\}`, 'g'), val);
+        for (const { regex, value } of varReplacements) {
+            newLine = newLine.replace(regex, value);
         }
         resultLines.push(newLine);
     }
@@ -661,6 +693,8 @@ function parseFieldMapping(mappingStr) {
     }
 }
 function apply(ctx, config) {
+    // @ts-expect-error koishi runtime supports optional service dependencies
+    ctx.using(['downloads', 'silk', 'ffmpeg'], { optional: true });
     debugEnabled = config.debug || false;
     debugLog('INFO', 'plugin start');
     const dedupCache = new SimpleLRUCache(1000, config.deduplicationInterval * 1000);
@@ -674,6 +708,7 @@ function apply(ctx, config) {
         parseErrorItemFormat: config.parseErrorItemFormat || '【${url}】: ${msg}',
     };
     const proxyConfig = config.proxy || {};
+    const cacheDir = config.cacheDir || './temp_cache';
     const customPlatforms = (config.customPlatforms || []).map((p) => ({
         name: p.name,
         apiUrl: p.apiUrl,
@@ -684,6 +719,59 @@ function apply(ctx, config) {
         proxy: p.proxy || null
     }));
     const downloadLimiter = new ConcurrencyLimiter(config.downloadConcurrency || 3);
+    const mediaDownloadTimeout = config.mediaDownloadTimeout ?? 120000;
+    const maxMediaSize = config.maxMediaSize ?? 0;
+    const downloadEngine = config.downloadEngine || 'internal';
+    let aria2 = null;
+    if (downloadEngine === 'aria2') {
+        try {
+            const Aria2 = require('aria2');
+            aria2 = new Aria2({
+                host: config.aria2Host || '127.0.0.1',
+                port: config.aria2Port || 6800,
+                secure: false,
+                secret: config.aria2Secret || '',
+                path: '/jsonrpc'
+            });
+            aria2.open();
+            logger.info('aria2 连接成功');
+        }
+        catch (e) {
+            logger.warn('aria2 连接失败，回退到内置下载');
+        }
+    }
+    const apiKeyList = (config.apiKeys || []).map((k) => ({
+        key: k.key,
+        weight: k.weight || 1,
+        lastUsed: 0
+    }));
+    let keyIndex = 0;
+    function getNextApiKey() {
+        if (apiKeyList.length === 0)
+            return '';
+        if (config.rotationMode === 'load_balance') {
+            const totalWeight = apiKeyList.reduce((sum, k) => sum + k.weight, 0);
+            let rand = Math.random() * totalWeight;
+            for (const k of apiKeyList) {
+                rand -= k.weight;
+                if (rand <= 0)
+                    return k.key;
+            }
+            return apiKeyList[0].key;
+        }
+        else {
+            const current = apiKeyList[keyIndex % apiKeyList.length];
+            keyIndex++;
+            return current.key;
+        }
+    }
+    function markApiKeyInvalid(key) {
+        if (config.rotationMode === 'sequential') {
+            const idx = apiKeyList.findIndex(k => k.key === key);
+            if (idx !== -1)
+                apiKeyList.splice(idx, 1);
+        }
+    }
     function getPlatformConfig(type) {
         if (type.startsWith('custom_')) {
             const name = type.slice(7);
@@ -692,7 +780,7 @@ function apply(ctx, config) {
                 return {
                     apiUrl: custom.apiUrl,
                     dedicatedFirst: true,
-                    apiKey: custom.apiKey,
+                    apiKey: custom.apiKey || getNextApiKey(),
                     authHeaderType: custom.authHeaderType,
                     customHeaderName: custom.customHeaderName,
                     fieldMapping: custom.fieldMapping,
@@ -706,7 +794,6 @@ function apply(ctx, config) {
             bilibili: 'https://api.bugpk.com/api/bilibili',
             douyin: 'https://api.bugpk.com/api/douyin',
             doubao: 'https://api.bugpk.com/api/dbvideos',
-            doubao_chat: 'https://api.bugpk.com/api/dbduihua',
             kuaishou: 'https://api.bugpk.com/api/kuaishou',
             xiaohongshu: 'https://api.bugpk.com/api/xhs',
             jimeng: 'https://api.bugpk.com/api/jimengai',
@@ -725,11 +812,14 @@ function apply(ctx, config) {
         let fieldMapping = undefined;
         if (custom && custom.apiUrl) {
             apiUrl = custom.apiUrl;
-            apiKey = custom.apiKey || '';
+            apiKey = custom.apiKey || getNextApiKey();
             authHeaderType = custom.authHeaderType || 'Bearer';
             customHeaderName = custom.customHeaderName || 'X-API-Key';
             fieldMapping = parseFieldMapping(custom.fieldMapping);
         }
+        else {
+            apiKey = getNextApiKey();
+        }
         const dedicatedFirst = config.platformDedicatedFirst?.[type] ?? false;
         if (!fieldMapping) {
             fieldMapping = parseFieldMapping(config.globalFieldMapping);
@@ -762,13 +852,77 @@ function apply(ctx, config) {
             return cleanUrl(url);
         }
     }
-    async function downloadFile(url, timeout, maxSize, tempDir, filePrefix, fileExts) {
+    async function downloadFile(url, timeout, maxSize, filePrefix, fileExts) {
         if (!url)
             throw new Error('链接为空');
-        await promises_1.default.mkdir(tempDir, { recursive: true });
-        const ext = fileExts.find(e => url.match(new RegExp('\\.' + e + '(\\?|$)', 'i'))) || fileExts[0];
+        await promises_1.default.mkdir(cacheDir, { recursive: true });
+        const extRegexCache = {};
+        const ext = fileExts.find(e => {
+            const r = extRegexCache[e] || (extRegexCache[e] = new RegExp('\\.' + e + '(\\?|$)', 'i'));
+            return r.test(url);
+        }) || fileExts[0];
         const fileName = `${filePrefix}_${Date.now()}_${(0, crypto_1.randomBytes)(4).toString('hex')}.${ext}`;
-        const filePath = path_1.default.resolve(tempDir, fileName);
+        const filePath = path_1.default.resolve(cacheDir, fileName);
+        if (ctx.downloads) {
+            try {
+                const dest = await ctx.downloads.download(url, path_1.default.join(cacheDir, fileName), {
+                    headers: { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36' },
+                    timeout
+                });
+                const stat = await promises_1.default.stat(dest);
+                if (maxSize > 0 && stat.size > maxSize * 1024 * 1024) {
+                    await promises_1.default.unlink(dest).catch(() => { });
+                    throw new Error(`文件过大(${Math.round(stat.size / 1024 / 1024)}MB)，超过限制(${maxSize}MB)`);
+                }
+                return dest;
+            }
+            catch (e) {
+                debugLog('ERROR', `downloads 服务下载失败，回退: ${getErrorMessage(e)}`);
+            }
+        }
+        if (aria2 && config.resumeDownload) {
+            try {
+                const gid = await aria2.call('aria2.addUri', [url], {
+                    dir: cacheDir,
+                    out: fileName,
+                    split: 4,
+                    continue: true,
+                    maxConnectionPerServer: 5,
+                    timeout: timeout / 1000,
+                    maxFileNotFound: 5,
+                    maxTries: 5,
+                    retryWait: 2,
+                    header: [`User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36`, `Referer: https://www.baidu.com/`]
+                });
+                let completed = false;
+                const ariaStartTime = Date.now();
+                while (!completed) {
+                    if (Date.now() - ariaStartTime > timeout) {
+                        await aria2.call('aria2.remove', gid).catch(() => { });
+                        throw new Error('aria2下载超时');
+                    }
+                    const status = await aria2.call('aria2.tellStatus', gid);
+                    if (status.status === 'complete') {
+                        completed = true;
+                    }
+                    else if (status.status === 'error' || status.status === 'removed') {
+                        throw new Error('aria2下载失败');
+                    }
+                    else {
+                        await delay(1000);
+                    }
+                }
+                const stat = await promises_1.default.stat(filePath);
+                if (maxSize > 0 && stat.size > maxSize * 1024 * 1024) {
+                    await promises_1.default.unlink(filePath).catch(() => { });
+                    throw new Error(`文件过大(${Math.round(stat.size / 1024 / 1024)}MB)，超过限制(${maxSize}MB)`);
+                }
+                return filePath;
+            }
+            catch (e) {
+                debugLog('ERROR', `aria2下载失败，回退内置下载: ${getErrorMessage(e)}`);
+            }
+        }
         const writer = (0, fs_1.createWriteStream)(filePath);
         let response;
         try {
@@ -803,7 +957,7 @@ function apply(ctx, config) {
             throw new Error(`写入文件失败: ${getErrorMessage(e)}`);
         }
     }
-    async function sendMedia(session, url, type, forceDownload, showFile, timeout, tempDir, maxSize) {
+    async function sendMedia(session, url, type, forceDownload, showFile) {
         if (!url)
             return;
         await downloadLimiter.acquire();
@@ -818,7 +972,7 @@ function apply(ctx, config) {
             const sendFunc = type === 'audio' ? koishi_1.h.audio : type === 'video' ? koishi_1.h.video : koishi_1.h.image;
             if (forceDownload) {
                 try {
-                    const localPath = await downloadFile(url, timeout, maxSize, tempDir, prefixMap[type], extMap[type]);
+                    const localPath = await downloadFile(url, mediaDownloadTimeout, maxMediaSize, prefixMap[type], extMap[type]);
                     try {
                         await sendWithTimeout(session, sendFunc(`file://${localPath}`));
                     }
@@ -847,7 +1001,7 @@ function apply(ctx, config) {
             }
             catch {
                 try {
-                    const localPath = await downloadFile(url, timeout, maxSize, tempDir, prefixMap[type], extMap[type]);
+                    const localPath = await downloadFile(url, mediaDownloadTimeout, maxMediaSize, prefixMap[type], extMap[type]);
                     try {
                         await sendWithTimeout(session, sendFunc(`file://${localPath}`));
                     }
@@ -957,26 +1111,26 @@ function apply(ctx, config) {
                     await delay(300);
                 }
                 if (p.cover && config.showCoverImage && p.type !== 'live_photo' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
-                    await sendMedia(session, p.cover, 'image', config.forceDownloadImage, config.showImageFile, config.imageDownloadTimeout, config.imageTempDir, config.maxImageSize).catch(() => { });
+                    await sendMedia(session, p.cover, 'image', config.forceDownloadImage, config.showImageFile).catch(() => { });
                     await delay(300);
                 }
                 if (config.showMusicCover && p.music.cover) {
-                    await sendMedia(session, p.music.cover, 'image', config.forceDownloadImage, config.showImageFile, config.imageDownloadTimeout, config.imageTempDir, config.maxImageSize).catch(() => { });
+                    await sendMedia(session, p.music.cover, 'image', config.forceDownloadImage, config.showImageFile).catch(() => { });
                     await delay(300);
                 }
                 if (p.video && (p.type === 'video' || (p.type === 'live' && !p.live_photo?.length && !p.images?.length))) {
-                    await sendMedia(session, p.video, 'video', config.forceDownloadVideo, config.showVideoFile, config.videoDownloadTimeout, config.tempDir, config.maxVideoSize).catch(() => { });
+                    await sendMedia(session, p.video, 'video', config.forceDownloadVideo, config.showVideoFile).catch(() => { });
                     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 sendMedia(session, imgUrl, 'image', config.forceDownloadImage, config.showImageFile, config.imageDownloadTimeout, config.imageTempDir, config.maxImageSize).catch(() => { });
+                        await sendMedia(session, imgUrl, 'image', config.forceDownloadImage, config.showImageFile).catch(() => { });
                         await delay(200);
                     }
                 }
                 if (config.showMusicVoice && p.music.url) {
-                    await sendMedia(session, p.music.url, 'audio', config.forceDownloadMusicVoice, config.showMusicVoiceFile, config.musicDownloadTimeout, config.musicTempDir, config.maxMusicSize).catch(() => { });
+                    await sendMedia(session, p.music.url, 'audio', config.forceDownloadMusicVoice, config.showMusicVoiceFile).catch(() => { });
                     await delay(300);
                 }
             }
@@ -1045,6 +1199,10 @@ function apply(ctx, config) {
                         urlCacheLocal.set(cacheKey, { data: parsed, expire: Date.now() + cacheTTL });
                         return parsed;
                     }
+                    if (res.data?.code === 403 || res.data?.code === 401) {
+                        if (api.apiKey)
+                            markApiKeyInvalid(api.apiKey);
+                    }
                     throw new Error(res.data?.msg || `API返回错误码: ${res.data?.code}`);
                 }
                 catch (error) {
@@ -1170,19 +1328,16 @@ function apply(ctx, config) {
     });
     const tempCleanupInterval = setInterval(async () => {
         try {
-            const dirs = [config.tempDir || './temp_videos', config.imageTempDir || './temp_images', config.musicTempDir || './temp_music'];
-            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)) ||
-                        (file.startsWith('music_') && file.match(/\.(mp3|wav|ogg|flac|aac|m4a)$/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(() => { });
-                        }
+            const files = await promises_1.default.readdir(cacheDir);
+            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)) ||
+                    (file.startsWith('music_') && file.match(/\.(mp3|wav|ogg|flac|aac|m4a)$/i))) {
+                    const filePath = path_1.default.join(cacheDir, file);
+                    const stats = await promises_1.default.stat(filePath);
+                    if (now - stats.mtimeMs > 3600000) {
+                        await promises_1.default.unlink(filePath).catch(() => { });
                     }
                 }
             }
@@ -1193,21 +1348,20 @@ function apply(ctx, config) {
     }, 3600000);
     ctx.on('dispose', () => {
         clearInterval(tempCleanupInterval);
+        if (aria2)
+            aria2.close();
         urlCacheLocal.clear();
         dedupCache.clear();
         debugLog('INFO', '插件已卸载');
     });
     process.on('beforeExit', async () => {
         try {
-            const dirs = [config.tempDir || './temp_videos', config.imageTempDir || './temp_images', config.musicTempDir || './temp_music'];
-            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)) ||
-                        (file.startsWith('music_') && file.match(/\.(mp3|wav|ogg|flac|aac|m4a)$/i))) {
-                        await promises_1.default.unlink(path_1.default.join(dir, file)).catch(() => { });
-                    }
+            const files = await promises_1.default.readdir(cacheDir);
+            for (const file of files) {
+                if ((file.startsWith('video_') && file.endsWith('.mp4')) ||
+                    (file.startsWith('img_') && file.match(/\.(png|jpg|jpeg|gif|webp)$/i)) ||
+                    (file.startsWith('music_') && file.match(/\.(mp3|wav|ogg|flac|aac|m4a)$/i))) {
+                    await promises_1.default.unlink(path_1.default.join(cacheDir, file)).catch(() => { });
                 }
             }
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-video-parser-all",
   "description": "Koishi 全平台视频/图集解析插件，支持抖音/快手/B站/微博/小红书/剪映/YouTube/TikTok等20+平台",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
@@ -45,7 +45,6 @@
     "twitter",
     "instagram",
     "doubao",
-    "doubao_chat",
     "jimeng",
     "oasis",
     "wechat_channel",
@@ -94,14 +93,14 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "axios": "^1.16.1",
-    "fast-xml-parser": "^4.5.6"
+    "axios": "^1.16.1"
   },
   "peerDependencies": {
     "@koishijs/plugin-console": "^5.30.4",
     "koishi": "^4.18.7",
     "koishi-plugin-silk": "^1.0.0",
-    "koishi-plugin-ffmpeg": "^1.0.0"
+    "koishi-plugin-ffmpeg": "^1.0.0",
+    "aria2": "^4.1.2"
   },
   "peerDependenciesMeta": {
     "koishi-plugin-silk": {
@@ -109,6 +108,9 @@
     },
     "koishi-plugin-ffmpeg": {
       "optional": true
+    },
+    "aria2": {
+      "optional": true
     }
   },
   "repository": {

package/readme.md

@@ -20,89 +20,94 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 
 ## 配置项说明 (Configuration)
 
-### 基础设置 (Basic Settings)
+### 基本设置
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `enable` | boolean | true | 是否启用视频解析插件 |
-| `botName` | string | 视频解析机器人 | 合并转发消息中显示的机器人名称 |
-| `showWaitingTip` | boolean | true | 解析时是否显示等待提示 |
-| `debug` | boolean | false | 是否开启 Debug 模式，在控制台输出详细日志 |
-| `platformEnabled` | object | 各平台均为 `true` | 各平台解析开关，可单独关闭某平台 |
+| `enable` | boolean | true | 启用插件 |
+| `botName` | string | 视频解析机器人 | 合并转发中的昵称 |
+| `showWaitingTip` | boolean | true | 显示等待提示 |
+| `debug` | boolean | false | Debug 日志 |
+| `platformEnabled` | object | 全开 | 各平台开关 |
 
-### 统一消息格式 (Unified Message Format)
+### 消息格式
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `unifiedMessageFormat` | string | `标题：${标题}\n作者：${作者}\n简介：${简介}\n音乐标题：${音乐标题}\n音乐作者：${音乐作者}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}` | 文字消息格式，支持变量替换。空行自动隐藏。 |
+| `unifiedMessageFormat` | string | 见预设 | 文字格式，支持变量，空行自动隐藏 |
 
-### 内容显示设置 (Content Display Settings)
+### 媒体发送
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `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 不限制 |
-| `maxDescLength` | number | 200 | 简介最大长度（字符） |
-| `maxConcurrent` | number | 3 | 解析最大并发数 |
-| `downloadConcurrency` | number | 3 | 下载线程数（≥1 整数） |
-| `showMusicVoice` | boolean | false | 是否发送音乐（转语音）。**需要依赖 `koishi-plugin-silk` 和 `koishi-plugin-ffmpeg`** |
-| `showMusicVoiceFile` | boolean | true | 音乐语音是否以文件形式发送（关闭则只发链接） |
-| `forceDownloadMusicVoice` | boolean | false | 强制下载音乐语音后发送 |
-| `musicDownloadTimeout` | number | 120000 | 音乐下载超时（毫秒） |
-| `musicTempDir` | string | `./temp_music` | 临时音乐存储目录 |
-| `maxMusicSize` | number | 0 | 最大下载音乐大小（MB），0 不限制 |
-
-### 网络与 API 设置 (Network & API Settings)
+| `showImageText` | boolean | true | 发送文字内容 |
+| `showCoverImage` | boolean | true | 发送封面图片 |
+| `showMusicCover` | boolean | true | 发送音乐封面 |
+| `showImageFile` | boolean | true | 封面/图片是否以图片形式发送（关闭则只发送链接） |
+| `showVideoFile` | boolean | true | 视频是否以视频形式发送（关闭则只发送链接） |
+| `forceDownloadImage` | boolean | false | 强制下载封面/图片 |
+| `forceDownloadVideo` | boolean | false | 强制下载视频 |
+
+### 音乐语音（需 silk 和 ffmpeg）
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `timeout` | number | 180000 | API 请求超时时间（毫秒） |
-| `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` |
+| `showMusicVoice` | boolean | false | 音乐链接以语音发送 |
+| `showMusicVoiceFile` | boolean | true | 音乐语音是否以文件形式发送（关闭则只发送链接） |
+| `forceDownloadMusicVoice` | boolean | false | 强制下载音乐语音 |
 
-### API 选择与回退设置 (API Selection & Fallback)
+### 性能与限制
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `platformDedicatedFirst` | object | 各平台均为 `false` | 平台专属 API 优先开关，键：`bilibili` 等 |
-| `customApis` | array | [] | 自定义内置平台专属 API，含 `platform`, `apiUrl`, `apiKey`, `authHeaderType`, `customHeaderName`, `fieldMapping` |
-| `customPlatforms` | array | [] | 完全自定义新平台。每项含：`name`（平台名称）、`exampleUrl`（示例链接）、`keywords`（匹配关键词，逗号分隔）、`apiUrl`（解析API）、`apiKey`、`authHeaderType`、`customHeaderName`、`fieldMapping`、`proxy`（独立代理） |
-| `globalFieldMapping` | string | 预设字段映射 JSON | 全局字段映射，支持点号路径 |
+| `maxDescLength` | number | 200 | 简介长度上限 |
+| `maxConcurrent` | number | 3 | 解析最大并发数 |
+| `downloadConcurrency` | number | 3 | 下载线程数 |
+| `mediaDownloadTimeout` | number | 120000 | 统一下载超时 (ms) |
+| `maxMediaSize` | number | 0 | 最大下载文件大小 (MB)，0 为不限制 |
+| `downloadEngine` | string | internal | 下载引擎（internal / aria2） |
+| `aria2Host` | string | 127.0.0.1 | aria2 RPC 地址 |
+| `aria2Port` | number | 6800 | aria2 RPC 端口 |
+| `aria2Secret` | string |  | aria2 RPC 密钥 |
+| `resumeDownload` | boolean | true | 启用断点续传（仅 aria2） |
+
+### 网络与请求
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `timeout` | number | 180000 | API 超时 (ms) |
+| `videoSendTimeout` | number | 180000 | 发送超时 (ms) |
+| `userAgent` | string | 见预设 | User-Agent |
+| `proxy` | object | ... | HTTP/HTTPS 代理 |
+| `customHeaders` | array | [] | 自定义请求头 |
 
-### 错误与重试设置 (Error & Retry Settings)
+### 发送与重试
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
 | `ignoreSendError` | boolean | true | 忽略发送失败 |
 | `retryTimes` | number | 3 | 重试次数 |
-| `retryInterval` | number | 1000 | 重试间隔（毫秒） |
+| `retryInterval` | number | 1000 | 重试间隔 (ms) |
+| `enableForward` | boolean | false | 合并转发（OneBot/Satori） |
 
-### 发送方式设置 (Send Mode Settings)
+### 缓存与临时文件
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `enableForward` | boolean | false | 启用合并转发（支持 OneBot、Satori 平台） |
+| `deduplicationInterval` | number | 180 | 去重间隔 (s) |
+| `cacheTTL` | number | 600 | 缓存时间 (s) |
+| `cacheDir` | string | ./temp_cache | 统一临时目录 |
 
-### 缓存与去重设置 (Cache & Deduplication Settings)
+### API 与平台
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `deduplicationInterval` | number | 180 | 去重间隔（秒） |
-| `cacheTTL` | number | 600 | 缓存时间（秒） |
-
-### 界面文字设置 (UI Text Settings)
+| `apiKeys` | array | [] | 多 API 密钥列表 |
+| `rotationMode` | string | sequential | 密钥轮换模式（sequential / load_balance） |
+| `platformDedicatedFirst` | object | 全关 | 优先专属 API |
+| `customApis` | array | [] | 覆盖内置平台 API |
+| `customPlatforms` | array | [] | 自定义新平台 |
+| `globalFieldMapping` | string | 预设 | 全局字段映射 JSON |
+
+### 界面文本
 | 配置项 | 类型 | 默认值 | 说明 |
 |--------|------|--------|------|
-| `waitingTipText` | string | 正在解析视频，请稍候... | 等待提示 |
-| `unsupportedPlatformText` | string | 不支持该平台链接 | 不支持平台提示 |
-| `invalidLinkText` | string | 无效的视频链接 | 无效链接提示 |
+| `waitingTipText` | string | 正在解析... | 等待提示 |
+| `unsupportedPlatformText` | string | 不支持该平台 | 不支持提示 |
+| `invalidLinkText` | string | 无效链接 | 无效链接提示 |
 | `parseErrorPrefix` | string | ❌ 解析失败： | 错误前缀 |
-| `parseErrorItemFormat` | string | `【${url}】: ${msg}` | 错误项格式 |
+| `parseErrorItemFormat` | string | ... | 错误格式 |
 
 ## 支持的变量 (Supported Variables)
 在 `unifiedMessageFormat` 中可使用以下变量，空行自动隐藏：
@@ -125,13 +130,19 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 | `${音乐标题}` | 音乐标题 |
 | `${音乐作者}` | 音乐作者 |
 
-## 音乐语音依赖说明 (Music Voice Dependencies)
-若启用 `showMusicVoice`，请确保已安装以下 Koishi 插件：
-- `koishi-plugin-silk`：提供 silk 编解码支持
-- `koishi-plugin-ffmpeg`：提供音频重采样支持
-
-这些依赖已声明为可选依赖
-若未安装，音乐语音将尝试直接发送原始音频，部分平台可能无法播放。
+## 依赖说明 (Dependencies)
+### 音乐语音（可选）
+若启用 `showMusicVoice`，请安装：
+- `koishi-plugin-silk`：silk 编解码
+- `koishi-plugin-ffmpeg`：音频重采样
+### aria2 下载引擎（可选）
+若启用 `downloadEngine: 'aria2'`，请安装并启动 aria2 服务，并安装 npm 包 `aria2`：
+- 安装 aria2 服务端：https://github.com/aria2/aria2
+- 安装 npm 客户端：`npm install aria2`
+- 启动 RPC：`aria2c --enable-rpc --rpc-listen-all=true --rpc-allow-origin-all`
+未满足条件时自动降级为内置下载，不影响正常使用。
+### downloads 服务（可选）
+插件会自动检测 Koishi 内置 `downloads` 服务，优先使用其下载文件，失败时回退到内置/aria2 下载。
 
 ## 支持的平台 (Supported Platforms)
 | 平台名称 | 关键词识别 | 解析能力 |
@@ -150,22 +161,19 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 | YouTube（油管） | youtube, youtu.be | 视频 |
 | TikTok（国际版抖音） | tiktok, tiktok.com | 短视频 |
 | 好看视频 | haokan, haokan.baidu.com | 短视频 |
-| 梨视频 | video.li | 短视频 |
 | 美拍 | meipai, meipai.com | 短视频 |
-| 全民直播 | quanmin (quanmin.tv) | 直播 |
 | Twitter / X | twitter, x.com | 视频、图文 |
 | Instagram | instagram, instagram.com | 图文、Reels |
 | 豆包 | doubao (doubao.com/video) | 视频 |
-| 豆包对话 | doubao (doubao.com/thread) | 对话分享 |
 | 皮皮搞笑 | pipigx, h5.pipigx.com | 短视频 |
 | 皮皮虾 | pipixia, h5.pipix.com | 短视频 |
 | 最右 | zuiyou, xiaochuankeji.cn | 短视频 |
+| 梨视频 | video.li, pearvideo.com | 短视频 |
+| 全民直播 | quanmin (quanmin.tv) | 直播 |
 | 绿洲 (Oasis) | oasis.weibo.com | 视频、图文 |
 | 视频号 (WeChat Channels) | channels.weixin.qq.com, weixin.qq.com/sph/ | 短视频 |
 | 🔧 自定义平台 | 通过 `customPlatforms` 添加 | 取决于 API |
 
-> 注：部分平台解析能力可能因API限制有所差异。可通过 `platformEnabled` 单独关闭。
-
 ## 项目贡献者 (Contributors)
 
 | 贡献者 (Contributor) | 贡献内容 (Contribution) |