@playcraft/cli 0.0.15 → 0.0.18

package/dist/fs-handler.js

@@ -1,7 +1,13 @@
 import fs from 'fs/promises';
 import path from 'path';
+/** Maximum recursion depth for file search to prevent performance issues */
+const MAX_SEARCH_DEPTH = 10;
+/** Cache TTL in milliseconds (5 minutes) */
+const CACHE_TTL_MS = 5 * 60 * 1000;
 export class FSHandler {
     config;
+    /** Cache for file name to path mapping */
+    filePathCache = new Map();
     constructor(config) {
         this.config = config;
     }
@@ -93,6 +99,8 @@ export class FSHandler {
         else {
             await fs.writeFile(fullPath, content);
         }
+        // Invalidate cache for the affected file
+        this.invalidateCache(relativePath);
     }
     async deleteFile(relativePath) {
         if (!this.isSafePath(relativePath)) {
@@ -100,5 +108,114 @@ export class FSHandler {
         }
         const fullPath = path.join(this.config.dir, relativePath);
         await fs.unlink(fullPath);
+        // Invalidate cache for the deleted file
+        this.invalidateCache(relativePath);
+    }
+    /**
+     * Recursively search for a file by name within a directory.
+     * Returns the relative path if found, or null.
+     * Uses caching and depth limiting to optimize performance.
+     */
+    async findFileRecursive(dir, fileName) {
+        // Normalize directory path for consistent cache keys
+        const normalizedDir = this.normalizePath(dir);
+        // Check cache first
+        const cacheKey = `${normalizedDir}:${fileName}`;
+        const cached = this.filePathCache.get(cacheKey);
+        if (cached) {
+            // Validate cache entry is not expired
+            if (Date.now() - cached.timestamp < CACHE_TTL_MS) {
+                // Verify the cached path still exists
+                try {
+                    const fullPath = path.join(this.config.dir, cached.path);
+                    await fs.access(fullPath);
+                    return cached.path;
+                }
+                catch {
+                    // File no longer exists, remove from cache
+                    this.filePathCache.delete(cacheKey);
+                }
+            }
+            else {
+                // Cache expired
+                this.filePathCache.delete(cacheKey);
+            }
+        }
+        const result = await this.findFileRecursiveInternal(normalizedDir, fileName, 0);
+        // Cache the result if found
+        if (result) {
+            this.filePathCache.set(cacheKey, {
+                path: result,
+                timestamp: Date.now(),
+            });
+        }
+        return result;
+    }
+    /**
+     * Internal recursive search with depth limiting.
+     */
+    async findFileRecursiveInternal(dir, fileName, depth) {
+        // Limit recursion depth to prevent performance issues
+        if (depth >= MAX_SEARCH_DEPTH)
+            return null;
+        if (!this.isSafePath(dir))
+            return null;
+        const fullDir = path.join(this.config.dir, dir);
+        try {
+            const entries = await fs.readdir(fullDir, { withFileTypes: true });
+            // First pass: check files in current directory (breadth-first approach)
+            for (const entry of entries) {
+                if (entry.name.startsWith('.'))
+                    continue;
+                if (entry.isFile() && entry.name === fileName) {
+                    return path.posix.join(dir, entry.name);
+                }
+            }
+            // Second pass: recurse into subdirectories
+            for (const entry of entries) {
+                if (entry.name.startsWith('.'))
+                    continue;
+                if (entry.isDirectory()) {
+                    const rel = path.posix.join(dir, entry.name);
+                    const found = await this.findFileRecursiveInternal(rel, fileName, depth + 1);
+                    if (found)
+                        return found;
+                }
+            }
+        }
+        catch {
+            // ignore errors (e.g. permission denied)
+        }
+        return null;
+    }
+    /**
+     * Normalize path separators to forward slashes for consistent cache key matching.
+     */
+    normalizePath(p) {
+        return p.replace(/\\/g, '/');
+    }
+    /**
+     * Invalidate cache entries for a specific file path.
+     * Call this when files are written or deleted.
+     */
+    invalidateCache(relativePath) {
+        if (!relativePath) {
+            this.filePathCache.clear();
+            return;
+        }
+        // Normalize path separators for consistent matching
+        const normalizedPath = this.normalizePath(relativePath);
+        const fileName = path.basename(normalizedPath);
+        const dirName = path.dirname(normalizedPath);
+        // Build the exact cache key that would have been used
+        // Cache key format: "dir:fileName" (consistent with findFileRecursive)
+        const exactKey = `${dirName}:${fileName}`;
+        // Remove entries by exact key match or by result path match
+        for (const [key, entry] of this.filePathCache) {
+            const normalizedEntryPath = this.normalizePath(entry.path);
+            if (key === exactKey || normalizedEntryPath === normalizedPath) {
+                this.filePathCache.delete(key);
+            }
+        }
     }
 }

package/dist/index.js

@@ -10,6 +10,7 @@ import { statusCommand } from './commands/status.js';
 import { logsCommand } from './commands/logs.js';
 import { configCommand } from './commands/config.js';
 import { buildCommand } from './commands/build.js';
+import { buildAllCommand } from './commands/build-all.js';
 import { upgradeCommand } from './commands/upgrade.js';
 import { checkForUpdates } from './utils/version-checker.js';
 import { syncCommand } from './commands/sync.js';
@@ -124,18 +125,20 @@ program
     .command('build')
     .description('打包项目为 Playable Ad（自动执行基础构建和渠道打包）')
     .argument('[project-path]', '项目路径', process.cwd())
-    .option('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo)')
+    .option('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo|inmobi|adikteev|remerge|mintegral)')
     .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
     .option('-o, --output <path>', '输出目录', './dist')
     .option('-c, --config <file>', '配置文件路径')
-    .option('-s, --scenes <scenes>', '选择场景（逗号分隔），例如: MainMenu,Gameplay')
+    .option('-s, --scenes <scenes>', '选择场景（逗号分隔），例如: "Main Scene" 或 MainMenu,Gameplay')
+    .option('-e, --engine <engine>', '指定引擎类型 (playcanvas|phaser|pixijs|threejs|cocos|babylonjs|layaair|egret|generic)，默认自动检测')
     .option('--clean', '构建前清理旧的输出目录（默认启用）', true)
     .option('--no-clean', '跳过清理旧的输出目录')
-    .option('--compress', '压缩引擎代码（使用 LZ4）')
-    .option('--compress-config', '压缩 config.json（使用 LZ4，可减少 60-70% 体积）')
+    .option('--compress', '压缩引擎代码（使用 LZ4，仅 PlayCanvas）')
+    .option('--compress-config', '压缩 config.json（使用 LZ4，可减少 60-70% 体积，仅 PlayCanvas）')
+    .option('--compress-js', '压缩所有 JS 代码（LZ4 源码保护，浏览器中无法查看变量名和方法名）')
     .option('--analyze', '生成打包分析报告')
-    .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
-    .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')
+    .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon（仅 PlayCanvas）')
+    .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)，仅 PlayCanvas')
     .option('--auto-build', '如果是源代码项目，自动执行本地构建')
     .option('--skip-build', '跳过本地构建，直接从源代码打包（可能不完整）')
     .option('--mode <mode>', '构建模式 (full|base|playable)')
