@anyul/koishi-plugin-rss 5.3.2 → 5.3.10

package/lib/utils/metrics.js

@@ -1,401 +0,0 @@
-"use strict";
-/**
- * 性能监控指标系统
- * 收集和报告应用程序性能指标
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MetricsCollector = exports.Gauge = exports.Counter = exports.Histogram = exports.MetricType = void 0;
-exports.initMetrics = initMetrics;
-exports.getMetricsCollector = getMetricsCollector;
-exports.incCounter = incCounter;
-exports.setGauge = setGauge;
-exports.observeHistogram = observeHistogram;
-exports.recordRssFetch = recordRssFetch;
-exports.recordRssFetchError = recordRssFetchError;
-exports.recordAiSummary = recordAiSummary;
-exports.recordAiSummaryError = recordAiSummaryError;
-exports.recordMessageSend = recordMessageSend;
-exports.updateMemoryUsage = updateMemoryUsage;
-/**
- * 指标类型
- */
-var MetricType;
-(function (MetricType) {
-    MetricType["COUNTER"] = "counter";
-    MetricType["GAUGE"] = "gauge";
-    MetricType["HISTOGRAM"] = "histogram";
-    MetricType["SUMMARY"] = "summary"; // 摘要（统计信息）
-})(MetricType || (exports.MetricType = MetricType = {}));
-/**
- * 直方图指标
- */
-class Histogram {
-    name;
-    description;
-    buckets;
-    data = new Map();
-    sum = 0;
-    count = 0;
-    constructor(name, description, buckets = [10, 50, 100, 500, 1000, 5000, 10000]) {
-        this.name = name;
-        this.description = description;
-        this.buckets = buckets;
-        // 初始化桶
-        for (const value of buckets) {
-            this.data.set(value.toString(), { le: value, count: 0 });
-        }
-        // 添加 +Inf 桶
-        this.data.set('+Inf', { le: Infinity, count: 0 });
-    }
-    /**
-     * 观察一个值
-     */
-    observe(value, labels) {
-        this.sum += value;
-        this.count += 1;
-        // 更新桶计数
-        for (const [key, bucket] of this.data) {
-            if (value <= bucket.le) {
-                bucket.count += 1;
-            }
-        }
-    }
-    /**
-     * 获取统计信息
-     */
-    getStats() {
-        const buckets = {};
-        for (const [key, bucket] of this.data) {
-            buckets[key === '+Inf' ? 'Inf' : key] = bucket.count;
-        }
-        return {
-            count: this.count,
-            sum: this.sum,
-            avg: this.count > 0 ? this.sum / this.count : 0,
-            buckets
-        };
-    }
-    /**
-     * 重置
-     */
-    reset() {
-        this.sum = 0;
-        this.count = 0;
-        for (const bucket of this.data.values()) {
-            bucket.count = 0;
-        }
-    }
-}
-exports.Histogram = Histogram;
-/**
- * 计数器指标
- */
-class Counter {
-    name;
-    description;
-    value = 0;
-    constructor(name, description) {
-        this.name = name;
-        this.description = description;
-    }
-    /**
-     * 增加计数
-     */
-    inc(delta = 1, labels) {
-        this.value += delta;
-    }
-    /**
-     * 获取当前值
-     */
-    get() {
-        return this.value;
-    }
-    /**
-     * 重置
-     */
-    reset() {
-        this.value = 0;
-    }
-}
-exports.Counter = Counter;
-/**
- * 仪表盘指标
- */
-class Gauge {
-    name;
-    description;
-    value = 0;
-    constructor(name, description) {
-        this.name = name;
-        this.description = description;
-    }
-    /**
-     * 设置值
-     */
-    set(value, labels) {
-        this.value = value;
-    }
-    /**
-     * 增加
-     */
-    inc(delta = 1, labels) {
-        this.value += delta;
-    }
-    /**
-     * 减少
-     */
-    dec(delta = 1, labels) {
-        this.value -= delta;
-    }
-    /**
-     * 获取当前值
-     */
-    get() {
-        return this.value;
-    }
-    /**
-     * 重置
-     */
-    reset() {
-        this.value = 0;
-    }
-}
-exports.Gauge = Gauge;
-/**
- * 性能指标收集器
- */
-class MetricsCollector {
-    metrics = new Map();
-    /**
-     * 创建或获取计数器
-     */
-    getCounter(name, description) {
-        if (!this.metrics.has(name)) {
-            this.metrics.set(name, new Counter(name, description));
-        }
-        const metric = this.metrics.get(name);
-        if (!(metric instanceof Counter)) {
-            throw new Error(`Metric ${name} is not a Counter`);
-        }
-        return metric;
-    }
-    /**
-     * 创建或获取仪表盘
-     */
-    getGauge(name, description) {
-        if (!this.metrics.has(name)) {
-            this.metrics.set(name, new Gauge(name, description));
-        }
-        const metric = this.metrics.get(name);
-        if (!(metric instanceof Gauge)) {
-            throw new Error(`Metric ${name} is not a Gauge`);
-        }
-        return metric;
-    }
-    /**
-     * 创建或获取直方图
-     */
-    getHistogram(name, description, buckets) {
-        if (!this.metrics.has(name)) {
-            this.metrics.set(name, new Histogram(name, description, buckets));
-        }
-        const metric = this.metrics.get(name);
-        if (!(metric instanceof Histogram)) {
-            throw new Error(`Metric ${name} is not a Histogram`);
-        }
-        return metric;
-    }
-    /**
-     * 获取所有指标
-     */
-    getAllMetrics() {
-        return this.metrics;
-    }
-    /**
-     * 重置所有指标
-     */
-    resetAll() {
-        for (const metric of this.metrics.values()) {
-            metric.reset();
-        }
-    }
-    /**
-     * 生成指标报告
-     */
-    generateReport() {
-        const lines = [];
-        lines.push('# Metrics Report');
-        lines.push(`# Generated at: ${new Date().toISOString()}`);
-        lines.push('');
-        for (const [name, metric] of this.metrics) {
-            lines.push(`# ${metric.description}`);
-            lines.push(`# TYPE ${name} ${metric.constructor.name}`);
-            if (metric instanceof Counter) {
-                lines.push(`${name} ${metric.get()}`);
-            }
-            else if (metric instanceof Gauge) {
-                lines.push(`${name} ${metric.get()}`);
-            }
-            else if (metric instanceof Histogram) {
-                const stats = metric.getStats();
-                lines.push(`${name}_count ${stats.count}`);
-                lines.push(`${name}_sum ${stats.sum}`);
-                for (const [bucket, count] of Object.entries(stats.buckets)) {
-                    lines.push(`${name}_bucket{le="${bucket}"} ${count}`);
-                }
-            }
-            lines.push('');
-        }
-        return lines.join('\n');
-    }
-}
-exports.MetricsCollector = MetricsCollector;
-// 全局指标收集器实例
-let globalMetricsCollector = null;
-/**
- * 初始化全局指标收集器
- */
-function initMetrics() {
-    if (!globalMetricsCollector) {
-        globalMetricsCollector = new MetricsCollector();
-        // 注册默认指标
-        registerDefaultMetrics(globalMetricsCollector);
-    }
-    return globalMetricsCollector;
-}
-/**
- * 注册默认指标
- */
-function registerDefaultMetrics(collector) {
-    // RSS 订阅相关
-    collector.getCounter('rss_fetch_total', 'RSS fetch total count');
-    collector.getCounter('rss_fetch_success', 'RSS fetch success count');
-    collector.getCounter('rss_fetch_error', 'RSS fetch error count');
-    collector.getHistogram('rss_fetch_duration', 'RSS fetch duration (ms)');
-    // HTML 监控相关
-    collector.getCounter('html_monitor_total', 'HTML monitor total count');
-    collector.getCounter('html_monitor_success', 'HTML monitor success count');
-    collector.getCounter('html_monitor_error', 'HTML monitor error count');
-    collector.getHistogram('html_monitor_duration', 'HTML monitor duration (ms)');
-    // AI 相关
-    collector.getCounter('ai_summary_total', 'AI summary total count');
-    collector.getCounter('ai_summary_success', 'AI summary success count');
-    collector.getCounter('ai_summary_error', 'AI summary error count');
-    collector.getCounter('ai_cache_hit', 'AI cache hit count');
-    collector.getCounter('ai_cache_miss', 'AI cache miss count');
-    collector.getHistogram('ai_summary_duration', 'AI summary duration (ms)');
-    // 消息推送相关
-    collector.getCounter('message_send_total', 'Message send total count');
-    collector.getCounter('message_send_success', 'Message send success count');
-    collector.getCounter('message_send_error', 'Message send error count');
-    // 性能相关
-    collector.getGauge('memory_usage', 'Memory usage (MB)');
-    collector.getGauge('active_subscriptions', 'Active subscriptions count');
-    collector.getGauge('queue_size', 'Queue size');
-    // Puppeteer 相关
-    collector.getCounter('puppeteer_render_total', 'Puppeteer render total count');
-    collector.getCounter('puppeteer_render_success', 'Puppeteer render success count');
-    collector.getCounter('puppeteer_render_error', 'Puppeteer render error count');
-    collector.getHistogram('puppeteer_render_duration', 'Puppeteer render duration (ms)');
-}
-/**
- * 获取全局指标收集器
- */
-function getMetricsCollector() {
-    return globalMetricsCollector;
-}
-/**
- * 便捷函数：增加计数器
- */
-function incCounter(name, delta = 1) {
-    if (globalMetricsCollector) {
-        try {
-            globalMetricsCollector.getCounter(name, '').inc(delta);
-        }
-        catch {
-            // 指标不存在，忽略
-        }
-    }
-}
-/**
- * 便捷函数：设置仪表盘
- */
-function setGauge(name, value) {
-    if (globalMetricsCollector) {
-        try {
-            globalMetricsCollector.getGauge(name, '').set(value);
-        }
-        catch {
-            // 指标不存在，忽略
-        }
-    }
-}
-/**
- * 便捷函数：观察直方图
- */
-function observeHistogram(name, value) {
-    if (globalMetricsCollector) {
-        try {
-            globalMetricsCollector.getHistogram(name, '').observe(value);
-        }
-        catch {
-            // 指标不存在，忽略
-        }
-    }
-}
-/**
- * 便捷函数：记录 RSS 获取成功
- */
-function recordRssFetch(duration) {
-    incCounter('rss_fetch_total');
-    incCounter('rss_fetch_success');
-    observeHistogram('rss_fetch_duration', duration);
-}
-/**
- * 便捷函数：记录 RSS 获取失败
- */
-function recordRssFetchError() {
-    incCounter('rss_fetch_total');
-    incCounter('rss_fetch_error');
-}
-/**
- * 便捷函数：记录 AI 摘要成功
- */
-function recordAiSummary(duration, cached) {
-    incCounter('ai_summary_total');
-    incCounter('ai_summary_success');
-    observeHistogram('ai_summary_duration', duration);
-    if (cached) {
-        incCounter('ai_cache_hit');
-    }
-    else {
-        incCounter('ai_cache_miss');
-    }
-}
-/**
- * 便捷函数：记录 AI 摘要失败
- */
-function recordAiSummaryError() {
-    incCounter('ai_summary_total');
-    incCounter('ai_summary_error');
-}
-/**
- * 便捷函数：记录消息发送
- */
-function recordMessageSend(success) {
-    incCounter('message_send_total');
-    if (success) {
-        incCounter('message_send_success');
-    }
-    else {
-        incCounter('message_send_error');
-    }
-}
-/**
- * 更新内存使用指标
- */
-function updateMemoryUsage() {
-    const memoryUsage = process.memoryUsage();
-    const heapUsedMB = memoryUsage.heapUsed / 1024 / 1024;
-    setGauge('memory_usage', heapUsedMB);
-}

