@playcraft/devkit 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Smoud
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/cli/bin/playable-scripts.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+"use strict";process.on("unhandledRejection",err=>{throw err});const spawn=require("cross-spawn");const args=process.argv.slice(2);const scriptIndex=args.findIndex(x=>x==="build"||x==="dev"||x==="builds");const script=scriptIndex===-1?args[0]:args[scriptIndex];const nodeArgs=scriptIndex>0?args.slice(0,scriptIndex):[];if(["build","dev","builds"].includes(script)){const result=spawn.sync(process.execPath,nodeArgs.concat(require.resolve("../commands/"+script)).concat(args.slice(scriptIndex+1)),{stdio:"inherit"});if(result.signal){if(result.signal==="SIGKILL"){console.log("The build failed because the process exited too early. "+"This probably means the system ran out of memory or someone called "+"`kill -9` on the process.")}else if(result.signal==="SIGTERM"){console.log("The build failed because the process exited too early. "+"Someone might have called `kill` or `killall`, or the system could "+"be shutting down.")}process.exit(1)}process.exit(result.status)}else{console.log("Unknown script \""+script+"\".")}

package/cli/commands/build.js

@@ -0,0 +1 @@
+"use strict";process.env.BABEL_ENV="production";process.env.NODE_ENV="production";const{runBuild}=require("../../core/webpack.build.js");runBuild();

package/cli/commands/builds.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+"use strict";/**
+ * Batch Builds Command for playable-scripts
+ * 
+ * 支持：
+ * - 单个主题下多个渠道的并发构建
+ * - 独立临时目录，避免并发冲突
+ * - 灵活的配置系统
+ * 
+ * 使用方法：
+ * playable-scripts builds                              # 使用默认配置
+ * playable-scripts builds -t "theme1,theme2"          # 指定主题
+ * playable-scripts builds -c "google,facebook"        # 指定渠道
+ * playable-scripts builds -t "theme1" -c "google"     # 指定主题和渠道
+ * playable-scripts builds --parallel 3                 # 设置并发数
+ */process.on("unhandledRejection",err=>{throw err});const{buildBatch}=require("../../core/batch-build");buildBatch();

package/cli/commands/dev.js

@@ -0,0 +1 @@
+"use strict";process.env.BABEL_ENV="development";process.env.NODE_ENV="development";const{runDev}=require("../../core/webpack.dev.js");runDev();

