agent-ide 0.1.0

package/dist/core/performance/memory-manager.js

@@ -0,0 +1,364 @@
+/**
+ * Performance Memory Manager
+ * 提供記憶體監控、管理和優化功能
+ */
+/**
+ * 預設記憶體管理配置
+ */
+export const DEFAULT_MEMORY_CONFIG = {
+    thresholds: {
+        warning: 256 * 1024 * 1024, // 256MB
+        error: 512 * 1024 * 1024, // 512MB
+        gcThreshold: 128 * 1024 * 1024 // 128MB
+    },
+    monitoringInterval: 5000, // 5秒
+    maxSnapshots: 100,
+    autoGc: true,
+    leakDetection: true
+};
+/**
+ * 記憶體事件類型
+ */
+export var MemoryEventType;
+(function (MemoryEventType) {
+    MemoryEventType["WARNING"] = "warning";
+    MemoryEventType["ERROR"] = "error";
+    MemoryEventType["GC_TRIGGERED"] = "gc_triggered";
+    MemoryEventType["LEAK_DETECTED"] = "leak_detected";
+    MemoryEventType["LIMIT_EXCEEDED"] = "limit_exceeded";
+})(MemoryEventType || (MemoryEventType = {}));
+/**
+ * 效能記憶體管理器
+ */
+export class PerformanceMemoryManager {
+    config;
+    snapshots = [];
+    listeners = new Map();
+    monitoringTimer;
+    isMonitoring = false;
+    gcCount = 0;
+    peakSnapshot;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_MEMORY_CONFIG, ...config };
+        // 初始化事件監聽器映射
+        Object.values(MemoryEventType).forEach(type => {
+            this.listeners.set(type, []);
+        });
+        // 監聽 Node.js GC 事件（如果可用）
+        if (global.gc) {
+            const originalGc = global.gc;
+            global.gc = async () => {
+                this.gcCount++;
+                this.emitEvent(MemoryEventType.GC_TRIGGERED, '手動觸發垃圾回收');
+                return originalGc();
+            };
+        }
+    }
+    /**
+     * 開始記憶體監控
+     */
+    startMonitoring() {
+        if (this.isMonitoring) {
+            return;
+        }
+        this.isMonitoring = true;
+        this.recordSnapshot(); // 記錄初始快照
+        this.monitoringTimer = setInterval(() => {
+            this.checkMemoryUsage();
+        }, this.config.monitoringInterval);
+    }
+    /**
+     * 停止記憶體監控
+     */
+    stopMonitoring() {
+        if (!this.isMonitoring) {
+            return;
+        }
+        this.isMonitoring = false;
+        if (this.monitoringTimer) {
+            clearInterval(this.monitoringTimer);
+            this.monitoringTimer = undefined;
+        }
+    }
+    /**
+     * 記錄記憶體快照
+     */
+    recordSnapshot() {
+        const memory = process.memoryUsage();
+        const snapshot = {
+            timestamp: new Date(),
+            heapUsed: memory.heapUsed,
+            heapTotal: memory.heapTotal,
+            rss: memory.rss,
+            external: memory.external,
+            arrayBuffers: memory.arrayBuffers
+        };
+        this.snapshots.push(snapshot);
+        // 維護快照數量限制
+        if (this.snapshots.length > this.config.maxSnapshots) {
+            this.snapshots.shift();
+        }
+        // 更新峰值
+        if (!this.peakSnapshot || snapshot.heapUsed > this.peakSnapshot.heapUsed) {
+            this.peakSnapshot = { ...snapshot };
+        }
+        return snapshot;
+    }
+    /**
+     * 獲取當前記憶體快照
+     */
+    getCurrentSnapshot() {
+        return this.recordSnapshot();
+    }
+    /**
+     * 獲取記憶體使用統計
+     */
+    getUsageStats() {
+        if (this.snapshots.length === 0) {
+            this.recordSnapshot();
+        }
+        const current = this.snapshots[this.snapshots.length - 1];
+        const peak = this.peakSnapshot || current;
+        const average = this.calculateAverageSnapshot();
+        const leakDetection = this.detectMemoryLeak();
+        return {
+            current,
+            peak,
+            average,
+            gcCount: this.gcCount,
+            leakDetection
+        };
+    }
+    /**
+     * 檢查記憶體使用量
+     */
+    checkMemoryUsage() {
+        const snapshot = this.recordSnapshot();
+        const { thresholds } = this.config;
+        // 檢查記憶體限制
+        if (this.config.memoryLimit && snapshot.heapUsed > this.config.memoryLimit) {
+            this.emitEvent(MemoryEventType.LIMIT_EXCEEDED, `記憶體使用超過限制: ${this.formatBytes(snapshot.heapUsed)}/${this.formatBytes(this.config.memoryLimit)}`);
+        }
+        // 檢查錯誤閾值
+        if (snapshot.heapUsed > thresholds.error) {
+            this.emitEvent(MemoryEventType.ERROR, `記憶體使用過高: ${this.formatBytes(snapshot.heapUsed)}`);
+            if (this.config.autoGc) {
+                this.triggerGarbageCollection();
+            }
+        }
+        // 檢查警告閾值
+        else if (snapshot.heapUsed > thresholds.warning) {
+            this.emitEvent(MemoryEventType.WARNING, `記憶體使用警告: ${this.formatBytes(snapshot.heapUsed)}`);
+        }
+        // 檢查是否需要觸發 GC
+        if (this.config.autoGc &&
+            thresholds.gcThreshold &&
+            snapshot.heapUsed > thresholds.gcThreshold) {
+            this.triggerGarbageCollection();
+        }
+        // 記憶體洩漏檢測
+        if (this.config.leakDetection) {
+            const leakInfo = this.detectMemoryLeak();
+            if (leakInfo.suspected) {
+                this.emitEvent(MemoryEventType.LEAK_DETECTED, `疑似記憶體洩漏，增長率: ${this.formatBytes(leakInfo.growthRate)}/秒`, leakInfo);
+            }
+        }
+    }
+    /**
+     * 觸發垃圾回收
+     */
+    triggerGarbageCollection() {
+        if (!global.gc) {
+            console.warn('垃圾回收不可用，請使用 --expose-gc 參數啟動 Node.js');
+            return false;
+        }
+        try {
+            global.gc();
+            this.gcCount++;
+            this.emitEvent(MemoryEventType.GC_TRIGGERED, '自動觸發垃圾回收');
+            return true;
+        }
+        catch (error) {
+            console.error('垃圾回收失敗:', error);
+            return false;
+        }
+    }
+    /**
+     * 檢測記憶體洩漏
+     */
+    detectMemoryLeak() {
+        if (this.snapshots.length < 10) {
+            return { suspected: false, growthRate: 0, stableTime: 0 };
+        }
+        // 計算最近 10 個快照的記憶體增長率
+        const recentSnapshots = this.snapshots.slice(-10);
+        const timeSpan = recentSnapshots[recentSnapshots.length - 1].timestamp.getTime() -
+            recentSnapshots[0].timestamp.getTime();
+        const memoryGrowth = recentSnapshots[recentSnapshots.length - 1].heapUsed -
+            recentSnapshots[0].heapUsed;
+        const growthRate = timeSpan > 0 ? (memoryGrowth / timeSpan) * 1000 : 0; // 每秒位元組
+        // 檢查記憶體是否持續增長（簡化的洩漏檢測）
+        const isGrowing = growthRate > 1024 * 10; // 每秒增長超過 10KB
+        const stableTime = this.calculateStableTime();
+        return {
+            suspected: isGrowing && stableTime < 30000, // 30秒內不穩定
+            growthRate,
+            stableTime
+        };
+    }
+    /**
+     * 計算記憶體穩定時間
+     */
+    calculateStableTime() {
+        if (this.snapshots.length < 5) {
+            return 0;
+        }
+        const recent = this.snapshots.slice(-5);
+        const variance = this.calculateVariance(recent.map(s => s.heapUsed));
+        const threshold = 1024 * 1024; // 1MB
+        return variance < threshold ?
+            recent[recent.length - 1].timestamp.getTime() - recent[0].timestamp.getTime() :
+            0;
+    }
+    /**
+     * 計算變異數
+     */
+    calculateVariance(values) {
+        const mean = values.reduce((sum, val) => sum + val, 0) / values.length;
+        const variance = values.reduce((sum, val) => sum + Math.pow(val - mean, 2), 0) / values.length;
+        return variance;
+    }
+    /**
+     * 計算平均記憶體快照
+     */
+    calculateAverageSnapshot() {
+        if (this.snapshots.length === 0) {
+            return this.getCurrentSnapshot();
+        }
+        const sum = this.snapshots.reduce((acc, snapshot) => ({
+            heapUsed: acc.heapUsed + snapshot.heapUsed,
+            heapTotal: acc.heapTotal + snapshot.heapTotal,
+            rss: acc.rss + snapshot.rss,
+            external: acc.external + snapshot.external,
+            arrayBuffers: acc.arrayBuffers + snapshot.arrayBuffers
+        }), {
+            heapUsed: 0,
+            heapTotal: 0,
+            rss: 0,
+            external: 0,
+            arrayBuffers: 0
+        });
+        const count = this.snapshots.length;
+        return {
+            timestamp: new Date(),
+            heapUsed: Math.round(sum.heapUsed / count),
+            heapTotal: Math.round(sum.heapTotal / count),
+            rss: Math.round(sum.rss / count),
+            external: Math.round(sum.external / count),
+            arrayBuffers: Math.round(sum.arrayBuffers / count)
+        };
+    }
+    /**
+     * 註冊事件監聽器
+     */
+    on(eventType, listener) {
+        const listeners = this.listeners.get(eventType);
+        if (listeners) {
+            listeners.push(listener);
+        }
+    }
+    /**
+     * 移除事件監聽器
+     */
+    off(eventType, listener) {
+        const listeners = this.listeners.get(eventType);
+        if (listeners) {
+            const index = listeners.indexOf(listener);
+            if (index !== -1) {
+                listeners.splice(index, 1);
+            }
+        }
+    }
+    /**
+     * 發送事件
+     */
+    emitEvent(type, message, data) {
+        const event = {
+            type,
+            timestamp: new Date(),
+            snapshot: this.getCurrentSnapshot(),
+            message,
+            data
+        };
+        const listeners = this.listeners.get(type);
+        if (listeners) {
+            listeners.forEach(listener => {
+                try {
+                    listener(event);
+                }
+                catch (error) {
+                    console.error('記憶體事件監聽器錯誤:', error);
+                }
+            });
+        }
+    }
+    /**
+     * 獲取記憶體快照歷史
+     */
+    getSnapshots() {
+        return [...this.snapshots];
+    }
+    /**
+     * 清理快照歷史
+     */
+    clearSnapshots() {
+        this.snapshots = [];
+        this.peakSnapshot = undefined;
+    }
+    /**
+     * 格式化位元組數
+     */
+    formatBytes(bytes) {
+        const units = ['B', 'KB', 'MB', 'GB'];
+        let size = bytes;
+        let unitIndex = 0;
+        while (size >= 1024 && unitIndex < units.length - 1) {
+            size /= 1024;
+            unitIndex++;
+        }
+        return `${size.toFixed(2)}${units[unitIndex]}`;
+    }
+    /**
+     * 獲取記憶體使用建議
+     */
+    getOptimizationSuggestions() {
+        const stats = this.getUsageStats();
+        const suggestions = [];
+        if (stats.current.heapUsed > this.config.thresholds.warning) {
+            suggestions.push('記憶體使用量較高，建議檢查是否有未釋放的資源');
+        }
+        if (stats.leakDetection.suspected) {
+            suggestions.push('檢測到疑似記憶體洩漏，建議檢查事件監聽器和定時器是否正確清理');
+        }
+        if (stats.gcCount > 100) {
+            suggestions.push('垃圾回收頻繁，考慮優化物件創建和銷毀模式');
+        }
+        if (stats.current.heapUsed / stats.current.heapTotal > 0.9) {
+            suggestions.push('堆使用率過高，考慮增加堆大小或優化記憶體使用');
+        }
+        return suggestions;
+    }
+    /**
+     * 清理資源
+     */
+    dispose() {
+        this.stopMonitoring();
+        this.clearSnapshots();
+        this.listeners.clear();
+    }
+}
+/**
+ * 全域記憶體管理器實例
+ */
+export const globalMemoryManager = new PerformanceMemoryManager();
+//# sourceMappingURL=memory-manager.js.map

