@anyul/koishi-plugin-rss 5.2.3 → 5.2.4

package/lib/core/item-processor.js

@@ -34,17 +34,12 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RssItemProcessor = void 0;
-const koishi_1 = require("koishi");
 const cheerio = __importStar(require("cheerio"));
 const logger_1 = require("../utils/logger");
-const common_1 = require("../utils/common");
-const media_1 = require("../utils/media");
-const renderer_1 = require("./renderer");
-const template_1 = require("../utils/template");
-const ai_1 = require("./ai");
-const marked_1 = require("marked");
 const sanitizer_1 = require("../utils/sanitizer");
-const security_1 = require("../utils/security");
+const ai_1 = require("./ai");
+const item_processor_template_1 = require("./item-processor-template");
+const item_processor_runtime_1 = require("./item-processor-runtime");
 class RssItemProcessor {
     ctx;
     config;
@@ -54,345 +49,75 @@ class RssItemProcessor {
         this.config = config;
         this.$http = $http;
     }
+    getRuntimeDeps() {
+        return {
+            ctx: this.ctx,
+            config: this.config,
+            $http: this.$http,
+        };
+    }
     async parseRssItem(item, arg, authorId) {
+        void authorId;
         (0, logger_1.debug)(this.config, arg, 'rss arg', 'details');
         let template = arg.template;
-        let msg = "";
-        let html;
-        let videoList = [];
-        item.description = item.description?.join?.('') || item.description;
-        // HTML 安全清理
+        item.title = (0, item_processor_runtime_1.normalizeText)(item?.title);
+        item.description = (0, item_processor_runtime_1.normalizeText)(item?.description);
         const sanitizer = (0, sanitizer_1.createSanitizer)(this.config);
         if (sanitizer.isEnabled() && item.description) {
             item.description = sanitizer.sanitize(item.description);
         }
-        // --- AI 逻辑 START ---
-        let aiSummary = "";
-        let formattedAiSummary = "";
-        const hasCustomAiTemplate = this.config.template?.custom?.includes('{{aiSummary}}') ||
-            this.config.template?.content?.includes('{{aiSummary}}');
-        if (this.config.ai && this.config.ai.enabled) {
+        let aiSummary = '';
+        let formattedAiSummary = '';
+        const hasCustomAiTemplate = this.config.template?.custom?.includes('{{aiSummary}}')
+            || this.config.template?.content?.includes('{{aiSummary}}');
+        if (this.config.ai?.enabled) {
             const rawSummary = await (0, ai_1.getAiSummary)(this.config, item.title, item.description);
             if (rawSummary) {
-                const prefix = "🤖 AI摘要：\n";
-                const sep = this.config.ai?.separator || '----------------';
-                // 带格式的摘要文本
-                formattedAiSummary = `${prefix}${rawSummary}`;
-                // 注入模板变量的纯文本
                 aiSummary = rawSummary;
-                // 将 aiSummary 添加到 item 对象中，供模板使用
+                formattedAiSummary = `🤖 AI摘要：\n${rawSummary}`;
                 item.aiSummary = aiSummary;
             }
         }
-        // --- AI 逻辑 END ---
-        //block
         arg.block?.forEach((blockWord) => {
-            item.description = item.description.replace(new RegExp(blockWord, 'gim'), i => Array(i.length).fill(this.config.msg?.blockString || '*').join(""));
-            item.title = item.title.replace(new RegExp(blockWord, 'gim'), i => Array(i.length).fill(this.config.msg?.blockString || '*').join(""));
+            item.description = (0, item_processor_runtime_1.normalizeText)(item.description).replace(new RegExp(blockWord, 'gim'), matched => Array(matched.length).fill(this.config.msg?.blockString || '*').join(''));
+            item.title = (0, item_processor_runtime_1.normalizeText)(item.title).replace(new RegExp(blockWord, 'gim'), matched => Array(matched.length).fill(this.config.msg?.blockString || '*').join(''));
         });
-        if (this.config.basic?.videoMode === 'filter') {
-            html = cheerio.load(item.description);
-            if (html('video').length > 0)
-                return '';
+        const html = cheerio.load(item.description);
+        if (this.config.basic?.videoMode === 'filter' && html('video').length > 0) {
+            return '';
         }
-        html = cheerio.load(item.description);
-        if (template == 'auto') {
-            let stringLength = html.text().length;
-            template = stringLength < 300 ? 'content' : 'custom';
+        if (template === 'auto') {
+            template = html.text().length < 300 ? 'content' : 'custom';
         }
-        // 在确定最终模板后才记录日志
         if (template) {
             (0, logger_1.debug)(this.config, `使用模板: ${template}`, 'template', 'info');
         }
-        msg = await this.processTemplate(template, item, arg, html, videoList, aiSummary);
-        // 如果是图片渲染模板，AI摘要已经被注入到HTML中，不需要再自动拼接
-        const isImageRenderTemplate = template === 'custom' || template === 'default' || template === 'only description';
-        if (isImageRenderTemplate && (this.config.basic?.imageMode === 'base64' || this.config.basic?.imageMode === 'File' || this.config.basic?.imageMode === 'assets')) {
+        let msg = await (0, item_processor_template_1.processItemTemplate)({
+            deps: this.getRuntimeDeps(),
+            template,
+            item,
+            arg,
+            html,
+            aiSummary,
+        });
+        const imageMode = this.config.basic?.imageMode;
+        const isImageRenderTemplate = template === 'custom'
+            || template === 'default'
+            || template === 'only description';
+        if (isImageRenderTemplate && ['base64', 'File', 'assets'].includes(imageMode || '')) {
             formattedAiSummary = '';
         }
         if (this.config.msg?.censor) {
             msg = `<censor>${msg}</censor>`;
         }
-        // --- AI 自动拼接逻辑 START ---
-        // 如果生成了摘要，且用户使用的模板里没有显式包含 {{aiSummary}}，则自动拼接
         if (formattedAiSummary && !hasCustomAiTemplate && this.config.ai) {
-            const sep = this.config.ai?.separator || '----------------';
-            if (this.config.ai?.placement === 'bottom') {
-                // 底部：正文 + 分割线 + 摘要
-                msg = msg + `\n${sep}\n` + formattedAiSummary;
-            }
-            else {
-                // 顶部：摘要 + 分割线 + 正文
-                msg = formattedAiSummary + `\n${sep}\n` + msg;
-            }
-        }
-        // --- AI 自动拼接逻辑 END ---
-        (0, logger_1.debug)(this.config, msg, "parse:msg", 'info');
-        return msg;
-    }
-    async processTemplate(template, item, arg, html, videoList, aiSummary) {
-        let msg = "";
-        const parseContent = (templateStr, itemObj) => (0, common_1.parseTemplateContent)(templateStr, { ...itemObj, aiSummary });
-        switch (template) {
-            case "custom":
-                msg = await this.processCustomTemplate(item, arg, html, parseContent);
-                await this.processVideos(html, arg, videoList);
-                msg += this.formatVideoList(videoList);
-                break;
-            case "content":
-                msg = await this.processContentTemplate(item, arg, html, parseContent);
-                await this.processVideos(html, arg, videoList);
-                msg += this.formatVideoList(videoList);
-                msg += videoList.filter(([src, poster]) => poster && !src.startsWith('__VIDEO_LINK__')).map(([src, poster]) => (0, koishi_1.h)('img', { src: poster })).join("");
-                break;
-            case "only text":
-                msg = html.text();
-                break;
-            case "only media":
-                msg = await this.processOnlyMediaTemplate(item, arg, html);
-                await this.processVideos(html, arg, videoList);
-                msg += this.formatVideoList(videoList);
-                break;
-            case "only image":
-                msg = await this.processOnlyImageTemplate(item, arg, html);
-                break;
-            case "only video":
-                await this.processVideos(html, arg, videoList);
-                msg = this.formatVideoList(videoList);
-                break;
-            case "proto":
-                msg = item.description;
-                break;
-            case "default":
-                msg = await this.processDefaultTemplate(item, arg, html, parseContent);
-                await this.processVideos(html, arg, videoList);
-                msg += this.formatVideoList(videoList);
-                break;
-            case "only description":
-                msg = await this.processOnlyDescriptionTemplate(item, arg, html, parseContent);
-                await this.processVideos(html, arg, videoList);
-                msg += this.formatVideoList(videoList);
-                break;
-            case "link":
-                msg = await this.processLinkTemplate(item, arg);
-                break;
-            default:
-                msg = item.description;
-        }
-        return msg;
-    }
-    async processCustomTemplate(item, arg, html, parseContent) {
-        item.description = parseContent(this.config.template?.custom || '', { ...item, arg });
-        (0, logger_1.debug)(this.config, item.description, 'description');
-        // 如果有AI摘要，在图片渲染前将其注入到HTML中
-        const hasAiSummary = item.aiSummary && item.aiSummary.trim();
-        if (hasAiSummary && (this.config.basic?.imageMode === 'base64' || this.config.basic?.imageMode === 'File' || this.config.basic?.imageMode === 'assets')) {
-            // 将markdown转换为HTML
-            const aiSummaryHtml = await (0, marked_1.marked)(item.aiSummary);
-            const aiSummarySection = `
-        <div class="ai-summary-section mb-6">
-          <div class="flex items-start gap-3 mb-3">
-            <div class="mt-0.5 w-6 h-6 rounded-md bg-primary/10 flex flex-shrink-0 items-center justify-center">
-              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" class="w-4 h-4 text-primary">
-                <path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z"/>
-              </svg>
-            </div>
-            <h3 class="text-sm font-bold text-slate-700">AI 摘要</h3>
-          </div>
-          <div class="pl-9 prose prose-slate prose-sm max-w-none">
-            ${aiSummaryHtml}
-          </div>
-        </div>
-        <div class="border-t border-slate-100 my-6"></div>
-      `;
-            item.description = aiSummarySection + item.description;
-        }
-        html = cheerio.load(item.description);
-        if (arg?.proxyAgent?.enabled) {
-            await Promise.all(html('img').map(async (v, i) => i.attribs.src = await (0, media_1.getImageUrl)(this.ctx, this.config, this.$http, i.attribs.src, arg, true)).get());
-        }
-        html('img').attr('style', 'object-fit:scale-down;max-width:100%;');
-        let msg = await this.renderImage(html.html(), arg);
-        return parseContent(this.config.template?.customRemark || '', { ...item, arg, description: msg });
-    }
-    async processContentTemplate(item, arg, html, parseContent) {
-        let imgList = [];
-        html('img').map((key, i) => imgList.push(i.attribs.src));
-        imgList = [...new Set(imgList)];
-        let imgBufferList = Object.assign({}, ...(await Promise.all(imgList.map(async (src) => ({ [src]: await (0, media_1.getImageUrl)(this.ctx, this.config, this.$http, src, arg) })))));
-        html('img').replaceWith((key, Dom) => `<p>$img{{${imgList[key]}}}</p>`);
-        let msg = html.text();
-        item.description = msg.replace(/\$img\{\{(.*?)\}\}/g, (match) => {
-            let src = match.match(/\$img\{\{(.*?)\}\}/)[1];
-            let finalUrl = imgBufferList[src];
-            return finalUrl ? `<img src="${finalUrl}"/>` : '';
-        });
-        return parseContent(this.config.template?.content || '', { ...item, arg });
-    }
-    async processOnlyMediaTemplate(item, arg, html) {
-        let imgList = [];
-        html('img').map((key, i) => imgList.push(i.attribs.src));
-        imgList = await Promise.all([...new Set(imgList)].map(async (src) => await (0, media_1.getImageUrl)(this.ctx, this.config, this.$http, src, arg)));
-        return imgList.filter(Boolean).map(img => `<img src="${img}"/>`).join("");
-    }
-    async processOnlyImageTemplate(item, arg, html) {
-        let imgList = [];
-        html('img').map((key, i) => imgList.push(i.attribs.src));
-        imgList = await Promise.all([...new Set(imgList)].map(async (src) => await (0, media_1.getImageUrl)(this.ctx, this.config, this.$http, src, arg)));
-        return imgList.filter(Boolean).map(img => `<img src="${img}"/>`).join("");
-    }
-    async processDefaultTemplate(item, arg, html, parseContent) {
-        item.description = parseContent((0, template_1.getDefaultTemplate)(this.config, arg.bodyWidth, arg.bodyPadding, arg.bodyFontSize || this.config.template?.bodyFontSize), { ...item, arg });
-        (0, logger_1.debug)(this.config, item.description, 'description');
-        // 如果有AI摘要，在图片渲染前将其注入到HTML中
-        const hasAiSummary = item.aiSummary && item.aiSummary.trim();
-        if (hasAiSummary && (this.config.basic?.imageMode === 'base64' || this.config.basic?.imageMode === 'File' || this.config.basic?.imageMode === 'assets')) {
-            // 将markdown转换为HTML
-            const aiSummaryHtml = await (0, marked_1.marked)(item.aiSummary);
-            const aiSummarySection = `
-        <div class="ai-summary-section mb-6">
-          <div class="flex items-start gap-3 mb-3">
-            <div class="mt-0.5 w-6 h-6 rounded-md bg-primary/10 flex flex-shrink-0 items-center justify-center">
-              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" class="w-4 h-4 text-primary">
-                <path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z"/>
-              </svg>
-            </div>
-            <h3 class="text-sm font-bold text-slate-700">AI 摘要</h3>
-          </div>
-          <div class="pl-9 prose prose-slate prose-sm max-w-none">
-            ${aiSummaryHtml}
-          </div>
-        </div>
-        <div class="border-t border-slate-100 my-6"></div>
-      `;
-            item.description = aiSummarySection + item.description;
+            const sep = this.config.ai.separator || '----------------';
+            msg = this.config.ai.placement === 'bottom'
+                ? `${msg}\n${sep}\n${formattedAiSummary}`
+                : `${formattedAiSummary}\n${sep}\n${msg}`;
         }
-        html = cheerio.load(item.description);
-        if (arg?.proxyAgent?.enabled) {
-            await Promise.all(html('img').map(async (v, i) => i.attribs.src = await (0, media_1.getImageUrl)(this.ctx, this.config, this.$http, i.attribs.src, arg, true)).get());
-        }
-        html('img').attr('style', 'object-fit:scale-down;max-width:100%;');
-        (0, logger_1.debug)(this.config, `当前 imageMode: ${this.config.basic?.imageMode}`, 'imageMode', 'info');
-        let msg = await this.renderImage(html.html(), arg);
-        return msg;
-    }
-    async processOnlyDescriptionTemplate(item, arg, html, parseContent) {
-        item.description = parseContent((0, template_1.getDescriptionTemplate)(this.config, arg.bodyWidth, arg.bodyPadding, arg.bodyFontSize || this.config.template?.bodyFontSize), { ...item, arg });
-        (0, logger_1.debug)(this.config, item.description, 'description');
-        // 如果有AI摘要，在图片渲染前将其注入到HTML中
-        const hasAiSummary = item.aiSummary && item.aiSummary.trim();
-        if (hasAiSummary && (this.config.basic?.imageMode === 'base64' || this.config.basic?.imageMode === 'File' || this.config.basic?.imageMode === 'assets')) {
-            // 将markdown转换为HTML
-            const aiSummaryHtml = await (0, marked_1.marked)(item.aiSummary);
-            const aiSummarySection = `
-        <div class="ai-summary-section mb-6">
-          <div class="flex items-start gap-3 mb-3">
-            <div class="mt-0.5 w-6 h-6 rounded-md bg-primary/10 flex flex-shrink-0 items-center justify-center">
-              <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" class="w-4 h-4 text-primary">
-                <path d="M12 2C6.48 2 2 6.48 2 12s4.48 10 10 10 10-4.48 10-10S17.52 2 12 2zm-2 15l-5-5 1.41-1.41L10 14.17l7.59-7.59L19 8l-9 9z"/>
-              </svg>
-            </div>
-            <h3 class="text-sm font-bold text-slate-700">AI 摘要</h3>
-          </div>
-          <div class="pl-9 prose prose-slate prose-sm max-w-none" style="color: #475569; line-height: 1.6;">
-            ${aiSummaryHtml}
-          </div>
-        </div>
-        <div style="border-top: 1px solid #e2e8f0; margin: 24px 0;"></div>
-      `;
-            item.description = aiSummarySection + item.description;
-        }
-        html = cheerio.load(item.description);
-        if (arg?.proxyAgent?.enabled) {
-            await Promise.all(html('img').map(async (v, i) => i.attribs.src = await (0, media_1.getImageUrl)(this.ctx, this.config, this.$http, i.attribs.src, arg, true)).get());
-        }
-        html('img').attr('style', 'object-fit:scale-down;max-width:100%;');
-        let msg = await this.renderImage(html.html(), arg);
-        return msg;
-    }
-    async processLinkTemplate(item, arg) {
-        let html = cheerio.load(item.description);
-        let src = html('a')[0].attribs.href;
-        (0, logger_1.debug)(this.config, src, 'link src', 'info');
-        // URL 安全验证
-        try {
-            (0, security_1.validateUrlOrThrow)(src, (0, security_1.getSecurityOptions)(this.config));
-        }
-        catch (error) {
-            if (error instanceof security_1.SecurityError) {
-                (0, logger_1.debug)(this.config, `链接 URL 安全验证失败: ${error.message}`, 'security', 'error');
-                return `链接安全验证失败: ${error.message}`;
-            }
-            throw error;
-        }
-        let html2 = cheerio.load((await this.$http(src, arg)).data);
-        if (arg?.proxyAgent?.enabled) {
-            await Promise.all(html2('img').map(async (v, i) => i.attribs.src = await (0, media_1.getImageUrl)(this.ctx, this.config, this.$http, i.attribs.src, arg, true)).get());
-        }
-        html2('img').attr('style', 'object-fit:scale-down;max-width:100%;');
-        // link 模板使用订阅级参数设置 body 样式
-        const bodyWidth = arg?.bodyWidth ?? this.config.template?.bodyWidth ?? 600;
-        const bodyPadding = arg?.bodyPadding ?? this.config.template?.bodyPadding ?? 20;
-        html2('body').attr('style', `width:${bodyWidth}px;padding:${bodyPadding}px;`);
-        let msg = await this.renderImage(html2.xml(), arg);
+        (0, logger_1.debug)(this.config, msg, 'parse:msg', 'info');
         return msg;
     }
-    async processVideos(html, arg, videoList) {
-        await Promise.all(html('video').map(async (v, i) => videoList.push([
-            await (0, media_1.getVideoUrl)(this.ctx, this.config, this.$http, i.attribs.src, arg, true, i),
-            (i.attribs.poster && this.config.basic?.usePoster) ? await (0, media_1.getImageUrl)(this.ctx, this.config, this.$http, i.attribs.poster, arg, true) : ""
-        ])).get());
-    }
-    formatVideoList(videoList) {
-        return videoList.filter(([src]) => src).map(([src, poster]) => {
-            // href 模式：返回视频链接文本
-            if (src.startsWith('__VIDEO_LINK__:')) {
-                const videoUrl = src.replace('__VIDEO_LINK__:', '');
-                return `\n🎬 视频: ${videoUrl}\n`;
-            }
-            // 其他模式：创建 video 元素
-            return (0, koishi_1.h)('video', { src, poster });
-        }).join('');
-    }
-    /**
-     * 统一的图片渲染方法
-     * 提取了 custom、default、only description、link 模板中重复的图片渲染逻辑
-     */
-    async renderImage(htmlContent, arg) {
-        const imageMode = this.config.basic?.imageMode;
-        // base64 模式
-        if (imageMode === 'base64') {
-            (0, logger_1.debug)(this.config, '使用 base64 模式渲染', 'render mode', 'info');
-            return (await (0, renderer_1.renderHtml2Image)(this.ctx, this.config, this.$http, htmlContent, arg)).toString();
-        }
-        // File 或 assets 模式
-        if (imageMode === 'File' || imageMode === 'assets') {
-            if (!this.ctx.puppeteer) {
-                (0, logger_1.debug)(this.config, '未安装 puppeteer 插件，跳过图片渲染', 'puppeteer error', 'error');
-                return htmlContent;
-            }
-            try {
-                (0, logger_1.debug)(this.config, `使用 ${imageMode} 模式渲染`, 'render mode', 'info');
-                const processedHtml = await (0, renderer_1.preprocessHtmlImages)(this.ctx, this.config, this.$http, htmlContent, arg);
-                let msg;
-                if ((this.config.template?.deviceScaleFactor ?? 1) !== 1) {
-                    msg = (await (0, renderer_1.renderHtml2Image)(this.ctx, this.config, this.$http, processedHtml, arg)).toString();
-                }
-                else {
-                    msg = await this.ctx.puppeteer.render(processedHtml);
-                }
-                msg = await (0, media_1.puppeteerToFile)(this.ctx, this.config, msg);
-                (0, logger_1.debug)(this.config, 'puppeteer 渲染完成', 'render success', 'info');
-                return msg;
-            }
-            catch (error) {
-                (0, logger_1.debug)(this.config, `puppeteer render 失败: ${error}`, 'puppeteer error', 'error');
-                return htmlContent;
-            }
-        }
-        // 未知模式，回退到 HTML
-        (0, logger_1.debug)(this.config, `未知的 imageMode: ${imageMode}，回退到 HTML`, 'render warning', 'error');
-        return htmlContent;
-    }
 }
 exports.RssItemProcessor = RssItemProcessor;

package/lib/core/notification-queue-retry.d.ts

@@ -0,0 +1,25 @@
+import { Config } from '../types';
+import { QueueTaskContent } from './notification-queue-types';
+declare const DEFAULT_QUEUE_BACKOFF_DELAYS: number[];
+declare const DEFAULT_QUEUE_BATCH_SIZE = 10;
+declare const DEFAULT_QUEUE_MAX_RETRIES = 5;
+declare const DEFAULT_QUEUE_PROCESS_INTERVAL_SECONDS = 30;
+declare const DEFAULT_QUEUE_CLEANUP_HOURS = 24;
+export interface QueueRuntimeConfig {
+    batchSize: number;
+    maxRetries: number;
+    processIntervalSeconds: number;
+    cleanupHours: number;
+}
+export type QueueErrorAction = 'FAILED' | 'DOWNGRADE' | 'RETRY';
+export interface QueueErrorClassification {
+    action: QueueErrorAction;
+    normalizedError: Error;
+}
+export declare function getQueueRuntimeConfig(config?: Config): QueueRuntimeConfig;
+export declare function isFatalQueueError(error: any): boolean;
+export declare function isQueueDowngradeError(error: any): boolean;
+export declare function classifyQueueError(error: unknown, content?: Pick<QueueTaskContent, 'isDowngraded'>): QueueErrorClassification;
+export declare function shouldStopRetrying(retryCount: number, maxRetries: number): boolean;
+export declare function getRetryDelaySeconds(retryCount: number, backoffDelays?: number[]): number;
+export { DEFAULT_QUEUE_BACKOFF_DELAYS, DEFAULT_QUEUE_BATCH_SIZE, DEFAULT_QUEUE_MAX_RETRIES, DEFAULT_QUEUE_PROCESS_INTERVAL_SECONDS, DEFAULT_QUEUE_CLEANUP_HOURS, };

package/lib/core/notification-queue-retry.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_QUEUE_CLEANUP_HOURS = exports.DEFAULT_QUEUE_PROCESS_INTERVAL_SECONDS = exports.DEFAULT_QUEUE_MAX_RETRIES = exports.DEFAULT_QUEUE_BATCH_SIZE = exports.DEFAULT_QUEUE_BACKOFF_DELAYS = void 0;
+exports.getQueueRuntimeConfig = getQueueRuntimeConfig;
+exports.isFatalQueueError = isFatalQueueError;
+exports.isQueueDowngradeError = isQueueDowngradeError;
+exports.classifyQueueError = classifyQueueError;
+exports.shouldStopRetrying = shouldStopRetrying;
+exports.getRetryDelaySeconds = getRetryDelaySeconds;
+const error_handler_1 = require("../utils/error-handler");
+const DEFAULT_QUEUE_BACKOFF_DELAYS = [10, 30, 60, 300, 600];
+exports.DEFAULT_QUEUE_BACKOFF_DELAYS = DEFAULT_QUEUE_BACKOFF_DELAYS;
+const DEFAULT_QUEUE_BATCH_SIZE = 10;
+exports.DEFAULT_QUEUE_BATCH_SIZE = DEFAULT_QUEUE_BATCH_SIZE;
+const DEFAULT_QUEUE_MAX_RETRIES = 5;
+exports.DEFAULT_QUEUE_MAX_RETRIES = DEFAULT_QUEUE_MAX_RETRIES;
+const DEFAULT_QUEUE_PROCESS_INTERVAL_SECONDS = 30;
+exports.DEFAULT_QUEUE_PROCESS_INTERVAL_SECONDS = DEFAULT_QUEUE_PROCESS_INTERVAL_SECONDS;
+const DEFAULT_QUEUE_CLEANUP_HOURS = 24;
+exports.DEFAULT_QUEUE_CLEANUP_HOURS = DEFAULT_QUEUE_CLEANUP_HOURS;
+function clampInteger(value, min, max, fallback) {
+    if (!Number.isFinite(value)) {
+        return fallback;
+    }
+    return Math.min(max, Math.max(min, Math.floor(value)));
+}
+function getQueueRuntimeConfig(config) {
+    const queueConfig = config?.queue;
+    return {
+        batchSize: clampInteger(queueConfig?.batchSize, 1, 50, DEFAULT_QUEUE_BATCH_SIZE),
+        maxRetries: clampInteger(queueConfig?.maxRetries, 0, 20, DEFAULT_QUEUE_MAX_RETRIES),
+        processIntervalSeconds: clampInteger(queueConfig?.processInterval, 5, 3600, DEFAULT_QUEUE_PROCESS_INTERVAL_SECONDS),
+        cleanupHours: clampInteger(queueConfig?.cleanupHours, 1, 720, DEFAULT_QUEUE_CLEANUP_HOURS),
+    };
+}
+function isFatalQueueError(error) {
+    const errorCode = error?.code?.toString?.() || error?.retcode?.toString?.();
+    if (errorCode === 'UnknownGroup' || errorCode === 'GROUP_NOT_FOUND') {
+        return true;
+    }
+    if (errorCode === 'UserBlock' || errorCode === 'BANNED') {
+        return true;
+    }
+    if (errorCode === 'PermissionDenied' || errorCode === 'NO_PERMISSION') {
+        return true;
+    }
+    return false;
+}
+function isQueueDowngradeError(error) {
+    const errorCode = error?.code?.toString?.() || error?.retcode?.toString?.();
+    const errorMessage = error?.message?.toString?.() || '';
+    return errorCode === '1200' || errorMessage.includes('1200') || Boolean(error?.requiresDowngrade);
+}
+function classifyQueueError(error, content) {
+    const normalizedError = (0, error_handler_1.normalizeError)(error);
+    if (!content?.isDowngraded && isQueueDowngradeError(error)) {
+        return {
+            action: 'DOWNGRADE',
+            normalizedError,
+        };
+    }
+    if (isFatalQueueError(error)) {
+        return {
+            action: 'FAILED',
+            normalizedError,
+        };
+    }
+    return {
+        action: 'RETRY',
+        normalizedError,
+    };
+}
+function shouldStopRetrying(retryCount, maxRetries) {
+    return retryCount >= Math.max(0, maxRetries);
+}
+function getRetryDelaySeconds(retryCount, backoffDelays = DEFAULT_QUEUE_BACKOFF_DELAYS) {
+    return backoffDelays[retryCount] || backoffDelays[backoffDelays.length - 1];
+}

package/lib/core/notification-queue-sender.d.ts

@@ -0,0 +1,20 @@
+import { Context } from 'koishi';
+import { Config } from '../types';
+import { createDebugWithContext } from '../utils/logger';
+import { QueueTask, QueueTaskContent } from './notification-queue-types';
+type QueueDebugFn = ReturnType<typeof createDebugWithContext>;
+interface NotificationQueueSenderDeps {
+    ctx: Context;
+    config: Config;
+    createTaskDebug: (task: Partial<QueueTask>) => QueueDebugFn;
+    buildTaskLogContext: (task: Partial<QueueTask>) => Record<string, any>;
+}
+export declare function downgradeQueueMessage(content: QueueTaskContent): QueueTaskContent;
+export declare class NotificationQueueSender {
+    private deps;
+    constructor(deps: NotificationQueueSenderDeps);
+    sendMessage(task: QueueTask): Promise<void>;
+    downgradeMessage(content: QueueTaskContent): Promise<QueueTaskContent>;
+    cacheMessage(task: QueueTask): Promise<void>;
+}
+export {};

package/lib/core/notification-queue-sender.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotificationQueueSender = void 0;
+exports.downgradeQueueMessage = downgradeQueueMessage;
+const error_handler_1 = require("../utils/error-handler");
+const error_tracker_1 = require("../utils/error-tracker");
+const notification_queue_retry_1 = require("./notification-queue-retry");
+function downgradeQueueMessage(content) {
+    if (content.isDowngraded) {
+        return {
+            ...content,
+            isDowngraded: true,
+        };
+    }
+    const downgradedMessage = content.message.replace(/<video[^>]*>.*?<\/video>/gis, (match) => {
+        const srcMatch = match.match(/src=["']([^"']+)["']/);
+        if (srcMatch) {
+            return `\n🎬 视频: ${srcMatch[1]}\n`;
+        }
+        return '\n[视频不支持]\n';
+    });
+    return {
+        ...content,
+        message: downgradedMessage,
+        isDowngraded: true,
+    };
+}
+class NotificationQueueSender {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async sendMessage(task) {
+        const { guildId, platform, content } = task;
+        const target = `${platform}:${guildId}`;
+        const taskDebug = this.deps.createTaskDebug(task);
+        try {
+            await this.deps.ctx.broadcast([target], content.message);
+            taskDebug(`消息发送成功: ${target}`, 'queue', 'details');
+        }
+        catch (sendError) {
+            if ((0, notification_queue_retry_1.isQueueDowngradeError)(sendError) && !content.isDowngraded) {
+                taskDebug('检测到 OneBot 1200 错误，尝试降级处理', 'queue', 'info', { errorCode: '1200' });
+            }
+            throw sendError;
+        }
+    }
+    async downgradeMessage(content) {
+        return downgradeQueueMessage(content);
+    }
+    async cacheMessage(task) {
+        if (!this.deps.config.cache?.enabled) {
+            return;
+        }
+        const taskDebug = this.deps.createTaskDebug(task);
+        const { getMessageCache } = await Promise.resolve().then(() => __importStar(require('../utils/message-cache')));
+        const cache = getMessageCache();
+        if (!cache) {
+            return;
+        }
+        try {
+            await cache.addMessage({
+                rssId: task.rssId,
+                guildId: task.guildId,
+                platform: task.platform,
+                title: task.content.title || '',
+                content: task.content.description || '',
+                link: task.content.link || '',
+                pubDate: task.content.pubDate || new Date(),
+                imageUrl: task.content.imageUrl || '',
+                videoUrl: '',
+                finalMessage: task.content.message,
+            });
+        }
+        catch (err) {
+            const normalizedError = (0, error_handler_1.normalizeError)(err);
+            taskDebug(`缓存消息失败: ${normalizedError.message}`, 'cache', 'info');
+            (0, error_tracker_1.trackError)(normalizedError, {
+                ...this.deps.buildTaskLogContext(task),
+                operation: 'cacheMessage',
+            });
+        }
+    }
+}
+exports.NotificationQueueSender = NotificationQueueSender;