package/core/batch-build.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+"use strict";/**
+ * 批量构建核心模块
+ * 
+ * 核心特性:
+ * 1. 支持单个主题下多个渠道的并发构建
+ * 2. 每个构建任务使用独立的临时目录（dist-temp-{taskId}）
+ * 3. 构建完成后自动移动到目标目录并清理临时目录
+ * 4. 支持灵活的配置系统
+ */const{execSync,exec}=require("child_process");const fs=require("fs");const path=require("path");const os=require("os");const{promisify}=require("util");const{uploadDirectoryToCOS}=require("./cos-uploader");const execAsync=promisify(exec);// ==================== 默认配置 ====================
+/**
+ * 计算默认并发数
+ * 策略: CPU 核心数 - 1，最小为 2，最大为 8
+ * 例如:
+ * - 4 核 CPU → 3 并发
+ * - 8 核 CPU → 7 并发
+ * - 16 核 CPU → 8 并发（限制最大值）
+ */function getDefaultParallel(){const cpuCount=os.cpus().length;const calculated=Math.max(2,cpuCount-1);// 至少 2 个并发
+const parallel=Math.min(8,calculated);// 最多 8 个并发
+return parallel}const DEFAULT_CONFIG={title:"Phaser Game",appName:"",// 用于从远程仓库拉取配置
+channels:["google","facebook","tiktok","applovin","ironSource","unity","moloco","liftoff","bigoads"],themes:{enabled:true,sourceDir:"src/theme",entryFile:"src/theme/index.ts",whitelist:null},naming:{language:"EN",format:"\u65E0",supplier:"AIX",follower:"ZQL"},build:{outputDir:"dist-all",tempDirPrefix:"dist-temp",continueOnError:true,cleanTemp:true,parallel:getDefaultParallel()// 根据 CPU 核心数自动设置
+},// COS 配置（可选）
+cosConfig:null// 如果配置，则自动为每个主题生成 preview 渠道并上传
+};// ==================== 工具函数 ====================
+let isExiting=false;let backupContent=null;let backupPath=null;const activeTempDirs=new Set;// 跟踪所有活动的临时目录
+function log(message,level="info"){const timestamp=new Date().toLocaleTimeString();const colors={info:"\x1B[36m",success:"\x1B[32m",error:"\x1B[31m",warn:"\x1B[33m",debug:"\x1B[90m"};const reset="\x1B[0m";const prefix={info:"\uD83D\uDCE6",success:"\u2705",error:"\u274C",warn:"\u26A0\uFE0F",debug:"\uD83D\uDD0D"}[level]||"\u2139\uFE0F";console.log(`${colors[level]}[${timestamp}] ${prefix} ${message}${reset}`)}function getCurrentMonth(){const month=new Date().getMonth()+1;return`${month}月`}function getCurrentDate(){const date=new Date;const year=date.getFullYear();const month=String(date.getMonth()+1).padStart(2,"0");const day=String(date.getDate()).padStart(2,"0");return`${year}${month}${day}`}function defaultFileNameGenerator(config,themeName,channel){const parts=[themeName,config.naming.language,config.naming.format,getCurrentMonth(),getCurrentDate(),config.naming.supplier,config.naming.follower,channel.toLowerCase()].filter(item=>!!item);return parts.join("-")}function getAllThemes(config,projectRoot){const themesDir=path.join(projectRoot,config.themes.sourceDir);if(!fs.existsSync(themesDir)){log(`主题目录不存在: ${themesDir}`,"warn");return[]}const entries=fs.readdirSync(themesDir,{withFileTypes:true});let themes=entries.filter(entry=>entry.isDirectory()).map(entry=>entry.name).sort();if(config.themes.whitelist&&typeof config.themes.whitelist==="function"){themes=themes.filter(config.themes.whitelist);log(`应用主题白名单过滤: ${themes.length} 个主题`,"debug")}return themes}function backupEntryFile(config,projectRoot){const entryPath=path.join(projectRoot,config.themes.entryFile);if(!fs.existsSync(entryPath)){throw new Error(`入口文件不存在: ${entryPath}`)}backupPath=entryPath;backupContent=fs.readFileSync(entryPath,"utf8");log(`已备份入口文件: ${config.themes.entryFile}`,"debug")}function restoreEntryFile(){if(backupPath&&backupContent){fs.writeFileSync(backupPath,backupContent,"utf8");log(`已恢复入口文件`,"debug");backupPath=null;backupContent=null}}function switchTheme(config,themeName,projectRoot){const entryPath=path.join(projectRoot,config.themes.entryFile);// 使用配置文件中的 generateEntryFile 函数（如果提供）
+let content;if(config.themes.switching&&typeof config.themes.switching.generateEntryFile==="function"){content=config.themes.switching.generateEntryFile(themeName)}else{// 兼容旧格式：简化的 export 语句
+const themePath=`./${themeName}`;content=`export { default } from '${themePath}';\n`}fs.writeFileSync(entryPath,content,"utf8");log(`已切换主题: ${themeName}`,"debug")}/**
+ * 生成唯一的任务 ID
+ */function generateTaskId(){return`${Date.now()}-${Math.random().toString(36).substr(2,9)}`}/**
+ * 创建独立的临时目录
+ */function createTempDir(config,projectRoot,taskId){const tempDir=path.join(projectRoot,`${config.build.tempDirPrefix}-${taskId}`);if(fs.existsSync(tempDir)){fs.rmSync(tempDir,{recursive:true,force:true})}fs.mkdirSync(tempDir,{recursive:true});activeTempDirs.add(tempDir);return tempDir}/**
+ * 清理临时目录
+ */function cleanTempDir(tempDir){if(fs.existsSync(tempDir)){try{fs.rmSync(tempDir,{recursive:true,force:true});activeTempDirs.delete(tempDir);log(`已清理目录: ${path.basename(tempDir)}`,"debug")}catch(error){log(`清理临时目录失败: ${error.message}`,"warn")}}}/**
+ * 清理所有活动的临时目录
+ */function cleanAllTempDirs(){for(const tempDir of activeTempDirs){cleanTempDir(tempDir)}activeTempDirs.clear()}/**
+ * 递归复制目录
+ */function copyDirRecursive(src,dest){if(!fs.existsSync(dest)){fs.mkdirSync(dest,{recursive:true})}const entries=fs.readdirSync(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()){copyDirRecursive(srcPath,destPath)}else{fs.copyFileSync(srcPath,destPath)}}}/**
+ * 构建单个渠道（使用独立临时目录）
+ */async function buildChannel(config,themeName,channel,outputDir,projectRoot){const taskId=generateTaskId();const tempDir=createTempDir(config,projectRoot,taskId);log(`开始构建: 主题=${themeName}, 渠道=${channel}, 任务ID=${taskId.substr(0,8)}...`);try{// 生成文件名
+const fileName=config.naming.generator?config.naming.generator(themeName,channel,getCurrentDate(),getCurrentMonth()):defaultFileNameGenerator(config,themeName,channel);log(`文件名: ${fileName}`,"debug");// 执行构建，指定独立的输出目录（使用绝对路径）
+// 注意：
+// 1. 命令行参数使用 --out-dir (连字符格式)
+// 2. 通过环境变量 PLAYABLE_FILENAME 传递文件名，避免并发时修改 build.json 导致竞态条件
+// 3. 使用 execAsync 实现真正的并发构建
+// 4. 商店链接会自动从 builds.config.js 或 build.json 读取，无需通过命令行传递
+await execAsync(`npm run build -- ${channel} --out-dir "${tempDir}"`,{cwd:projectRoot,env:{...process.env,PLAYABLE_BUILD_TASK_ID:taskId,PLAYABLE_FILENAME:fileName// 通过环境变量传递文件名
+},// 不使用 stdio: 'inherit' 以支持并发，而是捕获输出
+maxBuffer:10*1024*1024// 10MB buffer
+});// 移动构建产物到目标目录
+const targetDir=path.join(outputDir,themeName,channel);if(fs.existsSync(tempDir)){if(!fs.existsSync(targetDir)){fs.mkdirSync(targetDir,{recursive:true})}const files=fs.readdirSync(tempDir);files.forEach(file=>{const srcPath=path.join(tempDir,file);const destPath=path.join(targetDir,file);if(fs.statSync(srcPath).isDirectory()){copyDirRecursive(srcPath,destPath)}else{fs.copyFileSync(srcPath,destPath)}});log(`✓ 构建成功: ${themeName}/${channel}`,"success")}// 清理临时目录
+if(config.build.cleanTemp){cleanTempDir(tempDir)}return{success:true,theme:themeName,channel}}catch(error){log(`构建失败: ${themeName}/${channel} - ${error.message}`,"error");// 清理临时目录
+if(config.build.cleanTemp){cleanTempDir(tempDir)}if(!config.build.continueOnError){throw error}return{success:false,theme:themeName,channel,error:error.message}}}/**
+ * 并发构建多个渠道
+ */async function buildChannelsInParallel(config,themeName,channels,outputDir,projectRoot){const maxParallel=config.build.parallel||3;const results=[];// 分批并发构建
+for(let i=0;i<channels.length;i+=maxParallel){const batch=channels.slice(i,i+maxParallel);const batchPromises=batch.map(channel=>buildChannel(config,themeName,channel,outputDir,projectRoot));const batchResults=await Promise.allSettled(batchPromises);batchResults.forEach((result,index)=>{if(result.status==="fulfilled"){results.push(result.value)}else{var _result$reason;results.push({success:false,theme:themeName,channel:batch[index],error:((_result$reason=result.reason)===null||_result$reason===void 0?void 0:_result$reason.message)||"\u672A\u77E5\u9519\u8BEF"})}})}return results}/**
+ * 解析命令行参数
+ */function parseArgs(){const args=process.argv.slice(2);const result={themes:null,channels:null,parallel:null};for(let i=0;i<args.length;i++){const currentArg=args[i];const nextArg=args[i+1];// 支持 -t 和 --themes 格式
+if(currentArg==="-t"||currentArg==="--themes"){if(nextArg&&!nextArg.startsWith("-")){result.themes=nextArg.split(",").map(t=>t.trim()).filter(Boolean);i++}}// 支持 -c 和 --channels 格式
+else if(currentArg==="-c"||currentArg==="--channels"){if(nextArg&&!nextArg.startsWith("-")){result.channels=nextArg.split(",").map(c=>c.trim()).filter(Boolean);i++}}// 支持 -p 和 --parallel 格式
+else if(currentArg==="-p"||currentArg==="--parallel"){if(nextArg&&!nextArg.startsWith("-")){result.parallel=parseInt(nextArg,10);i++}}// 支持 --themes=value 格式（Windows PowerShell 兼容）
+else if(currentArg.startsWith("--themes=")){result.themes=currentArg.substring(9).split(",").map(t=>t.trim()).filter(Boolean)}// 支持 --channels=value 格式（Windows PowerShell 兼容）
+else if(currentArg.startsWith("--channels=")){result.channels=currentArg.substring(11).split(",").map(c=>c.trim()).filter(Boolean)}// 支持 --parallel=value 格式（Windows PowerShell 兼容）
+else if(currentArg.startsWith("--parallel=")){result.parallel=parseInt(currentArg.substring(11),10)}// 兼容位置参数：第一个参数作为主题，第二个作为渠道
+else if(!currentArg.startsWith("-")&&result.themes===null){result.themes=[currentArg]}else if(!currentArg.startsWith("-")&&result.themes!==null&&result.channels===null){result.channels=[currentArg]}}return result}// 远程配置仓库地址
+const REMOTE_CONFIG_REPO="";/**
+ * 执行命令并返回结果
+ * @param {string} command - 要执行的命令
+ * @param {object} options - execSync 选项
+ * @returns {string|null} 命令输出，失败返回 null
+ */function execCommand(command,options={}){const{execSync}=require("child_process");try{return execSync(command,{encoding:"utf-8",stdio:["pipe","pipe","pipe"],...options}).trim()}catch(error){return null}}/**
+ * 从远程仓库获取配置文件内容
+ * 使用 git clone 方式获取，读取后删除临时目录
+ * 
+ * @param {string} appName - 应用名称，对应远程仓库中的文件夹名
+ * @returns {Promise<object|null>} 远程配置对象，失败返回 null
+ */async function fetchRemoteConfig(appName){if(!appName||!REMOTE_CONFIG_REPO)return null;const os=require("os");// 使用系统临时目录
+const tempDir=path.join(os.tmpdir(),`playable-config-${Date.now()}`);log(`尝试从远程仓库拉取配置: ${appName}`,"info");log(`仓库地址: ${REMOTE_CONFIG_REPO}`,"debug");try{// 创建临时目录
+fs.mkdirSync(tempDir,{recursive:true});// 克隆远程仓库到临时目录
+log("\u514B\u9686\u8FDC\u7A0B\u914D\u7F6E\u4ED3\u5E93...","info");const cloneResult=execCommand(`git clone --depth 1 --quiet "${REMOTE_CONFIG_REPO}" "${tempDir}"`,{timeout:30000});if(cloneResult===null){log("git clone \u5931\u8D25\uFF0C\u8BF7\u68C0\u67E5\u7F51\u7EDC\u8FDE\u63A5\u548C\u4ED3\u5E93\u6743\u9650","error");return null}log("\u2713 \u8FDC\u7A0B\u914D\u7F6E\u4ED3\u5E93\u514B\u9686\u6210\u529F","success");// 检查 appName 对应的文件夹是否存在
+const appConfigDir=path.join(tempDir,appName);if(!fs.existsSync(appConfigDir)){log(`远程仓库中未找到 "${appName}" 文件夹`,"warn");// 列出可用的配置文件夹供参考
+const availableDirs=fs.readdirSync(tempDir).filter(name=>{const itemPath=path.join(tempDir,name);return fs.statSync(itemPath).isDirectory()&&!name.startsWith(".")});if(availableDirs.length>0){log(`可用的 appName: ${availableDirs.join(", ")}`,"info")}return null}// 检查配置文件是否存在
+const configFilePath=path.join(appConfigDir,"build.config.js");if(!fs.existsSync(configFilePath)){log(`"${appName}" 文件夹中未找到 build.config.js`,"warn");return null}// 读取配置文件内容并解析
+// 使用 vm 模块执行，避免 require 缓存问题
+const vm=require("vm");const configContent=fs.readFileSync(configFilePath,"utf-8");const sandbox={module:{exports:{}},exports:{},require:require};sandbox.exports=sandbox.module.exports;try{vm.runInNewContext(configContent,sandbox);log(`✓ 成功加载远程配置: ${appName}`,"success");return sandbox.module.exports}catch(parseError){log(`解析远程配置文件失败: ${parseError.message}`,"error");return null}}catch(error){log(`获取远程配置失败: ${error.message}`,"warn");return null}finally{// 无论成功与否，都删除临时目录
+if(fs.existsSync(tempDir)){try{fs.rmSync(tempDir,{recursive:true,force:true});log("\u5DF2\u6E05\u7406\u4E34\u65F6\u76EE\u5F55","debug")}catch(cleanupError){log(`清理临时目录失败: ${cleanupError.message}`,"debug")}}}}/**
+ * 加载配置文件
+ * 
+ * 优先级: 本地 builds.config.js > 远程配置 > build.json > 默认值
+ * 
+ * 配置合并逻辑:
+ * 1. 首先读取本地 builds.config.js
+ * 2. 如果配置了 appName，从远程仓库拉取对应配置并合并（本地优先）
+ * 3. 读取 build.json 作为补充（向后兼容）
+ * 
+ * 兼容性说明:
+ * - builds.config.js: 新的推荐配置文件，支持所有配置项
+ * - build.json: 旧的配置文件，向后兼容，仅读取 app, name, google_play_url, app_store_url
+ * 
+ * 字段映射:
+ * - build.json.app + build.json.name → title (如果 builds.config.js 未指定)
+ * - build.json.google_play_url → googlePlayUrl
+ * - build.json.app_store_url → appStoreUrl
+ * 
+ * 忽略字段:
+ * - filename: 由批量构建自动生成
+ * - version: 不在批量构建中使用
+ */async function loadConfig(projectRoot){var _localConfig;const buildsConfigPath=path.join(projectRoot,"builds.config.js");const buildJsonPath=path.join(projectRoot,"build.json");let config={...DEFAULT_CONFIG};let localConfig=null;// 1. 先尝试加载本地 builds.config.js
+if(fs.existsSync(buildsConfigPath)){log("\u52A0\u8F7D\u914D\u7F6E\u6587\u4EF6: builds.config.js","debug");// 清除 require 缓存，确保读取最新配置
+delete require.cache[buildsConfigPath];localConfig=require(buildsConfigPath)}else{log("\u672A\u627E\u5230 builds.config.js\uFF0C\u4F7F\u7528\u9ED8\u8BA4\u914D\u7F6E","debug")}// 2. 如果配置了 appName，从远程仓库拉取配置并合并
+const appName=(_localConfig=localConfig)===null||_localConfig===void 0?void 0:_localConfig.appName;if(appName){const remoteConfig=await fetchRemoteConfig(appName);if(remoteConfig){// 远程配置先合并到默认配置
+config=mergeConfig(config,remoteConfig);log(`已合并远程配置: ${appName}`,"info")}}// 3. 本地配置具有最高优先级，覆盖远程配置
+if(localConfig){config=mergeConfig(config,localConfig)}// 5. 尝试加载 build.json 作为补充（向后兼容）
+if(fs.existsSync(buildJsonPath)){try{const buildJson=JSON.parse(fs.readFileSync(buildJsonPath,"utf8"));log("\u68C0\u6D4B\u5230 build.json\uFF0C\u8BFB\u53D6\u517C\u5BB9\u914D\u7F6E","debug");// 合并 app + name 为 title（仅当 builds.config.js 未指定时）
+if(!config.title||config.title===DEFAULT_CONFIG.title){if(buildJson.app&&buildJson.name){config.title=`${buildJson.app} ${buildJson.name}`;log(`  ├─ title: "${config.title}" (来自 build.json)`,"debug")}else if(buildJson.app){config.title=buildJson.app;log(`  ├─ title: "${config.title}" (来自 build.json.app)`,"debug")}else if(buildJson.name){config.title=buildJson.name;log(`  ├─ title: "${config.title}" (来自 build.json.name)`,"debug")}}// 读取商店链接（如果 builds.config.js 未指定）
+if(buildJson.google_play_url&&!config.googlePlayUrl){config.googlePlayUrl=buildJson.google_play_url;log(`  ├─ googlePlayUrl: "${config.googlePlayUrl}" (来自 build.json)`,"debug")}if(buildJson.app_store_url&&!config.appStoreUrl){config.appStoreUrl=buildJson.app_store_url;log(`  └─ appStoreUrl: "${config.appStoreUrl}" (来自 build.json)`,"debug")}// 忽略的字段
+if(buildJson.filename){log("  \u26A0\uFE0F  build.json.filename \u5C06\u88AB\u5FFD\u7565\uFF08\u7531\u6279\u91CF\u6784\u5EFA\u81EA\u52A8\u751F\u6210\uFF09","debug")}if(buildJson.version){log("  \u26A0\uFE0F  build.json.version \u5C06\u88AB\u5FFD\u7565\uFF08\u4E0D\u5728\u6279\u91CF\u6784\u5EFA\u4E2D\u4F7F\u7528\uFF09","debug")}}catch(error){log(`⚠️  解析 build.json 失败: ${error.message}`,"warn")}}return config}/**
+ * 深度合并配置
+ */function mergeConfig(defaultConfig,userConfig){const result={...defaultConfig};for(const key in userConfig){if(typeof userConfig[key]==="object"&&!Array.isArray(userConfig[key])){result[key]={...defaultConfig[key],...userConfig[key]}}else{result[key]=userConfig[key]}}return result}/**
+ * 打印配置摘要
+ */function printSummary(config,themes,channels){var _os$cpus$;const totalBuilds=themes.length*channels.length;const cpuCount=os.cpus().length;const cpuModel=((_os$cpus$=os.cpus()[0])===null||_os$cpus$===void 0?void 0:_os$cpus$.model)||"Unknown";log("========================================");log("\u5F00\u59CB\u6279\u91CF\u6784\u5EFA\u4EFB\u52A1");log(`项目: ${config.title}`);log(`主题数: ${themes.length}`);log(`渠道数: ${channels.length}`);log(`总构建数: ${totalBuilds}`);log(`CPU: ${cpuCount} 核心 (${cpuModel.substring(0,40)}${cpuModel.length>40?"...":""})`);log(`并发数: ${config.build.parallel} (自动优化)`);log("========================================\n");if(themes.length<=10){log(`主题列表: ${themes.join(", ")}`,"debug")}log(`渠道列表: ${channels.join(", ")}`,"debug");log("")}// ==================== 主函数 ====================
+async function buildBatch(){const projectRoot=process.cwd();const startTime=Date.now();try{// 加载配置（包含远程配置合并）
+const config=await loadConfig(projectRoot);// 解析命令行参数
+const args=parseArgs();// 应用命令行参数
+if(args.parallel!==null){config.build.parallel=args.parallel}// 确定主题列表
+let themes;if(!config.themes.enabled){themes=[config.title.replace(/\s+/g,"-")]}else if(args.themes){themes=args.themes;log(`使用命令行指定的主题: ${themes.join(", ")}`,"info")}else{themes=getAllThemes(config,projectRoot);if(themes.length===0){throw new Error("\u672A\u627E\u5230\u4EFB\u4F55\u4E3B\u9898")}}// 确定渠道列表
+let channels=args.channels||config.channels;// 检查是否需要生成预览链接
+const needPreview=config.cosConfig&&config.cosConfig.enabled!==false&&config.cosConfig.SecretId&&config.cosConfig.SecretKey&&config.cosConfig.Bucket&&config.cosConfig.Region&&config.cosConfig.CdnDomain;// 如果配置了 COS，添加 preview 渠道
+if(needPreview){if(!channels.includes("preview")){channels=[...channels,"preview"];log("\u68C0\u6D4B\u5230 COS \u914D\u7F6E\uFF0C\u5DF2\u6DFB\u52A0 preview \u6E20\u9053","info")}}// 打印摘要
+printSummary(config,themes,channels);// 备份入口文件（如果启用主题切换）
+if(config.themes.enabled){backupEntryFile(config,projectRoot)}// 批量构建
+const outputDir=path.join(projectRoot,config.build.outputDir);const allResults=[];const previewLinks=[];// 存储预览链接
+// 批量构建前，清理一下目录
+cleanTempDir(outputDir);for(const theme of themes){// 切换主题
+if(config.themes.enabled){switchTheme(config,theme,projectRoot)}// 并发构建该主题的所有渠道
+const themeResults=await buildChannelsInParallel(config,theme,channels,outputDir,projectRoot);allResults.push(...themeResults);// 如果需要预览链接，上传 preview 渠道产物到 COS
+if(needPreview){const previewResult=themeResults.find(r=>r.channel==="preview"&&r.success);if(previewResult){try{const previewDir=path.join(outputDir,theme,"preview");// 去掉 theme 这一级目录，直接使用 PathPrefix
+const cosPrefix=config.cosConfig.PathPrefix||"";log(`开始上传 ${theme} 预览文件到 COS...`,"info");const uploadResults=await uploadDirectoryToCOS(config.cosConfig,previewDir,cosPrefix);// 保存预览链接
+uploadResults.forEach(result=>{previewLinks.push({theme,file:result.file,url:result.url})});log(`✓ ${theme} 预览文件上传成功`,"success")}catch(error){log(`上传 ${theme} 预览文件失败: ${error.message}`,"error")}}}// 打印进度
+const completedBuilds=allResults.length;const totalBuilds=themes.length*channels.length;const progress=Math.round(completedBuilds/totalBuilds*100);log(`进度: ${completedBuilds}/${totalBuilds} (${progress}%)`,"success")}// 恢复入口文件
+if(config.themes.enabled){restoreEntryFile()}// 确保清理所有临时目录
+if(config.build.cleanTemp){cleanAllTempDirs()}// 统计结果
+const successBuilds=allResults.filter(r=>r.success).length;const failedBuilds=allResults.filter(r=>!r.success);// 打印结果
+const duration=((Date.now()-startTime)/1000/60).toFixed(2);log("\n========================================");log("\uD83C\uDF89 \u6240\u6709\u6784\u5EFA\u4EFB\u52A1\u5B8C\u6210\uFF01","success");log(`✓ 成功构建: ${successBuilds}/${allResults.length}`);if(failedBuilds.length>0){log(`✗ 失败构建: ${failedBuilds.length}`,"warn");failedBuilds.forEach(({theme,channel,error})=>{log(`  - ${theme}/${channel}: ${error}`,"error")})}log(`⏱️  耗时: ${duration} 分钟`);log(`📁 输出目录: ${outputDir}`);// 打印预览链接
+if(previewLinks.length>0){log("\n========================================");log("\uD83D\uDD17 \u9884\u89C8\u94FE\u63A5","info");log("========================================");// 按主题分组
+const linksByTheme={};previewLinks.forEach(link=>{if(!linksByTheme[link.theme]){linksByTheme[link.theme]=[]}linksByTheme[link.theme].push(link)});// 打印链接
+Object.keys(linksByTheme).sort().forEach(theme=>{log(`\n📦 ${theme}:`,"info");linksByTheme[theme].forEach(link=>{console.log(`${link.url}`)})});log("\n========================================")}log("========================================")}catch(error){log(`严重错误: ${error.message}`,"error");console.error(error);restoreEntryFile();cleanAllTempDirs();process.exit(1)}}// ==================== 信号处理 ====================
+function cleanup(){if(isExiting)return;isExiting=true;log("\n\u6536\u5230\u4E2D\u65AD\u4FE1\u53F7\uFF0C\u6B63\u5728\u6E05\u7406...","warn");restoreEntryFile();cleanAllTempDirs();process.exit(1)}process.on("SIGINT",cleanup);process.on("SIGTERM",cleanup);// ==================== 导出 ====================
+module.exports={buildBatch};

