@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/Utils/Debug/ComponentDataCollector.js

@@ -0,0 +1,250 @@
+import { ComponentPoolManager } from '../../ECS/Core/ComponentPool';
+import { getComponentInstanceTypeName } from '../../ECS/Decorators';
+/**
+ * 组件数据收集器
+ */
+export class ComponentDataCollector {
+    /**
+     * 收集组件数据（轻量版，不计算实际内存大小）
+     * @param scene 场景实例
+     */
+    collectComponentData(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 = getComponentInstanceTypeName(component);
+                    const stats = componentStats.get(typeName) || { count: 0, entities: 0 };
+                    stats.count++;
+                    totalInstances++;
+                    componentStats.set(typeName, stats);
+                });
+            }
+        });
+        // 获取池利用率信息
+        const poolUtilizations = new Map();
+        const poolSizes = new Map();
+        try {
+            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, scene);
+                return {
+                    typeName,
+                    instanceCount: stats.count,
+                    memoryPerInstance: memoryPerInstance,
+                    totalMemory: stats.count * memoryPerInstance,
+                    poolSize: poolSize,
+                    poolUtilization: poolUtilization,
+                    averagePerEntity: stats.count / entityList.buffer.length
+                };
+            })
+        };
+    }
+    /**
+     * 获取组件类型的估算内存大小（基于预设值，不进行实际计算）
+     */
+    getEstimatedComponentSize(typeName, scene) {
+        if (ComponentDataCollector.componentSizeCache.has(typeName)) {
+            return ComponentDataCollector.componentSizeCache.get(typeName);
+        }
+        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) => getComponentInstanceTypeName(c) === 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 || 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);
+    }
+    /**
+     * 为内存快照功能提供的详细内存计算
+     * 只在用户主动请求内存快照时调用
+     * @param typeName 组件类型名称
+     * @param scene 场景实例
+     */
+    calculateDetailedComponentMemory(typeName, scene) {
+        if (!scene)
+            return this.getEstimatedComponentSize(typeName, scene);
+        const entityList = scene.entities;
+        if (!entityList?.buffer)
+            return this.getEstimatedComponentSize(typeName, scene);
+        try {
+            // 找到第一个包含此组件的实体，分析组件大小
+            for (const entity of entityList.buffer) {
+                if (entity.components) {
+                    const component = entity.components.find((c) => getComponentInstanceTypeName(c) === typeName);
+                    if (component) {
+                        return this.estimateObjectSize(component);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // 忽略错误，使用估算值
+        }
+        return this.getEstimatedComponentSize(typeName, scene);
+    }
+    /**
+     * 估算对象内存大小（仅用于内存快照）
+     * 优化版本：减少递归深度，提高性能
+     */
+    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)
+                                continue;
+                            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/DebugConfigService.d.ts

@@ -0,0 +1,16 @@
+import { IECSDebugConfig } from '../../Types';
+import type { IService } from '../../Core/ServiceContainer';
+/**
+ * 调试配置服务
+ *
+ * 管理调试系统的配置信息
+ */
+export declare class DebugConfigService implements IService {
+    private _config;
+    constructor();
+    setConfig(config: IECSDebugConfig): void;
+    getConfig(): IECSDebugConfig;
+    isEnabled(): boolean;
+    dispose(): void;
+}
+//# sourceMappingURL=DebugConfigService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DebugConfigService.d.ts","sourceRoot":"","sources":["../../../src/Utils/Debug/DebugConfigService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;;;GAIG;AACH,qBACa,kBAAmB,YAAW,QAAQ;IAC/C,OAAO,CAAC,OAAO,CAAkB;;IAkB1B,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAIxC,SAAS,IAAI,eAAe;IAI5B,SAAS,IAAI,OAAO;IAI3B,OAAO,IAAI,IAAI;CAGlB"}

package/bin/Utils/Debug/DebugConfigService.js

@@ -0,0 +1,42 @@
+import { __decorate, __metadata } from "tslib";
+import { Injectable } from '../../Core/DI/Decorators';
+/**
+ * 调试配置服务
+ *
+ * 管理调试系统的配置信息
+ */
+let DebugConfigService = class DebugConfigService {
+    constructor() {
+        this._config = {
+            enabled: false,
+            websocketUrl: '',
+            debugFrameRate: 30,
+            autoReconnect: true,
+            channels: {
+                entities: true,
+                systems: true,
+                performance: true,
+                components: true,
+                scenes: true
+            }
+        };
+    }
+    setConfig(config) {
+        this._config = config;
+    }
+    getConfig() {
+        return this._config;
+    }
+    isEnabled() {
+        return this._config.enabled;
+    }
+    dispose() {
+        // 清理资源
+    }
+};
+DebugConfigService = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [])
+], DebugConfigService);
+export { DebugConfigService };
+//# sourceMappingURL=DebugConfigService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DebugConfigService.js","sourceRoot":"","sources":["../../../src/Utils/Debug/DebugConfigService.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD;;;;GAIG;AAEI,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;IAG3B;QACI,IAAI,CAAC,OAAO,GAAG;YACX,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,EAAE;YAClB,aAAa,EAAE,IAAI;YACnB,QAAQ,EAAE;gBACN,QAAQ,EAAE,IAAI;gBACd,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,IAAI;gBACjB,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,IAAI;aACf;SACJ,CAAC;IACN,CAAC;IAEM,SAAS,CAAC,MAAuB;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAEM,SAAS;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAEM,SAAS;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,OAAO;QACH,OAAO;IACX,CAAC;CACJ,CAAA;AAlCY,kBAAkB;IAD9B,UAAU,EAAE;;GACA,kBAAkB,CAkC9B"}

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

