@anyul/koishi-plugin-rss 5.2.1 → 5.2.3

package/lib/core/feeder.js

@@ -41,12 +41,27 @@ exports.feeder = feeder;
 exports.startFeeder = startFeeder;
 exports.stopFeeder = stopFeeder;
 const koishi_1 = require("koishi");
+const error_handler_1 = require("../utils/error-handler");
+const error_tracker_1 = require("../utils/error-tracker");
 const logger_1 = require("../utils/logger");
 const common_1 = require("../utils/common");
 const parser_1 = require("./parser");
 const constants_1 = require("../constants");
 let interval = null;
 let queueInterval = null;
+function buildFeedLogContext(rssItem) {
+    return {
+        subscribeId: String(rssItem.id),
+        rssId: rssItem.rssId || rssItem.title,
+        rssTitle: rssItem.title,
+        url: rssItem.url,
+        guildId: rssItem.guildId,
+        platform: rssItem.platform,
+    };
+}
+function createFeedDebug(config, rssItem) {
+    return (0, logger_1.createDebugWithContext)(config, buildFeedLogContext(rssItem));
+}
 function findRssItem(rssList, keyword) {
     // 优先匹配列表索引（用户看到的序号 1, 2, 3...）
     if (typeof keyword === 'number' || /^\d+$/.test(String(keyword))) {
@@ -56,10 +71,14 @@ function findRssItem(rssList, keyword) {
         }
     }
     // 其他匹配方式：按 rssId、url、title 等
-    let index = ((rssList.findIndex(i => i.rssId === +keyword) + 1) ||
+    const index = ((rssList.findIndex(i => i.rssId === +keyword) + 1) ||
         (rssList.findIndex(i => i.url == keyword) + 1) ||
         (rssList.findIndex(i => i.url.indexOf(keyword) + 1) + 1) ||
         (rssList.findIndex(i => i.title.indexOf(keyword) + 1) + 1)) - 1;
+    // 边界检查：确保索引有效
+    if (index < 0 || index >= rssList.length) {
+        return undefined;
+    }
     return rssList[index];
 }
 function getLastContent(item, config) {
@@ -69,6 +88,12 @@ function getLastContent(item, config) {
 }
 function formatArg(options, config) {
     let { arg, template, auth } = options;
+    const parseArrayArg = (value) => {
+        return value
+            .split('/')
+            .map(item => item.trim())
+            .filter(Boolean);
+    };
     // 特殊处理：提取完整的 proxyAgent URL
     let proxyAgentUrl;
     if (arg && arg.includes('proxyAgent:')) {
@@ -95,9 +120,9 @@ function formatArg(options, config) {
         json.forceLength = parseInt(json.forceLength);
     // Array conversions
     if (json.filter && typeof json.filter === 'string')
-        json.filter = json.filter.split("/");
+        json.filter = parseArrayArg(json.filter);
     if (json.block && typeof json.block === 'string')
-        json.block = json.block.split("/");
+        json.block = parseArrayArg(json.block);
     // Proxy Argument Parsing (使用提取的完整 URL)
     if (proxyAgentUrl) {
         if (['false', 'none', ''].includes(String(proxyAgentUrl))) {
@@ -199,6 +224,142 @@ function mixinArg(arg, config) {
     (0, logger_1.debug)(config, `[DEBUG_PROXY] mixinArg return: ${JSON.stringify(res.proxyAgent)}`, 'mixin', 'details');
     return res;
 }
+// ============ 拆分出的辅助函数 ============
+/**
+ * 1. 抓取 RSS 数据
+ */
+async function fetchRssItems(ctx, config, $http, rssItem, arg, feedDebug) {
+    const rssHubUrl = config.msg?.rssHubUrl || 'https://hub.slarker.me';
+    try {
+        const urls = rssItem.url.split("|").map((u) => (0, common_1.parseQuickUrl)(u, rssHubUrl, constants_1.quickList));
+        const fetchPromises = urls.map((url) => (0, parser_1.getRssData)(ctx, config, $http, url, arg));
+        const results = await Promise.all(fetchPromises);
+        return results.flat(1);
+    }
+    catch (err) {
+        const normalizedError = (0, error_handler_1.normalizeError)(err);
+        feedDebug(`Fetch failed for ${rssItem.title}: ${normalizedError.message}`, 'feeder', 'error', {
+            stage: 'fetch',
+        });
+        (0, error_tracker_1.trackError)(normalizedError, {
+            ...buildFeedLogContext(rssItem),
+            stage: 'fetch',
+        });
+        return [];
+    }
+}
+/**
+ * 2. 过滤关键字
+ */
+function filterItems(config, items, arg, feedDebug) {
+    return items.filter(item => {
+        const matchKeyword = arg.filter?.find((keyword) => new RegExp(keyword, 'im').test(item.title) || new RegExp(keyword, 'im').test(item.description));
+        if (matchKeyword) {
+            feedDebug(`filter:${matchKeyword}`, 'feeder', 'info', { matchedKeyword: matchKeyword });
+            feedDebug(item, 'filter rss item', 'info', { matchedKeyword: matchKeyword });
+        }
+        return !matchKeyword;
+    });
+}
+/**
+ * 3. 检查更新（时间+内容）
+ */
+function checkForUpdates(config, rssItem, items, arg, feedDebug) {
+    // 按时间排序
+    let itemArray = items
+        .sort((a, b) => (0, common_1.parsePubDate)(config, b.pubDate).getTime() - (0, common_1.parsePubDate)(config, a.pubDate).getTime());
+    if (itemArray.length === 0) {
+        return { newItems: [], latestPubDate: new Date(), currentContent: [] };
+    }
+    const latestItem = itemArray[0];
+    const lastPubDate = (0, common_1.parsePubDate)(config, latestItem.pubDate);
+    feedDebug(`${rssItem.title}: Latest item date=${lastPubDate.toISOString()}, DB date=${rssItem.lastPubDate ? new Date(rssItem.lastPubDate).toISOString() : 'none'}`, 'feeder', 'details');
+    // 准备去重内容
+    const currentContent = config.basic?.resendUpdataContent === 'all'
+        ? itemArray.map((i) => getLastContent(i, config))
+        : [getLastContent(latestItem, config)];
+    // 反转顺序（发送顺序：最早的先发）
+    if (arg.reverse) {
+        itemArray = itemArray.reverse();
+    }
+    let rssItemArray = [];
+    if (rssItem.arg.forceLength) {
+        // 强制长度模式：忽略时间，只取 N 条
+        rssItemArray = itemArray.slice(0, rssItem.arg.forceLength);
+        feedDebug(`${rssItem.title}: Force length mode, taking ${rssItemArray.length} items`, 'feeder', 'details');
+    }
+    else {
+        // 标准模式：时间 + 内容检查
+        feedDebug(`${rssItem.title}: Checking ${itemArray.length} items for updates`, 'feeder', 'details');
+        rssItemArray = itemArray.filter((v, i) => {
+            const currentItemTime = (0, common_1.parsePubDate)(config, v.pubDate).getTime();
+            const lastTime = rssItem.lastPubDate ? (0, common_1.parsePubDate)(config, rssItem.lastPubDate).getTime() : 0;
+            feedDebug(`[${i}] ${v.title?.substring(0, 30)}: time=${new Date(currentItemTime).toISOString()} > last=${new Date(lastTime).toISOString()} ? ${currentItemTime > lastTime}`, 'feeder', 'details');
+            // 严格时间检查
+            if (currentItemTime > lastTime) {
+                feedDebug(`[${i}] ✓ Item is new (time check)`, 'feeder', 'details');
+                return true;
+            }
+            // 内容哈希检查（时间相同但内容变化）
+            if (config.basic?.resendUpdataContent !== 'disable') {
+                const newItemContent = getLastContent(v, config);
+                const oldItemMatch = rssItem.lastContent?.itemArray?.find((old) => (newItemContent.guid && old.guid === newItemContent.guid) ||
+                    (old.link === newItemContent.link && old.title === newItemContent.title));
+                if (oldItemMatch) {
+                    const descriptionChanged = JSON.stringify(oldItemMatch.description) !== JSON.stringify(newItemContent.description);
+                    if (descriptionChanged) {
+                        feedDebug(`[${i}] ✓ Item is updated (content changed)`, 'feeder', 'details');
+                    }
+                    else {
+                        feedDebug(`[${i}] ✗ Item filtered (already sent)`, 'feeder', 'details');
+                    }
+                    return descriptionChanged;
+                }
+                else {
+                    feedDebug(`[${i}] ✗ Item filtered (no match in lastContent)`, 'feeder', 'details');
+                }
+            }
+            feedDebug(`[${i}] ✗ Item filtered (failed all checks)`, 'feeder', 'details');
+            return false;
+        });
+        // 应用最大条目限制
+        if (arg.maxRssItem) {
+            rssItemArray = rssItemArray.slice(0, arg.maxRssItem);
+        }
+    }
+    return { newItems: rssItemArray, latestPubDate: lastPubDate, currentContent };
+}
+/**
+ * 4. 生成消息
+ */
+async function generateMessages(processor, items, rssItem, arg) {
+    const itemsToSend = [...items].reverse();
+    // 生成所有消息
+    const messageList = (await Promise.all(itemsToSend.map(async (i) => await processor.parseRssItem(i, { ...rssItem, ...arg }, rssItem.author)))).filter(m => m);
+    return { messageList, itemsToSend };
+}
+/**
+ * 5. 构建最终消息
+ */
+function buildFinalMessage(config, messageList, rssItem, arg) {
+    let message = "";
+    const shouldMerge = arg.merge === true || config.basic?.merge === '一直合并' || (config.basic?.merge === '有多条更新时合并' && messageList.length > 1);
+    // 检查是否需要合并视频
+    const hasVideo = config.basic?.margeVideo && messageList.some(msg => /<video/.test(msg));
+    if (shouldMerge || hasVideo) {
+        message = `<message forward><author id="${rssItem.author}"/>${messageList.map(m => `<message>${m}</message>`).join("")}</message>`;
+    }
+    else {
+        message = messageList.join("");
+    }
+    // 添加提及
+    if (rssItem.followers && rssItem.followers.length > 0) {
+        const mentions = rssItem.followers.map((id) => `<at ${id === 'all' ? 'type="all"' : `id="${id}"`}/>`).join(" ");
+        message += `<message>${mentions}</message>`;
+    }
+    return message;
+}
+// ============ 主函数 ============
 /**
  * 生产者：抓取 RSS，发现新消息，存入队列
  */
@@ -210,9 +371,10 @@ async function feeder(deps, processor) {
         return;
     for (const rssItem of rssList) {
         try {
+            const feedDebug = createFeedDebug(config, rssItem);
             // 1. Prepare Arguments
             let arg = mixinArg(rssItem.arg || {}, config);
-            (0, logger_1.debug)(config, `[DEBUG_PROXY] feeder mixinArg result proxyAgent: ${JSON.stringify(arg.proxyAgent)}`, 'feeder', 'details');
+            feedDebug(`[DEBUG_PROXY] feeder mixinArg result proxyAgent: ${JSON.stringify(arg.proxyAgent)}`, 'feeder', 'details');
             let originalArg = (0, koishi_1.clone)(rssItem.arg || {});
             // 2. Interval Check
             if (rssItem.arg.interval) {
@@ -229,132 +391,52 @@ async function feeder(deps, processor) {
                 }
             }
             // 3. Fetch RSS Data
-            // Use config.msg.rssHubUrl for quick url parsing
-            const rssHubUrl = config.msg?.rssHubUrl || 'https://hub.slarker.me';
-            let rssItemList = [];
-            try {
-                const urls = rssItem.url.split("|").map((u) => (0, common_1.parseQuickUrl)(u, rssHubUrl, constants_1.quickList));
-                const fetchPromises = urls.map((url) => (0, parser_1.getRssData)(ctx, config, $http, url, arg));
-                const results = await Promise.all(fetchPromises);
-                rssItemList = results.flat(1);
-            }
-            catch (err) {
-                (0, logger_1.debug)(config, `Fetch failed for ${rssItem.title}: ${err.message}`, 'feeder', 'info');
-                continue;
-            }
-            if (rssItemList.length === 0)
-                continue;
-            // 4. Sort and Filter
-            let itemArray = rssItemList
-                .sort((a, b) => (0, common_1.parsePubDate)(config, b.pubDate).getTime() - (0, common_1.parsePubDate)(config, a.pubDate).getTime())
-                .filter(item => {
-                // Keyword filter
-                const matchKeyword = arg.filter?.find((keyword) => new RegExp(keyword, 'im').test(item.title) || new RegExp(keyword, 'im').test(item.description));
-                if (matchKeyword) {
-                    (0, logger_1.debug)(config, `filter:${matchKeyword}`, '', 'info');
-                    (0, logger_1.debug)(config, item, 'filter rss item', 'info');
-                }
-                return !matchKeyword;
-            });
-            if (itemArray.length === 0)
+            const rssItemList = await fetchRssItems(ctx, config, $http, rssItem, arg, feedDebug);
+            if (rssItemList.length === 0) {
+                await ctx.database.set('rssOwl', { id: rssItem.id }, {
+                    lastPubDate: rssItem.lastPubDate,
+                    arg: originalArg,
+                    lastContent: rssItem.lastContent || { itemArray: [] }
+                });
                 continue;
-            // 5. Check for Updates
-            const latestItem = itemArray[0];
-            const lastPubDate = (0, common_1.parsePubDate)(config, latestItem.pubDate);
-            (0, logger_1.debug)(config, `${rssItem.title}: Latest item date=${lastPubDate.toISOString()}, DB date=${rssItem.lastPubDate ? new Date(rssItem.lastPubDate).toISOString() : 'none'}`, 'feeder', 'details');
-            // Prepare content for deduplication
-            const currentContent = config.basic?.resendUpdataContent === 'all'
-                ? itemArray.map((i) => getLastContent(i, config))
-                : [getLastContent(latestItem, config)];
-            // Reverse if needed for sending order (oldest first usually)
-            if (arg.reverse) {
-                itemArray = itemArray.reverse();
             }
-            let rssItemArray = [];
-            if (rssItem.arg.forceLength) {
-                // Force length mode: ignore time, just take N items
-                rssItemArray = itemArray.slice(0, arg.forceLength);
-                (0, logger_1.debug)(config, `${rssItem.title}: Force length mode, taking ${rssItemArray.length} items`, 'feeder', 'details');
-            }
-            else {
-                // Standard mode: Time & Content check
-                (0, logger_1.debug)(config, `${rssItem.title}: Checking ${itemArray.length} items for updates`, 'feeder', 'details');
-                rssItemArray = itemArray.filter((v, i) => {
-                    const currentItemTime = (0, common_1.parsePubDate)(config, v.pubDate).getTime();
-                    const lastTime = rssItem.lastPubDate ? (0, common_1.parsePubDate)(config, rssItem.lastPubDate).getTime() : 0;
-                    (0, logger_1.debug)(config, `[${i}] ${v.title?.substring(0, 30)}: time=${new Date(currentItemTime).toISOString()} > last=${new Date(lastTime).toISOString()} ? ${currentItemTime > lastTime}`, 'feeder', 'details');
-                    // Strict time check
-                    if (currentItemTime > lastTime) {
-                        (0, logger_1.debug)(config, `[${i}] ✓ Item is new (time check)`, 'feeder', 'details');
-                        return true;
-                    }
-                    // Content hash check (if time is same but content changed)
-                    if (config.basic?.resendUpdataContent !== 'disable') {
-                        const newItemContent = getLastContent(v, config);
-                        const oldItemMatch = rssItem.lastContent?.itemArray?.find((old) => (newItemContent.guid && old.guid === newItemContent.guid) ||
-                            (old.link === newItemContent.link && old.title === newItemContent.title));
-                        if (oldItemMatch) {
-                            // If description changed, it's an update
-                            const descriptionChanged = JSON.stringify(oldItemMatch.description) !== JSON.stringify(newItemContent.description);
-                            if (descriptionChanged) {
-                                (0, logger_1.debug)(config, `[${i}] ✓ Item is updated (content changed)`, 'feeder', 'details');
-                            }
-                            else {
-                                (0, logger_1.debug)(config, `[${i}] ✗ Item filtered (already sent)`, 'feeder', 'details');
-                            }
-                            return descriptionChanged;
-                        }
-                        else {
-                            (0, logger_1.debug)(config, `[${i}] ✗ Item filtered (no match in lastContent)`, 'feeder', 'details');
-                        }
-                    }
-                    (0, logger_1.debug)(config, `[${i}] ✗ Item filtered (failed all checks)`, 'feeder', 'details');
-                    return false;
+            // 4. Filter Items
+            const filteredItems = filterItems(config, rssItemList, arg, feedDebug);
+            if (filteredItems.length === 0) {
+                const latestItem = [...rssItemList]
+                    .sort((a, b) => (0, common_1.parsePubDate)(config, b.pubDate).getTime() - (0, common_1.parsePubDate)(config, a.pubDate).getTime())[0];
+                await ctx.database.set('rssOwl', { id: rssItem.id }, {
+                    lastPubDate: latestItem ? (0, common_1.parsePubDate)(config, latestItem.pubDate) : rssItem.lastPubDate,
+                    arg: originalArg,
+                    lastContent: latestItem
+                        ? { itemArray: [getLastContent(latestItem, config)] }
+                        : (rssItem.lastContent || { itemArray: [] })
                 });
-                // Apply Max Item Limit
-                if (arg.maxRssItem) {
-                    rssItemArray = rssItemArray.slice(0, arg.maxRssItem);
-                }
+                continue;
             }
-            if (rssItemArray.length === 0) {
-                (0, logger_1.debug)(config, `${rssItem.title}: No new items found after filtering`, 'feeder', 'info');
-                // No new items, but we should still update 'lastContent' to latest state to prevent future drifts
+            // 5. Check for Updates
+            const { newItems, latestPubDate, currentContent } = checkForUpdates(config, rssItem, filteredItems, arg, feedDebug);
+            if (newItems.length === 0) {
+                feedDebug(`${rssItem.title}: No new items found after filtering`, 'feeder', 'info', { newItemCount: 0 });
                 await ctx.database.set('rssOwl', { id: rssItem.id }, {
-                    lastPubDate,
+                    lastPubDate: latestPubDate,
                     arg: originalArg,
                     lastContent: { itemArray: currentContent }
                 });
                 continue;
             }
-            (0, logger_1.debug)(config, `${rssItem.title}: Found ${rssItemArray.length} new items`, 'feeder', 'info');
-            (0, logger_1.debug)(config, rssItemArray.map(i => i.title), '', 'info');
-            // 6. 生成消息并添加到队列（生产者核心逻辑）
-            const itemsToSend = [...rssItemArray].reverse();
-            // 生成所有消息
-            const messageList = (await Promise.all(itemsToSend.map(async (i) => await processor.parseRssItem(i, { ...rssItem, ...arg }, rssItem.author)))).filter(m => m); // Filter empty messages
+            feedDebug(`${rssItem.title}: Found ${newItems.length} new items`, 'feeder', 'info', { newItemCount: newItems.length });
+            feedDebug(newItems.map(i => i.title), 'feeder', 'info', { newItemCount: newItems.length });
+            // 6. Generate Messages
+            const { messageList, itemsToSend } = await generateMessages(processor, newItems, rssItem, arg);
             if (messageList.length === 0) {
-                (0, logger_1.debug)(config, `${rssItem.title}: Items found but parsed to empty messages`, 'feeder', 'info');
-                // Items found but parsed to empty (e.g. filtered by video mode)
-                await ctx.database.set('rssOwl', { id: rssItem.id }, { lastPubDate, arg: originalArg, lastContent: { itemArray: currentContent } });
+                feedDebug(`${rssItem.title}: Items found but parsed to empty messages`, 'feeder', 'info', { newItemCount: newItems.length });
+                await ctx.database.set('rssOwl', { id: rssItem.id }, { lastPubDate: latestPubDate, arg: originalArg, lastContent: { itemArray: currentContent } });
                 continue;
             }
-            // 7. 构建最终消息
-            let message = "";
-            const shouldMerge = arg.merge === true || config.basic?.merge === '一直合并' || (config.basic?.merge === '有多条更新时合并' && messageList.length > 1);
-            // Check for video merge requirement
-            const hasVideo = config.basic?.margeVideo && messageList.some(msg => /<video/.test(msg));
-            if (shouldMerge || hasVideo) {
-                message = `<message forward><author id="${rssItem.author}"/>${messageList.map(m => `<message>${m}</message>`).join("")}</message>`;
-            }
-            else {
-                message = messageList.join("");
-            }
-            // Add mentions
-            if (rssItem.followers && rssItem.followers.length > 0) {
-                const mentions = rssItem.followers.map((id) => `<at ${id === 'all' ? 'type="all"' : `id="${id}"`}/>`).join(" ");
-                message += `<message>${mentions}</message>`;
-            }
-            // 8. 添加任务到队列（关键变更：不再直接发送）
+            // 7. Build Final Message
+            const message = buildFinalMessage(config, messageList, rssItem, arg);
+            // 8. Add to Queue
             const taskContent = {
                 message,
                 originalItem: itemsToSend[0],
@@ -373,24 +455,38 @@ async function feeder(deps, processor) {
                 platform: rssItem.platform,
                 content: taskContent
             });
-            (0, logger_1.debug)(config, `✓ 已添加到发送队列: ${rssItem.title}`, 'feeder', 'info');
-            // 9. 更新数据库状态（关键：无论发送是否成功，都更新 lastPubDate）
-            // 这样即使 Bot 掉线，重启后也不会重复发送旧消息
+            feedDebug(`✓ 已添加到发送队列: ${rssItem.title}`, 'feeder', 'info', {
+                queuedItemTitle: itemsToSend[0]?.title,
+            });
+            // 9. Update Database State
             await ctx.database.set('rssOwl', { id: rssItem.id }, {
-                lastPubDate,
+                lastPubDate: latestPubDate,
                 arg: originalArg,
                 lastContent: { itemArray: currentContent }
             });
         }
         catch (err) {
-            (0, logger_1.debug)(config, `Feeder error for ${rssItem.url}: ${err.message}`, 'feeder', 'error');
+            const normalizedError = (0, error_handler_1.normalizeError)(err);
+            const feedContext = buildFeedLogContext(rssItem);
+            (0, logger_1.debug)(config, `Feeder error for ${rssItem.url}: ${normalizedError.message}`, 'feeder', 'error', feedContext);
+            (0, error_tracker_1.trackError)(normalizedError, feedContext);
         }
     }
 }
 function startFeeder(ctx, config, $http, processor, queueManager) {
     const deps = { ctx, config, $http, queueManager };
+    const lifecycleDebug = (0, logger_1.createDebugWithContext)(config, { lifecycle: 'feeder' });
     // Initial run
-    feeder(deps, processor).catch(err => console.error("Initial feeder run failed:", err));
+    feeder(deps, processor).catch(err => {
+        const normalizedError = (0, error_handler_1.normalizeError)(err);
+        lifecycleDebug(`Initial feeder run failed: ${normalizedError.message}`, 'feeder', 'error', {
+            operation: 'initial-feeder-run',
+        });
+        (0, error_tracker_1.trackError)(normalizedError, {
+            lifecycle: 'feeder',
+            operation: 'initial-feeder-run',
+        });
+    });
     // 启动生产者定时器（抓取 RSS）
     const refreshInterval = (config.basic?.refresh || 600) * 1000;
     interval = setInterval(async () => {
@@ -407,9 +503,22 @@ function startFeeder(ctx, config, $http, processor, queueManager) {
         await queueManager.processQueue();
     }, queueProcessInterval);
     // 立即处理一次队列（启动时）
-    queueManager.processQueue().catch(err => console.error("Initial queue processing failed:", err));
+    queueManager.processQueue().catch(err => {
+        const normalizedError = (0, error_handler_1.normalizeError)(err);
+        lifecycleDebug(`Initial queue processing failed: ${normalizedError.message}`, 'queue', 'error', {
+            operation: 'initial-queue-processing',
+        });
+        (0, error_tracker_1.trackError)(normalizedError, {
+            lifecycle: 'feeder',
+            operation: 'initial-queue-processing',
+        });
+    });
+    lifecycleDebug('Feeder started', 'feeder', 'info', {
+        refreshInterval,
+        queueProcessInterval,
+    });
 }
-function stopFeeder() {
+function stopFeeder(config) {
     if (interval) {
         clearInterval(interval);
         interval = null;
@@ -418,4 +527,8 @@ function stopFeeder() {
         clearInterval(queueInterval);
         queueInterval = null;
     }
+    if (config) {
+        const lifecycleDebug = (0, logger_1.createDebugWithContext)(config, { lifecycle: 'feeder' });
+        lifecycleDebug('Feeder stopped', 'feeder', 'info');
+    }
 }

package/lib/core/item-processor.d.ts

@@ -16,4 +16,9 @@ export declare class RssItemProcessor {
     private processLinkTemplate;
     private processVideos;
     private formatVideoList;
+    /**
+     * 统一的图片渲染方法
+     * 提取了 custom、default、only description、link 模板中重复的图片渲染逻辑
+     */
+    private renderImage;
 }