@playcraft/devkit 1.0.5 → 1.0.7

package/cli/commands/build.js

@@ -1,4 +1,4 @@
-"use strict";process.env.BABEL_ENV="production";process.env.NODE_ENV="production";const fs=require("fs");const path=require("path");const{runBuild}=require("../../core/webpack.build.js");const{validateThemeData}=require("../../core/utils/validateThemeData");/**
+"use strict";process.env.BABEL_ENV="production";process.env.NODE_ENV="production";const fs=require("fs");const path=require("path");const{runBuild}=require("../../core/webpack.build.js");const{runThemeValidation,restoreSchema}=require("../../core/utils/validateThemeData");/**
  * Detect the current theme name from the theme entry file.
  * Supports patterns like:
  *   export { default } from './themeName';
@@ -8,4 +8,6 @@
 const buildsConfigPath=path.join(projectRoot,"builds.config.js");let themeConfig={sourceDir:"src/theme",entryFile:"src/theme/index.ts"};if(fs.existsSync(buildsConfigPath)){try{delete require.cache[buildsConfigPath];const config=require(buildsConfigPath);if(config.themes){themeConfig={...themeConfig,...config.themes}}}catch(e){// ignore
 }}const entryPath=path.join(projectRoot,themeConfig.entryFile);if(!fs.existsSync(entryPath)){return{themeName:null,themeConfig}}const content=fs.readFileSync(entryPath,"utf8");// Match: export { default } from './themeName'  or  import ... from './themeName'
 const match=content.match(/from\s+['"]\.\/([^'"]+)['"]/);if(match){return{themeName:match[1],themeConfig}}return{themeName:null,themeConfig}}// --- Main ---
-const projectRoot=process.cwd();const{themeName,themeConfig}=detectCurrentTheme(projectRoot);if(themeName){const themeBaseDir=path.join(projectRoot,themeConfig.sourceDir||"src/theme");const schemaPath=path.join(themeBaseDir,"theme.schema.json5");if(fs.existsSync(schemaPath)){console.log(`\x1b[36m[build] 校验主题数据: ${themeName}\x1b[0m`);const{merged,errors}=validateThemeData(themeName,projectRoot,themeConfig);if(errors){console.error(`\x1b[31m[build] 主题 "${themeName}" 数据校验失败:\x1b[0m`);errors.forEach(e=>console.error(`\x1b[31m  - ${e}\x1b[0m`));process.exit(1)}console.log(`\x1b[32m[build] 主题 "${themeName}" 数据校验通过`)}}runBuild();
+const projectRoot=process.cwd();const{themeName,themeConfig}=detectCurrentTheme(projectRoot);let schemaPathToRestore=null;if(themeName){const buildLog=(msg,level)=>{const colors={info:"\x1B[36m",success:"\x1B[32m",error:"\x1B[31m"};const reset="\x1B[0m";const color=colors[level]||"";console.log(`${color}[build] ${msg}${reset}`)};const{valid,schemaPath}=runThemeValidation(themeName,projectRoot,themeConfig,{log:buildLog});schemaPathToRestore=schemaPath;if(!valid){// Restore schema on validation failure (backup may have been created)
+if(schemaPathToRestore)restoreSchema(schemaPathToRestore);process.exit(1)}}// Run build, then always restore schema regardless of success/failure
+runBuild().then(()=>{if(schemaPathToRestore)restoreSchema(schemaPathToRestore)}).catch(err=>{if(schemaPathToRestore)restoreSchema(schemaPathToRestore);console.error(err);process.exit(1)});

package/cli/commands/pack.js

@@ -19,25 +19,35 @@ return path.basename(projectRoot)}/**
  * @returns {string[]} Array of normalized ignore patterns
  */function parseSingleIgnoreFile(filePath){if(!fs.existsSync(filePath)){return[]}const content=fs.readFileSync(filePath,"utf8");const patterns=[];for(const rawLine of content.split(/\r?\n/)){const line=rawLine.trim();// Skip empty lines and comments
 if(!line||line.startsWith("#"))continue;// Warn about negation patterns (not supported)
-if(line.startsWith("!")){console.log(`\x1b[33m⚠️  Negation pattern not supported, skipping: ${line}\x1b[0m`);continue}// Normalize: remove trailing slashes for directory matching
-const normalized=line.replace(/\/+$/,"");patterns.push(normalized)}return patterns}/**
+if(line.startsWith("!")){console.log(`\x1b[33m⚠️  Negation pattern not supported, skipping: ${line}\x1b[0m`);continue}// Normalize:
+//   - remove trailing slashes for directory matching
+//   - remove leading ./ (gitignore treats ./foo same as foo)
+let normalized=line.replace(/\/+$/,"");normalized=normalized.replace(/^\.\//g,"");patterns.push(normalized)}return patterns}/**
  * Parse .gitignore and .playcraftignore files, merge and deduplicate patterns.
  * .gitignore provides base ignore rules, .playcraftignore provides additional ones.
  * @returns {{ patterns: string[], sources: { gitignore: number, playcraftignore: number } }}
  */function parseIgnoreFiles(){const gitignorePath=path.join(projectRoot,".gitignore");const playcraftignorePath=path.join(projectRoot,".playcraftignore");const gitignorePatterns=parseSingleIgnoreFile(gitignorePath);const playcraftPatterns=parseSingleIgnoreFile(playcraftignorePath);if(gitignorePatterns.length===0&&playcraftPatterns.length===0){console.log("\x1B[33m\u26A0\uFE0F  No .gitignore or .playcraftignore file found, packing all files.\x1B[0m");return{patterns:[],sources:{gitignore:0,playcraftignore:0}}}// Merge and deduplicate (preserve order, .gitignore first)
 const seen=new Set;const merged=[];for(const p of[...gitignorePatterns,...playcraftPatterns]){if(!seen.has(p)){seen.add(p);merged.push(p)}}return{patterns:merged,sources:{gitignore:gitignorePatterns.length,playcraftignore:playcraftPatterns.length}}}/**
  * Convert a gitignore-like pattern to a RegExp.
+ *
+ * Gitignore semantics:
+ *   - Pattern without `/` → matches against the basename anywhere in the tree
+ *   - Pattern with `/` (e.g. `scripts/foo`) → anchored to project root
+ *   - Leading `/` means "root only" and is stripped before regex conversion
+ *   - Leading `./` is treated the same as `/` (already stripped in parse phase)
+ *
  * @param {string} pattern
  * @returns {RegExp}
- */function patternToRegex(pattern){// Escape regex special chars except * and ?
-let regexStr=pattern.replace(/[.+^${}()|[\]\\]/g,"\\$&");// Handle ** (match any path segment including nested)
+ */function patternToRegex(pattern){let p=pattern;let anchored=false;// Leading / means root-anchored; strip it for regex building
+if(p.startsWith("/")){p=p.slice(1);anchored=true}// If the pattern contains a /, it is also root-anchored
+if(p.includes("/")){anchored=true}// Escape regex special chars except * and ?
+let regexStr=p.replace(/[.+^${}()|[\]\\]/g,"\\$&");// Handle ** (match any path segment including nested)
 regexStr=regexStr.replace(/\*\*/g,"{{GLOBSTAR}}");// Handle * (match anything except path separator)
 regexStr=regexStr.replace(/\*/g,"[^/]*");// Handle ?
 regexStr=regexStr.replace(/\?/g,"[^/]");// Restore globstar
-regexStr=regexStr.replace(/\{\{GLOBSTAR\}\}/g,".*");// If pattern doesn't contain /, match against basename or full path
-if(!pattern.includes("/")){// Match as a path segment anywhere: either at start or after /
-return new RegExp(`(^|/)${regexStr}(/|$)`)}// Pattern with / — match from the start of the relative path
-return new RegExp(`^${regexStr}(/|$)`)}/**
+regexStr=regexStr.replace(/\{\{GLOBSTAR\}\}/g,".*");if(anchored){// Anchored: match from the start of the relative path
+return new RegExp(`^${regexStr}(/|$)`)}// Unanchored: match as a path segment anywhere in the tree
+return new RegExp(`(^|/)${regexStr}(/|$)`)}/**
  * Check if a relative path should be ignored.
  * @param {string} relativePath - Forward-slash normalized relative path
  * @param {RegExp[]} regexPatterns

package/core/batch-build.js

@@ -7,20 +7,21 @@
  * 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{createCOSClient,uploadDirectoryToCOS,uploadFileToCOS,purgeCDNCache}=require("./cos-uploader");const{validateThemeData}=require("./utils/validateThemeData");const execAsync=promisify(exec);/**
+ */const{execSync,exec}=require("child_process");const fs=require("fs");const path=require("path");const os=require("os");const{promisify}=require("util");const{fetchTemporaryCredentials,createCOSClient,uploadDirectoryToCOS,uploadFileToCOS,purgeCDNCache}=require("./cos-uploader");const{runThemeValidation,restoreSchema}=require("./utils/validateThemeData");const execAsync=promisify(exec);/**
  * 更新 preview.json 文件
- */async function updatePreviewJson(cosConfig,cosPrefix,currentTheme,previewLinks){const previewJsonKey=cosPrefix?`${cosPrefix}/preview.json`:"preview.json";// 读取现有的 preview.json 文件
-let existingPreviewData={};try{const cos=createCOSClient(cosConfig);const getObjectResult=await new Promise((resolve,reject)=>{cos.getObject({Bucket:cosConfig.Bucket,Region:cosConfig.Region,Key:previewJsonKey},(err,data)=>{if(err){if(err.statusCode===404){// 文件不存在，使用空对象
+ */async function updatePreviewJson(cosConfig,cosPrefix,currentTheme,previewLinks,credentials=null){const previewJsonKey=cosPrefix?`${cosPrefix}/preview.json`:"preview.json";// 如果没有传入凭证，尝试获取一次
+if(!credentials){try{credentials=await fetchTemporaryCredentials()}catch(error){log(`获取临时凭证失败，跳过 preview.json 更新: ${error.message}`,"warn");return}}// 读取现有的 preview.json 文件
+let existingPreviewData={};try{const cos=await createCOSClient(null,credentials);const getObjectResult=await new Promise((resolve,reject)=>{cos.getObject({Bucket:credentials.bucket,Region:credentials.region,Key:previewJsonKey},(err,data)=>{if(err){if(err.statusCode===404){// 文件不存在，使用空对象
 resolve(null)}else{reject(err)}}else{resolve(data)}})});if(getObjectResult&&getObjectResult.Body){existingPreviewData=JSON.parse(getObjectResult.Body.toString())}}catch(error){// 如果读取失败，使用空对象继续
-console.log(`[${new Date().toLocaleTimeString()}] 🔍 读取现有 preview.json 失败，将创建新文件: ${error.message}`)}// 更新预览数据
+log(`读取现有 preview.json 失败，将创建新文件: ${error.message}`,"debug")}// 更新预览数据
 const updatedPreviewData={...existingPreviewData};// 获取当前时间
 const currentTime=new Date().toISOString();// 更新当前主题的预览链接
 const currentThemeLinks=previewLinks.filter(link=>link.theme===currentTheme);currentThemeLinks.forEach(link=>{const fileName=link.file.replace(/\.[^.]+$/,"");// 去掉文件扩展名
 updatedPreviewData[fileName]={url:link.url,update_time:currentTime}});// 将更新后的数据写入临时文件
 const tempDir=path.join(os.tmpdir(),"playable-preview");if(!fs.existsSync(tempDir)){fs.mkdirSync(tempDir,{recursive:true})}const tempPreviewPath=path.join(tempDir,"preview.json");fs.writeFileSync(tempPreviewPath,JSON.stringify(updatedPreviewData,null,2),"utf8");// 上传更新后的 preview.json 文件
-await uploadFileToCOS(cosConfig,tempPreviewPath,previewJsonKey);// 刷新 CDN 缓存
-const cdnDomain=cosConfig.CdnDomain;if(cdnDomain){const previewJsonUrl=`https://${cdnDomain}/${previewJsonKey}`;try{await purgeCDNCache(cosConfig,[previewJsonUrl]);console.log(`[${new Date().toLocaleTimeString()}] ✅ CDN 缓存已刷新: ${previewJsonUrl}`)}catch(error){console.log(`[${new Date().toLocaleTimeString()}] ⚠️  CDN 缓存刷新失败: ${error.message}`)}}// 清理临时文件
-fs.unlinkSync(tempPreviewPath);console.log(`[${new Date().toLocaleTimeString()}] ✅ preview.json 文件已更新并上传`)}// ==================== 默认配置 ====================
+await uploadFileToCOS(null,tempPreviewPath,previewJsonKey,credentials);// 刷新 CDN 缓存
+const cdnDomain="static.aix.intlgame.com";const previewJsonUrl=`https://${cdnDomain}/${previewJsonKey}`;try{await purgeCDNCache(null,[previewJsonUrl],credentials);log(`✓ CDN 缓存已刷新: ${previewJsonUrl}`,"success")}catch(error){log(`⚠️  CDN 缓存刷新失败: ${error.message}`,"warn")}// 清理临时文件
+fs.unlinkSync(tempPreviewPath);log(`✓ preview.json 文件已更新并上传`,"success")}// ==================== 默认配置 ====================
 /**
  * 计算默认并发数
  * 策略: CPU 核心数 - 1，最小为 2，最大为 8
@@ -32,9 +33,7 @@ fs.unlinkSync(tempPreviewPath);console.log(`[${new Date().toLocaleTimeString()}]
 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 语句
@@ -84,7 +83,7 @@ else if(currentArg.startsWith("--channels=")){result.channels=currentArg.substri
 else if(currentArg.startsWith("--parallel=")){result.parallel=parseInt(currentArg.substring(11),10)}// 支持 --is-channel-fold2zip 参数
 else if(currentArg==="--is-channel-fold2zip"){result.isChannelFold2Zip=true}// 兼容位置参数：第一个参数作为主题，第二个作为渠道
 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="";/**
+const REMOTE_CONFIG_REPO="https://git.woa.com/maclerylin/playable-build-config.git";/**
  * 执行命令并返回结果
  * @param {string} command - 要执行的命令
  * @param {object} options - execSync 选项
@@ -95,16 +94,10 @@ const REMOTE_CONFIG_REPO="";/**
  * 
  * @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")}}}}/**
+ */async function fetchRemoteConfig(appName){if(!appName)return null;const https=require("https");const http=require("http");const url=require("url");// 构建远程配置文件 URL
+const configUrl=`https://wd-act.woa.com/aix/playable-build-config/${encodeURIComponent(appName)}/build.config.js`;log(`尝试从远程 URL 获取配置: ${appName}`,"info");log(`URL: ${configUrl}`,"debug");try{// 发起 HTTP 请求获取配置文件
+const configContent=await new Promise((resolve,reject)=>{const parsedUrl=url.parse(configUrl);const protocol=parsedUrl.protocol==="https:"?https:http;const request=protocol.get(configUrl,response=>{if(response.statusCode!==200){reject(new Error(`HTTP ${response.statusCode}: ${response.statusMessage}`));return}let data="";response.on("data",chunk=>data+=chunk);response.on("end",()=>resolve(data))});request.on("error",reject);request.setTimeout(30000,()=>{request.destroy();reject(new Error("Request timeout"))})});log("\u2713 \u8FDC\u7A0B\u914D\u7F6E\u6587\u4EF6\u4E0B\u8F7D\u6210\u529F","success");// 使用 vm 模块执行配置文件，避免 require 缓存问题
+const vm=require("vm");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");log(`配置内容预览: ${configContent.substring(0,200)}...`,"debug");return null}}catch(error){log(`获取远程配置失败: ${error.message}`,"warn");return null}}/**
  * 加载配置文件
  * 
  * 优先级: 本地 builds.config.js > 远程配置 > build.json > 默认值
@@ -146,23 +139,27 @@ const args=parseArgs();// 应用命令行参数
 if(args.parallel!==null){config.build.parallel=args.parallel}// 是否启用渠道折叠为 zip 模式
 const isChannelFold2Zip=args.isChannelFold2Zip;if(isChannelFold2Zip){log("\u5DF2\u542F\u7528 --is-channel-fold2zip \u6A21\u5F0F\uFF1A\u6240\u6709\u6E20\u9053\u8F93\u51FA\u5C06\u538B\u7F29\u4E3A zip \u6587\u4EF6","info")}// 确定主题列表
 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")}}// 打印摘要
+let channels=args.channels||config.channels;// 始终添加 preview 渠道，用于收集上传文件
+if(!channels.includes("preview")){channels=[...channels,"preview"];log("\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)}// Validate and merge theme data (schema + default + theme override)
-const themeBaseDir=path.join(projectRoot,config.themes.sourceDir||"src/theme");const schemaPath=path.join(themeBaseDir,"theme.schema.json5");if(fs.existsSync(schemaPath)){log(`校验主题数据: ${theme}`,"info");const{merged,errors}=validateThemeData(theme,projectRoot,config.themes);if(errors){log(`主题 "${theme}" 数据校验失败:`,"error");errors.forEach(e=>log(`  - ${e}`,"error"));if(!config.build.continueOnError){throw new Error(`Theme data validation failed for "${theme}"`)}// Record failures for all channels of this theme and skip building
-channels.forEach(channel=>{allResults.push({success:false,theme,channel,error:"Theme data validation failed"})});continue}log(`主题 "${theme}" 数据校验通过`,"success")}// 并发构建该主题的所有渠道
-const themeResults=await buildChannelsInParallel(config,theme,channels,outputDir,projectRoot,isChannelFold2Zip);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");// 更新 preview.json 文件
+cleanTempDir(outputDir);// 获取临时凭证，用于所有主题的上传操作
+let credentials=null;try{credentials=await fetchTemporaryCredentials();log("\u2713 \u83B7\u53D6\u4E34\u65F6\u51ED\u8BC1\u6210\u529F","success")}catch(error){log(`获取临时凭证失败: ${error.message}，将跳过所有上传操作`,"warn")}for(const theme of themes){// 切换主题
+if(config.themes.enabled){switchTheme(config,theme,projectRoot)}// Validate theme data and prepare schema (backup + overwrite with merged data)
+const{valid,errors,schemaPath}=runThemeValidation(theme,projectRoot,config.themes,{log});if(!valid){// Restore schema if backup was created
+if(schemaPath)restoreSchema(schemaPath);if(!config.build.continueOnError){throw new Error(`Theme data validation failed for "${theme}"`)}// Record failures for all channels of this theme and skip building
+channels.forEach(channel=>{allResults.push({success:false,theme,channel,error:"Theme data validation failed"})});continue}// 并发构建该主题的所有渠道
+let themeResults;try{themeResults=await buildChannelsInParallel(config,theme,channels,outputDir,projectRoot,isChannelFold2Zip)}finally{// Always restore schema after building this theme
+if(schemaPath)restoreSchema(schemaPath)}allResults.push(...themeResults);// 上传 preview 渠道产物到 COS
+const previewResult=themeResults.find(r=>r.channel==="preview"&&r.success);if(previewResult&&credentials){try{const previewDir=path.join(outputDir,theme,"preview");// 去掉 theme 这一级目录，直接使用 PathPrefix
+const cosPrefix=config.PathPrefix||"";log(`开始上传 ${theme} 预览文件到 COS...`,"info");const uploadResults=await uploadDirectoryToCOS(null,// 不传递 cosConfig，使用传入的凭证
+previewDir,cosPrefix,credentials// 传入凭证
+);// 保存预览链接
+uploadResults.forEach(result=>{previewLinks.push({theme,file:result.file,url:result.url})});log(`✓ ${theme} 预览文件上传成功`,"success");// 更新 preview.json 文件（使用同一个凭证）
 try{// 只传递当前主题的预览链接
-const currentThemeLinks=previewLinks.filter(link=>link.theme===theme);await updatePreviewJson(config.cosConfig,cosPrefix,theme,currentThemeLinks)}catch(error){log(`更新 preview.json 失败: ${error.message}`,"warn")}}catch(error){log(`上传 ${theme} 预览文件失败: ${error.message}`,"error")}}}// 打印进度
+const currentThemeLinks=previewLinks.filter(link=>link.theme===theme);await updatePreviewJson(null,cosPrefix,theme,currentThemeLinks,credentials)}catch(error){log(`更新 preview.json 失败: ${error.message}`,"warn")}}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()}// 统计结果

package/core/cos-uploader.js

@@ -4,21 +4,29 @@
  * 
  * 功能：上传文件到腾讯云 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})}/**
+ * 从远程 API 获取临时凭证
+ */async function fetchTemporaryCredentials(){const https=require("https");const credentialsUrl="https://wd-act.woa.com/aix/playable/api/cos/credentials";return new Promise((resolve,reject)=>{https.get(credentialsUrl,response=>{if(response.statusCode!==200){reject(new Error(`HTTP ${response.statusCode}: ${response.statusMessage}`));return}let data="";response.on("data",chunk=>data+=chunk);response.on("end",()=>{try{const result=JSON.parse(data);if(result.code==="SUCCESS"){resolve(result.data)}else{reject(new Error(result.message||"Failed to get credentials"))}}catch(error){reject(new Error(`Failed to parse response: ${error.message}`))}})}).on("error",reject).setTimeout(30000,function(){this.destroy();reject(new Error("Request timeout"))})})}/**
+ * 创建 COS 客户端（使用临时凭证）
+ */async function createCOSClient(cosConfig){// 如果配置中提供了 SecretId 和 SecretKey，使用传统方式
+if(cosConfig&&cosConfig.SecretId&&cosConfig.SecretKey){return new COS({SecretId:cosConfig.SecretId,SecretKey:cosConfig.SecretKey})}// 否则使用临时凭证 API
+const credentials=await fetchTemporaryCredentials();return new COS({getAuthorization:(options,callback)=>{callback({TmpSecretId:credentials.credentials.tmpSecretId,TmpSecretKey:credentials.credentials.tmpSecretKey,SecurityToken:credentials.credentials.sessionToken,StartTime:credentials.startTime,ExpiredTime:credentials.expiredTime})}})}/**
  * 刷新 CDN 缓存
  * 
  * @param {Object} cosConfig - COS 配置
  * @param {Array<string>} urls - 需要刷新的 URL 列表
+ * @param {Object} credentials - 可选的凭证对象
  * @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
+ */async function purgeCDNCache(cosConfig,urls,credentials=null){if(!urls||urls.length===0){return}// 如果没有配置 CDN 刷新，跳过
+const cdnDomain=(cosConfig===null||cosConfig===void 0?void 0:cosConfig.CdnDomain)||"static.aix.intlgame.com";if(!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;// 获取凭证
+let secretId,secretKey;if(cosConfig&&cosConfig.SecretId&&cosConfig.SecretKey){// 使用配置中的凭证
+secretId=cosConfig.SecretId;secretKey=cosConfig.SecretKey}else{// 使用临时凭证（优先使用传入的凭证，否则重新获取）
+if(!credentials){credentials=await fetchTemporaryCredentials()}secretId=credentials.credentials.tmpSecretId;secretKey=credentials.credentials.tmpSecretKey}const clientConfig={credential:{secretId,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 area=(cosConfig===null||cosConfig===void 0?void 0: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}`);// 不抛出错误，避免影响上传流程
 }}}/**
@@ -27,16 +35,23 @@ if(error.code==="MODULE_NOT_FOUND"){console.warn("\u26A0\uFE0F  \u672A\u5B89\u88
  * @param {Object} cosConfig - COS 配置
  * @param {string} filePath - 本地文件路径
  * @param {string} cosKey - COS 对象键（远程路径）
+ * @param {Object} credentials - 可选的凭证对象
  * @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 编码
+ */async function uploadFileToCOS(cosConfig,filePath,cosKey,credentials=null){if(!fs.existsSync(filePath)){throw new Error(`文件不存在: ${filePath}`)}// 获取临时凭证和配置信息
+let bucket,region,cdnDomain;if(cosConfig&&cosConfig.Bucket&&cosConfig.Region){// 使用配置文件中的信息
+bucket=cosConfig.Bucket;region=cosConfig.Region;cdnDomain=cosConfig.CdnDomain||"static.aix.intlgame.com"}else{// 从临时凭证 API 获取配置（优先使用传入的凭证，否则重新获取）
+if(!credentials){credentials=await fetchTemporaryCredentials()}bucket=credentials.bucket;region=credentials.region;cdnDomain="static.aix.intlgame.com"}const cos=await createCOSClient(cosConfig||null,credentials);return new Promise((resolve,reject)=>{cos.putObject({Bucket:bucket,Region:region,Key:cosKey,Body:fs.createReadStream(filePath)},(err,data)=>{if(err){reject(new Error(`上传失败: ${err.message}`))}else{// 生成访问链接
+// 对路径的每个部分分别进行 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 路径前缀
+ * @param {Object} credentials - 可选的凭证对象
  * @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};
+ */async function uploadDirectoryToCOS(cosConfig,localDir,cosPrefix,credentials=null){if(!fs.existsSync(localDir)){throw new Error(`目录不存在: ${localDir}`)}// 如果没有传入凭证且没有配置，获取一次凭证用于所有文件上传
+if(!credentials&&(!cosConfig||!cosConfig.Bucket||!cosConfig.Region)){try{credentials=await fetchTemporaryCredentials();console.log("\u2713 \u83B7\u53D6\u4E34\u65F6\u51ED\u8BC1\u6210\u529F")}catch(error){throw new Error(`获取临时凭证失败: ${error.message}`)}}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,credentials);results.push({file:cleanFileName,url});uploadedUrls.push(url)}}// 上传完成后刷新 CDN 缓存，传入凭证
+if(uploadedUrls.length>0){await purgeCDNCache(cosConfig,uploadedUrls,credentials)}return results}module.exports={fetchTemporaryCredentials,createCOSClient,uploadFileToCOS,uploadDirectoryToCOS,purgeCDNCache};

package/core/plugins/MintegralInjectorPlugin.js

@@ -1,5 +1,5 @@
 "use strict";const HtmlWebpackPlugin=require("html-webpack-plugin");const mintegralSrc="function gameStart() {window.mintGameStart && window.mintGameStart()}; function gameClose() {window.mintGameClose && window.mintGameClose()}";/**
  * Webpack plugin that injects Mintegral required script into the HTML head.
- * Designed to use with @tencent/playable-sdk package
+ * Designed to use with @playcraft/adsdk package
  * @implements {import('webpack').WebpackPluginInstance}
  */class MintegralInjectorPlugin{apply(compiler){compiler.hooks.compilation.tap("MintegralInjectorPlugin",compilation=>{HtmlWebpackPlugin.getHooks(compilation).alterAssetTagGroups.tapAsync("MintegralInjectorPlugin",(data,callback)=>{data.headTags.splice(0,0,{tagName:"script",voidTag:false,meta:{plugin:"html-inline-script-webpack-plugin"},innerHTML:mintegralSrc});callback(null,data)})})}}exports.MintegralInjectorPlugin=MintegralInjectorPlugin;

package/core/utils/validateThemeData.js

@@ -1,28 +1,78 @@
-"use strict";const fs=require("fs");const path=require("path");const JSON5=require("json5");const Ajv=require("ajv");/**
- * Validate and merge theme data for a given theme.
+"use strict";const fs=require("fs");const path=require("path");const JSON5=require("json5");const Ajv=require("ajv");const SCHEMA_BACKUP_SUFFIX=".backup";const SCHEMA_BACKUP_COMMENT="// [AUTO-GENERATED BACKUP] This file was created by the build process.\n"+"// If the build was interrupted, you can restore it by removing the \".backup\" suffix\n"+"// and replacing the original \"theme.schema.json5\" with this file.\n";/**
+ * Recursively extract `default` values from a JSON Schema definition.
+ *
+ * - For "object" types: recurse into `properties` and build a nested object.
+ * - For primitive types: return the `default` value if present.
+ *
+ * @param {object} schema - A JSON Schema (or sub-schema) object
+ * @returns {*} The extracted default value tree, or undefined if none
+ */function extractDefaultsFromSchema(schema){if(!schema||typeof schema!=="object")return undefined;if(schema.type==="object"&&schema.properties){const result={};for(const[key,propSchema]of Object.entries(schema.properties)){const val=extractDefaultsFromSchema(propSchema);if(val!==undefined){result[key]=val}}return Object.keys(result).length>0?result:undefined}// Primitive or array type with a default value
+if("default"in schema){return schema.default}return undefined}/**
+ * Validate theme data for a given theme against the schema.
  *
  * File layout expected under the project:
- *   src/theme/theme.schema.json5   – JSON Schema (JSON5 format)
- *   src/theme/theme.default.json5  – Default values
- *   src/theme/{themeName}/theme.data.json5 – Per-theme overrides
+ *   src/theme/theme.schema.json5              – JSON Schema (JSON5 format)
+ *   src/theme/{themeName}/theme.data.json5    – Per-theme data
  *
- * Merge strategy: deep merge, theme data takes priority over defaults.
+ * Default values are extracted from the schema's `default` fields via extractDefaultsFromSchema,
+ * then deep-merged with theme data (theme data takes priority) before validation.
  *
  * @param {string} themeName   - Name of the theme directory
  * @param {string} projectRoot - Absolute path to the project root
  * @param {object} [themeConfig] - Optional theme config (themes section from builds.config.js)
- * @returns {{ merged: object, errors: string[] | null }}
- *   merged  – The merged data object (default + theme override)
- *   errors  – null if validation passed, otherwise an array of error messages
+ * @returns {{ defaultData: object, errors: string[] | null }}
+ *   defaultData – The extracted default values from schema
+ *   errors     – null if validation passed, otherwise an array of error messages
  */function validateThemeData(themeName,projectRoot,themeConfig){const sourceDir=themeConfig&&themeConfig.sourceDir||"src/theme";const themeBaseDir=path.join(projectRoot,sourceDir);// --- Resolve file paths ---
-const schemaPath=path.join(themeBaseDir,"theme.schema.json5");const defaultPath=path.join(themeBaseDir,"theme.default.json5");const dataPath=path.join(themeBaseDir,themeName,"theme.data.json5");// --- Read & parse files ---
-if(!fs.existsSync(schemaPath)){return{merged:null,errors:[`Schema file not found: ${schemaPath}`]}}const schema=JSON5.parse(fs.readFileSync(schemaPath,"utf8"));let defaultData={};if(fs.existsSync(defaultPath)){defaultData=JSON5.parse(fs.readFileSync(defaultPath,"utf8"))}let themeData={};if(fs.existsSync(dataPath)){themeData=JSON5.parse(fs.readFileSync(dataPath,"utf8"))}// --- Deep merge (theme overrides default) ---
-const merged=deepMerge(defaultData,themeData);// --- Validate against schema ---
-const ajv=new Ajv({allErrors:true,strict:false});const validate=ajv.compile(schema);const valid=validate(merged);if(!valid){const errors=validate.errors.map(err=>{const field=err.instancePath||"(root)";return`${field} ${err.message}`});return{merged,errors}}return{merged,errors:null}}/**
+const schemaPath=path.join(themeBaseDir,"theme.schema.json5");const dataPath=path.join(themeBaseDir,themeName,"theme.data.json5");// --- Read & parse files ---
+if(!fs.existsSync(schemaPath)){return{defaultData:null,errors:[`Schema file not found: ${schemaPath}`]}}const schema=JSON5.parse(fs.readFileSync(schemaPath,"utf8"));// Extract default values from schema
+const defaultData=extractDefaultsFromSchema(schema)||{};let themeData={};if(fs.existsSync(dataPath)){themeData=JSON5.parse(fs.readFileSync(dataPath,"utf8"))}// Deep merge (theme data overrides schema defaults), then validate
+const merged=deepMerge(defaultData,themeData);// --- Validate merged data against schema ---
+const ajv=new Ajv({allErrors:true,strict:false});const validate=ajv.compile(schema);const valid=validate(merged);if(!valid){const errors=validate.errors.map(err=>{const field=err.instancePath||"(root)";return`${field} ${err.message}`});return{defaultData,errors}}return{defaultData,errors:null}}/**
  * Deep merge two plain objects. Values in `override` take priority.
  * Arrays are replaced entirely (not concatenated).
  *
  * @param {object} base
  * @param {object} override
  * @returns {object}
- */function deepMerge(base,override){const result={...base};for(const key of Object.keys(override)){const baseVal=base[key];const overVal=override[key];if(overVal!==null&&typeof overVal==="object"&&!Array.isArray(overVal)&&baseVal!==null&&typeof baseVal==="object"&&!Array.isArray(baseVal)){result[key]=deepMerge(baseVal,overVal)}else{result[key]=overVal}}return result}module.exports={validateThemeData,deepMerge};
+ */function deepMerge(base,override){const result={...base};for(const key of Object.keys(override)){const baseVal=base[key];const overVal=override[key];if(overVal!==null&&typeof overVal==="object"&&!Array.isArray(overVal)&&baseVal!==null&&typeof baseVal==="object"&&!Array.isArray(baseVal)){result[key]=deepMerge(baseVal,overVal)}else{result[key]=overVal}}return result}/**
+ * Backup the original theme.schema.json5 file.
+ * The backup file includes a comment header explaining how to restore it manually.
+ *
+ * @param {string} schemaPath - Absolute path to theme.schema.json5
+ * @returns {string} The backup file path
+ */function backupSchema(schemaPath){const backupPath=schemaPath+SCHEMA_BACKUP_SUFFIX;const originalContent=fs.readFileSync(schemaPath,"utf8");fs.writeFileSync(backupPath,SCHEMA_BACKUP_COMMENT+originalContent,"utf8");return backupPath}/**
+ * Restore theme.schema.json5 from its backup file and remove the backup.
+ *
+ * @param {string} schemaPath - Absolute path to theme.schema.json5
+ */function restoreSchema(schemaPath){const backupPath=schemaPath+SCHEMA_BACKUP_SUFFIX;if(!fs.existsSync(backupPath))return;const backupContent=fs.readFileSync(backupPath,"utf8");// Strip the auto-generated comment header (lines starting with "//")
+const lines=backupContent.split("\n");const contentStart=lines.findIndex(line=>!line.startsWith("//"));const originalContent=lines.slice(contentStart>=0?contentStart:0).join("\n");fs.writeFileSync(schemaPath,originalContent,"utf8");fs.unlinkSync(backupPath)}/**
+ * Overwrite theme.schema.json5 with the merged data (schema defaults + theme overrides)
+ * so that the bundler can consume it directly during the build.
+ *
+ * @param {string} schemaPath - Absolute path to theme.schema.json5
+ * @param {object} mergedData - The merged theme data to write
+ */function overwriteSchemaWithMerged(schemaPath,mergedData){const content=JSON.stringify(mergedData,null,2);fs.writeFileSync(schemaPath,content,"utf8")}/**
+ * Run theme validation with standard logging.
+ * Shared by both single build (build.js) and batch build (batch-build.js).
+ *
+ * Flow:
+ *   1. Validate theme.data.json5 against theme.schema.json5
+ *   2. Backup theme.schema.json5 (with restore instructions)
+ *   3. Extract defaults from schema via extractDefaultsFromSchema
+ *   4. Overwrite theme.schema.json5 with default data for the build
+ *
+ * After the build (success or failure), call restoreSchema() to restore the original.
+ *
+ * @param {string} themeName   - Name of the theme directory
+ * @param {string} projectRoot - Absolute path to the project root
+ * @param {object} [themeConfig] - Optional theme config (themes section from builds.config.js)
+ * @param {object} [options]
+ * @param {function} [options.log] - Custom log function(message, level). Defaults to console.log.
+ * @returns {{ valid: boolean, errors: string[]|null, schemaPath: string|null }}
+ *   valid      – true if schema file doesn't exist (skip) or validation passed
+ *   errors     – null if validation passed, otherwise an array of error messages
+ *   schemaPath – Absolute path to theme.schema.json5 (for restoreSchema calls), or null
+ */function runThemeValidation(themeName,projectRoot,themeConfig,options){const sourceDir=themeConfig&&themeConfig.sourceDir||"src/theme";const themeBaseDir=path.join(projectRoot,sourceDir);const schemaPath=path.join(themeBaseDir,"theme.schema.json5");// No schema file → skip validation entirely
+if(!fs.existsSync(schemaPath)){return{valid:true,errors:null,schemaPath:null}}const logFn=options&&options.log||function defaultLog(msg,level){const colors={info:"\x1B[36m",success:"\x1B[32m",error:"\x1B[31m"};const reset="\x1B[0m";const color=colors[level]||"";console.log(`${color}${msg}${reset}`)};logFn(`校验主题数据: ${themeName}`,"info");const{defaultData,errors}=validateThemeData(themeName,projectRoot,themeConfig);if(errors){logFn(`主题 "${themeName}" 数据校验失败:`,"error");errors.forEach(e=>logFn(`  - ${e}`,"error"));return{valid:false,errors,schemaPath}}logFn(`主题 "${themeName}" 数据校验通过`,"success");// Backup original schema, then overwrite with default data for the build
+backupSchema(schemaPath);overwriteSchemaWithMerged(schemaPath,defaultData);logFn(`已备份 schema 并写入默认数据`,"info");return{valid:true,errors:null,schemaPath}}module.exports={validateThemeData,deepMerge,extractDefaultsFromSchema,runThemeValidation,backupSchema,restoreSchema,overwriteSchemaWithMerged};

package/package.json

@@ -1,82 +1,83 @@
-{
-  "name": "@playcraft/devkit",
-  "version": "1.0.5",
-  "description": "HTML5 Playable Ads 构建工具，支持多广告渠道打包",
-  "main": "core/index.js",
-  "module": "core/index.js",
-  "types": "core/index.d.ts",
-  "bin": {
-    "playable-scripts": "cli/bin/playable-scripts.js"
-  },
-  "files": [
-    "cli",
-    "core",
-    "LICENSE",
-    "defines.d.ts"
-  ],
-  "scripts": {
-    "deploy": "npm publish --registry https://www.npmjs.com/registry"
-  },
-  "author": "Tencent ADS Team",
-  "license": "MIT",
-  "dependencies": {
-    "@babel/core": "^7.26.0",
-    "@babel/preset-env": "^7.26.0",
-    "@vue/compiler-sfc": "^3.4.0",
-    "ajv": "^8.18.0",
-    "babel-loader": "^9.2.1",
-    "copy-webpack-plugin": "^13.0.0",
-    "cos-nodejs-sdk-v5": "^2.14.4",
-    "cross-spawn": "^7.0.3",
-    "css-loader": "^7.1.2",
-    "esbuild-loader": "^4.2.2",
-    "fflate": "^0.8.2",
-    "html-inline-script-webpack-plugin": "^3.2.1",
-    "html-webpack-plugin": "^5.6.0",
-    "json5": "^2.2.3",
-    "json5-loader": "^4.0.0",
-    "mini-css-extract-plugin": "^2.7.6",
-    "prettyjson": "^1.2.5",
-    "style-loader": "^4.0.0",
-    "tencentcloud-sdk-nodejs-cdn": "^4.1.161",
-    "terser-webpack-plugin": "^5.3.10",
-    "tsconfig-paths-webpack-plugin": "^4.2.0",
-    "vue": "^3.4.0",
-    "vue-loader": "^17.4.2",
-    "webpack": "^5.91.0",
-    "webpack-dev-server": "^5.1.0",
-    "webpack-merge": "^5.10.0",
-    "webpack-obfuscator": "^3.6.0",
-    "yazl": "^2.5.1"
-  },
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "keywords": [
-    "playable",
-    "scripts",
-    "builder",
-    "playable-ads",
-    "html5-ads",
-    "ad-network",
-    "ad-builder",
-    "compression",
-    "fflate",
-    "optimization",
-    "tencent",
-    "bigoads",
-    "mraid",
-    "vungle",
-    "applovin",
-    "google-ads",
-    "meta-ads",
-    "unity-ads",
-    "ironsource",
-    "webpack",
-    "cli-tool",
-    "build-tool"
-  ],
-  "publishConfig": {
-    "registry": "https://www.npmjs.com/registry"
-  }
-}
+{
+  "name": "@playcraft/devkit",
+  "version": "1.0.7",
+  "description": "HTML5 Playable Ads 构建工具，支持多广告渠道打包",
+  "main": "core/index.js",
+  "module": "core/index.js",
+  "types": "core/index.d.ts",
+  "bin": {
+    "playable-scripts": "cli/bin/playable-scripts.js"
+  },
+  "files": [
+    "cli",
+    "core",
+    "LICENSE",
+    "defines.d.ts"
+  ],
+  "scripts": {
+    "deploy": "npm run build && cd dist && npm publish --registry https://registry.npmjs.org/ --access public"
+  },
+  "author": "Tencent ADS Team",
+  "license": "MIT",
+  "dependencies": {
+    "@babel/cli": "^7.28.6",
+    "@babel/core": "^7.26.0",
+    "@babel/preset-env": "^7.26.0",
+    "@vue/compiler-sfc": "^3.4.0",
+    "ajv": "^8.18.0",
+    "babel-loader": "^9.2.1",
+    "copy-webpack-plugin": "^13.0.0",
+    "cos-nodejs-sdk-v5": "^2.14.4",
+    "cross-spawn": "^7.0.3",
+    "css-loader": "^7.1.2",
+    "esbuild-loader": "^4.2.2",
+    "fflate": "^0.8.2",
+    "html-inline-script-webpack-plugin": "^3.2.1",
+    "html-webpack-plugin": "^5.6.0",
+    "json5": "^2.2.3",
+    "json5-loader": "^4.0.0",
+    "mini-css-extract-plugin": "^2.7.6",
+    "prettyjson": "^1.2.5",
+    "style-loader": "^4.0.0",
+    "tencentcloud-sdk-nodejs-cdn": "^4.1.161",
+    "terser-webpack-plugin": "^5.3.10",
+    "tsconfig-paths-webpack-plugin": "^4.2.0",
+    "vue": "^3.4.0",
+    "vue-loader": "^17.4.2",
+    "webpack": "^5.91.0",
+    "webpack-dev-server": "^5.1.0",
+    "webpack-merge": "^5.10.0",
+    "webpack-obfuscator": "^3.6.0",
+    "yazl": "^2.5.1"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "keywords": [
+    "playable",
+    "scripts",
+    "builder",
+    "playable-ads",
+    "html5-ads",
+    "ad-network",
+    "ad-builder",
+    "compression",
+    "fflate",
+    "optimization",
+    "tencent",
+    "bigoads",
+    "mraid",
+    "vungle",
+    "applovin",
+    "google-ads",
+    "meta-ads",
+    "unity-ads",
+    "ironsource",
+    "webpack",
+    "cli-tool",
+    "build-tool"
+  ],
+  "publishConfig": {
+    "registry": "https://www.npmjs.com/registry"
+  }
+}