package/dist/core/performance/memory-manager.js.map

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

package/dist/core/performance/monitor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Performance Monitor 實作
+ * 提供效能監控和指標收集功能
+ */
+import { PerformanceMonitor, PerformanceMetrics, MemorySnapshot } from './interfaces.js';
+/**
+ * 預設效能監控器實作
+ */
+export declare class DefaultPerformanceMonitor implements PerformanceMonitor {
+    private startTime;
+    private startMemory;
+    private isMonitoring;
+    private memorySnapshots;
+    /**
+     * 開始監控
+     */
+    start(): void;
+    /**
+     * 停止監控
+     */
+    stop(): PerformanceMetrics;
+    /**
+     * 記錄記憶體快照
+     */
+    recordMemorySnapshot(): MemorySnapshot;
+    /**
+     * 獲取當前指標
+     */
+    getCurrentMetrics(): PerformanceMetrics;
+    /**
+     * 獲取記憶體快照歷史
+     */
+    getMemorySnapshots(): MemorySnapshot[];
+    /**
+     * 清理快照
+     */
+    clearSnapshots(): void;
+    /**
+     * 估算 CPU 使用率（簡化版本）
+     */
+    private estimateCpuUsage;
+}
+/**
+ * 批量效能監控器
+ * 用於監控多個並行操作
+ */
+export declare class BatchPerformanceMonitor {
+    private monitors;
+    /**
+     * 開始監控特定操作
+     */
+    startOperation(operationId: string): void;
+    /**
+     * 停止監控特定操作
+     */
+    stopOperation(operationId: string): PerformanceMetrics | null;
+    /**
+     * 獲取所有正在監控的操作
+     */
+    getActiveOperations(): string[];
+    /**
+     * 獲取操作的當前指標
+     */
+    getOperationMetrics(operationId: string): PerformanceMetrics | null;
+    /**
+     * 停止所有監控
+     */
+    stopAll(): Map<string, PerformanceMetrics>;
+    /**
+     * 清理資源
+     */
+    dispose(): void;
+}
+/**
+ * 全域效能監控器實例
+ */
+export declare const globalPerformanceMonitor: DefaultPerformanceMonitor;
+/**
+ * 工具函式：測量函式執行時間
+ */
+export declare function measureAsync<T>(operation: () => Promise<T>, operationName?: string): Promise<{
+    result: T;
+    metrics: PerformanceMetrics;
+}>;
+/**
+ * 工具函式：測量同步函式執行時間
+ */
+export declare function measureSync<T>(operation: () => T, operationName?: string): {
+    result: T;
+    metrics: PerformanceMetrics;
+};
+//# sourceMappingURL=monitor.d.ts.map

package/dist/core/performance/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../../src/core/performance/monitor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,eAAe,CAAwB;IAE/C;;OAEG;IACH,KAAK,IAAI,IAAI;IAUb;;OAEG;IACH,IAAI,IAAI,kBAAkB;IA6B1B;;OAEG;IACH,oBAAoB,IAAI,cAAc;IAetC;;OAEG;IACH,iBAAiB,IAAI,kBAAkB;IAqBvC;;OAEG;IACH,kBAAkB,IAAI,cAAc,EAAE;IAItC;;OAEG;IACH,cAAc,IAAI,IAAI;IAItB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAgBzB;AAED;;;GAGG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAqD;IAErE;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMzC;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAW7D;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAKnE;;OAEG;IACH,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAe1C;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,2BAAkC,CAAC;AAExE;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAqBrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,CAAC,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAoB5C"}