@maoyugames/phaser-framework 1.0.2 → 1.0.4

package/dist/cli/index.d.ts

@@ -7,6 +7,7 @@
  *   pf build <platform|all>      构建某平台/全部平台(临时入口 + 编程式 vite + 外壳注入 + 校验)
  *   pf size-check [platform]     产物体积检查(扫 <root>/dist/<p>)
  *   pf verify-isolation [platform] SDK 隔离校验(扫 <root>/dist/<p>)
+ *   pf verify [platform] [--no-build] 实跑冒烟验证(Playwright 无头:确认渲染 + 无运行期错误)
  *   pf cap <sync|open> [android|ios]  Capacitor 同步/打开原生工程
  *   pf help                      查看帮助
  *

package/dist/cli/index.js

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
 import '../chunk-PKBMQBKP.js';
-import pc4 from 'picocolors';
-import { resolve, join, relative, basename, dirname } from 'path';
+import pc6 from 'picocolors';
+import { resolve, join, extname, relative, basename, dirname } from 'path';
 import { randomBytes } from 'crypto';
 import fse4 from 'fs-extra';
 import { createRequire } from 'module';
 import { fileURLToPath } from 'url';
-import { existsSync, readFileSync } from 'fs';
+import { existsSync, mkdirSync, writeFileSync, readFile, readFileSync } from 'fs';
+import http from 'http';
 import { spawnSync } from 'child_process';
 
 // src/cli/platforms-meta.ts