@@ -0,0 +1,131 @@
+import { IECSDebugConfig, IECSDebugData } from '../../Types';
+import type { IService } from '../../Core/ServiceContainer';
+import type { IUpdatable } from '../../Types/IUpdatable';
+/**
+ * 调试管理器
+ *
+ * 整合所有调试数据收集器，负责收集和发送调试数据
+ */
+export declare class DebugManager implements IService, IUpdatable {
+    private config;
+    private webSocketManager;
+    private entityCollector;
+    private systemCollector;
+    private performanceCollector;
+    private componentCollector;
+    private sceneCollector;
+    private advancedProfilerCollector;
+    private sceneManager;
+    private performanceMonitor;
+    private configService;
+    private frameCounter;
+    private lastSendTime;
+    private sendInterval;
+    private isRunning;
+    private originalConsole;
+    onInitialize(): void;
+    /**
+     * 启动调试管理器
+     */
+    start(): void;
+    /**
+     * 停止调试管理器
+     */
+    stop(): void;
+    /**
+     * 拦截 console 日志并转发到编辑器
+     */
+    private interceptConsole;
+    /**
+     * 格式化日志消息
+     */
+    private formatLogMessage;
+    /**
+     * 安全的 JSON 序列化,支持循环引用和深度限制
+     */
+    private safeStringify;
+    /**
+     * 发送日志到编辑器
+     */
+    private sendLog;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: IECSDebugConfig): void;
+    update(_deltaTime?: number): void;
+    /**
+     * 场景变更回调
+     */
+    onSceneChanged(): void;
+    /**
+     * 处理来自调试面板的消息
+     */
+    private handleMessage;
+    /**
+     * 处理展开懒加载对象请求
+     */
+    private handleExpandLazyObjectRequest;
+    /**
+     * 处理获取组件属性请求
+     */
+    private handleGetComponentPropertiesRequest;
+    /**
+     * 处理获取原始实体列表请求
+     */
+    private handleGetRawEntityListRequest;
+    /**
+     * 处理获取实体详情请求
+     */
+    private handleGetEntityDetailsRequest;
+    /**
+     * 处理获取高级性能分析数据请求
+     */
+    private handleGetAdvancedProfilerDataRequest;
+    /**
+     * 处理设置性能分析器选中函数请求
+     */
+    private handleSetProfilerSelectedFunction;
+    /**
+     * 处理内存快照请求
+     */
+    private handleMemorySnapshotRequest;
+    /**
+     * 捕获内存快照
+     */
+    private captureMemorySnapshot;
+    /**
+     * 收集基础内存信息
+     */
+    private collectBaseMemoryInfo;
+    /**
+     * 收集组件内存统计（仅用于内存快照）
+     */
+    private collectComponentMemoryStats;
+    private collectSystemMemoryStats;
+    private calculateQuickSystemSize;
+    /**
+     * 收集对象池内存统计
+     */
+    private collectPoolMemoryStats;
+    /**
+     * 收集性能统计信息
+     */
+    private collectPerformanceStats;
+    /**
+     * 获取调试数据
+     */
+    getDebugData(): IECSDebugData;
+    /**
+     * 连接WebSocket
+     */
+    private connectWebSocket;
+    /**
+     * 发送调试数据
+     */
+    private sendDebugData;
+    /**
+     * 释放资源
+     */
+    dispose(): void;
+}
+//# 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;AAY7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAOzD;;;;GAIG;AACH,qBAEa,YAAa,YAAW,QAAQ,EAAE,UAAU;IACrD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,oBAAoB,CAA4B;IACxD,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,yBAAyB,CAA6B;IAG9D,OAAO,CAAC,YAAY,CAAgB;IAGpC,OAAO,CAAC,kBAAkB,CAAsB;IAGhD,OAAO,CAAC,aAAa,CAAsB;IAE3C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAMrB;IAEK,YAAY,IAAI,IAAI;IAiC3B;;OAEG;IACI,KAAK,IAAI,IAAI;IAOpB;;OAEG;IACI,IAAI,IAAI,IAAI;IAOnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqCrB;;OAEG;IACH,OAAO,CAAC,OAAO;IAmBf;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAmB3C,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAYxC;;OAEG;IACI,cAAc,IAAI,IAAI;IAO7B;;OAEG;IACH,OAAO,CAAC,aAAa;IA4DrB;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA8BrC;;OAEG;IACH,OAAO,CAAC,mCAAmC;IA8B3C;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAqBrC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA+BrC;;OAEG;IACH,OAAO,CAAC,oCAAoC;IAuB5C;;OAEG;IACH,OAAO,CAAC,iCAAiC;IAsBzC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAenC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6C7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmE7B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAoFnC,OAAO,CAAC,wBAAwB;IAwDhC,OAAO,CAAC,wBAAwB;IAiChC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4E9B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwC/B;;OAEG;IACI,YAAY,IAAI,aAAa;IAoCpC;;OAEG;YACW,gBAAgB;IAS9B;;OAEG;IACH,OAAO,CAAC,aAAa;IA2BrB;;OAEG;IACI,OAAO,IAAI,IAAI;CAUzB"}