package/core/cos-uploader.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+"use strict";/**
+ * COS 上传模块
+ * 
+ * 功能：上传文件到腾讯云 COS，并刷新 CDN 缓存
+ */const COS=require("cos-nodejs-sdk-v5");const fs=require("fs");const path=require("path");/**
+ * 创建 COS 客户端
+ */function createCOSClient(cosConfig){if(!cosConfig||!cosConfig.SecretId||!cosConfig.SecretKey){throw new Error("COS \u914D\u7F6E\u7F3A\u5931\uFF1A\u9700\u8981 SecretId \u548C SecretKey")}return new COS({SecretId:cosConfig.SecretId,SecretKey:cosConfig.SecretKey})}/**
+ * 刷新 CDN 缓存
+ * 
+ * @param {Object} cosConfig - COS 配置
+ * @param {Array<string>} urls - 需要刷新的 URL 列表
+ * @returns {Promise<void>}
+ */async function purgeCDNCache(cosConfig,urls){if(!urls||urls.length===0){return}// 如果没有配置 CDN 刷新，跳过
+if(!cosConfig.CdnDomain){console.log("\u26A0\uFE0F  \u672A\u914D\u7F6E CdnDomain\uFF0C\u8DF3\u8FC7 CDN \u5237\u65B0");return}try{// 动态加载 CDN SDK
+const tencentcloud=require("tencentcloud-sdk-nodejs-cdn");const CdnClient=tencentcloud.cdn.v20180606.Client;const clientConfig={credential:{secretId:cosConfig.SecretId,secretKey:cosConfig.SecretKey},region:"",// CDN 是全球服务，不需要指定 region
+profile:{httpProfile:{endpoint:"cdn.tencentcloudapi.com"}}};const client=new CdnClient(clientConfig);// CDN 刷新区域（从配置中读取，默认为 overseas）
+// mainland: 中国境内
+// overseas: 中国境外
+// global: 全球
+const area=cosConfig.CdnArea||"overseas";// 每次最多刷新 1000 个 URL（腾讯云限制）
+const batchSize=1000;for(let i=0;i<urls.length;i+=batchSize){const batch=urls.slice(i,i+batchSize);const params={Urls:batch,Area:area};await client.PurgeUrlsCache(params);console.log(`✓ 已刷新 ${batch.length} 个 URL 的 CDN 缓存 (区域: ${area})`)}}catch(error){// 如果没有安装 CDN SDK，给出提示
+if(error.code==="MODULE_NOT_FOUND"){console.warn("\u26A0\uFE0F  \u672A\u5B89\u88C5 tencentcloud-sdk-nodejs-cdn\uFF0C\u8DF3\u8FC7 CDN \u5237\u65B0");console.warn("   \u5B89\u88C5\u547D\u4EE4: npm install tencentcloud-sdk-nodejs-cdn --save-dev")}else{console.error(`CDN 刷新失败: ${error.message}`);// 不抛出错误，避免影响上传流程
+}}}/**
+ * 上传单个文件到 COS
+ * 
+ * @param {Object} cosConfig - COS 配置
+ * @param {string} filePath - 本地文件路径
+ * @param {string} cosKey - COS 对象键（远程路径）
+ * @returns {Promise<string>} - 上传成功返回访问链接
+ */async function uploadFileToCOS(cosConfig,filePath,cosKey){if(!fs.existsSync(filePath)){throw new Error(`文件不存在: ${filePath}`)}const cos=createCOSClient(cosConfig);return new Promise((resolve,reject)=>{cos.putObject({Bucket:cosConfig.Bucket,Region:cosConfig.Region,Key:cosKey,Body:fs.createReadStream(filePath)},(err,data)=>{if(err){reject(new Error(`上传失败: ${err.message}`))}else{// 生成访问链接
+const cdnDomain=cosConfig.CdnDomain;// 对路径的每个部分分别进行 URL 编码
+const pathParts=cosKey.split("/");const encodedPath=pathParts.map(part=>encodeURIComponent(part)).join("/");const url=`https://${cdnDomain}/${encodedPath}`;resolve(url)}})})}/**
+ * 上传目录下的所有文件到 COS
+ * 
+ * @param {Object} cosConfig - COS 配置
+ * @param {string} localDir - 本地目录路径
+ * @param {string} cosPrefix - COS 路径前缀
+ * @returns {Promise<Array>} - 上传成功返回文件列表
+ */async function uploadDirectoryToCOS(cosConfig,localDir,cosPrefix){if(!fs.existsSync(localDir)){throw new Error(`目录不存在: ${localDir}`)}const files=fs.readdirSync(localDir);const results=[];const uploadedUrls=[];for(const file of files){const filePath=path.join(localDir,file);const stat=fs.statSync(filePath);if(stat.isFile()){// 去掉文件名中的 -preview 或 _preview 后缀
+let cleanFileName=file;cleanFileName=cleanFileName.replace(/-preview\./i,".");cleanFileName=cleanFileName.replace(/_preview\./i,".");const cosKey=cosPrefix?`${cosPrefix}/${cleanFileName}`:cleanFileName;const url=await uploadFileToCOS(cosConfig,filePath,cosKey);results.push({file:cleanFileName,url});uploadedUrls.push(url)}}// 上传完成后刷新 CDN 缓存
+if(uploadedUrls.length>0){await purgeCDNCache(cosConfig,uploadedUrls)}return results}module.exports={createCOSClient,uploadFileToCOS,uploadDirectoryToCOS,purgeCDNCache};

