@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/Utils/PerformanceMonitor.d.ts

@@ -0,0 +1,196 @@
+/**
+ * 性能监控数据
+ */
+export interface PerformanceData {
+    /** 系统名称 */
+    name: string;
+    /** 执行时间（毫秒） */
+    executionTime: number;
+    /** 处理的实体数量 */
+    entityCount: number;
+    /** 平均每个实体的处理时间 */
+    averageTimePerEntity: number;
+    /** 最后更新时间戳 */
+    lastUpdateTime: number;
+    /** 内存使用量（字节） */
+    memoryUsage?: number;
+    /** CPU使用率（百分比） */
+    cpuUsage?: number;
+}
+/**
+ * 性能统计信息
+ */
+export interface PerformanceStats {
+    /** 总执行时间 */
+    totalTime: number;
+    /** 平均执行时间 */
+    averageTime: number;
+    /** 最小执行时间 */
+    minTime: number;
+    /** 最大执行时间 */
+    maxTime: number;
+    /** 执行次数 */
+    executionCount: number;
+    /** 最近的执行时间列表 */
+    recentTimes: number[];
+    /** 标准差 */
+    standardDeviation: number;
+    /** 95百分位数 */
+    percentile95: number;
+    /** 99百分位数 */
+    percentile99: number;
+}
+/**
+ * 性能警告类型
+ */
+export declare enum PerformanceWarningType {
+    HIGH_EXECUTION_TIME = "high_execution_time",
+    HIGH_MEMORY_USAGE = "high_memory_usage",
+    HIGH_CPU_USAGE = "high_cpu_usage",
+    FREQUENT_GC = "frequent_gc",
+    LOW_FPS = "low_fps",
+    HIGH_ENTITY_COUNT = "high_entity_count"
+}
+/**
+ * 性能警告
+ */
+export interface PerformanceWarning {
+    type: PerformanceWarningType;
+    systemName: string;
+    message: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    timestamp: number;
+    value: number;
+    threshold: number;
+    suggestion?: string;
+}
+/**
+ * 性能阈值配置
+ */
+export interface PerformanceThresholds {
+    /** 执行时间阈值（毫秒） */
+    executionTime: {
+        warning: number;
+        critical: number;
+    };
+    /** 内存使用阈值（MB） */
+    memoryUsage: {
+        warning: number;
+        critical: number;
+    };
+    /** CPU使用率阈值（百分比） */
+    cpuUsage: {
+        warning: number;
+        critical: number;
+    };
+    /** FPS阈值 */
+    fps: {
+        warning: number;
+        critical: number;
+    };
+    /** 实体数量阈值 */
+    entityCount: {
+        warning: number;
+        critical: number;
+    };
+}
+import type { IService } from '../Core/ServiceContainer';
+/**
+ * 高性能监控器
+ * 用于监控ECS系统的性能表现，提供详细的分析和优化建议
+ */
+export declare class PerformanceMonitor implements IService {
+    private _systemData;
+    private _systemStats;
+    private _isEnabled;
+    private _maxRecentSamples;
+    constructor();
+    /**
+     * 启用性能监控
+     */
+    enable(): void;
+    /**
+     * 禁用性能监控
+     */
+    disable(): void;
+    /**
+     * 检查是否启用了性能监控
+     */
+    get isEnabled(): boolean;
+    /**
+     * 开始监控系统性能
+     * @param systemName 系统名称
+     * @returns 开始时间戳
+     */
+    startMonitoring(_systemName: string): number;
+    /**
+     * 结束监控并记录性能数据
+     * @param systemName 系统名称
+     * @param startTime 开始时间戳
+     * @param entityCount 处理的实体数量
+     */
+    endMonitoring(systemName: string, startTime: number, entityCount?: number): void;
+    /**
+     * 更新系统统计信息
+     * @param systemName 系统名称
+     * @param executionTime 执行时间
+     */
+    private updateStats;
+    /**
+     * 计算高级统计信息
+     * @param stats 统计信息对象
+     */
+    private calculateAdvancedStats;
+    /**
+     * 获取系统的当前性能数据
+     * @param systemName 系统名称
+     * @returns 性能数据或undefined
+     */
+    getSystemData(systemName: string): PerformanceData | undefined;
+    /**
+     * 获取系统的统计信息
+     * @param systemName 系统名称
+     * @returns 统计信息或undefined
+     */
+    getSystemStats(systemName: string): PerformanceStats | undefined;
+    /**
+     * 获取所有系统的性能数据
+     * @returns 所有系统的性能数据
+     */
+    getAllSystemData(): Map<string, PerformanceData>;
+    /**
+     * 获取所有系统的统计信息
+     * @returns 所有系统的统计信息
+     */
+    getAllSystemStats(): Map<string, PerformanceStats>;
+    /**
+     * 获取性能报告
+     * @returns 格式化的性能报告字符串
+     */
+    getPerformanceReport(): string;
+    /**
+     * 重置所有性能数据
+     */
+    reset(): void;
+    /**
+     * 重置指定系统的性能数据
+     * @param systemName 系统名称
+     */
+    resetSystem(systemName: string): void;
+    /**
+     * 获取性能警告
+     * @param thresholdMs 警告阈值（毫秒）
+     * @returns 超过阈值的系统列表
+     */
+    getPerformanceWarnings(thresholdMs?: number): string[];
+    /**
+     * 设置最大保留样本数
+     * @param maxSamples 最大样本数
+     */
+    setMaxRecentSamples(maxSamples: number): void;
+    /**
+     * 释放资源
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=PerformanceMonitor.d.ts.map

package/bin/Utils/PerformanceMonitor.d.ts.map

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

package/bin/Utils/PerformanceMonitor.js

@@ -0,0 +1,244 @@
+/**
+ * 性能警告类型
+ */
+export var PerformanceWarningType;
+(function (PerformanceWarningType) {
+    PerformanceWarningType["HIGH_EXECUTION_TIME"] = "high_execution_time";
+    PerformanceWarningType["HIGH_MEMORY_USAGE"] = "high_memory_usage";
+    PerformanceWarningType["HIGH_CPU_USAGE"] = "high_cpu_usage";
+    PerformanceWarningType["FREQUENT_GC"] = "frequent_gc";
+    PerformanceWarningType["LOW_FPS"] = "low_fps";
+    PerformanceWarningType["HIGH_ENTITY_COUNT"] = "high_entity_count";
+})(PerformanceWarningType || (PerformanceWarningType = {}));
+/**
+ * 高性能监控器
+ * 用于监控ECS系统的性能表现，提供详细的分析和优化建议
+ */
+export class PerformanceMonitor {
+    constructor() {
+        this._systemData = new Map();
+        this._systemStats = new Map();
+        this._isEnabled = false;
+        this._maxRecentSamples = 60; // 保留最近60帧的数据
+    }
+    /**
+     * 启用性能监控
+     */
+    enable() {
+        this._isEnabled = true;
+    }
+    /**
+     * 禁用性能监控
+     */
+    disable() {
+        this._isEnabled = false;
+    }
+    /**
+     * 检查是否启用了性能监控
+     */
+    get isEnabled() {
+        return this._isEnabled;
+    }
+    /**
+     * 开始监控系统性能
+     * @param systemName 系统名称
+     * @returns 开始时间戳
+     */
+    startMonitoring(_systemName) {
+        if (!this._isEnabled) {
+            return 0;
+        }
+        return performance.now();
+    }
+    /**
+     * 结束监控并记录性能数据
+     * @param systemName 系统名称
+     * @param startTime 开始时间戳
+     * @param entityCount 处理的实体数量
+     */
+    endMonitoring(systemName, startTime, entityCount = 0) {
+        if (!this._isEnabled || startTime === 0) {
+            return;
+        }
+        const endTime = performance.now();
+        const executionTime = endTime - startTime;
+        const averageTimePerEntity = entityCount > 0 ? executionTime / entityCount : 0;
+        // 更新当前性能数据
+        const data = {
+            name: systemName,
+            executionTime,
+            entityCount,
+            averageTimePerEntity,
+            lastUpdateTime: endTime
+        };
+        this._systemData.set(systemName, data);
+        // 更新统计信息
+        this.updateStats(systemName, executionTime);
+    }
+    /**
+     * 更新系统统计信息
+     * @param systemName 系统名称
+     * @param executionTime 执行时间
+     */
+    updateStats(systemName, executionTime) {
+        let stats = this._systemStats.get(systemName);
+        if (!stats) {
+            stats = {
+                totalTime: 0,
+                averageTime: 0,
+                minTime: Number.MAX_VALUE,
+                maxTime: 0,
+                executionCount: 0,
+                recentTimes: [],
+                standardDeviation: 0,
+                percentile95: 0,
+                percentile99: 0
+            };
+            this._systemStats.set(systemName, stats);
+        }
+        // 更新基本统计
+        stats.totalTime += executionTime;
+        stats.executionCount++;
+        stats.averageTime = stats.totalTime / stats.executionCount;
+        stats.minTime = Math.min(stats.minTime, executionTime);
+        stats.maxTime = Math.max(stats.maxTime, executionTime);
+        // 更新最近时间列表
+        stats.recentTimes.push(executionTime);
+        if (stats.recentTimes.length > this._maxRecentSamples) {
+            stats.recentTimes.shift();
+        }
+        // 计算高级统计信息
+        this.calculateAdvancedStats(stats);
+    }
+    /**
+     * 计算高级统计信息
+     * @param stats 统计信息对象
+     */
+    calculateAdvancedStats(stats) {
+        if (stats.recentTimes.length === 0)
+            return;
+        // 计算标准差
+        const mean = stats.recentTimes.reduce((a, b) => a + b, 0) / stats.recentTimes.length;
+        const variance = stats.recentTimes.reduce((acc, time) => acc + Math.pow(time - mean, 2), 0) / stats.recentTimes.length;
+        stats.standardDeviation = Math.sqrt(variance);
+        // 计算百分位数
+        const sortedTimes = [...stats.recentTimes].sort((a, b) => a - b);
+        const len = sortedTimes.length;
+        stats.percentile95 = sortedTimes[Math.floor(len * 0.95)] || 0;
+        stats.percentile99 = sortedTimes[Math.floor(len * 0.99)] || 0;
+    }
+    /**
+     * 获取系统的当前性能数据
+     * @param systemName 系统名称
+     * @returns 性能数据或undefined
+     */
+    getSystemData(systemName) {
+        return this._systemData.get(systemName);
+    }
+    /**
+     * 获取系统的统计信息
+     * @param systemName 系统名称
+     * @returns 统计信息或undefined
+     */
+    getSystemStats(systemName) {
+        return this._systemStats.get(systemName);
+    }
+    /**
+     * 获取所有系统的性能数据
+     * @returns 所有系统的性能数据
+     */
+    getAllSystemData() {
+        return new Map(this._systemData);
+    }
+    /**
+     * 获取所有系统的统计信息
+     * @returns 所有系统的统计信息
+     */
+    getAllSystemStats() {
+        return new Map(this._systemStats);
+    }
+    /**
+     * 获取性能报告
+     * @returns 格式化的性能报告字符串
+     */
+    getPerformanceReport() {
+        if (!this._isEnabled) {
+            return 'Performance monitoring is disabled.';
+        }
+        const lines = [];
+        lines.push('=== ECS Performance Report ===');
+        lines.push('');
+        // 按平均执行时间排序
+        const sortedSystems = Array.from(this._systemStats.entries())
+            .sort((a, b) => b[1].averageTime - a[1].averageTime);
+        for (const [systemName, stats] of sortedSystems) {
+            const data = this._systemData.get(systemName);
+            lines.push(`System: ${systemName}`);
+            lines.push(`  Current: ${data?.executionTime.toFixed(2)}ms (${data?.entityCount} entities)`);
+            lines.push(`  Average: ${stats.averageTime.toFixed(2)}ms`);
+            lines.push(`  Min/Max: ${stats.minTime.toFixed(2)}ms / ${stats.maxTime.toFixed(2)}ms`);
+            lines.push(`  Total: ${stats.totalTime.toFixed(2)}ms (${stats.executionCount} calls)`);
+            if (data?.averageTimePerEntity && data.averageTimePerEntity > 0) {
+                lines.push(`  Per Entity: ${data.averageTimePerEntity.toFixed(4)}ms`);
+            }
+            lines.push('');
+        }
+        // 总体统计
+        const totalCurrentTime = Array.from(this._systemData.values())
+            .reduce((sum, data) => sum + data.executionTime, 0);
+        lines.push(`Total Frame Time: ${totalCurrentTime.toFixed(2)}ms`);
+        lines.push(`Systems Count: ${this._systemData.size}`);
+        return lines.join('\n');
+    }
+    /**
+     * 重置所有性能数据
+     */
+    reset() {
+        this._systemData.clear();
+        this._systemStats.clear();
+    }
+    /**
+     * 重置指定系统的性能数据
+     * @param systemName 系统名称
+     */
+    resetSystem(systemName) {
+        this._systemData.delete(systemName);
+        this._systemStats.delete(systemName);
+    }
+    /**
+     * 获取性能警告
+     * @param thresholdMs 警告阈值（毫秒）
+     * @returns 超过阈值的系统列表
+     */
+    getPerformanceWarnings(thresholdMs = 16.67) {
+        const warnings = [];
+        for (const [systemName, data] of this._systemData.entries()) {
+            if (data.executionTime > thresholdMs) {
+                warnings.push(`${systemName}: ${data.executionTime.toFixed(2)}ms (>${thresholdMs}ms)`);
+            }
+        }
+        return warnings;
+    }
+    /**
+     * 设置最大保留样本数
+     * @param maxSamples 最大样本数
+     */
+    setMaxRecentSamples(maxSamples) {
+        this._maxRecentSamples = maxSamples;
+        // 裁剪现有数据
+        for (const stats of this._systemStats.values()) {
+            while (stats.recentTimes.length > maxSamples) {
+                stats.recentTimes.shift();
+            }
+        }
+    }
+    /**
+     * 释放资源
+     */
+    dispose() {
+        this._systemData.clear();
+        this._systemStats.clear();
+        this._isEnabled = false;
+    }
+}
+//# sourceMappingURL=PerformanceMonitor.js.map

package/bin/Utils/PerformanceMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceMonitor.js","sourceRoot":"","sources":["../../src/Utils/PerformanceMonitor.ts"],"names":[],"mappings":"AA4CA;;GAEG;AACH,MAAM,CAAN,IAAY,sBAOX;AAPD,WAAY,sBAAsB;IAC9B,qEAA2C,CAAA;IAC3C,iEAAuC,CAAA;IACvC,2DAAiC,CAAA;IACjC,qDAA2B,CAAA;IAC3B,6CAAmB,CAAA;IACnB,iEAAuC,CAAA;AAC3C,CAAC,EAPW,sBAAsB,KAAtB,sBAAsB,QAOjC;AAiDD;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAM3B;QALQ,gBAAW,GAAG,IAAI,GAAG,EAA2B,CAAC;QACjD,iBAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;QACnD,eAAU,GAAG,KAAK,CAAC;QACnB,sBAAiB,GAAG,EAAE,CAAC,CAAC,aAAa;IAE9B,CAAC;IAEhB;;OAEG;IACI,MAAM;QACT,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,OAAO;QACV,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,eAAe,CAAC,WAAmB;QACtC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACb,CAAC;QACD,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,UAAkB,EAAE,SAAiB,EAAE,cAAsB,CAAC;QAC/E,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO;QACX,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;QAC1C,MAAM,oBAAoB,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/E,WAAW;QACX,MAAM,IAAI,GAAoB;YAC1B,IAAI,EAAE,UAAU;YAChB,aAAa;YACb,WAAW;YACX,oBAAoB;YACpB,cAAc,EAAE,OAAO;SAC1B,CAAC;QAEF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAEvC,SAAS;QACT,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACK,WAAW,CAAC,UAAkB,EAAE,aAAqB;QACzD,IAAI,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,KAAK,GAAG;gBACJ,SAAS,EAAE,CAAC;gBACZ,WAAW,EAAE,CAAC;gBACd,OAAO,EAAE,MAAM,CAAC,SAAS;gBACzB,OAAO,EAAE,CAAC;gBACV,cAAc,EAAE,CAAC;gBACjB,WAAW,EAAE,EAAE;gBACf,iBAAiB,EAAE,CAAC;gBACpB,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;aAClB,CAAC;YACF,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QAED,SAAS;QACT,KAAK,CAAC,SAAS,IAAI,aAAa,CAAC;QACjC,KAAK,CAAC,cAAc,EAAE,CAAC;QACvB,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC;QAC3D,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACvD,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAEvD,WAAW;QACX,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpD,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,WAAW;QACX,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACK,sBAAsB,CAAC,KAAuB;QAClD,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE3C,QAAQ;QACR,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC;QACrF,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC;QACvH,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE9C,SAAS;QACT,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC;QAE/B,KAAK,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9D,KAAK,CAAC,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACI,aAAa,CAAC,UAAkB;QACnC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACI,cAAc,CAAC,UAAkB;QACpC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACI,gBAAgB;QACnB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACI,iBAAiB;QACpB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACI,oBAAoB;QACvB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACnB,OAAO,qCAAqC,CAAC;QACjD,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,YAAY;QACZ,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;aACxD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAEzD,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAE9C,KAAK,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,WAAW,YAAY,CAAC,CAAC;YAC7F,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACvF,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,cAAc,SAAS,CAAC,CAAC;YAEvF,IAAI,IAAI,EAAE,oBAAoB,IAAI,IAAI,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC1E,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QAED,OAAO;QACP,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;aACzD,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAExD,KAAK,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAEtD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACI,WAAW,CAAC,UAAkB;QACjC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACpC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACI,sBAAsB,CAAC,cAAsB,KAAK;QACrD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,IAAI,IAAI,CAAC,aAAa,GAAG,WAAW,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,CAAC,GAAG,UAAU,KAAK,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,WAAW,KAAK,CAAC,CAAC;YAC3F,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;OAGG;IACI,mBAAmB,CAAC,UAAkB;QACzC,IAAI,CAAC,iBAAiB,GAAG,UAAU,CAAC;QAEpC,SAAS;QACT,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC3C,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YAC9B,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACI,OAAO;QACV,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC5B,CAAC;CACJ"}

package/bin/Utils/Pool/IPoolable.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 可池化对象接口
+ */
+export interface IPoolable {
+    /**
+     * 重置对象状态，准备重用
+     */
+    reset(): void;
+}
+/**
+ * 对象池统计信息
+ */
+export interface PoolStats {
+    /** 池中对象数量 */
+    size: number;
+    /** 池的最大大小 */
+    maxSize: number;
+    /** 总共创建的对象数量 */
+    totalCreated: number;
+    /** 总共获取的次数 */
+    totalObtained: number;
+    /** 总共释放的次数 */
+    totalReleased: number;
+    /** 命中率（从池中获取的比例） */
+    hitRate: number;
+    /** 内存使用估算（字节） */
+    estimatedMemoryUsage: number;
+}
+//# sourceMappingURL=IPoolable.d.ts.map

package/bin/Utils/Pool/IPoolable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPoolable.d.ts","sourceRoot":"","sources":["../../../src/Utils/Pool/IPoolable.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,oBAAoB,EAAE,MAAM,CAAC;CAChC"}

package/bin/Utils/Pool/IPoolable.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IPoolable.js.map

package/bin/Utils/Pool/IPoolable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPoolable.js","sourceRoot":"","sources":["../../../src/Utils/Pool/IPoolable.ts"],"names":[],"mappings":""}

package/bin/Utils/Pool/Pool.d.ts

@@ -0,0 +1,109 @@
+import { IPoolable, PoolStats } from './IPoolable';
+/**
+ * 高性能通用对象池
+ * 支持任意类型的对象池化，包含详细的统计信息
+ */
+export declare class Pool<T extends IPoolable> {
+    private static _pools;
+    private _objects;
+    private _createFn;
+    private _maxSize;
+    private _stats;
+    private _objectSize;
+    /**
+     * 构造函数
+     * @param createFn 创建对象的函数
+     * @param maxSize 池的最大大小，默认100
+     * @param estimatedObjectSize 估算的单个对象大小（字节），默认1024
+     */
+    constructor(createFn: () => T, maxSize?: number, estimatedObjectSize?: number);
+    /**
+     * 获取指定类型的对象池
+     * @param type 对象类型
+     * @param maxSize 池的最大大小
+     * @param estimatedObjectSize 估算的单个对象大小
+     * @returns 对象池实例
+     */
+    static getPool<T extends IPoolable>(type: new (...args: unknown[]) => T, maxSize?: number, estimatedObjectSize?: number): Pool<T>;
+    /**
+     * 从池中获取对象
+     * @returns 对象实例
+     */
+    obtain(): T;
+    /**
+     * 释放对象回池中
+     * @param obj 要释放的对象
+     */
+    release(obj: T): void;
+    /**
+     * 获取池统计信息
+     * @returns 统计信息对象
+     */
+    getStats(): Readonly<PoolStats>;
+    /**
+     * 清空池
+     */
+    clear(): void;
+    /**
+     * 压缩池（移除多余的对象）
+     * @param targetSize 目标大小，默认为当前大小的一半
+     */
+    compact(targetSize?: number): void;
+    /**
+     * 预填充池
+     * @param count 预填充的对象数量
+     */
+    prewarm(count: number): void;
+    /**
+     * 设置最大池大小
+     * @param maxSize 新的最大大小
+     */
+    setMaxSize(maxSize: number): void;
+    /**
+     * 获取池中可用对象数量
+     * @returns 可用对象数量
+     */
+    getAvailableCount(): number;
+    /**
+     * 检查池是否为空
+     * @returns 如果池为空返回true
+     */
+    isEmpty(): boolean;
+    /**
+     * 检查池是否已满
+     * @returns 如果池已满返回true
+     */
+    isFull(): boolean;
+    /**
+     * 获取所有已注册的池类型
+     * @returns 所有池类型的数组
+     */
+    static getAllPoolTypes(): Function[];
+    /**
+     * 获取所有池的统计信息
+     * @returns 包含所有池统计信息的对象
+     */
+    static getAllPoolStats(): Record<string, PoolStats>;
+    /**
+     * 压缩所有池
+     */
+    static compactAllPools(): void;
+    /**
+     * 清空所有池
+     */
+    static clearAllPools(): void;
+    /**
+     * 获取全局池统计信息的格式化字符串
+     * @returns 格式化的统计信息字符串
+     */
+    static getGlobalStatsString(): string;
+    /**
+     * 更新命中率
+     */
+    private _updateHitRate;
+    /**
+     * 更新内存使用估算
+     */
+    private _updateMemoryUsage;
+}
+//# sourceMappingURL=Pool.d.ts.map

package/bin/Utils/Pool/Pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pool.d.ts","sourceRoot":"","sources":["../../../src/Utils/Pool/Pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnD;;;GAGG;AACH,qBAAa,IAAI,CAAC,CAAC,SAAS,SAAS;IACjC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAkC;IAEvD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;OAKG;gBACS,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,MAAY,EAAE,mBAAmB,GAAE,MAAa;IAexF;;;;;;OAMG;WACW,OAAO,CAAC,CAAC,SAAS,SAAS,EACrC,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EACnC,OAAO,GAAE,MAAY,EACrB,mBAAmB,GAAE,MAAa,GACnC,IAAI,CAAC,CAAC,CAAC;IAWV;;;OAGG;IACI,MAAM,IAAI,CAAC;IAiBlB;;;OAGG;IACI,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAgB5B;;;OAGG;IACI,QAAQ,IAAI,QAAQ,CAAC,SAAS,CAAC;IAItC;;OAEG;IACI,KAAK,IAAI,IAAI;IAWpB;;;OAGG;IACI,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAczC;;;OAGG;IACI,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAcnC;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUxC;;;OAGG;IACI,iBAAiB,IAAI,MAAM;IAIlC;;;OAGG;IACI,OAAO,IAAI,OAAO;IAIzB;;;OAGG;IACI,MAAM,IAAI,OAAO;IAIxB;;;OAGG;WACW,eAAe,IAAI,QAAQ,EAAE;IAI3C;;;OAGG;WACW,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IAW1D;;OAEG;WACW,eAAe,IAAI,IAAI;IAMrC;;OAEG;WACW,aAAa,IAAI,IAAI;IAOnC;;;OAGG;WACW,oBAAoB,IAAI,MAAM;IAsB5C;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAG7B"}