@playcraft/build 0.0.36 → 0.0.37

package/dist/engines/playable-scripts-adapter.js

@@ -1029,8 +1029,19 @@ export class PlayableScriptsAdapter {
             }, options.timeout);
             // shell: true 时 Node.js 把 cmd + args 拼接成 shell 字符串，
             // 但不会转义 args 中的特殊字符（如 URL 里的 &）。
-            // 用单引号包裹每个 arg 防止 shell 解析（单引号内只有 ' 本身需要转义）。
-            const shellSafeArgs = args.map(a => `'${a.replace(/'/g, "'\\''")}'`);
+            // 需要按平台分别处理：
+            //  - Windows (cmd.exe) 不认识单引号，用双引号；cmd 的特殊字符用 ^ 转义
+            //  - POSIX (bash/sh) 使用单引号强引用
+            const isWindows = process.platform === 'win32';
+            const shellSafeArgs = args.map((a) => {
+                if (isWindows) {
+                    // cmd.exe：用双引号包裹，内部的 " 转义为 ""，其它 shell 元字符用 ^ 转义
+                    const escaped = a.replace(/"/g, '""').replace(/([&|<>^%])/g, '^$1');
+                    return `"${escaped}"`;
+                }
+                // POSIX：单引号包裹，单引号本身通过 '\'' 断开转义
+                return `'${a.replace(/'/g, "'\\''")}'`;
+            });
             const child = spawn(cmd, shellSafeArgs, {
                 cwd: options.cwd,
                 env: options.env,

package/dist/platforms/base.d.ts

@@ -70,14 +70,14 @@ export declare abstract class PlatformAdapter {
      */
     protected getTrackingAdapterScriptAsync(): Promise<string>;
     /**
-     * 从 @playcraft/adsdk 包中提取 tracking 实现代码
-     * 读取 IIFE 版本中 `// src/tracking.ts` 到 `var tracking = {...};` 的代码段
-     * 包装为独立 IIFE 并暴露 window.PlayCraftTracking
+     * 从 @playcraft/ads-tracking 包中提取 tracking 实现代码
+     * 读取 IIFE 版本，剥掉最外层的自执行箭头函数包装，
+     * 重新包裹为独立 IIFE 并通过 window.PlayCraftTracking 暴露。
      */
     protected getAdsdkTrackingScriptAsync(): Promise<string>;
     /**
      * 在 HTML 中注入 Tracking 适配器（异步版本）
-     * 注入顺序：1.Config → 2.adsdk tracking 实现 → 3.Adapter 桥接脚本
+     * 注入顺序：1.Config → 2.ads-tracking 实现 → 3.Adapter 桥接脚本
      */
     protected injectTrackingAdapterAsync(html: string): Promise<string>;
 }

package/dist/platforms/base.js

@@ -6,8 +6,8 @@ import { minifyPatchCode } from '../utils/minify.js';
 let cachedMinifiedCTAAdapter = null;
 // 缓存压缩后的 Tracking 适配器代码
 let cachedMinifiedTrackingAdapter = null;
-// 缓存从 @playcraft/adsdk 提取的 tracking 实现代码
-let cachedAdsdkTrackingScript = null;
+// 缓存从 @playcraft/ads-tracking 提取的 tracking 实现代码
+let cachedAdsTrackingScript = null;
 // 缓存压缩后的平台脚本
 const platformScriptCache = new Map();
 export class PlatformAdapter {
@@ -151,54 +151,59 @@ export class PlatformAdapter {
         return `<script>${minified}</script>`;
     }
     /**
-     * 从 @playcraft/adsdk 包中提取 tracking 实现代码
-     * 读取 IIFE 版本中 `// src/tracking.ts` 到 `var tracking = {...};` 的代码段
-     * 包装为独立 IIFE 并暴露 window.PlayCraftTracking
+     * 从 @playcraft/ads-tracking 包中提取 tracking 实现代码
+     * 读取 IIFE 版本，剥掉最外层的自执行箭头函数包装，
+     * 重新包裹为独立 IIFE 并通过 window.PlayCraftTracking 暴露。
      */
     async getAdsdkTrackingScriptAsync() {
-        if (cachedAdsdkTrackingScript) {
-            return `<script>${cachedAdsdkTrackingScript}</script>`;
+        if (cachedAdsTrackingScript) {
+            return `<script>${cachedAdsTrackingScript}</script>`;
         }
         try {
-            // 从 @playcraft/adsdk 的 IIFE 构建中读取
+            // 从 @playcraft/ads-tracking 的 IIFE 构建中读取
             const { createRequire } = await import('module');
             const require = createRequire(import.meta.url);
-            const adsdkPath = require.resolve('@playcraft/adsdk/dist/iife/index.js');
-            const iifeCode = await fs.readFile(adsdkPath, 'utf-8');
-            // 提取 tracking 部分：从 "// src/tracking.ts" 到 "trackChallengeFailed" 对象结尾
+            const adsTrackingPath = require.resolve('@playcraft/ads-tracking/dist/iife/index.js');
+            const iifeCode = await fs.readFile(adsTrackingPath, 'utf-8');
+            // 提取 IIFE 内部实现：ads-tracking 的 IIFE 形如
+            //   "use strict";\n(() => {\n  // src/tracking.ts\n  ...\n  var tracking = {...};\n})();
+            // 需要剥掉最外层 (() => { ... })(); 保留内部代码，
+            // 再在末尾挂到 window.PlayCraftTracking 上。
             const startMarker = '// src/tracking.ts';
-            const endMarker = 'trackChallengeFailed: _trackChallengeFailed';
             const startIdx = iifeCode.indexOf(startMarker);
-            const endIdx = iifeCode.indexOf(endMarker);
-            if (startIdx === -1 || endIdx === -1) {
-                console.warn('[Tracking] 无法从 @playcraft/adsdk 中提取 tracking 代码，使用内置 adapter');
+            if (startIdx === -1) {
+                console.warn('[Tracking] 无法从 @playcraft/ads-tracking 中提取 tracking 代码，使用内置 adapter');
                 return '';
             }
-            // 找到 tracking 对象定义结束的 `};`
-            const afterEnd = iifeCode.indexOf('};', endIdx);
-            const trackingCode = iifeCode.substring(startIdx, afterEnd + 2);
+            // 找到最后一个 "})();" 作为 IIFE 结束
+            const endIdx = iifeCode.lastIndexOf('})();');
+            if (endIdx === -1 || endIdx <= startIdx) {
+                console.warn('[Tracking] 无法定位 @playcraft/ads-tracking IIFE 结尾，使用内置 adapter');
+                return '';
+            }
+            const innerCode = iifeCode.substring(startIdx, endIdx).trimEnd();
             // 包装为独立 IIFE，暴露 window.PlayCraftTracking
-            const wrappedCode = `(function(){"use strict";${trackingCode}\nwindow.PlayCraftTracking=tracking;})();`;
-            const minified = await minifyPatchCode(wrappedCode, 'adsdk-tracking-extract');
-            cachedAdsdkTrackingScript = minified;
+            const wrappedCode = `(function(){"use strict";${innerCode}\nwindow.PlayCraftTracking=tracking;})();`;
+            const minified = await minifyPatchCode(wrappedCode, 'ads-tracking-extract');
+            cachedAdsTrackingScript = minified;
             return `<script>${minified}</script>`;
         }
         catch (e) {
-            console.warn('[Tracking] 无法加载 @playcraft/adsdk:', e.message);
+            console.warn('[Tracking] 无法加载 @playcraft/ads-tracking:', e.message);
             return '';
         }
     }
     /**
      * 在 HTML 中注入 Tracking 适配器（异步版本）
-     * 注入顺序：1.Config → 2.adsdk tracking 实现 → 3.Adapter 桥接脚本
+     * 注入顺序：1.Config → 2.ads-tracking 实现 → 3.Adapter 桥接脚本
      */
     async injectTrackingAdapterAsync(html) {
         if (this.options.tracking?.enabled === false)
             return html;
         const configScript = this.getTrackingConfigScript();
-        const adsdkScript = await this.getAdsdkTrackingScriptAsync();
+        const adsTrackingScript = await this.getAdsdkTrackingScriptAsync();
         const trackingScript = await this.getTrackingAdapterScriptAsync();
-        const combined = configScript + adsdkScript + trackingScript;
+        const combined = configScript + adsTrackingScript + trackingScript;
         if (html.includes('</head>')) {
             return html.replace('</head>', `${combined}\n</head>`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/build",
-  "version": "0.0.36",
+  "version": "0.0.37",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -16,6 +16,11 @@
       "require": "./dist/types.js",
       "types": "./dist/types.d.ts"
     },
+    "./scene-asset-collector": {
+      "import": "./dist/analyzers/scene-asset-collector.js",
+      "require": "./dist/analyzers/scene-asset-collector.js",
+      "types": "./dist/analyzers/scene-asset-collector.d.ts"
+    },
     "./dist/*": "./dist/*"
   },
   "files": [
@@ -30,7 +35,7 @@
     "release": "node scripts/release.js"
   },
   "dependencies": {
-    "@playcraft/adsdk": "^1.0.13",
+    "@playcraft/ads-tracking": "^1.0.0",
     "@gltf-transform/core": "^4.3.0",
     "@gltf-transform/extensions": "^4.3.0",
     "@gltf-transform/functions": "^4.3.0",
@@ -50,7 +55,7 @@
     "vite-plugin-singlefile": "^2.3.2"
   },
   "devDependencies": {
-    "@playcraft/adsdk": "^1.0.13",
+    "@playcraft/ads-tracking": "^1.0.0",
     "@types/archiver": "^6.0.4",
     "@types/mime-types": "^2.1.4",
     "@types/node": "^22.19.8",

package/templates/patches/playcraft-tracking-adapter.js

@@ -2,8 +2,20 @@
  * PlayCraft Tracking Adapter (Bridge Layer)
  *
  * 职责：在正确的生命周期节点调用 window.PlayCraftTracking 的方法。
- * 渠道埋点逻辑由 @playcraft/adsdk 的 tracking 模块提供（构建时自动提取注入）。
- * 如果 adsdk tracking 未注入，adapter 的调用会静默忽略。
+ * 渠道埋点逻辑由 @playcraft/ads-tracking 的 tracking 模块提供（构建时自动提取注入）。
+ * 如果 ads-tracking 未注入，adapter 的调用会静默忽略。
+ *
+ * 新 API 对照（@playcraft/ads-tracking v1.0.0）：
+ *   onPlaycraftTrackingInit      - SDK 初始化开始
+ *   onPlaycraftTrackingLoading   - 游戏资源加载中
+ *   onPlaycraftTrackingLoaded    - 资源加载完成、主场景就绪
+ *   onPlaycraftChallengeStart    - 游戏挑战开始（首次用户交互）
+ *   onPlaycraftChallengeProgress - 进度上报 (percent 0-100)，内部自动触发里程碑
+ *   onPlaycraftChallengeSuccess  - 游戏挑战成功
+ *   onPlaycraftChallengeFailed   - 游戏挑战失败
+ *   onPlaycraftChallengeFinish   - 游戏结束
+ *   onPlaycraftInstall           - 点击安装
+ *   onPlaycraftRetry             - 重试游戏
  */
 (function() {
   'use strict';
@@ -23,28 +35,44 @@
     }
   }
 
+  // ===== 进度上报（兼容旧的 setTotalInteractions + checkInteractionProgress）=====
+  // 新包只提供 onPlaycraftChallengeProgress(percent 0-100)，里程碑由 SDK 内部处理。
+  // 这里维护 total 状态，将 (current/total*100) 转换为百分比上报。
+  var _total = totalInteractions > 0 ? totalInteractions : 0;
+  function setTotal(n) {
+    if (typeof n === 'number' && n > 0) _total = n;
+  }
+  function reportProgress(current) {
+    if (typeof current !== 'number') return;
+    var percent;
+    if (_total > 0) {
+      percent = Math.min(100, Math.max(0, (current / _total) * 100));
+    } else {
+      // 未设置 total 时，把传入值当作已经是百分比
+      percent = Math.min(100, Math.max(0, current));
+    }
+    call('onPlaycraftChallengeProgress', [percent]);
+  }
+
   // ===== 自动埋点 =====
 
-  // 1. setTotalInteractions + onInit（立即）
-  if (totalInteractions > 0) {
-    call('setTotalInteractions', [totalInteractions]);
-  }
-  call('onInit', [adNetwork]);
+  // 1. onPlaycraftTrackingInit（立即）
+  call('onPlaycraftTrackingInit', [adNetwork]);
 
-  // 2. onStart（页面加载完成）
+  // 2. onPlaycraftTrackingLoading（页面加载完成）
   if (document.readyState === 'complete') {
-    setTimeout(function() { call('onStart', [adNetwork]); }, 0);
+    setTimeout(function() { call('onPlaycraftTrackingLoading', [adNetwork]); }, 0);
   } else {
-    window.addEventListener('load', function() { call('onStart', [adNetwork]); });
+    window.addEventListener('load', function() { call('onPlaycraftTrackingLoading', [adNetwork]); });
   }
 
-  // 2.5 onInteractive（游戏完全就绪，可交互）
+  // 2.5 onPlaycraftTrackingLoaded（游戏完全就绪，可交互）
   // 优先级: playcraft:interactive 事件 > PlayCanvas app.on('start') fallback
   var _interactive = false;
   function triggerInteractive() {
     if (_interactive) return;
     _interactive = true;
-    call('onInteractive', [adNetwork]);
+    call('onPlaycraftTrackingLoaded', [adNetwork]);
   }
   // 优先监听游戏主动派发的 playcraft:interactive
   document.addEventListener('playcraft:interactive', triggerInteractive);
@@ -66,12 +94,12 @@
   }
   setTimeout(pollPlayCanvasApp, 0);
 
-  // 3. onInteraction（首次用户交互，只触发一次）
+  // 3. onPlaycraftChallengeStart（首次用户交互，只触发一次）
   var _interacted = false;
   function onFirstInteraction() {
     if (_interacted) return;
     _interacted = true;
-    call('onInteraction', [adNetwork]);
+    call('onPlaycraftChallengeStart', [adNetwork]);
     document.removeEventListener('touchstart', onFirstInteraction, true);
     document.removeEventListener('mousedown', onFirstInteraction, true);
     document.removeEventListener('pointerdown', onFirstInteraction, true);
@@ -80,13 +108,13 @@
   document.addEventListener('mousedown', onFirstInteraction, true);
   document.addEventListener('pointerdown', onFirstInteraction, true);
 
-  // 4. onInstall（hook CTA adapter）
+  // 4. onPlaycraftInstall（hook CTA adapter）
   var _ctaAttempts = 0;
   function hookCTA() {
     if (window.PlayCraftCTA && window.PlayCraftCTA.jump) {
       var _orig = window.PlayCraftCTA.jump;
       window.PlayCraftCTA.jump = function(opts) {
-        call('onInstall', [adNetwork]);
+        call('onPlaycraftInstall', [adNetwork]);
         _orig.call(window.PlayCraftCTA, opts);
       };
       if (window.jump2AppStore) window.jump2AppStore = window.PlayCraftCTA.jump;
@@ -110,21 +138,30 @@
     });
   }
 
-  listenOnce('playcraft:finish', 'onFinish');
-  listen('playcraft:success', 'trackChallengeSuccess');
-  listen('playcraft:failed', 'trackChallengeFailed');
+  listenOnce('playcraft:finish', 'onPlaycraftChallengeFinish');
+  listen('playcraft:success', 'onPlaycraftChallengeSuccess');
+  listen('playcraft:failed', 'onPlaycraftChallengeFailed');
   document.addEventListener('playcraft:retry', function() {
     once['playcraft:finish'] = false;
-    call('onRetry', [adNetwork]);
+    call('onPlaycraftRetry', [adNetwork]);
   });
   document.addEventListener('playcraft:setTotal', function(e) {
     var d = e.detail;
     var n = typeof d === 'number' ? d : (d && d.total);
-    if (typeof n === 'number') call('setTotalInteractions', [n]);
+    if (typeof n === 'number') setTotal(n);
   });
   document.addEventListener('playcraft:progress', function(e) {
     var d = e.detail;
-    var n = typeof d === 'number' ? d : (d && d.current);
-    if (typeof n === 'number') call('checkInteractionProgress', [n]);
+    // 兼容两种传参：number（当前值）或 { current, total, percent }
+    if (typeof d === 'number') {
+      reportProgress(d);
+    } else if (d && typeof d === 'object') {
+      if (typeof d.total === 'number') setTotal(d.total);
+      if (typeof d.percent === 'number') {
+        call('onPlaycraftChallengeProgress', [Math.min(100, Math.max(0, d.percent))]);
+      } else if (typeof d.current === 'number') {
+        reportProgress(d.current);
+      }
+    }
   });
 })();