koishi-plugin-xhs-parser 0.1.2 → 0.1.4

package/README.md

@@ -9,6 +9,7 @@
 - 解析 `https://xhslink.com/...`，例如 `http://xhslink.com/m/AixEkyLwpfs`
 - 从 Koishi 卡片元素的 `data` 字段、转义 JSON、普通文本中提取小红书链接
 - 支持图片、视频链接、原文链接和基础互动数据返回
+- 支持视频直链发送，或先下载首个视频后以 Buffer / base64 / file URL 模式发送
 - 支持 OneBot / Red 适配器的合并转发元素
 
 ## 本地测试
@@ -33,4 +34,30 @@ npm run dev -- "http://xhslink.com/m/AixEkyLwpfs"
 plugins:
   /absolute/path/to/xhs-parser/lib:
     enabled: true
-```
+```
+
+常用视频发送配置：
+
+```yaml
+plugins:
+  /absolute/path/to/xhs-parser/lib:
+    enabled: true
+    showVideo: true
+    downloadVideoAsFile: false
+    videoDownloadMode: buffer
+    maxDownloadedVideoSizeMB: 20
+    maxVideoSendSizeMB: 100
+```
+
+说明：
+
+- `downloadVideoAsFile: false`：默认行为，不下载视频，直接发送小红书视频直链。
+- `downloadVideoAsFile: true`：先用 Koishi 的 `ctx.http.file()` 下载首个视频，下载失败会自动回退直链。
+- `videoDownloadMode: buffer`：以二进制 Buffer 传给 `h.video()`，通常最推荐。
+- `videoDownloadMode: base64`：转换成 `base64://...` 发送，适合部分 OneBot 实现。
+- `videoDownloadMode: file`：写入系统临时目录并以 `file://` URL 发送，适合部分 Napcat / 本地网关场景。
+- `maxDownloadedVideoSizeMB: 20`：下载后的视频超过该大小时，自动回退为发送小红书视频直链，避免大视频转 base64 时超过 Node 字符串长度限制。设为 `0` 表示不限制。
+- `maxVideoSendSizeMB: 100`：视频超过该大小时不发送视频，包括直链。设为 `0` 表示不限制。
+- `loggerinfo: true`：输出视频下载开始、下载结果、大小阈值判断、发送模式和失败原因等调试日志。
+
+下载模式只处理每个笔记的首个视频，避免一次消息消耗过多带宽。

package/lib/index.d.ts

