@anyul/koishi-plugin-rss 5.2.2 → 5.2.4

package/lib/commands/web-monitor.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerWebMonitorCommands = registerWebMonitorCommands;
+const common_1 = require("../utils/common");
+const error_handler_1 = require("../utils/error-handler");
+const utils_1 = require("./utils");
+function registerWebMonitorCommands(deps) {
+    registerHtmlMonitorCommand(deps);
+    registerAskCommand(deps);
+    registerWatchCommand(deps);
+}
+function registerHtmlMonitorCommand(deps) {
+    deps.ctx.guild()
+        .command('rssowl.html <url:string>', '监控网页变化 (CSS Selector)')
+        .alias('rsso.html')
+        .usage(`
+HTML 网页监控功能，使用 CSS 选择器提取内容
+用法:
+  rsso.html https://example.com -s ".item"                    - 监控网页变化
+  rsso.html https://example.com -s ".item" -T                  - 测试选择器
+  rsso.html https://example.com -s ".item" -t "我的订阅"       - 自定义标题
+  rsso.html https://example.com -s ".item" -P                  - SPA 动态页面
+  rsso.html https://example.com -s ".item" -w 5000             - 渲染后等待5秒
+
+示例:
+  rsso.html https://www.zhihu.com/billboard -s ".BillBoard-item:first-child"
+  rsso.html https://news.ycombinator.com -s ".titleline > a"
+    `)
+        .option('selector', '-s <选择器> CSS 选择器 (必填)')
+        .option('title', '-t <标题> 自定义订阅标题')
+        .option('template', '-i <模板> 消息模板 (推荐 content)')
+        .option('text', '--text 只提取纯文本')
+        .option('puppeteer', '-P 使用 Puppeteer 渲染 (适用于SPA)')
+        .option('wait', '-w <毫秒> 渲染后等待时间')
+        .option('waitSelector', '-W <选择器> 等待特定元素出现')
+        .option('test', '-T 测试抓取结果 (不创建订阅)')
+        .example('rsso.html https://news.ycombinator.com -s ".titleline > a"')
+        .action(async ({ session, options }, url) => {
+        if (!url)
+            return '请输入 URL';
+        if (!options.selector)
+            return '请指定 CSS 选择器 (-s)';
+        const logContext = (0, utils_1.buildCommandLogContext)(session, 'rsso.html', options.test ? 'test' : 'create');
+        const { guildId, platform } = (0, utils_1.extractSessionInfo)(session);
+        const botSelfId = session.bot?.selfId;
+        const normalizedUrl = (0, common_1.ensureUrlProtocol)(url);
+        const rawArg = buildHtmlMonitorArg(options);
+        const arg = deps.mixinArg(rawArg);
+        try {
+            if (options.test) {
+                const items = await deps.getRssData(normalizedUrl, arg);
+                if (!items.length)
+                    return '未找到符合选择器的元素';
+                return buildItemsPreview(items, `找到 ${items.length} 个元素:`, true);
+            }
+            const rssList = await deps.ctx.database.get('rssOwl', { platform, guildId });
+            if (rssList.find(item => item.url === normalizedUrl))
+                return '该订阅已存在';
+            const htmlItems = await deps.getRssData(normalizedUrl, arg);
+            if (!htmlItems.length)
+                return '未找到符合选择器的元素，无法创建订阅';
+            const title = options.title || htmlItems[0]?.rss?.channel?.title || `HTML监控: ${normalizedUrl}`;
+            const rssItem = {
+                url: normalizedUrl,
+                platform,
+                guildId,
+                author: botSelfId,
+                rssId: title,
+                arg: rawArg,
+                title,
+                lastPubDate: new Date(),
+                lastContent: [],
+                followers: [],
+            };
+            if (deps.config.basic.urlDeduplication && rssList.find(item => item.rssId === rssItem.rssId)) {
+                return `订阅已存在: ${rssItem.rssId}`;
+            }
+            await deps.ctx.database.create('rssOwl', rssItem);
+            if (deps.config.basic.firstLoad && arg.firstLoad !== false && htmlItems.length > 0) {
+                await broadcastInitialItems(deps, `${platform}:${guildId}`, htmlItems, rssItem);
+            }
+            return `订阅成功: ${title}\n提示: HTML监控基于内容变化检测，请确保选择器稳定`;
+        }
+        catch (error) {
+            deps.debug(error, 'html error', 'error', logContext);
+            return `抓取失败: ${(0, error_handler_1.getFriendlyErrorMessage)(error, 'HTML监控')}`;
+        }
+    });
+}
+function registerAskCommand(deps) {
+    deps.ctx.guild()
+        .command('rssowl.ask <url:string> <instruction:text>', 'AI 智能订阅网页')
+        .alias('rsso.ask')
+        .usage(`AI 智能订阅功能，自动生成 CSS 选择器
+
+前置要求:
+  - 需要配置 AI 功能 (config.ai.enabled = true)
+  - 需要配置 API Key (config.ai.apiKey)
+
+用法:
+  rsso.ask https://news.ycombinator.com "监控首页的前5条新闻标题"
+
+示例:
+  rsso.ask https://www.zhihu.com/billboard "获取热榜第一条"
+  rsso.ask https://example.com "提取所有文章标题" -T
+    `)
+        .option('test', '-T 测试模式 (只分析不订阅)')
+        .example('rsso.ask https://news.ycombinator.com "监控首页的前5条新闻标题"')
+        .action(async ({ session, options }, url, instruction) => {
+        if (!url)
+            return '请输入网址';
+        if (!instruction)
+            return '请描述你的需求';
+        const logContext = (0, utils_1.buildCommandLogContext)(session, 'rsso.ask', options.test ? 'test' : 'analyze');
+        const normalizedUrl = (0, common_1.ensureUrlProtocol)(url);
+        try {
+            const html = await deps.fetchUrl(normalizedUrl);
+            const selector = await deps.generateSelectorByAI(normalizedUrl, instruction, html);
+            if (options.test) {
+                const items = await deps.getRssData(normalizedUrl, {
+                    type: 'html',
+                    selector,
+                    template: 'content',
+                });
+                if (!items.length)
+                    return `选择器未匹配到任何元素: ${selector}`;
+                return `AI 生成的选择器: ${selector}\n\n匹配到 ${items.length} 个元素:\n${items.slice(0, 2).map((item) => normalizePreviewText(item?.title) || '无标题').join('\n')}`;
+            }
+            return `AI 生成的选择器: ${selector}\n请使用 rsso.html ${normalizedUrl} -s "${selector}" 完成订阅`;
+        }
+        catch (error) {
+            deps.debug(error, 'ask error', 'error', logContext);
+            return `AI 分析失败: ${(0, error_handler_1.getFriendlyErrorMessage)(error, 'AI生成选择器')}`;
+        }
+    });
+}
+function registerWatchCommand(deps) {
+    deps.ctx.guild()
+        .command('rssowl.watch <url:string> [keyword:text]', '简单网页监控')
+        .alias('rsso.watch')
+        .usage(`
+简单网页监控，支持关键词或整页监控。
+用法:
+  rsso.watch https://example.com                    - 监控整页变化
+  rsso.watch https://example.com "缺货"             - 监控包含关键词的内容
+  rsso.watch https://example.com "缺货" -P          - SPA 动态页面
+  rsso.watch https://example.com "缺货" -T          - 测试模式 (只预览不订阅)
+    `)
+        .option('puppeteer', '-P 使用 Puppeteer 渲染')
+        .option('test', '-T 测试模式 (只预览不订阅)')
+        .example('rsso.watch https://example.com "缺货"')
+        .action(async ({ session, options }, url, keyword) => {
+        if (!url)
+            return '请输入 URL';
+        const logContext = (0, utils_1.buildCommandLogContext)(session, 'rsso.watch', options.test ? 'test' : 'preview');
+        const normalizedUrl = (0, common_1.ensureUrlProtocol)(url);
+        const arg = deps.mixinArg(buildWatchArg(keyword, options));
+        try {
+            if (options.test) {
+                const items = await deps.getRssData(normalizedUrl, arg);
+                if (!items.length)
+                    return '未找到内容';
+                return buildItemsPreview(items, `找到 ${items.length} 条内容:`, false);
+            }
+            return '请使用 rsso 命令完成订阅，或使用 -T 测试';
+        }
+        catch (error) {
+            deps.debug(error, 'watch error', 'error', logContext);
+            return `监控失败: ${(0, error_handler_1.getFriendlyErrorMessage)(error, '网页监控')}`;
+        }
+    });
+}
+function buildHtmlMonitorArg(options) {
+    return {
+        type: 'html',
+        selector: options.selector,
+        template: options.template || 'content',
+        textOnly: Boolean(options.text),
+        mode: options.puppeteer ? 'puppeteer' : 'static',
+        waitFor: options.wait ? parseInt(options.wait, 10) : undefined,
+        waitSelector: options.waitSelector,
+        title: options.title,
+    };
+}
+function buildWatchArg(keyword, options) {
+    return {
+        type: 'html',
+        selector: keyword ? `*:contains("${keyword}")` : 'body',
+        textOnly: Boolean(keyword),
+        mode: options.puppeteer ? 'puppeteer' : 'static',
+        template: 'content',
+    };
+}
+async function broadcastInitialItems(deps, target, items, rssItem) {
+    const maxItem = rssItem.arg?.forceLength || 1;
+    const mergedArg = deps.mixinArg(rssItem.arg || {});
+    const messageList = await Promise.all(items
+        .filter((_, index) => index < maxItem)
+        .map(async (item) => deps.parseRssItem(item, { ...rssItem, ...mergedArg }, rssItem.author)));
+    await deps.ctx.broadcast([target], messageList.join(''));
+}
+function buildItemsPreview(items, header, withContentLabel) {
+    const preview = items.slice(0, 3).map((item) => {
+        const title = normalizePreviewText(item?.title) || '无标题';
+        const description = truncatePreviewText(normalizePreviewText(item?.description), 100);
+        const body = withContentLabel ? `内容: ${description}` : description;
+        return `标题: ${title}\n${body}`;
+    }).join('\n\n');
+    return `${header}\n\n${preview}`;
+}
+function normalizePreviewText(value) {
+    if (Array.isArray(value))
+        return value.join('');
+    if (value === undefined || value === null)
+        return '';
+    return String(value);
+}
+function truncatePreviewText(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    return `${value.substring(0, maxLength)}...`;
+}

