@playcraft/cli 0.0.9 → 0.0.11

package/README.md

@@ -11,8 +11,10 @@ PlayCraft CLI 是一个功能强大的命令行工具，支持本地代码与云
 
 - 🚀 **本地开发隧道** - 在本地 IDE 编写代码，云端编辑器实时预览与热更新
 - 📦 **Playable Ads 打包** - 支持 10 个主流广告平台的一键打包
+- 🎬 **智能场景选择** - 交互式场景选择，可减小 30-60% 文件大小（**新功能**）
 - 🎯 **两阶段构建** - Base Build + Channel Build，灵活可控
 - ⚡ **Vite 构建** - 使用 Vite 进行资源内联与压缩，性能优异
+- 🖼️ **资源优化** - 自动图片压缩（PNG → WebP）、模型压缩（Draco）
 - 🔧 **交互式配置** - 友好的命令行交互，快速上手
 - 📊 **构建分析** - 生成详细的打包分析报告
 
@@ -140,6 +142,16 @@ done
 ### 构建优化
 
 ```bash
+# 🎬 场景选择（推荐！可减小 30-60% 文件大小）
+# 交互式选择（自动检测多个场景并提示）
+playcraft build --platform facebook
+
+# 指定特定场景
+playcraft build --platform facebook --scenes BallGame
+
+# 指定多个场景
+playcraft build --platform facebook --scenes "MainMenu,Gameplay,Settings"
+
 # 启用图片压缩
 playcraft build --platform facebook --compress-images --image-quality 75
 
@@ -148,6 +160,9 @@ playcraft build --platform facebook --compress-models --model-compression draco
 
 # 生成分析报告
 playcraft build --platform facebook --analyze
+
+# 组合使用（场景选择 + 图片压缩 + 分析）
+playcraft build --platform facebook --scenes MainScene --compress-images --analyze
 ```
 
 ## ⚙️ 配置
@@ -190,13 +205,54 @@ CLI 会在 `~/.playcraft/` 目录下存储：
 - `pids/` - 进程文件
 - `logs/` - 日志文件
 
+## 🆕 最新功能
+
+### v0.0.9 - 场景选择优化 (2026-01-26)
+
+当项目包含多个场景时，CLI 会自动提供交互式场景选择：
+
+```bash
+playcraft build --platform facebook
+```
+
+**交互界面**：
+```
+🎬 检测到 20 个场景
+💡 提示: 只打包选中的场景可以显著减小文件大小（通常可减小 30-60%）
+
+? 选择要打包的场景（使用空格选择，回车确认）:
+❯◉ MainScene
+ ◉ Gameplay
+ ◯ TestScene
+ ◯ DebugScene
+ ...
+```
+
+**优化效果**：
+- 🎯 单场景：减小 40-60%
+- 🎯 2-3 个场景：减小 30-50%
+- 🎯 自动过滤未使用的资源
+
+**命令行模式**：
+```bash
+# 指定单个场景
+playcraft build --platform facebook --scenes MainScene
+
+# 指定多个场景
+playcraft build --platform facebook --scenes "MainScene,Gameplay"
+```
+
+详见：[场景选择功能文档](../../docs/cli/scene-selection-feature.md)
+
 ## 🔗 相关链接
 
 - [PlayCraft 项目](https://github.com/your-org/playcraft)
-- [完整文档](./docs/cli/README.md)
-- [快速开始指南](./docs/cli/quick-start.md)
-- [构建命令详解](./docs/cli/build.md)
-- [配置文件说明](./docs/cli/config.md)
+- [完整文档](../../docs/cli/README.md)
+- [快速开始指南](../../docs/cli/quick-start.md)
+- [构建命令详解](../../docs/cli/build.md)
+- [场景选择功能](../../docs/cli/scene-selection-feature.md)
+- [配置文件说明](../../docs/cli/config.md)
+- [平台规格对照](../../docs/cli/各渠道Playable规格对照表.md)
 
 ## 📝 许可证
 

package/dist/commands/build.js

@@ -25,6 +25,55 @@ async function detectBaseBuild(dir) {
         return false;
     }
 }
