@playcraft/cli 0.0.19 → 0.0.21

package/dist/cli-root-help.js

@@ -0,0 +1,22 @@
+/** 与 docs/cli/capabilities.md 一致的三块划分说明（纯文本，供 --help / topics 复用） */
+export function getCliTopicsHelpText() {
+    return [
+        '命令分区（完整说明见仓库 docs/cli/capabilities.md）：',
+        '',
+        '  本地开发   init, start, stop, status, logs, config, sync, fix-ids',
+        '  素材       tools generate-*  |  image <子命令>  |  audio <子命令>',
+        '  平台       build, build-base, build-playable, build-all, analyze, inspect, upgrade',
+        '             tools 除 generate-* 外（Git / 沙箱构建 / 发布 / 列表 / Prefab 等，需后端 API）',
+        '',
+        '也可运行: playcraft topics',
+        '',
+    ].join('\n');
+}
+/** 根程序短描述（单行摘要 + 多行补充） */
+export const CLI_ROOT_DESCRIPTION = [
+    'PlayCraft CLI：本地开发 Agent、素材处理、Playable 与各广告渠道打包、云端平台 API。',
+    '命令分区见下方；详情见 docs/cli/capabilities.md。',
+].join('\n');
+export function registerRootProgramHelp(program) {
+    program.addHelpText('before', () => getCliTopicsHelpText());
+}

package/dist/commands/audio.js

