@playcraft/cli 0.0.13 → 0.0.15

package/dist/agent/agent.js

@@ -89,7 +89,11 @@ export class PlayCraftAgent {
                 onDocCreate: async (collection, id) => {
                     // Prefer internal endpoints from local backend
                     const url = `http://localhost:${this.config.port}/api/${collection}/internal/${id}`;
-                    const res = await fetch(url, { headers: { 'X-Internal-Secret': emitSecret } });
+                    const path = `/api/${collection}/internal/${id}`;
+                    // 生成签名 headers
+                    const { generateSignedHeaders } = await import('@playcraft/common');
+                    const headers = generateSignedHeaders('GET', path, emitSecret, 'cli');
+                    const res = await fetch(url, { headers });
                     if (res.ok)
                         return await res.json();
                     return null;

package/dist/commands/build.js

@@ -2,7 +2,7 @@ import path from 'path';
 import fs from 'fs/promises';
 import pc from 'picocolors';
 import ora from 'ora';
-import { BaseBuilder, ViteBuilder, PlayableBuilder } from '@playcraft/build';
+import { BaseBuilder, ViteBuilder, PlayableBuilder, PlayableAnalyzer } from '@playcraft/build';
 import { loadBuildConfig } from '../build-config.js';
 import inquirer from 'inquirer';
 /**
@@ -328,6 +328,7 @@ export async function buildCommand(projectPath, options) {
                 outputDir: baseBuildOutputDir,
                 selectedScenes,
                 clean: shouldClean && !isSameAsInput, // 清理逻辑由 BaseBuilder 内部处理
+                analyze: options.analyze, // 传递 analyze 参数
             });
             const baseBuild = await baseBuilder.build();
             spinner.succeed(pc.green('✅ 基础构建完成！'));
@@ -459,6 +460,8 @@ export async function buildCommand(projectPath, options) {
             outputDir: path.resolve(options.output || './dist'),
             // 如果命令行指定了 --compress，则使用命令行参数；否则让平台配置生效
             compressEngine: options.compress,
+            // 如果命令行指定了 --compress-config，则使用命令行参数；否则让平台配置生效
+            compressConfigJson: options.compressConfig,
             analyze: options.analyze || false,
             // Vite 构建选项
             useVite: options.useVite !== false, // 默认使用 Vite
@@ -615,43 +618,81 @@ export async function buildCommand(projectPath, options) {
         console.log(`  - 总计: ${totalMB} MB ${status} (限制: ${limitMB} MB)`);
         console.log('\n' + pc.green(`输出: ${outputPath}`));
         if (buildOptions.analyze) {
-            // 从 Base Build 复制分析报告到最终输出目录
-            const baseReportPath = path.join(baseBuildDir, 'base-bundle-report.html');
-            const finalReportPath = buildOptions.analyzeReportPath
-                ? buildOptions.analyzeReportPath
-                : path.join(buildOptions.outputDir || './dist', 'bundle-report.html');
-            let reportExists = false;
+            console.log('\n' + pc.bold('📊 生成分析报告...'));
+            // 1. 生成 Base Build 分析报告（如果有）
+            const baseReportPath = path.join(baseBuildDir, 'build-analysis-report.html');
+            let baseReportExists = false;
             try {
                 await fs.access(baseReportPath);
-                await fs.copyFile(baseReportPath, finalReportPath);
-                reportExists = true;
+                baseReportExists = true;
             }
             catch {
-                // 报告文件不存在（例如从官方构建产物直接复制时），这是正常的
+                // Base Build 报告不存在
             }
-            const analysis = await analyzeBaseBuild(baseBuildDir, buildOptions.ammoReplacement);
-            console.log('\n' + pc.bold('分析报告:'));
-            if (reportExists) {
-                console.log(`  - 可视化报告: ${finalReportPath}`);
-            }
-            if (analysis.engineSize > 0) {
-                const engineMB = (analysis.engineSize / 1024 / 1024).toFixed(2);
-                console.log(`  - 引擎大小: ${engineMB} MB`);
+            // 2. 生成 Playable 分析报告（分析最终打包产物）
+            try {
+                const playableAnalyzer = new PlayableAnalyzer(outputPath, buildOptions.outputDir || './dist', baseReportExists ? baseReportPath : undefined // 传入 Base Build 报告路径
+                );
+                // 分析最终产物
+                const playableReport = await playableAnalyzer.analyze();
+                // 如果有 Base Build 报告，添加优化信息
+                if (baseReportExists) {
+                    try {
+                        const baseReportContent = await fs.readFile(baseReportPath, 'utf-8');
+                        // 从 Base Build 报告中提取预估大小
+                        const estimatedMatch = baseReportContent.match(/预估 HTML 大小[^>]*>([^<]+)</);
+                        if (estimatedMatch) {
+                            const estimatedSizeStr = estimatedMatch[1].trim();
+                            // 解析大小字符串（例如 "16.02 MB"）
+                            const sizeMatch = estimatedSizeStr.match(/([\d.]+)\s*(B|KB|MB|GB)/);
+                            if (sizeMatch) {
+                                const value = parseFloat(sizeMatch[1]);
+                                const unit = sizeMatch[2];
+                                const multipliers = { 'B': 1, 'KB': 1024, 'MB': 1024 * 1024, 'GB': 1024 * 1024 * 1024 };
+                                const baseBuildSize = value * multipliers[unit];
+                                playableReport.optimizationInfo = {
+                                    baseBuildSize,
+                                    baseBuildSizeFormatted: estimatedSizeStr,
+                                    optimizationRate: ((baseBuildSize - playableReport.totalSize) / baseBuildSize) * 100
+                                };
+                            }
+                        }
+                    }
+                    catch (error) {
+                        // 忽略解析错误
+                    }
+                }
+                // 生成 HTML 报告
+                const playableReportPath = await playableAnalyzer.generateHTMLReport(playableReport);
+                console.log('\n' + pc.bold('分析报告:'));
+                console.log(`  - Playable 分析报告: ${playableReportPath}`);
+                if (baseReportExists) {
+                    console.log(`  - Base Build 分析报告: ${baseReportPath}`);
+                }
+                // 显示优化效果
+                if (playableReport.optimizationInfo) {
+                    const opt = playableReport.optimizationInfo;
+                    console.log('\n' + pc.bold('🎯 优化效果:'));
+                    console.log(`  - Base Build 预估: ${opt.baseBuildSizeFormatted}`);
+                    console.log(`  - 实际打包大小: ${playableReport.totalSizeFormatted}`);
+                    console.log(`  - 优化率: ${pc.green((opt.optimizationRate ?? 0).toFixed(1) + '%')}`);
+                }
+                // 显示 Top 资源
+                const topAssets = playableReport.assets.slice(0, 10);
+                if (topAssets.length > 0) {
+                    console.log('\n' + pc.bold('🔝 Top 10 资源:'));
+                    topAssets.forEach((asset, index) => {
+                        console.log(`  ${index + 1}. ${asset.name}: ${asset.sizeFormatted} (${asset.percentage.toFixed(2)}%)`);
+                    });
+                }
             }
-            if (analysis.topAssets.length > 0) {
-                console.log('  - 资源 Top:');
-                analysis.topAssets.forEach((asset) => {
-                    const sizeKB = asset.size / 1024;
-                    const sizeMB = sizeKB / 1024;
-                    // 自动选择合适的单位
-                    const sizeStr = sizeMB >= 0.01
-                        ? `${sizeMB.toFixed(2)} MB`
-                        : `${sizeKB.toFixed(2)} KB`;
-                    console.log(`    • ${asset.path}: ${sizeStr}`);
-                });
+            catch (error) {
+                console.error(pc.red('生成 Playable 分析报告失败:'), error);
             }
+            // 3. 显示旧的分析信息（向后兼容）
+            const analysis = await analyzeBaseBuild(baseBuildDir, buildOptions.ammoReplacement);
             if (analysis.hasAmmo) {
-                console.log(pc.yellow(`  - 检测到 Ammo.js，建议替换为 ${analysis.suggestedEngine}`));
+                console.log(pc.yellow(`\n⚠️  检测到 Ammo.js，建议替换为 ${analysis.suggestedEngine}`));
             }
         }
         // 清理临时目录（调试时注释掉）

package/dist/index.js

@@ -131,7 +131,8 @@ program
     .option('-s, --scenes <scenes>', '选择场景（逗号分隔），例如: MainMenu,Gameplay')
     .option('--clean', '构建前清理旧的输出目录（默认启用）', true)
     .option('--no-clean', '跳过清理旧的输出目录')
-    .option('--compress', '压缩引擎代码')
+    .option('--compress', '压缩引擎代码（使用 LZ4）')
+    .option('--compress-config', '压缩 config.json（使用 LZ4，可减少 60-70% 体积）')
     .option('--analyze', '生成打包分析报告')
     .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
     .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')
@@ -178,7 +179,8 @@ program
     .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
     .option('-o, --output <path>', '输出目录', './dist')
     .option('-c, --config <file>', '配置文件路径')
-    .option('--compress', '压缩引擎代码')
+    .option('--compress', '压缩引擎代码（使用 LZ4）')
+    .option('--compress-config', '压缩 config.json（使用 LZ4，可减少 60-70% 体积）')
     .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
     .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')
     .option('--mode <mode>', '构建模式 (full|base|playable)')
@@ -214,7 +216,8 @@ program
     .option('-c, --config <file>', '配置文件路径')
     .option('--clean', '构建前清理旧的输出目录（默认不清理，使用覆盖模式）')
     .option('--no-clean', '使用覆盖模式（默认行为）')
-    .option('--compress', '压缩引擎代码')
+    .option('--compress', '压缩引擎代码（使用 LZ4）')
+    .option('--compress-config', '压缩 config.json（使用 LZ4，可减少 60-70% 体积）')
     .option('--analyze', '生成打包分析报告')
     .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
     .option('--ammo-engine <engine>', '指定替换物理引擎 (p2|cannon)')

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@playcraft/cli",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "private": false,
   "type": "module",
   "bin": {
-    "playcraft": "./dist/index.js"
+    "playcraft": "./dist/index.js",
+    "playcraft-test": "./dist/index.js"
   },
   "files": [
     "dist",
@@ -21,32 +22,32 @@
     "release": "node scripts/release.js"
   },
   "dependencies": {
-    "@playcraft/common": "^0.0.2",
-    "@playcraft/build": "^0.0.9",
+    "@playcraft/common": "^0.0.6",
+    "@playcraft/build": "^0.0.13",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
-    "cors": "^2.8.5",
+    "cors": "^2.8.6",
     "cosmiconfig": "^9.0.0",
     "dotenv": "^17.2.3",
     "drizzle-orm": "^0.45.1",
-    "execa": "^9.0.0",
+    "execa": "^9.6.1",
     "express": "^5.2.1",
+    "inquirer": "^9.3.8",
     "latest-version": "^7.0.0",
-    "inquirer": "^9.2.12",
     "ora": "^8.2.0",
     "picocolors": "^1.1.1",
     "update-notifier": "^7.3.1",
-    "ws": "^8.18.0",
-    "zod": "^3.24.1"
+    "ws": "^8.19.0",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/cors": "^2.8.17",
-    "@types/express": "^5.0.0",
-    "@types/inquirer": "^9.0.7",
-    "@types/node": "^22.10.5",
-    "@types/update-notifier": "^6.0.4",
-    "@types/ws": "^8.5.13",
-    "typescript": "^5.7.2",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^22.19.8",
+    "@types/update-notifier": "^6.0.8",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.9.3",
     "vitest": "^3.2.4"
   }
 }

package/dist/playable/base-builder.js

@@ -1,265 +0,0 @@
-import fs from 'fs/promises';
-import path from 'path';
-import { fileURLToPath } from 'url';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-/**
- * 基础构建器 - 生成可运行的多文件构建产物
- *
- * 职责：
- * 1. 从源代码或构建产物加载项目
- * 2. 确保所有必需文件存在且格式正确
- * 3. 输出可直接运行的多文件版本
- * 4. 不做任何内联或压缩
- */
-export class BaseBuilder {
-    projectDir;
-    options;
-    constructor(projectDir, options) {
-        this.projectDir = projectDir;
-        this.options = options;
-    }
-    /**
-     * 执行基础构建
-     */
-    async build() {
-        // 1. 检测项目类型
-        const projectType = await this.detectProjectType();
-        if (projectType === 'official-build') {
-            // 官方构建产物 - 直接复制并验证
-            return await this.buildFromOfficial();
-        }
-        else {
-            // 源代码 - 需要编译
-            throw new Error('源代码构建暂未实现，请使用官方构建产物。\n' +
-                '💡 推荐：先使用 PlayCanvas REST API 下载构建版本，然后再打包为 Playable Ad。');
-        }
-    }
-    /**
-     * 检测项目类型
-     */
-    async detectProjectType() {
-        // 检查是否是官方构建产物
-        const buildIndicators = [
-            path.join(this.projectDir, 'index.html'),
-            path.join(this.projectDir, 'config.json'),
-        ];
-        try {
-            await fs.access(buildIndicators[0]);
-            await fs.access(buildIndicators[1]);
-            return 'official-build';
-        }
-        catch (error) {
-            return 'source';
-        }
-    }
-    /**
-     * 从官方构建产物构建
-     */
-    async buildFromOfficial() {
-        // 验证必需文件存在
-        await this.validateOfficialBuild();
-        // 创建输出目录
-        await fs.mkdir(this.options.outputDir, { recursive: true });
-        // 复制所有文件到输出目录
-        const files = await this.copyBuildFiles();
-        return {
-            outputDir: this.options.outputDir,
-            files,
-        };
-    }
-    /**
-     * 验证官方构建产物
-     */
-    async validateOfficialBuild() {
-        const requiredFiles = [
-            'index.html',
-            'config.json',
-            '__start__.js',
-        ];
-        const missingFiles = [];
-        for (const file of requiredFiles) {
-            try {
-                await fs.access(path.join(this.projectDir, file));
-            }
-            catch (error) {
-                missingFiles.push(file);
-            }
-        }
-        if (missingFiles.length > 0) {
-            throw new Error(`官方构建产物缺少必需文件: ${missingFiles.join(', ')}\n` +
-                `请确保项目目录包含完整的构建产物。`);
-        }
-    }
-    /**
-     * 复制构建文件到输出目录
-     */
-    async copyBuildFiles() {
-        const files = {
-            html: '',
-            engine: null,
-            config: '',
-            settings: null,
-            modules: null,
-            start: '',
-            scenes: [],
-            assets: [],
-        };
-        // 复制 index.html
-        const htmlPath = path.join(this.projectDir, 'index.html');
-        const outputHtmlPath = path.join(this.options.outputDir, 'index.html');
-        await fs.copyFile(htmlPath, outputHtmlPath);
-        files.html = outputHtmlPath;
-        // 复制 config.json
-        const configPath = path.join(this.projectDir, 'config.json');
-        const outputConfigPath = path.join(this.options.outputDir, 'config.json');
-        await fs.copyFile(configPath, outputConfigPath);
-        files.config = outputConfigPath;
-        // 读取 config.json 以获取场景信息
-        const configContent = await fs.readFile(configPath, 'utf-8');
-        const configJson = JSON.parse(configContent);
-        // 复制 __start__.js
-        const startPath = path.join(this.projectDir, '__start__.js');
-        const outputStartPath = path.join(this.options.outputDir, '__start__.js');
-        await fs.copyFile(startPath, outputStartPath);
-        files.start = outputStartPath;
-        // 复制 __settings__.js（如果存在）
-        const settingsPath = path.join(this.projectDir, '__settings__.js');
-        try {
-            await fs.access(settingsPath);
-            const outputSettingsPath = path.join(this.options.outputDir, '__settings__.js');
-            await fs.copyFile(settingsPath, outputSettingsPath);
-            files.settings = outputSettingsPath;
-        }
-        catch (error) {
-            // __settings__.js 不是必需的
-        }
-        // 复制 __modules__.js（如果存在）
-        const modulesPath = path.join(this.projectDir, '__modules__.js');
-        try {
-            await fs.access(modulesPath);
-            const outputModulesPath = path.join(this.options.outputDir, '__modules__.js');
-            await fs.copyFile(modulesPath, outputModulesPath);
-            files.modules = outputModulesPath;
-        }
-        catch (error) {
-            // __modules__.js 不是必需的
-        }
-        // 复制 PlayCanvas Engine（查找可能的文件名）
-        const engineNames = [
-            'playcanvas-stable.min.js',
-            'playcanvas.min.js',
-            '__lib__.js',
-        ];
-        for (const engineName of engineNames) {
-            const enginePath = path.join(this.projectDir, engineName);
-            try {
-                await fs.access(enginePath);
-                const outputEnginePath = path.join(this.options.outputDir, engineName);
-                await fs.copyFile(enginePath, outputEnginePath);
-                files.engine = outputEnginePath;
-                break;
-            }
-            catch (error) {
-                // 继续尝试下一个
-            }
-        }
-        // 复制场景文件
-        if (configJson.scenes && Array.isArray(configJson.scenes)) {
-            for (const scene of configJson.scenes) {
-                if (scene.url && !scene.url.startsWith('data:')) {
-                    const scenePath = path.join(this.projectDir, scene.url);
-                    try {
-                        await fs.access(scenePath);
-                        const sceneDir = path.dirname(scene.url);
-                        if (sceneDir && sceneDir !== '.') {
-                            const outputSceneDir = path.join(this.options.outputDir, sceneDir);
-                            await fs.mkdir(outputSceneDir, { recursive: true });
-                        }
-                        const outputScenePath = path.join(this.options.outputDir, scene.url);
-                        await fs.copyFile(scenePath, outputScenePath);
-                        files.scenes.push(outputScenePath);
-                    }
-                    catch (error) {
-                        console.warn(`警告: 场景文件不存在: ${scene.url}`);
-                    }
-                }
-            }
-        }
-        // 复制资产文件（从 config.json 中的 assets）
-        if (configJson.assets) {
-            const assetsDir = path.join(this.options.outputDir, 'files');
-            await fs.mkdir(assetsDir, { recursive: true });
-            for (const [assetId, assetData] of Object.entries(configJson.assets)) {
-                const asset = assetData;
-                if (asset.file && asset.file.url && !asset.file.url.startsWith('data:')) {
-                    const assetPath = path.join(this.projectDir, asset.file.url);
-                    try {
-                        await fs.access(assetPath);
-                        const assetDir = path.dirname(asset.file.url);
-                        if (assetDir && assetDir !== '.') {
-                            const outputAssetDir = path.join(this.options.outputDir, assetDir);
-                            await fs.mkdir(outputAssetDir, { recursive: true });
-                        }
-                        const outputAssetPath = path.join(this.options.outputDir, asset.file.url);
-                        await fs.copyFile(assetPath, outputAssetPath);
-                        files.assets.push(outputAssetPath);
-                    }
-                    catch (error) {
-                        // 资产文件可能不存在（可能是内联的）
-                    }
-                }
-            }
-        }
-        // 复制 files/ 目录（如果存在）
-        const filesDir = path.join(this.projectDir, 'files');
-        try {
-            const filesDirStat = await fs.stat(filesDir);
-            if (filesDirStat.isDirectory()) {
-                const outputFilesDir = path.join(this.options.outputDir, 'files');
-                await this.copyDirectory(filesDir, outputFilesDir);
-            }
-        }
-        catch (error) {
-            // files/ 目录可能不存在
-        }
-        // 复制 styles.css（如果存在）
-        const stylesPath = path.join(this.projectDir, 'styles.css');
-        try {
-            await fs.access(stylesPath);
-            const outputStylesPath = path.join(this.options.outputDir, 'styles.css');
-            await fs.copyFile(stylesPath, outputStylesPath);
-        }
-        catch (error) {
-            // styles.css 可能不存在
-        }
-        // 复制 manifest.json（如果存在）
-        const manifestPath = path.join(this.projectDir, 'manifest.json');
-        try {
-            await fs.access(manifestPath);
-            const outputManifestPath = path.join(this.options.outputDir, 'manifest.json');
-            await fs.copyFile(manifestPath, outputManifestPath);
-        }
-        catch (error) {
-            // manifest.json 可能不存在
-        }
-        return files;
-    }
-    /**
-     * 递归复制目录
-     */
-    async copyDirectory(src, dest) {
-        await fs.mkdir(dest, { recursive: true });
-        const entries = await fs.readdir(src, { withFileTypes: true });
-        for (const entry of entries) {
-            const srcPath = path.join(src, entry.name);
-            const destPath = path.join(dest, entry.name);
-            if (entry.isDirectory()) {
-                await this.copyDirectory(srcPath, destPath);
-            }
-            else {
-                await fs.copyFile(srcPath, destPath);
-            }
-        }
-    }
-}