@playcraft/build 0.0.11 → 0.0.14

package/dist/vite/plugin-playcanvas.js

@@ -2,6 +2,7 @@ import fs from 'fs/promises';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { createRequire } from 'module';
+import { minifyPatchCode } from '../utils/minify.js';
 /**
  * PlayCanvas Vite 插件
  * 处理 PlayCanvas 特定的资源转换和内联
@@ -73,6 +74,9 @@ export function vitePlayCanvasPlugin(options) {
                     }
                     // 对于 Classic 模式或 ESM 原生模式，保持原有的多文件结构
                 }
+                // 注意：HTML 压缩不能在这里执行，因为 Vite 还需要解析 HTML
+                // HTML 模板已经在 templates/ 中被压缩为单行
+                // 最终的 HTML 压缩由 vite-plugin-singlefile 在最后阶段处理
                 return html;
             },
         },
@@ -107,7 +111,7 @@ async function inlineEngineScript(html, baseBuildDir, options) {
         const enginePath = path.join(baseBuildDir, engineName);
         try {
             await fs.access(enginePath);
-            const engineCode = await fs.readFile(enginePath, 'utf-8');
+            let engineCode = await fs.readFile(enginePath, 'utf-8');
             const patchScripts = await getEnginePatchScripts(options);
             const engineScript = options.compressEngine
                 ? `${await getLz4InlineScript()}${await buildCompressedEngineScript(engineCode)}`
@@ -202,6 +206,8 @@ async function generateAndInlineSettings(html, baseBuildDir, options, pluginCont
     const appProps = configJson.application_properties || {};
     const scripts = appProps.scripts || [];
     const preloadModules = extractPreloadModules(configJson);
+    // 保留原始的 powerPreference 设置，默认为 high-performance
+    const powerPreference = appProps.powerPreference || 'high-performance';
     const settingsCode = `
 window.ASSET_PREFIX = "";
 window.SCRIPT_PREFIX = "";
@@ -211,7 +217,7 @@ window.CONTEXT_OPTIONS = {
     'alpha': ${appProps.transparentCanvas === true},
     'preserveDrawingBuffer': ${appProps.preserveDrawingBuffer === true},
     'deviceTypes': ['webgl2', 'webgl1'],
-    'powerPreference': "default"
+    'powerPreference': "${powerPreference}"
 };
 window.SCRIPTS = [${scripts.join(', ')}];
 window.CONFIG_FILENAME = ${configValue};
@@ -260,8 +266,24 @@ async function inlineESMBundleAssets(html, baseBuildDir, options, pluginContext)
     if (options.mraidSupport) {
         configJson = applyMraidConfig(configJson);
     }
-    // 5. 生成 config data URL
-    const configDataUrl = `data:application/json;base64,${Buffer.from(JSON.stringify(configJson)).toString('base64')}`;
+    // 5. 生成 config.json 的 data URL
+    // 如果启用 compressConfigJson，使用 LZ4 压缩后再 base64 编码
+    const configJsonString = JSON.stringify(configJson);
+    let configDataUrl;
+    if (options.compressConfigJson) {
+        const lz4 = await loadLz4Module();
+        const compressed = lz4.compress(Buffer.from(configJsonString));
+        const compressedBase64 = Buffer.from(compressed).toString('base64');
+        // 使用 lz4-json 前缀标识压缩格式，运行时需要解压
+        configDataUrl = `data:application/x-lz4-json;base64,${compressedBase64}`;
+        const originalSize = Buffer.from(configJsonString).length;
+        const compressedSize = compressed.length;
+        const ratio = ((1 - compressedSize / originalSize) * 100).toFixed(1);
+        console.log(`[PlayCanvasPlugin] ESM Bundle: config.json 已压缩 (${formatBytes(originalSize)} → ${formatBytes(compressedSize)}, 减少 ${ratio}%)`);
+    }
+    else {
+        configDataUrl = `data:application/json;base64,${Buffer.from(configJsonString).toString('base64')}`;
+    }
     // 6. 处理场景文件 - 获取第一个场景的 data URL
     let sceneDataUrl = '';
     if (configJson.scenes && configJson.scenes.length > 0) {
@@ -281,57 +303,23 @@ async function inlineESMBundleAssets(html, baseBuildDir, options, pluginContext)
             sceneDataUrl = sceneUrl || '';
         }
     }
-    // 7. 内联 logo.png
-    // index.esm.mjs 中使用 `${ASSET_PREFIX}logo.png` 引用 logo
-    // 需要将 ASSET_PREFIX 替换为 data URL 或直接替换 logo 引用
-    if (options.convertDataUrls) {
-        const logoPath = path.join(baseBuildDir, 'logo.png');
-        try {
-            const logoBuffer = await fs.readFile(logoPath);
-            const logoDataUrl = `data:image/png;base64,${logoBuffer.toString('base64')}`;
-            // 替换 `${ASSET_PREFIX}logo.png` 模式
-            // 由于代码被打包为 IIFE，模板字符串可能被转换为字符串拼接
-            // 格式1: `${ASSET_PREFIX}logo.png`
-            // 格式2: ASSET_PREFIX + "logo.png"
-            // 格式3: "".concat(ASSET_PREFIX, "logo.png")  (Vite 打包后)
-            const escapedLogoDataUrl = logoDataUrl.replace(/\$/g, '$$$$');
-            // 替换模板字符串格式（原始格式）
-            html = html.replace(/\$\{ASSET_PREFIX\}logo\.png/g, escapedLogoDataUrl);
-            // 替换字符串拼接格式
-            html = html.replace(/ASSET_PREFIX\s*\+\s*["']logo\.png["']/g, `"${escapedLogoDataUrl}"`);
-            // 替换 concat 格式 (Vite/Rollup 打包后常见格式)
-            html = html.replace(/["']?["']?\.concat\(ASSET_PREFIX,\s*["']logo\.png["']\)/g, `"${escapedLogoDataUrl}"`);
-            // 替换反引号模板字符串在 IIFE 中的编译结果
-            // `${ASSET_PREFIX}logo.png` 可能被编译为 ASSET_PREFIX+"logo.png"
-            html = html.replace(/`\$\{ASSET_PREFIX\}logo\.png`/g, `"${escapedLogoDataUrl}"`);
-            // ⚠️ 重要：Vite 压缩后，直接查找 "logo.png" 字符串
-            // 格式: .src="logo.png" 或 src:"logo.png" 或 ="logo.png"
-            const logoReplaceCount = (html.match(/["']logo\.png["']/g) || []).length;
-            if (logoReplaceCount > 0) {
-                html = html.replace(/["']logo\.png["']/g, `"${escapedLogoDataUrl}"`);
-                console.log(`[PlayCanvasPlugin] ESM Bundle: 替换了 ${logoReplaceCount} 处 "logo.png" 字符串`);
-            }
-            console.log(`[PlayCanvasPlugin] ESM Bundle: logo.png 已内联`);
-        }
-        catch (error) {
-            console.warn(`[PlayCanvasPlugin] ESM Bundle: logo.png 不存在，跳过内联`);
-        }
-    }
+    // 7. (Logo removed - no longer needed)
     // 8. 在 HTML 中查找并替换 ESM Bundle IIFE 代码中的配置值
-    // CONFIG_FILENAME = "config.json" → CONFIG_FILENAME = "data:application/json;base64,..."
-    // 注意：替换字符串中的 $ 是特殊字符，需要转义
-    const escapedConfigDataUrl = configDataUrl.replace(/\$/g, '$$$$');
-    // 替换 CONFIG_FILENAME（支持多种格式）
-    // 格式1: const CONFIG_FILENAME = "config.json"
-    // 格式2: CONFIG_FILENAME="config.json"
-    html = html.replace(/CONFIG_FILENAME\s*=\s*["']config\.json["']/g, `CONFIG_FILENAME = "${escapedConfigDataUrl}"`);
-    // ⚠️ 重要：Vite 压缩后，变量名会被混淆（如 CONFIG_FILENAME → vh）
-    // 需要直接替换 .configure("config.json" 调用中的字符串字面量
-    // 格式: .configure("config.json", ...) 或 .configure('config.json', ...)
+    // 方案1+3：直接将 CONFIG_FILENAME = "config.json" 替换为 data URL
+    // 8.1 替换 CONFIG_FILENAME
+    // 格式1: CONFIG_FILENAME = "config.json"
+    // 格式2: CONFIG_FILENAME="config.json"  (压缩后)
+    const configReplaceCount = (html.match(/CONFIG_FILENAME\s*=\s*["']config\.json["']/g) || []).length;
+    if (configReplaceCount > 0) {
+        html = html.replace(/CONFIG_FILENAME\s*=\s*["']config\.json["']/g, `CONFIG_FILENAME="${configDataUrl}"`);
+        console.log(`[PlayCanvasPlugin] ESM Bundle: 替换了 ${configReplaceCount} 处 CONFIG_FILENAME`);
+    }
+    // 8.2 替换 configure("config.json") 调用
+    // Vite 压缩后可能是: .configure("config.json",
     const configureReplaceCount = (html.match(/\.configure\s*\(\s*["']config\.json["']/g) || []).length;
     if (configureReplaceCount > 0) {
-        html = html.replace(/\.configure\s*\(\s*["']config\.json["']/g, `.configure("${escapedConfigDataUrl}"`);
-        console.log(`[PlayCanvasPlugin] ESM Bundle: 替换了 ${configureReplaceCount} 处 .configure("config.json") 调用`);
+        html = html.replace(/\.configure\s*\(\s*["']config\.json["']/g, `.configure("${configDataUrl}"`);
+        console.log(`[PlayCanvasPlugin] ESM Bundle: 替换了 ${configureReplaceCount} 处 .configure("config.json")`);
     }
     // 9. 替换 SCENE_PATH
     if (sceneDataUrl) {
@@ -403,28 +391,22 @@ async function inlineESMBundleAssets(html, baseBuildDir, options, pluginContext)
     // 这个补丁覆盖 pc.ScriptHandler.prototype._loadScript，使其能够：
     // 1. 正确处理 data URL 格式的脚本
     // 2. 对于空脚本（已打包到 IIFE 中的），直接跳过执行
-    const scriptHandlerPatch = `
-<script>
-// ScriptHandler patch for one-page build (empty scripts are already bundled in IIFE)
+    const scriptHandlerPatchCode = `
 (function() {
     if (typeof pc === 'undefined' || !pc.ScriptHandler) return;
     
     var originalLoadScript = pc.ScriptHandler.prototype._loadScript;
     pc.ScriptHandler.prototype._loadScript = function(url, callback) {
-        // Check if this is a data URL
         if (url && url.startsWith('data:text/javascript;base64,')) {
             var head = document.head;
             var element = document.createElement('script');
             this._cache[url] = element;
             element.async = false;
             
-            // Decode base64 content
             var index = url.indexOf(',');
             var base64 = url.slice(index + 1);
             
-            // If empty content (scripts already bundled), skip execution
             if (!base64 || base64.length === 0) {
-                // Still create the element for cache consistency
                 callback(null, url, element);
                 return;
             }
@@ -441,14 +423,13 @@ async function inlineESMBundleAssets(html, baseBuildDir, options, pluginContext)
             return;
         }
         
-        // Fall back to original implementation for non-data URLs
         return originalLoadScript.call(this, url, callback);
     };
-})();
-</script>`;
+})();`;
+    const minifiedScriptHandlerPatch = await minifyPatchCode(scriptHandlerPatchCode, 'scriptHandlerPatch');
     // 将补丁注入到 </head> 之前，确保在引擎之后、脚本加载之前执行
     if (html.includes('</head>')) {
-        html = html.replace('</head>', `${scriptHandlerPatch}\n</head>`);
+        html = html.replace('</head>', `<script>${minifiedScriptHandlerPatch}</script>\n</head>`);
     }
     console.log('[PlayCanvasPlugin] ESM Bundle 模式：资源内联完成');
     return html;
@@ -737,9 +718,6 @@ async function inlineGameScripts(html, baseBuildDir) {
 async function inlineStartScript(html, baseBuildDir, options) {
     const startPath = path.join(baseBuildDir, '__start__.js');
     let startCode = await fs.readFile(startPath, 'utf-8');
-    if (options.convertDataUrls) {
-        startCode = await inlineLogoInStartScript(startCode, baseBuildDir);
-    }
     // 替换 script 标签
     const scriptPattern = /<script[^>]*src=["']__start__\.js["'][^>]*><\/script>/i;
     if (scriptPattern.test(html)) {
@@ -761,9 +739,6 @@ async function inlineLoadingScript(html, baseBuildDir) {
         await fs.access(loadingPath);
         // 文件存在，内联它
         let loadingCode = await fs.readFile(loadingPath, 'utf-8');
-        if (loadingCode.includes('${ASSET_PREFIX}logo.png')) {
-            loadingCode = await inlineLogoInStartScript(loadingCode, baseBuildDir);
-        }
         if (scriptPattern.test(html)) {
             html = html.replace(scriptPattern, `<script>${loadingCode}</script>`);
         }
@@ -780,6 +755,33 @@ async function inlineLoadingScript(html, baseBuildDir) {
     }
     return html;
 }
+/**
+ * 压缩 CSS 代码
+ * 移除注释、多余空白、合并为单行
+ */
+function minifyCSS(css) {
+    return css
+        // 移除多行注释 /* ... */
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        // 移除单行注释 // ... (CSS 不标准但有些预处理器会保留)
+        .replace(/\/\/.*$/gm, '')
+        // 将多个空白字符（空格、换行、制表符）替换为单个空格
+        .replace(/\s+/g, ' ')
+        // 移除 { 前的空格
+        .replace(/\s*\{\s*/g, '{')
+        // 移除 } 后的空格
+        .replace(/\s*\}\s*/g, '}')
+        // 移除 : 前后的空格
+        .replace(/\s*:\s*/g, ':')
+        // 移除 ; 前后的空格
+        .replace(/\s*;\s*/g, ';')
+        // 移除 , 后的空格
+        .replace(/,\s*/g, ',')
+        // 移除最后一个 ; 在 } 前
+        .replace(/;}/g, '}')
+        // 去除首尾空白
+        .trim();
+}
 /**
  * 内联 CSS 文件
  */