@@ -538,7 +539,7 @@ function writeShellFiles(distDir, projectRoot, files) {
     const dst = join(distDir, f.relPath);
     fse4.ensureDirSync(resolve(dst, ".."));
     fse4.writeFileSync(dst, f.content, "utf-8");
-    console.log(pc4.green(`    \u2713 ${f.relPath} \u2192 ${relative(projectRoot, dst)}`));
+    console.log(pc6.green(`    \u2713 ${f.relPath} \u2192 ${relative(projectRoot, dst)}`));
   }
 }
 function injectShell(opts) {
@@ -548,19 +549,19 @@ function injectShell(opts) {
     case "tiktok":
       return true;
     case "facebook": {
-      console.log(pc4.cyan(`  \u25B6 [facebook] \u6CE8\u5165\u5916\u58F3\u6587\u4EF6`));
+      console.log(pc6.cyan(`  \u25B6 [facebook] \u6CE8\u5165\u5916\u58F3\u6587\u4EF6`));
       writeShellFiles(distDir, projectRoot, [renderFacebookAppConfig(config.facebook)]);
       return true;
     }
     case "capacitor": {
-      console.log(pc4.cyan(`  \u25B6 [capacitor] \u751F\u6210 capacitor.config.ts(\u9879\u76EE\u6839)`));
+      console.log(pc6.cyan(`  \u25B6 [capacitor] \u751F\u6210 capacitor.config.ts(\u9879\u76EE\u6839)`));
       const capCfgPath = resolve(projectRoot, "capacitor.config.ts");
       fse4.writeFileSync(capCfgPath, renderCapacitorConfig(config.capacitor), "utf-8");
-      console.log(pc4.green(`    \u2713 capacitor.config.ts \u2192 ${relative(projectRoot, capCfgPath)}`));
+      console.log(pc6.green(`    \u2713 capacitor.config.ts \u2192 ${relative(projectRoot, capCfgPath)}`));
       return true;
     }
     case "wechat": {
-      console.log(pc4.cyan(`  \u25B6 [wechat] \u6CE8\u5165\u5916\u58F3\u6587\u4EF6`));
+      console.log(pc6.cyan(`  \u25B6 [wechat] \u6CE8\u5165\u5916\u58F3\u6587\u4EF6`));
       writeShellFiles(distDir, projectRoot, renderWeChatShells(config.wechat));
       copyPublicAssetsToWechat(projectRoot, distDir);
       copyWechatVendor(projectRoot, distDir);
@@ -573,37 +574,37 @@ function injectShell(opts) {
 function copyPublicAssetsToWechat(projectRoot, distDir) {
   const srcPublic = resolve(projectRoot, "src/game/public");
   if (!fse4.existsSync(srcPublic)) return;
-  console.log(pc4.cyan("  \u25B6 [wechat] \u62F7\u8D1D\u4E1A\u52A1\u9759\u6001\u8D44\u6E90(src/game/public)"));
+  console.log(pc6.cyan("  \u25B6 [wechat] \u62F7\u8D1D\u4E1A\u52A1\u9759\u6001\u8D44\u6E90(src/game/public)"));
   fse4.copySync(srcPublic, distDir);
-  console.log(pc4.green("    \u2713 src/game/public/* \u2192 dist/wechat/"));
+  console.log(pc6.green("    \u2713 src/game/public/* \u2192 dist/wechat/"));
 }
 function copyWechatVendor(projectRoot, distDir) {
-  console.log(pc4.cyan("  \u25B6 [wechat] \u68C0\u6D4B\u5FAE\u4FE1\u9002\u914D\u5668(vendor)"));
+  console.log(pc6.cyan("  \u25B6 [wechat] \u68C0\u6D4B\u5FAE\u4FE1\u9002\u914D\u5668(vendor)"));
   const dirs = wechatVendorDirs(projectRoot);
   const adapter = dirs.map((d) => join(d, "weapp-adapter.js")).find((p) => fse4.existsSync(p));
   if (adapter) {
     fse4.copyFileSync(adapter, join(distDir, "weapp-adapter.js"));
-    console.log(pc4.green("    \u2713 weapp-adapter.js \u2192 dist/wechat/weapp-adapter.js"));
+    console.log(pc6.green("    \u2713 weapp-adapter.js \u2192 dist/wechat/weapp-adapter.js"));
     const vendorDir = resolve(adapter, "..");
     const symbol = join(vendorDir, "symbol.js");
     if (fse4.existsSync(symbol)) {
       fse4.copyFileSync(symbol, join(distDir, "symbol.js"));
-      console.log(pc4.green("    \u2713 symbol.js \u2192 dist/wechat/symbol.js"));
+      console.log(pc6.green("    \u2713 symbol.js \u2192 dist/wechat/symbol.js"));
     }
     return true;
   }
-  console.log(pc4.yellow(pc4.bold("    \u26A0 \u7F3A\u5C11\u5FAE\u4FE1\u9002\u914D\u5668 weapp-adapter.js")));
+  console.log(pc6.yellow(pc6.bold("    \u26A0 \u7F3A\u5C11\u5FAE\u4FE1\u9002\u914D\u5668 weapp-adapter.js")));
   console.log(
-    pc4.yellow(
+    pc6.yellow(
       "      \u5FAE\u4FE1\u5C0F\u6E38\u620F\u65E0 DOM,\u9700\u6B64\u5B98\u65B9\u9002\u914D\u5668\u6CE8\u5165 canvas/document shim,\u5426\u5219 game.js \u542F\u52A8\u5373\u62A5\u9519\u3002"
     )
   );
-  console.log(pc4.yellow(`      \u8BF7\u628A\u5B98\u65B9 weapp-adapter.js(\u53CA\u53EF\u9009 symbol.js)\u653E\u5230\u4EE5\u4E0B\u4EFB\u4E00\u76EE\u5F55\u540E\u91CD\u65B0\u6784\u5EFA:`));
+  console.log(pc6.yellow(`      \u8BF7\u628A\u5B98\u65B9 weapp-adapter.js(\u53CA\u53EF\u9009 symbol.js)\u653E\u5230\u4EE5\u4E0B\u4EFB\u4E00\u76EE\u5F55\u540E\u91CD\u65B0\u6784\u5EFA:`));
   for (const d of wechatVendorDirs(projectRoot)) {
-    console.log(pc4.yellow(`        - ${relative(projectRoot, d)}/weapp-adapter.js`));
+    console.log(pc6.yellow(`        - ${relative(projectRoot, d)}/weapp-adapter.js`));
   }
   console.log(
-    pc4.yellow("      \u83B7\u53D6\u65B9\u5F0F:\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177\u65B0\u5EFA\u300C\u5C0F\u6E38\u620F\u300D\u9879\u76EE\u6A21\u677F\u91CC\u9644\u5E26 weapp-adapter.js\u3002")
+    pc6.yellow("      \u83B7\u53D6\u65B9\u5F0F:\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177\u65B0\u5EFA\u300C\u5C0F\u6E38\u620F\u300D\u9879\u76EE\u6A21\u677F\u91CC\u9644\u5E26 weapp-adapter.js\u3002")
   );
   return false;
 }
@@ -627,43 +628,43 @@ function findMainBundle(files) {
 }
 function checkPlatform(platform, distDir) {
   if (!fse4.existsSync(distDir)) {
-    console.log(pc4.gray(`  [${platform}] \u672A\u6784\u5EFA,\u8DF3\u8FC7`));
+    console.log(pc6.gray(`  [${platform}] \u672A\u6784\u5EFA,\u8DF3\u8FC7`));
     return true;
   }
   const files = listFiles(distDir);
   const total = files.reduce((s, f) => s + f.size, 0);
   const main2 = findMainBundle(files);
   const limits = SIZE_LIMITS[platform];
-  console.log(pc4.cyan(`  [${platform}]`));
-  console.log(`    \u603B\u4F53\u79EF:${pc4.bold(formatBytes(total))}(${files.length} \u4E2A\u6587\u4EF6)`);
+  console.log(pc6.cyan(`  [${platform}]`));
+  console.log(`    \u603B\u4F53\u79EF:${pc6.bold(formatBytes(total))}(${files.length} \u4E2A\u6587\u4EF6)`);
   if (main2) {
-    console.log(`    \u4E3B bundle:${basename(main2.path)} = ${pc4.bold(formatBytes(main2.size))}`);
+    console.log(`    \u4E3B bundle:${basename(main2.path)} = ${pc6.bold(formatBytes(main2.size))}`);
   }
   let ok = true;
   if (limits?.totalHardLimit) {
     if (total > limits.totalHardLimit) {
       console.log(
-        pc4.red(
+        pc6.red(
           `    \u2717 \u8D85\u51FA TikTok \u6574\u5305\u786C\u4E0A\u9650 ${formatBytes(limits.totalHardLimit)}(\u8D85 ${formatBytes(total - limits.totalHardLimit)})`
         )
       );
       ok = false;
     } else {
       console.log(
-        pc4.green(`    \u2713 \u5728 TikTok 50MB \u6574\u5305\u4E0A\u9650\u5185(\u4F59 ${formatBytes(limits.totalHardLimit - total)})`)
+        pc6.green(`    \u2713 \u5728 TikTok 50MB \u6574\u5305\u4E0A\u9650\u5185(\u4F59 ${formatBytes(limits.totalHardLimit - total)})`)
       );
     }
   }
   if (limits?.mainBundleSoftLimit && main2) {
     if (main2.size > limits.mainBundleSoftLimit) {
       console.log(
-        pc4.yellow(
+        pc6.yellow(
           `    \u26A0 \u5FAE\u4FE1\u4E3B\u5305\u8D85\u8FC7\u5EFA\u8BAE ${formatBytes(limits.mainBundleSoftLimit)}(\u5F53\u524D ${formatBytes(main2.size)});\u5EFA\u8BAE\u62C6\u5206\u5305\u6216\u88C1\u526A\u8D44\u6E90,\u4F46\u4E0D\u963B\u65AD\u6784\u5EFA`
         )
       );
     } else {
       console.log(
-        pc4.green(`    \u2713 \u5FAE\u4FE1\u4E3B\u5305\u5728 4MB \u5EFA\u8BAE\u503C\u5185(\u4F59 ${formatBytes(limits.mainBundleSoftLimit - main2.size)})`)
+        pc6.green(`    \u2713 \u5FAE\u4FE1\u4E3B\u5305\u5728 4MB \u5EFA\u8BAE\u503C\u5185(\u4F59 ${formatBytes(limits.mainBundleSoftLimit - main2.size)})`)
       );
     }
   }
@@ -672,29 +673,29 @@ function checkPlatform(platform, distDir) {
 function runSizeCheck(target) {
   const ctx = resolveProject();
   const targets = target ? isPlatform(target) ? [target] : invalidTarget(target) : ALL_PLATFORMS;
-  console.log(pc4.cyan(pc4.bold("\u25B6 \u4EA7\u7269\u4F53\u79EF\u68C0\u67E5")));
+  console.log(pc6.cyan(pc6.bold("\u25B6 \u4EA7\u7269\u4F53\u79EF\u68C0\u67E5")));
   let allOk = true;
   for (const p of targets) {
     const distDir = join(ctx.root, "dist", p);
     if (!checkPlatform(p, distDir)) allOk = false;
   }
   if (!allOk) {
-    console.log(pc4.red(pc4.bold("\n\u2717 \u4F53\u79EF\u68C0\u67E5\u672A\u901A\u8FC7(\u5B58\u5728\u8D85\u786C\u4E0A\u9650\u7684\u5E73\u53F0)")));
+    console.log(pc6.red(pc6.bold("\n\u2717 \u4F53\u79EF\u68C0\u67E5\u672A\u901A\u8FC7(\u5B58\u5728\u8D85\u786C\u4E0A\u9650\u7684\u5E73\u53F0)")));
     return false;
   }
-  console.log(pc4.green(pc4.bold("\n\u2713 \u4F53\u79EF\u68C0\u67E5\u5B8C\u6210")));
+  console.log(pc6.green(pc6.bold("\n\u2713 \u4F53\u79EF\u68C0\u67E5\u5B8C\u6210")));
   return true;
 }
 function sizeCheckPlatform(platform, distDir) {
-  console.log(pc4.cyan(pc4.bold("\u25B6 \u4EA7\u7269\u4F53\u79EF\u68C0\u67E5")));
+  console.log(pc6.cyan(pc6.bold("\u25B6 \u4EA7\u7269\u4F53\u79EF\u68C0\u67E5")));
   const ok = checkPlatform(platform, distDir);
-  if (ok) console.log(pc4.green(pc4.bold("\u2713 \u4F53\u79EF\u68C0\u67E5\u5B8C\u6210")));
-  else console.log(pc4.red(pc4.bold("\u2717 \u4F53\u79EF\u68C0\u67E5\u672A\u901A\u8FC7")));
+  if (ok) console.log(pc6.green(pc6.bold("\u2713 \u4F53\u79EF\u68C0\u67E5\u5B8C\u6210")));
+  else console.log(pc6.red(pc6.bold("\u2717 \u4F53\u79EF\u68C0\u67E5\u672A\u901A\u8FC7")));
   return ok;
 }
 function invalidTarget(target) {
-  console.log(pc4.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
-  console.log(pc4.gray(`\u53EF\u9009:${ALL_PLATFORMS.join(" / ")}`));
+  console.log(pc6.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
+  console.log(pc6.gray(`\u53EF\u9009:${ALL_PLATFORMS.join(" / ")}`));
   process.exit(1);
 }
 function collectJsFiles(dir) {
@@ -716,12 +717,12 @@ function snippetAround(text, index, span = 60) {
 function verifyPlatform(platform, distDir, projectRoot) {
   const rules = ISOLATION_RULES[platform];
   if (!fse4.existsSync(distDir)) {
-    console.log(pc4.gray(`  [${platform}] \u672A\u6784\u5EFA(${relative(projectRoot, distDir)} \u4E0D\u5B58\u5728),\u8DF3\u8FC7`));
+    console.log(pc6.gray(`  [${platform}] \u672A\u6784\u5EFA(${relative(projectRoot, distDir)} \u4E0D\u5B58\u5728),\u8DF3\u8FC7`));
     return 0;
   }
   const files = collectJsFiles(distDir);
   if (files.length === 0) {
-    console.log(pc4.yellow(`  [${platform}] \u672A\u53D1\u73B0 JS \u4EA7\u7269,\u8DF3\u8FC7`));
+    console.log(pc6.yellow(`  [${platform}] \u672A\u53D1\u73B0 JS \u4EA7\u7269,\u8DF3\u8FC7`));
     return 0;
   }
   let hits = 0;
@@ -735,13 +736,13 @@ function verifyPlatform(platform, distDir, projectRoot) {
         hits++;
         perSig++;
         const rel = relative(projectRoot, file);
-        console.log(pc4.red(`  \u2717 [${platform}] \u547D\u4E2D\u7981\u7528 SDK \u7B7E\u540D ${pc4.bold(sig)}`));
-        console.log(pc4.gray(`      \u6587\u4EF6:${rel}`));
-        console.log(pc4.gray(`      \u7247\u6BB5:\u2026${snippetAround(text, idx)}\u2026`));
+        console.log(pc6.red(`  \u2717 [${platform}] \u547D\u4E2D\u7981\u7528 SDK \u7B7E\u540D ${pc6.bold(sig)}`));
+        console.log(pc6.gray(`      \u6587\u4EF6:${rel}`));
+        console.log(pc6.gray(`      \u7247\u6BB5:\u2026${snippetAround(text, idx)}\u2026`));
         from = idx + sig.length;
         idx = text.indexOf(sig, from);
         if (perSig >= 3 && idx !== -1) {
-          console.log(pc4.gray(`      (\u8BE5\u7B7E\u540D\u5728\u672C\u6587\u4EF6\u8FD8\u6709\u66F4\u591A\u547D\u4E2D,\u5DF2\u6298\u53E0)`));
+          console.log(pc6.gray(`      (\u8BE5\u7B7E\u540D\u5728\u672C\u6587\u4EF6\u8FD8\u6709\u66F4\u591A\u547D\u4E2D,\u5DF2\u6298\u53E0)`));
           break;
         }
       }
@@ -749,7 +750,7 @@ function verifyPlatform(platform, distDir, projectRoot) {
   }
   if (hits === 0) {
     console.log(
-      pc4.green(`  \u2713 [${platform}] \u9694\u79BB\u901A\u8FC7(\u626B\u63CF ${files.length} \u4E2A JS \u6587\u4EF6,\u65E0\u5176\u5B83\u5E73\u53F0 SDK \u7B7E\u540D)`)
+      pc6.green(`  \u2713 [${platform}] \u9694\u79BB\u901A\u8FC7(\u626B\u63CF ${files.length} \u4E2A JS \u6587\u4EF6,\u65E0\u5176\u5B83\u5E73\u53F0 SDK \u7B7E\u540D)`)
     );
   }
   return hits;
@@ -757,32 +758,32 @@ function verifyPlatform(platform, distDir, projectRoot) {
 function runVerifyIsolation(target) {
   const ctx = resolveProject();
   const targets = target ? isPlatform(target) ? [target] : invalidTarget2(target) : ALL_PLATFORMS;
-  console.log(pc4.cyan(pc4.bold("\u25B6 SDK \u9694\u79BB\u6821\u9A8C")));
+  console.log(pc6.cyan(pc6.bold("\u25B6 SDK \u9694\u79BB\u6821\u9A8C")));
   let totalHits = 0;
   for (const p of targets) {
     totalHits += verifyPlatform(p, join(ctx.root, "dist", p), ctx.root);
   }
   if (totalHits > 0) {
-    console.log(pc4.red(pc4.bold(`
+    console.log(pc6.red(pc6.bold(`
 \u2717 \u9694\u79BB\u6821\u9A8C\u5931\u8D25:\u5171\u53D1\u73B0 ${totalHits} \u5904\u8DE8\u5E73\u53F0 SDK \u7B7E\u540D\u6CC4\u6F0F`)));
     return false;
   }
-  console.log(pc4.green(pc4.bold("\n\u2713 \u9694\u79BB\u6821\u9A8C\u5168\u90E8\u901A\u8FC7")));
+  console.log(pc6.green(pc6.bold("\n\u2713 \u9694\u79BB\u6821\u9A8C\u5168\u90E8\u901A\u8FC7")));
   return true;
 }
 function verifyIsolationPlatform(platform, distDir, projectRoot) {
-  console.log(pc4.cyan(pc4.bold("\u25B6 SDK \u9694\u79BB\u6821\u9A8C")));
+  console.log(pc6.cyan(pc6.bold("\u25B6 SDK \u9694\u79BB\u6821\u9A8C")));
   const hits = verifyPlatform(platform, distDir, projectRoot);
   if (hits > 0) {
-    console.log(pc4.red(pc4.bold(`\u2717 \u9694\u79BB\u6821\u9A8C\u5931\u8D25:${hits} \u5904\u8DE8\u5E73\u53F0 SDK \u7B7E\u540D\u6CC4\u6F0F`)));
+    console.log(pc6.red(pc6.bold(`\u2717 \u9694\u79BB\u6821\u9A8C\u5931\u8D25:${hits} \u5904\u8DE8\u5E73\u53F0 SDK \u7B7E\u540D\u6CC4\u6F0F`)));
     return false;
   }
-  console.log(pc4.green(pc4.bold("\u2713 \u9694\u79BB\u6821\u9A8C\u901A\u8FC7")));
+  console.log(pc6.green(pc6.bold("\u2713 \u9694\u79BB\u6821\u9A8C\u901A\u8FC7")));
   return true;
 }
 function invalidTarget2(target) {
-  console.log(pc4.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
-  console.log(pc4.gray(`\u53EF\u9009:${ALL_PLATFORMS.join(" / ")}`));
+  console.log(pc6.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
+  console.log(pc6.gray(`\u53EF\u9009:${ALL_PLATFORMS.join(" / ")}`));
   process.exit(1);
 }
 
@@ -928,7 +929,7 @@ function findFirstHtml(dir) {
   return void 0;
 }
 async function buildPlatform(platform, ctx, config, vite) {
-  console.log(pc4.bgCyan(pc4.black(` \u6784\u5EFA\u5E73\u53F0:${platform} `)));
+  console.log(pc6.bgCyan(pc6.black(` \u6784\u5EFA\u5E73\u53F0:${platform} `)));
   const cache = cacheDir(ctx.root);
   fse4.ensureDirSync(cache);
   const hash = randomBytes(4).toString("hex");
@@ -948,7 +949,7 @@ async function buildPlatform(platform, ctx, config, vite) {
       tempFiles.push(htmlPath);
       inputFile = htmlPath;
     }
-    console.log(pc4.cyan(`  \u25B6 [${platform}] vite build`));
+    console.log(pc6.cyan(`  \u25B6 [${platform}] vite build`));
     const inlineConfig = createPlatformConfig(platform, {
       projectRoot: ctx.root,
       viteRoot: platform === "wechat" ? ctx.root : cache,
@@ -961,22 +962,22 @@ async function buildPlatform(platform, ctx, config, vite) {
     if (platform !== "wechat") {
       normalizeHtmlOutput(distDir);
     }
-    console.log(pc4.green(`    \u2713 [${platform}] vite build \u5B8C\u6210 \u2192 ${relative(ctx.root, distDir)}`));
+    console.log(pc6.green(`    \u2713 [${platform}] vite build \u5B8C\u6210 \u2192 ${relative(ctx.root, distDir)}`));
     const injectOk = injectShell({ platform, projectRoot: ctx.root, distDir, config });
     const sizeOk = sizeCheckPlatform(platform, distDir);
     const isoOk = verifyIsolationPlatform(platform, distDir, ctx.root);
     const allOk = injectOk && sizeOk && isoOk;
     if (allOk) {
-      console.log(pc4.green(pc4.bold(`\u2713 [${platform}] \u6784\u5EFA + \u6821\u9A8C\u5B8C\u6210 \u2192 ${relative(ctx.root, distDir)}
+      console.log(pc6.green(pc6.bold(`\u2713 [${platform}] \u6784\u5EFA + \u6821\u9A8C\u5B8C\u6210 \u2192 ${relative(ctx.root, distDir)}
 `)));
     } else {
-      console.log(pc4.red(pc4.bold(`\u2717 [${platform}] \u6821\u9A8C/\u6CE8\u5165\u672A\u5168\u90E8\u901A\u8FC7
+      console.log(pc6.red(pc6.bold(`\u2717 [${platform}] \u6821\u9A8C/\u6CE8\u5165\u672A\u5168\u90E8\u901A\u8FC7
 `)));
     }
     return allOk;
   } catch (e) {
-    console.log(pc4.red(`  \u2717 [${platform}] vite build \u5931\u8D25:${e.message}`));
-    if (e.stack) console.log(pc4.gray(e.stack ?? ""));
+    console.log(pc6.red(`  \u2717 [${platform}] vite build \u5931\u8D25:${e.message}`));
+    if (e.stack) console.log(pc6.gray(e.stack ?? ""));
     return false;
   } finally {
     for (const f of tempFiles) {
@@ -989,37 +990,37 @@ async function buildPlatform(platform, ctx, config, vite) {
 }
 async function runBuild(target) {
   if (!target) {
-    console.log(pc4.red("\u7528\u6CD5:pf build <web|tiktok|wechat|facebook|capacitor|all>"));
+    console.log(pc6.red("\u7528\u6CD5:pf build <web|tiktok|wechat|facebook|capacitor|all>"));
     return false;
   }
   const platforms = target === "all" ? ALL_PLATFORMS : isPlatform(target) ? [target] : null;
   if (!platforms) {
-    console.log(pc4.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
-    console.log(pc4.gray(`\u53EF\u9009:${ALL_PLATFORMS.join(" / ")} / all`));
+    console.log(pc6.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
+    console.log(pc6.gray(`\u53EF\u9009:${ALL_PLATFORMS.join(" / ")} / all`));
     return false;
   }
   const ctx = resolveProject();
   const config = await loadPlatformConfig(ctx);
   const vite = await loadViteFromRoot(ctx.root);
-  console.log(pc4.cyan(pc4.bold(`\u25B6 \u5F00\u59CB\u6784\u5EFA:${platforms.join(", ")}(\u9879\u76EE:${ctx.root})
+  console.log(pc6.cyan(pc6.bold(`\u25B6 \u5F00\u59CB\u6784\u5EFA:${platforms.join(", ")}(\u9879\u76EE:${ctx.root})
 `)));
   const results = [];
   for (const p of platforms) {
     results.push({ platform: p, ok: await buildPlatform(p, ctx, config, vite) });
   }
-  console.log(pc4.cyan(pc4.bold("\u25B6 \u6784\u5EFA\u6C47\u603B")));
+  console.log(pc6.cyan(pc6.bold("\u25B6 \u6784\u5EFA\u6C47\u603B")));
   let allOk = true;
   for (const r of results) {
-    if (r.ok) console.log(pc4.green(`  \u2713 ${r.platform}`));
+    if (r.ok) console.log(pc6.green(`  \u2713 ${r.platform}`));
     else {
-      console.log(pc4.red(`  \u2717 ${r.platform}`));
+      console.log(pc6.red(`  \u2717 ${r.platform}`));
       allOk = false;
     }
   }
   if (!allOk) {
-    console.log(pc4.red(pc4.bold("\n\u2717 \u5B58\u5728\u6784\u5EFA/\u6821\u9A8C\u5931\u8D25\u7684\u5E73\u53F0")));
+    console.log(pc6.red(pc6.bold("\n\u2717 \u5B58\u5728\u6784\u5EFA/\u6821\u9A8C\u5931\u8D25\u7684\u5E73\u53F0")));
   } else {
-    console.log(pc4.green(pc4.bold("\n\u2713 \u5168\u90E8\u5B8C\u6210")));
+    console.log(pc6.green(pc6.bold("\n\u2713 \u5168\u90E8\u5B8C\u6210")));
   }
   return allOk;
 }
@@ -1043,8 +1044,8 @@ function renderHtmlShell2(platform, config, scriptSrc) {
 async function runDev(target) {
   const platform = target ? isPlatform(target) ? target : invalidTarget3(target) : "web";
   if (platform === "wechat") {
-    console.log(pc4.red("\u2717 wechat \u65E0 HTML dev server \u5F62\u6001\u3002"));
-    console.log(pc4.yellow("  \u8BF7\u7528 `pf build wechat` \u4EA7\u51FA dist/wechat,\u518D\u7528\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177\u6253\u5F00\u9884\u89C8\u3002"));
+    console.log(pc6.red("\u2717 wechat \u65E0 HTML dev server \u5F62\u6001\u3002"));
+    console.log(pc6.yellow("  \u8BF7\u7528 `pf build wechat` \u4EA7\u51FA dist/wechat,\u518D\u7528\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177\u6253\u5F00\u9884\u89C8\u3002"));
     return false;
   }
   const ctx = resolveProject();
@@ -1096,9 +1097,9 @@ async function runDev(target) {
     await server.listen();
     const info = server.resolvedUrls;
     const url = info?.local?.[0] ?? "http://localhost:5173/";
-    console.log(pc4.green(pc4.bold(`\u25B6 [${platform}] dev server \u5C31\u7EEA`)));
-    console.log(`  \u6253\u5F00:${pc4.cyan(url)}`);
-    console.log(pc4.gray("  (Ctrl+C \u9000\u51FA,\u4E34\u65F6\u5165\u53E3\u4F1A\u81EA\u52A8\u6E05\u7406)"));
+    console.log(pc6.green(pc6.bold(`\u25B6 [${platform}] dev server \u5C31\u7EEA`)));
+    console.log(`  \u6253\u5F00:${pc6.cyan(url)}`);
+    console.log(pc6.gray("  (Ctrl+C \u9000\u51FA,\u4E34\u65F6\u5165\u53E3\u4F1A\u81EA\u52A8\u6E05\u7406)"));
     const onExit = async () => {
       cleanup();
       await server.close();
@@ -1109,17 +1110,227 @@ async function runDev(target) {
     return true;
   } catch (e) {
     cleanup();
-    console.log(pc4.red(`\u2717 dev server \u542F\u52A8\u5931\u8D25:${e.message}`));
+    console.log(pc6.red(`\u2717 dev server \u542F\u52A8\u5931\u8D25:${e.message}`));
     return false;
   }
 }
 function invalidTarget3(target) {
-  console.log(pc4.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
+  console.log(pc6.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
+  process.exit(1);
+}
+var CONTENT_TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".mjs": "text/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".wasm": "application/wasm"
+};
+function serveDist(distDir) {
+  const server = http.createServer((req, res) => {
+    let p = decodeURIComponent((req.url ?? "/").split("?")[0]);
+    if (p === "/") p = "/index.html";
+    if (p === "/favicon.ico") {
+      res.statusCode = 204;
+      res.end();
+      return;
+    }
+    const fp = join(distDir, p);
+    if (!resolve(fp).startsWith(resolve(distDir))) {
+      res.statusCode = 403;
+      res.end("forbidden");
+      return;
+    }
+    readFile(fp, (err, data) => {
+      if (err) {
+        res.statusCode = 404;
+        res.end("not found");
+        return;
+      }
+      res.setHeader("Content-Type", CONTENT_TYPES[extname(fp).toLowerCase()] ?? "application/octet-stream");
+      res.end(data);
+    });
+  });
+  return new Promise((r) => {
+    server.listen(0, "127.0.0.1", () => {
+      const addr = server.address();
+      const port = typeof addr === "object" && addr ? addr.port : 0;
+      r({ server, port });
+    });
+  });
+}
+function resolvePlaywright(root) {
+  const req = createRequire(join(root, "package.json"));
+  for (const name of ["playwright", "playwright-core", "@playwright/test"]) {
+    try {
+      const mod = req(name);
+      if (mod && mod.chromium) return { chromium: mod.chromium };
+    } catch {
+    }
+  }
+  return null;
+}
+async function readViewport(ctx) {
+  try {
+    const mod = await loadConfigModule(ctx.root, ctx.gameConfigPath);
+    const cfg = mod.gameConfig ?? mod.default ?? {};
+    const width = Number(cfg.designWidth) || 720;
+    const height = Number(cfg.designHeight) || 1280;
+    return { width, height };
+  } catch {
+    return { width: 720, height: 1280 };
+  }
+}
+async function runVerify(target, opts = {}) {
+  const platform = target ? isPlatform(target) ? target : invalid(target) : "web";
+  if (platform === "wechat") {
+    console.log(pc6.yellow("\u26A0 wechat \u65E0 DOM\u3001\u9700\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177,\u65E0\u6CD5\u7528\u6D4F\u89C8\u5668 verify\u3002"));
+    console.log(pc6.gray("  \u8BF7 `pf build wechat` \u540E\u7528\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177\u6253\u5F00 dist/wechat \u9884\u89C8\u9A8C\u8BC1\u3002"));
+    return false;
+  }
+  const ctx = resolveProject();
+  const pw = resolvePlaywright(ctx.root);
+  if (!pw) {
+    console.log(pc6.red("\u2717 pf verify \u9700\u8981 Playwright(\u53EF\u9009\u4F9D\u8D56,\u672A\u5B89\u88C5)\u3002"));
+    console.log(pc6.yellow("  \u5B89\u88C5:") + pc6.cyan(" npm i -D playwright"));
+    console.log(pc6.gray("  \u6D4F\u89C8\u5668\u4F18\u5148\u7528\u7CFB\u7EDF Chrome(channel:chrome),\u901A\u5E38\u65E0\u9700 `npx playwright install`\u3002"));
+    return false;
+  }
+  if (!opts.noBuild) {
+    console.log(pc6.cyan(pc6.bold(`\u25B6 [verify] \u5148\u6784\u5EFA ${platform}`)));
+    const built = await runBuild(platform);
+    if (!built) {
+      console.log(pc6.red("\u2717 [verify] \u6784\u5EFA\u5931\u8D25,\u7EC8\u6B62\u9A8C\u8BC1"));
+      return false;
+    }
+  }
+  const distDir = resolve(ctx.root, "dist", platform);
+  if (!existsSync(join(distDir, "index.html"))) {
+    console.log(pc6.red(`\u2717 [verify] \u627E\u4E0D\u5230 ${join(distDir, "index.html")}(\u5148 build \u6216\u53BB\u6389 --no-build)`));
+    return false;
+  }
+  const viewport = await readViewport(ctx);
+  const { server, port } = await serveDist(distDir);
+  const url = `http://127.0.0.1:${port}/`;
+  console.log(pc6.cyan(pc6.bold(`\u25B6 [verify] \u65E0\u5934\u6D4F\u89C8\u5668\u6253\u5F00 ${platform} \u4EA7\u7269`)));
+  const launchArgs = [
+    "--no-sandbox",
+    "--use-gl=angle",
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--ignore-gpu-blocklist"
+  ];
+  let browser;
+  try {
+    browser = await pw.chromium.launch({ channel: "chrome", headless: true, args: launchArgs });
+  } catch {
+    try {
+      browser = await pw.chromium.launch({ headless: true, args: launchArgs });
+    } catch (e) {
+      server.close();
+      console.log(pc6.red(`\u2717 [verify] \u6D4F\u89C8\u5668\u542F\u52A8\u5931\u8D25:${e.message}`));
+      console.log(pc6.yellow("  \u88C5\u7CFB\u7EDF Chrome,\u6216\u8FD0\u884C `npx playwright install chromium`\u3002"));
+      return false;
+    }
+  }
+  const errors = [];
+  let rendered = false;
+  let distinctColors = 0;
+  let canvasInView = false;
+  let canvasInfo = null;
+  const outDir = join(ctx.root, ".pf-verify");
+  mkdirSync(outDir, { recursive: true });
+  const shot = join(outDir, `${platform}.png`);
+  try {
+    const page = await browser.newPage({ viewport });
+    page.on("pageerror", (e) => errors.push("PAGEERROR: " + e.message));
+    page.on("console", (m) => {
+      if (m.type() === "error" && !/favicon/i.test(m.text())) errors.push("CONSOLE: " + m.text());
+    });
+    await page.goto(url, { waitUntil: "load", timeout: 3e4 });
+    for (let i = 0; i < 20; i++) {
+      await page.waitForTimeout(1e3);
+      const buf = await page.screenshot({ type: "png" }).catch(() => null);
+      if (buf) writeFileSync(shot, buf);
+      if (buf) {
+        const dataUrl = "data:image/png;base64," + buf.toString("base64");
+        distinctColors = await page.evaluate(async (u) => {
+          const img = new Image();
+          img.src = u;
+          await img.decode();
+          const cv = document.createElement("canvas");
+          cv.width = img.width;
+          cv.height = img.height;
+          const cx = cv.getContext("2d");
+          if (!cx) return 0;
+          cx.drawImage(img, 0, 0);
+          const data = cx.getImageData(0, 0, cv.width, cv.height).data;
+          const colors = /* @__PURE__ */ new Set();
+          const total = cv.width * cv.height;
+          const step = Math.max(1, Math.floor(total / 5e3));
+          for (let k = 0; k < total && colors.size < 40; k += step) {
+            const o = k * 4;
+            colors.add(`${data[o]},${data[o + 1]},${data[o + 2]}`);
+          }
+          return colors.size;
+        }, dataUrl).catch(() => 0);
+      }
+      const vis = await page.evaluate(() => {
+        const c = document.querySelector("canvas");
+        if (!c) return { has: false, inView: false, w: 0, h: 0 };
+        const r = c.getBoundingClientRect();
+        const st = getComputedStyle(c);
+        const inView = r.bottom > 0 && r.right > 0 && r.top < innerHeight && r.left < innerWidth && r.width > 1 && r.height > 1 && st.display !== "none" && st.visibility !== "hidden" && Number(st.opacity) > 0;
+        return { has: true, inView, w: Math.round(r.width), h: Math.round(r.height) };
+      }).catch(() => ({ has: false, inView: false, w: 0, h: 0 }));
+      canvasInfo = vis.has ? { w: vis.w, h: vis.h } : canvasInfo;
+      canvasInView = vis.inView;
+      if (distinctColors > 3 && canvasInView) {
+        rendered = true;
+        break;
+      }
+    }
+    console.log(pc6.gray(`  \u622A\u56FE(\u5C4F\u5E55\u5B9E\u62CD):${shot}`));
+  } catch (e) {
+    errors.push("VERIFY: " + e.message);
+  } finally {
+    await browser.close();
+    server.close();
+  }
+  const ok = errors.length === 0 && rendered;
+  console.log("");
+  console.log(pc6.bold("\u25B6 [verify] \u7ED3\u679C"));
+  console.log(
+    `  canvas:${canvasInfo ? `${canvasInfo.w}\xD7${canvasInfo.h}` : "\u65E0"};\u5728\u89C6\u53E3\u5185:${canvasInView ? "\u662F" : "\u5426"};\u5C4F\u5E55\u989C\u8272\u6570:${distinctColors}(>3 \u89C6\u4E3A\u5DF2\u6E32\u67D3)`
+  );
+  if (errors.length) {
+    console.log(pc6.red(`  \u63A7\u5236\u53F0/\u9875\u9762\u9519\u8BEF(${errors.length}):`));
+    errors.slice(0, 12).forEach((e) => console.log(pc6.red("    " + e)));
+  } else {
+    console.log(pc6.green("  \u65E0\u63A7\u5236\u53F0/\u9875\u9762\u9519\u8BEF"));
+  }
+  if (ok) {
+    console.log(pc6.green(pc6.bold(`
+\u2713 [verify] ${platform} \u5B9E\u8DD1\u901A\u8FC7(\u5C4F\u5E55\u6E32\u67D3\u6B63\u5E38\u3001\u65E0\u8FD0\u884C\u671F\u9519\u8BEF)`)));
+  } else {
+    const reason = errors.length ? "\u5B58\u5728\u8FD0\u884C\u671F\u9519\u8BEF" : !canvasInView ? "canvas \u4E0D\u5728\u89C6\u53E3\u5185(\u88AB\u5E03\u5C40\u63A8\u51FA\u5C4F\u5E55/\u9690\u85CF \u2192 \u7528\u6237\u770B\u5230\u9ED1\u5C4F)" : "\u5C4F\u5E55\u753B\u9762\u672A\u6E32\u67D3\u51FA\u5185\u5BB9(\u7591\u4F3C\u5D29\u6E83/\u9ED1\u5C4F)";
+    console.log(pc6.red(pc6.bold(`
+\u2717 [verify] ${platform} \u672A\u901A\u8FC7:${reason}`)));
+  }
+  return ok;
+}
+function invalid(target) {
+  console.log(pc6.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
   process.exit(1);
 }
 function spawnCap(projectRoot, args) {
   const npx = process.platform === "win32" ? "npx.cmd" : "npx";
-  console.log(pc4.gray(`    $ ${npx} cap ${args.join(" ")}`));
+  console.log(pc6.gray(`    $ ${npx} cap ${args.join(" ")}`));
   const res = spawnSync(npx, ["cap", ...args], {
     cwd: projectRoot,
     stdio: "inherit",
@@ -1127,9 +1338,9 @@ function spawnCap(projectRoot, args) {
     shell: process.platform === "win32"
   });
   if (res.error) {
-    console.log(pc4.red(`    \u2717 \u6267\u884C\u5931\u8D25:${res.error.message}`));
+    console.log(pc6.red(`    \u2717 \u6267\u884C\u5931\u8D25:${res.error.message}`));
     console.log(
-      pc4.yellow(
+      pc6.yellow(
         "      \u8BF7\u786E\u8BA4\u5DF2\u5B89\u88C5 Capacitor CLI:npm i -D @capacitor/cli @capacitor/android @capacitor/ios"
       )
     );
@@ -1140,11 +1351,11 @@ function spawnCap(projectRoot, args) {
 function runCap(action, platform) {
   const ctx = resolveProject();
   if (action === "sync") {
-    console.log(pc4.cyan(pc4.bold("\u25B6 Capacitor sync")));
+    console.log(pc6.cyan(pc6.bold("\u25B6 Capacitor sync")));
     const distDir = resolve(ctx.root, "dist", "capacitor");
     if (!fse4.existsSync(distDir)) {
-      console.log(pc4.red("\u2717 dist/capacitor \u4E0D\u5B58\u5728"));
-      console.log(pc4.yellow("  \u8BF7\u5148\u6784\u5EFA:pf build capacitor"));
+      console.log(pc6.red("\u2717 dist/capacitor \u4E0D\u5B58\u5728"));
+      console.log(pc6.yellow("  \u8BF7\u5148\u6784\u5EFA:pf build capacitor"));
       return false;
     }
     const args = platform ? ["sync", platform] : ["sync"];
@@ -1152,13 +1363,13 @@ function runCap(action, platform) {
   }
   if (action === "open") {
     if (platform !== "android" && platform !== "ios") {
-      console.log(pc4.red("\u2717 open \u9700\u6307\u5B9A\u5E73\u53F0:pf cap open <android|ios>"));
+      console.log(pc6.red("\u2717 open \u9700\u6307\u5B9A\u5E73\u53F0:pf cap open <android|ios>"));
       return false;
     }
-    console.log(pc4.cyan(pc4.bold(`\u25B6 Capacitor open ${platform}`)));
+    console.log(pc6.cyan(pc6.bold(`\u25B6 Capacitor open ${platform}`)));
     return capExec(ctx.root, ["open", platform]);
   }
-  console.log(pc4.red("\u7528\u6CD5:"));
+  console.log(pc6.red("\u7528\u6CD5:"));
   console.log("  pf cap sync [android|ios]");
   console.log("  pf cap open <android|ios>");
   return false;
@@ -1197,35 +1408,43 @@ async function main(argv = process.argv.slice(2)) {
         process.exitCode = ok ? 0 : 1;
         return;
       }
+      case "verify": {
+        const noBuild = rest.includes("--no-build");
+        const platform = rest.find((a) => !a.startsWith("-"));
+        const ok = await runVerify(platform, { noBuild });
+        process.exitCode = ok ? 0 : 1;
+        return;
+      }
       case "cap": {
         const ok = runCap(rest[0], rest[1]);
         process.exitCode = ok ? 0 : 1;
         return;
       }
       default: {
-        console.log(pc4.yellow(`[pf] \u672A\u77E5\u547D\u4EE4 "${command}"\u3002`));
-        console.log(pc4.dim("\u8FD0\u884C `pf help` \u67E5\u770B\u53EF\u7528\u547D\u4EE4\u3002"));
+        console.log(pc6.yellow(`[pf] \u672A\u77E5\u547D\u4EE4 "${command}"\u3002`));
+        console.log(pc6.dim("\u8FD0\u884C `pf help` \u67E5\u770B\u53EF\u7528\u547D\u4EE4\u3002"));
         process.exitCode = 1;
       }
     }
   } catch (e) {
-    console.log(pc4.red(`[pf] \u6267\u884C "${command}" \u51FA\u9519:${e.message}`));
-    if (e.stack) console.log(pc4.gray(e.stack ?? ""));
+    console.log(pc6.red(`[pf] \u6267\u884C "${command}" \u51FA\u9519:${e.message}`));
+    if (e.stack) console.log(pc6.gray(e.stack ?? ""));
     process.exitCode = 1;
   }
 }
 function printHelp() {
-  console.log(pc4.bold("@maoyugames/phaser-framework CLI (pf)"));
-  console.log(pc4.dim("\u591A\u5E73\u53F0 Phaser \u6846\u67B6\u6784\u5EFA\u5DE5\u5177\u3002"));
+  console.log(pc6.bold("@maoyugames/phaser-framework CLI (pf)"));
+  console.log(pc6.dim("\u591A\u5E73\u53F0 Phaser \u6846\u67B6\u6784\u5EFA\u5DE5\u5177\u3002"));
   console.log("");
   console.log("\u547D\u4EE4:");
-  console.log(`  ${pc4.cyan("pf dev [platform]")}                \u542F\u52A8\u67D0\u5E73\u53F0 dev server(\u9ED8\u8BA4 web)`);
-  console.log(`  ${pc4.cyan("pf build <platform|all>")}          \u6784\u5EFA\u67D0\u5E73\u53F0/\u5168\u90E8\u5E73\u53F0`);
-  console.log(`  ${pc4.cyan("pf size-check [platform]")}         \u4EA7\u7269\u4F53\u79EF\u68C0\u67E5`);
-  console.log(`  ${pc4.cyan("pf verify-isolation [platform]")}   SDK \u9694\u79BB\u6821\u9A8C`);
-  console.log(`  ${pc4.cyan("pf cap <sync|open> [android|ios]")} Capacitor \u539F\u751F\u5DE5\u7A0B\u64CD\u4F5C`);
+  console.log(`  ${pc6.cyan("pf dev [platform]")}                \u542F\u52A8\u67D0\u5E73\u53F0 dev server(\u9ED8\u8BA4 web)`);
+  console.log(`  ${pc6.cyan("pf build <platform|all>")}          \u6784\u5EFA\u67D0\u5E73\u53F0/\u5168\u90E8\u5E73\u53F0`);
+  console.log(`  ${pc6.cyan("pf size-check [platform]")}         \u4EA7\u7269\u4F53\u79EF\u68C0\u67E5`);
+  console.log(`  ${pc6.cyan("pf verify-isolation [platform]")}   SDK \u9694\u79BB\u6821\u9A8C`);
+  console.log(`  ${pc6.cyan("pf verify [platform] [--no-build]")} \u5B9E\u8DD1\u5192\u70DF\u9A8C\u8BC1(Playwright \u65E0\u5934:\u6E32\u67D3+\u65E0\u8FD0\u884C\u671F\u9519\u8BEF)`);
+  console.log(`  ${pc6.cyan("pf cap <sync|open> [android|ios]")} Capacitor \u539F\u751F\u5DE5\u7A0B\u64CD\u4F5C`);
   console.log("");
-  console.log(pc4.dim("\u5E73\u53F0:web / tiktok / wechat / facebook / capacitor"));
+  console.log(pc6.dim("\u5E73\u53F0:web / tiktok / wechat / facebook / capacitor"));
 }
 void main();
 

package/dist/index.js

@@ -2091,6 +2091,15 @@ var AccountService = class {
   }
 };
 
+// src/scene/active-scene.ts
+var _active = null;
+function setActiveScene(scene) {
+  _active = scene;
+}
+function getActiveScene() {
+  return _active;
+}
+
 // src/services/SceneManager.ts
 var SceneManager = class {
   constructor() {
@@ -2108,19 +2117,18 @@ var SceneManager = class {
       return;
     }
     const sceneData = asSceneData(data);
-    const all = manager.getScenes(false);
-    const vehicle = all.find((s) => s.scene.key !== key);
-    for (const scene of all) {
-      const sceneKey = scene.scene.key;
-      if (sceneKey !== key && scene !== vehicle) {
-        manager.stop(sceneKey);
+    const active = getActiveScene();
+    if (active && active.scene && typeof active.scene.start === "function") {
+      for (const scene of manager.getScenes(true)) {
+        const sceneKey = scene.scene.key;
+        if (sceneKey !== key && scene !== active) {
+          manager.stop(sceneKey);
+        }
       }
+      active.scene.start(key, sceneData);
+      return;
     }
-    if (vehicle) {
-      vehicle.scene.start(key, sceneData);
-    } else {
-      manager.start(key, sceneData);
-    }
+    manager.start(key, sceneData);
   }
   push(key, data) {
     const manager = this.game?.scene;
@@ -2868,9 +2876,6 @@ var PanelManager = class {
     return actives[actives.length - 1];
   }
 };
-
-// src/bootstrap.ts
-var _game = null;
 async function startGame(opts) {
   const { platform, config, scenes } = opts;
   PlatformContext.set(platform);
@@ -2932,31 +2937,40 @@ async function startGame(opts) {
     await opts.setup(App);
   }
   log.info(`[bootstrap] \u5E73\u53F0 ${platform.info.name} \u521D\u59CB\u5316\u5B8C\u6210,\u542F\u52A8 Phaser`);
-  _game = await createPhaserGame(config, scenes);
-  audio.bindGame(_game);
-  sceneManager.bindGame(_game);
-  panelManager.bindGame(_game);
+  const game = createPhaserGameInstance(config, scenes);
+  audio.bindGame(game);
+  sceneManager.bindGame(game);
+  panelManager.bindGame(game);
+  await waitForGameReady(game);
   await App.modules.initAll();
   log.info("[bootstrap] \u6E38\u620F\u542F\u52A8\u5B8C\u6210");
 }
-function createPhaserGame(config, scenes) {
+function createPhaserGameInstance(config, scenes) {
+  const gameConfig = {
+    type: Phaser4.AUTO,
+    // 关键:把 canvas 挂进各平台外壳的 #game-root(外壳已为它写好布局/居中 CSS)。
+    // 不设 parent 时 Phaser 把 canvas 追加到 document.body —— 而外壳里 #game-root 占满
+    // 100% 高度,canvas 作为其后的块级兄弟会被挤到视口外,再被 body 的 overflow:hidden
+    // 裁掉 → 屏幕全黑(但 canvas 后备缓冲其实已渲染,故 toDataURL/getImageData 读不出问题)。
+    // wechat 无 DOM(weapp-adapter),'game-root' 不存在时 Phaser 自动回退,安全。
+    parent: "game-root",
+    // 透明背景占位;业务场景自行绘制背景
+    backgroundColor: "#1f2937",
+    scale: {
+      // FIT:按设计分辨率等比缩放铺满容器(保持比例,留黑边);CENTER_BOTH:居中
+      mode: Phaser4.Scale.FIT,
+      autoCenter: Phaser4.Scale.CENTER_BOTH,
+      width: config.designWidth,
+      height: config.designHeight
+    },
+    scene: scenes
+    // 微信等无 DOM 平台由 weapp-adapter 提供 canvas;有 DOM 平台 Phaser 自动建 canvas
+  };
+  return new Phaser4.Game(gameConfig);
+}
+function waitForGameReady(game) {
   return new Promise((resolve) => {
-    const gameConfig = {
-      type: Phaser4.AUTO,
-      // 透明背景占位;业务场景自行绘制背景
-      backgroundColor: "#1f2937",
-      scale: {
-        // FIT:按设计分辨率等比缩放铺满容器(保持比例,留黑边);CENTER_BOTH:居中
-        mode: Phaser4.Scale.FIT,
-        autoCenter: Phaser4.Scale.CENTER_BOTH,
-        width: config.designWidth,
-        height: config.designHeight
-      },
-      scene: scenes
-      // 微信等无 DOM 平台由 weapp-adapter 提供 canvas;有 DOM 平台 Phaser 自动建 canvas
-    };
-    const game = new Phaser4.Game(gameConfig);
-    game.events.once(Phaser4.Core.Events.READY, () => resolve(game));
+    game.events.once(Phaser4.Core.Events.READY, () => resolve());
   });
 }
 
@@ -3094,6 +3108,7 @@ var BaseScene = class extends Phaser4.Scene {
    * 注意:业务场景若覆写 init(data),请调用 super.init(data) 以保留自动清理(this.bind / this.scheduler)。
    */
   init(_data) {
+    setActiveScene(this);
     this.armCleanupHooks();
   }
   /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maoyugames/phaser-framework",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "多平台 Phaser 游戏框架:业务/底层分离,HTTP/WebSocket/KCP,Web/TikTok/微信/Facebook/App 隔离打包",
   "type": "module",
   "license": "MIT",
@@ -53,11 +53,15 @@
     "phaser": "^3.60.0 || ^3.80.0 || ^3.90.0",
     "vite": "^5.0.0",
     "typescript": "^5.0.0",
-    "terser": "^5.0.0"
+    "terser": "^5.0.0",
+    "playwright": "^1.40.0"
   },
   "peerDependenciesMeta": {
     "terser": {
       "optional": true
+    },
+    "playwright": {
+      "optional": true
     }
   },
   "dependencies": {