@playcraft/build 0.0.13 → 0.0.15

package/dist/base-builder.js

@@ -1,765 +1,58 @@
-import fs from 'fs/promises';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { build as viteBuild } from 'vite';
-import { visualizer } from 'rollup-plugin-visualizer';
-import { viteSourceBuilderPlugin } from './vite/plugin-source-builder.js';
-import { loadPlayCanvasProject } from './loaders/playcanvas-loader.js';
-import { BuildAnalyzer } from './analyzers/build-analyzer.js';
-import { BuildStateManager } from './state/index.js';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
+import { EngineDetector, PlayCanvasAdapter, GenericAdapter } from './engines/index.js';
 /**
- * 基础构建器 - 生成可运行的多文件构建产物
+ * 基础构建器 - 路由到不同引擎适配器
  *
  * 职责：
- * 1. 从源代码或构建产物加载项目
- * 2. 确保所有必需文件存在且格式正确
- * 3. 输出可直接运行的多文件版本
- * 4. 不做任何内联或压缩
+ * 1. 确定引擎类型（从 options 或自动检测）
+ * 2. 路由到对应适配器执行 Base Build
+ *
+ * 适配器：
+ * - PlayCanvasAdapter：处理 PlayCanvas 项目（官方构建产物或源代码）
+ * - GenericAdapter：处理外部引擎（npm install + npm run build）
  */
 export class BaseBuilder {
     constructor(projectDir, options) {
         this.projectDir = projectDir;
         this.options = options;
-        this.stateManager = new BuildStateManager(projectDir, options.outputDir);
         console.log(`[BaseBuilder] 初始化: projectDir=${projectDir}, outputDir=${options.outputDir}`);
     }
     /**
      * 执行基础构建
+     * 根据引擎类型路由到对应适配器
      */
     async build() {
-        // 开始构建阶段
-        this.stateManager.startStage('base-build', {
-            selectedScenes: this.options.selectedScenes,
-            analyze: this.options.analyze,
-            clean: this.options.clean,
-        });
-        // 1. 检测项目类型
-        const projectType = await this.detectProjectType();
-        let result;
-        if (projectType === 'official-build') {
-            // 官方构建产物 - 直接复制并验证
-            result = await this.buildFromOfficial();
+        // 1. 确定引擎类型
+        const engine = await this.resolveEngine();
+        console.log(`[BaseBuilder] 使用引擎: ${engine}`);
+        // 2. 路由到对应适配器
+        if (engine === 'playcanvas') {
+            const adapter = new PlayCanvasAdapter(this.projectDir, this.options);
+            return adapter.baseBuild();
         }
         else {
-            // 源代码格式（PlayCanvas 或 PlayCraft）- 使用 Vite 生成构建产物
-            const formatName = projectType === 'playcraft' ? 'PlayCraft' : 'PlayCanvas';
-            console.log(`[BaseBuilder] 检测到 ${formatName} 源代码格式，使用 Vite 构建...`);
-            result = await this.buildFromSource();
-        }
-        // 保存构建元数据
-        await this.saveBuildMetadata(result.metadata);
-        // 记录构建产物
-        await this.recordBuildOutput(result);
-        // 结束构建阶段
-        this.stateManager.endStage();
-        // 生成分析报告（如果启用）
-        if (this.options.analyze) {
-            // 只在分析模式下保存状态文件（分析报告需要用到）
-            await this.stateManager.saveState();
-            await this.generateAnalysisReport();
-        }
-        return result;
-    }
-    /**
-     * 保存构建元数据到输出目录
-     */
-    async saveBuildMetadata(metadata) {
-        const metadataPath = path.join(this.options.outputDir, '.build-metadata.json');
-        await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');
-        console.log('[BaseBuilder] 构建元数据已保存');
-    }
-    /**
-     * 检测项目类型
-     */
-    async detectProjectType() {
-        // 1. 检查是否是官方构建产物
-        const buildIndicators = [
-            path.join(this.projectDir, 'index.html'),
-            path.join(this.projectDir, 'config.json'),
-        ];
-        try {
-            await fs.access(buildIndicators[0]);
-            await fs.access(buildIndicators[1]);
-            return 'official-build';
-        }
-        catch (error) {
-            // 2. 检查是否是 PlayCraft 项目格式
-            const manifestPath = path.join(this.projectDir, 'manifest.json');
-            try {
-                await fs.access(manifestPath);
-                const manifestContent = await fs.readFile(manifestPath, 'utf-8');
-                const manifest = JSON.parse(manifestContent);
-                if (manifest.format === 'playcraft' || Array.isArray(manifest.assets)) {
-                    return 'playcraft';
-                }
-            }
-            catch (error) {
-                // manifest.json 不存在或格式不对
-            }
-            // 3. 默认视为源代码项目
-            return 'source';
-        }
-    }
-    /**
-     * 从官方构建产物构建
-     */
-    async buildFromOfficial() {
-        // 验证必需文件存在
-        await this.validateOfficialBuild();
-        // 创建输出目录
-        await fs.mkdir(this.options.outputDir, { recursive: true });
-        // 复制所有文件到输出目录
-        const files = await this.copyBuildFiles();
-        // 检测构建模式（官方构建产物可能是 Classic 或 ESM）
-        const metadata = await this.detectBuildModeFromOutput();
-        return {
-            outputDir: this.options.outputDir,
-            metadata,
-            files,
-        };
-    }
-    /**
-     * 从输出目录检测构建模式
-     */
-    async detectBuildModeFromOutput() {
-        const indexPath = path.join(this.options.outputDir, 'index.html');
-        try {
-            const html = await fs.readFile(indexPath, 'utf-8');
-            const hasImportMap = html.includes('<script type="importmap">');
-            if (hasImportMap) {
-                const importMapMatch = html.match(/<script type="importmap">\s*(\{[\s\S]*?\})\s*<\/script>/);
-                const importMapContent = importMapMatch ? JSON.parse(importMapMatch[1]) : { imports: {} };
-                return {
-                    mode: 'esm',
-                    importMap: {
-                        id: 'detected',
-                        imports: importMapContent.imports || {},
-                    },
-                    entryPoint: 'js/index.mjs',
-                };
-            }
-        }
-        catch (error) {
-            // 忽略错误，返回 Classic 模式
-        }
-        return {
-            mode: 'classic',
-        };
-    }
-    /**
-     * 检测是否为 ESM 格式项目
-     */
-    async detectESMFormat() {
-        // ESM 格式的特征：存在 js/index.mjs 或 esm-scripts 目录
-        const esmIndicators = [
-            path.join(this.projectDir, 'js/index.mjs'),
-            path.join(this.projectDir, 'esm-scripts'),
-        ];
-        for (const indicator of esmIndicators) {
-            try {
-                await fs.access(indicator);
-                return true;
-            }
-            catch {
-                // 继续检查下一个
-            }
-        }
-        return false;
-    }
-    /**
-     * 验证官方构建产物
-     */
-    async validateOfficialBuild() {
-        // 检测是否为 ESM 格式
-        const isESM = await this.detectESMFormat();
-        // ESM 格式不需要 __start__.js，Classic 格式需要
-        const requiredFiles = isESM
-            ? ['index.html', 'config.json']
-            : ['index.html', 'config.json', '__start__.js'];
-        const missingFiles = [];
-        for (const file of requiredFiles) {
-            try {
-                await fs.access(path.join(this.projectDir, file));
-            }
-            catch (error) {
-                missingFiles.push(file);
-            }
-        }
-        if (missingFiles.length > 0) {
-            const formatType = isESM ? 'ESM' : 'Classic';
-            throw new Error(`官方构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
-                `检测到 ${formatType} 格式，请确保项目目录包含完整的构建产物。`);
-        }
-    }
-    /**
-     * 复制构建文件到输出目录
-     */
-    async copyBuildFiles() {
-        const files = {
-            html: '',
-            engine: null,
-            config: '',
-            settings: null,
-            modules: null,
-            start: '',
-            scenes: [],
-            assets: [],
-        };
-        // 复制 index.html
-        const htmlPath = path.join(this.projectDir, 'index.html');
-        const outputHtmlPath = path.join(this.options.outputDir, 'index.html');
-        await fs.copyFile(htmlPath, outputHtmlPath);
-        files.html = outputHtmlPath;
-        // 复制 config.json
-        const configPath = path.join(this.projectDir, 'config.json');
-        const outputConfigPath = path.join(this.options.outputDir, 'config.json');
-        await fs.copyFile(configPath, outputConfigPath);
-        files.config = outputConfigPath;
-        // 读取 config.json 以获取场景信息
-        const configContent = await fs.readFile(configPath, 'utf-8');
-        const configJson = JSON.parse(configContent);
-        // 检测是否为 ESM 格式
-        const isESM = await this.detectESMFormat();
-        // 复制 __start__.js（Classic 格式必需，ESM 格式不需要）
-        if (!isESM) {
-            const startPath = path.join(this.projectDir, '__start__.js');
-            const outputStartPath = path.join(this.options.outputDir, '__start__.js');
-            try {
-                await fs.copyFile(startPath, outputStartPath);
-                files.start = outputStartPath;
-            }
-            catch (error) {
-                console.warn('警告: 无法复制 __start__.js');
-            }
-        }
-        // 复制 __settings__.js（如果存在）
-        const settingsPath = path.join(this.projectDir, '__settings__.js');
-        try {
-            await fs.access(settingsPath);
-            const outputSettingsPath = path.join(this.options.outputDir, '__settings__.js');
-            await fs.copyFile(settingsPath, outputSettingsPath);
-            files.settings = outputSettingsPath;
-        }
-        catch (error) {
-            // __settings__.js 不是必需的
-        }
-        // 复制 __modules__.js（如果存在）
-        const modulesPath = path.join(this.projectDir, '__modules__.js');
-        try {
-            await fs.access(modulesPath);
-            const outputModulesPath = path.join(this.options.outputDir, '__modules__.js');
-            await fs.copyFile(modulesPath, outputModulesPath);
-            files.modules = outputModulesPath;
-        }
-        catch (error) {
-            // __modules__.js 不是必需的
-        }
-        // 复制 PlayCanvas Engine（查找可能的文件名）
-        const engineNames = [
-            'playcanvas-stable.min.js',
-            'playcanvas.min.js',
-            '__lib__.js',
-        ];
-        for (const engineName of engineNames) {
-            const enginePath = path.join(this.projectDir, engineName);
-            try {
-                await fs.access(enginePath);
-                const outputEnginePath = path.join(this.options.outputDir, engineName);
-                await fs.copyFile(enginePath, outputEnginePath);
-                files.engine = outputEnginePath;
-                break;
-            }
-            catch (error) {
-                // 继续尝试下一个
-            }
-        }
-        // 复制场景文件
-        if (configJson.scenes && Array.isArray(configJson.scenes)) {
-            for (const scene of configJson.scenes) {
-                if (scene.url && !scene.url.startsWith('data:')) {
-                    const scenePath = path.join(this.projectDir, scene.url);
-                    try {
-                        await fs.access(scenePath);
-                        const sceneDir = path.dirname(scene.url);
-                        if (sceneDir && sceneDir !== '.') {
-                            const outputSceneDir = path.join(this.options.outputDir, sceneDir);
-                            await fs.mkdir(outputSceneDir, { recursive: true });
-                        }
-                        const outputScenePath = path.join(this.options.outputDir, scene.url);
-                        await fs.copyFile(scenePath, outputScenePath);
-                        files.scenes.push(outputScenePath);
-                    }
-                    catch (error) {
-                        console.warn(`警告: 场景文件不存在: ${scene.url}`);
-                    }
-                }
-            }
-        }
-        // 复制资产文件（从 config.json 中的 assets）
-        if (configJson.assets) {
-            const assetsDir = path.join(this.options.outputDir, 'files');
-            await fs.mkdir(assetsDir, { recursive: true });
-            for (const [assetId, assetData] of Object.entries(configJson.assets)) {
-                const asset = assetData;
-                if (asset.file && asset.file.url && !asset.file.url.startsWith('data:')) {
-                    const assetPath = path.join(this.projectDir, asset.file.url);
-                    try {
-                        await fs.access(assetPath);
-                        const assetDir = path.dirname(asset.file.url);
-                        if (assetDir && assetDir !== '.') {
-                            const outputAssetDir = path.join(this.options.outputDir, assetDir);
-                            await fs.mkdir(outputAssetDir, { recursive: true });
-                        }
-                        const outputAssetPath = path.join(this.options.outputDir, asset.file.url);
-                        await fs.copyFile(assetPath, outputAssetPath);
-                        files.assets.push(outputAssetPath);
-                    }
-                    catch (error) {
-                        // 资产文件可能不存在（可能是内联的）
-                    }
-                }
-            }
-        }
-        // 复制 files/ 目录（如果存在）
-        const filesDir = path.join(this.projectDir, 'files');
-        try {
-            const filesDirStat = await fs.stat(filesDir);
-            if (filesDirStat.isDirectory()) {
-                const outputFilesDir = path.join(this.options.outputDir, 'files');
-                await this.copyDirectory(filesDir, outputFilesDir);
-            }
-        }
-        catch (error) {
-            // files/ 目录可能不存在
-        }
-        // 复制 styles.css（如果存在）
-        const stylesPath = path.join(this.projectDir, 'styles.css');
-        try {
-            await fs.access(stylesPath);
-            const outputStylesPath = path.join(this.options.outputDir, 'styles.css');
-            await fs.copyFile(stylesPath, outputStylesPath);
-        }
-        catch (error) {
-            // styles.css 可能不存在
-        }
-        // 复制 manifest.json（如果存在）
-        const manifestPath = path.join(this.projectDir, 'manifest.json');
-        try {
-            await fs.access(manifestPath);
-            const outputManifestPath = path.join(this.options.outputDir, 'manifest.json');
-            await fs.copyFile(manifestPath, outputManifestPath);
-        }
-        catch (error) {
-            // manifest.json 可能不存在
-        }
-        // ESM 格式：复制 js/ 目录（如果存在）
-        const jsDir = path.join(this.projectDir, 'js');
-        try {
-            const jsDirStat = await fs.stat(jsDir);
-            if (jsDirStat.isDirectory()) {
-                const outputJsDir = path.join(this.options.outputDir, 'js');
-                await this.copyDirectory(jsDir, outputJsDir);
-            }
-        }
-        catch (error) {
-            // js/ 目录可能不存在
-        }
-        // ESM 格式：复制 esm-scripts/ 目录（如果存在）
-        const esmScriptsDir = path.join(this.projectDir, 'esm-scripts');
-        try {
-            const esmScriptsDirStat = await fs.stat(esmScriptsDir);
-            if (esmScriptsDirStat.isDirectory()) {
-                const outputEsmScriptsDir = path.join(this.options.outputDir, 'esm-scripts');
-                await this.copyDirectory(esmScriptsDir, outputEsmScriptsDir);
-            }
-        }
-        catch (error) {
-            // esm-scripts/ 目录可能不存在
-        }
-        return files;
-    }
-    /**
-     * 递归复制目录
-     */
-    async copyDirectory(src, dest) {
-        await fs.mkdir(dest, { recursive: true });
-        const entries = await fs.readdir(src, { withFileTypes: true });
-        for (const entry of entries) {
-            const srcPath = path.join(src, entry.name);
-            const destPath = path.join(dest, entry.name);
-            if (entry.isDirectory()) {
-                await this.copyDirectory(srcPath, destPath);
-            }
-            else {
-                await fs.copyFile(srcPath, destPath);
-            }
-        }
-    }
-    /**
-     * 从源代码构建（使用 Vite）
-     */
-    async buildFromSource() {
-        console.log('[BaseBuilder] 使用 Vite 从源代码构建...');
-        console.log('[BaseBuilder] ====== 开始检测构建模式 ======');
-        // 0. 检测构建模式（Import Map）
-        let buildMode = 'classic';
-        let importMap = undefined;
-        try {
-            console.log('[BaseBuilder] 正在加载项目配置...');
-            const projectConfig = await loadPlayCanvasProject(this.projectDir);
-            console.log('[BaseBuilder] 项目配置加载成功');
-            console.log('[BaseBuilder] Import Map:', projectConfig.importMap ? 'YES' : 'NO');
-            buildMode = projectConfig.importMap ? 'esm' : 'classic';
-            importMap = projectConfig.importMap;
-            console.log(`[BaseBuilder] ====== 构建模式: ${buildMode} ======`);
-            if (importMap) {
-                console.log(`[BaseBuilder] Import Map ID: ${importMap.id}`);
-            }
-        }
-        catch (error) {
-            console.error('[BaseBuilder] 加载配置出错:', error.message);
-            console.log('[BaseBuilder] 无法加载 PlayCanvas 项目配置，使用传统模式');
-        }
-        // 1. 创建 Vite 配置
-        // 默认使用覆盖模式（不清空输出目录），只有显式设置 clean: true 时才清空
-        const shouldEmptyOutDir = this.options.clean === true;
-        const viteConfig = buildMode === 'esm' ? {
-            // ESM 模式：不需要打包用户脚本，只需触发插件复制文件
-            root: this.projectDir,
-            base: './',
-            build: {
-                outDir: this.options.outputDir,
-                emptyOutDir: shouldEmptyOutDir,
-                // 如果启用了分析报告，需要 write: true 以便 visualizer 插件能够生成报告
-                write: this.options.analyze ? true : false,
-                rollupOptions: {
-                    input: {
-                        // 使用虚拟入口，仅用于触发插件
-                        'esm-entry': 'virtual:esm-entry',
-                    },
-                },
-            },
-            plugins: [
-                // 虚拟入口插件
-                {
-                    name: 'virtual-esm-entry',
-                    resolveId(id) {
-                        if (id === 'virtual:esm-entry') {
-                            return '\0virtual:esm-entry';
-                        }
-                        return null;
-                    },
-                    load(id) {
-                        if (id === '\0virtual:esm-entry') {
-                            return '// ESM mode - no bundling needed';
-                        }
-                        return null;
-                    },
-                },
-                // 源代码构建插件
-                viteSourceBuilderPlugin({
-                    projectDir: this.projectDir,
-                    outputDir: this.options.outputDir,
-                    selectedScenes: this.options.selectedScenes,
-                    buildMode: buildMode,
-                    importMap: importMap,
-                }),
-                // 打包分析报告（如果启用）
-                ...(this.options.analyze ? [
-                    visualizer({
-                        filename: this.options.analyzeReportPath
-                            ? path.join(this.options.outputDir, this.options.analyzeReportPath)
-                            : path.join(this.options.outputDir, 'base-bundle-report.html'),
-                        template: 'treemap',
-                        gzipSize: true,
-                        brotliSize: true,
-                        open: false,
-                        sourcemap: false,
-                    }),
-                ] : []),
-            ],
-        } : {
-            // 传统模式：打包用户脚本
-            root: this.projectDir,
-            base: './',
-            build: {
-                outDir: this.options.outputDir,
-                emptyOutDir: shouldEmptyOutDir,
-                // 多文件输出（不内联资源）
-                assetsInlineLimit: 0,
-                // Base Build 不压缩（保持可读性和调试性）
-                minify: false,
-                cssMinify: false,
-                sourcemap: false,
-                rollupOptions: {
-                    input: {
-                        // 虚拟模块：用户脚本入口
-                        'game-scripts': 'virtual:game-scripts',
-                    },
-                    output: {
-                        entryFileNames: '__[name].js',
-                        chunkFileNames: '__[name]-[hash].js',
-                        assetFileNames: 'files/assets/[name].[ext]',
-                        format: 'iife', // 使用 IIFE 格式，避免 ES 模块的 import 语句
-                        globals: {
-                            'playcanvas': 'pc',
-                            'pc': 'pc',
-                        },
-                    },
-                    // 外部化 PlayCanvas Engine（不打包）
-                    external: ['pc', 'playcanvas'],
-                    // 仅对用户脚本模块启用 tree-shake（引擎已外部化）
-                    treeshake: true,
-                },
-            },
-            plugins: [
-                // 源代码构建插件
-                viteSourceBuilderPlugin({
-                    projectDir: this.projectDir,
-                    outputDir: this.options.outputDir,
-                    selectedScenes: this.options.selectedScenes,
-                    buildMode: buildMode,
-                    importMap: importMap,
-                }),
-                // 打包分析报告（如果启用）
-                ...(this.options.analyze ? [
-                    visualizer({
-                        filename: this.options.analyzeReportPath
-                            ? path.join(this.options.outputDir, this.options.analyzeReportPath)
-                            : path.join(this.options.outputDir, 'base-bundle-report.html'),
-                        template: 'treemap',
-                        gzipSize: true,
-                        brotliSize: true,
-                        open: false,
-                    }),
-                ] : []),
-            ],
-        };
-        // DEBUG: 检查 analyze 配置
-        if (this.options.analyze) {
-            console.log('[BaseBuilder] analyze 已启用，报告路径:', this.options.analyzeReportPath
-                ? path.join(this.options.outputDir, this.options.analyzeReportPath)
-                : path.join(this.options.outputDir, 'base-bundle-report.html'));
-        }
-        // 2. 执行 Vite 构建
-        await viteBuild(viteConfig);
-        // 3. 扫描生成的文件
-        const files = await this.scanOutputFiles();
-        // 4. 构建元数据
-        const metadata = {
-            mode: buildMode,
-            importMap: importMap ? {
-                id: importMap.id,
-                imports: importMap.content.imports,
-            } : undefined,
-            entryPoint: buildMode === 'esm' ? 'js/index.mjs' : undefined,
-        };
-        // 5. 返回构建结果
-        return {
-            outputDir: this.options.outputDir,
-            metadata,
-            files,
-        };
-    }
-    /**
-     * 扫描输出文件
-     */
-    async scanOutputFiles() {
-        const files = {
-            html: path.join(this.options.outputDir, 'index.html'),
-            engine: null,
-            config: path.join(this.options.outputDir, 'config.json'),
-            settings: path.join(this.options.outputDir, '__settings__.js'),
-            modules: null,
-            start: path.join(this.options.outputDir, '__start__.js'),
-            scenes: [],
-            assets: [],
-        };
-        // 检查 engine
-        const enginePath = path.join(this.options.outputDir, 'playcanvas-stable.min.js');
-        try {
-            await fs.access(enginePath);
-            files.engine = enginePath;
-        }
-        catch (error) {
-            // engine 可能不存在
-        }
-        // 检查 modules
-        const modulesPath = path.join(this.options.outputDir, '__modules__.js');
-        try {
-            await fs.access(modulesPath);
-            files.modules = modulesPath;
-        }
-        catch (error) {
-            // modules 可能不存在
-        }
-        // 读取 config.json 以获取场景信息
-        try {
-            const configContent = await fs.readFile(files.config, 'utf-8');
-            const configJson = JSON.parse(configContent);
-            // 扫描场景文件
-            if (configJson.scenes && Array.isArray(configJson.scenes)) {
-                for (const scene of configJson.scenes) {
-                    if (scene.url && !scene.url.startsWith('data:')) {
-                        const scenePath = path.join(this.options.outputDir, scene.url);
-                        try {
-                            await fs.access(scenePath);
-                            files.scenes.push(scenePath);
-                        }
-                        catch (error) {
-                            // 场景文件可能不存在
-                        }
-                    }
-                }
-            }
-            // 扫描资产文件（从 files/ 目录）
-            const filesDir = path.join(this.options.outputDir, 'files');
-            try {
-                const filesDirStat = await fs.stat(filesDir);
-                if (filesDirStat.isDirectory()) {
-                    await this.scanDirectory(filesDir, files.assets);
-                }
-            }
-            catch (error) {
-                // files/ 目录可能不存在
-            }
-        }
-        catch (error) {
-            console.warn('警告: 无法读取 config.json:', error);
-        }
-        return files;
-    }
-    /**
-     * 递归扫描目录
-     */
-    async scanDirectory(dir, files) {
-        const entries = await fs.readdir(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            const fullPath = path.join(dir, entry.name);
-            if (entry.isDirectory()) {
-                await this.scanDirectory(fullPath, files);
-            }
-            else {
-                files.push(fullPath);
-            }
+            const adapter = new GenericAdapter(this.projectDir, this.options, engine);
+            return adapter.baseBuild();
         }
     }
     /**
-     * 记录构建产物信息到状态管理器
+     * 解析引擎类型
+     * 优先级：
+     * 1. options.engine（用户显式指定）
+     * 2. 自动检测
      */
-    async recordBuildOutput(result) {
-        console.log('[BaseBuilder] 记录构建产物信息...');
-        try {
-            // 记录 HTML 文件
-            if (result.files.html) {
-                const stat = await fs.stat(result.files.html);
-                this.stateManager.recordAsset('index.html', 'index.html', result.files.html, stat.size, 'html');
-                this.stateManager.updateAsset('index.html', 'base-build', 'index.html', 'index.html', stat.size);
+    async resolveEngine() {
+        // 1. 用户显式指定
+        if (this.options.engine) {
+            const validated = EngineDetector.validateEngine(this.options.engine);
+            if (validated) {
+                console.log(`[BaseBuilder] 使用用户指定的引擎: ${validated}`);
+                return validated;
             }
-            // 记录引擎文件
-            if (result.files.engine) {
-                const stat = await fs.stat(result.files.engine);
-                const engineName = path.basename(result.files.engine);
-                this.stateManager.recordAsset('playcanvas-engine', engineName, result.files.engine, stat.size, 'script');
-                this.stateManager.updateAsset('playcanvas-engine', 'base-build', engineName, engineName, stat.size);
-            }
-            // 记录 config.json
-            if (result.files.config) {
-                const stat = await fs.stat(result.files.config);
-                this.stateManager.recordAsset('config.json', 'config.json', result.files.config, stat.size, 'json');
-                this.stateManager.updateAsset('config.json', 'base-build', 'config.json', 'config.json', stat.size);
-            }
-            // 记录其他脚本文件
-            const scriptFiles = [
-                { path: result.files.start, id: '__start__.js' },
-                { path: result.files.settings, id: '__settings__.js' },
-                { path: result.files.modules, id: '__modules__.js' },
-            ];
-            for (const { path: filePath, id } of scriptFiles) {
-                if (filePath) {
-                    try {
-                        const stat = await fs.stat(filePath);
-                        const fileName = path.basename(filePath);
-                        this.stateManager.recordAsset(id, fileName, filePath, stat.size, 'script');
-                        this.stateManager.updateAsset(id, 'base-build', fileName, fileName, stat.size);
-                    }
-                    catch (error) {
-                        // 文件可能不存在
-                    }
-                }
-            }
-            // 记录场景文件
-            for (const scenePath of result.files.scenes) {
-                try {
-                    const stat = await fs.stat(scenePath);
-                    const sceneName = path.basename(scenePath);
-                    const sceneId = `scene-${sceneName}`;
-                    this.stateManager.recordAsset(sceneId, sceneName, scenePath, stat.size, 'json');
-                    this.stateManager.updateAsset(sceneId, 'base-build', sceneName, path.relative(this.options.outputDir, scenePath), stat.size);
-                }
-                catch (error) {
-                    // 忽略错误
-                }
-            }
-            // 记录资产文件
-            for (const assetPath of result.files.assets) {
-                try {
-                    const stat = await fs.stat(assetPath);
-                    const assetName = path.basename(assetPath);
-                    const assetId = `asset-${assetName}`;
-                    // 根据文件扩展名判断类型
-                    const ext = path.extname(assetName).toLowerCase();
-                    let assetType = 'other';
-                    if (['.png', '.jpg', '.jpeg', '.webp', '.gif'].includes(ext)) {
-                        assetType = 'texture';
-                    }
-                    else if (['.mp3', '.wav', '.ogg'].includes(ext)) {
-                        assetType = 'audio';
-                    }
-                    else if (['.glb', '.gltf', '.obj', '.fbx'].includes(ext)) {
-                        assetType = 'model';
-                    }
-                    this.stateManager.recordAsset(assetId, assetName, assetPath, stat.size, assetType);
-                    this.stateManager.updateAsset(assetId, 'base-build', assetName, path.relative(this.options.outputDir, assetPath), stat.size);
-                }
-                catch (error) {
-                    // 忽略错误
-                }
-            }
-            console.log('[BaseBuilder] 构建产物信息已记录');
-        }
-        catch (error) {
-            console.error('[BaseBuilder] 记录构建产物信息失败:', error);
-        }
-    }
-    /**
-     * 生成构建分析报告
-     */
-    async generateAnalysisReport() {
-        console.log('\n[BaseBuilder] 生成构建分析报告...');
-        try {
-            const analyzer = new BuildAnalyzer(this.options.outputDir, this.options.outputDir);
-            const report = await analyzer.analyze();
-            const reportPath = await analyzer.generateHTMLReport(report);
-            // 删除 rollup-plugin-visualizer 生成的报告文件
-            const oldReportPath = path.join(this.options.outputDir, 'base-bundle-report.html');
-            try {
-                await fs.unlink(oldReportPath);
-                console.log('[BaseBuilder] 已删除旧的分析报告: base-bundle-report.html');
-            }
-            catch (error) {
-                // 文件可能不存在，忽略错误
-            }
-            console.log(`\n📊 构建分析报告:`);
-            console.log(`   文件总数: ${report.totalFiles}`);
-            console.log(`   当前总大小: ${report.totalSizeFormatted}`);
-            console.log(`   预估单 HTML 大小: ${report.estimatedHtmlSizeFormatted}`);
-            console.log(`   报告路径: ${reportPath}\n`);
-        }
-        catch (error) {
-            console.error('[BaseBuilder] 生成分析报告失败:', error);
+            console.warn(`[BaseBuilder] 无效的引擎类型: ${this.options.engine}，将自动检测`);
         }
+        // 2. 自动检测
+        const detected = await EngineDetector.detect(this.projectDir);
+        console.log(`[BaseBuilder] 自动检测引擎: ${detected}`);
+        return detected;
     }
 }