koishi-plugin-share-links-analysis 0.3.0 → 0.5.0

package/lib/core.d.ts

@@ -15,3 +15,4 @@ export declare function resolveLinks(content: string): Link[];
  * @returns 处理后的链接结果，如果失败则返回 null
  */
 export declare function processLink(ctx: Context, config: PluginConfig, link: Link, session: Session): Promise<ParsedInfo | null>;
+export declare function init(ctx: Context, config: PluginConfig): Promise<null>;

package/lib/core.js

@@ -36,10 +36,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveLinks = resolveLinks;
 exports.processLink = processLink;
+exports.init = init;
 const Bilibili = __importStar(require("./parsers/bilibili"));
 const Xiaohongshu = __importStar(require("./parsers/xiaohongshu"));
+const Twitter = __importStar(require("./parsers/twitter"));
 // 定义所有支持的解析器
-const parsers = [Bilibili, Xiaohongshu];
+const parsers = [Bilibili, Xiaohongshu, Twitter];
 /**
  * 从文本中解析出所有支持的链接
  * @param content 消息内容
@@ -69,3 +71,11 @@ async function processLink(ctx, config, link, session) {
     }
     return null;
 }
+async function init(ctx, config) {
+    for (const parser of parsers) {
+        if (typeof parser.init === 'function') {
+            await parser.init(ctx, config);
+        }
+    }
+    return null;
+}

package/lib/index.d.ts

@@ -5,6 +5,6 @@ export declare const inject: {
     required: string[];
     optional: never[];
 };
-export declare const usage = "\n\u5F00\u542F\u63D2\u4EF6\u540E\uFF0C\u5373\u53EF\u81EA\u52A8\u89E3\u6790\u5206\u4EAB\u94FE\u63A5\u3002\n\u5411Bot\u53D1\u9001B\u7AD9\u3001\u5C0F\u7EA2\u4E66\u7B49\u652F\u6301\u5E73\u53F0\u7684\u5206\u4EAB\u94FE\u63A5\uFF0C\u4F1A\u8FD4\u56DE\u56FE\u6587\u4FE1\u606F\u4E0E\u89C6\u9891\u3002\n\u60A8\u53EF\u4EE5\u5728\u63D2\u4EF6\u914D\u7F6E\u4E2D\u4E3A\u4E0D\u540C\u5E73\u53F0\u5206\u522B\u8BBE\u7F6E\u8FD4\u56DE\u7684\u56FE\u6587\u6D88\u606F\u683C\u5F0F\u3002\n";
+export declare const usage = "\n\u5F00\u542F\u63D2\u4EF6\u540E\uFF0C\u5373\u53EF\u81EA\u52A8\u89E3\u6790\u5206\u4EAB\u94FE\u63A5\u3002\n\u5411Bot\u53D1\u9001B\u7AD9\u3001\u5C0F\u7EA2\u4E66\u7B49\u652F\u6301\u5E73\u53F0\u7684\u5206\u4EAB\u94FE\u63A5\uFF0C\u4F1A\u8FD4\u56DE\u56FE\u6587\u4FE1\u606F\u4E0E\u89C6\u9891\u3002\n\u60A8\u53EF\u4EE5\u5728\u63D2\u4EF6\u914D\u7F6E\u4E2D\u4E3A\u4E0D\u540C\u5E73\u53F0\u5206\u522B\u8BBE\u7F6E\u8FD4\u56DE\u7684\u56FE\u6587\u6D88\u606F\u683C\u5F0F\u3002\n\u6B64\u63D2\u4EF6\u53EA\u6D4B\u8BD5\u8FC7\u5728Napcat\u4E0B\u7684\u517C\u5BB9\u6027\u60C5\u51B5\uFF0C\u4E0D\u4FDD\u8BC1\u5176\u4ED6\u5E73\u53F0\u53EF\u7528\u3002\n";
 export declare const Config: Schema<PluginConfig>;
 export declare function apply(ctx: Context, config: PluginConfig): void;

package/lib/index.js

@@ -5,7 +5,7 @@ exports.Config = exports.usage = exports.inject = exports.name = void 0;
 exports.apply = apply;
 const koishi_1 = require("koishi");
 const core_1 = require("./core");
-const xiaohongshu_1 = require("./parsers/xiaohongshu");
+const utils_1 = require("./utils");
 exports.name = 'share-links-analysis';
 exports.inject = {
     required: ['BiliBiliVideo', 'database', 'puppeteer'],
@@ -15,6 +15,7 @@ exports.usage = `
 开启插件后，即可自动解析分享链接。
 向Bot发送B站、小红书等支持平台的分享链接，会返回图文信息与视频。
 您可以在插件配置中为不同平台分别设置返回的图文消息格式。
+此插件只测试过在Napcat下的兼容性情况，不保证其他平台可用。
 `;
 // 配置文件
 exports.Config = koishi_1.Schema.intersect([
@@ -23,39 +24,41 @@ exports.Config = koishi_1.Schema.intersect([
             koishi_1.Schema.const('1').description('低清晰度优先'),
             koishi_1.Schema.const('2').description('高清晰度优先'),
         ]).role('radio').default('1').description("发送的视频清晰度优先策略"),
-        Maximumduration: koishi_1.Schema.number().default(25).description("允许解析的视频最大时长（分钟）").min(1),
-        Maximumduration_tip: koishi_1.Schema.string().default('视频太长啦！还是去平台官网看吧~').description("对过长视频的文字提示内容"),
-        MinimumTimeInterval: koishi_1.Schema.number().default(180).description("若干秒内不再处理相同链接，防止刷屏").min(1),
+        Max_size: koishi_1.Schema.number().default(5).description("允许发送的最大文件大小（Mb）"),
+        Max_size_tip: koishi_1.Schema.string().default('文件体积过大，策略已阻止发送').description("对大文件的文字提示内容"),
+        MinimumTimeInterval: koishi_1.Schema.number().default(600).description("若干秒内不再处理相同链接，防止刷屏").min(1),
         waitTip_Switch: koishi_1.Schema.union([
             koishi_1.Schema.const(false).description('不返回文字提示'),
             koishi_1.Schema.string().description('返回文字提示'),
         ]).description("是否返回等待提示。开启后，会发送`等待提示语`").default(false),
-        useForward: koishi_1.Schema.boolean().default(false).description("使用合并转发(强依赖Napcat，其他环境未测试)"),
+        useForward: koishi_1.Schema.union([
+            koishi_1.Schema.const("plain").description("普通发送"),
+            koishi_1.Schema.const("forward").description("合并转发"),
+            koishi_1.Schema.const("mixed").description("混合发送"),
+        ]).default("mixed").description("发送模式"),
     }).description("基础设置"),
     koishi_1.Schema.object({
         format: koishi_1.Schema.string().role('textarea').default(`{title}
 {cover}
 作者：{authorName}
-简介：{description}
 {stats}
-{images}
-{video}`).description('统一主输出格式。<br/>可用占位符: `{title}`, `{cover}`, `{authorName}`, `{description}`, `{stats}`, `{sourceUrl}`, `{images}`, `{video}`, `{videoUrl}`'),
+----------
+{mainbody}
+----------
+{sourceUrl}
+{video}`).description('图文/视频输出格式。<br/>可用占位符: `{title}`, `{cover}`, `{authorName}`, `{mainbody}`, `{stats}`, `{sourceUrl}`, `{video}`, `{videoUrl}`'),
     }).description("格式化模板"),
-    koishi_1.Schema.object({
-        bilibiliStatsFormat: koishi_1.Schema.string().role('textarea').default('播放: {播放} | 弹幕: {弹幕} | 点赞: {点赞} | 硬币: {硬币} | 收藏: {收藏}')
-            .description('Bilibili 链接的数据统计格式。<br/>可用占位符: `{播放}`, `{弹幕}`, `{点赞}`, `{硬币}`, `{收藏}`'),
-        xiaohongshuStatsFormat: koishi_1.Schema.string().role('textarea').default('点赞: {点赞} | 收藏: {收藏} | 评论: {评论}')
-            .description('小红书链接的数据统计格式。<br/>可用占位符: `{点赞}`, `{收藏}`, `{评论}`'),
-    }).description("数据格式化"),
     koishi_1.Schema.object({
         parseLimit: koishi_1.Schema.number().default(3).description("单对话多链接解析上限"),
         useNumeral: koishi_1.Schema.boolean().default(true).description("使用格式化数字 (如 10000 -> 1万)"),
         showError: koishi_1.Schema.boolean().default(false).description("当链接不正确时提醒发送者"),
-        bVideoIDPreference: koishi_1.Schema.union([
-            koishi_1.Schema.const("bv").description("BV 号"),
-            koishi_1.Schema.const("av").description("AV 号"),
-        ]).default("bv").description("B站ID 偏好"),
+        allow_sensitive: koishi_1.Schema.boolean().default(false).description("允许NSFW内容"),
+        proxy: koishi_1.Schema.string().description("代理设置"),
     }).description("高级解析设置"),
+    koishi_1.Schema.object({
+        onebotReadDir: koishi_1.Schema.string().description('OneBot 实现 (如 NapCat) 所在的容器或环境提供的路径前缀。').default("/app/.config/QQ/NapCat/temp"),
+        localDownloadDir: koishi_1.Schema.string().description('与上述路径对应的、Koishi 所在的容器或主机可以访问的路径前缀。').default("/koishi/data/temp"),
+    }).description('跨环境路径映射设置'),
     koishi_1.Schema.object({
         userAgent: koishi_1.Schema.string().description("所有 API 请求所用的 User-Agent").default("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"),
         logLevel: koishi_1.Schema.union([
@@ -75,8 +78,8 @@ function apply(ctx, config) {
     const logger = ctx.logger('share-links-analysis');
     const lastProcessedUrls = {};
     ctx.on('ready', async () => {
-        logger.info('插件已启动，执行一次初始的小红书 Cookie 刷新...');
-        await (0, xiaohongshu_1.refreshXhsCookie)(ctx, config);
+        logger.info('插件已启动，执行插件初始化');
+        await (0, core_1.init)(ctx, config);
     });
     ctx.middleware(async (session, next) => {
         if (!session.content || !session.channelId)
@@ -95,7 +98,7 @@ function apply(ctx, config) {
             const now = Date.now();
             if (!lastProcessedUrls[channelId])
                 lastProcessedUrls[channelId] = {};
-            if (now - (lastProcessedUrls[channelId][link.url] || 0) < config.MinimumTimeInterval * 1000) {
+            if (now - (lastProcessedUrls[channelId][link.url] || 0) < config.Min_Interval * 1000) {
                 if (config.logLevel === 'full')
                     logger.info(`链接 ${link.url} 在冷却时间内，跳过处理。`);
                 continue;
@@ -115,194 +118,20 @@ function apply(ctx, config) {
         }
     });
 }
-function escapeHtml(str) {
-    if (!str)
-        return '';
-    return str.replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;')
-        .replace(/'/g, '&#39;');
-}
 async function sendResult(session, config, result, logger) {
-    if (config.useForward) {
-        try {
-            await sendResult_forward(session, config, result, logger);
-            return; // 成功，结束
-        }
-        catch (err) {
-            logger.warn('合并转发失败:', err);
-            return;
-        }
-    }
-    else {
-        await sendResult_plain(session, config, result, logger);
+    if (!session.channel) {
+        await (0, utils_1.sendResult_plain)(session, config, result, logger);
         return;
     }
-}
-async function sendResult_plain(session, config, result, logger) {
-    if (config.logLevel === 'full') {
-        logger.info('进入普通消息发送');
-    }
-    let message = config.format;
-    // 对所有文本内容进行 HTML 转义
-    message = message.replace(/{title}/g, escapeHtml(result.title || ''));
-    message = message.replace(/{authorName}/g, escapeHtml(result.authorName || ''));
-    message = message.replace(/{description}/g, escapeHtml(result.description ? result.description : ''));
-    message = message.replace(/{sourceUrl}/g, escapeHtml(result.sourceUrl || ''));
-    message = message.replace(/{cover}/g, result.coverUrl ? koishi_1.h.image(result.coverUrl).toString() : '');
-    const imagesText = result.images ? result.images.map(img => koishi_1.h.image(img).toString()).join('\n') : '';
-    message = message.replace(/{images}/g, imagesText);
-    message = message.replace(/{stats}/g, escapeHtml(result.stats || ''));
-    // 【修复】只要 videoUrl 存在就处理，仅当 duration 明确超长时才替换为提示
-    if (result.videoUrl) {
-        message = message.replace(/{videoUrl}/g, escapeHtml(result.videoUrl));
-        // 仅当 duration 是有效数字且超长时，才显示提示
-        if (typeof result.duration === 'number' && result.duration > config.Maximumduration * 60) {
-            const tip = escapeHtml(config.Maximumduration_tip || '');
-            message = message.replace(/{video}/g, tip);
-        }
-        else {
-            // 正常发送视频和链接
-            message = message.replace(/{video}/g, koishi_1.h.video(result.videoUrl).toString());
-            if (config.logLevel === 'link_only' || config.logLevel === 'full') {
-                logger.info(`视频直链 (${result.platform}): ${result.videoUrl}`);
-            }
-        }
-    }
-    else {
-        // 没有视频则移除占位符
-        message = message.replace(/{video}/g, '');
-        message = message.replace(/{videoUrl}/g, '');
-    }
-    // 过滤空行，保留含有 < 的行（如图片、视频标签）
-    const cleanMessage = message.split('\n').filter(line => line.trim() !== '' || line.includes('<')).join('\n');
-    if (config.logLevel === 'full') {
-        logger.info(`解析结果: \n ${JSON.stringify(result, null, 2)}`);
-    }
-    if (cleanMessage) {
-        await session.send(koishi_1.h.quote(session.messageId) + cleanMessage);
-    }
-}
-async function sendResult_forward(session, config, result, logger) {
-    if (config.logLevel === 'full') {
-        logger.info('进入合并转发发送');
-    }
-    let message = config.format;
-    // Step 1: 替换纯文本字段
-    message = message.replace(/{title}/g, escapeHtml(result.title || ''));
-    message = message.replace(/{authorName}/g, escapeHtml(result.authorName || ''));
-    message = message.replace(/{description}/g, escapeHtml(result.description || ''));
-    message = message.replace(/{sourceUrl}/g, escapeHtml(result.sourceUrl || ''));
-    message = message.replace(/{stats}/g, escapeHtml(result.stats || ''));
-    if (result.videoUrl) {
-        message = message.replace(/{videoUrl}/g, escapeHtml(result.videoUrl));
-    }
-    if (typeof result.duration === 'number' && result.duration > config.Maximumduration * 60) {
-        const tip = escapeHtml(config.Maximumduration_tip || '');
-        message = message.replace(/{video}/g, tip);
-    }
-    // Step 2: 检查是否包含视频占位符
-    const hasVideoInTemplate = message.includes('{video}');
-    // Step 3: 构建富媒体映射
-    const mediaMap = {};
-    // 处理封面
-    if (result.coverUrl) {
-        mediaMap['{cover}'] = [{ type: 'image', data: { file: result.coverUrl } }];
-    }
-    else {
-        mediaMap['{cover}'] = [];
-    }
-    // 处理图片列表
-    if (result.images && result.images.length > 0) {
-        mediaMap['{images}'] = result.images.map(img => ({ type: 'image', data: { file: img } }));
-    }
-    else {
-        mediaMap['{images}'] = [];
-    }
-    // Step 4: 按行处理，仅过滤纯空行，并精确控制换行
-    const lines = message.split('\n').filter(line => line.trim() !== '');
-    const nonVideoSegments = [];
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const isLastLine = i === lines.length - 1;
-        // 按富媒体占位符分割
-        const tokens = line.split(/(\{cover\}|\{images\}|\{video\})/g);
-        // 用于存储当前行的消息段
-        const currentLineSegments = [];
-        let hasTextContent = false; // 新增标志：当前行是否包含纯文本
-        for (const token of tokens) {
-            if (token === '{cover}' || token === '{images}') {
-                // 插入对应的消息段
-                currentLineSegments.push(...mediaMap[token]);
-            }
-            else if (token === '{video}') {
-                // 视频不放入 nonVideoSegments，跳过
-            }
-            else if (token.trim() !== '') {
-                // 普通文本
-                currentLineSegments.push({ type: 'text', data: { text: token } });
-                hasTextContent = true; // 标记当前行有文本
-            }
-            // 注意：token 为空字符串时（如占位符在行首/尾），不添加任何内容
-        }
-        // 只有当 currentLineSegments 不为空时，才将其加入总列表
-        if (currentLineSegments.length > 0) {
-            nonVideoSegments.push(...currentLineSegments);
-        }
-        // 如果不是最后一行，且当前行非空，则添加一个换行符
-        if (!isLastLine && hasTextContent) {
-            nonVideoSegments.push({ type: 'text', data: { text: '\n' } });
-        }
-    }
-    // Step 5: 构建转发节点
-    const forwardNodes = [];
-    // 非视频内容节点
-    if (nonVideoSegments.length > 0) {
-        forwardNodes.push({
-            type: 'node',
-            data: {
-                user_id: session.selfId,
-                nickname: '分享助手',
-                content: nonVideoSegments
-            }
-        });
-    }
-    // 视频节点（仅当模板中有 {video} 且有有效视频时）
-    if (hasVideoInTemplate && result.videoUrl) {
-        if (typeof result.duration === 'number' && result.duration > config.Maximumduration * 60) {
-            // 超时提示已作为普通文本处理（在模板中替换为文字）
-        }
-        else {
-            forwardNodes.push({
-                type: 'node',
-                data: {
-                    user_id: session.selfId,
-                    nickname: '分享助手',
-                    content: [
-                        { type: 'video', data: { file: result.videoUrl } },
-                    ]
-                }
-            });
-            if (config.logLevel === 'link_only' || config.logLevel === 'full') {
-                logger.info(`视频直链 (${result.platform}): ${result.videoUrl}`);
-            }
-        }
-    }
-    if (forwardNodes.length === 0)
-        return;
-    if (config.logLevel === 'full') {
-        logger.info(`解析结果: \n ${JSON.stringify(result, null, 2)}`);
+    switch (config.useForward) {
+        case "plain":
+            await (0, utils_1.sendResult_plain)(session, config, result, logger);
+            return;
+        case 'forward':
+            await (0, utils_1.sendResult_forward)(session, config, result, logger, false);
+            return;
+        case "mixed":
+            await (0, utils_1.sendResult_forward)(session, config, result, logger, true);
+            return;
     }
-    // Step 6: 发送合并转发
-    if (!(session.onebot && session.onebot._request))
-        throw new Error("Onebot is not defined");
-    await session.onebot._request('send_group_forward_msg', {
-        group_id: session.guildId,
-        messages: forwardNodes,
-        news: [{ text: result.description || '-' }, { text: '点击查看详情 | Powered by furryaxw' }],
-        prompt: result.title || '',
-        summary: '分享解析',
-        source: result.title || ''
-    });
 }

package/lib/parsers/bilibili.js

@@ -4,6 +4,17 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.match = match;
 exports.process = process;
 const utils_1 = require("../utils");
+const linkRules = [
+    {
+        pattern: /(?:https?:\/\/)?(?:www\.bilibili\.com\/video\/)(([ab]v[0-9a-zA-Z]+))/gi,
+        type: "video",
+    },
+    {
+        pattern: /(?:https?:\/\/)?(?:b23\.tv\/([0-9a-zA-Z]+))/gi,
+        type: "short",
+    },
+];
+const bvPattern = /(?<![a-zA-Z0-9/])(BV[1-9A-HJ-NP-Za-km-z]{10})(?![a-zA-Z0-9])/gi;
 /**
  * 在文本中匹配B站链接 (长链/短链/纯BV号)
  * @param content 消息内容
@@ -11,36 +22,40 @@ const utils_1 = require("../utils");
  */
 function match(content) {
     const results = [];
-    // 匹配标准长链接和短链接
-    const linkRegex = [
-        { pattern: /(https?:\/\/)?(www\.bilibili\.com\/video\/([ab]v[0-9a-zA-Z]+))/g, type: "video" },
-        { pattern: /(https?:\/\/)?(b23\.tv\/[0-9a-zA-Z]+)/g, type: "short" },
-    ];
-    for (const rule of linkRegex) {
-        const matches = [...content.matchAll(new RegExp(rule.pattern, 'gi'))];
-        for (const matchArr of matches) {
-            if (matchArr[2]) {
-                // 强制将所有链接格式化为 https 开头
-                const formattedUrl = `https://${matchArr[2]}`;
-                results.push({
-                    platform: 'bilibili',
-                    type: rule.type,
-                    id: rule.type === 'video' ? matchArr[3] : matchArr[2],
-                    url: formattedUrl
-                });
-            }
+    const seen = new Set();
+    for (const { pattern, type } of linkRules) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            const id = match[1];
+            if (!id)
+                continue;
+            const host = type === "short" ? "b23.tv" : "www.bilibili.com";
+            const path = type === "short" ? id : `video/${id}`;
+            const url = `https://${host}/${path}`;
+            if (seen.has(url))
+                continue;
+            seen.add(url);
+            results.push({
+                platform: 'bilibili',
+                type,
+                id,
+                url,
+            });
         }
     }
-    // 匹配独立的 BV 号
-    const bvPattern = /(?<![a-zA-Z0-9/])(BV[1-9A-HJ-NP-Za-km-z]{10})(?![a-zA-Z0-9])/gi;
-    const bvMatches = [...content.matchAll(bvPattern)];
-    for (const matchArr of bvMatches) {
-        const videoId = matchArr[1];
+    // 匹配独立的 BV 号（不包含在链接中）
+    let bvMatch;
+    while ((bvMatch = bvPattern.exec(content)) !== null) {
+        const videoId = bvMatch[1];
+        const url = `https://www.bilibili.com/video/${videoId}`;
+        if (seen.has(url))
+            continue;
+        seen.add(url);
         results.push({
             platform: 'bilibili',
             type: 'video',
             id: videoId,
-            url: `https://www.bilibili.com/video/${videoId}`
+            url,
         });
     }
     return results;
@@ -154,29 +169,22 @@ async function process(ctx, config, link, session) {
         catch (e) {
             logger.error(`通过BiliBiliVideo服务获取视频流失败，bvid: ${data.bvid}: ${e.message}`);
         }
-        // 在解析器内部格式化 stats 字符串
-        const stats = {
-            '播放': (0, utils_1.numeral)(data.stat.view, config),
-            '弹幕': (0, utils_1.numeral)(data.stat.danmaku, config),
-            '点赞': (0, utils_1.numeral)(data.stat.like, config),
-            '硬币': (0, utils_1.numeral)(data.stat.coin, config),
-            '收藏': (0, utils_1.numeral)(data.stat.favorite, config),
-        };
-        let statsString = config.bilibiliStatsFormat;
-        // 【修复】使用类型安全的方式遍历对象，防止 TypeScript 报错
-        Object.keys(stats).forEach(key => {
-            statsString = statsString.replace(`{${key}}`, stats[key]);
-        });
+        const play = (0, utils_1.numeral)(data.stat.view, config);
+        const danmaku = (0, utils_1.numeral)(data.stat.danmaku, config);
+        const liked = (0, utils_1.numeral)(data.stat.like, config);
+        const coin = (0, utils_1.numeral)(data.stat.coin, config);
+        const favorite = (0, utils_1.numeral)(data.stat.favorite, config);
+        const statsString = `播放: ${play} | 弹幕: ${danmaku}
+  点赞: ${liked} | 硬币: ${coin} | 收藏: ${favorite}`;
         return {
             platform: 'bilibili',
             title: data.title,
             authorName: data.owner.name,
-            description: data.desc,
+            mainbody: (0, utils_1.escapeHtml)(data.desc),
             coverUrl: data.pic,
             videoUrl: videoUrl,
-            duration: data.duration,
             sourceUrl: `https://www.bilibili.com/video/${data.bvid}`,
-            stats: statsString, // 【修改】传入格式化后的字符串
+            stats: statsString,
         };
     }
     catch (error) {

package/lib/parsers/tmp.json

@@ -0,0 +1,46 @@
+{
+  allSameType: true,
+  article: null,
+  combinedMediaUrl: null,
+  communityNote: null,
+  conversationID: '1988209837298377142',
+  date: 'Tue Nov 11 11:38:59 +0000 2025',
+  date_epoch: 1762861139,
+  fetched_on: 1763038701,
+  hasMedia: true,
+  hashtags: [],
+  lang: 'zxx',
+  likes: 80,
+  mediaURLs: [
+    'https://pbs.twimg.com/media/G5eKTetbcAE9wtk.jpg'
+  ],
+  media_extended: [
+    {
+      altText: null,
+      id_str: '1988209827773116417',
+      size: {
+        height: 1840,
+        width: 1840
+      },
+      thumbnail_url: 'https://pbs.twimg.com/media/G5eKTetbcAE9wtk.jpg',
+      type: 'image',
+      url: 'https://pbs.twimg.com/media/G5eKTetbcAE9wtk.jpg'
+    }
+  ],
+  pollData: null,
+  possibly_sensitive: false,
+  qrt: null,
+  qrtURL: null,
+  replies: 5,
+  replyingTo: null,
+  replyingToID: null,
+  retweet: null,
+  retweetURL: null,
+  retweets: 4,
+  text: 'https://t.co/b8AyvpjhAE',
+  tweetID: '1988209837298377142',
+  tweetURL: 'https://twitter.com/moyushuang_/status/1988209837298377142',
+  user_name: '魔芋凉粉',
+  user_profile_image_url: 'https://pbs.twimg.com/profile_images/1830265587676962816/KM46JNnI_normal.jpg',
+  user_screen_name: 'moyushuang_'
+}

package/lib/parsers/twitter.d.ts

@@ -0,0 +1,10 @@
+import { Context, Session } from 'koishi';
+import { PluginConfig, ParsedInfo, Link } from '../types';
+/**
+ * 在文本中匹配 Twitter/X 链接
+ */
+export declare function match(content: string): Link[];
+/**
+ * 处理单条 Twitter 链接
+ */
+export declare function process(ctx: Context, config: PluginConfig, link: Link, session: Session): Promise<ParsedInfo | null>;