pixifact-cli 0.17.0 → 0.18.0

package/README.md

@@ -122,6 +122,10 @@ pixifact dev --mode douyin
 
 Web mode 只需要 `pixifact`，不安装小游戏平台包也能构建。`dev` 默认 mode 为 `development`，`build` 和 `validate` 默认为 `production`；显式 `--mode` 原样交给 Vite。默认产物目录为 `dist/<platform>/`，需要修改时使用 Vite `build.outDir`。
 
+`pixifact dev` 的 Web 开发服务默认监听所有网络接口，启动 JSON 的 `urls.local` 和 `urls.network` 分别提供本机与局域网游戏地址；同一局域网的手机或电脑可直接打开 `urls.network` 中的 URL。项目在 `vite.config.ts` 显式设置的 `server.host` 会优先使用，例如 `server: { host: '127.0.0.1' }` 只监听本机。
+
+`pixifact dev` 同时自动启用 Bun Inspector，默认监听 `0.0.0.0`，端口由系统分配；项目的 `dev` 脚本直接调用 `pixifact dev` 即可。远程调试时，将 Bun 输出的 WebSocket 或浏览器调试链接中的 `0.0.0.0` 替换为开发电脑的局域网 IP，保留端口和路径。若启动 Bun 时已指定 `--inspect`、`--inspect-brk` 或 `--inspect-wait`（包括自定义地址），CLI 使用已有调试参数。
+
 CLI 使用 Vite 完成 env、TypeScript、tree-shaking、watch、静态资源和产物生命周期；Pixifact 插件负责 Scene 编译、当前平台虚拟模块、Pixi manifest、资源分包、原生配置和包体检查。业务代码只使用 PixiJS `Assets`，不需要手动加载分包。
 
 完整配置见 [微信小游戏构建](https://github.com/hxg2050/pixifact/blob/main/docs/zh/wechat-minigame.md) 和 [抖音小游戏构建](https://github.com/hxg2050/pixifact/blob/main/docs/zh/douyin-minigame.md)，可运行三端示例见 [wechat-minigame-demo](https://github.com/hxg2050/pixifact/tree/main/sample-projects/wechat-minigame-demo)。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixifact-cli",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Pixifact Scene 自动化 CLI。",
   "packageManager": "bun@1.3.13",
   "type": "module",
@@ -32,7 +32,7 @@
     "start": "bun src/pixifact-cli.ts"
   },
   "dependencies": {
-    "pixifact": "^0.17.0",
+    "pixifact": "^0.18.0",
     "playwright": "1.58.2",
     "vite": "^8.0.10"
   }

package/src/pixifact-cli.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 import fs from 'node:fs';
 import path from 'node:path';
-import { pathToFileURL } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { createPixifactAutomation } from './automation';
 import { hintForCommandError } from 'pixifact';
 import { CompileSceneError, compileScenes } from 'pixifact/compiler-node';
@@ -50,6 +50,7 @@ interface ParsedArgs {
 }
 
 const runtimeScreenshotDefaultOutput = '.pixifact/runtime/frame.png';
+const isCliEntrypoint = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
 
 function parseArgs(argv: string[]): ParsedArgs {
     const positionals: string[] = [];
@@ -440,6 +441,7 @@ async function executeFileCommand(
                     mode,
                     watching: true,
                     report: session.initialReport,
+                    urls: session.urls,
                 };
             } catch (error) {
                 if (error instanceof PixifactTargetError) {
@@ -611,6 +613,30 @@ export async function executePixifactCli(argv: string[], options: CliOptions = {
             };
         }
 
+        if (isCliEntrypoint
+            && parsed.positionals.length === 1
+            && parsed.positionals[0] === 'dev'
+            && !process.execArgv.some((arg) => /^--inspect(?:-brk|-wait)?(?:=|$)/.test(arg))) {
+            assertAllowedFlags(parsed.flags, ['mode', 'project-root'], 'dev');
+            const child = Bun.spawn([
+                process.execPath,
+                ...process.execArgv,
+                '--inspect=0.0.0.0:0',
+                fileURLToPath(import.meta.url),
+                ...argv,
+            ], { stdin: 'inherit', stdout: 'inherit', stderr: 'inherit' });
+            const interrupt = () => child.kill('SIGINT');
+            const terminate = () => child.kill('SIGTERM');
+            process.on('SIGINT', interrupt);
+            process.on('SIGTERM', terminate);
+            try {
+                return { exitCode: await child.exited, stdout: '', stderr: '' };
+            } finally {
+                process.off('SIGINT', interrupt);
+                process.off('SIGTERM', terminate);
+            }
+        }
+
         const automation = options.automation ?? createPixifactAutomation();
         const result = await executeFileCommand(
             parsed.positionals,
@@ -650,7 +676,7 @@ export async function executePixifactCli(argv: string[], options: CliOptions = {
     }
 }
 
-if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+if (isCliEntrypoint) {
     const result = await executePixifactCli(process.argv.slice(2), {
         onDevEvent: (event) => process.stdout.write(jsonLine(event)),
     });

package/src/viteTarget.ts

@@ -4,6 +4,7 @@ import {
     build,
     createServer,
     resolveConfig,
+    type ResolvedServerUrls,
     type Rollup,
 } from 'vite';
 import {
@@ -42,6 +43,7 @@ export interface PixifactDevSession {
     close(): Promise<void>;
     initialReport: PixifactBuildReport;
     platform: PixifactPlatform;
+    urls?: ResolvedServerUrls | null;
 }
 
 export class PixifactTargetError extends Error {
@@ -123,12 +125,17 @@ export async function devPixifactTarget(
             root: validation.projectRoot,
             mode,
             logLevel: 'silent',
+            plugins: [{
+                name: 'pixifact-dev-host',
+                config: (config) => ({ server: { host: config.server?.host ?? true } }),
+            }],
         });
         await server.listen();
         return {
             close: () => server.close(),
             initialReport: emptyReport('web', validation.resolved.build.outDir),
             platform: 'web',
+            urls: server.resolvedUrls,
         };
     }
     let resolveInitial: (report: PixifactBuildReport) => void;