package/lib/config.js

@@ -164,6 +164,22 @@ exports.Config = koishi_1.Schema.object({
         enabled: koishi_1.Schema.boolean().description('启用消息缓存').default(true),
         maxSize: koishi_1.Schema.number().description('最大缓存消息条数').default(100),
     }).description('消息缓存设置'),
+    queue: koishi_1.Schema.object({
+        batchSize: koishi_1.Schema.number().min(1).max(50).description('每次处理发送队列的最大任务数').default(10),
+        maxRetries: koishi_1.Schema.number().min(0).max(20).description('临时错误的最大重试次数，超过后转为失败').default(5),
+        processInterval: koishi_1.Schema.number().min(5).max(3600).description('发送队列处理间隔（秒）').default(30),
+        cleanupHours: koishi_1.Schema.number().min(1).max(720).description('队列清理命令默认保留成功任务的小时数').default(24),
+    }).description('发送队列设置'),
+    security: koishi_1.Schema.object({
+        enabled: koishi_1.Schema.boolean().description('启用安全检查（建议开启）').default(false),
+        allowInternalAccess: koishi_1.Schema.boolean().description('允许访问内网 IP 地址（如本地部署的 RSSHub）').default(false),
+        whitelist: koishi_1.Schema.array(koishi_1.Schema.string()).description('URL 白名单域名').default([]),
+        blacklist: koishi_1.Schema.array(koishi_1.Schema.string()).description('URL 黑名单域名').default([]),
+        allowHttp: koishi_1.Schema.boolean().description('允许 HTTP 协议').default(true),
+        allowHttps: koishi_1.Schema.boolean().description('允许 HTTPS 协议').default(true),
+        sanitizeHtml: koishi_1.Schema.boolean().description('启用 RSS 原始 HTML 内容清理').default(true),
+        maxCacheSize: koishi_1.Schema.number().description('AI 摘要缓存最大条数').default(1000),
+    }).description('安全设置'),
     // customUrlEnable:Schema.boolean().description('开发中：允许使用自定义规则对网页进行提取，用于对非RSS链接抓取').default(false).experimental(),
     debug: koishi_1.Schema.union(["disable", "error", "info", "details"]).default("disable").description('调试级别'),
     logging: koishi_1.Schema.object({
@@ -173,5 +189,14 @@ exports.Config = koishi_1.Schema.object({
         includeModule: koishi_1.Schema.boolean().description('包含模块名').default(true),
         includeContext: koishi_1.Schema.boolean().description('包含额外上下文信息').default(false),
         contextFields: koishi_1.Schema.array(koishi_1.Schema.string()).description('要包含的上下文字段（如 guildId, platform 等）').default([]),
+        sanitizeLogs: koishi_1.Schema.boolean().description('自动脱敏日志中的敏感信息').default(true),
     }).description('日志设置'),
+    errorTracking: koishi_1.Schema.object({
+        enabled: koishi_1.Schema.boolean().description('启用错误追踪').default(false),
+        dsn: koishi_1.Schema.string().role('secret').description('Sentry DSN').default(''),
+        environment: koishi_1.Schema.string().description('错误追踪环境').default('production'),
+        release: koishi_1.Schema.string().description('错误追踪版本号').default('5.2.3'),
+        tracesSampleRate: koishi_1.Schema.number().min(0).max(1).description('性能追踪采样率').default(0.1),
+        profilesSampleRate: koishi_1.Schema.number().min(0).max(1).description('性能分析采样率').default(0.1),
+    }).description('错误追踪设置'),
 });

