@anyul/koishi-plugin-rss 5.3.2 → 5.3.10

package/lib/utils/logger.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.logger = void 0;
+exports.applyDebugLevel = applyDebugLevel;
 exports.shouldLog = shouldLog;
 exports.debug = debug;
 exports.debugError = debugError;
@@ -10,6 +11,47 @@ const koishi_1 = require("koishi");
 const types_1 = require("../types");
 const logger = new koishi_1.Logger('rss-owl');
 exports.logger = logger;
+/**
+ * 把 config.debug 映射到 Koishi/reggol 的原生日志级别数值。
+ *
+ * reggol 级别（见 reggol/index.d.ts）：
+ *   SILENT=0, SUCCESS/ERROR=1, INFO/WARN=2, DEBUG=3
+ *
+ * 本插件的 debug 字段语义：
+ *   disable → 0（SILENT，什么也不输出）
+ *   error   → 1（仅 error）
+ *   info    → 2（error + info/warn）
+ *   details → 3（含 debug 全量）
+ */
+function debugLevelToReggol(debug) {
+    switch (debug) {
+        case 'error': return koishi_1.Logger.ERROR;
+        case 'info': return koishi_1.Logger.INFO;
+        case 'details': return koishi_1.Logger.DEBUG;
+        default: return koishi_1.Logger.SILENT;
+    }
+}
+/**
+ * 把 config.debug 同步到 Koishi 原生日志分级 `Logger.levels['rss-owl']`。
+ *
+ * 这样本插件的日志可见性既受自身 debug 字段控制，也能被 Koishi 全局 levels
+ * （WebUI 的 logger 插件、配置文件中的 levels.base / levels['rss-owl']）覆盖/调节。
+ * 应在 apply() 启动时调用一次；值未变化时不重复写入。
+ */
+let lastAppliedLevel;
+function applyDebugLevel(config) {
+    const target = debugLevelToReggol(config.debug);
+    if (lastAppliedLevel === target)
+        return;
+    lastAppliedLevel = target;
+    koishi_1.Logger.levels = koishi_1.Logger.levels || { base: 2 };
+    koishi_1.Logger.levels['rss-owl'] = target;
+}
+/**
+ * 按 config.debug 判定某级是否应输出。
+ * 在 debug() 中作为性能预检门控（避免对注定被丢弃的日志做脱敏/格式化），
+ * 与 applyDebugLevel 同步到 Koishi levels 的语义保持一致；最终输出与否仍由 reggol levels 决定。
+ */
 function shouldLog(config, type) {
     const typeLevel = types_1.debugLevel.findIndex(i => i === type);
     if (typeLevel < 1)
@@ -19,6 +61,22 @@ function shouldLog(config, type) {
         return false;
     return typeLevel <= configLevel;
 }
+/**
+ * 子命名空间 logger 缓存，避免每条日志都 extend。
+ * 用 logger.extend('feeder') 产出 rss-owl:feeder，命名空间天然带模块名，
+ * 取代此前 formatTextLog 里手工拼 [name] 前缀的做法（与 Koishi Logger 命名空间重复）。
+ */
+const subLoggers = new Map();
+function getSubLogger(name) {
+    if (!name)
+        return logger;
+    let sub = subLoggers.get(name);
+    if (!sub) {
+        sub = logger.extend(name);
+        subLoggers.set(name, sub);
+    }
+    return sub;
+}
 /**
  * 敏感信息模式定义
  */
@@ -129,12 +187,21 @@ function sanitizeObject(obj, depth = 0) {
     }
     return obj;
 }