@@ -150,7 +153,7 @@ program
     .option('--image-quality <quality>', '图片质量 0-100（默认根据平台配置）', parseInt)
     .option('--convert-webp', '转换为 WebP 格式（默认启用）', true)
     .option('--no-convert-webp', '禁用 WebP 转换')
-    .option('--compress-models', '压缩 3D 模型（默认根据平台配置）')
+    .option('--compress-models', '压缩 3D 模型（默认根据平台配置，仅 PlayCanvas/Three.js/Babylon.js）')
     .option('--no-compress-models', '禁用模型压缩')
     .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
     .action(async (projectPath, options) => {
@@ -162,7 +165,8 @@ program
     .description('生成可运行的多文件构建产物（阶段1）')
     .argument('<project-path>', '项目路径')
     .option('-o, --output <path>', '输出目录', './build')
-    .option('-s, --scenes <scenes>', '选择场景（逗号分隔），例如: MainMenu,Gameplay')
+    .option('-s, --scenes <scenes>', '选择场景（逗号分隔），例如: "Main Scene" 或 MainMenu,Gameplay')
+    .option('-e, --engine <engine>', '指定引擎类型 (playcanvas|phaser|pixijs|threejs|cocos|babylonjs|layaair|egret|generic)，默认自动检测')
     .action(async (projectPath, options) => {
     await buildCommand(projectPath, {
         ...options,
@@ -175,14 +179,16 @@ program
     .command('analyze')
     .description('生成打包分析报告（可视化 + 体积建议）')
     .argument('[project-path]', '项目路径', process.cwd())
-    .option('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo)')
+    .option('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo|inmobi|adikteev|remerge|mintegral)')
     .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
     .option('-o, --output <path>', '输出目录', './dist')
     .option('-c, --config <file>', '配置文件路径')
-    .option('--compress', '压缩引擎代码（使用 LZ4）')
-    .option('--compress-config', '压缩 config.json（使用 LZ4，可减少 60-70% 体积）')
-    .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
-    .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')
+    .option('-e, --engine <engine>', '指定引擎类型 (playcanvas|phaser|pixijs|threejs|cocos|babylonjs|layaair|egret|generic)，默认自动检测')
+    .option('--compress', '压缩引擎代码（使用 LZ4，仅 PlayCanvas）')
+    .option('--compress-config', '压缩 config.json（使用 LZ4，可减少 60-70% 体积，仅 PlayCanvas）')
+    .option('--compress-js', '压缩所有 JS 代码（LZ4 源码保护）')
+    .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon（仅 PlayCanvas）')
+    .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)，仅 PlayCanvas')
     .option('--mode <mode>', '构建模式 (full|base|playable)')
     .option('--use-vite', '使用 Vite 构建（默认启用）', true)
     .option('--no-use-vite', '禁用 Vite，使用旧构建器')
@@ -195,7 +201,7 @@ program
     .option('--image-quality <quality>', '图片质量 0-100（默认根据平台配置）', parseInt)
     .option('--convert-webp', '转换为 WebP 格式（默认启用）', true)
     .option('--no-convert-webp', '禁用 WebP 转换')
-    .option('--compress-models', '压缩 3D 模型（默认根据平台配置）')
+    .option('--compress-models', '压缩 3D 模型（默认根据平台配置，仅 PlayCanvas/Three.js/Babylon.js）')
     .option('--no-compress-models', '禁用模型压缩')
     .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
     .option('--esm-mode <mode>', 'ESM 模块处理模式 (auto|enabled|disabled)', 'auto')
@@ -210,7 +216,7 @@ program
     .command('build-playable')
     .description('将多文件构建产物转换为单HTML Playable Ads（阶段2）')
     .argument('<base-build-dir>', '多文件构建产物目录')
-    .requiredOption('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo)')
+    .requiredOption('-p, --platform <platform>', '目标平台 (facebook|snapchat|ironsource|applovin|google|tiktok|unity|liftoff|moloco|bigo|inmobi|adikteev|remerge|mintegral)')
     .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
     .option('-o, --output <path>', '输出目录', './dist')
     .option('-c, --config <file>', '配置文件路径')
@@ -242,6 +248,42 @@ program
         mode: 'playable',
     });
 });
+// build-all 命令 - 批量打渠道包
+program
+    .command('build-all')
+    .description('批量打多渠道包（一次 Base Build + 多渠道 Channel Build）')
+    .argument('[project-path]', '项目路径', process.cwd())
+    .option('--platforms <platforms>', '目标平台列表（逗号分隔），例如: facebook,google,tiktok,applovin')
+    .option('--group <group>', '使用预定义分组 (all|mainstream|html|zip)')
+    .option('-o, --output <path>', '输出根目录（每个渠道一个子目录）', './dist')
+    .option('-c, --config <file>', '配置文件路径')
+    .option('-s, --scenes <scenes>', '选择场景（逗号分隔）')
+    .option('--clean', '构建前清理旧的输出目录', true)
+    .option('--no-clean', '跳过清理旧的输出目录')
+    .option('--compress', '压缩引擎代码（使用 LZ4）')
+    .option('--compress-config', '压缩 config.json（使用 LZ4）')
+    .option('--compress-js', '压缩所有 JS 代码（LZ4 源码保护）')
+    .option('--analyze', '生成打包分析报告')
+    .option('--replace-ammo', '检测到 Ammo 时自动替换')
+    .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')
+    .option('--use-vite', '使用 Vite 构建（默认启用）', true)
+    .option('--no-use-vite', '禁用 Vite，使用旧构建器')
+    .option('--css-minify', '压缩 CSS')
+    .option('--no-css-minify', '禁用 CSS 压缩')
+    .option('--js-minify', '压缩 JS')
+    .option('--no-js-minify', '禁用 JS 压缩')
+    .option('--compress-images', '压缩图片')
+    .option('--no-compress-images', '禁用图片压缩')
+    .option('--image-quality <quality>', '图片质量 0-100', parseInt)
+    .option('--convert-webp', '转换为 WebP 格式', true)
+    .option('--no-convert-webp', '禁用 WebP 转换')
+    .option('--compress-models', '压缩 3D 模型')
+    .option('--no-compress-models', '禁用模型压缩')
+    .option('--model-compression <method>', '模型压缩方法 (draco|meshopt)', 'draco')
+    .option('--esm-mode <mode>', 'ESM 模块处理模式 (auto|enabled|disabled)', 'auto')
+    .action(async (projectPath, options) => {
+    await buildAllCommand(projectPath, options);
+});
 // 新增：inspect 命令 - 检查项目类型
 program
     .command('inspect')

package/dist/server.js

@@ -1,9 +1,13 @@
 import express from 'express';
 import cors from 'cors';
-export function createServer(config, fsHandler) {
+import path from 'path';
+export function createServer(config, fsHandler, options) {
     const app = express();
-    app.use(cors());
-    app.use(express.json());
+    app.use(cors({
+        origin: true, // reflect request origin
+        credentials: true, // allow credentials (withCredentials)
+    }));
+    app.use(express.json({ limit: '50mb' }));
     // Health check
     app.get('/health', (req, res) => {
         res.json({ status: 'ok', projectId: config.projectId });
@@ -54,10 +58,22 @@ export function createServer(config, fsHandler) {
             return res.status(400).json({ error: 'Missing path parameter' });
         }
         try {
-            const result = await fsHandler.readBinaryFile(filePath);
+            let result = await fsHandler.readBinaryFile(filePath);
+            let actualPath = filePath;
+            // Fallback: if exact path not found and path starts with "assets/",
+            // search recursively in the assets directory for a file with the same name.
+            // Note: findFileRecursive() has built-in caching (5min TTL) and depth limiting (max 10 levels)
+            if (!result.exists && filePath.startsWith('assets/')) {
+                const fileName = path.basename(filePath);
+                const found = await fsHandler.findFileRecursive('assets', fileName);
+                if (found) {
+                    result = await fsHandler.readBinaryFile(found);
+                    actualPath = found;
+                }
+            }
             if (result.exists) {
-                // Set appropriate content type
-                const ext = filePath.split('.').pop()?.toLowerCase();
+                // Set appropriate content type based on the actual file path
+                const ext = actualPath.split('.').pop()?.toLowerCase();
                 const contentType = getContentType(ext || '');
                 res.setHeader('Content-Type', contentType);
                 if (result.size !== undefined) {
@@ -81,6 +97,7 @@ export function createServer(config, fsHandler) {
         }
         try {
             await fsHandler.writeFile(filePath, content ?? '');
+            options?.onFileWritten?.(filePath);
             res.json({ success: true, path: filePath });
         }
         catch (error) {

package/dist/socket.js

@@ -59,8 +59,9 @@ export class SocketServer {
     onConnectionChange;
     constructor(server, config, onConnectionChange) {
         this.config = config;
-        // 注意：必须显式指定 path='/'，避免拦截 /realtime、/messenger 等其他 WebSocket 服务
-        this.wss = new WebSocketServer({ server, path: '/' });
+        // 使用 noServer 模式，由 agent.ts 的统一 upgrade handler 分发 WebSocket 连接
+        // 避免多个 WebSocketServer 在同一个 HTTP server 上的 upgrade 事件冲突
+        this.wss = new WebSocketServer({ noServer: true });
         this.onConnectionChange = onConnectionChange;
         this.wss.on('connection', (ws) => {
             this.clients.set(ws, { patterns: ['**/*'] });
@@ -173,4 +174,8 @@ export class SocketServer {
     getConnectionCount() {
         return this.clients.size;
     }
+    /** 获取内部 WebSocketServer 实例，用于手动 handleUpgrade */
+    getWss() {
+        return this.wss;
+    }
 }

package/dist/watcher.js

@@ -4,6 +4,13 @@ export class Watcher {
     config;
     onChange;
     watcher;
+    /**
+     * 被抑制的文件路径及其过期时间戳。
+     * 当 Editor 通过 HTTP 保存文件时，将文件路径加入此 Map，
+     * Watcher 在窗口期内忽略该文件的变更通知，防止保存→watcher→reload 循环。
+     */
+    suppressedFiles = new Map();
+    static SUPPRESS_WINDOW_MS = 3000; // 3 秒抑制窗口
     constructor(config, onChange) {
         this.config = config;
         this.onChange = onChange;
@@ -24,9 +31,28 @@ export class Watcher {
             .on('unlink', (filePath) => this.handleEvent(filePath, 'delete'));
     }
     handleEvent(filePath, type) {
-        const relativePath = path.relative(this.config.dir, filePath);
+        // 统一使用 / 分隔符，确保 Windows 和 Unix 行为一致
+        const relativePath = path.relative(this.config.dir, filePath).replace(/\\/g, '/');
+        // 检查是否在抑制窗口内
+        const suppressUntil = this.suppressedFiles.get(relativePath);
+        if (suppressUntil && Date.now() < suppressUntil) {
+            // 文件刚被 Editor 保存，忽略 Watcher 回弹
+            return;
+        }
+        // 过期清理
+        if (suppressUntil) {
+            this.suppressedFiles.delete(relativePath);
+        }
         this.onChange(relativePath, type);
     }
+    /**
+     * 抑制指定文件的 Watcher 通知（在窗口期内）。
+     * 应在 Editor 通过 HTTP API 保存文件后调用。
+     */
+    suppressFile(relativePath, durationMs) {
+        const normalizedPath = relativePath.replace(/\\/g, '/');
+        this.suppressedFiles.set(normalizedPath, Date.now() + (durationMs || Watcher.SUPPRESS_WINDOW_MS));
+    }
     close() {
         return this.watcher.close();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/cli",
-  "version": "0.0.15",
+  "version": "0.0.18",
   "private": false,
   "type": "module",
   "bin": {
@@ -22,8 +22,8 @@
     "release": "node scripts/release.js"
   },
   "dependencies": {
-    "@playcraft/common": "^0.0.6",
-    "@playcraft/build": "^0.0.13",
+    "@playcraft/common": "^0.0.8",
+    "@playcraft/build": "^0.0.15",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "cors": "^2.8.6",