@playcraft/cli 0.0.8 → 0.0.10

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';
 }
@@ -162,11 +211,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 +290,9 @@ export async function buildCommand(projectPath, options) {
             'liftoff',
             'moloco',
             'bigo',
+            'inmobi',
+            'adikteev',
+            'remerge',
         ];
         if (!options.platform || !validPlatforms.includes(options.platform)) {
             spinner.stop();
@@ -243,6 +348,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 +376,7 @@ 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,
             });
             const baseBuild = await baseBuilder.build();
             baseBuildDir = baseBuild.outputDir;

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.8",
+  "version": "0.0.10",
   "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.1",
+    "@playcraft/build": "^0.0.3",
     "chokidar": "^4.0.3",
     "commander": "^13.1.0",
     "cors": "^2.8.5",