@esengine/ecs-framework 2.1.29 → 2.1.30

package/bin/Utils/Debug/ComponentDataCollector.js

@@ -0,0 +1,248 @@
+import { Core } from '../../Core';
+/**
+ * 组件数据收集器
+ */
+export class ComponentDataCollector {
+    /**
+     * 收集组件数据（轻量版，不计算实际内存大小）
+     */
+    collectComponentData() {
+        const scene = Core.scene;
+        if (!scene) {
+            return {
+                componentTypes: 0,
+                componentInstances: 0,
+                componentStats: []
+            };
+        }
+        const entityList = scene.entities;
+        if (!entityList?.buffer) {
+            return {
+                componentTypes: 0,
+                componentInstances: 0,
+                componentStats: []
+            };
+        }
+        const componentStats = new Map();
+        let totalInstances = 0;
+        entityList.buffer.forEach((entity) => {
+            if (entity.components) {
+                entity.components.forEach((component) => {
+                    const typeName = component.constructor.name;
+                    const stats = componentStats.get(typeName) || { count: 0, entities: 0 };
+                    stats.count++;
+                    totalInstances++;
+                    componentStats.set(typeName, stats);
+                });
+            }
+        });
+        // 获取池利用率信息
+        let poolUtilizations = new Map();
+        let poolSizes = new Map();
+        try {
+            const { ComponentPoolManager } = require('../../ECS/Core/ComponentPool');
+            const poolManager = ComponentPoolManager.getInstance();
+            const poolStats = poolManager.getPoolStats();
+            const utilizations = poolManager.getPoolUtilization();
+            for (const [typeName, stats] of poolStats.entries()) {
+                poolSizes.set(typeName, stats.maxSize);
+            }
+            for (const [typeName, util] of utilizations.entries()) {
+                poolUtilizations.set(typeName, util.utilization);
+            }
+        }
+        catch (error) {
+            // 如果无法获取池信息，使用默认值
+        }
+        return {
+            componentTypes: componentStats.size,
+            componentInstances: totalInstances,
+            componentStats: Array.from(componentStats.entries()).map(([typeName, stats]) => {
+                const poolSize = poolSizes.get(typeName) || 0;
+                const poolUtilization = poolUtilizations.get(typeName) || 0;
+                // 使用预估的基础内存大小，避免每帧计算
+                const memoryPerInstance = this.getEstimatedComponentSize(typeName);
+                return {
+                    typeName,
+                    instanceCount: stats.count,
+                    memoryPerInstance: memoryPerInstance,
+                    totalMemory: stats.count * memoryPerInstance,
+                    poolSize: poolSize,
+                    poolUtilization: poolUtilization,
+                    averagePerEntity: stats.count / entityList.buffer.length
+                };
+            })
+        };
+    }
+    /**
+     * 获取组件类型的估算内存大小（基于预设值，不进行实际计算）
+     */
+    getEstimatedComponentSize(typeName) {
+        if (ComponentDataCollector.componentSizeCache.has(typeName)) {
+            return ComponentDataCollector.componentSizeCache.get(typeName);
+        }
+        const scene = Core.scene;
+        if (!scene)
+            return 64;
+        const entityList = scene.entities;
+        if (!entityList?.buffer)
+            return 64;
+        let calculatedSize = 64;
+        try {
+            for (const entity of entityList.buffer) {
+                if (entity.components) {
+                    const component = entity.components.find((c) => c.constructor.name === typeName);
+                    if (component) {
+                        calculatedSize = this.calculateQuickObjectSize(component);
+                        break;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            calculatedSize = 64;
+        }
+        ComponentDataCollector.componentSizeCache.set(typeName, calculatedSize);
+        return calculatedSize;
+    }
+    calculateQuickObjectSize(obj) {
+        if (!obj || typeof obj !== 'object')
+            return 8;
+        let size = 32;
+        const visited = new WeakSet();
+        const calculate = (item, depth = 0) => {
+            if (!item || typeof item !== 'object' || visited.has(item) || depth > 3) {
+                return 0;
+            }
+            visited.add(item);
+            let itemSize = 0;
+            try {
+                const keys = Object.keys(item);
+                for (let i = 0; i < Math.min(keys.length, 20); i++) {
+                    const key = keys[i];
+                    if (key === 'entity' || key === '_entity' || key === 'constructor')
+                        continue;
+                    const value = item[key];
+                    itemSize += key.length * 2;
+                    if (typeof value === 'string') {
+                        itemSize += Math.min(value.length * 2, 200);
+                    }
+                    else if (typeof value === 'number') {
+                        itemSize += 8;
+                    }
+                    else if (typeof value === 'boolean') {
+                        itemSize += 4;
+                    }
+                    else if (typeof value === 'object' && value !== null) {
+                        itemSize += calculate(value, depth + 1);
+                    }
+                }
+            }
+            catch (error) {
+                return 32;
+            }
+            return itemSize;
+        };
+        size += calculate(obj);
+        return Math.max(size, 32);
+    }
+    /**
+     * 为内存快照功能提供的详细内存计算
+     * 只在用户主动请求内存快照时调用
+     */
+    calculateDetailedComponentMemory(typeName) {
+        const scene = Core.scene;
+        if (!scene)
+            return this.getEstimatedComponentSize(typeName);
+        const entityList = scene.entities;
+        if (!entityList?.buffer)
+            return this.getEstimatedComponentSize(typeName);
+        try {
+            // 找到第一个包含此组件的实体，分析组件大小
+            for (const entity of entityList.buffer) {
+                if (entity.components) {
+                    const component = entity.components.find((c) => c.constructor.name === typeName);
+                    if (component) {
+                        return this.estimateObjectSize(component);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // 忽略错误，使用估算值
+        }
+        return this.getEstimatedComponentSize(typeName);
+    }
+    /**
+     * 估算对象内存大小（仅用于内存快照）
+     * 优化版本：减少递归深度，提高性能
+     */
+    estimateObjectSize(obj, visited = new WeakSet(), depth = 0) {
+        if (obj === null || obj === undefined || depth > 10)
+            return 0;
+        if (visited.has(obj))
+            return 0;
+        let size = 0;
+        const type = typeof obj;
+        switch (type) {
+            case 'boolean':
+                size = 4;
+                break;
+            case 'number':
+                size = 8;
+                break;
+            case 'string':
+                size = 24 + Math.min(obj.length * 2, 1000);
+                break;
+            case 'object':
+                visited.add(obj);
+                if (Array.isArray(obj)) {
+                    size = 40 + (obj.length * 8);
+                    const maxElements = Math.min(obj.length, 50);
+                    for (let i = 0; i < maxElements; i++) {
+                        size += this.estimateObjectSize(obj[i], visited, depth + 1);
+                    }
+                }
+                else {
+                    size = 32;
+                    try {
+                        const ownKeys = Object.getOwnPropertyNames(obj);
+                        const maxProps = Math.min(ownKeys.length, 30);
+                        for (let i = 0; i < maxProps; i++) {
+                            const key = ownKeys[i];
+                            if (key === 'constructor' ||
+                                key === '__proto__' ||
+                                key === 'entity' ||
+                                key === '_entity' ||
+                                key.startsWith('_cc_') ||
+                                key.startsWith('__')) {
+                                continue;
+                            }
+                            try {
+                                size += 16 + (key.length * 2);
+                                const value = obj[key];
+                                if (value !== undefined && value !== null) {
+                                    size += this.estimateObjectSize(value, visited, depth + 1);
+                                }
+                            }
+                            catch (error) {
+                                continue;
+                            }
+                        }
+                    }
+                    catch (error) {
+                        size = 128;
+                    }
+                }
+                break;
+            default:
+                size = 8;
+        }
+        return Math.ceil(size / 8) * 8;
+    }
+    static clearCache() {
+        ComponentDataCollector.componentSizeCache.clear();
+    }
+}
+ComponentDataCollector.componentSizeCache = new Map();
+//# sourceMappingURL=ComponentDataCollector.js.map

package/bin/Utils/Debug/ComponentDataCollector.js.map

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

package/bin/Utils/Debug/DebugDataFormatter.d.ts

@@ -0,0 +1,22 @@
+import { Component } from '../../ECS/Component';
+/**
+ * 调试数据格式化工具
+ */
+export declare class DebugDataFormatter {
+    /**
+     * 格式化属性值
+     */
+    static formatPropertyValue(value: any, depth?: number): any;
+    /**
+     * 提取组件详细信息
+     */
+    static extractComponentDetails(components: Component[]): Array<{
+        typeName: string;
+        properties: Record<string, any>;
+    }>;
+    /**
+     * 计算对象大小
+     */
+    static calculateObjectSize(obj: any, excludeKeys?: string[]): number;
+}
+//# sourceMappingURL=DebugDataFormatter.d.ts.map

package/bin/Utils/Debug/DebugDataFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugDataFormatter.d.ts","sourceRoot":"","sources":["../../../src/Utils/Debug/DebugDataFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;GAEG;AACH,qBAAa,kBAAkB;IAC3B;;OAEG;WACW,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,GAAE,MAAU,GAAG,GAAG;IAwCrE;;OAEG;WACW,uBAAuB,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;QAClE,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACnC,CAAC;IA2BF;;OAEG;WACW,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,MAAM;CAsClF"}

package/bin/Utils/Debug/DebugDataFormatter.js

@@ -0,0 +1,117 @@
+/**
+ * 调试数据格式化工具
+ */
+export class DebugDataFormatter {
+    /**
+     * 格式化属性值
+     */
+    static formatPropertyValue(value, depth = 0) {
+        // 防止无限递归，限制最大深度
+        if (depth > 5) {
+            return value?.toString() || 'null';
+        }
+        if (typeof value === 'object' && value !== null) {
+            if (Array.isArray(value)) {
+                // 对于数组，总是返回完整数组，让前端决定如何显示
+                return value.map(item => this.formatPropertyValue(item, depth + 1));
+            }
+            else {
+                // 通用对象处理：提取所有可枚举属性，不限制数量
+                try {
+                    const keys = Object.keys(value);
+                    if (keys.length === 0) {
+                        return {};
+                    }
+                    const result = {};
+                    keys.forEach(key => {
+                        const propValue = value[key];
+                        // 避免循环引用和函数属性
+                        if (propValue !== value && typeof propValue !== 'function') {
+                            try {
+                                result[key] = this.formatPropertyValue(propValue, depth + 1);
+                            }
+                            catch (error) {
+                                // 如果属性访问失败，记录错误信息
+                                result[key] = `[访问失败: ${error instanceof Error ? error.message : String(error)}]`;
+                            }
+                        }
+                    });
+                    return result;
+                }
+                catch (error) {
+                    return `[对象解析失败: ${error instanceof Error ? error.message : String(error)}]`;
+                }
+            }
+        }
+        return value;
+    }
+    /**
+     * 提取组件详细信息
+     */
+    static extractComponentDetails(components) {
+        return components.map((component) => {
+            const componentDetail = {
+                typeName: component.constructor.name,
+                properties: {}
+            };
+            // 安全地提取组件属性
+            try {
+                const propertyKeys = Object.keys(component);
+                propertyKeys.forEach(propertyKey => {
+                    // 跳过私有属性和实体引用，避免循环引用
+                    if (!propertyKey.startsWith('_') && propertyKey !== 'entity') {
+                        const propertyValue = component[propertyKey];
+                        if (propertyValue !== undefined && propertyValue !== null) {
+                            componentDetail.properties[propertyKey] = this.formatPropertyValue(propertyValue);
+                        }
+                    }
+                });
+            }
+            catch (error) {
+                componentDetail.properties['_extractionError'] = '属性提取失败';
+            }
+            return componentDetail;
+        });
+    }
+    /**
+     * 计算对象大小
+     */
+    static calculateObjectSize(obj, excludeKeys = []) {
+        if (!obj || typeof obj !== 'object')
+            return 0;
+        let size = 0;
+        const visited = new WeakSet();
+        const calculate = (item) => {
+            if (!item || typeof item !== 'object' || visited.has(item))
+                return 0;
+            visited.add(item);
+            let itemSize = 0;
+            try {
+                for (const key in item) {
+                    if (excludeKeys.includes(key))
+                        continue;
+                    const value = item[key];
+                    itemSize += key.length * 2; // key size
+                    if (typeof value === 'string') {
+                        itemSize += value.length * 2;
+                    }
+                    else if (typeof value === 'number') {
+                        itemSize += 8;
+                    }
+                    else if (typeof value === 'boolean') {
+                        itemSize += 4;
+                    }
+                    else if (typeof value === 'object' && value !== null) {
+                        itemSize += calculate(value);
+                    }
+                }
+            }
+            catch (error) {
+                // 忽略无法访问的属性
+            }
+            return itemSize;
+        };
+        return calculate(obj);
+    }
+}
+//# sourceMappingURL=DebugDataFormatter.js.map

package/bin/Utils/Debug/DebugDataFormatter.js.map

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

package/bin/Utils/Debug/DebugManager.d.ts

@@ -0,0 +1,104 @@
+import { IECSDebugConfig, IECSDebugData } from '../../Types';
+import { Core } from '../../Core';
+/**
+ * 调试管理器
+ *
+ * 整合所有调试数据收集器，负责收集和发送调试数据
+ */
+export declare class DebugManager {
+    private config;
+    private webSocketManager;
+    private entityCollector;
+    private systemCollector;
+    private performanceCollector;
+    private componentCollector;
+    private sceneCollector;
+    private frameCounter;
+    private lastSendTime;
+    private sendInterval;
+    private isRunning;
+    constructor(core: Core, config: IECSDebugConfig);
+    /**
+     * 启动调试管理器
+     */
+    start(): void;
+    /**
+     * 停止调试管理器
+     */
+    stop(): void;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: IECSDebugConfig): void;
+    /**
+     * 帧更新回调
+     */
+    onFrameUpdate(deltaTime: number): void;
+    /**
+     * 场景变更回调
+     */
+    onSceneChanged(): void;
+    /**
+     * 处理来自调试面板的消息
+     */
+    private handleMessage;
+    /**
+     * 处理展开懒加载对象请求
+     */
+    private handleExpandLazyObjectRequest;
+    /**
+     * 处理获取组件属性请求
+     */
+    private handleGetComponentPropertiesRequest;
+    /**
+     * 处理获取原始实体列表请求
+     */
+    private handleGetRawEntityListRequest;
+    /**
+     * 处理获取实体详情请求
+     */
+    private handleGetEntityDetailsRequest;
+    /**
+     * 处理内存快照请求
+     */
+    private handleMemorySnapshotRequest;
+    /**
+     * 捕获内存快照
+     */
+    private captureMemorySnapshot;
+    /**
+     * 收集基础内存信息
+     */
+    private collectBaseMemoryInfo;
+    /**
+     * 收集组件内存统计（仅用于内存快照）
+     */
+    private collectComponentMemoryStats;
+    private collectSystemMemoryStats;
+    private calculateQuickSystemSize;
+    /**
+     * 收集对象池内存统计
+     */
+    private collectPoolMemoryStats;
+    /**
+     * 收集性能统计信息
+     */
+    private collectPerformanceStats;
+    /**
+     * 获取内存大小分类
+     */
+    private getMemorySizeCategory;
+    /**
+     * 获取调试数据
+     */
+    getDebugData(): IECSDebugData;
+    /**
+     * 连接WebSocket
+     */
+    private connectWebSocket;
+    /**
+     * 发送调试数据
+     */
+    private sendDebugData;
+}
+//# sourceMappingURL=DebugManager.d.ts.map

package/bin/Utils/Debug/DebugManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugManager.d.ts","sourceRoot":"","sources":["../../../src/Utils/Debug/DebugManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO7D,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC;;;;GAIG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,oBAAoB,CAA2B;IACvD,OAAO,CAAC,kBAAkB,CAAyB;IACnD,OAAO,CAAC,cAAc,CAAqB;IAE3C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe;IA0B/C;;OAEG;IACI,KAAK,IAAI,IAAI;IAOpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAOnB;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAmBlD;;OAEG;IACI,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAa7C;;OAEG;IACI,cAAc,IAAI,IAAI;IAO7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAoDrB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA6BrC;;OAEG;IACH,OAAO,CAAC,mCAAmC;IA6B3C;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAoBrC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAiCrC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAenC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4C7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2C7B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAoEnC,OAAO,CAAC,wBAAwB;IA0ChC,OAAO,CAAC,wBAAwB;IAiChC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuD9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6B/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;OAEG;IACI,YAAY,IAAI,aAAa;IAsCpC;;OAEG;YACW,gBAAgB;IAS9B;;OAEG;IACH,OAAO,CAAC,aAAa;CAiBxB"}