@noob-stupid/dsh-plugin-console 0.5.21 → 0.5.23

package/lib/server/domain/plugin-actions.js

@@ -27,7 +27,7 @@ import { NPM_NAME_RE } from './dep-source.js'
 import { runLockfileRepair } from './lockfile-health.js'
 import { pinProfileDependency, specOf } from './manifest.js'
 import { lockVersion } from './selfupdate.js'
-import { buildPnpmEnv, pnpmAddArgs, runPnpmWithFallback } from '../infra/exec.js'
+import { buildPnpmEnv, pnpmAddArgs, runPnpmWithFallback, unknownPnpmOption } from '../infra/exec.js'
 
 const DEFAULT_REGISTRY = 'https://registry.npmmirror.com'
 /** 动作白名单（客户端只能给这些 kind；执行分支与 argv 全在服务端）。 */
@@ -91,14 +91,18 @@ function isReleaseAgeBlock(message) {
 }
 
 /** 跑一次 pnpm（原样），必要时**只对这一条命令**放宽供应链闸并如实标记。
- *  返回 { ok, exitCode, stdout, stderr, relaxedReleaseAge, error }。 */
+ *  返回 { ok, exitCode, stdout, stderr, relaxedReleaseAge, error }。
+ *
+ *  ★ 2026-09-27 CI 实测踩到（本函数的第一个版本）：这里直接拼 `pnpmAddArgs` 却没有 `runPnpmAdd` 的
+ *    **未知选项降级** —— 而 CI 的 corepack 解析到 pnpm 12，`--fetch-timeout/--fetch-retries` 在 pnpm 12
+ *    上是 `error: unexpected argument`（直接退出），于是"加固"变成了"动作跑不成"（真机 CI 红）。
+ *    现在与 `infra/exec.js#runPnpmAdd` 同一条规矩：认不出这两个选项就去掉加固选项重试一次。 */
 async function runAddWithReleaseAgeRetry({ profileDir, spec, registry, runAdd, timeoutMs = 180000 }) {
-  const argv = pnpmAddArgs(spec, registry)
   const execOpts = { cwd: profileDir, timeout: timeoutMs, windowsHide: true, maxBuffer: 4 * 1024 * 1024, env: buildPnpmEnv(registry) }
-  const attempt = async (args) => {
+  const once = async (args) => {
     try {
       const out = await runAdd(args, { execOpts })
-      return { ok: true, exitCode: 0, stdout: tail(out?.stdout), stderr: tail(out?.stderr), error: null }
+      return { ok: true, exitCode: 0, stdout: tail(out?.stdout), stderr: tail(out?.stderr), error: null, argv: args }
     } catch (error) {
       return {
         ok: false,
@@ -106,14 +110,21 @@ async function runAddWithReleaseAgeRetry({ profileDir, spec, registry, runAdd, t
         stdout: tail(error?.stdout),
         stderr: tail(error?.stderr ?? error?.message ?? String(error)),
         error: error instanceof Error ? error : new Error(String(error)),
+        argv: args,
       }
     }
   }
-  const first = await attempt(argv)
+  const attempt = async (extra) => {
+    const first = await once([...pnpmAddArgs(spec, registry), ...extra])
+    if (first.ok || !unknownPnpmOption(String(first.error?.message ?? ''))) return first
+    // 加固选项不被该版本 pnpm 认识 → 去掉它们重试一次（绝不让加固变成"跑不成"）
+    return once([...pnpmAddArgs(spec, registry, { fetchFlags: false }), ...extra])
+  }
+  const first = await attempt([])
   // 放宽条件**必须同时**成立：第一次真的失败了，且失败原因确定是供应链闸（文案/错误码认得出）
   const blocked = !first.ok && (isReleaseAgeBlock(first.stderr) || isReleaseAgeBlock(String(first.error?.message ?? '')))
   if (!blocked) return { ...first, relaxedReleaseAge: false }
-  const retried = await attempt([...argv, '--config.minimumReleaseAge=0'])
+  const retried = await attempt(['--config.minimumReleaseAge=0'])
   return { ...retried, relaxedReleaseAge: true }
 }
 

package/lib/server/infra/exec.js

@@ -13,13 +13,81 @@ function gitBin() {
   return process.platform === 'win32' ? 'git.exe' : 'git'
 }
 
+/** PATH 条目是不是桌面端运行时的 `<…>\runtime\pnpm\bin` / `<…>\runtime\bin`（两种分隔符都认）。 */
+const RUNTIME_PNPM_BIN_RE = /[\\/]runtime[\\/]pnpm[\\/]bin[\\/]?$/u
+const RUNTIME_BIN_RE = /[\\/]runtime[\\/]bin[\\/]?$/u
+
+/** cmd.exe 的元字符：`^` 是 cmd 自己的转义符（**引号内照样生效** —— 本机实测 `"a^b"` 到程序手里变成 `ab`），
+ *  `& | < > ( )` 在引号内**仍然是 cmd 的操作符**（实测 `"a&b"` 会在 `&` 处断开，把 `b` 当命令执行）。
+ *  所以段内这些字符必须逐个加 `^` 转义。 */
+const CMD_META_RE = /[\^&|<>()]/gu
+
+/** 把一串命令段拼成**一条 cmd.exe 命令字符串**（纯函数，导出给单测）。
+ *
+ * 2026-09-27 改错（桌面端实例"所有 pnpm 操作都跑不了"的两处根因之一）：
+ *   旧代码是 `['corepack','pnpm',...args].map((a) => JSON.stringify(a)).join(' ')` —— JSON.stringify 加的是
+ *   **真引号**，而这一整串又是作为一个 argv 元素交给 Node 的 spawn；Windows 上 Node/libuv 按 MSVCRT 规则
+ *   把参数里的 `"` 转义成 `\"`，cmd 实际收到 `\"corepack\" \"pnpm\"` → `'\"corepack\"' 不是内部或外部命令`。
+ *   本机对着一个只回显参数的 .cmd 实测三种形态：
+ *     · `"a" "b"`   + 默认转义 → 收到 `\"a\" \"b\"` → 失败（旧缺陷）
+ *     · `"a" "b"`   + windowsVerbatimArguments → `/s` 会把首尾两个引号一起剥掉 → 也失败
+ *     · `""a" "b""` + windowsVerbatimArguments → 正确解析成两个参数 ✓（含空格 / `&` / `|` / `>` 的参数
+ *       在段内加 `^` 转义后也原样到达）
+ *   所以本函数产出的是"**内层**命令字符串"（形如 `"corepack" "pnpm" "add" "x"`，**永不含 `\"`**），
+ *   最外层那对引号由 cmdShellArgv 负责加。
+ * 已知边界（如实记，不假装覆盖）：`%VAR%` 与开启延迟展开时的 `!VAR!` 是 cmd 自己的展开，
+ *   **任何引号/`^` 都挡不住**；我们生成的 argv（包名、registry、布尔选项、绝对路径）不含这两个字符，
+ *   真出现时该通道会失败并如实报错（不会静默跑成别的命令）。 */
+function cmdCommandLine(parts) {
+  return parts
+    .map((part) => `"${String(part).replace(CMD_META_RE, (ch) => `^${ch}`)}"`)
+    .join(' ')
+}
+
+/** corepack 形态的命令字符串（纯函数，导出给单测断言"不含 `\"` 转义"）。 */
+function cmdCorepackCommand(args) {
+  return cmdCommandLine(['corepack', 'pnpm', ...args])
+}
+
+/** 交给 cmd.exe 的完整 argv（`/d /s /c` + **整条再包一层引号**的内层命令字符串）。
+ *  必须与 `verbatim: true`（windowsVerbatimArguments）配套：Node 不再做任何引号转义，
+ *  cmd 的 `/s` 剥掉最外层那一对，剩下的正好是我们要的命令行。 */
+function cmdShellArgv(commandLine) {
+  return ['/d', '/s', '/c', `"${commandLine}"`]
+}
+
 /** pnpm 执行方式定位（跨平台，纯函数便于单测 → 按优先级返回列表，逐个尝试）。
  * 事故（2026-09-20，同一位用户，node v24 + Linux）：只按 Windows 布局找 corepack.js
  * （`<node bin>/node_modules/corepack/dist/corepack.js`），而 Linux 的 npm 全局布局在
  * `<prefix>/lib/node_modules/corepack/...` → AI 赋能的 install-npm 生成
  * `node /usr/local/bin/node_modules/corepack/dist/corepack.js pnpm add …` →
- * `Error: Cannot find module …`（MODULE_NOT_FOUND）。这里把三种布局 + PATH 兜底都列出来。 */
-function resolvePnpmRunners({ platform = process.platform, execPath = process.execPath, comspec = process.env.ComSpec ?? 'cmd.exe', exists = existsSync } = {}) {
+ * `Error: Cannot find module …`（MODULE_NOT_FOUND）。这里把三种布局 + PATH 兜底都列出来。
+ *
+ * 事故（2026-09-27，官方桌面端实例：**所有** pnpm 操作都跑不了）—— 本次两处修：
+ *   ① 形态缺陷（先于本轮存在）：cmd-corepack 分支原来把 argv 数组交给 cmd.exe，Node 在 Windows 上
+ *      按 MSVCRT 规则把段内引号转义成 `\"` → cmd 收到 `\"corepack\" \"pnpm\"` → 一条都跑不起来。
+ *      修法与实测证据见 cmdCommandLine / cmdShellArgv。
+ *   ② 认不出桌面端自带运行时（加法）：桌面端 host 自己就是用
+ *      `command: process.execPath`（Electron 二进制）+ `args: ['--expose-internals', <resources>\runtime\pnpm\bin\pnpm.mjs]`
+ *      + `env.ELECTRON_RUN_AS_NODE=1` 跑 pnpm 的（dsh-desktop-host 的 packageManager），
+ *      而我们的候选只有"node 旁边的三种 corepack.js 布局 + cmd corepack + PATH 上的 pnpm" ——
+ *      桌面端的 host 二进制旁边没有 corepack.js，PATH 里也只有 `runtime\bin`（没有 pnpm.cmd），
+ *      于是三条候选全落空。现在把桌面端运行时（resourcesPath ① / PATH+env 线索 ③ / PATH 扫描 ②）
+ *      作为**新候选插在 node-corepack 之后、cmd-corepack 之前**：既有候选与顺序一个都没动。
+ * 兜底语义保持不变：只有"执行方式本身不可用"（ENOENT / Cannot find module）才换下一个，
+ * 真正的失败立即抛出（见 runPnpmWithFallback）。
+ * 全部候选都走注入的 `exists`；`env/resourcesPath/delimiter/nodeBin` 四个注入点只为离线单测，
+ * 生产调用方一个字都不用改（默认值就是当前进程的事实）。 */
+function resolvePnpmRunners({
+  platform = process.platform,
+  execPath = process.execPath,
+  comspec = process.env.ComSpec ?? 'cmd.exe',
+  exists = existsSync,
+  env = process.env,
+  resourcesPath = process.resourcesPath,
+  delimiter = platform === 'win32' ? ';' : ':',
+  nodeBin = 'node',
+} = {}) {
   const binDir = dirname(execPath)
   const corepackCandidates = [
     join(binDir, 'node_modules', 'corepack', 'dist', 'corepack.js'), // Windows 官方安装器 / nvm-windows
@@ -27,17 +95,63 @@ function resolvePnpmRunners({ platform = process.platform, execPath = process.ex
     join(binDir, '..', 'libexec', 'lib', 'node_modules', 'corepack', 'dist', 'corepack.js'), // brew / 自编译布局
   ]
   const runners = []
+  const add = (runner) => {
+    if (runners.some((r) => r.note === runner.note)) return // 同一路径可能被多条线索命中（resourcesPath + PATH）
+    runners.push(runner)
+  }
   for (const js of corepackCandidates) {
     if (exists(js)) {
       runners.push({ kind: 'node-corepack', note: `node ${js} pnpm`, run: (args) => ({ bin: execPath, argv: [js, 'pnpm', ...args] }) })
     }
   }
+
+  // ── 新候选 ①/③：桌面端（Electron）自带运行时 ──────────────────────────────────
+  // ① Electron 的 `process.resourcesPath`（桌面端 = `<安装目录>\resources`）；
+  // ③ 环境线索：PATH 条目里的 `<…>\runtime\pnpm\bin` 与 `<…>\runtime\bin`（桌面端 host 就是把
+  //    `resources\runtime\bin` 拼进 profile 的 PATH 的，其同级就是 `runtime\pnpm\bin\pnpm.mjs`）。
+  const desktopNode = typeof env?.DSH_DESKTOP_NODE_EXECUTABLE === 'string' && env.DSH_DESKTOP_NODE_EXECUTABLE !== ''
+    ? env.DSH_DESKTOP_NODE_EXECUTABLE
+    : execPath
+  const runtimeMjs = []
+  if (typeof resourcesPath === 'string' && resourcesPath !== '') runtimeMjs.push(join(resourcesPath, 'runtime', 'pnpm', 'bin', 'pnpm.mjs'))
+  const pathValue = typeof env?.PATH === 'string' && env.PATH !== '' ? env.PATH : (typeof env?.Path === 'string' ? env.Path : '')
+  const pathDirs = String(pathValue).split(delimiter).map((d) => d.trim()).filter((d) => d !== '')
+  for (const dir of pathDirs) {
+    if (RUNTIME_PNPM_BIN_RE.test(dir)) runtimeMjs.push(join(dir, 'pnpm.mjs'))
+    else if (RUNTIME_BIN_RE.test(dir)) runtimeMjs.push(join(dirname(dir), 'pnpm', 'bin', 'pnpm.mjs'))
+  }
+  for (const js of runtimeMjs) {
+    if (!exists(js)) continue
+    add({
+      kind: 'desktop-pnpm-mjs',
+      note: `${desktopNode} --expose-internals ${js} pnpm`,
+      // 照抄桌面端 host 的形态（command=execPath，args=['--expose-internals', <pnpm.mjs>]）。
+      // ELECTRON_RUN_AS_NODE 必须显式带上：不带它，Electron 二进制会当 **GUI 应用**启动 ——
+      // 等于弹一个新窗口，而且退出码可能是 0（"假成功"，比失败更糟）。
+      run: (args) => ({ bin: desktopNode, argv: ['--expose-internals', js, ...args], env: { ELECTRON_RUN_AS_NODE: '1' } }),
+    })
+  }
+
+  // ── 新候选 ②：PATH 扫描（pnpm.cmd(win) / pnpm(posix) / <dir>\pnpm\bin\pnpm.mjs）──────
+  for (const dir of pathDirs) {
+    const mjs = join(dir, 'pnpm', 'bin', 'pnpm.mjs')
+    if (exists(mjs)) add({ kind: 'path-pnpm-mjs', note: `${nodeBin} ${mjs} pnpm`, run: (args) => ({ bin: nodeBin, argv: [mjs, ...args] }) })
+    if (platform === 'win32') {
+      // .cmd 批处理不能直接 execFile（本机实测 EINVAL）→ 唯一通路是 cmd.exe（修好的单字符串形态）
+      if (exists(join(dir, 'pnpm.cmd'))) {
+        add({ kind: 'cmd-pnpm', note: `cmd /c pnpm（PATH: ${dir}）`, run: (args) => ({ bin: comspec, argv: cmdShellArgv(cmdCommandLine(['pnpm', ...args])), verbatim: true }) })
+      }
+    } else if (exists(join(dir, 'pnpm'))) {
+      add({ kind: 'path-pnpm', note: join(dir, 'pnpm'), run: (args) => ({ bin: join(dir, 'pnpm'), argv: args }) })
+    }
+  }
+
   if (platform === 'win32') {
-    // .cmd 批处理不能直接 execFile（EINVAL）→ 经 cmd.exe 调用（整条命令作为一个参数）
+    // 修好的形态：单个命令字符串（段内各自加引号 + 转义 cmd 元字符）+ 整条外包裹 + verbatim
     runners.push({
       kind: 'cmd-corepack',
       note: 'cmd /c corepack pnpm',
-      run: (args) => ({ bin: comspec, argv: ['/d', '/s', '/c', ['corepack', 'pnpm', ...args].map((a) => JSON.stringify(a)).join(' ')] }),
+      run: (args) => ({ bin: comspec, argv: cmdShellArgv(cmdCorepackCommand(args)), verbatim: true }),
     })
   } else {
     runners.push({ kind: 'corepack', note: 'corepack pnpm', run: (args) => ({ bin: 'corepack', argv: ['pnpm', ...args] }) })
@@ -73,10 +187,21 @@ async function runPnpmWithFallback(args, { execOpts = {}, runners = resolvePnpmR
     return wrapped
   }
   for (const runner of runners) {
-    const { bin, argv } = runner.run(args)
+    // 执行方式可以带自己的 spawn 附加项（2026-09-27 加法）：
+    //   · `verbatim`：cmd.exe 形态必须原样透传命令行（否则 Node 会把段内引号转义成 `\"`，见 cmdCommandLine）；
+    //   · `env`：桌面端形态必须带 ELECTRON_RUN_AS_NODE=1（否则 Electron 二进制会当 GUI 应用启动）。
+    // 两者都只在 runner 明确给出时生效，既有的 node-corepack / corepack / pnpm 候选一个字不变。
+    const { bin, argv, verbatim = false, env: runnerEnv = null } = runner.run(args)
+    const opts = verbatim || runnerEnv !== null
+      ? {
+        ...execOpts,
+        ...(verbatim ? { windowsVerbatimArguments: true } : {}),
+        ...(runnerEnv === null ? {} : { env: { ...(typeof execOpts.env === 'object' && execOpts.env !== null ? execOpts.env : process.env), ...runnerEnv } }),
+      }
+      : execOpts
     try {
       // eslint-disable-next-line no-await-in-loop
-      await exec(bin, argv, execOpts)
+      await exec(bin, argv, opts)
       return { runner }
     } catch (error) {
       lastError = withStderr(error)
@@ -300,6 +425,9 @@ function execFileWithKillTree(bin, argv, opts = {}, deps = {}) {
         cwd: opts.cwd,
         env: opts.env,
         windowsHide: opts.windowsHide !== false,
+        // 2026-09-27（加法）：cmd.exe 形态要求"命令行原样透传"（见 infra/exec.js#cmdCommandLine）。
+        // 只有 runner 显式标了 verbatim 才会是 true；其余调用点行为完全不变（默认 false）。
+        windowsVerbatimArguments: opts.windowsVerbatimArguments === true,
         detached: platform !== 'win32', // POSIX：自成进程组，-pid 才杀得掉整棵树（platform 可注入，见单测）
       })
     } catch (error) { finish(error, null); return }
@@ -434,4 +562,4 @@ const GH_BIN_CANDIDATES = [
   join(homedir(), 'scoop', 'shims', 'gh.exe'),
 ]
 
-export { GH_BIN_CANDIDATES, gitEnv, gitBin, processAlive, execFileAsync, resolvePnpmRunners, runPnpmWithFallback, killProcessTree, posixDescendants, execFileWithKillTree, KILL_WAIT_MS, KILL_WAIT_POLL_MS, GIT_LOW_SPEED_ENV, pnpmEnvOverrides, buildPnpmEnv, pnpmFetchArgs, pnpmAddArgs, unknownPnpmOption, runPnpmAdd }
+export { GH_BIN_CANDIDATES, gitEnv, gitBin, processAlive, execFileAsync, resolvePnpmRunners, runPnpmWithFallback, killProcessTree, posixDescendants, execFileWithKillTree, KILL_WAIT_MS, KILL_WAIT_POLL_MS, GIT_LOW_SPEED_ENV, pnpmEnvOverrides, buildPnpmEnv, pnpmFetchArgs, pnpmAddArgs, unknownPnpmOption, runPnpmAdd, cmdCommandLine, cmdCorepackCommand, cmdShellArgv }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noob-stupid/dsh-plugin-console",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "description": "DSH 框架升级安全与插件升级门控：一键升级、失败自动回滚、升级后回滚上版、旧插件不适配自动禁用；内置多源插件市场为发现层，插件源全部可自定义，可指向公司内网私有源 / 私有索引 / 本地 Git 仓库，纯内网离线可用 | Framework upgrade safety & plugin version gating for DSH, with a customizable multi-source plugin market: point every source at internal mirrors or a local file:// repo for intranet-only, offline installs.",
   "repository": {
     "type": "git",