@@ -799,6 +801,8 @@ async function inlineCSS(html, baseBuildDir, options) {
             if (options.mraidSupport && !cssContent.includes('fill-mode-NONE')) {
                 cssContent += '\n#application-canvas.fill-mode-NONE { margin: 0; width: 100%; height: 100%; }\n';
             }
+            // 压缩 CSS（移除注释、多余空白、合并为单行）
+            cssContent = minifyCSS(cssContent);
             // 替换 link 标签为 style 标签
             html = html.replace(match[0], `<style>${cssContent}</style>`);
         }
@@ -1004,10 +1008,14 @@ async function inlineConfigAssetUrls(configJson, baseBuildDir, pluginContext) {
                 }
             }
             // ✅ 核心优化：如果是图片，使用 sharp 压缩
+            // ⚠️ 重要：字体纹理（type === 'font'）不能转换为 WebP！
+            // MSDF/位图字体的 PNG 纹理包含精确的距离场/像素数据，
+            // WebP 有损压缩会破坏这些数据导致字体渲染异常
             else if (isImageFile(cleanUrl)) {
+                const isFontTexture = asset.type === 'font';
                 const compressed = await compressImage(buffer, cleanUrl, {
-                    convertToWebP: true,
-                    quality: 75,
+                    convertToWebP: !isFontTexture, // 字体纹理不转换为 WebP
+                    quality: isFontTexture ? 100 : 75, // 字体纹理使用无损压缩
                 });
                 // 防御性检查：如果压缩后的 buffer 为空，使用原始 buffer
                 if (!compressed.buffer || compressed.buffer.length === 0) {
@@ -1122,17 +1130,6 @@ async function inlineConfigAssetUrls(configJson, baseBuildDir, pluginContext) {
     }
     return configJson;
 }
-async function inlineLogoInStartScript(startCode, baseBuildDir) {
-    const logoPath = path.join(baseBuildDir, 'logo.png');
-    try {
-        const buffer = await fs.readFile(logoPath);
-        const dataUrl = `data:image/png;base64,${buffer.toString('base64')}`;
-        return startCode.replace(/\$\{ASSET_PREFIX\}logo\.png/g, dataUrl);
-    }
-    catch (error) {
-        return startCode;
-    }
-}
 /**
  * 为跳过的资源生成有效的占位符 data URL
  */
@@ -1196,10 +1193,15 @@ async function compressImage(buffer, filePath, options) {
             };
         }
         // 按原格式压缩
