koishi-plugin-video-parser-all 1.4.8 → 1.5.0

package/lib/index.d.ts

@@ -1,12 +1,4 @@
 import { Context, Schema } from 'koishi';
-declare module 'koishi' {
-    interface Context {
-        downloads?: {
-            download(url: string, dest: string, options?: Record<string, unknown>): Promise<string>;
-        };
-        aria2?: any;
-    }
-}
 export declare const name = "video-parser-all";
 export declare const Config: Schema<{
     enable?: boolean | null | undefined;
@@ -45,10 +37,17 @@ export declare const Config: Schema<{
 } & {
     showImageText?: boolean | null | undefined;
     showCoverImage?: boolean | null | undefined;
+    showCoverFile?: boolean | null | undefined;
+    showImageFileNew?: boolean | null | undefined;
+    showAuthorAvatar?: boolean | null | undefined;
+    showAuthorAvatarFile?: boolean | null | undefined;
+    showAuthorAvatarText?: boolean | null | undefined;
+    authorAvatarText?: string | null | undefined;
     showMusicCover?: boolean | null | undefined;
-    showImageFile?: boolean | null | undefined;
     showVideoFile?: boolean | null | undefined;
-    forceDownloadImage?: boolean | null | undefined;
+    forceDownloadCover?: boolean | null | undefined;
+    forceDownloadImageNew?: boolean | null | undefined;
+    forceDownloadAuthorAvatar?: boolean | null | undefined;
     forceDownloadVideo?: boolean | null | undefined;
 } & {
     showMusicVoice?: boolean | null | undefined;
@@ -190,10 +189,17 @@ export declare const Config: Schema<{
 } & {
     showImageText: boolean;
     showCoverImage: boolean;
+    showCoverFile: boolean;
+    showImageFileNew: boolean;
+    showAuthorAvatar: boolean;
+    showAuthorAvatarFile: boolean;
+    showAuthorAvatarText: boolean;
+    authorAvatarText: string;
     showMusicCover: boolean;
-    showImageFile: boolean;
     showVideoFile: boolean;
-    forceDownloadImage: boolean;
+    forceDownloadCover: boolean;
+    forceDownloadImageNew: boolean;
+    forceDownloadAuthorAvatar: boolean;
     forceDownloadVideo: boolean;
 } & {
     showMusicVoice: boolean;

package/lib/index.js

@@ -103,15 +103,22 @@ exports.Config = koishi_1.Schema.intersect([
         }).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('文字格式，支持变量，空行自动隐藏'),
+        unifiedMessageFormat: koishi_1.Schema.string().role('textarea').default('标题：${标题}\n作者：${作者}\n简介：${简介}\n音乐标题：${音乐标题}\n音乐作者：${音乐作者}\n点赞：${点赞数}\n收藏：${收藏数}\n转发：${转发数}\n播放：${播放数}\n评论：${评论数}\n图片数量：${图片数量}').description('文字格式，支持变量：${标题} ${作者} ${简介} ${视频时长} ${点赞数} ${收藏数} ${转发数} ${播放数} ${评论数} ${发布时间} ${图片数量} ${作者ID} ${音乐标题} ${音乐作者}，空行自动隐藏'),
     }).description('消息格式'),
     koishi_1.Schema.object({
         showImageText: koishi_1.Schema.boolean().default(true).description('发送文字内容'),
         showCoverImage: koishi_1.Schema.boolean().default(true).description('发送封面图片'),
+        showCoverFile: koishi_1.Schema.boolean().default(true).description('封面是否以图片形式发送（关闭则只发送链接）'),
+        showImageFileNew: koishi_1.Schema.boolean().default(true).description('图片是否以图片形式发送（关闭则只发送链接）'),
+        showAuthorAvatar: koishi_1.Schema.boolean().default(true).description('发送作者头像图片'),
+        showAuthorAvatarFile: koishi_1.Schema.boolean().default(true).description('作者头像图片是否以图片形式发送（关闭则只发送链接）'),
+        showAuthorAvatarText: koishi_1.Schema.boolean().default(true).description('发送作者头像前显示文字提示'),
+        authorAvatarText: koishi_1.Schema.string().default('作者头像：').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('强制下载封面/图片'),
+        forceDownloadCover: koishi_1.Schema.boolean().default(false).description('强制下载封面'),
+        forceDownloadImageNew: koishi_1.Schema.boolean().default(false).description('强制下载图片'),
+        forceDownloadAuthorAvatar: koishi_1.Schema.boolean().default(false).description('强制下载作者头像'),
         forceDownloadVideo: koishi_1.Schema.boolean().default(false).description('强制下载视频'),
     }).description('媒体发送'),
     koishi_1.Schema.object({
@@ -623,17 +630,6 @@ function parseApiResponse(raw, maxDescLen, fieldMapping) {
     const author_followers = parseCount(mapField('author_followers', () => extra.author_extra?.follower_count ?? data.author_extra?.follower_count ?? 0));
     const author_signature = String(mapField('author_signature', () => extra.author_extra?.signature ?? data.author_extra?.signature ?? ''));
     const admire = parseCount(mapField('admire', () => extra.statistics?.admire_count ?? data.statistics?.admire_count ?? 0));
-    let hashtags = '';
-    const tagsArray = mapField('hashtags', () => extra.hashtags ?? data.hashtags);
-    if (Array.isArray(tagsArray) && tagsArray.length > 0) {
-        const tagNames = tagsArray.map((t) => t?.name ? t.name : '').filter(Boolean);
-        hashtags = tagNames.map(name => `#${name}`).join(' ');
-        if (tagNames.length > 0 && desc) {
-            const escapedTags = tagNames.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
-            const tagRegex = new RegExp(`[#＃](${escapedTags.join('|')})\\b`, 'gi');
-            desc = desc.replace(tagRegex, '').replace(/\s{2,}/g, ' ').trim();
-        }
-    }
     title = title.replace(/\[话题\]/g, '');
     desc = desc.replace(/\[话题\]/g, '');
     if (title && desc && title.trim() === desc.trim()) {
@@ -643,7 +639,7 @@ function parseApiResponse(raw, maxDescLen, fieldMapping) {
         title = '';
     if (desc.trim().startsWith('#'))
         desc = '';
-    return { type, title, desc, author, uid, avatar, cover, video, videos, images, live_photo, music, like, comment, collect, share, play, duration, publishTime, author_followers, author_signature, admire, hashtags };
+    return { type, title, desc, author, uid, avatar, cover, video, videos, images, live_photo, music, like, comment, collect, share, play, duration, publishTime, author_followers, author_signature, admire };
 }
 const formatVarRegex = /\$\{([^}]+)\}/g;
 function generateFormattedText(p, format) {
@@ -651,8 +647,6 @@ function generateFormattedText(p, format) {
     const vars = {
         '标题': p.title,
         '作者': p.author,
-        '作者名称': p.author,
-        'author-name': p.author,
         '简介': p.desc,
         '视频时长': p.duration > 0 ? formatDuration(p.duration) : '',
         '点赞数': String(p.like),
@@ -663,22 +657,8 @@ function generateFormattedText(p, format) {
         '发布时间': p.publishTime ? formatPublishTime(p.publishTime) : '',
         '图片数量': String(imageCount),
         '作者ID': p.uid,
-        'author-id': p.uid,
-        '视频链接': p.video,
         '音乐标题': p.music.title || '',
-        'music-title': p.music.title || '',
         '音乐作者': p.music.author || '',
-        'music-author': p.music.author || '',
-        '音乐封面': p.music.cover || '',
-        'author-avatar': p.avatar,
-        '作者粉丝数': String(p.author_followers),
-        'author-followers': String(p.author_followers),
-        '作者签名': p.author_signature,
-        'author-signature': p.author_signature,
-        '赞赏数': String(p.admire),
-        'admire-count': String(p.admire),
-        '话题标签': p.hashtags,
-        'hashtags': p.hashtags,
     };
     const varReplacements = Object.entries(vars).map(([key, val]) => ({
         regex: new RegExp(`\\$\\{${key}\\}`, 'g'),
@@ -773,9 +753,14 @@ function apply(ctx, config) {
     const mediaDownloadTimeout = config.mediaDownloadTimeout ?? 120000;
     const maxMediaSize = config.maxMediaSize ?? 0;
     const downloadEngine = config.downloadEngine || 'internal';
-    if (downloadEngine === 'aria2' && !ctx.aria2) {
+    const aria2Service = ctx.get('aria2');
+    const downloadsService = ctx.get('downloads');
+    if (downloadEngine === 'aria2' && !aria2Service) {
         logger.warn('选择了 aria2 下载引擎，但未检测到 koishi-plugin-aria2-plus 服务，将回退到内置下载');
     }
+    if (downloadEngine === 'downloads' && !downloadsService) {
+        logger.warn('选择了 downloads 下载引擎，但未检测到 koishi-plugin-downloads 服务，将回退到内置下载');
+    }
     function getPlatformConfig(type) {
         if (type.startsWith('custom_')) {
             const name = type.slice(7);
@@ -853,9 +838,9 @@ function apply(ctx, config) {
         }) || fileExts[0];
         const fileName = `${filePrefix}_${Date.now()}_${(0, crypto_1.randomBytes)(4).toString('hex')}.${ext}`;
         const filePath = path_1.default.resolve(cacheDir, fileName);
-        if (downloadEngine === 'downloads' && ctx.downloads) {
+        if (downloadEngine === 'downloads' && downloadsService) {
             logger.info(`开始下载: ${url}`);
-            const dest = await ctx.downloads.download(url, path_1.default.join(cacheDir, fileName), {
+            const dest = await downloadsService.download(url, path_1.default.join(cacheDir, fileName), {
                 headers: { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36' },
                 timeout
             });
@@ -868,9 +853,9 @@ function apply(ctx, config) {
             }
             return dest;
         }
-        if (downloadEngine === 'aria2' && ctx.aria2) {
+        if (downloadEngine === 'aria2' && aria2Service) {
             try {
-                const gid = await ctx.aria2.addUri([url], {
+                const gid = await aria2Service.addUri([url], {
                     dir: cacheDir,
                     out: fileName,
                     split: 4,
@@ -887,10 +872,10 @@ function apply(ctx, config) {
                 let lastProgressTime = 0;
                 while (!completed) {
                     if (Date.now() - startTime > timeout) {
-                        await ctx.aria2.remove(gid).catch(() => { });
+                        await aria2Service.remove(gid).catch(() => { });
                         throw new Error('aria2下载超时');
                     }
-                    const status = await ctx.aria2.tellStatus(gid);
+                    const status = await aria2Service.tellStatus(gid);
                     if (status.status === 'complete') {
                         completed = true;
                         if (onProgress)
@@ -904,7 +889,7 @@ function apply(ctx, config) {
                             lastProgressTime = Date.now();
                             const total = parseInt(status.totalLength) || 0;
                             const completed = parseInt(status.completedLength) || 0;
-                            const percent = total > 0 ? Math.round((completed / total) * 100) : 0;
+                            const percent = total > 0 ? Math.round((completed / total) * 100) : -1;
                             const speed = formatSpeed(parseInt(status.downloadSpeed) || 0);
                             onProgress(percent, speed);
                         }
@@ -951,16 +936,27 @@ function apply(ctx, config) {
         let lastProgressTime = 0;
         response.data.on('data', (chunk) => {
             downloaded += chunk.length;
-            if (onProgress && contentLength > 0 && Date.now() - lastProgressTime > 500) {
+            if (onProgress && Date.now() - lastProgressTime > 500) {
                 lastProgressTime = Date.now();
-                const percent = Math.round((downloaded / contentLength) * 100);
-                onProgress(percent, '');
+                if (contentLength > 0) {
+                    const percent = Math.round((downloaded / contentLength) * 100);
+                    onProgress(percent, '');
+                }
+                else {
+                    onProgress(-1, formatSpeed(downloaded / ((Date.now() - lastProgressTime) / 1000)));
+                }
             }
         });
         try {
             await (0, promises_2.pipeline)(response.data, writer);
-            if (onProgress)
-                onProgress(100, '');
+            if (onProgress) {
+                if (contentLength > 0) {
+                    onProgress(100, '');
+                }
+                else {
+                    onProgress(-1, formatSpeed(downloaded / ((Date.now() - lastProgressTime) / 1000)));
+                }
+            }
             return filePath;
         }
         catch (e) {
@@ -994,8 +990,13 @@ function apply(ctx, config) {
             const prefixMap = { image: 'img', video: 'video', audio: 'music' };
             const sendFunc = type === 'audio' ? koishi_1.h.audio : type === 'video' ? koishi_1.h.video : koishi_1.h.image;
             const onProgress = forceDownload ? (percent, speed) => {
-                const text = `下载进度: ${percent}%` + (speed ? ` (${speed})` : '');
-                logger.info(text);
+                if (percent === -1) {
+                    logger.info(`下载进度: 已下载 ${speed}`);
+                }
+                else {
+                    const text = `下载进度: ${percent}%` + (speed ? ` (${speed})` : '');
+                    logger.info(text);
+                }
             } : undefined;
             if (forceDownload) {
                 try {
@@ -1107,6 +1108,11 @@ function apply(ctx, config) {
                 const text = item.text;
                 if (text && config.showImageText)
                     forwardMessages.push(buildForwardNode(session, text, botName));
+                if (config.showAuthorAvatar && p.avatar) {
+                    if (config.showAuthorAvatarText)
+                        forwardMessages.push(buildForwardNode(session, config.authorAvatarText || '作者头像：', botName));
+                    forwardMessages.push(buildForwardNode(session, koishi_1.h.image(p.avatar), botName));
+                }
                 if (p.cover && config.showCoverImage && p.type !== 'live_photo' && p.type !== 'image' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
                     forwardMessages.push(buildForwardNode(session, koishi_1.h.image(p.cover), botName));
                 }
@@ -1145,12 +1151,18 @@ function apply(ctx, config) {
                     await sendWithTimeout(session, text);
                     await delay(300);
                 }
+                if (config.showAuthorAvatar && p.avatar) {
+                    if (config.showAuthorAvatarText)
+                        await sendWithTimeout(session, config.authorAvatarText || '作者头像：');
+                    await sendMedia(session, p.avatar, 'image', config.forceDownloadAuthorAvatar, config.showAuthorAvatarFile).catch(() => { });
+                    await delay(300);
+                }
                 if (p.cover && config.showCoverImage && p.type !== 'live_photo' && p.type !== 'image' && !(p.type === 'live' && (p.live_photo?.length || p.images?.length))) {
-                    await sendMedia(session, p.cover, 'image', config.forceDownloadImage, config.showImageFile).catch(() => { });
+                    await sendMedia(session, p.cover, 'image', config.forceDownloadCover, config.showCoverFile).catch(() => { });
                     await delay(300);
                 }
                 if (config.showMusicCover && p.music.cover) {
-                    await sendMedia(session, p.music.cover, 'image', config.forceDownloadImage, config.showImageFile).catch(() => { });
+                    await sendMedia(session, p.music.cover, 'image', false, true).catch(() => { });
                     await delay(300);
                 }
                 if (p.video && (p.type === 'video' || (p.type === 'live' && !p.live_photo?.length && !p.images?.length))) {
@@ -1160,7 +1172,7 @@ function apply(ctx, config) {
                 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).catch(() => { });
+                        await sendMedia(session, imgUrl, 'image', config.forceDownloadImageNew, config.showImageFileNew).catch(() => { });
                         await delay(200);
                     }
                 }

package/package.json

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

package/readme.md

@@ -20,176 +20,189 @@ This is a **multi-platform video/image parsing plugin** developed for the Koishi
 
 ## 配置项说明 (Configuration)
 
-### 基本设置
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `enable` | boolean | true | 启用插件 |
-| `botName` | string | 视频解析机器人 | 合并转发中的昵称 |
-| `showWaitingTip` | boolean | true | 显示等待提示 |
-| `debug` | boolean | false | Debug 日志 |
-| `platformEnabled` | object | 全开 | 各平台开关 |
-
-### 消息格式
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `unifiedMessageFormat` | string | 见预设 | 文字格式，支持变量，空行自动隐藏 |
-
-### 媒体发送
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `showImageText` | boolean | true | 发送文字内容 |
-| `showCoverImage` | boolean | true | 发送封面图片 |
-| `showMusicCover` | boolean | true | 发送音乐封面 |
-| `showImageFile` | boolean | true | 封面/图片是否以图片形式发送（关闭则只发送链接） |
-| `showVideoFile` | boolean | true | 视频是否以视频形式发送（关闭则只发送链接） |
-| `forceDownloadImage` | boolean | false | 强制下载封面/图片 |
-| `forceDownloadVideo` | boolean | false | 强制下载视频 |
-
-### 音乐语音（需 silk 和 ffmpeg）
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `showMusicVoice` | boolean | false | 音乐链接以语音发送 |
-| `showMusicVoiceFile` | boolean | true | 音乐链接是否以语音形式发送（关闭则只发送链接） |
-| `forceDownloadMusicVoice` | boolean | false | 强制下载音乐语音 |
-
-### 性能与限制
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `maxDescLength` | number | 200 | 简介长度上限 |
-| `maxConcurrent` | number | 3 | 解析最大并发数 |
-| `downloadConcurrency` | number | 3 | 下载线程数 |
-| `mediaDownloadTimeout` | number | 120000 | 统一下载超时 (ms) |
-| `maxMediaSize` | number | 0 | 最大下载文件大小 (MB)，0 为不限制 |
-| `downloadEngine` | string | internal | 下载引擎（internal / aria2 / downloads） |
-
-### 网络与请求
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `timeout` | number | 180000 | API 超时 (ms) |
-| `videoSendTimeout` | number | 180000 | 发送超时 (ms) |
+### 基本设置 (Basic Settings)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `enable` | boolean | true | 启用插件 (Enable plugin) |
+| `botName` | string | 视频解析机器人 | 合并转发中的昵称 (Nickname in forward messages) |
+| `showWaitingTip` | boolean | true | 显示等待提示 (Show waiting tip) |
+| `debug` | boolean | false | Debug 日志 (Debug logging) |
+| `platformEnabled` | object | 全开 (All enabled) | 各平台开关 (Platform switches) |
+
+### 消息格式 (Message Format)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `unifiedMessageFormat` | string | 见预设 (See preset) | 文字格式，支持变量，空行自动隐藏 (Text format, supports variables, auto-hide empty lines) |
+
+### 媒体发送 (Media Sending)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `showImageText` | boolean | true | 发送文字内容 (Send text content) |
+| `showCoverImage` | boolean | true | 发送封面图片 (Send cover image) |
+| `showCoverFile` | boolean | true | 封面是否以图片形式发送（关闭则只发送链接）(Send cover as image, otherwise link only) |
+| `showImageFileNew` | boolean | true | 图片是否以图片形式发送（关闭则只发送链接）(Send images as image, otherwise link only) |
+| `showAuthorAvatar` | boolean | true | 发送作者头像图片 (Send author avatar image) |
+| `showAuthorAvatarFile` | boolean | true | 作者头像图片是否以图片形式发送（关闭则只发送链接）(Send author avatar as image, otherwise link only) |
+| `showAuthorAvatarText` | boolean | true | 发送作者头像前显示文字提示 (Show text hint before author avatar) |
+| `authorAvatarText` | string | 作者头像： | 作者头像前显示的文字 (Text displayed before author avatar) |
+| `showMusicCover` | boolean | true | 发送音乐封面图片 (Send music cover image) |
+| `showVideoFile` | boolean | true | 视频是否以视频形式发送（关闭则只发送链接）(Send video as file, otherwise link only) |
+| `forceDownloadCover` | boolean | false | 强制下载封面 (Force download cover) |
+| `forceDownloadImageNew` | boolean | false | 强制下载图片 (Force download images) |
+| `forceDownloadAuthorAvatar` | boolean | false | 强制下载作者头像 (Force download author avatar) |
+| `forceDownloadVideo` | boolean | false | 强制下载视频 (Force download video) |
+
+### 音乐语音（需 silk 和 ffmpeg）(Music Voice - requires silk & ffmpeg)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `showMusicVoice` | boolean | false | 音乐链接以语音发送 (Send music as voice) |
+| `showMusicVoiceFile` | boolean | true | 音乐链接是否以语音形式发送（关闭则只发送链接）(Send as voice file, otherwise link only) |
+| `forceDownloadMusicVoice` | boolean | false | 强制下载音乐语音 (Force download music voice) |
+
+### 性能与限制 (Performance & Limits)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `maxDescLength` | number | 200 | 简介长度上限 (Max description length) |
+| `maxConcurrent` | number | 3 | 解析最大并发数 (Max concurrent parsing) |
+| `downloadConcurrency` | number | 3 | 下载线程数 (Download concurrency) |
+| `mediaDownloadTimeout` | number | 120000 | 统一下载超时 (ms) (Download timeout) |
+| `maxMediaSize` | number | 0 | 最大下载文件大小 (MB)，0 为不限制 (Max file size, 0 = unlimited) |
+| `downloadEngine` | string | internal | 下载引擎（internal / aria2 / downloads）(Download engine) |
+
+### 网络与请求 (Network & Request)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `timeout` | number | 180000 | API 超时 (ms) (API timeout) |
+| `videoSendTimeout` | number | 180000 | 发送超时 (ms) (Send timeout) |
 | `userAgent` | string | 见预设 | User-Agent |
-| `proxy` | object | ... | HTTP/HTTPS 代理 |
-| `customHeaders` | array | [] | 自定义请求头 |
-
-### 发送与重试
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `ignoreSendError` | boolean | true | 忽略发送失败 |
-| `retryTimes` | number | 3 | 重试次数 |
-| `retryInterval` | number | 1000 | 重试间隔 (ms) |
-| `enableForward` | boolean | false | 合并转发（OneBot/Satori） |
-
-### 缓存与临时文件
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `deduplicationInterval` | number | 180 | 去重间隔 (s) |
-| `cacheTTL` | number | 600 | 缓存时间 (s) |
-| `cacheDir` | string | ./temp_cache | 统一临时目录 |
-
-### API 与平台
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `platformDedicatedFirst` | object | 全关 | 优先专属 API |
-| `customApis` | array | [] | 覆盖内置平台 API |
-| `customPlatforms` | array | [] | 自定义新平台 |
-| `globalFieldMapping` | string | 预设 | 全局字段映射 JSON |
-
-### 界面文本
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| `waitingTipText` | string | 正在解析... | 等待提示 |
-| `unsupportedPlatformText` | string | 不支持该平台 | 不支持提示 |
-| `invalidLinkText` | string | 无效链接 | 无效链接提示 |
-| `parseErrorPrefix` | string | ❌ 解析失败： | 错误前缀 |
-| `parseErrorItemFormat` | string | ... | 错误格式 |
+| `proxy` | object | ... | HTTP/HTTPS 代理 (Proxy) |
+| `customHeaders` | array | [] | 自定义请求头 (Custom headers) |
+
+### 发送与重试 (Send & Retry)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `ignoreSendError` | boolean | true | 忽略发送失败 (Ignore send errors) |
+| `retryTimes` | number | 3 | 重试次数 (Retry times) |
+| `retryInterval` | number | 1000 | 重试间隔 (ms) (Retry interval) |
+| `enableForward` | boolean | false | 合并转发（OneBot/Satori）(Enable forward message) |
+
+### 缓存与临时文件 (Cache & Temp Files)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `deduplicationInterval` | number | 180 | 去重间隔 (s) (Deduplication interval) |
+| `cacheTTL` | number | 600 | 缓存时间 (s) (Cache TTL) |
+| `cacheDir` | string | ./temp_cache | 统一临时目录 (Temp directory) |
+
+### API 与平台 (API & Platforms)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `platformDedicatedFirst` | object | 全关 (All off) | 优先专属 API (Prioritize dedicated APIs) |
+| `customApis` | array | [] | 覆盖内置平台 API (Override built-in APIs) |
+| `customPlatforms` | array | [] | 自定义新平台 (Custom platforms) |
+| `globalFieldMapping` | string | 预设 (Preset) | 全局字段映射 JSON (Global field mapping JSON) |
+
+### 界面文本 (UI Text)
+| 配置项 (Config) | 类型 (Type) | 默认值 (Default) | 说明 (Description) |
+|----------------|-------------|-------------------|---------------------|
+| `waitingTipText` | string | 正在解析... | 等待提示 (Waiting tip) |
+| `unsupportedPlatformText` | string | 不支持该平台 | 不支持提示 (Unsupported platform tip) |
+| `invalidLinkText` | string | 无效链接 | 无效链接提示 (Invalid link tip) |
+| `parseErrorPrefix` | string | ❌ 解析失败： | 错误前缀 (Error prefix) |
+| `parseErrorItemFormat` | string | ... | 错误格式 (Error format) |
 
 ## 支持的变量 (Supported Variables)
-在 `unifiedMessageFormat` 中可使用以下变量，空行自动隐藏：
-
-| 变量名 | 说明 |
-|--------|------|
-| `${标题}` | 视频/图集标题 |
-| `${作者}` | 作者名称 |
-| `${简介}` | 内容简介 |
-| `${视频时长}` | 视频时长（时:分:秒） |
-| `${点赞数}` | 点赞数量 |
-| `${收藏数}` | 收藏数量 |
-| `${转发数}` | 转发/分享数量 |
-| `${播放数}` | 播放量 |
-| `${评论数}` | 评论数量 |
-| `${发布时间}` | 发布时间（格式化） |
-| `${图片数量}` | 图集/实况图片数量 |
-| `${作者ID}` | 作者唯一标识ID |
-| `${视频链接}` | 视频原始链接 |
-| `${音乐标题}` | 音乐标题 |
-| `${音乐作者}` | 音乐作者 |
+在 `unifiedMessageFormat` 中可使用以下变量，空行自动隐藏。  
+The following variables can be used in `unifiedMessageFormat`, empty lines are auto-hidden.
+
+| 变量 (Variable) | 说明 (Description) |
+|----------------|--------------------|
+| `${标题}` | 视频/图集标题 (Title) |
+| `${作者}` | 作者名称 (Author name) |
+| `${简介}` | 内容简介 (Description) |
+| `${视频时长}` | 视频时长（时:分:秒）(Duration, hh:mm:ss) |
+| `${点赞数}` | 点赞数量 (Like count) |
+| `${收藏数}` | 收藏数量 (Favorite count) |
+| `${转发数}` | 转发/分享数量 (Share count) |
+| `${播放数}` | 播放量 (Play count) |
+| `${评论数}` | 评论数量 (Comment count) |
+| `${发布时间}` | 发布时间（格式化）(Publish time, formatted) |
+| `${图片数量}` | 图集/实况图片数量 (Image count) |
+| `${作者ID}` | 作者唯一标识ID (Author ID) |
+| `${音乐标题}` | 音乐标题 (Music title) |
+| `${音乐作者}` | 音乐作者 (Music author) |
 
 ## 依赖说明 (Dependencies)
-### 音乐语音（可选）
-若启用 `showMusicVoice`，请安装：
-- `koishi-plugin-silk`：silk 编解码
-- `koishi-plugin-ffmpeg`：音频重采样
-### aria2 下载引擎（可选）
-若启用 `downloadEngine: 'aria2'`，请安装可选依赖 `koishi-plugin-aria2-plus` 并配置该插件连接 aria2 服务。插件启动时会自动检测该服务，未安装或不可用时将降级为内置下载，不影响正常使用。
-### downloads 服务（可选）
-若启用 `downloadEngine: 'downloads'`，请安装可选依赖 `koishi-plugin-downloads`，失败时回退到内置下载。
+### 音乐语音（可选）(Music Voice - Optional)
+若启用 `showMusicVoice`，请安装：  
+If you enable `showMusicVoice`, please install:  
+- `koishi-plugin-silk`：silk 编解码 (Silk codec)  
+- `koishi-plugin-ffmpeg`：音频重采样 (Audio resampling)  
+
+### aria2 下载引擎（可选）(aria2 Download Engine - Optional)
+若启用 `downloadEngine: 'aria2'`，请安装可选依赖 `koishi-plugin-aria2-plus` 并配置该插件连接 aria2 服务。插件启动时会自动检测该服务，未安装或不可用时将降级为内置下载，不影响正常使用。  
+If you use `downloadEngine: 'aria2'`, please install the optional dependency `koishi-plugin-aria2-plus` and configure it to connect to an aria2 service. The plugin will auto-detect it; if not available, it will fall back to the built-in downloader without affecting normal usage.
+
+### downloads 服务（可选）(Downloads Service - Optional)
+若启用 `downloadEngine: 'downloads'`，请安装可选依赖 `koishi-plugin-downloads`，失败时回退到内置下载。  
+If you use `downloadEngine: 'downloads'`, please install the optional dependency `koishi-plugin-downloads`. It will fall back to the built-in downloader on failure.
 
 ## 支持的平台 (Supported Platforms)
 
-> 以下为插件内置链接匹配规则，可根据用户发送的链接自动识别。所有匹配规则同时支持 HTTP 和 HTTPS 协议，并兼容多级路径（如短链后带 `/` 子路径）。
-
-| 平台名称 | 关键词识别（匹配的域名/路径模式） | 解析能力 |
-|----------|----------------------------------|----------|
-| 哔哩哔哩 (B站) | `bilibili.com/video/`, `b23.tv`, `bili*.cn`, `b23.wtf`, `bili2233.cn` | 视频 |
-| 抖音 | `douyin.com/video/`, `v.douyin.com` | 短视频、图集、实况 |
-| 快手 | `kuaishou.com/short-video/`, `v.kuaishou.com`, `kuaishou.com/f/` | 短视频、图集 |
-| 小红书 | `xiaohongshu.com/discovery/item/`, `xhslink.com`（含多级路径）, `xiaohongshu.com/explore/`, `xiaohongshu.com/board/` | 图文、视频 |
-| 微博 | `weibo.com/数字/`, `video.weibo.com/show`, `t.cn`, `m.weibo.cn` | 视频、图集 |
-| 西瓜视频 | `ixigua.com` | 短视频 |
-| YouTube | `youtube.com/watch`, `youtu.be`, `youtube.com/shorts/` | 视频 |
-| TikTok | `tiktok.com/@/video/`, `vm.tiktok.com`, `vt.tiktok.com` | 短视频 |
-| AcFun（A站） | `acfun.cn/v/ac` | 视频 |
-| 知乎 | `zhihu.com/video/`, `zhihu.com/question/xxx/answer/xxx`, `zhuanlan.zhihu.com/p/`, `zhihu.com/zvideo/` | 视频、回答中的视频 |
-| 微视 | `weishi.qq.com/weishi/feed/` | 短视频 |
-| 虎牙 | `huya.com/video/` | 直播回放、视频 |
-| 好看视频 | `haokan.baidu.com/v?vid=` | 短视频 |
-| 美拍 | `meipai.com/media/` | 短视频 |
-| Twitter / X | `twitter.com/用户名/status/`, `x.com/用户名/status/` | 视频、图文 |
-| Instagram | `instagram.com/p/`, `instagram.com/reel/`, `instagram.com/share/` | 图文、Reels |
-| 豆包（视频） | `doubao.com/video/`, `doubao.com/video-sharing` | 视频 |
-| 豆包（图集） | `doubao.com/thread/` | 图文 |
-| **即梦 (Jimeng)** | `jimeng.jianying.com`, `jimeng.cn`, `dreamina.jianying.com`, `dreamina.capcut.com` | AI视频、AI图片 |
-| 绿洲 (Oasis) | `oasis.weibo.com/v/` | 视频、图文 |
-| 视频号 (WeChat Channels) | `channels.weixin.qq.com`, `weixin.qq.com/sph/` | 短视频 |
-| 梨视频 | `pearvideo.com/video_`, `video.li` | 短视频 |
-| 全民直播 | `quanmin.tv`, `quanmintv.cn` | 直播 |
-| 皮皮搞笑 | `h5.pipigx.com/pp/post/`, `ippzone.com` | 短视频 |
-| 皮皮虾 | `pipix.com`, `pipixia.com` | 短视频 |
-| 最右 | `share.xiaochuankeji.cn/hybrid/share/post`, `izuiyou.com` | 短视频 |
-| 🔧 自定义平台 | 通过 `customPlatforms` 配置添加 | 取决于提供的 API |
+> 以下为插件内置链接匹配规则，可根据用户发送的链接自动识别。所有匹配规则同时支持 HTTP 和 HTTPS 协议，并兼容多级路径（如短链后带 `/` 子路径）。  
+> The following are the built-in link matching rules, which can automatically identify links sent by users. All rules support both HTTP and HTTPS, and are compatible with multi-level paths (e.g., short links followed by `/` subpaths).
+
+| 平台名称 (Platform) | 关键词识别（匹配的域名/路径模式）(Keyword/Domain Patterns) | 解析能力 (Supported Content) |
+|---------------------|--------------------------------------------------------------|------------------------------|
+| 哔哩哔哩 (B站) Bilibili | `bilibili.com/video/`, `b23.tv`, `bili*.cn`, `b23.wtf`, `bili2233.cn` | 视频 (Video) |
+| 抖音 Douyin | `douyin.com/video/`, `v.douyin.com` | 短视频、图集、实况 (Short video, Image, Live photo) |
+| 快手 Kuaishou | `kuaishou.com/short-video/`, `v.kuaishou.com`, `kuaishou.com/f/` | 短视频、图集 (Short video, Image) |
+| 小红书 Xiaohongshu | `xiaohongshu.com/discovery/item/`, `xhslink.com`, `xiaohongshu.com/explore/`, `xiaohongshu.com/board/` | 图文、视频 (Image, Video) |
+| 微博 Weibo | `weibo.com/数字/`, `video.weibo.com/show`, `t.cn`, `m.weibo.cn` | 视频、图集 (Video, Image) |
+| 西瓜视频 Xigua | `ixigua.com` | 短视频 (Short video) |
+| YouTube | `youtube.com/watch`, `youtu.be`, `youtube.com/shorts/` | 视频 (Video) |
+| TikTok | `tiktok.com/@/video/`, `vm.tiktok.com`, `vt.tiktok.com` | 短视频 (Short video) |
+| AcFun（A站） | `acfun.cn/v/ac` | 视频 (Video) |
+| 知乎 Zhihu | `zhihu.com/video/`, `zhihu.com/question/xxx/answer/xxx`, `zhuanlan.zhihu.com/p/`, `zhihu.com/zvideo/` | 视频、回答中的视频 (Video, answer video) |
+| 微视 Weishi | `weishi.qq.com/weishi/feed/` | 短视频 (Short video) |
+| 虎牙 Huya | `huya.com/video/` | 直播回放、视频 (Live replay, Video) |
+| 好看视频 Haokan | `haokan.baidu.com/v?vid=` | 短视频 (Short video) |
+| 美拍 Meipai | `meipai.com/media/` | 短视频 (Short video) |
+| Twitter / X | `twitter.com/用户名/status/`, `x.com/用户名/status/` | 视频、图文 (Video, Image) |
+| Instagram | `instagram.com/p/`, `instagram.com/reel/`, `instagram.com/share/` | 图文、Reels (Image, Reels) |
+| 豆包（视频）Doubao Video | `doubao.com/video/`, `doubao.com/video-sharing` | 视频 (Video) |
+| 豆包（图集）Doubao Image | `doubao.com/thread/` | 图文 (Image) |
+| **即梦 (Jimeng)** | `jimeng.jianying.com`, `jimeng.cn`, `dreamina.jianying.com`, `dreamina.capcut.com` | AI视频、AI图片 (AI video, AI image) |
+| 绿洲 Oasis | `oasis.weibo.com/v/` | 视频、图文 (Video, Image) |
+| 视频号 WeChat Channels | `channels.weixin.qq.com`, `weixin.qq.com/sph/` | 短视频 (Short video) |
+| 梨视频 Lishi | `pearvideo.com/video_`, `video.li` | 短视频 (Short video) |
+| 全民直播 Quanmin | `quanmin.tv`, `quanmintv.cn` | 直播 (Live) |
+| 皮皮搞笑 Pipigx | `h5.pipigx.com/pp/post/`, `ippzone.com` | 短视频 (Short video) |
+| 皮皮虾 Pipixia | `pipix.com`, `pipixia.com` | 短视频 (Short video) |
+| 最右 Zuiyou | `share.xiaochuankeji.cn/hybrid/share/post`, `izuiyou.com` | 短视频 (Short video) |
+| 自定义平台 Custom | 通过 `customPlatforms` 配置添加 (Add via `customPlatforms`) | 取决于提供的 API (Depends on API) |
 
 ## 项目贡献者 (Contributors)
 
 | 贡献者 (Contributor) | 贡献内容 (Contribution) |
 |----------------------|-------------------------|
 | Minecraft-1314 | 插件完整开发 (Complete plugin development) |
-| ShiraiKuroko003 | 修复消息格式设置问题并且PR-1.2.5版本已修复 |
-| cyavb | 提交功能建议-给自定义API添加KEY认证-已修复 |
-| Keep785 | 提交Bug-无法正常关闭发送封面-已修复<br>提交Bug-解析问题-已修复 |
-| dzt2008 + Apricityx | 提交Bug-会对非支持视频平台URL进行误解析-已修复 |
-| JH-Ahua | BugPk-Api 支持 |
-| shangxue | 灵感来源 |
+| ShiraiKuroko003 | 修复消息格式设置问题并且PR-1.2.5版本已修复 (Fixed message format issue, PR-1.2.5) |
+| cyavb | 提交功能建议-给自定义API添加KEY认证-已修复 (Suggested custom API key auth - fixed) |
+| Keep785 | 提交Bug-无法正常关闭发送封面-已修复<br>提交Bug-解析问题-已修复 (Reported bugs - cannot disable cover sending and parsing issues - fixed) |
+| dzt2008 + Apricityx | 提交Bug-会对非支持视频平台URL进行误解析-已修复 (Reported incorrect parsing of unsupported URLs - fixed) |
+| linyves | 提交Bug-小红书图集重复发送封面-已修复<br>提交Bug-话题显示异常 #**[话题]#-已修复<br>提交建议-Live Photo 全部按普通图片处理-已采纳<br>提交Bug-解析后会把作者头像一起发送-已修复 |
+| JH-Ahua | BugPk-Api 支持 (BugPk-Api support) |
+| shangxue | 灵感来源 (Inspiration) |
 
-（欢迎通过 Issues 或 PR 加入贡献者列表）
+（欢迎通过 Issues 或 PR 加入贡献者列表）  
+(Welcome to join the contributor list via Issues or PR)
 
 ## 许可协议 (License)
 
-本项目采用 MIT 许可证，详情参见 [LICENSE](LICENSE) 文件。
-
+本项目采用 MIT 许可证，详情参见 [LICENSE](LICENSE) 文件。  
 This project is licensed under the MIT License, see the [LICENSE](LICENSE) file for details.
 
 ## 支持我们 (Support Us)
 
-如果这个项目对您有帮助，欢迎点亮右上角的 Star ⭐ 支持我们！
-
+如果这个项目对您有帮助，欢迎点亮右上角的 Star ⭐ 支持我们！  
 If this project is helpful to you, please feel free to star it in the upper right corner ⭐ to support us!