package/core/index.d.ts

@@ -0,0 +1,167 @@
+import { Configuration as WebpackConfig } from 'webpack';
+import { WebpackPluginInstance } from 'webpack';
+
+/** Supported file extensions for webpack resolution */
+export declare const allowedExtensions: string[];
+
+/** Base webpack configuration used by both development and build configs */
+export declare const webpackCommonConfig: WebpackConfig;
+
+/** Options for CLI arguments */
+export interface CLIOptionConfig {
+  name: string;
+  alias?: string;
+  hasValue?: boolean;
+  defaultValue?: any;
+  description: string;
+  parser?: (value: string) => any;
+}
+
+/** Parse command line arguments based on configuration */
+export declare function parseArgvOptions(possibleOptions: CLIOptionConfig[]): Record<string, any>;
+
+/** Deep merge configuration options */
+export declare function mergeOptions<T>(target: T, source?: Partial<T>): T;
+
+/** Configuration for webpack defines */
+export interface DefinesOptions {
+  /** Development mode flag for conditional code */
+  __DEV__: string;
+  /** Google Play Store URL constant */
+  GOOGLE_PLAY_URL: string;
+  /** App Store URL constant */
+  APP_STORE_URL: string;
+  /** Current advertising network identifier */
+  AD_NETWORK: string;
+  /** Current advertising protocol */
+  AD_PROTOCOL: string;
+  /** Application name constant */
+  APP: string;
+  /** Build name constant */
+  NAME: string;
+  /** Build version constant */
+  VERSION: string;
+  /** Unique build identifier generated from timestamp */
+  BUILD_HASH: string;
+  /** Current language code */
+  LANGUAGE: string;
+  /** Current orientation identifier */
+  ORIENTATION: 'both' | 'portrait' | 'landscape' | 'square';
+}
+
+/** CLI configuration options */
+export interface CLIOptions {
+  /** Output directory for build files (default: 'dist') */
+  outDir: string;
+  /** Path to build.json configuration file (default: 'build.json') */
+  buildConfig: string;
+  /** Path to tsconfig.json configuration file (default: 'tsconfig.json') */
+  tsConfig: string;
+  /** Path to jsconfig.json configuration file (default: 'jsconfig.json') */
+  jsConfig: string;
+  /** Development server port number (default: 3000) */
+  port: number;
+  /** Whether to open browser automatically (default: false) */
+  open: boolean;
+  /** Ad protocol to use (default: 'none') */
+  protocol: 'none' | 'mraid' | 'dapi';
+  /** Ad network identifier (default: 'preview') */
+  network:
+    | 'preview'
+    | 'applovin'
+    | 'unity'
+    | 'google'
+    | 'ironsource'
+    | 'facebook'
+    | 'moloco'
+    | 'mintegral'
+    | 'vungle'
+    | 'adcolony'
+    | 'tapjoy'
+    | 'snapchat'
+    | 'tiktok'
+    | 'appreciate'
+    | 'chartboost'
+    | 'pangle'
+    | 'mytarget'
+    | 'liftoff'
+    | 'smadex'
+    | 'adikteev'
+    | 'bigabid'
+    | 'inmobi';
+  /** Development mode flag */
+  dev: boolean;
+  /** Skip recommended meta tags injection */
+  skipRecommendedMeta?: boolean;
+  /** URL of debugger script to inject */
+  debugger?: string;
+  /** Code obfuscation level: 1=terser only, 2=obfuscator basic, 3=obfuscator+dead code, 4=maximum (default: 2) */
+  obfuscateLevel: 1 | 2 | 3 | 4;
+  /** Template for output filename using pattern {app}_{name}_{version}_{date}_{language}_{network} */
+  filename: string;
+  /** Application name used in build filename and APP define */
+  app: string;
+  /** Concept name used in build filename and NAME define */
+  name: string;
+  /** Version name used in build filename and VERSION define */
+  version: string;
+  /** Language code for localization */
+  language: 'auto' | 'en' | 'es' | 'zh' | 'hi' | 'ar' | 'fr' | 'de' | 'ja' | 'pt';
+  /** Orientation identifier */
+  orientation: 'both' | 'portrait' | 'landscape' | 'square';
+  /** Google Play Store URL for the app */
+  googlePlayUrl: string;
+  /** App Store URL for the app */
+  appStoreUrl: string;
+  /** Webpack define plugin configuration */
+  defines: Record<string, string>;
+}
+
+/** Global options object */
+export declare const options: CLIOptions;
+
+/** Create webpack config for development */
+export declare function makeWebpackDevConfig(
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  webpackCustomConfig?: Partial<WebpackConfig>
+): WebpackConfig;
+
+/** Create webpack config for production build */
+export declare function makeWebpackBuildConfig(
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  webpackCustomConfig?: Partial<WebpackConfig>
+): WebpackConfig;
+
+/** Start webpack development server */
+export declare function runDev(
+  webpackConfig?: WebpackConfig,
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  webpackCustomConfig?: Partial<WebpackConfig>
+): void;
+
+/** Run webpack production build */
+export declare function runBuild(
+  webpackConfig?: WebpackConfig,
+  customOptions?: Partial<CLIOptions>,
+  customDefines?: Record<string, any>,
+  webpackCustomConfig?: Partial<WebpackConfig>
+): void;
+
+/** Plugin for injecting DAPI script */
+export declare class DAPIInjectorPlugin implements WebpackPluginInstance {
+  apply(compiler: any): void;
+}
+
+/** Plugin for injecting debugger script */
+export declare class DebuggerInjectionPlugin implements WebpackPluginInstance {
+  constructor(debuggerSrc: string);
+  apply(compiler: any): void;
+}
+
+/** Plugin for injecting Google's ExitAPI and meta tags */
+export declare class ExitAPIInjectorPlugin implements WebpackPluginInstance {
+  apply(compiler: any): void;
+}