+        const quality = options?.quality ?? 80;
         switch (ext) {
             case '.png':
+                // 如果 quality >= 100，使用无损压缩（适用于字体纹理）
                 const pngBuffer = await image
-                    .png({ quality: 80, compressionLevel: 9 })
+                    .png({
+                    compressionLevel: quality >= 100 ? 6 : 9, // 无损时使用中等压缩
+                    palette: quality < 100, // 无损时不使用调色板
+                })
                     .toBuffer();
                 // 防御性检查
                 if (!pngBuffer || pngBuffer.length === 0) {
@@ -1295,7 +1297,9 @@ function buildConfigValue(configJson) {
 function applyMraidConfig(configJson) {
     const next = { ...configJson };
     const props = { ...(next.application_properties || {}) };
-    props.fillMode = 'NONE';
+    // Keep original fillMode (usually KEEP_ASPECT) for correct canvas scaling
+    // The MRAID resize patch will handle the sizing
+    // props.fillMode = 'NONE';  // Removed: causes canvas scaling issues
     next.application_properties = props;
     return next;
 }
@@ -1325,19 +1329,42 @@ async function getEnginePatchScripts(options) {
     const scripts = [];
     if (options.patchXhrOut) {
         const patchCode = await readPatchFile('playcraft-no-xhr.js');
-        scripts.push(`<script>${patchCode}</script>`);
+        const minified = await minifyPatchCode(patchCode, 'playcraft-no-xhr.js');
+        scripts.push(`<script>${minified}</script>`);
     }
     else if (options.configJsonInline) {
         const patchCode = await readPatchFile('one-page-http-get.js');
-        scripts.push(`<script>${patchCode}</script>`);
+        const minified = await minifyPatchCode(patchCode, 'one-page-http-get.js');
+        scripts.push(`<script>${minified}</script>`);
     }
     if (options.inlineGameScripts) {
         const patchCode = await readPatchFile('one-page-inline-game-scripts.js');
-        scripts.push(`<script>${patchCode}</script>`);
+        const minified = await minifyPatchCode(patchCode, 'one-page-inline-game-scripts.js');
+        scripts.push(`<script>${minified}</script>`);
     }
     if (options.mraidSupport) {
         const patchCode = await readPatchFile('one-page-mraid-resize-canvas.js');
-        scripts.push(`<script>${patchCode}</script>`);
+        const minified = await minifyPatchCode(patchCode, 'one-page-mraid-resize-canvas.js');
+        scripts.push(`<script>${minified}</script>`);
+    }
+    // 注入 Scene applySettings 补丁：确保 settings.physics/render 存在，避免 "Cannot read properties of undefined (reading 'gravity')" 报错
+    // 场景：ammoReplacement 或部分场景 JSON 缺少 physics 配置
+    const scenePhysicsPatch = await readPatchFile('scene-physics-defaults.js');
+    if (scenePhysicsPatch) {
+        const minified = await minifyPatchCode(scenePhysicsPatch, 'scene-physics-defaults.js');
+        scripts.push(`<script>${minified}</script>`);
+    }
+    // 如果启用了 config.json 压缩，需要注入 LZ4 解压运行时代码
+    // 注意：必须在 compressEngine 之前检查，因为 compressEngine 也会注入 lz4.js
+    if (options.compressConfigJson && !options.compressEngine) {
+        // 如果没有启用引擎压缩，需要单独注入 lz4.js
+        const lz4Script = await getLz4InlineScript();
+        scripts.push(lz4Script);
+    }
+    // 注入 config.json 解压 patch（拦截 fetch 请求并解压 LZ4 数据）
+    if (options.compressConfigJson) {
+        const configDecompressPatch = buildConfigJsonDecompressPatch();
+        scripts.push(`<script>${configDecompressPatch}</script>`);
     }
     if (options.compressEngine) {
         // Focus patch: 确保 canvas 获得焦点以接收键盘事件
@@ -1379,3 +1406,69 @@ async function readPatchFile(name) {
     const patchPath = path.resolve(currentDir, '../../templates/patches', name);
     return await fs.readFile(patchPath, 'utf-8');
 }
+/**
+ * 格式化字节数为人类可读格式
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+}
+/**
+ * 构建 config.json 解压 patch
+ *
+ * 这个 patch 拦截 PlayCanvas 的 pc.Http.prototype.get 请求，
+ * 检测是否为 LZ4 压缩的 config.json，如果是则解压后返回。
+ *
+ * 工作原理：
+ * 1. 保存原始 pc.Http.prototype.get 函数
+ * 2. 重写 get，检测 URL 是否为 LZ4 压缩的 JSON data URL
+ * 3. 如果是，解压并通过 callback 返回解析后的 JSON 对象
+ *
+ * 注意：
+ * - PlayCanvas 使用 pc.Http.prototype.get 加载 config.json，不是 fetch
+ * - 使用 lz4.js 提供的 Buffer polyfill 进行解压
+ * - 必须在 pc 对象可用后才能生效，所以使用轮询等待
+ */
+function buildConfigJsonDecompressPatch() {
+    // 原始代码:
+    // (function() {
+    //   function patch() {
+    //     if (!window.pc || !window.pc.Http) return false;
+    //     var oldGet = pc.Http.prototype.get;
+    //     pc.Http.prototype.get = function(url, options, callback) {
+    //       if (typeof options === 'function') {
+    //         callback = options;
+    //         options = {};
+    //       }
+    //       if (typeof url === 'string' && url.startsWith('data:application/x-lz4-json;base64,')) {
+    //         try {
+    //           var base64 = url.replace('data:application/x-lz4-json;base64,', '');
+    //           var compressed = new Buffer(base64, 'base64');
+    //           var decompressed = lz4.decompress(compressed);
+    //           var str = Buffer.from(decompressed).toString('utf8');
+    //           var json = JSON.parse(str);
+    //           console.log('[LZ4 Config] Decompressed config.json successfully, size:', str.length);
+    //           callback(null, json);
+    //         } catch(e) {
+    //           console.error('[LZ4 Config] Decompression error:', e);
+    //           callback(e);
+    //         }
+    //         return;
+    //       }
+    //       oldGet.call(this, url, options, callback);
+    //     };
+    //     return true;
+    //   }
+    //   if (!patch()) {
+    //     var c = 0;
+    //     var i = setInterval(function() {
+    //       if (patch() || ++c > 100) clearInterval(i);
+    //     }, 10);
+    //   }
+    // })();
+    return `!function(){function p(){if(!window.pc||!pc.Http)return!1;var o=pc.Http.prototype.get;return pc.Http.prototype.get=function(e,t,n){"function"==typeof t&&(n=t,t={});if("string"==typeof e&&e.startsWith("data:application/x-lz4-json;base64,")){try{var r=e.replace("data:application/x-lz4-json;base64,",""),a=new Buffer(r,"base64"),d=lz4.decompress(a),s=Buffer.from(d).toString("utf8"),j=JSON.parse(s);console.log("[LZ4 Config] Decompressed config.json successfully, size:",s.length);n(null,j)}catch(x){console.error("[LZ4 Config] Decompression error:",x);n(x)}return}o.call(this,e,t,n)},!0}if(!p()){var c=0,i=setInterval(function(){(p()||++c>100)&&clearInterval(i)},10)}}();`;
+}

package/dist/vite/plugin-source-builder.js

@@ -52,6 +52,39 @@ export function viteSourceBuilderPlugin(options) {
             if (scriptPathMap.has(id)) {
                 return scriptPathMap.get(id);
             }
+            // 通过 Import Map 解析裸模块说明符（如 gameRule、planck 等）
+            // Import Map 中的路径是相对于 assets/ 目录的（Import Map 文件本身在 assets/Import Map.json 中）
+            if (options.importMap?.content?.imports && !id.startsWith('./') && !id.startsWith('../') && !id.startsWith('/') && !id.startsWith('\0')) {
+                const imports = options.importMap.content.imports;
+                const assetsDir = path.join(options.projectDir, 'assets');
+                // 精确匹配（如 "gameRule" -> "./Generated/GameRule/BreakshotPoolRule.mjs"）
+                if (imports[id]) {
+                    let resolved = imports[id];
+                    // 去掉开头的 ./
+                    if (resolved.startsWith('./')) {
+                        resolved = resolved.slice(2);
+                    }
+                    const absPath = path.join(assetsDir, resolved);
+                    console.log(`[SourceBuilder] Import Map 解析: ${id} -> ${absPath}`);
+                    return absPath;
+                }
+                // 前缀匹配（如 "Gameplay/" -> "./LiteCreator/Gameplay/"）
+                for (const [prefix, target] of Object.entries(imports)) {
+                    if (prefix.endsWith('/') && id.startsWith(prefix)) {
+                        const remainder = id.slice(prefix.length);
+                        let targetBase = target;
+                        if (targetBase.startsWith('./')) {
+                            targetBase = targetBase.slice(2);
+                        }
+                        if (targetBase.endsWith('/')) {
+                            targetBase = targetBase.slice(0, -1);
+                        }
+                        const absPath = path.join(assetsDir, targetBase, remainder);
+                        console.log(`[SourceBuilder] Import Map 前缀解析: ${id} -> ${absPath}`);
+                        return absPath;
+                    }
+                }
+            }
             // 处理相对导入（../xxx 或 ./xxx）
             if (importer && (id.startsWith('./') || id.startsWith('../'))) {
                 // 获取导入者的模块路径
@@ -277,7 +310,6 @@ async function copyTemplates(outputDir) {
         '__loading__.js',
         'playcanvas-stable.min.js',
         'styles.css',
-        'logo.png',
         'manifest.json',
     ];
     for (const file of templateFiles) {
@@ -373,11 +405,21 @@ function collectRegisteredScriptNames(assets) {
         if (scriptName) {
             scriptNames.add(scriptName);
         }
-        // 如果脚本资产有 data.scripts 数组（Classic 格式），也收集这些名称
-        if (asset.data?.scripts && Array.isArray(asset.data.scripts)) {
-            for (const s of asset.data.scripts) {
-                if (s?.name)
-                    scriptNames.add(s.name);
+        // Classic 格式的 data.scripts 可能是对象或数组
+        if (asset.data?.scripts) {
+            if (Array.isArray(asset.data.scripts)) {
+                // 数组格式: [{ name: 'xxx' }, ...]
+                for (const s of asset.data.scripts) {
+                    if (s?.name)
+                        scriptNames.add(s.name);
+                }
+            }
+            else if (typeof asset.data.scripts === 'object') {
+                // 对象格式: { "followCamera": { attributes: {...} }, ... }
+                // 这是 PlayCanvas/PlayCraft 中 Classic 脚本的标准格式
+                for (const scriptKey of Object.keys(asset.data.scripts)) {
+                    scriptNames.add(scriptKey);
+                }
             }
         }
     }
@@ -542,8 +584,28 @@ async function normalizeAssetUrls(projectConfig, projectDir) {
     let notFoundCount = 0;
     for (const [assetId, asset] of Object.entries(assets)) {
         const assetData = asset;
-        // 跳过已有 url 或没有 file 的资源
-        if (!assetData.file || assetData.file.url) {
+        // 跳过没有 file 的资源
+        if (!assetData.file) {
+            continue;
+        }
+        // 如果已有有效的本地 url（非 API URL），验证文件是否存在
+        if (assetData.file.url && !assetData.file.url.startsWith('/api/') && !assetData.file.url.startsWith('http')) {
+            // 已有有效的本地 url，验证文件存在性
+            try {
+                await fs.access(path.join(projectDir, assetData.file.url));
+                continue; // 文件存在，跳过
+            }
+            catch {
+                // 文件不存在，清除 url 继续搜索
+                delete assetData.file.url;
+            }
+        }
+        // 如果 url 是 API URL（PlayCraft 格式残留），清除它
+        if (assetData.file.url && (assetData.file.url.startsWith('/api/') || assetData.file.url.startsWith('http'))) {
+            delete assetData.file.url;
+        }
+        // 如果已经有有效 url 了（由之前的 loader 设置的），跳过
+        if (assetData.file.url) {
             continue;
         }
         const filename = assetData.file.filename;
@@ -552,11 +614,19 @@ async function normalizeAssetUrls(projectConfig, projectDir) {
         }
         const revision = assetData.revision ?? assetData.file.revision ?? 1;
         const candidates = [
+            // PlayCanvas 标准结构
             path.join('files', 'assets', String(assetId), String(revision), filename),
             path.join('files', 'assets', String(assetId), '1', filename),
             path.join('files', 'assets', String(assetId), filename),
             path.join('files', filename),
         ];
+        // PlayCraft 结构：使用 treePath 或 path 字段推断文件位置
+        if (assetData.treePath) {
+            candidates.push(path.join(assetData.treePath, filename));
+        }
+        if (assetData.path && typeof assetData.path === 'string') {
+            candidates.push(assetData.path);
+        }
         let found = false;
         for (const rel of candidates) {
             const abs = path.join(projectDir, rel);
@@ -699,7 +769,6 @@ async function generateESMTemplate(projectConfig, options, config) {
         '__modules__.js',
         '__loading__.js',
         'styles.css',
-        'logo.png',
         'manifest.json',
     ];
     for (const file of templateFiles) {
@@ -737,12 +806,19 @@ function fixImportMapPaths(importMap) {
  * 收集 ESM 脚本的导入路径
  */
 async function collectESMScriptImports(projectConfig, options) {
-    if (projectConfig.format !== 'playcanvas') {
-        return [];
+    // 获取脚本 ID 列表和资产（支持 PlayCanvas 和 PlayCraft 两种格式）
+    let scriptIds;
+    let assets;
+    if (projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        scriptIds = pcProject.project.settings?.scripts || [];
+        assets = pcProject.assets;
+    }
+    else {
+        const pcProject = projectConfig;
+        scriptIds = pcProject.manifest.settings?.scripts || [];
+        assets = pcProject.assets;
     }
-    const pcProject = projectConfig;
-    const scriptIds = pcProject.project.settings?.scripts || [];
-    const assets = pcProject.assets;
     const importPaths = [];
     // 构建文件夹 ID 到名称的映射
     const folderMap = new Map();
@@ -868,14 +944,19 @@ async function generateESMEntry(projectConfig, outputDir, scriptImportPaths = []
 async function copyUserScriptsForESM(projectConfig, projectDir, outputDir, importMap) {
     const scriptUrlMap = new Map();
     console.log(`[copyUserScriptsForESM] 项目格式: ${projectConfig.format}`);
-    if (projectConfig.format !== 'playcanvas') {
-        // PlayCraft 格式暂不支持
-        console.log('[copyUserScriptsForESM] 跳过：非 PlayCanvas 格式');
-        return scriptUrlMap;
+    // 获取脚本 ID 列表和资产（支持 PlayCanvas 和 PlayCraft 两种格式）
+    let scriptIds;
+    let assets;
+    if (projectConfig.format === 'playcanvas') {
+        const pcProject = projectConfig;
+        scriptIds = pcProject.project.settings?.scripts || [];
+        assets = pcProject.assets;
+    }
+    else {
+        const pcProject = projectConfig;
+        scriptIds = pcProject.manifest.settings?.scripts || [];
+        assets = pcProject.assets;
     }
-    const pcProject = projectConfig;
-    const scriptIds = pcProject.project.settings?.scripts || [];
-    const assets = pcProject.assets;
     console.log(`[copyUserScriptsForESM] 脚本数量: ${scriptIds.length}`);
     // 构建文件夹 ID 到名称的映射
     const folderMap = new Map();