@maoyugames/phaser-framework 1.0.0

package/dist/cli/index.js

@@ -0,0 +1,1219 @@
+#!/usr/bin/env node
+import '../chunk-PKBMQBKP.js';
+import pc4 from 'picocolors';
+import { resolve, join, 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 { spawnSync } from 'child_process';
+
+// src/cli/platforms-meta.ts
+var ALL_PLATFORMS = ["web", "tiktok", "wechat", "facebook", "capacitor"];
+var ISOLATION_RULES = {
+  web: {
+    // 标准 H5,不该含任何小游戏 SDK 适配
+    forbidden: [
+      "TTMinis.game",
+      "FBInstant.player",
+      "FBInstant.initializeAsync",
+      "wx.connectSocket",
+      "wx.request",
+      "wx.setStorageSync",
+      "wx.requestMidasPayment"
+    ]
+  },
+  tiktok: {
+    // TikTok 包不得含微信 / Facebook
+    forbidden: [
+      "FBInstant.player",
+      "FBInstant.initializeAsync",
+      "wx.connectSocket",
+      "wx.request",
+      "wx.setStorageSync",
+      "wx.requestMidasPayment"
+    ]
+  },
+  wechat: {
+    // 微信包不得含 TikTok / Facebook
+    forbidden: ["TTMinis.game", "FBInstant.player", "FBInstant.initializeAsync", "FBInstant.payments"]
+  },
+  facebook: {
+    // Facebook 包不得含 TikTok / 微信
+    forbidden: ["TTMinis.game", "wx.connectSocket", "wx.request", "wx.setStorageSync", "wx.requestMidasPayment"]
+  },
+  capacitor: {
+    // 原生 App 包不得含任何小游戏 SDK 适配
+    forbidden: [
+      "TTMinis.game",
+      "FBInstant.player",
+      "FBInstant.initializeAsync",
+      "wx.connectSocket",
+      "wx.request",
+      "wx.setStorageSync",
+      "wx.requestMidasPayment"
+    ]
+  }
+};
+var MB = 1024 * 1024;
+var SIZE_LIMITS = {
+  // TikTok 整包硬上限 50MB
+  tiktok: { totalHardLimit: 50 * MB },
+  // 微信主包建议 ≤ 4MB(分包另算,给提示而非硬失败)
+  wechat: { mainBundleSoftLimit: 4 * MB }
+};
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < MB) return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / MB).toFixed(2)} MB`;
+}
+function isPlatform(value) {
+  return ALL_PLATFORMS.includes(value);
+}
+var FRAMEWORK_PKG = "@maoyugames/phaser-framework";
+function findProjectRoot(startDir = process.cwd()) {
+  let dir = resolve(startDir);
+  while (true) {
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        const deps = {
+          ...pkg.dependencies,
+          ...pkg.devDependencies,
+          ...pkg.peerDependencies
+        };
+        if (deps[FRAMEWORK_PKG]) {
+          return dir;
+        }
+      } catch {
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  throw new Error(
+    `\u672A\u627E\u5230\u7528\u6237\u9879\u76EE\u6839:\u4ECE ${startDir} \u5411\u4E0A\u672A\u627E\u5230\u4F9D\u8D56 ${FRAMEWORK_PKG} \u7684 package.json\u3002
+\u8BF7\u5728\u542B\u8BE5\u4F9D\u8D56\u7684\u9879\u76EE\u76EE\u5F55\u5185\u8FD0\u884C pf\u3002`
+  );
+}
+function readFrameworkVersion() {
+  let dir = dirname(fileURLToPath(import.meta.url));
+  while (true) {
+    const pkgPath = join(dir, "package.json");
+    if (existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        if (pkg.name === FRAMEWORK_PKG && pkg.version) {
+          return pkg.version;
+        }
+      } catch {
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return "0.0.0";
+}
+function resolveProject(startDir = process.cwd()) {
+  const root = findProjectRoot(startDir);
+  const gameConfigPath = join(root, "game.config.ts");
+  const platformConfigPath = join(root, "platform.config.ts");
+  if (!existsSync(gameConfigPath)) {
+    throw new Error(`\u7F3A\u5C11\u4E1A\u52A1\u914D\u7F6E:${gameConfigPath}
+\u8BF7\u5728\u9879\u76EE\u6839\u521B\u5EFA game.config.ts \u5E76\u5BFC\u51FA gameConfig\u3002`);
+  }
+  if (!existsSync(platformConfigPath)) {
+    throw new Error(
+      `\u7F3A\u5C11\u5E73\u53F0\u914D\u7F6E:${platformConfigPath}
+\u8BF7\u5728\u9879\u76EE\u6839\u521B\u5EFA platform.config.ts \u5E76 export default { ... } satisfies PlatformConfig\u3002`
+    );
+  }
+  return {
+    root,
+    gameConfigPath,
+    platformConfigPath,
+    frameworkVersion: readFrameworkVersion()
+  };
+}
+async function loadViteFromRoot(root) {
+  const requireFromRoot = createRequire(join(root, "package.json"));
+  const viteEntry = requireFromRoot.resolve("vite");
+  const mod = await import(pathToFileUrl(viteEntry));
+  const ns = mod && typeof mod.createServer === "function" ? mod : mod.default ?? mod;
+  if (typeof ns.build !== "function") {
+    throw new Error("\u65E0\u6CD5\u4ECE\u7528\u6237\u9879\u76EE\u52A0\u8F7D Vite(createServer/build \u4E0D\u53EF\u7528)\u3002\u8BF7\u786E\u8BA4\u5DF2\u5B89\u88C5 vite \u4F9D\u8D56\u3002");
+  }
+  return ns;
+}
+async function loadConfigModule(root, filePath) {
+  const vite = await loadViteFromRoot(root);
+  const server = await vite.createServer({
+    root,
+    // 仅用于 SSR 加载配置,不需要监听端口
+    server: { middlewareMode: true, hmr: false },
+    appType: "custom",
+    logLevel: "silent",
+    // 配置文件加载阶段不需要用户项目的 vite.config(若有也无妨,这里关闭以隔离副作用)
+    configFile: false
+  });
+  try {
+    const mod = await server.ssrLoadModule(filePath);
+    return mod;
+  } finally {
+    await server.close();
+  }
+}
+async function loadPlatformConfig(ctx) {
+  const mod = await loadConfigModule(ctx.root, ctx.platformConfigPath);
+  const cfg = mod.default ?? mod;
+  if (!cfg || typeof cfg !== "object") {
+    throw new Error(`platform.config.ts \u672A\u9ED8\u8BA4\u5BFC\u51FA PlatformConfig \u5BF9\u8C61:${ctx.platformConfigPath}`);
+  }
+  return cfg;
+}
+function pathToFileUrl(p) {
+  const resolved = resolve(p);
+  const normalized = resolved.replace(/\\/g, "/");
+  return normalized.startsWith("/") ? `file://${normalized}` : `file:///${normalized}`;
+}
+
+// src/cli/entry-template.ts
+var PLATFORM_CLASS = {
+  web: "WebPlatform",
+  tiktok: "TikTokPlatform",
+  wechat: "WeChatPlatform",
+  facebook: "FacebookPlatform",
+  capacitor: "CapacitorPlatform"
+};
+function renderEntry(opts) {
+  const { platform, projectRoot } = opts;
+  const cls = PLATFORM_CLASS[platform];
+  const gameConfigImport = JSON.stringify(toImportPath(`${projectRoot}/game.config`));
+  return `/**
+ * pf \u81EA\u52A8\u751F\u6210\u7684\u4E34\u65F6\u5355\u5E73\u53F0\u5165\u53E3(${platform})\u3002
+ * \u7531 CLI \u5728\u6784\u5EFA/dev \u65F6\u751F\u6210\u4E8E node_modules/.cache/pf/,\u6784\u5EFA\u540E\u81EA\u52A8\u6E05\u7406,\u8BF7\u52FF\u624B\u6539\u3002
+ */
+import { startGame } from ${JSON.stringify(FRAMEWORK_PKG)};
+import { ${cls} } from ${JSON.stringify(`${FRAMEWORK_PKG}/platform/${platform}`)};
+import { gameConfig } from ${gameConfigImport};
+import { scenes } from '@game/scenes';
+import { setupGame } from '@game/setup';
+
+void startGame({ platform: new ${cls}(), config: gameConfig, scenes, setup: setupGame });
+`;
+}
+function toImportPath(p) {
+  return p.replace(/\\/g, "/");
+}
+function createAlias(projectRoot) {
+  return [
+    // @game(整词)→ src/game/index?(用户通常用 @game/xxx,这里整词兜底到 src/game 目录)
+    { find: /^@game$/, replacement: resolve(projectRoot, "src/game") },
+    // @game/xxx → src/game/xxx
+    { find: /^@game\//, replacement: resolve(projectRoot, "src/game") + "/" }
+  ];
+}
+function createPlatformConfig(platform, opts) {
+  const { projectRoot, entryFile, frameworkVersion } = opts;
+  const dev = opts.dev ?? false;
+  const outDir = resolve(projectRoot, "dist", platform);
+  const publicDir = resolve(projectRoot, "src/game/public");
+  const base = {
+    root: opts.viteRoot,
+    // 资源用相对路径,适配 webview / file:// / 小游戏本地包加载;web 可被 opts.base 覆盖
+    base: opts.base ?? "./",
+    // 业务静态资源(配置表 JSON 等)整目录复制到产物根;wechat 在下面关闭并由 inject 手动拷
+    publicDir,
+    configFile: false,
+    logLevel: dev ? "info" : "warn",
+    define: {
+      __PLATFORM__: JSON.stringify(platform),
+      __DEV__: JSON.stringify(dev),
+      __FRAMEWORK_VERSION__: JSON.stringify(frameworkVersion)
+    },
+    resolve: {
+      alias: createAlias(projectRoot)
+    },
+    esbuild: {
+      // 兼容低端 webview / 小游戏 JS 引擎
+      target: "es2019"
+    },
+    envPrefix: ["VITE_"],
+    build: {
+      target: "es2019",
+      outDir,
+      emptyOutDir: !dev,
+      // 生产统一用 terser:压缩比稳定、可去 console/debugger,便于体积控制
+      minify: dev ? false : "terser",
+      terserOptions: {
+        compress: {
+          drop_console: !dev,
+          drop_debugger: !dev
+        },
+        format: {
+          comments: false
+        }
+      },
+      // 资源内联阈值:小图标内联减少请求,大资源走文件
+      assetsInlineLimit: 4096,
+      // phaser 较大,放宽 chunk 体积警告阈值(单位 KB)
+      chunkSizeWarningLimit: 4096,
+      rollupOptions: {
+        input: entryFile
+      }
+    }
+  };
+  if (platform === "wechat") {
+    return applyWechatOverrides(base, entryFile, outDir);
+  }
+  return base;
+}
+function applyWechatOverrides(base, entryFile, outDir) {
+  return {
+    ...base,
+    publicDir: false,
+    build: {
+      ...base.build,
+      outDir,
+      emptyOutDir: base.build?.emptyOutDir,
+      lib: {
+        entry: entryFile,
+        // CommonJS,供 game.js 用 require 加载
+        formats: ["cjs"],
+        fileName: () => "game.bundle.js"
+      },
+      rollupOptions: {
+        // 不 external 任何依赖:phaser 等全部打进 bundle
+        external: [],
+        output: {
+          // 强制单 chunk,杜绝动态 import 拆包(小游戏主包加载单文件)
+          inlineDynamicImports: true,
+          manualChunks: void 0,
+          entryFileNames: "game.bundle.js"
+        }
+      }
+    }
+  };
+}
+
+// src/cli/shells/html-util.ts
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function escapeAttr(s) {
+  return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+}
+
+// src/cli/shells/facebook.ts
+var DEFAULT_FB_SDK_VERSION = "7.1";
+function renderFacebookHtml(cfg, scriptSrc) {
+  const title = escapeHtml(cfg?.appName ?? "Facebook Instant Game");
+  const sdkVersion = (cfg?.fbSdkVersion ?? DEFAULT_FB_SDK_VERSION).trim();
+  const sdkSrc = `https://connect.facebook.net/en_US/fbinstant.${sdkVersion}.js`;
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover"
+    />
+    <title>${title}</title>
+    <style>
+      html,
+      body {
+        margin: 0;
+        padding: 0;
+        width: 100%;
+        height: 100%;
+        background: #000;
+        overflow: hidden;
+        box-sizing: border-box;
+      }
+      #game-root {
+        width: 100%;
+        height: 100%;
+      }
+      #game-root canvas {
+        display: block;
+        margin: 0 auto;
+      }
+    </style>
+  </head>
+  <body>
+    <!--
+      Facebook Instant Games SDK \u6CE8\u5165(\u7248\u672C\u6765\u81EA platform.config.facebook.fbSdkVersion)\u3002
+      \u5FC5\u987B\u5728\u6E38\u620F\u811A\u672C\u4E4B\u524D\u52A0\u8F7D,\u8FD0\u884C\u65F6\u901A\u8FC7\u5168\u5C40 FBInstant.* \u8C03\u7528\u6865\u63A5\u80FD\u529B\u3002
+    -->
+    <script src="${escapeAttr(sdkSrc)}"></script>
+
+    <!-- \u6E38\u620F\u753B\u5E03\u6302\u8F7D\u70B9 -->
+    <div id="game-root"></div>
+    <!-- Facebook \u5E73\u53F0\u5165\u53E3:\u4EC5\u9759\u6001 import Facebook \u9002\u914D\u5668 -->
+    <script type="module" src="${scriptSrc}"></script>
+  </body>
+</html>
+`;
+}
+function renderFacebookAppConfig(cfg) {
+  const orientation = (cfg?.orientation ?? "portrait").toUpperCase();
+  const obj = {
+    instant_games: {
+      platform_version: "RICH_GAMEPLAY",
+      orientation
+    },
+    app_id: cfg?.appId ?? "YOUR_FB_APP_ID",
+    app_name: cfg?.appName ?? "Phaser Instant Game"
+  };
+  return {
+    relPath: "fbapp-config.json",
+    content: JSON.stringify(obj, null, 2) + "\n"
+  };
+}
+
+// src/cli/shells/capacitor.ts
+function renderCapacitorHtml(cfg, scriptSrc) {
+  const title = escapeHtml(cfg?.appName ?? "Game App");
+  return `<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover"
+    />
+    <title>${title}</title>
+    <style>
+      html,
+      body {
+        margin: 0;
+        padding: 0;
+        width: 100%;
+        height: 100%;
+        background: #000;
+        overflow: hidden;
+        /* \u539F\u751F App webview \u5B89\u5168\u533A\u9002\u914D */
+        padding: env(safe-area-inset-top) env(safe-area-inset-right)
+          env(safe-area-inset-bottom) env(safe-area-inset-left);
+        box-sizing: border-box;
+      }
+      #game-root {
+        width: 100%;
+        height: 100%;
+      }
+      #game-root canvas {
+        display: block;
+        margin: 0 auto;
+      }
+    </style>
+  </head>
+  <body>
+    <!--
+      Capacitor \u539F\u751F App(iOS + Android)\u5916\u58F3\u3002
+      Capacitor \u8FD0\u884C\u65F6\u7531\u539F\u751F\u5BB9\u5668\u5728 webview \u6CE8\u5165\u5168\u5C40 window.Capacitor \u4E0E\u5DF2\u5B89\u88C5\u63D2\u4EF6;
+      \u6B64\u5904\u65E0\u9700 <script> \u6CE8\u5165 SDK,\u9002\u914D\u5668\u8FD0\u884C\u65F6\u63A2\u6D4B Capacitor \u5BF9\u8C61,\u7F3A\u5931\u5219\u4F18\u96C5\u964D\u7EA7\u3002
+    -->
+    <div id="game-root"></div>
+    <!-- Capacitor \u5E73\u53F0\u5165\u53E3:\u4EC5\u9759\u6001 import Capacitor \u9002\u914D\u5668 -->
+    <script type="module" src="${scriptSrc}"></script>
+  </body>
+</html>
+`;
+}
+function renderCapacitorConfig(cfg) {
+  const appId = cfg?.appId ?? "com.example.app";
+  const appName = cfg?.appName ?? "App";
+  return `/**
+ * Capacitor \u914D\u7F6E(\u7531 pf \u4ECE platform.config.capacitor \u81EA\u52A8\u751F\u6210)\u3002
+ *
+ * - appId / appName \u6765\u81EA\u9879\u76EE\u6839 platform.config.ts \u7684 capacitor \u6BB5\u3002
+ * - webDir \u6307\u5411 Vite \u6784\u5EFA\u4EA7\u7269 dist/capacitor:\`pf build capacitor\` \u4EA7\u51FA\u540E,
+ *   \`pf cap sync\` \u4F1A\u628A\u5B83\u540C\u6B65\u8FDB android / ios \u539F\u751F\u5DE5\u7A0B\u3002
+ *
+ * \u672C\u6587\u4EF6\u7531 CLI \u751F\u6210,\u624B\u6539\u4F1A\u5728\u4E0B\u6B21 build \u65F6\u88AB\u8986\u76D6;\u5982\u9700\u5B9A\u5236\u8BF7\u6539 platform.config.ts\u3002
+ */
+import type { CapacitorConfig } from '@capacitor/cli';
+
+const config: CapacitorConfig = {
+  appId: ${JSON.stringify(appId)},
+  appName: ${JSON.stringify(appName)},
+  // \u76F8\u5BF9\u9879\u76EE\u6839:Vite \u628A capacitor \u4EA7\u7269\u8F93\u51FA\u5230 dist/capacitor
+  webDir: 'dist/capacitor',
+  server: {
+    androidScheme: 'https',
+  },
+};
+
+export default config;
+`;
+}
+
+// src/cli/shells/wechat.ts
+function renderGameJs() {
+  return `/**
+ * \u5FAE\u4FE1\u5C0F\u6E38\u620F\u5165\u53E3(\u4F4D\u4E8E dist/wechat/game.js,\u7531 pf \u751F\u6210)\u3002
+ *
+ * \u52A0\u8F7D\u987A\u5E8F\u81F3\u5173\u91CD\u8981:
+ *  1. \u5148 require('./weapp-adapter.js'):\u5FAE\u4FE1\u5B98\u65B9\u9002\u914D\u5668,\u5728\u65E0 DOM \u7684\u5C0F\u6E38\u620F\u8FD0\u884C\u65F6\u91CC
+ *     \u6CE8\u5165 window / document / canvas / Image / localStorage \u7B49\u6D4F\u89C8\u5668 shim\u3002
+ *  2. \u518D require('./game.bundle.js'):Vite lib \u6A21\u5F0F\u6253\u51FA\u7684\u6E38\u620F\u4E3B bundle(CommonJS,
+ *     \u4EC5\u542B\u5FAE\u4FE1\u9002\u914D\u5668)\u3002
+ *
+ * weapp-adapter.js / symbol.js \u7531 pf \u5728\u6784\u5EFA\u65F6\u4ECE\u7528\u6237\u9879\u76EE wechat vendor \u76EE\u5F55\u62F7\u5165;
+ * \u7F3A\u5931\u65F6 CLI \u4F1A\u9192\u76EE\u8B66\u544A(\u5FAE\u4FE1\u8FD0\u884C\u65F6\u627E\u4E0D\u5230\u8BE5\u6587\u4EF6\u4F1A\u542F\u52A8\u5373\u62A5\u9519)\u3002
+ */
+require('./weapp-adapter.js');
+require('./game.bundle.js');
+`;
+}
+function renderGameJson(cfg) {
+  const orientation = cfg?.orientation ?? "portrait";
+  const obj = {
+    deviceOrientation: orientation,
+    showStatusBar: false,
+    networkTimeout: {
+      request: 1e4,
+      connectSocket: 1e4,
+      uploadFile: 1e4,
+      downloadFile: 1e4
+    },
+    workerSize: 1,
+    subpackages: [],
+    plugins: {},
+    openDataContext: ""
+  };
+  return JSON.stringify(obj, null, 2) + "\n";
+}
+function renderProjectConfig(cfg) {
+  const obj = {
+    appid: cfg?.appid ?? "wxYOUR_APPID",
+    projectname: cfg?.projectname ?? "phaser-wechat-minigame",
+    compileType: "game",
+    setting: {
+      es6: false,
+      enhance: false,
+      postcss: false,
+      minified: false,
+      uglifyFileName: false,
+      uploadWithSourceMap: true,
+      checkSiteMap: false,
+      babelSetting: {
+        ignore: [],
+        disablePlugins: [],
+        outputPath: ""
+      }
+    },
+    compileLifecycle: {},
+    libVersion: "latest",
+    condition: {}
+  };
+  return JSON.stringify(obj, null, 2) + "\n";
+}
+function renderWeChatShells(cfg) {
+  return [
+    { relPath: "game.js", content: renderGameJs() },
+    { relPath: "game.json", content: renderGameJson(cfg) },
+    { relPath: "project.config.json", content: renderProjectConfig(cfg) }
+  ];
+}
+
+// src/cli/inject.ts
+function wechatVendorDirs(projectRoot) {
+  return [resolve(projectRoot, "wechat/vendor"), resolve(projectRoot, "platforms/wechat/vendor")];
+}
+function writeShellFiles(distDir, projectRoot, files) {
+  for (const f of 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)}`));
+  }
+}
+function injectShell(opts) {
+  const { platform, projectRoot, distDir, config } = opts;
+  switch (platform) {
+    case "web":
+    case "tiktok":
+      return true;
+    case "facebook": {
+      console.log(pc4.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)`));
+      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)}`));
+      return true;
+    }
+    case "wechat": {
+      console.log(pc4.cyan(`  \u25B6 [wechat] \u6CE8\u5165\u5916\u58F3\u6587\u4EF6`));
+      writeShellFiles(distDir, projectRoot, renderWeChatShells(config.wechat));
+      copyPublicAssetsToWechat(projectRoot, distDir);
+      copyWechatVendor(projectRoot, distDir);
+      return true;
+    }
+    default:
+      return true;
+  }
+}
+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)"));
+  fse4.copySync(srcPublic, distDir);
+  console.log(pc4.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)"));
+  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"));
+    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"));
+    }
+    return true;
+  }
+  console.log(pc4.yellow(pc4.bold("    \u26A0 \u7F3A\u5C11\u5FAE\u4FE1\u9002\u914D\u5668 weapp-adapter.js")));
+  console.log(
+    pc4.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:`));
+  for (const d of wechatVendorDirs(projectRoot)) {
+    console.log(pc4.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")
+  );
+  return false;
+}
+function listFiles(dir) {
+  const out = [];
+  if (!fse4.existsSync(dir)) return out;
+  for (const name of fse4.readdirSync(dir)) {
+    const full = join(dir, name);
+    const st = fse4.statSync(full);
+    if (st.isDirectory()) out.push(...listFiles(full));
+    else out.push({ path: full, size: st.size });
+  }
+  return out;
+}
+function findMainBundle(files) {
+  const wechatBundle = files.find((f) => basename(f.path) === "game.bundle.js");
+  if (wechatBundle) return wechatBundle;
+  const jsFiles = files.filter((f) => /\.js$/i.test(f.path));
+  if (jsFiles.length === 0) return void 0;
+  return jsFiles.reduce((max, f) => f.size > max.size ? f : max, jsFiles[0]);
+}
+function checkPlatform(platform, distDir) {
+  if (!fse4.existsSync(distDir)) {
+    console.log(pc4.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)`);
+  if (main2) {
+    console.log(`    \u4E3B bundle:${basename(main2.path)} = ${pc4.bold(formatBytes(main2.size))}`);
+  }
+  let ok = true;
+  if (limits?.totalHardLimit) {
+    if (total > limits.totalHardLimit) {
+      console.log(
+        pc4.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)})`)
+      );
+    }
+  }
+  if (limits?.mainBundleSoftLimit && main2) {
+    if (main2.size > limits.mainBundleSoftLimit) {
+      console.log(
+        pc4.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)})`)
+      );
+    }
+  }
+  return ok;
+}
+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")));
+  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)")));
+    return false;
+  }
+  console.log(pc4.green(pc4.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")));
+  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")));
+  return ok;
+}
+function invalidTarget(target) {
+  console.log(pc4.red(`\u672A\u77E5\u5E73\u53F0:${target}`));
+  console.log(pc4.gray(`\u53EF\u9009:${ALL_PLATFORMS.join(" / ")}`));
+  process.exit(1);
+}
+function collectJsFiles(dir) {
+  const out = [];
+  if (!fse4.existsSync(dir)) return out;
+  for (const name of fse4.readdirSync(dir)) {
+    const full = join(dir, name);
+    const st = fse4.statSync(full);
+    if (st.isDirectory()) out.push(...collectJsFiles(full));
+    else if (/\.(js|mjs|cjs)$/i.test(name)) out.push(full);
+  }
+  return out;
+}
+function snippetAround(text, index, span = 60) {
+  const start = Math.max(0, index - span);
+  const end = Math.min(text.length, index + span);
+  return text.slice(start, end).replace(/\s+/g, " ").trim();
+}
+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`));
+    return 0;
+  }
+  const files = collectJsFiles(distDir);
+  if (files.length === 0) {
+    console.log(pc4.yellow(`  [${platform}] \u672A\u53D1\u73B0 JS \u4EA7\u7269,\u8DF3\u8FC7`));
+    return 0;
+  }
+  let hits = 0;
+  for (const file of files) {
+    const text = fse4.readFileSync(file, "utf-8");
+    for (const sig of rules.forbidden) {
+      let from = 0;
+      let idx = text.indexOf(sig, from);
+      let perSig = 0;
+      while (idx !== -1) {
+        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`));
+        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)`));
+          break;
+        }
+      }
+    }
+  }
+  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)`)
+    );
+  }
+  return hits;
+}
+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")));
+  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(`
+\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")));
+  return true;
+}
+function verifyIsolationPlatform(platform, distDir, projectRoot) {
+  console.log(pc4.cyan(pc4.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`)));
+    return false;
+  }
+  console.log(pc4.green(pc4.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(" / ")}`));
+  process.exit(1);
+}
+
+// src/cli/shells/web.ts
+function renderWebHtml(cfg, scriptSrc) {
+  const title = escapeHtml(cfg?.title ?? "Phaser Game");
+  return `<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover"
+    />
+    <title>${title}</title>
+    <style>
+      html,
+      body {
+        margin: 0;
+        padding: 0;
+        width: 100%;
+        height: 100%;
+        background: #000;
+        overflow: hidden;
+        /* \u5B89\u5168\u533A:\u5218\u6D77\u5C4F / \u5706\u89D2\u5C4F\u9002\u914D */
+        padding: env(safe-area-inset-top) env(safe-area-inset-right)
+          env(safe-area-inset-bottom) env(safe-area-inset-left);
+        box-sizing: border-box;
+      }
+      #game-root {
+        width: 100%;
+        height: 100%;
+      }
+      #game-root canvas {
+        display: block;
+        margin: 0 auto;
+      }
+    </style>
+  </head>
+  <body>
+    <!-- \u6E38\u620F\u753B\u5E03\u6302\u8F7D\u70B9 -->
+    <div id="game-root"></div>
+    <!-- Web \u5E73\u53F0\u5165\u53E3:\u4EC5\u9759\u6001 import Web \u9002\u914D\u5668,\u6784\u5EFA\u540E\u88AB\u66FF\u6362\u4E3A\u6253\u5305\u811A\u672C -->
+    <script type="module" src="${scriptSrc}"></script>
+  </body>
+</html>
+`;
+}
+
+// src/cli/shells/tiktok.ts
+var DEFAULT_SDK_URL = "https://developers.tiktok.com/js/minis.js";
+function renderTikTokHtml(cfg, scriptSrc) {
+  const title = escapeHtml(cfg?.title ?? "TikTok Mini Game");
+  const sdkUrl = cfg?.sdkUrl ?? DEFAULT_SDK_URL;
+  const sdkTag = sdkUrl ? `<!--
+      TikTok Mini Games(Minis)SDK \u6CE8\u5165(\u5730\u5740\u6765\u81EA platform.config.tiktok.sdkUrl)\u3002
+      \u5FC5\u987B\u5728\u6E38\u620F\u811A\u672C\u4E4B\u524D\u52A0\u8F7D,\u8FD0\u884C\u65F6\u901A\u8FC7\u5168\u5C40 TTMinis.game.* \u8C03\u7528\u6865\u63A5\u80FD\u529B\u3002
+    -->
+    <script src="${escapeAttr(sdkUrl)}"></script>` : "";
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover"
+    />
+    <title>${title}</title>
+    <style>
+      html,
+      body {
+        margin: 0;
+        padding: 0;
+        width: 100%;
+        height: 100%;
+        background: #000;
+        overflow: hidden;
+        box-sizing: border-box;
+      }
+      #game-root {
+        width: 100%;
+        height: 100%;
+      }
+      #game-root canvas {
+        display: block;
+        margin: 0 auto;
+      }
+    </style>
+  </head>
+  <body>
+    ${sdkTag}
+
+    <!-- \u6E38\u620F\u753B\u5E03\u6302\u8F7D\u70B9 -->
+    <div id="game-root"></div>
+    <!-- TikTok \u5E73\u53F0\u5165\u53E3:\u4EC5\u9759\u6001 import TikTok \u9002\u914D\u5668 -->
+    <script type="module" src="${scriptSrc}"></script>
+  </body>
+</html>
+`;
+}
+
+// src/cli/commands/build.ts
+function cacheDir(projectRoot) {
+  return resolve(projectRoot, "node_modules/.cache/pf");
+}
+function renderHtmlShell(platform, config, scriptSrc) {
+  switch (platform) {
+    case "web":
+      return renderWebHtml(config.web, scriptSrc);
+    case "tiktok":
+      return renderTikTokHtml(config.tiktok, scriptSrc);
+    case "facebook":
+      return renderFacebookHtml(config.facebook, scriptSrc);
+    case "capacitor":
+      return renderCapacitorHtml(config.capacitor, scriptSrc);
+    default:
+      throw new Error(`renderHtmlShell \u4E0D\u652F\u6301\u5E73\u53F0:${platform}`);
+  }
+}
+function normalizeHtmlOutput(distDir) {
+  const finalHtml = join(distDir, "index.html");
+  if (fse4.existsSync(finalHtml)) return;
+  const found = findFirstHtml(distDir);
+  if (found) {
+    fse4.moveSync(found, finalHtml, { overwrite: true });
+  }
+  const nm = join(distDir, "node_modules");
+  if (fse4.existsSync(nm)) {
+    fse4.removeSync(nm);
+  }
+}
+function findFirstHtml(dir) {
+  for (const name of fse4.readdirSync(dir)) {
+    const full = join(dir, name);
+    const st = fse4.statSync(full);
+    if (st.isDirectory()) {
+      const inner = findFirstHtml(full);
+      if (inner) return inner;
+    } else if (/\.html$/i.test(name)) {
+      return full;
+    }
+  }
+  return void 0;
+}
+async function buildPlatform(platform, ctx, config, vite) {
+  console.log(pc4.bgCyan(pc4.black(` \u6784\u5EFA\u5E73\u53F0:${platform} `)));
+  const cache = cacheDir(ctx.root);
+  fse4.ensureDirSync(cache);
+  const hash = randomBytes(4).toString("hex");
+  const entryFileName = `main.${platform}.${hash}.ts`;
+  const entryPath = join(cache, entryFileName);
+  fse4.writeFileSync(entryPath, renderEntry({ platform, projectRoot: ctx.root }), "utf-8");
+  const tempFiles = [entryPath];
+  const distDir = resolve(ctx.root, "dist", platform);
+  try {
+    let inputFile;
+    if (platform === "wechat") {
+      inputFile = entryPath;
+    } else {
+      const htmlName = `index.${platform}.${hash}.html`;
+      const htmlPath = join(cache, htmlName);
+      fse4.writeFileSync(htmlPath, renderHtmlShell(platform, config, `./${entryFileName}`), "utf-8");
+      tempFiles.push(htmlPath);
+      inputFile = htmlPath;
+    }
+    console.log(pc4.cyan(`  \u25B6 [${platform}] vite build`));
+    const inlineConfig = createPlatformConfig(platform, {
+      projectRoot: ctx.root,
+      viteRoot: platform === "wechat" ? ctx.root : cache,
+      entryFile: inputFile,
+      frameworkVersion: ctx.frameworkVersion,
+      dev: false,
+      base: platform === "web" ? config.web?.base : void 0
+    });
+    await vite.build(inlineConfig);
+    if (platform !== "wechat") {
+      normalizeHtmlOutput(distDir);
+    }
+    console.log(pc4.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)}
+`)));
+    } else {
+      console.log(pc4.red(pc4.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 ?? ""));
+    return false;
+  } finally {
+    for (const f of tempFiles) {
+      try {
+        fse4.removeSync(f);
+      } catch {
+      }
+    }
+  }
+}
+async function runBuild(target) {
+  if (!target) {
+    console.log(pc4.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`));
+    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})
+`)));
+  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")));
+  let allOk = true;
+  for (const r of results) {
+    if (r.ok) console.log(pc4.green(`  \u2713 ${r.platform}`));
+    else {
+      console.log(pc4.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")));
+  } else {
+    console.log(pc4.green(pc4.bold("\n\u2713 \u5168\u90E8\u5B8C\u6210")));
+  }
+  return allOk;
+}
+function cacheDir2(projectRoot) {
+  return resolve(projectRoot, "node_modules/.cache/pf");
+}
+function renderHtmlShell2(platform, config, scriptSrc) {
+  switch (platform) {
+    case "web":
+      return renderWebHtml(config.web, scriptSrc);
+    case "tiktok":
+      return renderTikTokHtml(config.tiktok, scriptSrc);
+    case "facebook":
+      return renderFacebookHtml(config.facebook, scriptSrc);
+    case "capacitor":
+      return renderCapacitorHtml(config.capacitor, scriptSrc);
+    default:
+      throw new Error(`dev \u4E0D\u652F\u6301\u5E73\u53F0:${platform}`);
+  }
+}
+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"));
+    return false;
+  }
+  const ctx = resolveProject();
+  const config = await loadPlatformConfig(ctx);
+  const vite = await loadViteFromRoot(ctx.root);
+  const cache = cacheDir2(ctx.root);
+  fse4.ensureDirSync(cache);
+  const hash = randomBytes(4).toString("hex");
+  const entryFileName = `main.${platform}.${hash}.ts`;
+  const entryPath = join(cache, entryFileName);
+  const htmlName = `index.${platform}.${hash}.html`;
+  const htmlPath = join(cache, htmlName);
+  fse4.writeFileSync(entryPath, renderEntry({ platform, projectRoot: ctx.root }), "utf-8");
+  fse4.writeFileSync(htmlPath, renderHtmlShell2(platform, config, `./${entryFileName}`), "utf-8");
+  const cleanup = () => {
+    for (const f of [entryPath, htmlPath]) {
+      try {
+        fse4.removeSync(f);
+      } catch {
+      }
+    }
+  };
+  try {
+    const server = await vite.createServer({
+      // root 设为缓存目录(临时 HTML 所在),入口页直接是 /index.<p>.<hash>.html;
+      // alias/publicDir 用绝对路径不受影响
+      root: cache,
+      base: "/",
+      configFile: false,
+      define: {
+        __PLATFORM__: JSON.stringify(platform),
+        __DEV__: JSON.stringify(true),
+        __FRAMEWORK_VERSION__: JSON.stringify(ctx.frameworkVersion)
+      },
+      resolve: {
+        alias: [
+          { find: /^@game$/, replacement: resolve(ctx.root, "src/game") },
+          { find: /^@game\//, replacement: resolve(ctx.root, "src/game") + "/" }
+        ]
+      },
+      publicDir: resolve(ctx.root, "src/game/public"),
+      server: { open: false }
+    });
+    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 + htmlName)}`);
+    console.log(pc4.gray("  (Ctrl+C \u9000\u51FA,\u4E34\u65F6\u5165\u53E3\u4F1A\u81EA\u52A8\u6E05\u7406)"));
+    const onExit = async () => {
+      cleanup();
+      await server.close();
+      process.exit(0);
+    };
+    process.on("SIGINT", onExit);
+    process.on("SIGTERM", onExit);
+    return true;
+  } catch (e) {
+    cleanup();
+    console.log(pc4.red(`\u2717 dev server \u542F\u52A8\u5931\u8D25:${e.message}`));
+    return false;
+  }
+}
+function invalidTarget3(target) {
+  console.log(pc4.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(" ")}`));
+  const res = spawnSync(npx, ["cap", ...args], {
+    cwd: projectRoot,
+    stdio: "inherit",
+    // Windows 下 .cmd 需要 shell:true 才能被解析
+    shell: process.platform === "win32"
+  });
+  if (res.error) {
+    console.log(pc4.red(`    \u2717 \u6267\u884C\u5931\u8D25:${res.error.message}`));
+    console.log(
+      pc4.yellow(
+        "      \u8BF7\u786E\u8BA4\u5DF2\u5B89\u88C5 Capacitor CLI:npm i -D @capacitor/cli @capacitor/android @capacitor/ios"
+      )
+    );
+    return 1;
+  }
+  return res.status ?? 1;
+}
+function runCap(action, platform) {
+  const ctx = resolveProject();
+  if (action === "sync") {
+    console.log(pc4.cyan(pc4.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"));
+      return false;
+    }
+    const args = platform ? ["sync", platform] : ["sync"];
+    return capExec(ctx.root, args);
+  }
+  if (action === "open") {
+    if (platform !== "android" && platform !== "ios") {
+      console.log(pc4.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}`)));
+    return capExec(ctx.root, ["open", platform]);
+  }
+  console.log(pc4.red("\u7528\u6CD5:"));
+  console.log("  pf cap sync [android|ios]");
+  console.log("  pf cap open <android|ios>");
+  return false;
+}
+function capExec(projectRoot, args) {
+  const code = spawnCap(projectRoot, args);
+  return code === 0;
+}
+
+// src/cli/index.ts
+async function main(argv = process.argv.slice(2)) {
+  const [command, ...rest] = argv;
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    printHelp();
+    return;
+  }
+  try {
+    switch (command) {
+      case "build": {
+        const ok = await runBuild(rest[0]);
+        process.exitCode = ok ? 0 : 1;
+        return;
+      }
+      case "dev": {
+        const ok = await runDev(rest[0]);
+        if (!ok) process.exitCode = 1;
+        return;
+      }
+      case "size-check": {
+        const ok = runSizeCheck(rest[0]);
+        process.exitCode = ok ? 0 : 1;
+        return;
+      }
+      case "verify-isolation": {
+        const ok = runVerifyIsolation(rest[0]);
+        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"));
+        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 ?? ""));
+    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("");
+  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("");
+  console.log(pc4.dim("\u5E73\u53F0:web / tiktok / wechat / facebook / capacitor"));
+}
+void main();
+
+export { main };