package/core/index.js

@@ -0,0 +1 @@
+"use strict";const{allowedExtensions,webpackCommonConfig}=require("./webpack.common.js");const{parseArgvOptions}=require("./utils/parseArgvOptions.js");const{mergeOptions}=require("./utils/mergeOptions.js");const{options}=require("./options.js");const{DAPIInjectorPlugin}=require("./plugins/DAPIInjectorPlugin.js");const{DebuggerInjectionPlugin}=require("./plugins/DebuggerInjectionPlugin.js");const{ExitAPIInjectorPlugin}=require("./plugins/ExitAPIInjectorPlugin.js");const{runBuild,makeWebpackBuildConfig}=require("./webpack.build.js");const{runDev,makeWebpackDevConfig}=require("./webpack.dev.js");exports.mergeOptions=mergeOptions;exports.parseArgvOptions=parseArgvOptions;exports.options=options;exports.allowedExtensions=allowedExtensions;exports.webpackCommonConfig=webpackCommonConfig;exports.makeWebpackDevConfig=makeWebpackDevConfig;exports.makeWebpackBuildConfig=makeWebpackBuildConfig;exports.runDev=runDev;exports.runBuild=runBuild;exports.DAPIInjectorPlugin=DAPIInjectorPlugin;exports.ExitAPIInjectorPlugin=ExitAPIInjectorPlugin;exports.DebuggerInjectionPlugin=DebuggerInjectionPlugin;

