refactor(scripts): 统一 pnpm 命令调用方式

提取 pnpm 命令解析逻辑至共享模块，消除各脚本中重复的平台检测代码。qa.mjs、qa-turbo.mjs 和 qa-benchmark.mjs 现在都通过 buildPnpmCommand 函数获取安全的跨平台调用方式，提高了代码的可维护性和一致性。

Author: mudssky

scripts/pnpm-command.mjs

@@ -0,0 +1,54 @@
+/**
+ * 解析当前环境下最稳妥的 pnpm 启动方式。
+ * npm_execpath 既可能指向 pnpm 的 JS 入口，也可能指向 Windows 的可执行包装器；
+ * 这里统一返回可直接交给 spawnSync 的命令与前置参数，避免调用方重复判断平台细节。
+ *
+ * @returns {{ command: string, argsPrefix: string[] }}
+ */
+export function resolvePnpmRunner() {
+  const pnpmExecPath =
+    typeof process.env.npm_execpath === 'string' ? process.env.npm_execpath : null
+  const pnpmExecPathLower = pnpmExecPath?.toLowerCase() ?? ''
+  const pnpmExecPathLooksLikePnpm = pnpmExecPathLower.includes('pnpm')
+  const pnpmExecPathUsesNodeRuntime = /\.(?:cjs|mjs|js)$/i.test(
+    pnpmExecPath ?? '',
+  )
+  const pnpmExecPathIsDirectlyExecutable = /\.(?:exe|cmd|bat)$/i.test(
+    pnpmExecPath ?? '',
+  )
+
+  if (pnpmExecPathLooksLikePnpm && pnpmExecPathUsesNodeRuntime) {
+    return {
+      command: process.execPath,
+      argsPrefix: [pnpmExecPath],
+    }
+  }
+
+  if (pnpmExecPathLooksLikePnpm && pnpmExecPathIsDirectlyExecutable) {
+    return {
+      command: pnpmExecPath,
+      argsPrefix: [],
+    }
+  }
+
+  return {
+    command: process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm',
+    argsPrefix: [],
+  }
+}
+
+/**
+ * 构造一条可直接传给 spawnSync 的 pnpm 命令。
+ * 调用方只需要关注业务参数，平台相关的执行细节由共享工具统一吸收。
+ *
+ * @param {string[]} pnpmArgs pnpm 原始参数
+ * @returns {{ command: string, args: string[] }}
+ */
+export function buildPnpmCommand(pnpmArgs) {
+  const runner = resolvePnpmRunner()
+
+  return {
+    command: runner.command,
+    args: [...runner.argsPrefix, ...pnpmArgs],
+  }
+}

scripts/qa-benchmark.mjs

@@ -3,6 +3,7 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import { spawnSync } from 'node:child_process'
+import { buildPnpmCommand } from './pnpm-command.mjs'
 
 const args = process.argv.slice(2)
 const outputDirArgIndex = args.findIndex((arg) => arg === '--output-dir')