package/lib/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const usage = "\n<details>\n<summary>RSS-OWL \u8BA2\u9605\u5668\u4F7F\u7528\u8BF4\u660E</summary>\n\n## \u57FA\u672C\u547D\u4EE4:\n  rsso &lt;url&gt;              - \u8BA2\u9605RSS\u94FE\u63A5\n  rsso -l                 - \u67E5\u770B\u8BA2\u9605\u5217\u8868\n  rsso -l [id]            - \u67E5\u770B\u8BA2\u9605\u8BE6\u60C5\n  rsso -r &lt;content&gt;       - \u5220\u9664\u8BA2\u9605(\u9700\u8981\u6743\u9650)\n  rsso -T &lt;url&gt;           - \u6D4B\u8BD5\u8BA2\u9605\n  rsso.ask &lt;url&gt; &lt;\u9700\u6C42&gt;  - AI \u667A\u80FD\u8BA2\u9605\u7F51\u9875 (\u9700\u8981 AI \u914D\u7F6E)\n  rsso.watch &lt;url&gt; [\u5173\u952E\u8BCD] - \u7B80\u5355\u7F51\u9875\u76D1\u63A7 (\u5173\u952E\u8BCD/\u6574\u9875)\n\n## \u5E38\u7528\u9009\u9879:\n  -i &lt;template&gt;          - \u8BBE\u7F6E\u6D88\u606F\u6A21\u677F\n      \u53EF\u9009\u503C: content(\u6587\u5B57) | default(\u56FE\u7247) | custom(\u81EA\u5B9A\u4E49) | only text | only media \u7B49\n  -t &lt;title&gt;             - \u81EA\u5B9A\u4E49\u8BA2\u9605\u6807\u9898\n  -a &lt;arg&gt;               - \u81EA\u5B9A\u4E49\u914D\u7F6E (\u683C\u5F0F: key:value,key2:value2)\n      \u4F8B\u5982: -a timeout:30,merge:true\n\n## \u9AD8\u7EA7\u9009\u9879:\n  -f &lt;content&gt;           - \u5173\u6CE8\u8BA2\u9605\uFF0C\u66F4\u65B0\u65F6\u63D0\u9192\n  -fAll &lt;content&gt;        - \u5168\u4F53\u5173\u6CE8(\u9700\u8981\u9AD8\u7EA7\u6743\u9650)\n  -target &lt;groupId&gt;      - \u8DE8\u7FA4\u8BA2\u9605(\u9700\u8981\u9AD8\u7EA7\u6743\u9650)\n  -d &lt;time&gt;              - \u5B9A\u65F6\u63A8\u9001 (\u683C\u5F0F: \"HH:mm/\u6570\u91CF\" \u6216 \"HH:mm\")\n      \u4F8B\u5982: -d \"08:00/5\" \u8868\u793A\u6BCF\u59298\u70B9\u63A8\u90015\u6761\n  -p &lt;id&gt;                - \u624B\u52A8\u62C9\u53D6\u6700\u65B0\u5185\u5BB9\n\n## \u5FEB\u901F\u8BA2\u9605:\n  rsso -q                - \u67E5\u770B\u5FEB\u901F\u8BA2\u9605\u5217\u8868\n  rsso -q [\u7F16\u53F7]         - \u67E5\u770B\u5FEB\u901F\u8BA2\u9605\u8BE6\u60C5\n  rsso -T tg:channel_name  - \u5FEB\u901F\u8BA2\u9605Telegram\u9891\u9053\n\n## Assets \u56FE\u7247/\u89C6\u9891\u670D\u52A1\u914D\u7F6E (\u63A8\u8350):\n  \u4F7F\u7528 assets \u670D\u52A1\u53EF\u4EE5\u907F\u514D Base64 \u8D85\u957F\u95EE\u9898\n  1. \u5728\u63D2\u4EF6\u5E02\u573A\u5B89\u88C5 assets-xxx \u63D2\u4EF6 (\u5982 assets-local, assets-s3, assets-smms \u7B49)\n  2. \u5728\u5BF9\u5E94\u63D2\u4EF6\u4E2D\u914D\u7F6E\u5B58\u50A8\u4FE1\u606F (AccessKey, Secret, Bucket \u7B49)\n  3. \u5728 RSS-Owl \u57FA\u7840\u8BBE\u7F6E\u4E2D\u5C06 imageMode/videoMode \u8BBE\u7F6E\u4E3A 'assets'\n  4. \u63D2\u4EF6\u4F1A\u81EA\u52A8\u4E0A\u4F20\u56FE\u7247/\u89C6\u9891\u5230\u4F60\u7684\u56FE\u5E8A\u670D\u52A1\n\n## \u914D\u7F6E\u793A\u4F8B:\n  rsso -T -i content \"https://example.com/rss\"\n  rsso \"https://example.com/rss\" -t \"\u6211\u7684\u8BA2\u9605\" -a \"timeout:60,merge:true\"\n  rsso -d \"09:00/3\" \"https://example.com/rss\"\n\n</details>\n\n<details>\n<summary>\u7F51\u9875\u76D1\u63A7 (rsso.html) - \u76D1\u63A7\u4EFB\u610F\u7F51\u9875\u5143\u7D20\u53D8\u5316</summary>\n\n\u4F7F\u7528 CSS \u9009\u62E9\u5668\u76D1\u63A7\u7F51\u9875\u5143\u7D20\u53D8\u5316\uFF0C\u652F\u6301\u9759\u6001\u7F51\u9875\u548C SPA \u52A8\u6001\u9875\u9762\u3002\n\n## \u57FA\u672C\u7528\u6CD5:\n  rsso.html &lt;url&gt; -s &lt;selector&gt;      - \u76D1\u63A7\u7B26\u5408\u9009\u62E9\u5668\u7684\u5143\u7D20\n\n## \u5E38\u7528\u9009\u9879:\n  -s, --selector &lt;\u9009\u62E9\u5668&gt;    CSS \u9009\u62E9\u5668 (\u5FC5\u586B)\uFF0C\u4F8B\u5982: .news-item\u3001#price\u3001div.list > li\n  -t, --title &lt;\u6807\u9898&gt;         \u81EA\u5B9A\u4E49\u8BA2\u9605\u6807\u9898\n  -i, --template &lt;\u6A21\u677F&gt;      \u6D88\u606F\u6A21\u677F (\u63A8\u8350 content)\n  --text                     \u53EA\u63D0\u53D6\u7EAF\u6587\u672C (\u9ED8\u8BA4\u63D0\u53D6 HTML)\n  -T, --test                 \u6D4B\u8BD5\u6A21\u5F0F\uFF0C\u67E5\u770B\u6293\u53D6\u9884\u89C8\n\n## Puppeteer \u52A8\u6001\u6E32\u67D3 (\u89E3\u51B3 SPA/JS \u52A8\u6001\u5185\u5BB9):\n  -P, --puppeteer            \u4F7F\u7528 Puppeteer \u6E32\u67D3\u9875\u9762 (\u9700\u8981\u5B89\u88C5 koishi-plugin-puppeteer)\n  -w, --wait &lt;\u6BEB\u79D2&gt;          \u6E32\u67D3\u540E\u7B49\u5F85\u65F6\u95F4\n  -W, --waitSelector &lt;\u9009\u62E9\u5668&gt;  \u7B49\u5F85\u7279\u5B9A\u5143\u7D20\u51FA\u73B0\n\n</details>\n\n<details>\n<summary>AI \u6458\u8981 (ai) - \u667A\u80FD\u751F\u6210\u5185\u5BB9\u6458\u8981</summary>\n\n\u4F7F\u7528 OpenAI \u517C\u5BB9 API \u4E3A\u8BA2\u9605\u5185\u5BB9\u751F\u6210 AI \u6458\u8981\u3002\n\n## \u542F\u7528\u65B9\u6CD5:\n  1. \u5728\u63D2\u4EF6\u914D\u7F6E\u4E2D\u5F00\u542F AI \u529F\u80FD\n  2. \u586B\u5199 API Base URL\u3001API Key \u548C\u6A21\u578B\u540D\u79F0\n\n## \u914D\u7F6E\u9879:\n  - placement           \u6458\u8981\u4F4D\u7F6E: top (\u9876\u90E8) / bottom (\u5E95\u90E8)\n  - separator          \u5206\u5272\u7EBF\u6837\u5F0F\n  - prompt             \u63D0\u793A\u8BCD\u6A21\u677F ({{title}} \u6807\u9898, {{content}} \u5185\u5BB9)\n  - maxInputLength     \u6700\u5927\u8F93\u5165\u957F\u5EA6 (\u9ED8\u8BA4 2000 \u5B57)\n  - timeout            \u8BF7\u6C42\u8D85\u65F6 (\u9ED8\u8BA4 30000 \u6BEB\u79D2)\n\n\n</details>\n";
+export declare const usage = "\n<details>\n<summary>RSS-OWL \u547D\u4EE4\u5BFC\u822A\uFF08\u53D1\u9001 rsso \u67E5\u770B\u672C\u5E2E\u52A9\uFF09</summary>\n\n## \u65B0\u5EFA / \u6D4B\u8BD5\u8BA2\u9605:\n  rsso &lt;url&gt;                              - \u521B\u5EFA RSS / Atom / JSON Feed \u8BA2\u9605\n  rsso -T &lt;url&gt;                           - \u6D4B\u8BD5\u6293\u53D6\uFF0C\u4E0D\u5199\u5165\u8BA2\u9605\n  rsso &lt;url&gt; -t &lt;\u6807\u9898&gt;                    - \u81EA\u5B9A\u4E49\u8BA2\u9605\u6807\u9898\n  rsso &lt;url&gt; -i &lt;\u6A21\u677F&gt;                    - \u6307\u5B9A\u6D88\u606F\u6A21\u677F\n  rsso &lt;url&gt; -a &lt;key:value,...&gt;          - \u8986\u76D6\u8BA2\u9605\u53C2\u6570\n  rsso &lt;url&gt; -d &lt;HH:mm[/\u6570\u91CF]&gt;           - \u6BCF\u65E5\u5B9A\u65F6\u63A8\u9001\n  rsso &lt;url&gt; --target &lt;\u5E73\u53F0:\u9891\u9053&gt;         - \u8DE8\u7FA4 / \u8DE8\u9891\u9053\u8BA2\u9605\uFF08\u9AD8\u7EA7\u6743\u9650\uFF09\n  rsso -q [\u7F16\u53F7]                          - \u67E5\u770B\u5FEB\u901F\u8BA2\u9605\u5217\u8868 / \u8BE6\u60C5\n\n## \u7BA1\u7406\u8BA2\u9605\uFF08\u4F7F\u7528\u5217\u8868\u5E8F\u53F7\uFF09:\n  rsso.list [id]                          - \u67E5\u770B\u8BA2\u9605\u5217\u8868 / \u8BE6\u60C5\n  rsso.remove &lt;id&gt; [--all]               - \u5220\u9664\u8BA2\u9605 / \u5220\u9664\u5168\u90E8\n  rsso.pull &lt;id&gt;                         - \u62C9\u53D6\u8BA2\u9605\u6700\u65B0\u5185\u5BB9\n  rsso.follow &lt;id&gt; [--all]               - \u5173\u6CE8\u8BA2\u9605\u66F4\u65B0 / \u5168\u5458\u63D0\u9192\n  rsso.edit &lt;id&gt; [\u9009\u9879]                  - \u4FEE\u6539\u6807\u9898\u3001URL\u3001\u6A21\u677F\u3001\u9009\u62E9\u5668\u3001\u76EE\u6807\n  rsso.cache                             - \u6D88\u606F\u7F13\u5B58\u7BA1\u7406\n  rsso.queue                             - \u53D1\u9001\u961F\u5217\u7BA1\u7406\n\n## \u7F51\u9875\u76D1\u63A7\u76F8\u5173:\n  rsso.html &lt;url&gt; -s &lt;selector&gt;          - \u4F7F\u7528 CSS \u9009\u62E9\u5668\u76D1\u63A7\u7F51\u9875\n  rsso.ask &lt;url&gt; &lt;\u9700\u6C42&gt;                  - AI \u751F\u6210\u9009\u62E9\u5668\u540E\u521B\u5EFA\u7F51\u9875\u8BA2\u9605\n  rsso.watch &lt;url&gt; [\u5173\u952E\u8BCD]              - \u7B80\u5355\u7F51\u9875 / \u5173\u952E\u8BCD\u76D1\u63A7\n\n## \u5E38\u7528\u6A21\u677F:\n  content        - \u7EAF\u6587\u5B57\u6B63\u6587\n  default        - \u9ED8\u8BA4\u56FE\u7247\u6A21\u677F\n  custom         - \u81EA\u5B9A\u4E49\u6A21\u677F\n  only text      - \u4EC5\u6587\u672C\n  only image     - \u4EC5\u56FE\u7247\n  only media     - \u56FE\u7247 + \u89C6\u9891\n  link           - \u8DDF\u968F\u6B63\u6587\u4E2D\u7684\u7B2C\u4E00\u4E2A\u94FE\u63A5\n\n## \u5E38\u7528\u793A\u4F8B:\n  rsso https://example.com/rss\n  rsso -T tg:woshadiao\n  rsso https://example.com/rss -i content -t \"\u793A\u4F8B\u8BA2\u9605\"\n  rsso.list\n  rsso.edit 1 -t \"\u65B0\u6807\u9898\"\n  rsso.html https://example.com -s \".news-item\"\n\n## \u517C\u5BB9\u63D0\u793A:\n  \u65E7\u9009\u9879 -l / -r / -f / -p \u4ECD\u4F1A\u8FD4\u56DE\u8FC1\u79FB\u63D0\u793A\uFF0C\n  \u5EFA\u8BAE\u6539\u7528 rsso.list / rsso.remove / rsso.follow / rsso.pull\u3002\n\n</details>\n";
 export declare const quickList: {
     prefix: string;
     name: string;

package/lib/constants.js

@@ -3,89 +3,52 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.quickList = exports.usage = void 0;
 exports.usage = `
 <details>
-<summary>RSS-OWL 订阅器使用说明</summary>
-
-## 基本命令:
-  rsso &lt;url&gt;              - 订阅RSS链接
-  rsso -l                 - 查看订阅列表
-  rsso -l [id]            - 查看订阅详情
-  rsso -r &lt;content&gt;       - 删除订阅(需要权限)
-  rsso -T &lt;url&gt;           - 测试订阅
-  rsso.ask &lt;url&gt; &lt;需求&gt;  - AI 智能订阅网页 (需要 AI 配置)
-  rsso.watch &lt;url&gt; [关键词] - 简单网页监控 (关键词/整页)
-
-## 常用选项:
-  -i &lt;template&gt;          - 设置消息模板
-      可选值: content(文字) | default(图片) | custom(自定义) | only text | only media 等
-  -t &lt;title&gt;             - 自定义订阅标题
-  -a &lt;arg&gt;               - 自定义配置 (格式: key:value,key2:value2)
-      例如: -a timeout:30,merge:true
-
-## 高级选项:
-  -f &lt;content&gt;           - 关注订阅，更新时提醒
-  -fAll &lt;content&gt;        - 全体关注(需要高级权限)
-  -target &lt;groupId&gt;      - 跨群订阅(需要高级权限)
-  -d &lt;time&gt;              - 定时推送 (格式: "HH:mm/数量" 或 "HH:mm")
-      例如: -d "08:00/5" 表示每天8点推送5条
-  -p &lt;id&gt;                - 手动拉取最新内容
-
-## 快速订阅:
-  rsso -q                - 查看快速订阅列表
-  rsso -q [编号]         - 查看快速订阅详情
-  rsso -T tg:channel_name  - 快速订阅Telegram频道
-
-## Assets 图片/视频服务配置 (推荐):
-  使用 assets 服务可以避免 Base64 超长问题
-  1. 在插件市场安装 assets-xxx 插件 (如 assets-local, assets-s3, assets-smms 等)
-  2. 在对应插件中配置存储信息 (AccessKey, Secret, Bucket 等)
-  3. 在 RSS-Owl 基础设置中将 imageMode/videoMode 设置为 'assets'
-  4. 插件会自动上传图片/视频到你的图床服务
-
-## 配置示例:
-  rsso -T -i content "https://example.com/rss"
-  rsso "https://example.com/rss" -t "我的订阅" -a "timeout:60,merge:true"
-  rsso -d "09:00/3" "https://example.com/rss"
-
-</details>
-
-<details>
-<summary>网页监控 (rsso.html) - 监控任意网页元素变化</summary>
-
-使用 CSS 选择器监控网页元素变化，支持静态网页和 SPA 动态页面。
-
-## 基本用法:
-  rsso.html &lt;url&gt; -s &lt;selector&gt;      - 监控符合选择器的元素
-
-## 常用选项:
-  -s, --selector &lt;选择器&gt;    CSS 选择器 (必填)，例如: .news-item、#price、div.list > li
-  -t, --title &lt;标题&gt;         自定义订阅标题
-  -i, --template &lt;模板&gt;      消息模板 (推荐 content)
-  --text                     只提取纯文本 (默认提取 HTML)
-  -T, --test                 测试模式，查看抓取预览
-
-## Puppeteer 动态渲染 (解决 SPA/JS 动态内容):
-  -P, --puppeteer            使用 Puppeteer 渲染页面 (需要安装 koishi-plugin-puppeteer)
-  -w, --wait &lt;毫秒&gt;          渲染后等待时间
-  -W, --waitSelector &lt;选择器&gt;  等待特定元素出现
-
-</details>
-
-<details>
-<summary>AI 摘要 (ai) - 智能生成内容摘要</summary>
-
-使用 OpenAI 兼容 API 为订阅内容生成 AI 摘要。
-
-## 启用方法:
-  1. 在插件配置中开启 AI 功能
-  2. 填写 API Base URL、API Key 和模型名称
-
-## 配置项:
-  - placement           摘要位置: top (顶部) / bottom (底部)
-  - separator          分割线样式
-  - prompt             提示词模板 ({{title}} 标题, {{content}} 内容)
-  - maxInputLength     最大输入长度 (默认 2000 字)
-  - timeout            请求超时 (默认 30000 毫秒)
-
+<summary>RSS-OWL 命令导航（发送 rsso 查看本帮助）</summary>
+
+## 新建 / 测试订阅:
+  rsso &lt;url&gt;                              - 创建 RSS / Atom / JSON Feed 订阅
+  rsso -T &lt;url&gt;                           - 测试抓取，不写入订阅
+  rsso &lt;url&gt; -t &lt;标题&gt;                    - 自定义订阅标题
+  rsso &lt;url&gt; -i &lt;模板&gt;                    - 指定消息模板
+  rsso &lt;url&gt; -a &lt;key:value,...&gt;          - 覆盖订阅参数
+  rsso &lt;url&gt; -d &lt;HH:mm[/数量]&gt;           - 每日定时推送
+  rsso &lt;url&gt; --target &lt;平台:频道&gt;         - 跨群 / 跨频道订阅（高级权限）
+  rsso -q [编号]                          - 查看快速订阅列表 / 详情
+
+## 管理订阅（使用列表序号）:
+  rsso.list [id]                          - 查看订阅列表 / 详情
+  rsso.remove &lt;id&gt; [--all]               - 删除订阅 / 删除全部
+  rsso.pull &lt;id&gt;                         - 拉取订阅最新内容
+  rsso.follow &lt;id&gt; [--all]               - 关注订阅更新 / 全员提醒
+  rsso.edit &lt;id&gt; [选项]                  - 修改标题、URL、模板、选择器、目标
+  rsso.cache                             - 消息缓存管理
+  rsso.queue                             - 发送队列管理
+
+## 网页监控相关:
+  rsso.html &lt;url&gt; -s &lt;selector&gt;          - 使用 CSS 选择器监控网页
+  rsso.ask &lt;url&gt; &lt;需求&gt;                  - AI 生成选择器后创建网页订阅
+  rsso.watch &lt;url&gt; [关键词]              - 简单网页 / 关键词监控
+
+## 常用模板:
+  content        - 纯文字正文
+  default        - 默认图片模板
+  custom         - 自定义模板
+  only text      - 仅文本
+  only image     - 仅图片
+  only media     - 图片 + 视频
+  link           - 跟随正文中的第一个链接
+
+## 常用示例:
+  rsso https://example.com/rss
+  rsso -T tg:woshadiao
+  rsso https://example.com/rss -i content -t "示例订阅"
+  rsso.list
+  rsso.edit 1 -t "新标题"
+  rsso.html https://example.com -s ".news-item"
+
+## 兼容提示:
+  旧选项 -l / -r / -f / -p 仍会返回迁移提示，
+  建议改用 rsso.list / rsso.remove / rsso.follow / rsso.pull。
 
 </details>
 `;

package/lib/core/ai-cache.d.ts

@@ -0,0 +1,27 @@
+export declare class AiSummaryCache {
+    private cache;
+    private ttl;
+    private maxSize;
+    private accessOrder;
+    constructor(ttl?: number, maxSize?: number);
+    private evictIfNeeded;
+    private updateAccessOrder;
+    private removeAccessOrder;
+    private generateKey;
+    get(title: string, content: string): string | null;
+    set(title: string, content: string, summary: string): void;
+    cleanExpired(): void;
+    clear(): void;
+    getStats(): {
+        size: number;
+        keys: string[];
+    };
+}
+export declare function initAiCache(ttl?: number, maxSize?: number): void;
+export declare function getOrInitAiCache(ttl?: number, maxSize?: number): AiSummaryCache;
+export declare function cleanExpiredCache(): void;
+export declare function clearAiCache(): void;
+export declare function getAiCacheStats(): {
+    size: number;
+    keys: string[];
+} | null;

package/lib/core/ai-cache.js

@@ -0,0 +1,169 @@
+"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.AiSummaryCache = void 0;
+exports.initAiCache = initAiCache;
+exports.getOrInitAiCache = getOrInitAiCache;
+exports.cleanExpiredCache = cleanExpiredCache;
+exports.clearAiCache = clearAiCache;
+exports.getAiCacheStats = getAiCacheStats;
+const crypto = __importStar(require("crypto"));
+const logger_1 = require("../utils/logger");
+class AiSummaryCache {
+    cache = new Map();
+    ttl;
+    maxSize;
+    accessOrder = [];
+    constructor(ttl = 24 * 60 * 60 * 1000, maxSize = 1000) {
+        this.ttl = ttl;
+        this.maxSize = maxSize;
+    }
+    evictIfNeeded() {
+        while (this.cache.size >= this.maxSize && this.accessOrder.length > 0) {
+            const oldestKey = this.accessOrder.shift();
+            if (oldestKey && this.cache.has(oldestKey)) {
+                this.cache.delete(oldestKey);
+            }
+            if (this.accessOrder.length === 0 && this.cache.size >= this.maxSize) {
+                const randomKey = this.cache.keys().next().value;
+                if (randomKey) {
+                    this.cache.delete(randomKey);
+                }
+                break;
+            }
+        }
+    }
+    updateAccessOrder(key) {
+        const index = this.accessOrder.indexOf(key);
+        if (index > -1) {
+            this.accessOrder.splice(index, 1);
+        }
+        this.accessOrder.push(key);
+    }
+    removeAccessOrder(key) {
+        const index = this.accessOrder.indexOf(key);
+        if (index > -1) {
+            this.accessOrder.splice(index, 1);
+        }
+    }
+    generateKey(title, content) {
+        return crypto
+            .createHash('sha256')
+            .update(`${title}|||${content}`)
+            .digest('hex');
+    }
+    get(title, content) {
+        const key = this.generateKey(title, content);
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        if (Date.now() - entry.timestamp > this.ttl) {
+            this.cache.delete(key);
+            this.removeAccessOrder(key);
+            return null;
+        }
+        this.updateAccessOrder(key);
+        entry.lastAccess = Date.now();
+        return entry.summary;
+    }
+    set(title, content, summary) {
+        const key = this.generateKey(title, content);
+        if (this.cache.has(key)) {
+            this.updateAccessOrder(key);
+            const entry = this.cache.get(key);
+            entry.summary = summary;
+            entry.timestamp = Date.now();
+            entry.lastAccess = Date.now();
+            return;
+        }
+        this.evictIfNeeded();
+        this.cache.set(key, {
+            summary,
+            timestamp: Date.now(),
+            lastAccess: Date.now()
+        });
+        this.accessOrder.push(key);
+    }
+    cleanExpired() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > this.ttl) {
+                this.cache.delete(key);
+                this.removeAccessOrder(key);
+            }
+        }
+    }
+    clear() {
+        this.cache.clear();
+        this.accessOrder = [];
+    }
+    getStats() {
+        return {
+            size: this.cache.size,
+            keys: Array.from(this.cache.keys())
+        };
+    }
+}
+exports.AiSummaryCache = AiSummaryCache;
+let globalCache = null;
+function initAiCache(ttl, maxSize) {
+    if (!globalCache) {
+        const defaultMaxSize = 1000;
+        globalCache = new AiSummaryCache(ttl, maxSize || defaultMaxSize);
+        (0, logger_1.debug)({ debug: 'info' }, `AI 摘要缓存已初始化 (TTL: ${ttl || 24 * 60 * 60 * 1000}ms, MaxSize: ${maxSize || defaultMaxSize})`, 'AI-Cache', 'info');
+    }
+}
+function getOrInitAiCache(ttl, maxSize) {
+    if (!globalCache) {
+        initAiCache(ttl, maxSize);
+    }
+    return globalCache;
+}
+function cleanExpiredCache() {
+    if (globalCache) {
+        globalCache.cleanExpired();
+    }
+}
+function clearAiCache() {
+    if (globalCache) {
+        globalCache.clear();
+    }
+}
+function getAiCacheStats() {
+    if (globalCache) {
+        return globalCache.getStats();
+    }
+    return null;
+}

package/lib/core/ai-client.d.ts

@@ -0,0 +1,12 @@
+import { Config } from '../types';
+export interface SummaryResult {
+    success: boolean;
+    summary: string;
+    cached: boolean;
+    error?: string;
+}
+export declare function requestAiText(config: Config, prompt: string, options?: {
+    temperature?: number;
+    timeout?: number;
+}): Promise<string>;
+export declare function callAiApi(config: Config, prompt: string, context: string): Promise<SummaryResult>;