package/core/loaders/gltf-loader.js

@@ -0,0 +1,45 @@
+"use strict";const path=require("path");const loaderUtils=require("loader-utils");const fs=require("fs");const isObject=value=>typeof value==="object"&&value!==null;const isDataURI=value=>/^data:/i.test(value);/**
+ * A utility function that allows mapping the value for a given key in an object
+ * [in place](https://en.wikipedia.org/wiki/In-place_algorithm).
+ *
+ * @remarks
+ * This function recursively iterates through every key in the object.
+ * Once a key strictly equal to the given key is found, the callback function
+ * is invoked, and its return value (or resolved value) is then set as the new value
+ * for that entry.
+ *
+ * @param {unknown} obj - The object to mutate.
+ * @param {string} key - The key to match against.
+ * @param {(value: unknown) => Promise<any>} callback
+ * The callback that either returns the mapped value, or returns a Promise
+ * that resolves to the new value.
+ */async function mapDeep(obj,key,callback){if(Array.isArray(obj)){for(const item of obj){await mapDeep(item,key,callback)}}else if(isObject(obj)){for(const[k,v]of Object.entries(obj)){if(k===key){obj[k]=await callback(v)}else{await mapDeep(v,key,callback)}}}}/**
+ * @typedef {import(".").GLTFLoaderDefinition} GLTFLoader
+ * @this {ThisParameterType<GLTFLoader>}
+ * @type {GLTFLoader}
+ */async function gltfLoader(content){// Destructure loader options and set default values:
+const{// inline = true,
+// useRelativePaths = true,
+// uriResolver = (module) => String(module.default ?? module),
+// fileName = '[name].[hash:8].[ext]',
+// filePath = '/static/media',
+// publicPath = this._compilation?.outputOptions.publicPath ?? '/',
+context=this.context}=this.getOptions();// Parse the glTF data:
+// console.log(content);
+const data=JSON.parse(content);// console.log(data);
+// Iterate over the object and map any URIs:
+await mapDeep(data,"uri",async uri=>{// Resolve early if the URI cannot be imported as a module:
+if(!loaderUtils.isUrlRequest(uri))return uri;// If the URI is a data URI, print a warning and resolve with the original value:
+if(isDataURI(uri)){return uri}const requestPath=path.join(context,uri);// console.log(requestPath);
+const binContent=fs.readFileSync(requestPath,{encoding:"base64"});return`data:application/octet-stream;base64,${binContent}`});// Stringify the updated data:
+const updatedContent=JSON.stringify(data);// Interpolate any file name tokens:
+// const interpolatedName = loaderUtils.interpolateName(this, fileName, { content: updatedContent });
+// Join the file path and interpolated name:
+// const interpolatedPath = path.join(filePath, interpolatedName);
+// Emit the file:
+// this.emitFile(interpolatedPath, updatedContent, null);
+// Join all paths together:
+// const fullPath = path.join(publicPath, interpolatedPath);
+// Lastly, resolve with either the JSON data or the full output path:
+// return `export default ${inline ? updatedContent : `"${fullPath}"`}`;
+return`export default ${updatedContent}`}module.exports=gltfLoader;

package/core/options.js