@@ -66,9 +67,14 @@ function stripAnsi(input) {
 
 function runScenario(scenario) {
   const [command, commandArgs] = scenario.command
+  // 报告里保留逻辑命令名便于横向比较，真正执行时再解析为平台安全的 pnpm 调用方式。
+  const resolvedCommand =
+    command === 'pnpm'
+      ? buildPnpmCommand(commandArgs)
+      : { command, args: commandArgs }
 
   const start = process.hrtime.bigint()
-  const result = spawnSync(command, commandArgs, {
+  const result = spawnSync(resolvedCommand.command, resolvedCommand.args, {
     cwd,
     env: baseEnv,
     encoding: 'utf8',

scripts/qa-turbo.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import { spawnSync } from 'node:child_process'
+import { buildPnpmCommand } from './pnpm-command.mjs'
 
 // Turbo 版 QA 编排器。
 // 这个入口把 workspace QA 拆成可缓存、可并行的任务链，优先服务速度和 affected 场景；
@@ -214,11 +215,14 @@ function hasPathChanges(pathspecs, sinceRef, ignorePatterns = []) {
 function resolveTurboRunner() {
   // 优先走 `pnpm exec turbo`，确保使用工作区锁定的版本；
   // 若外部环境已安装 turbo，则允许回退到全局命令，降低本地接入门槛。
+  // 这里复用共享 pnpm 解析逻辑，避免 Windows 下把 pnpm 可执行文件交给错误的启动器。
+  const pnpmTurboCommand = buildPnpmCommand(['exec', 'turbo'])
+  const pnpmTurboVersionCommand = buildPnpmCommand(['exec', 'turbo', '--version'])
   const candidates = [
     {
-      command: 'pnpm',
-      args: ['exec', 'turbo'],
-      versionArgs: ['exec', 'turbo', '--version'],
+      command: pnpmTurboCommand.command,
+      args: pnpmTurboCommand.args,
+      versionArgs: pnpmTurboVersionCommand.args,
     },
     { command: 'turbo', args: [], versionArgs: ['--version'] },
   ]
@@ -242,10 +246,11 @@ function runWorkspaceQa(modeValue, sinceRef) {
   const turboRunner = resolveTurboRunner()
 
   if (!turboRunner) {
+    const pnpmTurboVersionCommand = buildPnpmCommand(['exec', 'turbo', '--version'])
     throw new CommandFailedError(
       'workspace-turbo-not-found',
-      'pnpm',
-      ['exec', 'turbo', '--version'],
+      pnpmTurboVersionCommand.command,
+      pnpmTurboVersionCommand.args,
       1,
       new Error('turbo command is not available'),
     )
@@ -302,7 +307,8 @@ function runRootPwshQa(modeValue, sinceRef) {
   // 这样可以在享受 workspace 并行收益的同时，避免一次性重构根目录测试编排。
   if (modeValue === 'all') {
     console.log('[turbo:qa] run root qa:pwsh (all)')
-    runCommand('root-qa-pwsh-all', 'pnpm', ['run', 'qa:pwsh'])
+    const pnpmCommand = buildPnpmCommand(['run', 'qa:pwsh'])
+    runCommand('root-qa-pwsh-all', pnpmCommand.command, pnpmCommand.args)
     return
   }
 
@@ -321,7 +327,8 @@ function runRootPwshQa(modeValue, sinceRef) {
   }
 
   console.log('[turbo:qa] run root qa:pwsh (changed)')
-  runCommand('root-qa-pwsh-changed', 'pnpm', ['run', 'qa:pwsh'])
+  const pnpmCommand = buildPnpmCommand(['run', 'qa:pwsh'])
+  runCommand('root-qa-pwsh-changed', pnpmCommand.command, pnpmCommand.args)
 }
 
 const sinceRef = mode === 'changed' ? resolveSinceRef() : null

scripts/qa.mjs

@@ -2,6 +2,7 @@
 
 import { spawnSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
+import { buildPnpmCommand } from './pnpm-command.mjs'
 
 // 传统版 QA 编排器。
 // 这个入口复用各 workspace 包自身定义的 `qa` 脚本，不依赖 Turbo 任务图；
@@ -20,10 +21,6 @@ class CommandFailedError extends Error {
   }
 }
 
-const pnpmExecPath = process.env.npm_execpath
-const runPnpmWithNode =
-  typeof pnpmExecPath === 'string' && pnpmExecPath.toLowerCase().includes('pnpm')
-
 const args = process.argv.slice(2)
 let mode = 'changed'
 let verbose = false
@@ -105,13 +102,8 @@ function runCommand(step, command, args, options = {}) {
 }
 
 function runPnpm(step, pnpmArgs, options = {}) {
-  if (runPnpmWithNode) {
-    runCommand(step, process.execPath, [pnpmExecPath, ...pnpmArgs], options)
-    return
-  }
-
-  const command = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm'
-  runCommand(step, command, pnpmArgs, options)
+  const pnpmCommand = buildPnpmCommand(pnpmArgs)
+  runCommand(step, pnpmCommand.command, pnpmCommand.args, options)
 }
 
 function runCapture(command, args) {