@playcraft/cli 0.0.1

package/README.md

@@ -0,0 +1,12 @@
+# @playcraft/cli
+
+CLI 文档已收拢到 `docs/cli/` 目录：
+- `docs/cli/README.md`
+- `docs/cli/build.md`
+- `docs/cli/config.md`
+
+快速使用：
+```bash
+npx @playcraft/cli <command>
+playcraft <command>
+```

package/dist/build-config.js

@@ -0,0 +1,26 @@
+import fs from 'fs/promises';
+import path from 'path';
+export async function loadBuildConfigFromFile(configPath) {
+    const content = await fs.readFile(configPath, 'utf-8');
+    const parsed = JSON.parse(content);
+    if (parsed && typeof parsed === 'object' && 'build' in parsed) {
+        return parsed.build || {};
+    }
+    return parsed || {};
+}
+export async function loadBuildConfig(options) {
+    if (options.configPath) {
+        return loadBuildConfigFromFile(path.resolve(options.configPath));
+    }
+    if (options.projectPath) {
+        const unifiedPath = path.join(path.resolve(options.projectPath), 'playcraft.config.json');
+        try {
+            await fs.access(unifiedPath);
+            return loadBuildConfigFromFile(unifiedPath);
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    return null;
+}

package/dist/commands/build.js

@@ -0,0 +1,363 @@
+import path from 'path';
+import fs from 'fs/promises';
+import os from 'os';
+import pc from 'picocolors';
+import ora from 'ora';
+import { BaseBuilder, ViteBuilder, PlayableBuilder } from '@playcraft/build';
+import { loadBuildConfig } from '../build-config.js';
+import inquirer from 'inquirer';
+/**
+ * 检测是否是基础构建产物（多文件版本）
+ */
+async function detectBaseBuild(dir) {
+    const indicators = [
+        path.join(dir, 'index.html'),
+        path.join(dir, 'config.json'),
+        path.join(dir, '__start__.js'),
+    ];
+    try {
+        await fs.access(indicators[0]);
+        await fs.access(indicators[1]);
+        await fs.access(indicators[2]);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+function resolveSuggestedPhysicsEngine(use3dPhysics) {
+    return use3dPhysics ? 'cannon' : 'p2';
+}
+async function detectAmmoUsage(baseBuildDir) {
+    const configPath = path.join(baseBuildDir, 'config.json');
+    let hasAmmo = false;
+    let use3dPhysics = false;
+    try {
+        const configContent = await fs.readFile(configPath, 'utf-8');
+        const configJson = JSON.parse(configContent);
+        use3dPhysics = Boolean(configJson.application_properties?.use3dPhysics);
+        if (configJson.assets) {
+            for (const asset of Object.values(configJson.assets)) {
+                const assetData = asset;
+                const moduleName = assetData?.data?.moduleName?.toLowerCase?.() || '';
+                const fileUrl = assetData?.file?.url?.toLowerCase?.() || '';
+                if (moduleName.includes('ammo') || fileUrl.includes('ammo')) {
+                    hasAmmo = true;
+                    break;
+                }
+            }
+        }
+    }
+    catch (error) {
+        // 忽略解析失败
+    }
+    if (!hasAmmo) {
+        try {
+            const settingsContent = await fs.readFile(path.join(baseBuildDir, '__settings__.js'), 'utf-8');
+            if (settingsContent.toLowerCase().includes('ammo')) {
+                hasAmmo = true;
+            }
+        }
+        catch (error) {
+            // 忽略读取失败
+        }
+    }
+    return {
+        hasAmmo,
+        suggestedEngine: resolveSuggestedPhysicsEngine(use3dPhysics),
+        use3dPhysics,
+    };
+}
+async function analyzeBaseBuild(baseBuildDir, ammoReplacement) {
+    const assetSizes = [];
+    let engineSize = 0;
+    const ammoCheck = await detectAmmoUsage(baseBuildDir);
+    const engineCandidates = [
+        'playcanvas-stable.min.js',
+        'playcanvas.min.js',
+        '__lib__.js',
+    ];
+    for (const name of engineCandidates) {
+        try {
+            const stats = await fs.stat(path.join(baseBuildDir, name));
+            engineSize = stats.size;
+            break;
+        }
+        catch (error) {
+            // ignore
+        }
+    }
+    try {
+        const configContent = await fs.readFile(path.join(baseBuildDir, 'config.json'), 'utf-8');
+        const configJson = JSON.parse(configContent);
+        if (configJson.assets) {
+            for (const asset of Object.values(configJson.assets)) {
+                const assetData = asset;
+                const url = assetData?.file?.url;
+                if (!url || typeof url !== 'string' || url.startsWith('data:')) {
+                    continue;
+                }
+                const cleanUrl = url.split('?')[0];
+                const lowerUrl = cleanUrl.toLowerCase();
+                if (ammoReplacement && lowerUrl.includes('ammo')) {
+                    continue;
+                }
+                const assetPath = path.join(baseBuildDir, cleanUrl);
+                try {
+                    const stats = await fs.stat(assetPath);
+                    assetSizes.push({ path: cleanUrl, size: stats.size });
+                }
+                catch (error) {
+                    // ignore missing assets
+                }
+            }
+        }
+    }
+    catch (error) {
+        // ignore
+    }
+    assetSizes.sort((a, b) => b.size - a.size);
+    return {
+        engineSize,
+        topAssets: assetSizes.slice(0, 10),
+        hasAmmo: ammoReplacement ? false : ammoCheck.hasAmmo,
+        suggestedEngine: ammoCheck.suggestedEngine,
+    };
+}
+export async function buildCommand(projectPath, options) {
+    const spinner = ora(pc.cyan('🔨 开始打包 Playable Ad...')).start();
+    try {
+        // 解析项目路径
+        const resolvedProjectPath = path.resolve(projectPath);
+        if (!options.baseOnly && !options.mode) {
+            spinner.stop();
+            const modeAnswer = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'mode',
+                    message: '选择构建模式:',
+                    choices: [
+                        { name: '完整构建（Base Build + Channel Build）', value: 'full' },
+                        { name: '仅 Base Build（多文件产物）', value: 'base' },
+                        { name: '仅 Channel Build（从多文件产物生成 Playable）', value: 'playable' },
+                    ],
+                    default: 'full',
+                },
+            ]);
+            options.mode = modeAnswer.mode;
+            spinner.start(pc.cyan('🔨 开始打包 Playable Ad...'));
+        }
+        const fileConfig = await loadBuildConfig({
+            configPath: options.config,
+            projectPath: resolvedProjectPath,
+        });
+        if (fileConfig) {
+            if (!options.platform && fileConfig.platform) {
+                options.platform = fileConfig.platform;
+            }
+            if (!options.format && fileConfig.format) {
+                options.format = fileConfig.format;
+            }
+            if (!options.output && fileConfig.outputDir) {
+                options.output = fileConfig.outputDir;
+            }
+        }
+        // 如果只执行基础构建
+        if (options.baseOnly || options.mode === 'base') {
+            spinner.text = pc.cyan('执行阶段1: 基础构建...');
+            const baseBuilder = new BaseBuilder(resolvedProjectPath, {
+                outputDir: path.resolve(options.output || './build'),
+            });
+            const baseBuild = await baseBuilder.build();
+            spinner.succeed(pc.green('✅ 基础构建完成！'));
+            console.log(pc.green(`输出目录: ${baseBuild.outputDir}`));
+            console.log(pc.dim('💡 提示: 可以在浏览器中打开 index.html 测试游戏'));
+            return;
+        }
+        // 完整流程：阶段1 + 阶段2
+        const shouldRunPlayableOnly = options.mode === 'playable';
+        // 验证平台
+        const validPlatforms = [
+            'facebook',
+            'snapchat',
+            'ironsource',
+            'applovin',
+            'google',
+            'tiktok',
+            'unity',
+            'liftoff',
+            'moloco',
+            'bigo',
+        ];
+        if (!options.platform || !validPlatforms.includes(options.platform)) {
+            spinner.stop();
+            const answers = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'platform',
+                    message: '选择目标平台:',
+                    choices: validPlatforms,
+                },
+                {
+                    type: 'list',
+                    name: 'format',
+                    message: '选择输出格式:',
+                    choices: [
+                        { name: 'HTML（单文件）', value: 'html' },
+                        { name: 'ZIP（多文件）', value: 'zip' },
+                    ],
+                    default: 'html',
+                },
+                {
+                    type: 'input',
+                    name: 'output',
+                    message: '输出目录:',
+                    default: options.output || './dist',
+                },
+            ]);
+            options.platform = answers.platform;
+            options.format = answers.format;
+            options.output = answers.output;
+            spinner.start(pc.cyan('🔨 开始打包 Playable Ad...'));
+        }
+        // 解析配置
+        const buildOptions = {
+            platform: options.platform,
+            format: options.format || 'html',
+            outputDir: path.resolve(options.output || './dist'),
+            // 如果命令行指定了 --compress，则使用命令行参数；否则让平台配置生效
+            compressEngine: options.compress,
+            analyze: options.analyze || false,
+            // Vite 构建选项
+            useVite: options.useVite !== false, // 默认使用 Vite
+            // 压缩选项
+            cssMinify: options.cssMinify,
+            jsMinify: options.jsMinify,
+            compressImages: options.compressImages,
+            imageQuality: options.imageQuality,
+            convertToWebP: options.convertToWebP,
+            compressModels: options.compressModels,
+            modelCompression: options.modelCompression,
+        };
+        if (fileConfig) {
+            Object.assign(buildOptions, fileConfig);
+        }
+        // 1. 检测输入类型
+        spinner.text = pc.cyan('检测项目类型...');
+        const isBaseBuild = await detectBaseBuild(resolvedProjectPath);
+        let baseBuildDir;
+        if (shouldRunPlayableOnly) {
+            if (!isBaseBuild) {
+                throw new Error('当前目录不是多文件构建产物，请先运行完整构建或使用 build-base 生成。');
+            }
+            spinner.text = pc.cyan('✅ 使用多文件构建产物，直接执行阶段2');
+            baseBuildDir = resolvedProjectPath;
+        }
+        else if (isBaseBuild) {
+            // 输入已经是多文件构建产物，直接使用
+            spinner.text = pc.cyan('✅ 检测到多文件构建产物，跳过阶段1');
+            baseBuildDir = resolvedProjectPath;
+        }
+        else {
+            // 输入是源代码或官方构建，先执行阶段1
+            spinner.text = pc.cyan('执行阶段1: 基础构建...');
+            const tempDir = path.join(os.tmpdir(), `playcraft-base-build-${Date.now()}`);
+            const baseBuilder = new BaseBuilder(resolvedProjectPath, {
+                outputDir: tempDir,
+            });
+            const baseBuild = await baseBuilder.build();
+            baseBuildDir = baseBuild.outputDir;
+            spinner.text = pc.cyan('✅ 阶段1完成，开始阶段2...');
+        }
+        const ammoCheck = await detectAmmoUsage(baseBuildDir);
+        const requestedAmmoEngine = options.ammoEngine;
+        if (requestedAmmoEngine === 'p2' || requestedAmmoEngine === 'cannon') {
+            buildOptions.ammoReplacement = requestedAmmoEngine;
+        }
+        else if (options.replaceAmmo && ammoCheck.hasAmmo && ammoCheck.suggestedEngine) {
+            buildOptions.ammoReplacement = ammoCheck.suggestedEngine;
+        }
+        else if (ammoCheck.hasAmmo && ammoCheck.suggestedEngine && !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;
+            }
+            spinner.start(pc.cyan('🔨 开始打包 Playable Ad...'));
+        }
+        // 2. 执行阶段2：转换为Playable Ads
+        spinner.text = pc.cyan('执行阶段2: 转换为单HTML Playable Ads...');
+        let outputPath;
+        let sizeReport;
+        if (buildOptions.useVite !== false) {
+            // 使用 Vite 构建
+            const viteBuilder = new ViteBuilder(baseBuildDir, buildOptions);
+            outputPath = await viteBuilder.build();
+            sizeReport = viteBuilder.getSizeReport();
+        }
+        else {
+            // 使用旧的 PlayableBuilder（向后兼容）
+            const playableBuilder = new PlayableBuilder(baseBuildDir, buildOptions);
+            outputPath = await playableBuilder.build();
+            sizeReport = playableBuilder.getSizeReport();
+        }
+        spinner.succeed(pc.green('📦 打包完成！'));
+        // 显示文件大小报告
+        console.log('\n' + pc.bold('文件大小报告:'));
+        for (const [name, size] of Object.entries(sizeReport.assets)) {
+            const sizeMB = (size / 1024 / 1024).toFixed(2);
+            console.log(`  - ${name}: ${sizeMB} MB`);
+        }
+        const totalMB = (sizeReport.total / 1024 / 1024).toFixed(2);
+        const limitMB = (sizeReport.limit / 1024 / 1024).toFixed(2);
+        const status = sizeReport.total <= sizeReport.limit ? pc.green('✅') : pc.red('❌');
+        console.log(`  - 总计: ${totalMB} MB ${status} (限制: ${limitMB} MB)`);
+        console.log('\n' + pc.green(`输出: ${outputPath}`));
+        if (buildOptions.analyze) {
+            const reportPath = buildOptions.analyzeReportPath
+                ? buildOptions.analyzeReportPath
+                : path.join(buildOptions.outputDir || './dist', 'bundle-report.html');
+            const analysis = await analyzeBaseBuild(baseBuildDir, buildOptions.ammoReplacement);
+            console.log('\n' + pc.bold('分析报告:'));
+            console.log(`  - 可视化报告: ${reportPath}`);
+            if (analysis.engineSize > 0) {
+                const engineMB = (analysis.engineSize / 1024 / 1024).toFixed(2);
+                console.log(`  - 引擎大小: ${engineMB} MB`);
+            }
+            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`);
+                });
+            }
+            if (analysis.hasAmmo) {
+                console.log(pc.yellow(`  - 检测到 Ammo.js，建议替换为 ${analysis.suggestedEngine}`));
+            }
+        }
+        // 清理临时目录
+        if (!isBaseBuild && baseBuildDir.startsWith(os.tmpdir())) {
+            try {
+                await fs.rm(baseBuildDir, { recursive: true, force: true });
+            }
+            catch (error) {
+                // 忽略清理错误
+            }
+        }
+    }
+    catch (error) {
+        spinner.fail(pc.red('打包失败'));
+        console.error(pc.red(`错误: ${error.message}`));
+        if (error.stack) {
+            console.error(pc.dim(error.stack));
+        }
+        process.exit(1);
+    }
+}

package/dist/commands/config.js

@@ -0,0 +1,133 @@
+import { loadConfig } from '../config.js';
+import fs from 'fs/promises';
+import path from 'path';
+import pc from 'picocolors';
+import ora from 'ora';
+export async function configCommand(action, options) {
+    switch (action) {
+        case 'get':
+            await getConfig(options);
+            break;
+        case 'set':
+            await setConfig(options);
+            break;
+        case 'list':
+            await listConfig(options);
+            break;
+        default:
+            console.error(pc.red(`未知操作: ${action}`));
+            console.log(pc.yellow('可用操作: get, set, list'));
+            process.exit(1);
+    }
+}
+async function getConfig(options) {
+    const spinner = ora('读取配置...').start();
+    try {
+        const config = await loadConfig({
+            projectId: options.project,
+        });
+        spinner.succeed('配置读取成功');
+        if (options.key) {
+            // 获取特定键的值
+            const value = config[options.key];
+            if (value === undefined) {
+                console.log(pc.yellow(`配置项 ${options.key} 不存在`));
+            }
+            else {
+                console.log(pc.cyan(`\n${options.key}: ${value}\n`));
+            }
+        }
+        else {
+            // 显示所有配置
+            console.log(pc.cyan('\n📋 当前配置\n'));
+            console.log(JSON.stringify(config, null, 2));
+            console.log();
+        }
+    }
+    catch (error) {
+        spinner.fail('读取配置失败');
+        console.error(pc.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+}
+async function setConfig(options) {
+    if (!options.key || !options.value) {
+        console.error(pc.red('请指定配置键和值'));
+        console.log(pc.yellow('用法: playcraft config set --key <key> --value <value>'));
+        process.exit(1);
+    }
+    const spinner = ora('更新配置...').start();
+    try {
+        // 查找配置文件
+        const configPath = path.join(process.cwd(), 'playcraft.agent.config.json');
+        let config = {};
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            config = JSON.parse(content);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+            // 文件不存在，创建新配置
+        }
+        // 更新配置值
+        if (options.key === 'port') {
+            config.port = parseInt(options.value, 10);
+            if (isNaN(config.port)) {
+                throw new Error('端口必须是数字');
+            }
+        }
+        else {
+            config[options.key] = options.value;
+        }
+        // 保存配置
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        spinner.succeed('配置已更新');
+        console.log(pc.green(`✅ ${options.key} = ${options.value}\n`));
+    }
+    catch (error) {
+        spinner.fail('更新配置失败');
+        console.error(pc.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+}
+async function listConfig(options) {
+    const spinner = ora('读取配置...').start();
+    try {
+        const config = await loadConfig({
+            projectId: options.project,
+        });
+        spinner.succeed('配置读取成功');
+        console.log(pc.cyan('\n📋 配置列表\n'));
+        const configPath = path.join(process.cwd(), 'playcraft.agent.config.json');
+        let fileConfig = {};
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            fileConfig = JSON.parse(content);
+        }
+        catch (error) {
+            // 忽略文件读取错误
+        }
+        // 显示配置来源
+        console.log(`${pc.bold('配置文件:')} ${configPath}`);
+        console.log(`${pc.bold('项目 ID:')} ${config.projectId || pc.yellow('未设置')}`);
+        console.log(`${pc.bold('目录:')} ${config.dir}`);
+        console.log(`${pc.bold('端口:')} ${config.port}`);
+        if (config.token) {
+            console.log(`${pc.bold('令牌:')} ${pc.dim('***')}`);
+        }
+        console.log();
+        // 显示配置来源
+        if (Object.keys(fileConfig).length > 0) {
+            console.log(pc.dim('配置文件内容:'));
+            console.log(JSON.stringify(fileConfig, null, 2));
+            console.log();
+        }
+    }
+    catch (error) {
+        spinner.fail('读取配置失败');
+        console.error(pc.red(`错误: ${error.message}`));
+        process.exit(1);
+    }
+}

package/dist/commands/init.js

@@ -0,0 +1,86 @@
+import inquirer from 'inquirer';
+import fs from 'fs/promises';
+import path from 'path';
+import { findAvailablePort } from '../port-utils.js';
+import pc from 'picocolors';
+export async function initCommand(dir = process.cwd()) {
+    console.log(pc.cyan('\n🚀 PlayCraft Agent 初始化\n'));
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'projectId',
+            message: '请输入项目 ID:',
+            validate: (input) => {
+                if (!input.trim()) {
+                    return '项目 ID 不能为空';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'dir',
+            message: '监听目录:',
+            default: dir,
+            validate: async (input) => {
+                try {
+                    const resolved = path.resolve(input);
+                    const stats = await fs.stat(resolved);
+                    if (!stats.isDirectory()) {
+                        return '路径不是一个目录';
+                    }
+                    return true;
+                }
+                catch (error) {
+                    if (error.code === 'ENOENT') {
+                        return '目录不存在';
+                    }
+                    return `无法访问目录: ${error.message}`;
+                }
+            },
+        },
+        {
+            type: 'input',
+            name: 'port',
+            message: '服务端口:',
+            default: '2468',
+            validate: async (input) => {
+                const port = parseInt(input, 10);
+                if (isNaN(port) || port < 1 || port > 65535) {
+                    return '端口号必须是 1-65535 之间的数字';
+                }
+                const available = await findAvailablePort(port, 1).then(() => true).catch(() => false);
+                if (!available) {
+                    return `端口 ${port} 已被占用，请选择其他端口`;
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'token',
+            message: '认证令牌 (可选):',
+            default: '',
+        },
+    ]);
+    const config = {
+        agent: {
+            projectId: answers.projectId,
+            dir: path.resolve(answers.dir),
+            port: parseInt(answers.port, 10),
+            ...(answers.token && { token: answers.token }),
+        },
+    };
+    const configPath = path.join(dir, 'playcraft.config.json');
+    try {
+        await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+        console.log(pc.green(`\n✅ 配置文件已创建: ${configPath}\n`));
+        console.log(pc.dim('配置内容:'));
+        console.log(JSON.stringify(config, null, 2));
+        console.log();
+    }
+    catch (error) {
+        console.error(pc.red(`\n❌ 创建配置文件失败: ${error.message}\n`));
+        process.exit(1);
+    }
+}