-function emitLog(type, content) {
-    if (type === 'error') {
-        logger.error(content);
-        return;
-    }
-    logger.info(content);
+/**
+ * 按 Koishi 原生日志级别输出。
+ *
+ * 关键纠错：'details' 之前被错压成 logger.info()，现归到 logger.debug()，
+ * 让 reggol 的 levels（SILENT=0 / ERROR=1 / INFO=2 / DEBUG=3）能正确分级过滤。
+ * 模块名 name 通过子命名空间 logger.extend(name) 体现（如 rss-owl:feeder），
+ * 不再手工拼 [name] 前缀。
+ */
+function emitLog(type, content, name = '') {
+    const target = getSubLogger(name);
+    if (type === 'error')
+        return target.error(content);
+    if (type === 'info')
+        return target.info(content);
+    return target.debug(content); // 'details'
 }
 function filterContextFields(context, contextFields) {
     if (!contextFields?.length) {
@@ -163,12 +230,10 @@ function formatContextValue(value) {
     return String(value);
 }
 function formatTextLog(message, name, context, loggingConfig) {
-    const parts = [];
-    if (loggingConfig?.includeModule !== false && name) {
-        parts.push(`[${name}]`);
-    }
-    parts.push(message);
-    const textOutput = parts.filter(Boolean).join(' ').trim();
+    // 模块名不再手工拼前缀：已由子命名空间 logger（rss-owl:<name>）体现，
+    // 避免与 Koishi Logger 命名空间重复输出。
+    void name;
+    const textOutput = message.trim();
     if (!context || Object.keys(context).length === 0) {
         return textOutput;
     }
@@ -192,6 +257,9 @@ function formatTextLog(message, name, context, loggingConfig) {
  * @param context - 额外的上下文信息
  */
 function debug(config, message, name = '', type = 'details', context) {
+    // 性能预检：按 config.debug 快速跳过注定被 Koishi levels 丢弃的日志，
+    // 避免无谓的脱敏/格式化开销。最终是否真正输出由 reggol levels 决定
+    // （applyDebugLevel 已把 config.debug 同步到 Logger.levels['rss-owl']）。
     if (!shouldLog(config, type))
         return;
     // 检查是否启用日志脱敏（默认启用）
@@ -258,10 +326,10 @@ function debug(config, message, name = '', type = 'details', context) {
             }
         }
         // 输出结构化日志
-        emitLog(type, JSON.stringify(logEntry));
+        emitLog(type, JSON.stringify(logEntry), name);
     }
     else {
-        emitLog(type, formatTextLog(formattedMessage, name, context, loggingConfig));
+        emitLog(type, formatTextLog(formattedMessage, name, context, loggingConfig), name);
     }
 }
 /**

package/lib/utils/media.js

@@ -50,10 +50,10 @@ async function tryUnlink(filePath) {
     }
 }
 const getCacheDir = (config) => {
-    let dir = config.basic.cacheDir ? path.resolve('./', config.basic.cacheDir || "") : `${__dirname}/cache`;
-    let mkdir = (path, deep = 2) => {
-        let dir = path.split("\\").splice(0, deep).join("\\");
-        let dirDeep = path.split("\\").length;
+    const dir = config.basic.cacheDir ? path.resolve('./', config.basic.cacheDir || "") : `${__dirname}/cache`;
+    const mkdir = (path, deep = 2) => {
+        const dir = path.split("\\").splice(0, deep).join("\\");
+        const dirDeep = path.split("\\").length;
         if (!fs.existsSync(dir)) {
             fs.mkdirSync(dir);
         }
@@ -68,11 +68,11 @@ exports.getCacheDir = getCacheDir;
 const writeCacheFile = async (fileUrl, config) => {
     const cacheDir = (0, exports.getCacheDir)(config);
     (0, logger_1.debug)(config, cacheDir, 'cacheDir', 'details');
-    let suffix = /(?<=^data:.+?\/).+?(?=;base64)/.exec(fileUrl)?.[0] || 'bin';
+    const suffix = /(?<=^data:.+?\/).+?(?=;base64)/.exec(fileUrl)?.[0] || 'bin';
     // 使用时间戳 + 随机数生成唯一文件名，避免竞态条件
-    let fileName = `${Date.now()}-${Math.random().toString(36).substring(2, 11)}.${suffix}`;
-    let base64Data = fileUrl.replace(/^data:.+?;base64,/, "");
-    let filePath = `${cacheDir}/${fileName}`;
+    const fileName = `${Date.now()}-${Math.random().toString(36).substring(2, 11)}.${suffix}`;
+    const base64Data = fileUrl.replace(/^data:.+?;base64,/, "");
+    const filePath = `${cacheDir}/${fileName}`;
     fs.writeFileSync(filePath, base64Data, 'base64');
     if (config.basic.replaceDir) {
         return `file:///${config.basic.replaceDir}/${fileName}`;
@@ -120,10 +120,10 @@ const getImageUrl = async (ctx, config, $http, url, arg, useBase64Mode = false)
         (0, logger_1.debug)(config, `图片请求失败: ${error}`, 'img error', 'error');
         return '';
     }
-    let contentType = res.headers["content-type"] || 'image/jpeg';
-    let suffix = contentType?.split('/')[1] || 'jpg';
-    let base64Prefix = `data:${contentType};base64,`;
-    let base64Data = base64Prefix + Buffer.from(res.data, 'binary').toString('base64');
+    const contentType = res.headers["content-type"] || 'image/jpeg';
+    const suffix = contentType?.split('/')[1] || 'jpg';
+    const base64Prefix = `data:${contentType};base64,`;
+    const base64Data = base64Prefix + Buffer.from(res.data, 'binary').toString('base64');
     // 根据发送模式处理
     const imageMode = config.basic.imageMode;
     // base64 模式：直接返回 base64
@@ -132,13 +132,13 @@ const getImageUrl = async (ctx, config, $http, url, arg, useBase64Mode = false)
     }
     // File 模式：下载到本地，返回 file:// URL
     if (imageMode == 'File') {
-        let fileUrl = await (0, exports.writeCacheFile)(base64Data, config);
+        const fileUrl = await (0, exports.writeCacheFile)(base64Data, config);
         return fileUrl;
     }
     // assets 模式：下载到本地，上传到 assets，返回 assets URL
     if (imageMode === 'assets' && ctx.assets) {
         try {
-            let assetUrl = await ctx.assets.upload(base64Data, `rss-img-${Date.now()}.${suffix}`);
+            const assetUrl = await ctx.assets.upload(base64Data, `rss-img-${Date.now()}.${suffix}`);
             (0, logger_1.debug)(config, `图片 Assets 上传成功: ${assetUrl}`, 'assets', 'info');
             return assetUrl;
         }
@@ -152,7 +152,7 @@ const getImageUrl = async (ctx, config, $http, url, arg, useBase64Mode = false)
 };
 exports.getImageUrl = getImageUrl;
 const getVideoUrl = async (ctx, config, $http, url, arg, useBase64Mode = false, dom) => {
-    let src = dom.attribs.src || dom.children["0"].attribs.src;
+    const src = dom.attribs.src || dom.children["0"].attribs.src;
     // 根据发送模式处理
     const videoMode = config.basic.videoMode;
     // filter 模式：过滤掉所有视频
@@ -222,23 +222,23 @@ const getVideoUrl = async (ctx, config, $http, url, arg, useBase64Mode = false,
     // file:// 已读入内存（bufferData），后续 base64/File/assets 都基于内存数据，
     // 源文件不再需要 —— 立即删，避免几十 MB 视频在缓存目录堆积
     await tryUnlink(localSourcePath);
-    let suffix = contentType?.split('/')[1] || 'mp4';
-    let base64Prefix = `data:${contentType};base64,`;
-    let base64Data = base64Prefix + bufferData.toString('base64');
+    const suffix = contentType?.split('/')[1] || 'mp4';
+    const base64Prefix = `data:${contentType};base64,`;
+    const base64Data = base64Prefix + bufferData.toString('base64');
     // base64 模式：直接返回 base64（注意：视频 base64 可能非常长）
     if (videoMode === 'base64' || useBase64Mode) {
         return base64Data;
     }
     // File 模式：下载到本地，返回 file:// URL
     if (videoMode === 'File') {
-        let fileUrl = await (0, exports.writeCacheFile)(base64Data, config);
+        const fileUrl = await (0, exports.writeCacheFile)(base64Data, config);
         return fileUrl;
     }
     // assets 模式：下载到本地，上传到 assets，返回 assets URL
     if (videoMode === 'assets' && ctx.assets) {
         try {
             // 注意：大型视频的 base64 字符串可能很长，某些 assets 插件可能处理较慢
-            let assetUrl = await ctx.assets.upload(base64Data, `rss-video-${Date.now()}.${suffix}`);
+            const assetUrl = await ctx.assets.upload(base64Data, `rss-video-${Date.now()}.${suffix}`);
             (0, logger_1.debug)(config, `视频 Assets 上传成功: ${assetUrl}`, 'assets', 'info');
             return assetUrl;
         }
@@ -254,7 +254,7 @@ exports.getVideoUrl = getVideoUrl;
 const puppeteerToFile = async (ctx, config, puppeteer) => {
     // puppeteer.render() 返回 Element 字符串，格式如: <img src="data:image/png;base64,..."/> 或 <img src="https://..."/>
     // 提取 src 属性
-    let base64 = /(?<=src=").+?(?=")/.exec(puppeteer)?.[0];
+    const base64 = /(?<=src=").+?(?=")/.exec(puppeteer)?.[0];
     if (!base64) {
         (0, logger_1.debug)(config, `puppeteer render 返回值格式异常: ${puppeteer}`, 'puppeteerToFile', 'error');
         return puppeteer;

package/lib/utils/message-cache.d.ts

@@ -124,3 +124,11 @@ export declare function initMessageCache(ctx: Context, config: Config, maxSize?:
  * 获取全局消息缓存管理器
  */
 export declare function getMessageCache(): MessageCacheManager | null;
+/**
+ * 销毁全局消息缓存管理器
+ *
+ * 必须在插件 dispose 时调用：MessageCacheManager 构造时持有了 ctx，
+ * 若热重载后仍复用旧实例，会对已 dispose 的 ctx 执行数据库操作而报错/静默丢失。
+ * 置 null 后，下次 initMessageCache 会用新 ctx 重建实例。
+ */
+export declare function disposeMessageCache(): void;

package/lib/utils/message-cache.js

@@ -7,6 +7,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MessageCacheManager = void 0;
 exports.initMessageCache = initMessageCache;
 exports.getMessageCache = getMessageCache;
+exports.disposeMessageCache = disposeMessageCache;
 const koishi_1 = require("koishi");
 const logger_1 = require("./logger");
 const logger = new koishi_1.Logger('rss-owl:cache');
@@ -253,3 +254,14 @@ function initMessageCache(ctx, config, maxSize = 100) {
 function getMessageCache() {
     return globalMessageCache;
 }
+/**
+ * 销毁全局消息缓存管理器
+ *
+ * 必须在插件 dispose 时调用：MessageCacheManager 构造时持有了 ctx，
+ * 若热重载后仍复用旧实例，会对已 dispose 的 ctx 执行数据库操作而报错/静默丢失。
+ * 置 null 后，下次 initMessageCache 会用新 ctx 重建实例。
+ */
+function disposeMessageCache() {
+    globalMessageCache = null;
+    logger.info('消息缓存管理器已销毁');
+}

package/lib/utils/proxy.d.ts

@@ -1,3 +1,40 @@
 import type { AxiosRequestConfig } from 'axios';
 import type { Config } from '../types';
+/**
+ * 代理配置片段（订阅级 / 全局级通用形状）。
+ */
+export interface ProxyAgentShape {
+    enabled?: boolean;
+    protocol?: string;
+    host?: string;
+    port?: number | string;
+    auth?: {
+        enabled?: boolean;
+        user?: string;
+        pass?: string;
+    } & Record<string, any>;
+    [key: string]: any;
+}
+/**
+ * 合并订阅级代理配置 (argProxy) 与全局代理配置 (configProxy)。
+ *
+ * 优先级：
+ *   1. argProxy.enabled === false → 显式禁用
+ *   2. argProxy.enabled === true 且有 host → 用订阅配置
+ *   3. argProxy 缺失 / 未设置 enabled → 回落全局配置
+ *   4. argProxy.enabled === true 但缺 host → 用全局补全
+ *   5. 其余 → 禁用
+ *
+ * 返回值与 `config.net.proxyAgent` 同构，可直接喂给 `buildAxiosProxyConfig`。
+ *
+ * 本函数原位于 `core/feeder-arg.ts`，提升到此处以统一代理 helper 归属，
+ * 供 fetcher / feeder 等模块复用，避免重复实现合并逻辑。
+ */
+export declare function mergeProxyAgent(argProxy: any, configProxy: any, config: Config): ProxyAgentShape;
+/**
+ * 构造 axios 的代理配置（httpsAgent + 关闭 axios 原生 proxy）。
+ *
+ * 接受完整的 Config（读取 config.net.proxyAgent）。对于需要按订阅合并代理的场景，
+ * 先用 `mergeProxyAgent` 得到统一片段，再包成 `{ net: { proxyAgent } }` 传入。
+ */
 export declare function buildAxiosProxyConfig(config: Config): Pick<AxiosRequestConfig, 'httpsAgent' | 'proxy'>;

package/lib/utils/proxy.js

@@ -1,7 +1,67 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeProxyAgent = mergeProxyAgent;
 exports.buildAxiosProxyConfig = buildAxiosProxyConfig;
 const https_proxy_agent_1 = require("https-proxy-agent");
+const logger_1 = require("./logger");
+/**
+ * 合并订阅级代理配置 (argProxy) 与全局代理配置 (configProxy)。
+ *
+ * 优先级：
+ *   1. argProxy.enabled === false → 显式禁用
+ *   2. argProxy.enabled === true 且有 host → 用订阅配置
+ *   3. argProxy 缺失 / 未设置 enabled → 回落全局配置
+ *   4. argProxy.enabled === true 但缺 host → 用全局补全
+ *   5. 其余 → 禁用
+ *
+ * 返回值与 `config.net.proxyAgent` 同构，可直接喂给 `buildAxiosProxyConfig`。
+ *
+ * 本函数原位于 `core/feeder-arg.ts`，提升到此处以统一代理 helper 归属，
+ * 供 fetcher / feeder 等模块复用，避免重复实现合并逻辑。
+ */
+function mergeProxyAgent(argProxy, configProxy, config) {
+    (0, logger_1.debug)(config, `合并代理配置 - argProxy: ${JSON.stringify(argProxy)}, configProxy.enabled: ${configProxy?.enabled}`, 'proxy merge debug', 'details');
+    if (argProxy?.enabled === false) {
+        (0, logger_1.debug)(config, '订阅明确禁用代理', 'proxy merge', 'details');
+        return { enabled: false };
+    }
+    if (argProxy?.enabled === true && argProxy?.host) {
+        (0, logger_1.debug)(config, '使用订阅的代理配置', 'proxy merge', 'details');
+        return argProxy;
+    }
+    const shouldUseConfigProxy = !argProxy || Object.keys(argProxy || {}).length === 0 || argProxy?.enabled === undefined || argProxy?.enabled === null;
+    if (shouldUseConfigProxy) {
+        if (configProxy?.enabled) {
+            const result = {
+                enabled: true,
+                protocol: configProxy.protocol,
+                host: configProxy.host,
+                port: configProxy.port,
+                auth: configProxy.auth?.enabled ? configProxy.auth : undefined,
+            };
+            (0, logger_1.debug)(config, `使用全局代理: ${result.protocol}://${result.host}:${result.port}`, 'proxy merge', 'info');
+            return result;
+        }
+        (0, logger_1.debug)(config, '全局代理未启用', 'proxy merge', 'details');
+    }
+    if (argProxy?.enabled === true && !argProxy?.host) {
+        const result = {
+            ...configProxy,
+            ...argProxy,
+            auth: configProxy?.auth?.enabled ? configProxy.auth : undefined,
+        };
+        (0, logger_1.debug)(config, '订阅代理配置不完整，补充全局配置', 'proxy merge', 'details');
+        return result;
+    }
+    (0, logger_1.debug)(config, '代理未配置，使用默认(禁用)', 'proxy merge', 'details');
+    return { enabled: false };
+}
+/**
+ * 构造 axios 的代理配置（httpsAgent + 关闭 axios 原生 proxy）。
+ *
+ * 接受完整的 Config（读取 config.net.proxyAgent）。对于需要按订阅合并代理的场景，
+ * 先用 `mergeProxyAgent` 得到统一片段，再包成 `{ net: { proxyAgent } }` 传入。
+ */
 function buildAxiosProxyConfig(config) {
     if (!config.net?.proxyAgent?.enabled) {
         return {};

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@anyul/koishi-plugin-rss",
   "description": "Koishi RSS订阅器，支持多种RSS源、图片渲染、AI摘要等高级功能",
-  "version": "5.3.2",
+  "version": "5.3.10",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
+  "packageManager": "pnpm@10.12.1",
   "author": "Anyuluo <anyul@email.com>",
   "contributors": [],
   "repository": {
@@ -43,16 +44,28 @@
     "x2js": "^3.4.4"
   },
   "devDependencies": {
+    "@eslint/js": "^8.57.1",
     "@jest/globals": "^30.2.0",
     "@types/jest": "^30.0.0",
+    "@types/node": "^26.0.1",
+    "eslint": "^9.39.4",
+    "globals": "^15.15.0",
     "jest": "^30.2.0",
     "ts-jest": "^29.4.6",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.62.0"
   },
   "scripts": {
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "build": "tsc"
+    "test:ci": "jest --ci --reporters=default",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix"
+  },
+  "engines": {
+    "node": ">=20"
   }
 }

package/lib/commands/error-handler.d.ts

@@ -1,53 +0,0 @@
-/**
- * 命令错误处理中间件
- * 提供统一的错误处理和用户友好的错误消息
- */
-import { Context } from 'koishi';
-import { Config } from '../types';
-/**
- * 命令执行结果
- */
-export interface CommandResult {
-    success: boolean;
-    message: string;
-    error?: any;
-}
-/**
- * 命令错误类型
- */
-export declare enum CommandErrorType {
-    PERMISSION_DENIED = "PERMISSION_DENIED",
-    INVALID_ARGUMENT = "INVALID_ARGUMENT",
-    NOT_FOUND = "NOT_FOUND",
-    ALREADY_EXISTS = "ALREADY_EXISTS",
-    NETWORK_ERROR = "NETWORK_ERROR",
-    INTERNAL_ERROR = "INTERNAL_ERROR"
-}
-/**
- * 命令错误类
- */
-export declare class CommandError extends Error {
-    type: CommandErrorType;
-    details?: any;
-    constructor(type: CommandErrorType, message: string, details?: any);
-}
-/**
- * 包装命令执行，提供统一的错误处理
- */
-export declare function executeCommand(ctx: Context, config: Config, operationName: string, handler: () => Promise<string>): Promise<string>;
-/**
- * 创建权限检查错误
- */
-export declare function permissionDenied(customMessage?: string): CommandError;
-/**
- * 创建参数错误
- */
-export declare function invalidArgument(message: string): CommandError;
-/**
- * 创建未找到错误
- */
-export declare function notFound(resource: string): CommandError;
-/**
- * 创建已存在错误
- */
-export declare function alreadyExists(resource: string): CommandError;

package/lib/commands/error-handler.js

@@ -1,120 +0,0 @@
-"use strict";
-/**
- * 命令错误处理中间件
- * 提供统一的错误处理和用户友好的错误消息
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommandError = exports.CommandErrorType = void 0;
-exports.executeCommand = executeCommand;
-exports.permissionDenied = permissionDenied;
-exports.invalidArgument = invalidArgument;
-exports.notFound = notFound;
-exports.alreadyExists = alreadyExists;
-const error_handler_1 = require("../utils/error-handler");
-const error_tracker_1 = require("../utils/error-tracker");
-const logger_1 = require("../utils/logger");
-/**
- * 命令错误类型
- */
-var CommandErrorType;
-(function (CommandErrorType) {
-    CommandErrorType["PERMISSION_DENIED"] = "PERMISSION_DENIED";
-    CommandErrorType["INVALID_ARGUMENT"] = "INVALID_ARGUMENT";
-    CommandErrorType["NOT_FOUND"] = "NOT_FOUND";
-    CommandErrorType["ALREADY_EXISTS"] = "ALREADY_EXISTS";
-    CommandErrorType["NETWORK_ERROR"] = "NETWORK_ERROR";
-    CommandErrorType["INTERNAL_ERROR"] = "INTERNAL_ERROR";
-})(CommandErrorType || (exports.CommandErrorType = CommandErrorType = {}));
-/**
- * 命令错误类
- */
-class CommandError extends Error {
-    type;
-    details;
-    constructor(type, message, details) {
-        super(message);
-        this.type = type;
-        this.details = details;
-        this.name = 'CommandError';
-    }
-}
-exports.CommandError = CommandError;
-/**
- * 包装命令执行，提供统一的错误处理
- */
-async function executeCommand(ctx, config, operationName, handler) {
-    try {
-        return await handler();
-    }
-    catch (error) {
-        // 如果是 CommandError，使用自定义消息
-        if (error instanceof CommandError) {
-            logError(config, operationName, error);
-            return formatCommandError(error);
-        }
-        // 其他错误使用友好错误消息
-        logError(config, operationName, error);
-        const friendlyMessage = (0, error_handler_1.getFriendlyErrorMessage)(error, operationName);
-        return `${operationName}失败: ${friendlyMessage}`;
-    }
-}
-/**
- * 记录命令错误
- */
-function logError(config, operation, error) {
-    const normalizedError = (0, error_handler_1.normalizeError)(error, `${operation} failed`);
-    const context = {
-        command: operation,
-    };
-    if (error instanceof CommandError) {
-        context.commandErrorType = error.type;
-    }
-    if (normalizedError && typeof normalizedError.code === 'string') {
-        context.errorCode = normalizedError.code;
-    }
-    (0, logger_1.debugError)(config, normalizedError, `${operation} error`, context);
-    (0, error_tracker_1.trackError)(normalizedError, context);
-}
-/**
- * 格式化命令错误消息
- */
-function formatCommandError(error) {
-    switch (error.type) {
-        case CommandErrorType.PERMISSION_DENIED:
-            return error.message;
-        case CommandErrorType.INVALID_ARGUMENT:
-            return `参数错误: ${error.message}`;
-        case CommandErrorType.NOT_FOUND:
-            return `未找到: ${error.message}`;
-        case CommandErrorType.ALREADY_EXISTS:
-            return `已存在: ${error.message}`;
-        case CommandErrorType.NETWORK_ERROR:
-            return `网络错误: ${error.message}`;
-        default:
-            return error.message || '操作失败，请稍后重试';
-    }
-}
-/**
- * 创建权限检查错误
- */
-function permissionDenied(customMessage) {
-    return new CommandError(CommandErrorType.PERMISSION_DENIED, customMessage || '权限不足');
-}
-/**
- * 创建参数错误
- */
-function invalidArgument(message) {
-    return new CommandError(CommandErrorType.INVALID_ARGUMENT, message);
-}
-/**
- * 创建未找到错误
- */
-function notFound(resource) {
-    return new CommandError(CommandErrorType.NOT_FOUND, resource);
-}
-/**
- * 创建已存在错误
- */
-function alreadyExists(resource) {
-    return new CommandError(CommandErrorType.ALREADY_EXISTS, resource);
-}

package/lib/commands/rss-subscribe.d.ts

@@ -1,11 +0,0 @@
-/**
- * RSS 订阅命令
- * 处理 RSS 订阅的添加、删除、列表、关注等操作
- */
-import { Context } from 'koishi';
-import { Config } from '../types';
-import { RssItemProcessor } from '../core/item-processor';
-/**
- * 注册 RSS 订阅命令
- */
-export declare function registerRssSubscribeCommand(ctx: Context, config: Config, processor: RssItemProcessor, getRssDataLocal: (url: string, arg: any) => Promise<any[]>, parseRssItem: (item: any, arg: any, authorId: string | number) => Promise<string>, parseQuickUrlLocal: (url: string) => string, parsePubDateLocal: (pubDate: any) => Date): void;