@anyul/koishi-plugin-rss 5.3.2 → 5.3.4

package/lib/utils/error-handler.js

@@ -5,7 +5,7 @@
  * 将技术性错误转换为用户友好的提示信息
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorType = void 0;
+exports.CommandError = exports.CommandErrorType = exports.ErrorType = void 0;
 exports.getErrorType = getErrorType;
 exports.getFriendlyErrorMessage = getFriendlyErrorMessage;
 exports.createError = createError;
@@ -14,6 +14,12 @@ exports.isNetworkError = isNetworkError;
 exports.isParseError = isParseError;
 exports.isPermissionError = isPermissionError;
 exports.isRetryable = isRetryable;
+exports.executeCommand = executeCommand;
+exports.permissionDenied = permissionDenied;
+exports.invalidArgument = invalidArgument;
+exports.notFound = notFound;
+exports.alreadyExists = alreadyExists;
+const logger_1 = require("./logger");
 /**
  * 错误类型枚举
  */
@@ -276,3 +282,107 @@ function isRetryable(error) {
     // 其他错误不建议重试
     return false;
 }
+/**
+ * 命令错误类型
+ */
+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) {
+            logCommandError(config, operationName, error);
+            return formatCommandError(error);
+        }
+        // 其他错误使用友好错误消息
+        logCommandError(config, operationName, error);
+        const friendlyMessage = getFriendlyErrorMessage(error, operationName);
+        return `${operationName}失败: ${friendlyMessage}`;
+    }
+}
+/**
+ * 记录命令错误
+ */
+function logCommandError(config, operation, error) {
+    const normalizedError = 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);
+}
+/**
+ * 格式化命令错误消息
+ */
+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/utils/fetcher.js

@@ -5,11 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHttpFunction = exports.RequestManager = void 0;
 const axios_1 = __importDefault(require("axios"));
-const https_proxy_agent_1 = require("https-proxy-agent");
 const error_handler_1 = require("./error-handler");
-const error_tracker_1 = require("./error-tracker");
 const logger_1 = require("./logger");
 const common_1 = require("./common");
+const proxy_1 = require("./proxy");
 const security_1 = require("./security");
 // 简化版 RequestManager，仅用于普通 API 请求，大文件下载建议绕过
 class RequestManager {
@@ -91,12 +90,6 @@ const createHttpFunction = (ctx, config, requestManager) => {
                 requestDebug(`URL 安全验证失败: ${normalizedError.message}`, 'security', 'error', {
                     stage: 'security-validation',
                 });
-                (0, error_tracker_1.trackError)(normalizedError, {
-                    url,
-                    requestType,
-                    isHeavyRequest,
-                    stage: 'security-validation',
-                });
                 throw error;
             }
             throw error;
@@ -114,32 +107,20 @@ const createHttpFunction = (ctx, config, requestManager) => {
                 // 允许传入自定义 proxyAgent
                 ...(arg.proxyAgent?.enabled ? {} : {})
             };
-            // 代理配置
-            let currentProxyAgent = arg?.proxyAgent;
-            // 防御性：如果 arg 中没有有效的代理配置，尝试使用全局配置（作为安全网）
-            if (!currentProxyAgent || currentProxyAgent.enabled === undefined || currentProxyAgent.enabled === null) {
-                if (config.net?.proxyAgent?.enabled) {
-                    currentProxyAgent = {
-                        enabled: true,
-                        protocol: config.net.proxyAgent.protocol,
-                        host: config.net.proxyAgent.host,
-                        port: config.net.proxyAgent.port,
-                        auth: config.net.proxyAgent.auth?.enabled ? config.net.proxyAgent.auth : undefined
-                    };
-                    requestDebug(`[DEBUG_PROXY] fetcher 使用防御性全局代理`, 'request', 'details', {
-                        proxyEnabled: true,
-                        proxyUrl: config.net.proxyAgent.host
-                            ? `${config.net.proxyAgent.protocol}://${config.net.proxyAgent.host}:${config.net.proxyAgent.port}`
-                            : '',
-                    });
-                }
-            }
+            // 代理配置：复用 utils/proxy.ts 的合并 + 构造 helper（CLAUDE.md:346 规范）
+            // mergeProxyAgent 已处理“arg 缺失回落全局 / arg 不完整用全局补全”的防御性逻辑
+            const currentProxyAgent = (0, proxy_1.mergeProxyAgent)(arg?.proxyAgent, config.net?.proxyAgent, config);
             const proxyEnabled = Boolean(currentProxyAgent?.enabled);
             let proxyUrl = '';
             if (proxyEnabled && currentProxyAgent.host) {
                 proxyUrl = `${currentProxyAgent.protocol}://${currentProxyAgent.host}:${currentProxyAgent.port}`;
-                const agent = new https_proxy_agent_1.HttpsProxyAgent(proxyUrl);
-                configObj.httpsAgent = agent;
+                requestDebug(`[DEBUG_PROXY] fetcher 使用代理`, 'request', 'details', {
+                    proxyEnabled: true,
+                    proxyUrl,
+                });
+                // 用合并后的片段构造 axios 代理配置，与 ai-client / search-providers 同源
+                const proxyConfig = (0, proxy_1.buildAxiosProxyConfig)({ net: { proxyAgent: currentProxyAgent } });
+                configObj.httpsAgent = proxyConfig.httpsAgent;
                 configObj.proxy = false; // 禁用 axios 原生 proxy
             }
             // 合并外部配置
@@ -190,13 +171,6 @@ const createHttpFunction = (ctx, config, requestManager) => {
                 status,
                 retriesRemaining: 0,
             });
-            (0, error_tracker_1.trackError)(normalizedError, {
-                url,
-                requestType,
-                isHeavyRequest,
-                status,
-                ...requestContext,
-            });
             throw normalizedError;
         };
         if (isHeavyRequest) {

package/lib/utils/logger.d.ts

@@ -2,6 +2,12 @@ import { Logger } from 'koishi';
 import { Config } from '../types';
 declare const logger: Logger;
 export type DebugLogType = "disable" | "error" | "info" | "details";
+export declare function applyDebugLevel(config: Config): void;
+/**
+ * 按 config.debug 判定某级是否应输出。
+ * 在 debug() 中作为性能预检门控（避免对注定被丢弃的日志做脱敏/格式化），
+ * 与 applyDebugLevel 同步到 Koishi levels 的语义保持一致；最终输出与否仍由 reggol levels 决定。
+ */
 export declare function shouldLog(config: Config, type: DebugLogType): boolean;
 /**
  * 增强的调试日志函数

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/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,7 +1,7 @@
 {
   "name": "@anyul/koishi-plugin-rss",
   "description": "Koishi RSS订阅器，支持多种RSS源、图片渲染、AI摘要等高级功能",
-  "version": "5.3.2",
+  "version": "5.3.4",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "author": "Anyuluo <anyul@email.com>",

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;