@anyul/koishi-plugin-rss 5.2.48 → 5.3.1

package/lib/commands/subscription-create.d.ts

@@ -1,14 +1,27 @@
 import { Context } from 'koishi';
 import type { Config } from '../types';
+export interface QuickListItem {
+    prefix: string;
+    name: string;
+    detail: string;
+    example: string;
+    replace: string;
+}
+/**
+ * 按稳定键解析快速订阅项（审查 #12）。
+ * 优先按 prefix（稳定标识）匹配，避免数组重排导致「编号 1 指向不同项」的漂移；
+ * prefix 未命中时再回退到数字序号（向后兼容老用法）。
+ * 返回 null 表示既非合法 prefix 也非合法序号。
+ */
+export declare function resolveQuickItem(input: string, quickList: QuickListItem[]): {
+    item: QuickListItem;
+    matchedBy: 'prefix' | 'index';
+} | null;
 export interface SubscriptionCreateCommandDeps {
     ctx: Context;
     config: Config;
     usage: string;
-    quickList: Array<{
-        name: string;
-        detail: string;
-        example: string;
-    }>;
+    quickList: QuickListItem[];
     parseQuickUrl: (url: string) => string;
     parsePubDate: (pubDate: any) => Date;
     getRssData: (url: string, arg: any) => Promise<any[]>;

package/lib/commands/subscription-create.js

@@ -1,9 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveQuickItem = resolveQuickItem;
 exports.registerSubscriptionCreateCommand = registerSubscriptionCreateCommand;
 const common_1 = require("../utils/common");
 const error_handler_1 = require("../utils/error-handler");
 const utils_1 = require("./utils");
+/**
+ * 按稳定键解析快速订阅项（审查 #12）。
+ * 优先按 prefix（稳定标识）匹配，避免数组重排导致「编号 1 指向不同项」的漂移；
+ * prefix 未命中时再回退到数字序号（向后兼容老用法）。
+ * 返回 null 表示既非合法 prefix 也非合法序号。
+ */
+function resolveQuickItem(input, quickList) {
+    if (!input)
+        return null;
+    const trimmed = String(input).trim();
+    // 1) prefix 精确匹配（稳定键）
+    const byPrefix = quickList.find(q => q.prefix === trimmed);
+    if (byPrefix)
+        return { item: byPrefix, matchedBy: 'prefix' };
+    // 2) 数字序号回退（兼容历史用法，依赖数组顺序，不稳定）
+    const num = parseInt(trimmed, 10);
+    if (!Number.isNaN(num) && num >= 1 && num <= quickList.length) {
+        const item = quickList[num - 1];
+        return { item, matchedBy: 'index' };
+    }
+    return null;
+}
 /**
  * 注册主订阅命令。
  */
@@ -12,16 +35,10 @@ function registerSubscriptionCreateCommand(deps) {
         .command('rssowl <url:text>', '订阅 RSS/源')
         .alias('rsso')
         .usage(deps.usage)
-        .option('list', '-l [content] 查看订阅列表(详情) [已移至 rsso.list 子命令，使用列表序号]')
-        .option('remove', '-r <序号> 删除订阅 [已移至 rsso.remove 子命令，使用列表序号]')
-        .option('removeAll', '删除全部订阅 [已移至 rsso.remove --all 子命令]')
-        .option('follow', '-f <序号> 关注订阅 [已移至 rsso.follow 子命令，使用列表序号]')
-        .option('followAll', '<序号> 在该订阅更新时提醒所有人 [已移至 rsso.follow --all 子命令，使用列表序号]')
         .option('target', '--target <platform:guildId> 跨群订阅（高级权限）')
         .option('arg', '-a <content> 自定义配置')
         .option('template', '-i <content> 消息模板')
         .option('title', '-t <content> 自定义命名')
-        .option('pull', '-p <序号> 拉取订阅最新更新 [已移至 rsso.pull 子命令，使用列表序号]')
         .option('force', '强行写入')
         .option('daily', '-d <content>')
         .option('test', '-T 测试')
@@ -34,34 +51,29 @@ function registerSubscriptionCreateCommand(deps) {
         const botSelfId = session.bot?.selfId;
         deps.debug(`${platform}:${userId}:${guildId}, bot:${botSelfId}`, '', 'info', logContext);
         if (options?.quick === '') {
-            return '输入 rsso -q [id] 查询详情\n' + deps.quickList.map((v, i) => `${i + 1}.${v.name}`).join('\n');
+            // 同时显示序号与 prefix，引导用户使用稳定的 prefix 键
+            return '输入 rsso -q <prefix|序号> 查询详情\n' + deps.quickList.map((v, i) => `${i + 1}.${v.name} [${v.prefix}]`).join('\n');
         }
         if (options?.quick) {
-            const currentQuickObj = deps.quickList[parseInt(options.quick) - 1];
-            if (!currentQuickObj)
-                return `快速订阅编号不存在: ${options.quick}`;
-            return `${currentQuickObj.name}\n${currentQuickObj.detail}\n例:rsso -T ${currentQuickObj.example}\n(${deps.parseQuickUrl(currentQuickObj.example)})`;
+            const resolved = resolveQuickItem(options.quick, deps.quickList);
+            if (!resolved)
+                return `快速订阅不存在: ${options.quick}\n💡 使用 rsso -q 查看可用列表（支持 prefix 或序号）`;
+            const { item: currentQuickObj, matchedBy } = resolved;
+            const hint = matchedBy === 'index' ? '\n💡 提示：序号会随列表调整变化，推荐使用 prefix [' + currentQuickObj.prefix + '] 作为稳定键' : '';
+            return `${currentQuickObj.name}\n${currentQuickObj.detail}\n例:rsso -T ${currentQuickObj.example}\n(${deps.parseQuickUrl(currentQuickObj.example)})${hint}`;
         }
         if (platform.includes('sandbox') && !options.test && url) {
             session.send('沙盒中无法推送更新，但RSS依然会被订阅，建议使用 -T 选项进行测试');
         }
-        const rssList = await deps.ctx.database.get('rssOwl', { platform, guildId });
-        if (options?.list === '' || options?.list)
-            return '💡 提示：请使用子命令查看订阅\n\nrsso.list              - 查看所有订阅（显示序号）\nrsso.list 1            - 查看订阅详情\n\n（旧选项 -l 仍可使用，但建议迁移到新命令）';
-        if (options?.remove)
-            return '💡 提示：请使用子命令删除订阅\n\nrsso.remove 1           - 删除订阅 #1（使用列表序号）\nrsso.remove --all       - 删除全部订阅\n\n（旧选项 -r 仍可使用，但建议迁移到新命令）';
-        if (options?.removeAll)
-            return '💡 提示：请使用子命令删除订阅\n\nrsso.remove --all       - 删除全部订阅\n\n（旧选项仍可使用，但建议迁移到新命令）';
-        if (options?.follow)
-            return '💡 提示：请使用子命令关注订阅\n\nrsso.follow 1           - 关注订阅 #1（使用列表序号）\n\n（旧选项 -f 仍可使用，但建议迁移到新命令）';
-        if (options?.followAll)
-            return '💡 提示：请使用子命令设置全员提醒\n\nrsso.follow 1 --all     - 设置全员提醒（使用列表序号）\n\n（旧选项仍可使用，但建议迁移到新命令）';
-        if (options?.pull)
-            return '💡 提示：请使用子命令拉取订阅\n\nrsso.pull 1             - 拉取订阅 #1 的最新更新（使用列表序号）\n\n（旧选项 -p 仍可使用，但建议迁移到新命令）';
         if (!url)
             return deps.usage;
+        // 校验 URL 格式，给用户即时反馈，避免带着非法 URL 走到网络请求
+        if (!(0, utils_1.isValidUrl)((0, common_1.ensureUrlProtocol)(url))) {
+            return '❌ URL 格式不正确，请以 http:// 或 https:// 开头';
+        }
+        const rssList = await deps.ctx.database.get('rssOwl', { platform, guildId });
         if (rssList.find(item => item.url === url))
-            return '该订阅已存在';
+            return '❌ 该订阅已存在';
         const rawArg = deps.formatArg(options);
         const arg = deps.mixinArg(rawArg);
         let targetPlatform = platform;
@@ -78,7 +90,7 @@ function registerSubscriptionCreateCommand(deps) {
             targetGuildId = parsedTarget.guildId;
             if (options.test) {
                 try {
-                    await deps.ctx.broadcast([`${targetPlatform}:${targetGuildId}`], '📤 跨群订阅测试消息');
+                    await deps.ctx.broadcast([`${targetPlatform}:${targetGuildId}`], '跨群订阅测试消息');
                     return `✅ 测试消息已发送到目标群组\n目标: ${targetPlatform}:${targetGuildId}\n\n说明：Bot 可以访问该群组，跨群订阅可以正常工作。\n去掉 --test 选项完成订阅。`;
                 }
                 catch (error) {
@@ -123,7 +135,7 @@ function registerSubscriptionCreateCommand(deps) {
                     return forceCheck.message;
             }
             else if (deps.config.basic.urlDeduplication && rssList.find(item => item.rssId === rssItem.rssId)) {
-                return `订阅已存在: ${rssItem.rssId}`;
+                return `❌ 订阅已存在: ${rssItem.rssId}`;
             }
             await deps.ctx.database.create('rssOwl', rssItem);
             if (deps.config.basic.firstLoad && arg.firstLoad !== false && rssItemList.length > 0) {
@@ -135,7 +147,7 @@ function registerSubscriptionCreateCommand(deps) {
                 const messageList = await Promise.all(itemArray.filter((_, index) => index < maxItem).map(async (item) => deps.parseRssItem(item, { ...rssItem, ...mergedArg }, rssItem.author)));
                 await deps.ctx.broadcast([`${targetPlatform}:${targetGuildId}`], messageList.join(''));
             }
-            return `订阅成功: ${title}`;
+            return `✅ 订阅成功: ${title}`;
         }
         catch (error) {
             deps.debug(error, 'add error', 'error', logContext);

package/lib/commands/subscription-edit.js

@@ -5,7 +5,7 @@ const utils_1 = require("./utils");
 function registerSubscriptionEditCommand(deps) {
     deps.ctx.guild()
         .command('rssowl.edit <id:number>', '修改订阅配置')
-        .alias('rsso.edit')
+        .alias('rsso.edit', 'rsed')
         .usage(`修改订阅的配置项
 
 用法:
@@ -14,7 +14,7 @@ function registerSubscriptionEditCommand(deps) {
   rsso.edit 1 -u https://...      - 修改URL
   rsso.edit 1 -s ".item"         - 修改选择器（HTML监控）
   rsso.edit 1 --target onebot:123  - 修改推送目标（高级权限）
-  rsso.edit 1 --target "onebot:123,telegram:456"  - 多个推送目标（高级权限）⭐
+  rsso.edit 1 --target "onebot:123,telegram:456"  - 多个推送目标（高级权限）
   rsso.edit 1 -t "新标题" --test  - 测试修改（不保存）
 
 示例:
@@ -53,7 +53,7 @@ function registerSubscriptionEditCommand(deps) {
         }
         const hasChanges = options.title || options.url || options.template || options.selector || options.target;
         if (!hasChanges) {
-            return '请指定要修改的内容\n可用选项: -t (标题), -u (URL), -i (模板), -s (选择器), --target (推送目标)\n使用 --help 查看详细帮助';
+            return '❌ 请指定要修改的内容\n可用选项: -t (标题), -u (URL), -i (模板), -s (选择器), --target (推送目标)\n💡 使用 --help 查看详细帮助';
         }
         const parseResult = (0, utils_1.parseTargets)(options.target);
         if (parseResult.invalidTarget) {
@@ -66,7 +66,7 @@ function registerSubscriptionEditCommand(deps) {
     });
 }
 function buildEditPreview(rssItem, id, options, parsedTargets) {
-    let testOutput = `📝 修改预览 [序号:${id} | ID:${rssItem.id}]\n\n`;
+    let testOutput = `修改预览 [序号:${id} | ID:${rssItem.id}]\n\n`;
     testOutput += `当前标题: ${rssItem.title}\n`;
     testOutput += `当前URL: ${rssItem.url}\n`;
     testOutput += `当前推送目标: ${rssItem.platform}:${rssItem.guildId}\n`;
@@ -130,7 +130,7 @@ async function saveSubscriptionChanges(ctx, rssItem, id, options, parsedTargets)
             const originalTarget = `${rssItem.platform}:${rssItem.guildId}`;
             let result = `✅ 订阅已更新 [序号:${id} | ID:${rssItem.id}]\n\n`;
             result += `已创建 ${parsedTargets.length} 个推送目标:\n\n`;
-            result += `1️⃣ 原订阅 (本群): ${originalTarget}\n`;
+            result += `1. 原订阅 (本群): ${originalTarget}\n`;
             await ctx.database.set('rssOwl', rssItem.id, updates);
             for (let i = 0; i < parsedTargets.length; i++) {
                 const [newPlatform, newGuildId] = parsedTargets[i].split(/[:：]/);

package/lib/commands/subscription-management.js

@@ -14,7 +14,7 @@ function registerSubscriptionManagementCommands(deps) {
 function registerListCommand(deps) {
     deps.ctx.guild()
         .command('rssowl.list [id:number]', '查看订阅列表')
-        .alias('rsso.list')
+        .alias('rsso.list', 'rsls')
         .usage(`查看订阅列表
 
 用法:
@@ -40,9 +40,9 @@ function registerListCommand(deps) {
         const pushTarget = `${rssItem.platform}:${rssItem.guildId}`;
         const isCrossGroup = rssItem.platform !== platform || rssItem.guildId !== guildId;
         const targetInfo = isCrossGroup
-            ? `📤 推送目标: ${pushTarget} (跨群订阅)`
-            : `📤 推送目标: ${pushTarget} (本群)`;
-        return `📰 订阅详情 [序号:${id} | ID:${rssItem.id}]
+            ? `推送目标: ${pushTarget} (跨群订阅)`
+            : `推送目标: ${pushTarget} (本群)`;
+        return `订阅详情 [序号:${id} | ID:${rssItem.id}]
 标题: ${rssItem.title}
 链接: ${rssItem.url}
 类型: ${rssItem.arg?.type || 'RSS'}
@@ -55,7 +55,7 @@ ${targetInfo}
 function registerRemoveCommand(deps) {
     deps.ctx.guild()
         .command('rssowl.remove <id:number>', '删除订阅')
-        .alias('rsso.remove')
+        .alias('rsso.remove', 'rsrm')
         .usage(`删除订阅
 
 用法:
@@ -84,7 +84,7 @@ function registerRemoveCommand(deps) {
 function registerPullCommand(deps) {
     deps.ctx.guild()
         .command('rssowl.pull <id:number>', '拉取订阅最新内容')
-        .alias('rsso.pull')
+        .alias('rsso.pull', 'rspl')
         .usage(`拉取订阅最新内容
 
 用法:
@@ -129,7 +129,7 @@ function registerPullCommand(deps) {
 function registerFollowCommand(deps) {
     deps.ctx.guild()
         .command('rssowl.follow <id:number>', '关注订阅')
-        .alias('rsso.follow')
+        .alias('rsso.follow', 'rsfw')
         .usage(`关注订阅，在该订阅更新时提醒你
 
 用法:
@@ -150,13 +150,13 @@ function registerFollowCommand(deps) {
             if (!authorityCheck.success)
                 return authorityCheck.message;
             if (followers.includes('all'))
-                return '已经设置全员提醒';
+                return '💡 已经设置全员提醒';
             followers.push('all');
             await deps.ctx.database.set('rssOwl', { id: rssItem.id }, { followers });
             return '✅ 已设置全员提醒';
         }
         if (followers.includes(authorId))
-            return '已经关注过了';
+            return '💡 已经关注过了';
         followers.push(authorId);
         await deps.ctx.database.set('rssOwl', { id: rssItem.id }, { followers });
         return '✅ 关注成功';

package/lib/commands/web-monitor.d.ts

@@ -1,6 +1,23 @@
 import { Context } from 'koishi';
-import type { Config, rssArg } from '../types';
+import type { Config, TemplateType, rssArg } from '../types';
 type DebugType = 'disable' | 'error' | 'info' | 'details';
+type HtmlMonitorArg = rssArg & {
+    title?: string;
+};
+interface HtmlMonitorOptions {
+    selector?: string;
+    title?: string;
+    template?: TemplateType;
+    text?: boolean;
+    puppeteer?: boolean;
+    wait?: string;
+    waitSelector?: string;
+    test?: boolean;
+}
+interface WatchCommandOptions {
+    puppeteer?: boolean;
+    test?: boolean;
+}
 export interface WebMonitorCommandDeps {
     ctx: Context;
     config: Config;
@@ -12,4 +29,6 @@ export interface WebMonitorCommandDeps {
     fetchUrl: (url: string, arg?: Record<string, any>) => Promise<string>;
 }
 export declare function registerWebMonitorCommands(deps: WebMonitorCommandDeps): void;
+export declare function buildHtmlMonitorArg(options: HtmlMonitorOptions): HtmlMonitorArg;
+export declare function buildWatchArg(keyword: string | undefined, options: WatchCommandOptions): rssArg;
 export {};

package/lib/commands/web-monitor.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerWebMonitorCommands = registerWebMonitorCommands;
+exports.buildHtmlMonitorArg = buildHtmlMonitorArg;
+exports.buildWatchArg = buildWatchArg;
 const common_1 = require("../utils/common");
 const error_handler_1 = require("../utils/error-handler");
 const utils_1 = require("./utils");
@@ -12,7 +14,7 @@ function registerWebMonitorCommands(deps) {
 function registerHtmlMonitorCommand(deps) {
     deps.ctx.guild()
         .command('rssowl.html <url:string>', '监控网页变化 (CSS Selector)')
-        .alias('rsso.html')
+        .alias('rsso.html', 'rshm')
         .usage(`
 HTML 网页监控功能，使用 CSS 选择器提取内容
 用法:
@@ -37,9 +39,9 @@ HTML 网页监控功能，使用 CSS 选择器提取内容
         .example('rsso.html https://news.ycombinator.com -s ".titleline > a"')
         .action(async ({ session, options }, url) => {
         if (!url)
-            return '请输入 URL';
+            return '❌ 请输入 URL';
         if (!options.selector)
-            return '请指定 CSS 选择器 (-s)';
+            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;
@@ -50,15 +52,15 @@ HTML 网页监控功能，使用 CSS 选择器提取内容
             if (options.test) {
                 const items = await deps.getRssData(normalizedUrl, arg);
                 if (!items.length)
-                    return '未找到符合选择器的元素';
+                    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 '该订阅已存在';
+                return '❌ 该订阅已存在';
             const htmlItems = await deps.getRssData(normalizedUrl, arg);
             if (!htmlItems.length)
-                return '未找到符合选择器的元素，无法创建订阅';
+                return '❌ 未找到符合选择器的元素，无法创建订阅';
             const title = options.title || htmlItems[0]?.rss?.channel?.title || `HTML监控: ${normalizedUrl}`;
             const rssItem = {
                 url: normalizedUrl,
@@ -73,24 +75,24 @@ HTML 网页监控功能，使用 CSS 选择器提取内容
                 followers: [],
             };
             if (deps.config.basic.urlDeduplication && rssList.find(item => item.rssId === rssItem.rssId)) {
-                return `订阅已存在: ${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监控基于内容变化检测，请确保选择器稳定`;
+            return `✅ 订阅成功: ${title}\n💡 提示: HTML监控基于内容变化检测，请确保选择器稳定`;
         }
         catch (error) {
             deps.debug(error, 'html error', 'error', logContext);
-            return `抓取失败: ${(0, error_handler_1.getFriendlyErrorMessage)(error, 'HTML监控')}`;
+            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')
+        .alias('rsso.ask', 'rsak')
         .usage(`AI 智能订阅功能，自动生成 CSS 选择器
 
 前置要求:
@@ -108,9 +110,9 @@ function registerAskCommand(deps) {
         .example('rsso.ask https://news.ycombinator.com "监控首页的前5条新闻标题"')
         .action(async ({ session, options }, url, instruction) => {
         if (!url)
-            return '请输入网址';
+            return '❌ 请输入网址';
         if (!instruction)
-            return '请描述你的需求';
+            return '❌ 请描述你的需求';
         const logContext = (0, utils_1.buildCommandLogContext)(session, 'rsso.ask', options.test ? 'test' : 'analyze');
         const normalizedUrl = (0, common_1.ensureUrlProtocol)(url);
         try {
@@ -123,21 +125,21 @@ function registerAskCommand(deps) {
                     template: 'content',
                 });
                 if (!items.length)
-                    return `选择器未匹配到任何元素: ${selector}`;
+                    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生成选择器')}`;
+            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')
+        .alias('rsso.watch', 'rswt')
         .usage(`
 简单网页监控，支持关键词或整页监控。
 用法:
@@ -151,7 +153,7 @@ function registerWatchCommand(deps) {
         .example('rsso.watch https://example.com "缺货"')
         .action(async ({ session, options }, url, keyword) => {
         if (!url)
-            return '请输入 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));
@@ -159,14 +161,14 @@ function registerWatchCommand(deps) {
             if (options.test) {
                 const items = await deps.getRssData(normalizedUrl, arg);
                 if (!items.length)
-                    return '未找到内容';
+                    return '❌ 未找到内容';
                 return buildItemsPreview(items, `找到 ${items.length} 条内容:`, false);
             }
-            return '请使用 rsso 命令完成订阅，或使用 -T 测试';
+            return '💡 请使用 rsso 命令完成订阅，或使用 -T 测试';
         }
         catch (error) {
             deps.debug(error, 'watch error', 'error', logContext);
-            return `监控失败: ${(0, error_handler_1.getFriendlyErrorMessage)(error, '网页监控')}`;
+            return `❌ 监控失败: ${(0, error_handler_1.getFriendlyErrorMessage)(error, '网页监控')}`;
         }
     });
 }

package/lib/constants.d.ts

@@ -1,4 +1,4 @@
-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 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\uFF08list/search/stats/pull/clear/cleanup\uFF09\n  rsso.queue                             - \u53D1\u9001\u961F\u5217\u7BA1\u7406\uFF08stats/retry/cleanup\uFF09\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</details>\n";
 export declare const quickList: {
     prefix: string;
     name: string;

package/lib/constants.js

@@ -21,8 +21,8 @@ exports.usage = `
   rsso.pull <id>                         - 拉取订阅最新内容
   rsso.follow <id> [--all]               - 关注订阅更新 / 全员提醒
   rsso.edit <id> [选项]                  - 修改标题、URL、模板、选择器、目标
-  rsso.cache                             - 消息缓存管理
-  rsso.queue                             - 发送队列管理
+  rsso.cache                             - 消息缓存管理（list/search/stats/pull/clear/cleanup）
+  rsso.queue                             - 发送队列管理（stats/retry/cleanup）
 
 ## 网页监控相关:
   rsso.html <url> -s <selector>          - 使用 CSS 选择器监控网页
@@ -46,10 +46,6 @@ exports.usage = `
   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>
 `;
 exports.quickList = [

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

@@ -33,6 +33,11 @@ export declare function renderLoadedHtml(deps: ItemProcessorRuntimeDeps, html: c
 export declare function renderTemplatedDescription(deps: ItemProcessorRuntimeDeps, item: any, arg: rssArg, description: string, options?: RenderDescriptionOptions): Promise<string>;
 /**
  * 提取 HTML 中的视频资源，并按配置补齐 poster 图。
+ *
+ * 视频的发送方式由 config.basic.videoMode 决定（assets/File/base64/href/filter）。
+ * 仅在 videoMode === 'base64' 时强制内联 base64；其它模式交给 getVideoUrl 内部
+ * 按 videoMode 走 file:// / assets / href / filter 分支。
+ * （历史代码曾对所有视频硬编码 useBase64Mode=true，导致 videoMode 配置失效。）
  */
 export declare function processVideos(deps: ItemProcessorRuntimeDeps, html: cheerio.CheerioAPI, arg: rssArg, videoList: Array<[string, string]>): Promise<void>;
 /**

package/lib/core/item-processor-runtime.js

@@ -154,11 +154,18 @@ async function renderTemplatedDescription(deps, item, arg, description, options)
 }
 /**
  * 提取 HTML 中的视频资源，并按配置补齐 poster 图。
+ *
+ * 视频的发送方式由 config.basic.videoMode 决定（assets/File/base64/href/filter）。
+ * 仅在 videoMode === 'base64' 时强制内联 base64；其它模式交给 getVideoUrl 内部
+ * 按 videoMode 走 file:// / assets / href / filter 分支。
+ * （历史代码曾对所有视频硬编码 useBase64Mode=true，导致 videoMode 配置失效。）
  */
 async function processVideos(deps, html, arg, videoList) {
+    const videoMode = deps.config.basic?.videoMode;
+    const useVideoBase64 = videoMode === 'base64';
     await Promise.all(html('video').map(async (_, element) => {
         videoList.push([
-            await (0, media_1.getVideoUrl)(deps.ctx, deps.config, deps.$http, element.attribs.src, arg, true, element),
+            await (0, media_1.getVideoUrl)(deps.ctx, deps.config, deps.$http, element.attribs.src, arg, useVideoBase64, element),
             (element.attribs.poster && deps.config.basic?.usePoster)
                 ? await (0, media_1.getImageUrl)(deps.ctx, deps.config, deps.$http, element.attribs.poster, arg, true)
                 : '',