@@ -18,6 +18,10 @@ export interface Config {
     maxDescLength: number;
     descTruncateSuffix: string;
     showVideo: boolean;
+    downloadVideoAsFile: boolean;
+    videoDownloadMode: 'buffer' | 'file' | 'base64';
+    maxDownloadedVideoSizeMB: number;
+    maxVideoSendSizeMB: number;
     showStats: boolean;
     showLink: boolean;
     showError: boolean;

package/lib/index.js

@@ -1,11 +1,19 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.usage = exports.Config = exports.name = void 0;
 exports.apply = apply;
 const koishi_1 = require("koishi");
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = __importDefault(require("node:url"));
+const node_fs_1 = require("node:fs");
 const parser_1 = require("./parser");
 exports.name = 'xhs-parser';
 const logger = new koishi_1.Logger(exports.name);
+const VIDEO_TOO_LARGE_MESSAGE = '[视频文件过大，跳过解析]';
 exports.Config = koishi_1.Schema.intersect([
     koishi_1.Schema.object({
         enabled: koishi_1.Schema.boolean().default(true).description('开启小红书链接/卡片解析。'),
@@ -39,6 +47,14 @@ exports.Config = koishi_1.Schema.intersect([
         maxDescLength: koishi_1.Schema.number().min(0).max(2000).step(10).default(160).description('描述最大字数。设为 0 时不展示描述。'),
         descTruncateSuffix: koishi_1.Schema.string().default('...(已截断)').description('描述超出最大字数时追加的截断标志。'),
         showVideo: koishi_1.Schema.boolean().default(true).description('返回视频元素。'),
+        downloadVideoAsFile: koishi_1.Schema.boolean().default(false).description('尝试先下载首个视频再发送，缓解 QQ / OneBot 等平台直链“资源已过期”的问题。会增加带宽消耗。'),
+        videoDownloadMode: koishi_1.Schema.union([
+            koishi_1.Schema.const('buffer').description('使用二进制 Buffer 方式发送视频（推荐）'),
+            koishi_1.Schema.const('base64').description('使用 base64:// 段发送视频（OneBot 常用格式，buffer 失败时可尝试）'),
+            koishi_1.Schema.const('file').description('写入临时文件并通过 file:// URL 发送（Napcat 等特殊环境）'),
+        ]).default('buffer').description('下载视频后的发送方式。'),
+        maxDownloadedVideoSizeMB: koishi_1.Schema.number().min(0).max(2048).step(1).default(20).description('下载视频大小上限，单位 MB。超过后自动回退为发送视频直链；设为 0 表示不限制。'),
+        maxVideoSendSizeMB: koishi_1.Schema.number().min(0).max(2048).step(1).default(100).description('视频发送大小上限，单位 MB。超过后不发送视频，包括直链；设为 0 表示不限制。'),
         showStats: koishi_1.Schema.boolean().default(true).description('展示点赞、收藏、评论、分享数据。'),
         showLink: koishi_1.Schema.boolean().default(true).description('展示原文链接。'),
     }).description('内容设置'),
@@ -76,13 +92,13 @@ function apply(ctx, config) {
         const targets = links.filter((link) => shouldProcess(recent, session.channelId || session.guildId || 'private', link, config.minimumInterval));
         if (!targets.length)
             return next();
-        handleLinks(session, targets, config).catch((error) => {
+        handleLinks(ctx, session, targets, config).catch((error) => {
             logger.warn(error);
         });
         return next();
     }, config.middleware);
 }
-async function handleLinks(session, links, config) {
+async function handleLinks(ctx, session, links, config) {
     let waitTipMessageId;
     if (config.waitTip) {
         const result = await session.send(`${koishi_1.h.quote(session.messageId)}${config.waitTip}`);
@@ -93,7 +109,7 @@ async function handleLinks(session, links, config) {
         for (const link of links) {
             if (config.loggerinfo)
                 logger.info(`parse ${link}`);
-            const note = await (0, parser_1.fetchXhsNote)(link, config);
+            const note = await prepareNoteVideo(ctx, await (0, parser_1.fetchXhsNote)(link, config), config);
             allMessages.push(...(0, parser_1.buildXhsMessages)(note, config, session));
         }
         if (!allMessages.length)
@@ -122,6 +138,167 @@ async function handleLinks(session, links, config) {
         }
     }
 }
+async function prepareNoteVideo(ctx, note, config) {
+    if (!config.showVideo) {
+        if (config.loggerinfo) {
+            logger.info('skip video: showVideo=false');
+        }
+        return note;
+    }
+    const firstVideo = note.videoUrls[0];
+    if (!firstVideo) {
+        if (config.loggerinfo)
+            logger.info('skip video download: no video URL found');
+        return note;
+    }
+    if (!/^https?:\/\//i.test(firstVideo)) {
+        if (config.loggerinfo)
+            logger.info(`skip video download: unsupported video URL protocol (${firstVideo})`);
+        return note;
+    }
+    const maxSendSizeBytes = getSizeLimitBytes(config.maxVideoSendSizeMB, 100);
+    const remoteSize = await getRemoteVideoSize(ctx, firstVideo, config);
+    if (remoteSize !== undefined && maxSendSizeBytes && remoteSize > maxSendSizeBytes) {
+        if (config.loggerinfo) {
+            logger.info(`skip video send: remote size=${formatBytes(remoteSize)}, max=${formatBytes(maxSendSizeBytes)}, url=${firstVideo}`);
+        }
+        return removeNoteVideos(note);
+    }
+    if (!config.downloadVideoAsFile) {
+        if (config.loggerinfo) {
+            logger.info('skip video download: downloadVideoAsFile=false, use direct URL');
+        }
+        return note;
+    }
+    try {
+        if (config.loggerinfo) {
+            logger.info(`download first video start: url=${firstVideo}`);
+        }
+        const file = await ctx.http.file(firstVideo);
+        if (!file?.data) {
+            if (config.loggerinfo)
+                logger.info('download video failed: empty response data');
+            return note;
+        }
+        const buffer = Buffer.from(file.data);
+        const mimeType = file.type || file.mime || 'video/mp4';
+        const mode = config.videoDownloadMode || 'buffer';
+        const maxSizeBytes = config.maxDownloadedVideoSizeMB > 0
+            ? config.maxDownloadedVideoSizeMB * 1024 * 1024
+            : 0;
+        if (config.loggerinfo) {
+            logger.info(`download first video success: size=${formatBytes(buffer.length)}, mime=${mimeType}, mode=${mode}, max=${maxSizeBytes ? formatBytes(maxSizeBytes) : 'unlimited'}`);
+        }
+        if (maxSendSizeBytes && buffer.length > maxSendSizeBytes) {
+            if (config.loggerinfo) {
+                logger.info(`skip video send: downloaded size=${formatBytes(buffer.length)}, max=${formatBytes(maxSendSizeBytes)}`);
+            }
+            return removeNoteVideos(note);
+        }
+        if (maxSizeBytes && buffer.length > maxSizeBytes) {
+            if (config.loggerinfo) {
+                logger.info(`downloaded video exceeds limit: size=${formatBytes(buffer.length)}, max=${formatBytes(maxSizeBytes)}, fallback=direct URL`);
+            }
+            return note;
+        }
+        const remainingVideoUrls = note.videoUrls.slice(1);
+        if (mode === 'buffer') {
+            if (config.loggerinfo) {
+                logger.info(`use downloaded video buffer: size=${formatBytes(buffer.length)}, remainingVideoUrls=${remainingVideoUrls.length}`);
+            }
+            return {
+                ...note,
+                videoBuffer: buffer,
+                videoMimeType: mimeType,
+                videoUrls: remainingVideoUrls,
+            };
+        }
+        const replacement = mode === 'file'
+            ? await createTempVideoFile(buffer, mimeType)
+            : `base64://${buffer.toString('base64')}`;
+        if (config.loggerinfo) {
+            logger.info(`use downloaded video ${mode}: src=${mode === 'file' ? replacement : `base64://${formatBytes(buffer.length)} raw`}, remainingVideoUrls=${remainingVideoUrls.length}`);
+        }
+        return {
+            ...note,
+            videoBuffer: undefined,
+            videoMimeType: mimeType,
+            videoUrls: [replacement, ...remainingVideoUrls],
+        };
+    }
+    catch (error) {
+        if (config.loggerinfo)
+            logger.info(`download video failed: ${error instanceof Error ? error.message : String(error)}`);
+        return note;
+    }
+}
+async function getRemoteVideoSize(ctx, url, config) {
+    const maxSendSizeBytes = getSizeLimitBytes(config.maxVideoSendSizeMB, 100);
+    if (!maxSendSizeBytes)
+        return undefined;
+    try {
+        if (config.loggerinfo)
+            logger.info(`check remote video size start: url=${url}`);
+        const headers = await ctx.http.head(url, { timeout: config.timeout * 1000 });
+        const contentLength = headers.get('content-length');
+        if (!contentLength) {
+            if (config.loggerinfo)
+                logger.info('check remote video size skipped: missing content-length');
+            return undefined;
+        }
+        const size = Number.parseInt(contentLength, 10);
+        if (!Number.isFinite(size) || size < 0) {
+            if (config.loggerinfo)
+                logger.info(`check remote video size skipped: invalid content-length=${contentLength}`);
+            return undefined;
+        }
+        if (config.loggerinfo)
+            logger.info(`check remote video size success: size=${formatBytes(size)}, max=${formatBytes(maxSendSizeBytes)}`);
+        return size;
+    }
+    catch (error) {
+        if (config.loggerinfo)
+            logger.info(`check remote video size failed: ${error instanceof Error ? error.message : String(error)}`);
+        return undefined;
+    }
+}
+function removeNoteVideos(note) {
+    return {
+        ...note,
+        videoBuffer: undefined,
+        videoUrls: [],
+        videoSkippedMessage: VIDEO_TOO_LARGE_MESSAGE,
+    };
+}
+function getSizeLimitBytes(sizeMB, fallbackMB) {
+    const normalized = sizeMB ?? fallbackMB;
+    return normalized > 0 ? normalized * 1024 * 1024 : 0;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+async function createTempVideoFile(buffer, mimeType) {
+    const fileName = `xhs-video-${Date.now()}-${Math.random().toString(16).slice(2)}${getVideoFileExtension(mimeType)}`;
+    const filePath = node_path_1.default.join(node_os_1.default.tmpdir(), fileName);
+    await node_fs_1.promises.writeFile(filePath, buffer);
+    return node_url_1.default.pathToFileURL(filePath).href;
+}
+function getVideoFileExtension(mimeType) {
+    const lower = mimeType.toLowerCase();
+    if (lower.includes('mp4'))
+        return '.mp4';
+    if (lower.includes('webm'))
+        return '.webm';
+    if (lower.includes('ogg') || lower.includes('ogv'))
+        return '.ogv';
+    if (lower.includes('flv'))
+        return '.flv';
+    return '.mp4';
+}
 function shouldProcess(recent, channelId, link, seconds) {
     if (seconds <= 0)
         return true;

package/lib/parser.d.ts

@@ -26,6 +26,9 @@ export interface XhsNote {
     shareCount?: string | number;
     imageUrls: string[];
     videoUrls: string[];
+    videoBuffer?: Buffer;
+    videoMimeType?: string;
+    videoSkippedMessage?: string;
 }
 export declare function extractXhsLinks(content: string): string[];
 export declare function resolveXhsLink(rawUrl: string, config: XhsConfigLike): Promise<string>;

package/lib/parser.js

@@ -70,6 +70,12 @@ function buildXhsMessages(note, config, session) {
         }
     }
     if (config.showVideo) {
+        if (note.videoBuffer) {
+            messages.push((0, koishi_1.h)('message', {
+                userId: session?.userId,
+                nickname: session?.author?.nickname || session?.username,
+            }, koishi_1.h.video(note.videoBuffer, note.videoMimeType || 'video/mp4')));
+        }
         for (const videoUrl of note.videoUrls.slice(0, 1)) {
             messages.push((0, koishi_1.h)('message', {
                 userId: session?.userId,
@@ -77,6 +83,12 @@ function buildXhsMessages(note, config, session) {
             }, koishi_1.h.video(videoUrl)));
         }
     }
+    if (note.videoSkippedMessage) {
+        messages.push((0, koishi_1.h)('message', {
+            userId: session?.userId,
+            nickname: session?.author?.nickname || session?.username,
+        }, koishi_1.h.text(note.videoSkippedMessage)));
+    }
     return messages;
 }
 function extractInitialStateNote(html) {
@@ -244,22 +256,16 @@ function buildNote(data, url, config) {
         videoUrls: extractVideoUrls(data),
     };
 }
-
-const mobileLine = `------------------------------------`
-
 function formatNoteText(note, config) {
     const lines = [
-        `📕: ${note.title}`,
-        `👤: ${note.authorName}`,
-        mobileLine,
+        `小红书：${note.title}`,
+        `作者：${note.authorName}`,
     ];
     if (note.desc && config.maxDescLength > 0) {
         lines.push(trimText(note.desc, config.maxDescLength, config.descTruncateSuffix));
-        lines.push(mobileLine);
     }
     if (config.showStats) {
-        lines.push(`👍: ${displayCount(note.likedCount)} | 🌟: ${displayCount(note.collectedCount)} | 💬: ${displayCount(note.commentCount)} | 📤: ${displayCount(note.shareCount)}`);
-        lines.push(mobileLine);
+        lines.push(`点赞：${displayCount(note.likedCount)}  收藏：${displayCount(note.collectedCount)}  评论：${displayCount(note.commentCount)}  分享：${displayCount(note.shareCount)}`);
     }
     if (config.showLink)
         lines.push(note.url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-xhs-parser",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Parse Xiaohongshu links and cards for Koishi.",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/src/index.ts

@@ -1,9 +1,14 @@
 import { Context, Logger, Schema, h } from 'koishi'
-import { buildXhsMessages, extractXhsLinks, fetchXhsNote } from './parser'
+import os from 'node:os'
+import path from 'node:path'
+import nodeUrl from 'node:url'
+import { promises as fs } from 'node:fs'
+import { buildXhsMessages, extractXhsLinks, fetchXhsNote, XhsNote } from './parser'
 
 export const name = 'xhs-parser'
 
 const logger = new Logger(name)
+const VIDEO_TOO_LARGE_MESSAGE = '[视频文件过大，跳过解析]'
 
 export interface Config {
   enabled: boolean
@@ -23,6 +28,10 @@ export interface Config {
   maxDescLength: number
   descTruncateSuffix: string
   showVideo: boolean
+  downloadVideoAsFile: boolean
+  videoDownloadMode: 'buffer' | 'file' | 'base64'
+  maxDownloadedVideoSizeMB: number
+  maxVideoSendSizeMB: number
   showStats: boolean
   showLink: boolean
   showError: boolean
@@ -62,6 +71,14 @@ export const Config: Schema<Config> = Schema.intersect([
     maxDescLength: Schema.number().min(0).max(2000).step(10).default(160).description('描述最大字数。设为 0 时不展示描述。'),
     descTruncateSuffix: Schema.string().default('...(已截断)').description('描述超出最大字数时追加的截断标志。'),
     showVideo: Schema.boolean().default(true).description('返回视频元素。'),
+    downloadVideoAsFile: Schema.boolean().default(false).description('尝试先下载首个视频再发送，缓解 QQ / OneBot 等平台直链“资源已过期”的问题。会增加带宽消耗。'),
+    videoDownloadMode: Schema.union([
+      Schema.const('buffer').description('使用二进制 Buffer 方式发送视频（推荐）'),
+      Schema.const('base64').description('使用 base64:// 段发送视频（OneBot 常用格式，buffer 失败时可尝试）'),
+      Schema.const('file').description('写入临时文件并通过 file:// URL 发送（Napcat 等特殊环境）'),
+    ]).default('buffer').description('下载视频后的发送方式。'),
+    maxDownloadedVideoSizeMB: Schema.number().min(0).max(2048).step(1).default(20).description('下载视频大小上限，单位 MB。超过后自动回退为发送视频直链；设为 0 表示不限制。'),
+    maxVideoSendSizeMB: Schema.number().min(0).max(2048).step(1).default(100).description('视频发送大小上限，单位 MB。超过后不发送视频，包括直链；设为 0 表示不限制。'),
     showStats: Schema.boolean().default(true).description('展示点赞、收藏、评论、分享数据。'),
     showLink: Schema.boolean().default(true).description('展示原文链接。'),
   }).description('内容设置'),
@@ -102,7 +119,7 @@ export function apply(ctx: Context, config: Config) {
     const targets = links.filter((link) => shouldProcess(recent, session.channelId || session.guildId || 'private', link, config.minimumInterval))
     if (!targets.length) return next()
 
-    handleLinks(session, targets, config).catch((error) => {
+    handleLinks(ctx, session, targets, config).catch((error) => {
       logger.warn(error)
     })
 
@@ -110,7 +127,7 @@ export function apply(ctx: Context, config: Config) {
   }, config.middleware)
 }
 
-async function handleLinks(session: any, links: string[], config: Config) {
+async function handleLinks(ctx: Context, session: any, links: string[], config: Config) {
   let waitTipMessageId: string | undefined
 
   if (config.waitTip) {
@@ -123,7 +140,7 @@ async function handleLinks(session: any, links: string[], config: Config) {
 
     for (const link of links) {
       if (config.loggerinfo) logger.info(`parse ${link}`)
-      const note = await fetchXhsNote(link, config)
+      const note = await prepareNoteVideo(ctx, await fetchXhsNote(link, config), config)
       allMessages.push(...buildXhsMessages(note, config, session))
     }
 
@@ -151,6 +168,173 @@ async function handleLinks(session: any, links: string[], config: Config) {
   }
 }
 
+async function prepareNoteVideo(ctx: Context, note: XhsNote, config: Config): Promise<XhsNote> {
+  if (!config.showVideo) {
+    if (config.loggerinfo) {
+      logger.info('skip video: showVideo=false')
+    }
+    return note
+  }
+
+  const firstVideo = note.videoUrls[0]
+  if (!firstVideo) {
+    if (config.loggerinfo) logger.info('skip video download: no video URL found')
+    return note
+  }
+  if (!/^https?:\/\//i.test(firstVideo)) {
+    if (config.loggerinfo) logger.info(`skip video download: unsupported video URL protocol (${firstVideo})`)
+    return note
+  }
+
+  const maxSendSizeBytes = getSizeLimitBytes(config.maxVideoSendSizeMB, 100)
+  const remoteSize = await getRemoteVideoSize(ctx, firstVideo, config)
+  if (remoteSize !== undefined && maxSendSizeBytes && remoteSize > maxSendSizeBytes) {
+    if (config.loggerinfo) {
+      logger.info(`skip video send: remote size=${formatBytes(remoteSize)}, max=${formatBytes(maxSendSizeBytes)}, url=${firstVideo}`)
+    }
+    return removeNoteVideos(note)
+  }
+
+  if (!config.downloadVideoAsFile) {
+    if (config.loggerinfo) {
+      logger.info('skip video download: downloadVideoAsFile=false, use direct URL')
+    }
+    return note
+  }
+
+  try {
+    if (config.loggerinfo) {
+      logger.info(`download first video start: url=${firstVideo}`)
+    }
+
+    const file = await ctx.http.file(firstVideo)
+    if (!file?.data) {
+      if (config.loggerinfo) logger.info('download video failed: empty response data')
+      return note
+    }
+
+    const buffer = Buffer.from(file.data)
+    const mimeType = (file as any).type || (file as any).mime || 'video/mp4'
+    const mode = config.videoDownloadMode || 'buffer'
+    const maxSizeBytes = config.maxDownloadedVideoSizeMB > 0
+      ? config.maxDownloadedVideoSizeMB * 1024 * 1024
+      : 0
+
+    if (config.loggerinfo) {
+      logger.info(`download first video success: size=${formatBytes(buffer.length)}, mime=${mimeType}, mode=${mode}, max=${maxSizeBytes ? formatBytes(maxSizeBytes) : 'unlimited'}`)
+    }
+
+    if (maxSendSizeBytes && buffer.length > maxSendSizeBytes) {
+      if (config.loggerinfo) {
+        logger.info(`skip video send: downloaded size=${formatBytes(buffer.length)}, max=${formatBytes(maxSendSizeBytes)}`)
+      }
+      return removeNoteVideos(note)
+    }
+
+    if (maxSizeBytes && buffer.length > maxSizeBytes) {
+      if (config.loggerinfo) {
+        logger.info(`downloaded video exceeds limit: size=${formatBytes(buffer.length)}, max=${formatBytes(maxSizeBytes)}, fallback=direct URL`)
+      }
+      return note
+    }
+
+    const remainingVideoUrls = note.videoUrls.slice(1)
+
+    if (mode === 'buffer') {
+      if (config.loggerinfo) {
+        logger.info(`use downloaded video buffer: size=${formatBytes(buffer.length)}, remainingVideoUrls=${remainingVideoUrls.length}`)
+      }
+      return {
+        ...note,
+        videoBuffer: buffer,
+        videoMimeType: mimeType,
+        videoUrls: remainingVideoUrls,
+      }
+    }
+
+    const replacement = mode === 'file'
+      ? await createTempVideoFile(buffer, mimeType)
+      : `base64://${buffer.toString('base64')}`
+
+    if (config.loggerinfo) {
+      logger.info(`use downloaded video ${mode}: src=${mode === 'file' ? replacement : `base64://${formatBytes(buffer.length)} raw`}, remainingVideoUrls=${remainingVideoUrls.length}`)
+    }
+
+    return {
+      ...note,
+      videoBuffer: undefined,
+      videoMimeType: mimeType,
+      videoUrls: [replacement, ...remainingVideoUrls],
+    }
+  } catch (error) {
+    if (config.loggerinfo) logger.info(`download video failed: ${error instanceof Error ? error.message : String(error)}`)
+    return note
+  }
+}
+
+async function getRemoteVideoSize(ctx: Context, url: string, config: Config): Promise<number | undefined> {
+  const maxSendSizeBytes = getSizeLimitBytes(config.maxVideoSendSizeMB, 100)
+  if (!maxSendSizeBytes) return undefined
+
+  try {
+    if (config.loggerinfo) logger.info(`check remote video size start: url=${url}`)
+    const headers = await ctx.http.head(url, { timeout: config.timeout * 1000 })
+    const contentLength = headers.get('content-length')
+    if (!contentLength) {
+      if (config.loggerinfo) logger.info('check remote video size skipped: missing content-length')
+      return undefined
+    }
+
+    const size = Number.parseInt(contentLength, 10)
+    if (!Number.isFinite(size) || size < 0) {
+      if (config.loggerinfo) logger.info(`check remote video size skipped: invalid content-length=${contentLength}`)
+      return undefined
+    }
+
+    if (config.loggerinfo) logger.info(`check remote video size success: size=${formatBytes(size)}, max=${formatBytes(maxSendSizeBytes)}`)
+    return size
+  } catch (error) {
+    if (config.loggerinfo) logger.info(`check remote video size failed: ${error instanceof Error ? error.message : String(error)}`)
+    return undefined
+  }
+}
+
+function removeNoteVideos(note: XhsNote): XhsNote {
+  return {
+    ...note,
+    videoBuffer: undefined,
+    videoUrls: [],
+    videoSkippedMessage: VIDEO_TOO_LARGE_MESSAGE,
+  }
+}
+
+function getSizeLimitBytes(sizeMB: number | undefined, fallbackMB: number): number {
+  const normalized = sizeMB ?? fallbackMB
+  return normalized > 0 ? normalized * 1024 * 1024 : 0
+}
+
+function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`
+  return `${(bytes / 1024 / 1024).toFixed(1)} MB`
+}
+
+async function createTempVideoFile(buffer: Buffer, mimeType: string): Promise<string> {
+  const fileName = `xhs-video-${Date.now()}-${Math.random().toString(16).slice(2)}${getVideoFileExtension(mimeType)}`
+  const filePath = path.join(os.tmpdir(), fileName)
+  await fs.writeFile(filePath, buffer)
+  return nodeUrl.pathToFileURL(filePath).href
+}
+
+function getVideoFileExtension(mimeType: string) {
+  const lower = mimeType.toLowerCase()
+  if (lower.includes('mp4')) return '.mp4'
+  if (lower.includes('webm')) return '.webm'
+  if (lower.includes('ogg') || lower.includes('ogv')) return '.ogv'
+  if (lower.includes('flv')) return '.flv'
+  return '.mp4'
+}
+
 function shouldProcess(recent: Map<string, number>, channelId: string, link: string, seconds: number) {
   if (seconds <= 0) return true
 

package/src/parser.ts

@@ -28,6 +28,9 @@ export interface XhsNote {
   shareCount?: string | number
   imageUrls: string[]
   videoUrls: string[]
+  videoBuffer?: Buffer
+  videoMimeType?: string
+  videoSkippedMessage?: string
 }
 
 const URL_BOUNDARY = '[^\\s"\'<>\\\\^`{|}，。；！？、【】《》]+'
@@ -106,6 +109,13 @@ export function buildXhsMessages(note: XhsNote, config: XhsConfigLike, session?:
   }
 
   if (config.showVideo) {
+    if (note.videoBuffer) {
+      messages.push(h('message', {
+        userId: session?.userId,
+        nickname: session?.author?.nickname || session?.username,
+      }, h.video(note.videoBuffer, note.videoMimeType || 'video/mp4')))
+    }
+
     for (const videoUrl of note.videoUrls.slice(0, 1)) {
       messages.push(h('message', {
         userId: session?.userId,
@@ -114,6 +124,13 @@ export function buildXhsMessages(note: XhsNote, config: XhsConfigLike, session?:
     }
   }
 
+  if (note.videoSkippedMessage) {
+    messages.push(h('message', {
+      userId: session?.userId,
+      nickname: session?.author?.nickname || session?.username,
+    }, h.text(note.videoSkippedMessage)))
+  }
+
   return messages
 }