package/lib/utils/structured-logger.d.ts

@@ -1,135 +0,0 @@
-/**
- * 观测辅助日志包装层。
- *
- * 注意：当前插件主流程日志入口是 `src/utils/logger.ts` 中的
- * `debug / debugInfo / debugError / createDebugWithContext`。
- * 这里保留为可选的观测与兼容包装，不应作为新业务代码的首选入口。
- */
-import { Config } from '../types';
-/**
- * 日志级别枚举
- */
-export declare enum LogLevel {
-    DISABLE = "disable",
-    ERROR = "error",
-    INFO = "info",
-    DETAILS = "details"
-}
-/**
- * 日志条目接口
- */
-export interface LogEntry {
-    timestamp: string;
-    level: LogLevel;
-    module: string;
-    message: string;
-    data?: Record<string, any>;
-    error?: {
-        name: string;
-        message: string;
-        stack?: string;
-    };
-    performance?: {
-        duration?: number;
-        memory?: number;
-    };
-    context?: {
-        platform?: string;
-        guildId?: string;
-        userId?: string;
-        rssId?: string;
-        url?: string;
-    };
-}
-/**
- * 性能计时器
- */
-export declare class PerformanceTimer {
-    private startTime;
-    private startMemory;
-    constructor();
-    /**
-     * 获取耗时（毫秒）
-     */
-    getDuration(): number;
-    /**
-     * 获取内存使用（MB）
-     */
-    getMemoryUsage(): number;
-    /**
-     * 获取性能数据
-     */
-    getMetrics(): {
-        duration: number;
-        memory: number;
-    };
-}
-/**
- * 结构化日志记录器类。
- * 内部仍然回落到主日志入口，避免形成第二条日志主线。
- */
-export declare class StructuredLogger {
-    private config;
-    private enableJsonOutput;
-    constructor(config: Config, enableJsonOutput?: boolean);
-    /**
-     * 判断是否应该记录日志
-     */
-    private shouldLog;
-    /**
-     * 格式化日志条目
-     */
-    private formatEntry;
-    /**
-     * 记录日志
-     */
-    private log;
-    /**
-     * 记录普通信息
-     */
-    info(message: string, module: string, data?: Record<string, any>, context?: LogEntry['context']): void;
-    /**
-     * 记录详细信息
-     */
-    details(message: string, module: string, data?: Record<string, any>, context?: LogEntry['context']): void;
-    /**
-     * 记录错误
-     */
-    error(message: string, module: string, error?: Error, context?: LogEntry['context']): void;
-    /**
-     * 记录性能数据
-     */
-    performance(message: string, module: string, timer: PerformanceTimer, context?: LogEntry['context']): void;
-    /**
-     * 创建性能计时器
-     */
-    createTimer(): PerformanceTimer;
-}
-/**
- * 初始化全局结构化日志
- */
-export declare function initStructuredLogger(config: Config, enableJsonOutput?: boolean): void;
-/**
- * 获取全局结构化日志实例
- */
-export declare function getStructuredLogger(): StructuredLogger | null;
-/**
- * 便捷方法：记录信息
- */
-export declare function logInfo(message: string, module: string, data?: Record<string, any>, context?: LogEntry['context']): void;
-/**
- * 便捷方法：记录详细信息
- */
-export declare function logDetails(message: string, module: string, data?: Record<string, any>, context?: LogEntry['context']): void;
-/**
- * 便捷方法：记录错误
- */
-export declare function logError(message: string, module: string, error?: Error, context?: LogEntry['context']): void;
-/**
- * 便捷方法：创建计时器
- */
-export declare function createTimer(): PerformanceTimer;
-/**
- * 便捷方法：记录性能
- */
-export declare function logPerformance(message: string, module: string, timer: PerformanceTimer, context?: LogEntry['context']): void;