@@ -0,0 +1,25 @@
+"use strict";const{parseArgvOptions,allowedAdProtocols,allowedAdNetworks,allowedOrientations,allowedLanguages}=require("./utils/parseArgvOptions");const path=require("path");const fs=require("fs");const{name,version}=require("../package.json");const possibleOptions=[{name:"out-dir",alias:"outDir",defaultValue:"dist",hasValue:true,description:"Output directory for build files"},{name:"build-config",alias:"buildConfig",defaultValue:"build.json",hasValue:true,description:"Path to build.json configuration file"},{name:"ts-config",alias:"tsConfig",defaultValue:"tsconfig.json",hasValue:true,description:"For TypeScript projects, path to tsconfig.json file"},{name:"js-config",alias:"jsConfig",defaultValue:"jsconfig.json",hasValue:true,description:"For JavaScript projects, path to jsconfig.json file"},{name:"port",hasValue:true,defaultValue:3000,description:"Development server port number",parser:function(rawValue){const value=+rawValue;if(isNaN(value))throw new Error("--port should be a number");return value}},{name:"open",defaultValue:false,hasValue:false,description:"Open browser automatically when server starts"},{name:"protocol",hasValue:true,defaultValue:"none",description:"Ad protocol to use (none, mraid, or dapi)",parser:function(rawValue){if(!allowedAdProtocols.includes(rawValue)){throw new Error(`--protocol should have one of the value: ${allowedAdProtocols.join(", ")}`)}return rawValue}},{name:"network",defaultValue:"preview",hasValue:true,description:"Target Ad network",parser:function(rawValue){if(!allowedAdNetworks.includes(rawValue)){throw new Error(`--network should have one of the value: ${allowedAdNetworks.join(", ")}`)}return rawValue}},{name:"zip",defaultValue:false,hasValue:false,description:"Should the build be zipped? (only for some ad networks)"},{name:"dev",hasValue:true,description:"Enable development mode (true/false)",parser:function(rawValue){if(!(rawValue==="true"||rawValue==="false"))throw new Error("--dev should have either true or false value");return rawValue==="true"}},{name:"filename",defaultValue:"{app}_{name}_{version}_{date}_{language}_{network}",hasValue:true,description:"Specifies the build filename template"},{name:"app",defaultValue:"AppName",hasValue:true,description:"Specifies the application name used in build filename and APP define"},{name:"name",defaultValue:"ConceptName",hasValue:true,description:"Specifies the concept name used in build filename and NAME define"},{name:"version",defaultValue:"v1",hasValue:true,description:"Specifies the version name used in build filename and VERSION define"},{name:"language",defaultValue:"en",hasValue:true,description:"Specifies the language of the build used in LANGUAGE define",parser:function(rawValue){if(!allowedLanguages.includes(rawValue)){throw new Error(`--platform should have one of the value: ${allowedLanguages.join(", ")}`)}return rawValue}},{name:"orientation",defaultValue:"both",hasValue:true,description:"Specifies the ad orientation used in ORIENTATION define and some network specific configurations",parser:function(rawValue){if(!allowedOrientations.includes(rawValue)){throw new Error(`--orientation should have one of the value: ${allowedOrientations.join(", ")}`)}return rawValue}},{name:"google-play-url",alias:"googlePlayUrl",defaultValue:"https://play.google.com/store/games",hasValue:true,description:"Google Play Store URL for the app"},{name:"app-store-url",alias:"appStoreUrl",defaultValue:"https://www.apple.com/app-store/",hasValue:true,description:"App Store URL for the app"},{name:"skip-recommended-meta",alias:"skipRecommendedMeta",hasValue:false,description:"Don't inject recommended for playable ads META tags"},{name:"debugger",hasValue:true,description:"URL of debugger script to inject into code"},{name:"obfuscate-level",alias:"obfuscateLevel",defaultValue:4,hasValue:true,description:"Code obfuscation level: 1=terser only, 2=obfuscator basic(default), 3=obfuscator+dead code, 4=maximum obfuscation",parser:function(rawValue){const value=+rawValue;if(isNaN(value)||value<1||value>4){throw new Error("--obfuscate-level should be a number between 1 and 4")}return value}},{name:"fflate-compression",alias:"fflateCompression",defaultValue:false,hasValue:true,description:"Enable fflate compression for HTML output (level 9, production only)",parser:function(rawValue){// 支持 true/false 字符串和布尔值
+if(rawValue==="true"||rawValue===true||rawValue==="1")return true;if(rawValue==="false"||rawValue===false||rawValue==="0")return false;return Boolean(rawValue)}}];/** @type {import('./index').CLIOptions} */const options=parseArgvOptions(possibleOptions);options.defines={};options.compilation={};options.adNetworkNames={};// ==================== 配置文件加载 ====================
+//
+// 优先级（从低到高）:
+// 1. builds.config.js (新配置文件，优先读取)
+// 2. build.json (旧配置文件，作为覆盖/补充)
+// 3. 命令行参数 (最高优先级)
+//
+// 字段映射:
+// - builds.config.js: googlePlayUrl, appStoreUrl
+// - build.json: google_play_url → googlePlayUrl, app_store_url → appStoreUrl
+// 1️⃣ 先尝试读取 builds.config.js
+const buildsConfigPath=path.resolve("builds.config.js");if(fs.existsSync(buildsConfigPath)){try{// 清除 require 缓存，确保读取最新配置
+delete require.cache[buildsConfigPath];const buildsConfig=require(buildsConfigPath);// 读取商店链接配置
+if(buildsConfig.googlePlayUrl){options.googlePlayUrl=buildsConfig.googlePlayUrl}if(buildsConfig.appStoreUrl){options.appStoreUrl=buildsConfig.appStoreUrl}// 读取其他特殊配置
+if(buildsConfig.defines)Object.assign(options.defines,buildsConfig.defines);if(buildsConfig.compilation)Object.assign(options.compilation,buildsConfig.compilation);if(buildsConfig.adNetworkNames)Object.assign(options.adNetworkNames,buildsConfig.adNetworkNames);// 读取所有通用配置字段（如果在 builds.config.js 中定义了）
+for(const key in buildsConfig){// 跳过已处理的特殊字段和批量构建专用字段
+if(["googlePlayUrl","appStoreUrl","defines","compilation","adNetworkNames","title","appName","projectCode","channels","themes","naming","build","hooks","cosConfig"].includes(key)){continue}// 查找对应的配置项定义
+const possibleOption=possibleOptions.find(e=>e.alias===key||e.name===key);if(possibleOption&&buildsConfig[key]!==undefined){options[key]=buildsConfig[key]}}}catch(err){console.log("\x1B[33m\u26A0\uFE0F  \u8BFB\u53D6 builds.config.js \u5931\u8D25: "+err.message+"\x1B[0m")}}// 2️⃣ 再尝试读取 build.json（会覆盖 builds.config.js 中的相同字段）
+try{const fileData=fs.readFileSync(path.resolve(options["buildConfig"]),"utf8");try{const customOptions=JSON.parse(fileData);for(let key in customOptions){if(key==="defines")Object.assign(options.defines,customOptions[key]);else if(key==="compilation")Object.assign(options.compilation,customOptions[key]);else if(key==="adNetworkNames")Object.assign(options.adNetworkNames,customOptions[key]);else if(key==="google_play_url")options.googlePlayUrl=customOptions.google_play_url;// 覆盖 builds.config.js
+else if(key==="app_store_url")options.appStoreUrl=customOptions.app_store_url;// 覆盖 builds.config.js
+else{const possibleOption=possibleOptions.find(e=>e.alias===key||e.name===key);if(possibleOption&&(options[key]===undefined||options[key]===possibleOption.defaultValue)){options[key]=customOptions[key]}}}}catch(err){console.log("\x1B[31mBuild config parsing error: "+err.message+"\x1B[0m")}}catch(err){// build.json 不存在是正常的（使用 builds.config.js）
+}// 环境变量覆盖（用于批量构建时避免竞态条件）
+// 批量构建时通过 PLAYABLE_FILENAME 环境变量传递 filename，优先级最高
+if(process.env.PLAYABLE_FILENAME){options.filename=process.env.PLAYABLE_FILENAME}console.log(`${name} v${version}`);console.log("Options:",options);exports.options=options;

package/core/plugins/AdikteevInjectorPlugin.js

