@playcraft/build 0.0.41 → 0.0.42

package/dist/engines/playable-scripts-adapter.d.ts

@@ -86,6 +86,13 @@ export declare class PlayableScriptsAdapter {
      * 从参数列表中移除指定参数及其值
      */
     private removeArg;
+    /**
+     * 统一构造 pnpm CLI 参数：
+     *   - 透传通用 flag（dangerouslyAllowAllBuilds / strict-peer-dependencies / reporter）
+     *   - 按 NPM_REGISTRY 透传 --registry（与 helm values.yaml 的 mirrors.tencent.com 对齐）
+     * 让 ensureLocalDevkit 的 install 与 ensureBuildLoaders 的 add 共享同一套基础约束。
+     */
+    private buildPnpmArgs;
     /**
      * 查找项目本地的 playable-scripts 可执行文件
      * 优先查找项目 node_modules 中的版本，确保 webpack 能正确解析 loader
@@ -97,8 +104,15 @@ export declare class PlayableScriptsAdapter {
      */
     private ensureLocalDevkit;
     /**
-     * 检查构建所需 loader 是否存在（babel-loader）
-     * 注意：babel-loader 是必须的，esbuild-loader/esbuild 是 devkit 内部可选依赖
+     * 检查构建所需 loader 是否存在，缺失则尝试在 worker 容器内现场兜底安装。
+     *
+     * 分两类：
+     * 1) required：必须存在（babel-loader）。缺失先尝试 pnpm add 兜底，仍找不到才告警。
+     * 2) optional：devkit 在某些路径（例如 obfuscateLevel >= 4 时走 esbuild minify）
+     *    会 require('esbuild-loader')，但游戏工程模板的 package.json 通常没有显式声明，
+     *    pnpm 严格模式下也不会被提升到顶层 node_modules。这里如果本地确认缺失，
+     *    就以 --save=false 现场补装到 node_modules/，不写回业务方的 package.json，
+     *    避免污染 lockfile。
      */
     private ensureBuildLoaders;
     /**

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

@@ -520,6 +520,26 @@ export class PlayableScriptsAdapter {
         }
         return result;
     }
+    /**
+     * 统一构造 pnpm CLI 参数：
+     *   - 透传通用 flag（dangerouslyAllowAllBuilds / strict-peer-dependencies / reporter）
+     *   - 按 NPM_REGISTRY 透传 --registry（与 helm values.yaml 的 mirrors.tencent.com 对齐）
+     * 让 ensureLocalDevkit 的 install 与 ensureBuildLoaders 的 add 共享同一套基础约束。
+     */
+    buildPnpmArgs(subcommand, extra = []) {
+        const args = [
+            subcommand,
+            ...extra,
+            '--config.dangerouslyAllowAllBuilds=true',
+            '--config.strict-peer-dependencies=false',
+            '--reporter=append-only',
+        ];
+        const reg = process.env.NPM_REGISTRY;
+        if (reg && reg !== 'https://registry.npmjs.org') {
+            args.push(`--registry=${reg}`);
+        }
+        return args;
+    }
     /**
      * 查找项目本地的 playable-scripts 可执行文件
      * 优先查找项目 node_modules 中的版本，确保 webpack 能正确解析 loader
@@ -581,94 +601,267 @@ export class PlayableScriptsAdapter {
             return found;
         }
         console.log('[PlayableScriptsAdapter] 未找到本地 playable-scripts，执行 pnpm install 安装项目依赖');
+        // 创建 .npmrc 文件，允许所有构建脚本执行
+        // 这样可以让 esbuild 等 native 模块正确编译
+        //
+        // 注意：新版 pnpm（>=9）引入了 onlyBuiltDependencies 安全策略，
+        //   未批准的包（esbuild/sharp 等）的 lifecycle 脚本会被忽略，
+        //   并以 exit code 1 退出（即使包本身已经全部解压成功），
+        //   日志会出现 [ERR_PNPM_IGNORED_BUILDS]。
+        //   这里通过 dangerously-allow-all-builds=true 关掉这个保护，
+        //   保证 install 在 PlayCraft 构建场景里以 0 退出。
+        const npmrcPath = path.join(this.projectDir, '.npmrc');
+        // 关于 hoist 配置：
+        //   shamefully-hoist=true 在新版 pnpm 上对间接依赖的 hoist 行为并不可靠（实测
+        //   esbuild-loader / json5-loader / style-loader 这类作为 @playcraft/devkit 的
+        //   间接依赖仍然停留在 .pnpm 隔离目录，不会被提到顶层 node_modules，导致
+        //   webpack 的 enhanced-resolve 在 cwd=projectDir 时找不到这些 loader，
+        //   报 "Can't resolve 'xxx-loader'"）。
+        //   因此显式追加 public-hoist-pattern，把所有 *-loader 以及 esbuild 系列
+        //   主动 hoist 到顶层；相比 shamefully-hoist=true 更显式、更稳定。
+        //   即使 hoist 仍然失败，下面的 ensureBuildLoaders() 会再用 .pnpm 软链兜底。
+        const npmrcContent = [
+            '# Temporary config for PlayCraft build',
+            'enable-pre-post-scripts=true',
+            'shamefully-hoist=true',
+            'public-hoist-pattern[]=*-loader',
+            'public-hoist-pattern[]=esbuild',
+            'public-hoist-pattern[]=esbuild-*',
+            'public-hoist-pattern[]=@esbuild/*',
+            'ignore-scripts=false',
+            'strict-peer-dependencies=false',
+            'dangerously-allow-all-builds=true',
+        ].join('\n');
+        try {
+            await fs.writeFile(npmrcPath, npmrcContent, 'utf-8');
+            console.log('[PlayableScriptsAdapter] 已创建 .npmrc 配置（允许构建脚本）');
+        }
+        catch (error) {
+            console.log('[PlayableScriptsAdapter] ⚠️ 无法创建 .npmrc:', error.message);
+        }
+        // pnpm install 命令兜底：CLI flag 与 .npmrc 双保险，并透传 NPM_REGISTRY
+        // （helm values.yaml 配置了 https://mirrors.tencent.com/npm，避免外网慢/不通）
+        const installArgs = this.buildPnpmArgs('install', ['--config.confirm-modules-purge=false']);
+        let installError;
         try {
             // 执行 pnpm install 安装 package.json 中定义的所有依赖
             // 包括 @playcraft/devkit 和 babel-loader 等构建工具
             // 注意：不要设置 NODE_ENV=production，否则会跳过 devDependencies
-            // 创建 .npmrc 文件，允许所有构建脚本执行
-            // 这样可以让 esbuild 等 native 模块正确编译
-            const npmrcPath = path.join(this.projectDir, '.npmrc');
-            const npmrcContent = [
-                '# Temporary config for PlayCraft build',
-                'enable-pre-post-scripts=true',
-                'shamefully-hoist=true',
-            ].join('\n');
-            try {
-                await fs.writeFile(npmrcPath, npmrcContent, 'utf-8');
-                console.log('[PlayableScriptsAdapter] 已创建 .npmrc 配置（允许构建脚本）');
-            }
-            catch (error) {
-                console.log('[PlayableScriptsAdapter] ⚠️ 无法创建 .npmrc:', error.message);
-            }
-            await this.runCommandWithTimeout('pnpm', ['install'], {
+            await this.runCommandWithTimeout('pnpm', installArgs, {
                 cwd: this.projectDir,
                 timeout: 5 * 60 * 1000,
                 env: process.env,
             });
-            // 清理临时 .npmrc
-            try {
-                await fs.unlink(npmrcPath);
-                console.log('[PlayableScriptsAdapter] 已清理临时 .npmrc');
-            }
-            catch {
-                // 忽略删除错误
-            }
-            // 安装完成后，尝试通过 require.resolve 查找 devkit 路径
-            try {
-                const devkitPath = require.resolve('@playcraft/devkit/package.json', {
-                    paths: [this.projectDir],
-                });
-                const devkitDir = path.dirname(devkitPath);
-                // 尝试常见的 CLI 路径
-                const possiblePaths = [
-                    path.join(devkitDir, 'cli', 'bin', 'playable-scripts.js'),
-                    path.join(devkitDir, 'dist', 'cli.js'),
-                    path.join(devkitDir, 'bin', 'playable-scripts.js'),
-                ];
-                for (const binPath of possiblePaths) {
-                    try {
-                        await fs.access(binPath);
-                        console.log(`[PlayableScriptsAdapter] 安装后找到 playable-scripts: ${binPath}`);
-                        return binPath;
-                    }
-                    catch {
-                        // 继续尝试下一个
+        }
+        catch (error) {
+            // 不立即放弃：新版 pnpm 即使 install 实际成功，也可能因 ERR_PNPM_IGNORED_BUILDS
+            // 等告警退出非零；devkit 本身不需要 native build，只要 node_modules 里能定位到
+            // CLI 入口，构建即可继续。先记下错误，后面 verify 再决定是否真正失败。
+            installError = error;
+            console.log(`[PlayableScriptsAdapter] ⚠️ pnpm install 退出非零，将再次校验 node_modules 实际状态: ${error.message}`);
+        }
+        // 清理临时 .npmrc
+        try {
+            await fs.unlink(npmrcPath);
+            console.log('[PlayableScriptsAdapter] 已清理临时 .npmrc');
+        }
+        catch {
+            // 忽略删除错误
+        }
+        // 安装后无论 pnpm 是否报错，都尝试在 node_modules 中定位 devkit CLI
+        // 1) 通过 require.resolve 找到 devkit 包目录
+        try {
+            const devkitPath = require.resolve('@playcraft/devkit/package.json', {
+                paths: [this.projectDir],
+            });
+            const devkitDir = path.dirname(devkitPath);
+            // 尝试常见的 CLI 路径
+            const possiblePaths = [
+                path.join(devkitDir, 'cli', 'bin', 'playable-scripts.js'),
+                path.join(devkitDir, 'dist', 'cli.js'),
+                path.join(devkitDir, 'bin', 'playable-scripts.js'),
+            ];
+            for (const binPath of possiblePaths) {
+                try {
+                    await fs.access(binPath);
+                    console.log(`[PlayableScriptsAdapter] 安装后找到 playable-scripts: ${binPath}`);
+                    if (installError) {
+                        console.log('[PlayableScriptsAdapter] ✅ pnpm install 虽然退出非零，但 devkit 已就绪，忽略告警继续构建');
                     }
+                    return binPath;
+                }
+                catch {
+                    // 继续尝试下一个
                 }
-                console.error(`[PlayableScriptsAdapter] ❌ 找到 devkit 但无法定位 CLI: ${devkitDir}`);
-                return null;
             }
-            catch {
-                // 如果 require.resolve 失败，回退到 findLocalPlayableScripts
+            console.error(`[PlayableScriptsAdapter] ❌ 找到 devkit 但无法定位 CLI: ${devkitDir}`);
+        }
+        catch {
+            // require.resolve 失败，回退到 findLocalPlayableScripts
+        }
+        // 2) 回退：直接查 node_modules/.bin/playable-scripts
+        const fallback = await this.findLocalPlayableScripts();
+        if (fallback) {
+            if (installError) {
+                console.log('[PlayableScriptsAdapter] ✅ pnpm install 虽然退出非零，但 .bin 中已存在 playable-scripts，忽略告警继续构建');
             }
-            // 再次尝试查找
-            return await this.findLocalPlayableScripts();
+            return fallback;
         }
-        catch (error) {
-            console.log(`[PlayableScriptsAdapter] ⚠️ npm install 失败: ${error.message}`);
-            return null;
+        // 真的没找到才报错
+        if (installError) {
+            console.log(`[PlayableScriptsAdapter] ⚠️ npm install 失败: ${installError.message}`);
         }
+        return null;
     }
     /**
-     * 检查构建所需 loader 是否存在（babel-loader）
-     * 注意：babel-loader 是必须的，esbuild-loader/esbuild 是 devkit 内部可选依赖
+     * 检查构建所需 loader 是否存在，缺失则尝试在 worker 容器内现场兜底安装。
+     *
+     * 分两类：
+     * 1) required：必须存在（babel-loader）。缺失先尝试 pnpm add 兜底，仍找不到才告警。
+     * 2) optional：devkit 在某些路径（例如 obfuscateLevel >= 4 时走 esbuild minify）
+     *    会 require('esbuild-loader')，但游戏工程模板的 package.json 通常没有显式声明，
+     *    pnpm 严格模式下也不会被提升到顶层 node_modules。这里如果本地确认缺失，
+     *    就以 --save=false 现场补装到 node_modules/，不写回业务方的 package.json，
+     *    避免污染 lockfile。
      */
     async ensureBuildLoaders() {
         const required = ['babel-loader'];
-        const missing = [];
-        for (const name of required) {
-            const modulePath = path.join(this.projectDir, 'node_modules', name);
+        // optional 列表覆盖 @playcraft/devkit 的 webpack.build.js 实际会 require 的全部 loader：
+        //   - esbuild-loader / esbuild：obfuscate-level=4 走 esbuild minify 路径
+        //   - json5-loader：解析 .json5 / 主题数据
+        //   - style-loader / css-loader：处理样式资源
+        // 这些都是业务工程 package.json 里没显式声明的间接依赖，pnpm 默认不会
+        // 提到顶层 node_modules，但实际都已存在于 .pnpm 隔离目录里，可以走
+        // linkFromPnpmStore 毫秒级软链兜底（零网络、不动 lockfile）。
+        const optional = ['esbuild-loader', 'esbuild', 'json5-loader', 'style-loader', 'css-loader'];
+        // ⚠️ 这里的"存在"必须与 webpack 的 enhanced-resolve 行为对齐：
+        // 只看 projectDir/node_modules/{name}/package.json 是否可达。
+        //
+        // 不能用 require.resolve(name, { paths }):
+        //   pnpm 严格模式（默认 isolated）下，间接依赖不会被提到顶层 node_modules，
+        //   但会作为 .pnpm/{pkg}@{ver}/node_modules/{pkg} 存在，require.resolve
+        //   会顺着这条隔离图找到它（true positive 对 Node 来说），
+        //   而 webpack 的 resolve 在 cwd=source 下只看 source/node_modules/{name}，
+        //   会得到 "Can't resolve 'esbuild-loader'"（false negative 对它来说）。
+        // 这种不一致正是当前测试环境构建失败的根因。
+        const checkExists = async (name) => {
+            try {
+                await fs.access(path.join(this.projectDir, 'node_modules', name, 'package.json'));
+                return true;
+            }
+            catch {
+                return false;
+            }
+        };
+        // 优先策略：直接从 .pnpm/<name>@*/node_modules/<name> 软链到顶层。
+        // 命中场景：作为 @playcraft/devkit 的间接依赖，esbuild-loader/esbuild
+        // 已经被 pnpm 下载到 .pnpm 隔离目录，但没提到顶层。
+        // 比 pnpm add 快得多（毫秒级、零网络），并且不动 lockfile。
+        const linkFromPnpmStore = async (name) => {
+            const pnpmDir = path.join(this.projectDir, 'node_modules', '.pnpm');
+            let entries;
             try {
-                await fs.access(modulePath);
+                entries = await fs.readdir(pnpmDir);
             }
             catch {
-                missing.push(name);
+                return false;
+            }
+            // 形如 esbuild-loader@4.4.3_webpack@5.106.2 / esbuild@0.21.5
+            // 注意：name 后面紧跟 '@' 才是同名包，避免 'esbuild' 误匹配 'esbuild-loader'
+            const prefix = `${name}@`;
+            const candidates = entries.filter((e) => e.startsWith(prefix));
+            if (candidates.length === 0)
+                return false;
+            // 多个版本时挑最大的（用 numeric collator，避免 0.21.5 误大于 0.10.0 这类字典序坑）
+            candidates.sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
+            const chosen = candidates[candidates.length - 1];
+            const realPkgDir = path.join(pnpmDir, chosen, 'node_modules', name);
+            try {
+                await fs.access(path.join(realPkgDir, 'package.json'));
             }
+            catch {
+                return false;
+            }
+            const linkPath = path.join(this.projectDir, 'node_modules', name);
+            try {
+                // 先清理可能存在的同名残留（损坏的软链等）
+                try {
+                    await fs.rm(linkPath, { recursive: true, force: true });
+                }
+                catch {
+                    // ignore
+                }
+                // 用相对软链，路径更短、镜像迁移友好
+                const rel = path.relative(path.dirname(linkPath), realPkgDir);
+                await fs.symlink(rel, linkPath, 'dir');
+                console.log(`[PlayableScriptsAdapter] 🔗 从 .pnpm 软链 ${name} → ${rel}`);
+                return true;
+            }
+            catch (error) {
+                console.log(`[PlayableScriptsAdapter] ⚠️ 软链 ${name} 失败: ${error.message}`);
+                return false;
+            }
+        };
+        const ensureOne = async (name) => {
+            if (await checkExists(name))
+                return true;
+            if (await linkFromPnpmStore(name)) {
+                return await checkExists(name);
+            }
+            return false;
+        };
+        // 过滤出 ensureOne 之后仍缺失的包；首轮检测和 verify 阶段都复用此 helper。
+        const filterMissing = async (names) => {
+            const missing = [];
+            for (const n of names) {
+                if (!(await ensureOne(n)))
+                    missing.push(n);
+            }
+            return missing;
+        };
+        const missingRequired = await filterMissing(required);
+        const missingOptional = await filterMissing(optional);
+        const toInstall = [...missingRequired, ...missingOptional];
+        if (toInstall.length === 0)
+            return;
+        console.log(`[PlayableScriptsAdapter] 以下构建依赖缺失（.pnpm 也没有），尝试现场兜底安装: ${toInstall.join(', ')}`);
+        // 用 pnpm add -D --save=false 兜底安装：
+        //   - --save=false 不写回 package.json，避免污染业务工程；
+        //   - --config.dangerouslyAllowAllBuilds=true 跳过新版 pnpm 的 ignored-builds 退码（buildPnpmArgs 已带）；
+        //   - 透传 NPM_REGISTRY，与 ensureLocalDevkit 保持一致（走 mirrors.tencent.com）。
+        const installArgs = this.buildPnpmArgs('add', ['-D', '--save=false', ...toInstall]);
+        let addError;
+        try {
+            await this.runCommandWithTimeout('pnpm', installArgs, {
+                cwd: this.projectDir,
+                timeout: 3 * 60 * 1000,
+                env: process.env,
+            });
+        }
+        catch (error) {
+            addError = error;
+            console.log(`[PlayableScriptsAdapter] ⚠️ pnpm add 退出非零，将再次校验是否实际安装成功: ${error.message}`);
         }
-        if (missing.length > 0) {
-            console.log(`[PlayableScriptsAdapter] ⚠️ 以下构建依赖缺失: ${missing.join(', ')}`);
+        // 安装后再 verify 一遍：先 checkExists，未命中再尝试一次软链兜底
+        // （pnpm add 默认也是 isolated，可能依然没提到顶层）
+        const stillMissingRequired = await filterMissing(missingRequired);
+        const stillMissingOptional = await filterMissing(missingOptional);
+        if (stillMissingRequired.length > 0) {
+            console.log(`[PlayableScriptsAdapter] ❌ 必需的构建依赖仍缺失: ${stillMissingRequired.join(', ')}`);
             console.log(`[PlayableScriptsAdapter] 请确保这些依赖已在 package.json 的 devDependencies 中定义`);
         }
+        else if (missingRequired.length > 0) {
+            console.log(`[PlayableScriptsAdapter] ✅ 必需依赖已就绪: ${missingRequired.join(', ')}`);
+        }
+        if (stillMissingOptional.length > 0) {
+            console.log(`[PlayableScriptsAdapter] ⚠️ 可选构建依赖仍缺失: ${stillMissingOptional.join(', ')}（如果 devkit 在当前混淆等级下不需要它们，构建仍可能成功）`);
+        }
+        else if (missingOptional.length > 0) {
+            console.log(`[PlayableScriptsAdapter] ✅ 可选依赖已就绪: ${missingOptional.join(', ')}`);
+        }
+        if (addError && stillMissingRequired.length === 0 && stillMissingOptional.length === 0) {
+            console.log('[PlayableScriptsAdapter] pnpm add 虽然退出非零，但所有依赖已就绪，忽略告警继续构建');
+        }
     }
     /**
      * 确保 package.json 中有 build/builds 脚本

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcraft/build",
-  "version": "0.0.41",
+  "version": "0.0.42",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",