+/**
+ * 检测项目场景列表
+ */
+async function detectProjectScenes(projectPath) {
+    try {
+        // 尝试读取 scenes.json
+        const scenesJsonPath = path.join(projectPath, 'scenes.json');
+        try {
+            const scenesContent = await fs.readFile(scenesJsonPath, 'utf-8');
+            const scenesData = JSON.parse(scenesContent);
+            // scenes.json 可能是对象格式（key 是场景 ID）
+            if (typeof scenesData === 'object' && !Array.isArray(scenesData)) {
+                return Object.entries(scenesData).map(([id, scene]) => ({
+                    id: scene.id || scene.scene || id,
+                    name: scene.name || `Scene ${id}`
+                }));
+            }
+            // 或者是数组格式
+            if (Array.isArray(scenesData)) {
+                return scenesData.map(scene => ({
+                    id: scene.id || scene.scene || scene.uniqueId,
+                    name: scene.name || `Scene ${scene.id}`
+                }));
+            }
+        }
+        catch (error) {
+            // scenes.json 不存在或解析失败，尝试其他方法
+        }
+        // 尝试从 project.json 读取
+        const projectJsonPath = path.join(projectPath, 'project.json');
+        try {
+            const projectContent = await fs.readFile(projectJsonPath, 'utf-8');
+            const projectData = JSON.parse(projectContent);
+            if (projectData.scenes && Array.isArray(projectData.scenes)) {
+                return projectData.scenes.map((scene) => ({
+                    id: scene.id || scene.scene || scene.uniqueId,
+                    name: scene.name || `Scene ${scene.id}`
+                }));
+            }
+        }
+        catch (error) {
+            // project.json 不存在或解析失败
+        }
+        return [];
+    }
+    catch (error) {
+        return [];
+    }
+}
 function resolveSuggestedPhysicsEngine(use3dPhysics) {
     return use3dPhysics ? 'cannon' : 'p2';
 }
