@dommaker/harness 0.7.2 → 0.7.4

package/dist/monitoring/performance-analyzer.js

@@ -0,0 +1,417 @@
+"use strict";
+/**
+ * Performance Analyzer
+ *
+ * 纯计算，零 Token 成本
+ *
+ * 功能：
+ * - 统计汇总（每小时自动执行）
+ * - 异常检测（每日检查）
+ * - 趋势分析（对比上一周期）
+ *
+ * 与 TraceAnalyzer 的区别：
+ * - TraceAnalyzer: 分析约束检查结果
+ * - PerformanceAnalyzer: 分析操作耗时
+ */
+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.PerformanceAnalyzer = void 0;
+exports.createPerformanceAnalyzer = createPerformanceAnalyzer;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const performance_collector_1 = require("./performance-collector");
+/**
+ * 默认配置
+ */
+const DEFAULT_CONFIG = {
+    summaryFile: '.harness/logs/performance-summary.json',
+    periodMs: 3600 * 1000, // 1 小时
+    thresholds: {
+        avgDuration: 5000, // 平均耗时 > 5s 视为异常
+        exceededRate: 0.3, // 超阈值率 > 30% 视为异常
+        errorRate: 0.1, // 错误率 > 10% 视为异常
+    },
+};
+/**
+ * Performance Analyzer
+ *
+ * 使用方式：
+ * ```typescript
+ * const analyzer = new PerformanceAnalyzer(collector);
+ * const summaries = analyzer.summarize(traces);
+ * const anomalies = analyzer.detectAnomalies(summaries);
+ * ```
+ */
+class PerformanceAnalyzer {
+    config;
+    collector;
+    constructor(collector, config) {
+        this.collector = collector;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * 生成统计汇总
+     *
+     * 纯计算，零 Token 成本
+     */
+    summarize(traces) {
+        // 按操作类型分组
+        const grouped = this.groupByOperation(traces);
+        const summaries = [];
+        for (const [operation, group] of grouped) {
+            // 计算时间范围
+            const timestamps = group.map(t => t.timestamp);
+            const timeRange = {
+                start: Math.min(...timestamps),
+                end: Math.max(...timestamps),
+            };
+            // 计算核心统计
+            const totalCalls = group.length;
+            const okCount = group.filter(t => t.result === 'ok').length;
+            const exceededCount = group.filter(t => t.result === 'exceeded').length;
+            const errorCount = group.filter(t => t.result === 'error').length;
+            // 计算比率
+            const okRate = totalCalls > 0 ? okCount / totalCalls : 0;
+            const exceededRate = totalCalls > 0 ? exceededCount / totalCalls : 0;
+            const errorRate = totalCalls > 0 ? errorCount / totalCalls : 0;
+            // 计算耗时统计
+            const durations = group.map(t => t.duration);
+            const avgDuration = this.calcAverage(durations);
+            const maxDuration = Math.max(...durations);
+            const minDuration = Math.min(...durations);
+            const p95Duration = this.calcPercentile(durations, 95);
+            const p99Duration = this.calcPercentile(durations, 99);
+            // 计算趋势
+            const recentTrend = this.calculateTrend(group);
+            summaries.push({
+                operation,
+                timeRange,
+                totalCalls,
+                okCount,
+                exceededCount,
+                errorCount,
+                avgDuration,
+                maxDuration,
+                minDuration,
+                p95Duration,
+                p99Duration,
+                okRate,
+                exceededRate,
+                errorRate,
+                recentTrend,
+            });
+        }
+        return summaries;
+    }
+    /**
+     * 分析最近 N 小时的 traces
+     */
+    analyzeRecent(hours) {
+        const traces = this.collector.readRecent(hours);
+        return this.summarize(traces);
+    }
+    /**
+     * 分析特定操作
+     */
+    analyzeOperation(operation) {
+        const traces = this.collector.readByOperation(operation);
+        return this.summarize(traces);
+    }
+    /**
+     * 检测异常
+     *
+     * 基于阈值检测异常模式
+     */
+    detectAnomalies(summaries) {
+        const anomalies = [];
+        const thresholds = this.config.thresholds;
+        for (const summary of summaries) {
+            // 检测高平均耗时
+            if (summary.avgDuration > thresholds.avgDuration) {
+                anomalies.push({
+                    type: 'high_avg_duration',
+                    operation: summary.operation,
+                    message: `操作 ${summary.operation} 平均耗时 ${Math.round(summary.avgDuration)}ms，超过阈值 ${thresholds.avgDuration}ms`,
+                    data: {
+                        currentValue: summary.avgDuration,
+                        threshold: thresholds.avgDuration,
+                    },
+                    detectedAt: Date.now(),
+                    suggestedAction: 'optimize',
+                });
+            }
+            // 检测耗时趋势上升
+            if (summary.recentTrend === 'rising') {
+                anomalies.push({
+                    type: 'rising_duration',
+                    operation: summary.operation,
+                    message: `操作 ${summary.operation} 耗时趋势上升`,
+                    data: {
+                        currentValue: summary.avgDuration,
+                        threshold: 0,
+                        trend: 'rising',
+                    },
+                    detectedAt: Date.now(),
+                    suggestedAction: 'optimize',
+                });
+            }
+            // 检测高超阈值率
+            if (summary.exceededRate > thresholds.exceededRate) {
+                anomalies.push({
+                    type: 'high_exceeded_rate',
+                    operation: summary.operation,
+                    message: `操作 ${summary.operation} 超阈值率 ${Math.round(summary.exceededRate * 100)}%，超过阈值 ${thresholds.exceededRate * 100}%`,
+                    data: {
+                        currentValue: summary.exceededRate,
+                        threshold: thresholds.exceededRate,
+                    },
+                    detectedAt: Date.now(),
+                    suggestedAction: 'adjust_threshold',
+                });
+            }
+            // 检测超阈值率上升
+            if (summary.exceededRate > 0.1 && summary.recentTrend === 'rising') {
+                anomalies.push({
+                    type: 'rising_exceeded_rate',
+                    operation: summary.operation,
+                    message: `操作 ${summary.operation} 超阈值率 ${Math.round(summary.exceededRate * 100)}% 且趋势上升`,
+                    data: {
+                        currentValue: summary.exceededRate,
+                        threshold: 0.1,
+                        trend: 'rising',
+                    },
+                    detectedAt: Date.now(),
+                    suggestedAction: 'optimize',
+                });
+            }
+            // 检测高错误率
+            if (summary.errorRate > thresholds.errorRate) {
+                anomalies.push({
+                    type: 'high_error_rate',
+                    operation: summary.operation,
+                    message: `操作 ${summary.operation} 错误率 ${Math.round(summary.errorRate * 100)}%，超过阈值 ${thresholds.errorRate * 100}%`,
+                    data: {
+                        currentValue: summary.errorRate,
+                        threshold: thresholds.errorRate,
+                    },
+                    detectedAt: Date.now(),
+                    suggestedAction: 'notify_user',
+                });
+            }
+        }
+        return anomalies;
+    }
+    /**
+     * 对比上一周期
+     *
+     * 计算各指标的环比变化
+     */
+    compareWithPrevious(current, previous) {
+        const previousMap = new Map(previous.map(s => [s.operation, s]));
+        return current.map(summary => {
+            const prev = previousMap.get(summary.operation);
+            if (prev) {
+                summary.changeFromLastPeriod = {
+                    avgDurationDelta: summary.avgDuration - prev.avgDuration,
+                    exceededRateDelta: summary.exceededRate - prev.exceededRate,
+                };
+            }
+            return summary;
+        });
+    }
+    /**
+     * 按操作类型分组
+     */
+    groupByOperation(traces) {
+        const grouped = new Map();
+        for (const trace of traces) {
+            const existing = grouped.get(trace.operation) || [];
+            existing.push(trace);
+            grouped.set(trace.operation, existing);
+        }
+        return grouped;
+    }
+    /**
+     * 计算趋势
+     *
+     * 对比前半段和后半段的平均耗时
+     */
+    calculateTrend(traces) {
+        if (traces.length < 10) {
+            return 'stable';
+        }
+        // 按时间排序
+        const sorted = [...traces].sort((a, b) => a.timestamp - b.timestamp);
+        // 分成前后两半
+        const half = Math.floor(sorted.length / 2);
+        const firstHalf = sorted.slice(0, half);
+        const secondHalf = sorted.slice(half);
+        // 计算前半段和后半段的平均耗时
+        const firstAvg = this.calcAverage(firstHalf.map(t => t.duration));
+        const secondAvg = this.calcAverage(secondHalf.map(t => t.duration));
+        // 计算变化率
+        const delta = secondAvg - firstAvg;
+        const changeRate = firstAvg > 0 ? delta / firstAvg : 0;
+        // 判断趋势（变化 > 10% 才算显著）
+        if (changeRate > 0.1) {
+            return 'rising';
+        }
+        else if (changeRate < -0.1) {
+            return 'falling';
+        }
+        else {
+            return 'stable';
+        }
+    }
+    /**
+     * 计算平均值
+     */
+    calcAverage(values) {
+        if (values.length === 0)
+            return 0;
+        return values.reduce((sum, v) => sum + v, 0) / values.length;
+    }
+    /**
+     * 计算百分位数
+     */
+    calcPercentile(values, percentile) {
+        if (values.length === 0)
+            return 0;
+        const sorted = [...values].sort((a, b) => a - b);
+        const index = Math.ceil((percentile / 100) * sorted.length) - 1;
+        return sorted[Math.max(0, index)];
+    }
+    /**
+     * 保存汇总结果
+     */
+    saveSummary(summaries) {
+        const dir = path.dirname(this.config.summaryFile);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(this.config.summaryFile, JSON.stringify(summaries, null, 2), 'utf-8');
+    }
+    /**
+     * 加载上次汇总结果
+     */
+    loadSummary() {
+        if (!fs.existsSync(this.config.summaryFile)) {
+            return null;
+        }
+        const content = fs.readFileSync(this.config.summaryFile, 'utf-8');
+        return JSON.parse(content);
+    }
+    /**
+     * 运行每小时汇总
+     *
+     * 自动执行，零 Token 成本
+     */
+    runHourlySummary() {
+        // 分析最近 1 小时
+        const current = this.analyzeRecent(1);
+        // 加载上次汇总，对比趋势
+        const previous = this.loadSummary();
+        if (previous) {
+            this.compareWithPrevious(current, previous);
+        }
+        // 保存当前汇总
+        this.saveSummary(current);
+        return current;
+    }
+    /**
+     * 运行每日异常检测
+     *
+     * 返回异常列表，用于触发优化
+     */
+    runDailyAnomalyCheck() {
+        // 分析最近 24 小时
+        const summaries = this.analyzeRecent(24);
+        // 检测异常
+        const anomalies = this.detectAnomalies(summaries);
+        return anomalies;
+    }
+    /**
+     * 生成报告（文本格式）
+     */
+    generateReport(summaries, anomalies) {
+        const lines = [];
+        lines.push('# Performance Report');
+        lines.push(`Generated: ${new Date().toISOString()}`);
+        lines.push('');
+        // 汇总部分
+        lines.push('## Operation Summaries');
+        lines.push('');
+        for (const summary of summaries) {
+            const trendEmoji = {
+                rising: '📈',
+                falling: '📉',
+                stable: '➡️',
+            }[summary.recentTrend];
+            lines.push(`**${summary.operation}** ${trendEmoji}`);
+            lines.push(`  - Calls: ${summary.totalCalls}`);
+            lines.push(`  - Avg: ${Math.round(summary.avgDuration)}ms`);
+            lines.push(`  - P95: ${Math.round(summary.p95Duration)}ms`);
+            lines.push(`  - P99: ${Math.round(summary.p99Duration)}ms`);
+            lines.push(`  - OK: ${Math.round(summary.okRate * 100)}%`);
+            lines.push(`  - Exceeded: ${Math.round(summary.exceededRate * 100)}%`);
+            lines.push(`  - Errors: ${Math.round(summary.errorRate * 100)}%`);
+            lines.push('');
+        }
+        // 异常部分
+        if (anomalies.length > 0) {
+            lines.push('## Anomalies Detected');
+            lines.push('');
+            for (const anomaly of anomalies) {
+                lines.push(`⚠️ **${anomaly.type}**: ${anomaly.operation}`);
+                lines.push(`  - ${anomaly.message}`);
+                lines.push(`  - Suggested: ${anomaly.suggestedAction}`);
+                lines.push('');
+            }
+        }
+        else {
+            lines.push('## No Anomalies Detected ✅');
+        }
+        return lines.join('\n');
+    }
+}
+exports.PerformanceAnalyzer = PerformanceAnalyzer;
+/**
+ * 创建分析器（使用全局收集器）
+ */
+function createPerformanceAnalyzer(config) {
+    const collector = new performance_collector_1.PerformanceCollector();
+    return new PerformanceAnalyzer(collector, config);
+}
+//# sourceMappingURL=performance-analyzer.js.map

package/dist/monitoring/performance-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-analyzer.js","sourceRoot":"","sources":["../../src/monitoring/performance-analyzer.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/performance-collector.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Performance Collector
+ *
+ * 轻量设计，零 Token 成本
+ *
+ * 功能：
+ * - 记录操作耗时（追加写入）
+ * - 批量读取 traces（按时间范围过滤）
+ * - 文件滚动（防止文件过大）
+ *
+ * 与 TraceCollector 的区别：
+ * - TraceCollector: 记录约束检查结果
+ * - PerformanceCollector: 记录操作耗时
+ */
+import type { PerformanceTrace, PerformanceTraceFilter, PerformanceCollectorConfig } from '../types/performance';
+/**
+ * Performance Collector
+ *
+ * 使用方式：
+ * ```typescript
+ * const collector = new PerformanceCollector();
+ * collector.recordOk('extract', 150);
+ * collector.recordExceeded('invokeSkillAgent', 35000, 30000);
+ * ```
+ */
+export declare class PerformanceCollector {
+    private config;
+    private logFile;
+    constructor(config?: Partial<PerformanceCollectorConfig>);
+    /**
+     * 确保日志目录存在
+     */
+    private ensureDirectory;
+    /**
+     * 记录一条性能数据
+     *
+     * 轻量操作：
+     * - 追加写入（不读取现有内容）
+     * - 单行 JSON（便于批量处理）
+     * - 零 Token 成本
+     */
+    record(trace: PerformanceTrace): void;
+    /**
+     * 快捷方法：记录正常执行
+     */
+    recordOk(operation: string, duration: number, metadata?: Record<string, unknown>): void;
+    /**
+     * 快捷方法：记录超阈值
+     */
+    recordExceeded(operation: string, duration: number, threshold: number, metadata?: Record<string, unknown>): void;
+    /**
+     * 快捷方法：记录错误
+     */
+    recordError(operation: string, duration: number, error: Error | string, metadata?: Record<string, unknown>): void;
+    /**
+     * 批量读取 traces
+     *
+     * 支持过滤条件：
+     * - 时间范围
+     * - 操作类型
+     * - 结果类型
+     */
+    read(filter?: PerformanceTraceFilter): PerformanceTrace[];
+    /**
+     * 读取最近 N 小时的 traces
+     */
+    readRecent(hours: number): PerformanceTrace[];
+    /**
+     * 读取特定操作的 traces
+     */
+    readByOperation(operation: string): PerformanceTrace[];
+    /**
+     * 应用过滤条件
+     */
+    private applyFilter;
+    /**
+     * 检查文件大小，必要时滚动
+     */
+    private checkFileSize;
+    /**
+     * 滚动文件
+     *
+     * 将当前文件重命名为带时间戳的备份
+     */
+    private rotateFile;
+    /**
+     * 清理旧备份文件
+     *
+     * 删除超过 maxAge 天的备份文件
+     */
+    cleanupOldFiles(maxAgeDays?: number): number;
+    /**
+     * 获取日志文件统计信息
+     */
+    getStats(): {
+        fileExists: boolean;
+        fileSize: number;
+        totalRecords: number;
+        oldestRecord?: number;
+        newestRecord?: number;
+    };
+}
+/**
+ * 获取全局收集器
+ */
+export declare function getPerformanceCollector(): PerformanceCollector;
+/**
+ * 配置全局收集器
+ */
+export declare function configurePerformanceCollector(config: Partial<PerformanceCollectorConfig>): void;
+//# sourceMappingURL=performance-collector.d.ts.map

package/dist/monitoring/performance-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-collector.d.ts","sourceRoot":"","sources":["../../src/monitoring/performance-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAW9B;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC;IAMxD;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAWrC;;OAEG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAUP;;OAEG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAWP;;OAEG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAaP;;;;;;;OAOG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,gBAAgB,EAAE;IAkBzD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAK7C;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAItD;;OAEG;IACH,OAAO,CAAC,WAAW;IA8CnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAWlB;;;;OAIG;IACH,eAAe,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IA0BhD;;OAEG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,OAAO,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;CA2BF;AAOD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAK9D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI,CAE/F"}