@@ -0,0 +1,219 @@
+import { getAudioInfo, compressAudio, trimAudio, convertAudio, fadeAudio, concatAudio, normalizeAudio, loopAudio, mixAudio, } from '../utils/audio-processor.js';
+/**
+ * Parse and validate `audio mix --volumes` / `--offsets` against `--inputs`.
+ */
+function buildValidatedMixTracks(inputs, volumeStrs, offsetStrs) {
+    const n = inputs.length;
+    if (volumeStrs.length > 0 && volumeStrs.length !== n) {
+        throw new Error(`--volumes: expected ${n} value(s) to match ${n} --inputs, got ${volumeStrs.length}`);
+    }
+    if (offsetStrs.length > 0 && offsetStrs.length !== n) {
+        throw new Error(`--offsets: expected ${n} value(s) to match ${n} --inputs, got ${offsetStrs.length}`);
+    }
+    return inputs.map((input, i) => {
+        let volume = 1.0;
+        let offset = 0;
+        const volRaw = volumeStrs[i];
+        const offRaw = offsetStrs[i];
+        if (volRaw !== undefined) {
+            const v = Number.parseFloat(volRaw);
+            if (!Number.isFinite(v)) {
+                throw new Error(`Invalid --volumes value for track ${i + 1}: "${volRaw}" is not a valid number`);
+            }
+            if (v < 0 || v > 1) {
+                throw new Error(`Invalid --volumes value for track ${i + 1}: ${v} (expected 0.0–1.0)`);
+            }
+            volume = v;
+        }
+        if (offRaw !== undefined) {
+            const o = Number.parseFloat(offRaw);
+            if (!Number.isFinite(o)) {
+                throw new Error(`Invalid --offsets value for track ${i + 1}: "${offRaw}" is not a valid number`);
+            }
+            if (o < 0) {
+                throw new Error(`Invalid --offsets value for track ${i + 1}: ${o} (must be >= 0 seconds)`);
+            }
+            offset = o;
+        }
+        return { input, volume, offset };
+    });
+}
+/**
+ * Register all local audio processing commands under `playcraft audio`.
+ * These commands run entirely locally using ffmpeg -- no API calls required.
+ */
+export function registerAudioCommands(program) {
+    const audio = program
+        .command('audio')
+        .description('素材工具：本地音频处理（ffmpeg，不调用 API）');
+    // ── audio-info ──────────────────────────────────────────────────────────
+    audio
+        .command('info')
+        .description('获取音频文件元信息（时长/体积/格式/比特率/采样率/声道数）')
+        .requiredOption('--input <file>', '输入音频文件路径')
+        .action(async (opts) => {
+        try {
+            const info = await getAudioInfo(opts.input);
+            console.log(JSON.stringify(info, null, 2));
+        }
+        catch (err) {
+            console.error('audio info failed:', err.message);
+            process.exit(1);
+        }
+    });
+    // ── audio-compress ───────────────────────────────────────────────────────
+    audio
+        .command('compress')
+        .description('压缩音频文件（降低比特率/采样率，转单声道，或指定目标体积）')
+        .requiredOption('--input <file>', '输入音频文件路径')
+        .requiredOption('--output <file>', '输出音频文件路径')
+        .option('--bitrate <kbps>', '目标比特率（kbps），如 64', parseInt)
+        .option('--sample-rate <hz>', '目标采样率（Hz），如 22050', parseInt)
+        .option('--mono', '转为单声道', false)
+        .option('--target-size <size>', '目标体积（自动计算比特率），如 30KB、1.5MB')
+        .action(async (opts) => {
+        try {
+            await compressAudio(opts.input, opts.output, {
+                bitrate: opts.bitrate,
+                sampleRate: opts.sampleRate,
+                mono: opts.mono,
+                targetSize: opts.targetSize,
+            });
+            const info = await getAudioInfo(opts.output);
+            console.log(`Compressed: ${opts.output} (${(info.fileSize / 1024).toFixed(1)}KB, ${info.bitrate}kbps)`);
+        }
+        catch (err) {
+            console.error('audio compress failed:', err.message);
+            process.exit(1);
+        }
+    });
+    // ── audio-trim ───────────────────────────────────────────────────────────
+    audio
+        .command('trim')
+        .description('裁剪音频到指定时间范围')
+        .requiredOption('--input <file>', '输入音频文件路径')
+        .requiredOption('--output <file>', '输出音频文件路径')
+        .requiredOption('--start <seconds>', '起始时间（秒）', parseFloat)
+        .requiredOption('--end <seconds>', '结束时间（秒）', parseFloat)
+        .action(async (opts) => {
+        try {
+            await trimAudio(opts.input, opts.output, opts.start, opts.end);
+            const info = await getAudioInfo(opts.output);
+            console.log(`Trimmed: ${opts.output} (${info.duration.toFixed(2)}s, ${(info.fileSize / 1024).toFixed(1)}KB)`);
+        }
+        catch (err) {
+            console.error('audio trim failed:', err.message);
+            process.exit(1);
+        }
+    });
+    // ── audio-convert ────────────────────────────────────────────────────────
+    audio
+        .command('convert')
+        .description('音频格式转换（如 WAV → MP3）')
+        .requiredOption('--input <file>', '输入音频文件路径')
+        .requiredOption('--output <file>', '输出音频文件路径（扩展名决定格式）')
+        .option('--bitrate <kbps>', '目标比特率（kbps）', parseInt)
+        .action(async (opts) => {
+        try {
+            await convertAudio(opts.input, opts.output, opts.bitrate);
+            const info = await getAudioInfo(opts.output);
+            console.log(`Converted: ${opts.output} (${info.format}, ${(info.fileSize / 1024).toFixed(1)}KB)`);
+        }
+        catch (err) {
+            console.error('audio convert failed:', err.message);
+            process.exit(1);
+        }
+    });
+    // ── audio-fade ───────────────────────────────────────────────────────────
+    audio
+        .command('fade')
+        .description('为音频添加淡入/淡出效果')
+        .requiredOption('--input <file>', '输入音频文件路径')
+        .requiredOption('--output <file>', '输出音频文件路径')
+        .option('--fade-in <seconds>', '淡入时长（秒）', parseFloat)
+        .option('--fade-out <seconds>', '淡出时长（秒）', parseFloat)
+        .action(async (opts) => {
+        try {
+            await fadeAudio(opts.input, opts.output, {
+                fadeIn: opts.fadeIn,
+                fadeOut: opts.fadeOut,
+            });
+            console.log(`Faded: ${opts.output}`);
+        }
+        catch (err) {
+            console.error('audio fade failed:', err.message);
+            process.exit(1);
+        }
+    });
+    // ── audio-concat ─────────────────────────────────────────────────────────
+    audio
+        .command('concat')
+        .description('将多个音频文件顺序拼接为一个')
+        .requiredOption('--inputs <files...>', '输入音频文件列表')
+        .requiredOption('--output <file>', '输出音频文件路径')
+        .action(async (opts) => {
+        try {
+            await concatAudio({ inputs: opts.inputs, output: opts.output });
+            const info = await getAudioInfo(opts.output);
+            console.log(`Concatenated: ${opts.output} (${info.duration.toFixed(2)}s, ${(info.fileSize / 1024).toFixed(1)}KB)`);
+        }
+        catch (err) {
+            console.error('audio concat failed:', err.message);
+            process.exit(1);
+        }
+    });
+    // ── audio-normalize ──────────────────────────────────────────────────────
+    audio
+        .command('normalize')
+        .description('音量归一化（LUFS 响度标准化）')
+        .requiredOption('--input <file>', '输入音频文件路径')
+        .requiredOption('--output <file>', '输出音频文件路径')
+        .option('--target-loudness <lufs>', '目标响度（LUFS），如 -16', parseFloat, -16)
+        .action(async (opts) => {
+        try {
+            await normalizeAudio(opts.input, opts.output, opts.targetLoudness);
+            console.log(`Normalized: ${opts.output} (target: ${opts.targetLoudness} LUFS)`);
+        }
+        catch (err) {
+            console.error('audio normalize failed:', err.message);
+            process.exit(1);
+        }
+    });
+    // ── audio-loop ───────────────────────────────────────────────────────────
+    audio
+        .command('loop')
+        .description('对音频进行无缝循环处理（首尾交叉淡化）')
+        .requiredOption('--input <file>', '输入音频文件路径')
+        .requiredOption('--output <file>', '输出音频文件路径')
+        .option('--crossfade <seconds>', '交叉淡化时长（秒），默认 0.5', parseFloat, 0.5)
+        .action(async (opts) => {
+        try {
+            await loopAudio(opts.input, opts.output, opts.crossfade);
+            console.log(`Loop processed: ${opts.output} (crossfade=${opts.crossfade}s)`);
+        }
+        catch (err) {
+            console.error('audio loop failed:', err.message);
+            process.exit(1);
+        }
+    });
+    // ── audio-mix ────────────────────────────────────────────────────────────
+    audio
+        .command('mix')
+        .description('多轨混音（叠加多个音频，可指定音量和时间偏移）')
+        .requiredOption('--inputs <files...>', '输入音频文件列表')
+        .requiredOption('--output <file>', '输出音频文件路径')
+        .option('--volumes <values...>', '各轨音量（0.0-1.0），数量需与 --inputs 一致，默认全为 1.0', (val, prev) => [...prev, val], [])
+        .option('--offsets <values...>', '各轨时间偏移（秒），数量需与 --inputs 一致，默认全为 0', (val, prev) => [...prev, val], [])
+        .action(async (opts) => {
+        try {
+            const tracks = buildValidatedMixTracks(opts.inputs, opts.volumes, opts.offsets);
+            await mixAudio(tracks, opts.output);
+            const info = await getAudioInfo(opts.output);
+            console.log(`Mixed: ${opts.output} (${tracks.length} tracks, ${info.duration.toFixed(2)}s, ${(info.fileSize / 1024).toFixed(1)}KB)`);
+        }
+        catch (err) {
+            console.error('audio mix failed:', err.message);
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/build-all.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, detectAmmoUsage } from '@playcraft/build';
+import { BaseBuilder, ViteBuilder, PlayableBuilder, EngineDetector, detectAmmoUsage } from '@playcraft/build';
 import { loadBuildConfig } from '../build-config.js';
 import inquirer from 'inquirer';
 /**
@@ -56,7 +56,7 @@ const platformFormatConfig = {
     moloco: { formats: ['html'], default: 'html' },
     adikteev: { formats: ['html'], default: 'html' },
     remerge: { formats: ['html'], default: 'html' },
-    google: { formats: ['zip'], default: 'zip' },
+    google: { formats: ['html', 'zip'], default: 'html' },
     tiktok: { formats: ['zip'], default: 'zip' },
     liftoff: { formats: ['zip'], default: 'zip' },
     bigo: { formats: ['zip'], default: 'zip' },
@@ -146,7 +146,7 @@ export async function buildAllCommand(projectPath, options) {
         let targetPlatforms;
         if (options.platforms) {
             // 命令行指定了平台列表
-            targetPlatforms = options.platforms.split(',').map(p => p.trim()).filter(p => ALL_PLATFORMS.includes(p));
+            targetPlatforms = options.platforms.split(',').map(p => p.trim()).filter((p) => ALL_PLATFORMS.includes(p));
             if (targetPlatforms.length === 0) {
                 throw new Error(`无效的平台列表: ${options.platforms}\n可用平台: ${ALL_PLATFORMS.join(', ')}`);
             }
@@ -167,7 +167,7 @@ export async function buildAllCommand(projectPath, options) {
                         { name: '🌐 全部渠道（13个）', value: 'all' },
                         { name: '⭐ 主流渠道（facebook, google, tiktok, applovin, ironsource, unity）', value: 'mainstream' },
                         { name: '📄 仅 HTML 渠道（applovin, ironsource, unity, moloco, adikteev, remerge）', value: 'html' },
-                        { name: '📦 仅 ZIP 渠道（google, tiktok, liftoff, bigo, snapchat, inmobi）', value: 'zip' },
+                        { name: '📦 仅 ZIP 渠道（tiktok, liftoff, bigo, snapchat, inmobi）', value: 'zip' },
                         { name: '🔧 自定义选择', value: 'custom' },
                     ],
                 },
@@ -242,7 +242,11 @@ export async function buildAllCommand(projectPath, options) {
             spinner.start(pc.cyan('🚀 批量打渠道包...'));
         }
         // 3.5 输入商店跳转地址（CTA）- 必填
-        if (!options.iosStoreUrl || !options.androidStoreUrl) {
+        // 先从配置文件读取 storeUrls（loadBuildConfig 从 build 字段读取）
+        const configStoreUrls = fileConfig?.storeUrls;
+        let iosUrl = options.iosStoreUrl || configStoreUrls?.ios || '';
+        let androidUrl = options.androidStoreUrl || configStoreUrls?.android || '';
+        if (!iosUrl || !androidUrl) {
             spinner.stop();
             console.log(pc.cyan('\n🔗 商店跳转地址（CTA 按钮目标）'));
             console.log(pc.dim('   iOS 和 Android 地址均为必填'));
@@ -251,22 +255,134 @@ export async function buildAllCommand(projectPath, options) {
                     type: 'input',
                     name: 'iosStoreUrl',
                     message: 'iOS App Store URL:',
-                    default: options.iosStoreUrl || '',
+                    default: iosUrl,
                     validate: (input) => input.trim() ? true : '请输入 iOS App Store URL',
                 },
                 {
                     type: 'input',
                     name: 'androidStoreUrl',
                     message: 'Android Google Play URL:',
-                    default: options.androidStoreUrl || '',
+                    default: androidUrl,
                     validate: (input) => input.trim() ? true : '请输入 Android Google Play URL',
                 },
             ]);
-            options.iosStoreUrl = storeUrlAnswer.iosStoreUrl.trim();
-            options.androidStoreUrl = storeUrlAnswer.androidStoreUrl.trim();
+            iosUrl = storeUrlAnswer.iosStoreUrl.trim();
+            androidUrl = storeUrlAnswer.androidStoreUrl.trim();
             spinner.start(pc.cyan('🚀 批量打渠道包...'));
         }
-        // 4. 执行阶段1：Base Build（只执行一次）
+        // 保存到 options 供后续使用
+        options.iosStoreUrl = iosUrl;
+        options.androidStoreUrl = androidUrl;
+        // 4. 检测引擎 + 构建工具
+        let detectionResult;
+        if (options.usePlayableScripts) {
+            detectionResult = { engine: 'generic', buildTool: 'playable-scripts' };
+            console.log(pc.cyan(`\n🔧 使用 @playcraft/devkit 构建工具（用户显式指定）`));
+        }
+        else {
+            detectionResult = await EngineDetector.detectFull(resolvedProjectPath);
+            if (detectionResult.buildTool === 'playable-scripts') {
+                console.log(pc.cyan(`\n🔧 检测到 @playcraft/devkit 构建工具`));
+                console.log(pc.dim('   将使用 playable-scripts builds 进行批量构建'));
+            }
+        }
+        const isPlayableScripts = detectionResult.buildTool === 'playable-scripts';
+        // 4.5 如果是 playable-scripts，使用其原生批量构建能力
+        if (isPlayableScripts) {
+            spinner.text = pc.cyan('使用 @playcraft/devkit 进行批量构建...');
+            // 主题选择：CLI 参数 > 交互式选择 > 默认主题
+            let selectedThemes;
+            const themeDir = path.join(resolvedProjectPath, 'src', 'theme');
+            if (options.theme) {
+                // 用户通过 --theme 参数指定了主题，清理可能的引号
+                const cleanTheme = options.theme.replace(/^["']|["']$/g, '');
+                selectedThemes = [cleanTheme];
+                console.log(pc.green(`\n✅ 使用指定主题: ${cleanTheme}`));
+            }
+            else {
+                // 交互式选择主题（如果项目有多个主题）
+                try {
+                    const themeEntries = await fs.readdir(themeDir, { withFileTypes: true });
+                    const availableThemes = themeEntries
+                        .filter(e => e.isDirectory() && !e.name.startsWith('.') && !e.name.startsWith('tiles-'))
+                        .map(e => e.name)
+                        .sort();
+                    if (availableThemes.length > 1) {
+                        spinner.stop();
+                        console.log(pc.cyan('\n🎨 选择要构建的主题:'));
+                        const themeAnswer = await inquirer.prompt([
+                            {
+                                type: 'list',
+                                name: 'theme',
+                                message: '选择主题:',
+                                choices: [
+                                    { name: '📌 使用当前默认主题 (src/theme/index.ts)', value: '__default__' },
+                                    ...availableThemes.map(t => ({ name: `🎨 ${t}`, value: t })),
+                                ],
+                                default: '__default__',
+                            },
+                        ]);
+                        if (themeAnswer.theme !== '__default__') {
+                            selectedThemes = [themeAnswer.theme];
+                            console.log(pc.green(`✅ 已选择主题: ${themeAnswer.theme}`));
+                        }
+                        else {
+                            console.log(pc.dim('   使用当前默认主题'));
+                        }
+                        spinner.start(pc.cyan('使用 @playcraft/devkit 进行批量构建...'));
+                    }
+                }
+                catch {
+                    // 无主题目录，跳过
+                }
+            }
+            // 构建 playableScripts 配置，将选中的渠道和主题传入
+            // 商店地址优先级：CLI 参数 > 配置文件 > 交互式输入
+            const psConfig = {
+                ...fileConfig?.playableScripts,
+                channels: targetPlatforms,
+                outputDir: path.resolve(options.output || './dist'),
+                storeUrls: {
+                    ios: options.iosStoreUrl || '',
+                    android: options.androidStoreUrl || '',
+                },
+            };
+            // 如果选择了具体主题，添加到配置
+            if (selectedThemes && selectedThemes.length > 0) {
+                psConfig.themes = {
+                    enabled: true,
+                    whitelist: selectedThemes,
+                };
+            }
+            const outputDir = path.resolve(options.output || './dist');
+            const baseBuilder = new BaseBuilder(resolvedProjectPath, {
+                outputDir,
+            }, {
+                usePlayableScripts: true,
+                playableScriptsConfig: psConfig,
+            });
+            const baseBuild = await baseBuilder.build();
+            spinner.succeed(pc.green('📦 @playcraft/devkit 批量构建完成！'));
+            // 显示产物信息
+            const outputBaseDir = baseBuild.outputDir;
+            console.log('\n' + pc.bold('构建产物:'));
+            if (baseBuild.files.assets.length > 0) {
+                for (const asset of baseBuild.files.assets) {
+                    try {
+                        const stat = await fs.stat(asset);
+                        const sizeMB = (stat.size / 1024 / 1024).toFixed(2);
+                        console.log(`  - ${path.relative(outputBaseDir, asset)}: ${sizeMB} MB`);
+                    }
+                    catch {
+                        console.log(`  - ${path.relative(outputBaseDir, asset)}`);
+                    }
+                }
+            }
+            console.log('\n' + pc.green(`输出目录: ${outputBaseDir}`));
+            console.log(pc.dim('💡 产物已包含渠道适配、MRAID 注入、代码混淆和 fflate 压缩'));
+            return;
+        }
+        // 5. 执行阶段1：Base Build（只执行一次，非 playable-scripts 流程）
         isBaseBuild = await detectBaseBuild(resolvedProjectPath);
         if (isBaseBuild) {
             spinner.text = pc.cyan('✅ 检测到多文件构建产物，跳过阶段1');
@@ -285,7 +401,7 @@ export async function buildAllCommand(projectPath, options) {
             spinner.succeed(pc.green('✅ 阶段1: 基础构建完成'));
             spinner.start(pc.cyan('开始阶段2: 批量渠道打包...'));
         }
-        // 5. 检测 Ammo.js 并处理
+        // 6. 检测 Ammo.js 并处理
         const ammoCheck = await detectAmmoUsage(baseBuildDir);
         let ammoReplacement;
         if (options.ammoEngine === 'p2' || options.ammoEngine === 'cannon') {
@@ -319,7 +435,7 @@ export async function buildAllCommand(projectPath, options) {
             }
             spinner.start(pc.cyan('开始阶段2: 批量渠道打包...'));
         }
-        // 6. 逐个渠道执行阶段2
+        // 7. 逐个渠道执行阶段2
         const outputBaseDir = path.resolve(options.output || './dist');
         const results = [];
         const startTime = Date.now();
@@ -407,7 +523,7 @@ export async function buildAllCommand(projectPath, options) {
         }
         const totalDuration = Date.now() - startTime;
         spinner.stop();
-        // 7. 输出汇总报告
+        // 8. 输出汇总报告
         const successCount = results.filter(r => r.success).length;
         const failCount = results.filter(r => !r.success).length;
         console.log('\n' + pc.bold('═══════════════════════════════════════════'));