@@ -35,7 +84,36 @@ async function detectAmmoUsage(baseBuildDir) {
     try {
         const configContent = await fs.readFile(configPath, 'utf-8');
         const configJson = JSON.parse(configContent);
+        // 检查 application_properties.use3dPhysics
         use3dPhysics = Boolean(configJson.application_properties?.use3dPhysics);
+        // 如果 use3dPhysics 未设置，通过检查场景内容来推断
+        // 检查场景是否包含 3D 物理组件（rigidbody, collision 等）
+        if (!use3dPhysics) {
+            const scenesDir = baseBuildDir;
+            try {
+                const files = await fs.readdir(scenesDir);
+                for (const file of files) {
+                    if (file.endsWith('.json') && !['config.json', 'manifest.json'].includes(file)) {
+                        try {
+                            const sceneContent = await fs.readFile(path.join(scenesDir, file), 'utf-8');
+                            // 检查场景是否包含 3D 物理组件
+                            if (sceneContent.includes('"rigidbody"') ||
+                                sceneContent.includes('"collision"') ||
+                                sceneContent.includes('"joint"')) {
+                                use3dPhysics = true;
+                                break;
+                            }
+                        }
+                        catch {
+                            // 忽略单个场景读取失败
+                        }
+                    }
+                }
+            }
+            catch {
+                // 忽略目录读取失败
+            }
+        }
         if (configJson.assets) {
             for (const asset of Object.values(configJson.assets)) {
                 const assetData = asset;
@@ -70,6 +148,7 @@ async function detectAmmoUsage(baseBuildDir) {
 }
 async function analyzeBaseBuild(baseBuildDir, ammoReplacement) {
     const assetSizes = [];
+    const assetPaths = new Set(); // 用于去重
     let engineSize = 0;
     const ammoCheck = await detectAmmoUsage(baseBuildDir);
     const engineCandidates = [
@@ -102,10 +181,15 @@ async function analyzeBaseBuild(baseBuildDir, ammoReplacement) {
                 if (ammoReplacement && lowerUrl.includes('ammo')) {
                     continue;
                 }
+                // 跳过已经处理过的资源
+                if (assetPaths.has(cleanUrl)) {
+                    continue;
+                }
                 const assetPath = path.join(baseBuildDir, cleanUrl);
                 try {
                     const stats = await fs.stat(assetPath);
                     assetSizes.push({ path: cleanUrl, size: stats.size });
+                    assetPaths.add(cleanUrl); // 标记为已处理
                 }
                 catch (error) {
                     // ignore missing assets
@@ -162,11 +246,64 @@ export async function buildCommand(projectPath, options) {
                 options.output = fileConfig.outputDir;
             }
         }
+        // 解析场景选择参数（需要在 baseOnly 之前）
+        let selectedScenes;
+        if (options.scenes) {
+            // 命令行指定了场景参数
+            selectedScenes = options.scenes.split(',').map(s => s.trim()).filter(s => s);
+            if (selectedScenes.length > 0) {
+                console.log(`\n🎬 选中场景: ${selectedScenes.join(', ')}`);
+            }
+        }
+        else {
+            // 没有指定场景参数，检测项目场景并提供交互选择
+            spinner.stop();
+            const projectScenes = await detectProjectScenes(resolvedProjectPath);
+            if (projectScenes.length > 1) {
+                // 有多个场景，提示用户选择
+                console.log(pc.cyan(`\n🎬 检测到 ${projectScenes.length} 个场景`));
+                console.log(pc.dim('💡 提示: 只打包选中的场景可以显著减小文件大小（通常可减小 30-60%）\n'));
+                const sceneAnswer = await inquirer.prompt([
+                    {
+                        type: 'checkbox',
+                        name: 'selectedScenes',
+                        message: '选择要打包的场景（使用空格选择，回车确认）:',
+                        choices: projectScenes.map(scene => ({
+                            name: scene.name,
+                            value: scene.name,
+                            checked: true // 默认全选
+                        })),
+                        validate: (answer) => {
+                            if (answer.length === 0) {
+                                return '请至少选择一个场景';
+                            }
+                            return true;
+                        }
+                    }
+                ]);
+                selectedScenes = sceneAnswer.selectedScenes;
+                if (selectedScenes && selectedScenes.length > 0) {
+                    if (selectedScenes.length === projectScenes.length) {
+                        console.log(pc.green(`✅ 已选择所有场景 (${selectedScenes.length} 个)`));
+                        // 全选则不传递参数（向后兼容）
+                        selectedScenes = undefined;
+                    }
+                    else {
+                        console.log(pc.green(`✅ 已选择 ${selectedScenes.length} / ${projectScenes.length} 个场景: ${selectedScenes.join(', ')}`));
+                    }
+                }
+            }
+            else if (projectScenes.length === 1) {
+                console.log(pc.dim(`ℹ️  项目只有 1 个场景: ${projectScenes[0].name}`));
+            }
+            spinner.start(pc.cyan('🔨 开始打包 Playable Ad...'));
+        }
         // 如果只执行基础构建
         if (options.baseOnly || options.mode === 'base') {
             spinner.text = pc.cyan('执行阶段1: 基础构建...');
             const baseBuilder = new BaseBuilder(resolvedProjectPath, {
                 outputDir: path.resolve(options.output || './build'),
+                selectedScenes,
             });
             const baseBuild = await baseBuilder.build();
             spinner.succeed(pc.green('✅ 基础构建完成！'));
@@ -188,6 +325,9 @@ export async function buildCommand(projectPath, options) {
             'liftoff',
             'moloco',
             'bigo',
+            'inmobi',
+            'adikteev',
+            'remerge',
         ];
         if (!options.platform || !validPlatforms.includes(options.platform)) {
             spinner.stop();
@@ -243,6 +383,8 @@ export async function buildCommand(projectPath, options) {
             convertToWebP: options.convertToWebP,
             compressModels: options.compressModels,
             modelCompression: options.modelCompression,
+            // 场景选择
+            selectedScenes,
         };
         if (fileConfig) {
             Object.assign(buildOptions, fileConfig);
@@ -269,6 +411,9 @@ export async function buildCommand(projectPath, options) {
             const tempDir = path.join(os.tmpdir(), `playcraft-base-build-${Date.now()}`);
             const baseBuilder = new BaseBuilder(resolvedProjectPath, {
                 outputDir: tempDir,
+                selectedScenes,
+                analyze: buildOptions.analyze,
+                analyzeReportPath: buildOptions.analyze ? 'base-bundle-report.html' : undefined,
             });
             const baseBuild = await baseBuilder.build();
             baseBuildDir = baseBuild.outputDir;
@@ -282,18 +427,48 @@ export async function buildCommand(projectPath, options) {
         else if (options.replaceAmmo && ammoCheck.hasAmmo && ammoCheck.suggestedEngine) {
             buildOptions.ammoReplacement = ammoCheck.suggestedEngine;
         }
-        else if (ammoCheck.hasAmmo && ammoCheck.suggestedEngine && !buildOptions.ammoReplacement) {
+        else if (ammoCheck.hasAmmo && !buildOptions.ammoReplacement) {
             spinner.stop();
-            const replaceAnswer = await inquirer.prompt([
-                {
-                    type: 'confirm',
-                    name: 'replaceAmmo',
-                    message: `检测到 Ammo.js，是否替换为 ${ammoCheck.suggestedEngine} 并打包内置？`,
-                    default: false,
-                },
-            ]);
-            if (replaceAnswer.replaceAmmo) {
-                buildOptions.ammoReplacement = ammoCheck.suggestedEngine;
+            // 根据是否使用 3D 物理提供不同的选项
+            const physicsType = ammoCheck.use3dPhysics ? '3D' : '2D';
+            if (ammoCheck.use3dPhysics) {
+                // 3D 项目 - 可以使用 Cannon.js 替换
+                console.log(pc.yellow(`⚠️  检测到 3D 物理项目，Ammo.js 约 1.8MB`));
+                console.log(pc.gray(`   提示: Cannon.js (~400KB) 可以减小 75% 的体积`));
+                const replaceAnswer = await inquirer.prompt([
+                    {
+                        type: 'list',
+                        name: 'ammoAction',
+                        message: `如何处理 Ammo.js？`,
+                        choices: [
+                            { name: '保留 Ammo.js（完整物理功能，文件较大）', value: 'keep' },
+                            { name: '替换为 Cannon.js（推荐 3D 项目，~400KB，自动适配）', value: 'cannon' },
+                        ],
+                        default: 'cannon',
+                    },
+                ]);
+                if (replaceAnswer.ammoAction === 'cannon') {
+                    buildOptions.ammoReplacement = 'cannon';
+                    console.log(pc.green('   ✓ 将使用 Cannon.js 替换 Ammo.js（自动兼容 rigidbody API）'));
+                }
+            }
+            else {
+                // 2D 项目 - 可以使用 p2.js 替换
+                const replaceAnswer = await inquirer.prompt([
+                    {
+                        type: 'list',
+                        name: 'ammoAction',
+                        message: `检测到 Ammo.js（项目使用 ${physicsType} 物理），如何处理？`,
+                        choices: [
+                            { name: '不替换（保留 Ammo.js，文件较大）', value: 'keep' },
+                            { name: '替换为 p2.js（推荐 2D 项目，~60KB）', value: 'p2' },
+                        ],
+                        default: 'p2',
+                    },
+                ]);
+                if (replaceAnswer.ammoAction === 'p2') {
+                    buildOptions.ammoReplacement = 'p2';
+                }
             }
             spinner.start(pc.cyan('🔨 开始打包 Playable Ad...'));
         }
@@ -326,12 +501,21 @@ export async function buildCommand(projectPath, options) {
         console.log(`  - 总计: ${totalMB} MB ${status} (限制: ${limitMB} MB)`);
         console.log('\n' + pc.green(`输出: ${outputPath}`));
         if (buildOptions.analyze) {
-            const reportPath = buildOptions.analyzeReportPath
+            // 从 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');
+            try {
+                await fs.access(baseReportPath);
+                await fs.copyFile(baseReportPath, finalReportPath);
+            }
+            catch (error) {
+                console.warn(pc.yellow('  ⚠️ 无法找到或复制分析报告'));
+            }
             const analysis = await analyzeBaseBuild(baseBuildDir, buildOptions.ammoReplacement);
             console.log('\n' + pc.bold('分析报告:'));
-            console.log(`  - 可视化报告: ${reportPath}`);
+            console.log(`  - 可视化报告: ${finalReportPath}`);
             if (analysis.engineSize > 0) {
                 const engineMB = (analysis.engineSize / 1024 / 1024).toFixed(2);
                 console.log(`  - 引擎大小: ${engineMB} MB`);
@@ -339,8 +523,13 @@ export async function buildCommand(projectPath, options) {
             if (analysis.topAssets.length > 0) {
                 console.log('  - 资源 Top:');
                 analysis.topAssets.forEach((asset) => {
-                    const sizeMB = (asset.size / 1024 / 1024).toFixed(2);
-                    console.log(`    • ${asset.path}: ${sizeMB} MB`);
+                    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}`);
                 });
             }
             if (analysis.hasAmmo) {

package/dist/index.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 import { initCommand } from './commands/init.js';
 import { startCommand, startInternal } from './commands/start.js';
 import { stopCommand } from './commands/stop.js';
@@ -7,11 +10,14 @@ import { statusCommand } from './commands/status.js';
 import { logsCommand } from './commands/logs.js';
 import { configCommand } from './commands/config.js';
 import { buildCommand } from './commands/build.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
 const program = new Command();
 program
     .name('playcraft')
     .description('PlayCraft Local Dev Agent - 本地开发助手')
-    .version('0.0.1');
+    .version(packageJson.version);
 // init 命令
 program
     .command('init')
@@ -85,6 +91,7 @@ program
     .option('-f, --format <format>', '输出格式 (html|zip)', 'html')
     .option('-o, --output <path>', '输出目录', './dist')
     .option('-c, --config <file>', '配置文件路径')
+    .option('-s, --scenes <scenes>', '选择场景（逗号分隔），例如: MainMenu,Gameplay')
     .option('--compress', '压缩引擎代码')
     .option('--analyze', '生成打包分析报告')
     .option('--replace-ammo', '检测到 Ammo 时自动替换为 p2 或 cannon')
@@ -115,6 +122,7 @@ program
     .description('生成可运行的多文件构建产物（阶段1）')
     .argument('<project-path>', '项目路径')
     .option('-o, --output <path>', '输出目录', './build')
+    .option('-s, --scenes <scenes>', '选择场景（逗号分隔），例如: MainMenu,Gameplay')
     .action(async (projectPath, options) => {
     await buildCommand(projectPath, {
         ...options,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/cli",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "private": false,
   "type": "module",
   "bin": {
@@ -15,10 +15,12 @@
     "dev": "tsc -w",
     "build": "tsc",
     "start": "node dist/index.js",
+    "link": "pnpm build && npm link",
+    "unlink": "npm unlink -g @playcraft/cli",
     "release": "node scripts/release.js"
   },
   "dependencies": {
-    "@playcraft/build": "^0.0.2",
+    "@playcraft/build": "^0.0.4",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "cors": "^2.8.5",