@@ -0,0 +1,47 @@
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * AdikteevInjectorPlugin
+ * 
+ * 在开发环境中注入 Adikteev MRAID mock 和占位符变量
+ * 
+ * 官方文档: https://help.adikteev.com/hc/en-us/articles/10549028250130
+ * 
+ * Adikteev 要求:
+ * 1. 使用 mraid.open() 打开目标 URL
+ * 2. 暴露 AK_CLICK_DESTINATION_URL 和 AK_CLICK_PIXEL_URL 占位符
+ * 3. 生产环境由 Adikteev CDN 提供 mraid.js
+ */class AdikteevInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("AdikteevInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("AdikteevInjectorPlugin",(data,cb)=>{// 注入 MRAID mock (仅开发环境)
+data.headTags.unshift({tagName:"script",innerHTML:`
+              // Adikteev MRAID Mock (Development Only)
+              if (typeof mraid === 'undefined') {
+                window.mraid = {
+                  getState: function() {
+                    console.log('[Adikteev Mock] mraid.getState() called');
+                    return 'default';
+                  },
+                  open: function(url) {
+                    console.log('[Adikteev Mock] mraid.open() called with URL:', url);
+                    console.log('[Adikteev Mock] In production, this would open:', url);
+                    // 开发环境下可选择性打开链接
+                    // window.open(url, '_blank');
+                  },
+                  addEventListener: function(event, handler) {
+                    console.log('[Adikteev Mock] addEventListener:', event);
+                  },
+                  removeEventListener: function(event, handler) {
+                    console.log('[Adikteev Mock] removeEventListener:', event);
+                  }
+                };
+                console.log('[Adikteev] MRAID mock initialized (development mode)');
+              }
+
+              // Adikteev 占位符变量 (生产环境会被 Adikteev 平台替换)
+              if (typeof AK_CLICK_DESTINATION_URL === 'undefined') {
+                window.AK_CLICK_DESTINATION_URL = "https://play.google.com/store/apps/details?id=com.example.app";
+                console.log('[Adikteev] AK_CLICK_DESTINATION_URL mock set');
+              }
+              
+              if (typeof AK_CLICK_PIXEL_URL === 'undefined') {
+                window.AK_CLICK_PIXEL_URL = "";
+                console.log('[Adikteev] AK_CLICK_PIXEL_URL mock set (empty for dev)');
+              }
+            `,voidTag:false});cb(null,data)})})}}exports.AdikteevInjectorPlugin=AdikteevInjectorPlugin;

package/core/plugins/BigoAdsInjectorPlugin.js

@@ -0,0 +1,7 @@
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * BigoAds SDK 注入插件
+ * 在 HTML 头部注入 BigoAds 专用 SDK 脚本
+ * 文档: https://www.bigoads.com/help/detail?id=143&moduleId=7&currentLan=CN
+ */class BigoAdsInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("BigoAdsInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).beforeEmit.tapAsync("BigoAdsInjectorPlugin",(data,cb)=>{// BigoAds 要求必须引入此 SDK，不允许使用标准 mraid.js
+const bigoAdsScript=`<script src="https://static-web.likeevideo.com/as/common-static/big-data/dsp-public/bgy-mraid-sdk.js"></script>`;// 在 <head> 标签后注入
+data.html=data.html.replace("<head>",`<head>\n    ${bigoAdsScript}`);cb(null,data)})})}}exports.BigoAdsInjectorPlugin=BigoAdsInjectorPlugin;

package/core/plugins/DAPIInjectorPlugin.js

@@ -0,0 +1,5 @@
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");const dapiSrc="function getScript(e,i){var n=document.createElement(\"script\");n.type=\"text/javascript\",n.async=!0,i&&(n.onload=i),n.src=e,document.head.appendChild(n)}function parseMessage(e){var i=e.data,n=i.indexOf(DOLLAR_PREFIX+RECEIVE_MSG_PREFIX);if(-1!==n){var t=i.slice(n+2);return getMessageParams(t)}return{}}function getMessageParams(e){var i,n=[],t=e.split(\"/\"),a=t.length;if(-1===e.indexOf(RECEIVE_MSG_PREFIX)){if(a>=2&&a%2===0)for(i=0;a>i;i+=2)n[t[i]]=t.length<i+1?null:decodeURIComponent(t[i+1])}else{var o=e.split(RECEIVE_MSG_PREFIX);void 0!==o[1]&&(n=JSON&&JSON.parse(o[1]))}return n}function getDapi(e){var i=parseMessage(e);if(!i||i.name===GET_DAPI_URL_MSG_NAME){var n=i.data;getScript(n,onDapiReceived)}}function invokeDapiListeners(){for(var e in dapiEventsPool)dapiEventsPool.hasOwnProperty(e)&&dapi.addEventListener(e,dapiEventsPool[e])}function onDapiReceived(){dapi=window.dapi,window.removeEventListener(\"message\",getDapi),invokeDapiListeners()}function init(){window.dapi.isDemoDapi&&(window.parent.postMessage(DOLLAR_PREFIX+SEND_MSG_PREFIX+JSON.stringify({state:\"getDapiUrl\"}),\"*\"),window.addEventListener(\"message\",getDapi,!1))}var DOLLAR_PREFIX=\"$$\",RECEIVE_MSG_PREFIX=\"DAPI_SERVICE:\",SEND_MSG_PREFIX=\"DAPI_AD:\",GET_DAPI_URL_MSG_NAME=\"connection.getDapiUrl\",dapiEventsPool={},dapi=window.dapi||{isReady:function(){return!1},addEventListener:function(e,i){dapiEventsPool[e]=i},removeEventListener:function(e){delete dapiEventsPool[e]},isDemoDapi:!0};init();";/**
+ * Webpack plugin that injects DAPI (Display Advertising Programming Interface) script
+ * into the HTML head. This enables communication with ad networks that use DAPI protocol.
+ * @implements {import('webpack').WebpackPluginInstance}
+ */class DAPIInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("DAPIInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("DAPIInjectorPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},innerHTML:dapiSrc});callback(null,data)})})}}exports.DAPIInjectorPlugin=DAPIInjectorPlugin;

package/core/plugins/DebuggerInjectionPlugin.js

@@ -0,0 +1,6 @@
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * Webpack plugin that injects a custom debugger script into the HTML head
+ * @implements {import('webpack').WebpackPluginInstance}
+ */class DebuggerInjectionPlugin{/**
+   * @param {string} debuggerSrc - URL of the debugger script to inject
+   */constructor(debuggerSrc){this.debuggerSrc=debuggerSrc}apply(compiler){compiler.hooks.compilation.tap("DebuggerInjectionPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("DebuggerInjectionPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},attributes:{src:this.debuggerSrc,type:"text/javascript"}});callback(null,data)})})}}exports.DebuggerInjectionPlugin=DebuggerInjectionPlugin;

package/core/plugins/ExitAPIInjectorPlugin.js

@@ -0,0 +1,10 @@
+"use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");/**
+ * Webpack plugin that injects Google's ExitAPI script and required meta tags for Google Ads.
+ * Adds:
+ * - ExitAPI script for handling ad exits
+ * - Meta tag for ad size configuration
+ * - Meta tag for ad orientation support
+ * @implements {import('webpack').WebpackPluginInstance}
+ */class ExitAPIInjectorPlugin{/**
+   * @param {ORIENTATION} orientation - device orientation
+   */constructor(orientation){this.orientation=orientation}apply(compiler){compiler.hooks.compilation.tap("ExitAPIInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("ExitAPIInjectorPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},attributes:{src:"https://tpc.googlesyndication.com/pagead/gadgets/html5/api/exitapi.js",type:"text/javascript"}});let width=320;let height=480;if(this.orientation==="square")width=480;else if(this.orientation==="landscape"){width=480;height=320}data.headTags.splice(0,0,{tagName:"meta",voidTag:true,meta:{plugin:"html-webpack-plugin"},attributes:{name:"ad.size",content:`width=${width},height=${height}`}});data.headTags.splice(0,0,{tagName:"meta",voidTag:true,meta:{plugin:"html-webpack-plugin"},attributes:{name:"ad.orientation",content:this.orientation==="both"||this.orientation==="square"?"portrait,landscape":this.orientation}});callback(null,data)})})}}exports.ExitAPIInjectorPlugin=ExitAPIInjectorPlugin;