@hyzyn/dsh-safe 0.3.1 → 0.3.2

package/README.en.md

@@ -99,7 +99,7 @@ How upgrading works: `dsh-safe update` auto-detects the dsh package name and ins
 - Rows inserted via `--patch` overlay layers are not part of the mapping (only the profile patch, the home patch and bundle patches are scanned).
 - To capture stderr, the wrapper pipes dsh's stderr (content is still echoed to the terminal in real time); stdout/stdin pass through unaffected.
 - Match patterns target the dsh 0.1.x error formats; a major dsh upgrade that changes them requires updating the parser.
-- Windows is best-effort: update / --self / list / restore are adapted (.cmd shim parsing, shelled npm/pnpm invocations), but the wrapped dsh boot's child-process spawn is unverified on Windows.
+- Windows is best-effort: update / --self / list / restore are adapted (.cmd shim parsing, shelled npm/pnpm invocations); the wrapped boot resolves the node entry embedded in dsh's .cmd/.ps1 shim on PATH and spawns `node <entry>` directly (.exe runs as-is, unparseable shims fall back to a shelled spawn), sidestepping Node's ban on spawning .cmd files. Not yet verified end-to-end on a real Windows machine — feedback welcome.
 
 ## Development
 

package/README.md

@@ -99,12 +99,12 @@ Error: dsh: plugin tree failed to load: failed to apply loader entry smoke-broke
 - `--patch` 覆盖层里插入的行不参与对照表（对照表只扫 profile patch、home patch 与 bundle patch）。
 - 为了捕获 stderr，包装器把 dsh 的 stderr 接到管道（内容仍实时回显到终端）；stdout/stdin 直通不受影响。
 - 本项目针对 dsh 0.1.x 的报错格式做匹配；dsh 大版本升级后格式变化时需要同步更新解析器。
-- Windows 为尽力支持：update / --self / list / restore 已适配（.cmd shim 解析、shell 方式调用 npm/pnpm），包装启动 dsh 的子进程方式未在 Windows 验证。
+- Windows 为尽力支持：update / --self / list / restore 已适配（.cmd shim 解析、shell 方式调用 npm/pnpm）；包装启动会把 PATH 上 dsh 的 .cmd/.ps1 shim 解析出内嵌的 node 入口、改为 `node <入口>` 直接启动（.exe 直接运行，shim 解析失败退回 shell 方式），绕开 Node 禁止 spawn .cmd 的限制。尚未在真实 Windows 上端到端验证，欢迎反馈。
 
 ## 开发
 
 ```bash
-npm test        # node:test 单元测试 + 假 dsh 集成测试
+npm test        # node:test 单元测试 + fake dsh 集成测试
 ```
 
 ## License

package/lib/dshpaths.js

@@ -6,7 +6,7 @@
  */
 import { existsSync, readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
-import { resolve, join } from 'node:path'
+import { dirname, resolve, join } from 'node:path'
 
 /** dsh home 目录：`DSH_HOME` 优先，默认 `~/.dsh`。 */
 export function dshHome() {
@@ -79,3 +79,75 @@ export function detectInvocation(args) {
   }
   return { mode: 'boot', profile: profile || null }
 }
+
+/**
+ * 解析把 dsh 跑起来的 spawn 目标（Windows 兼容的关键）。
+ *
+ * 非 Windows 的全局 bin 是 symlink / 带执行位脚本，`spawn('dsh')` 原样可用。
+ * Windows 的全局 bin 是 .cmd/.ps1 批处理：Node 出于安全禁止无 shell 地 spawn
+ * 它们（EINVAL），裸名也不参与 PATHEXT 解析（ENOENT）。因此按 PATH 目录顺序
+ * 找 `dsh.exe` / `dsh.cmd` / `dsh.ps1`：
+ *   - .exe → 直接 spawn；
+ *   - .cmd/.ps1 → 解析 shim 内嵌的 node_modules 入口脚本，改 spawn
+ *     `node <entry>`（无 shell、无参数转义问题，stderr 管道行为与 unix 一致）；
+ *   - shim 里解析不出入口 → 退回 shell 方式运行 shim 本身；
+ *   - PATH 上什么都没有 → 原样返回（报错行为与从前一致）。
+ *
+ * @param {string} command dsh 可执行名（默认 'dsh'）
+ * @param {{
+ *   platform?: string,
+ *   pathEnv?: string,
+ *   execPath?: string,
+ *   exists?: (path: string) => boolean,
+ *   readFile?: (path: string) => string | undefined,
+ * }} [inject] 测试注入
+ * @returns {{ file: string, prefix: string[], shell: boolean }}
+ *          spawn(file, [...prefix, ...args], { shell })
+ */
+export function resolveDshSpawnTarget(command, {
+  platform = process.platform,
+  pathEnv = process.env.PATH ?? '',
+  execPath = process.execPath,
+  exists = existsSync,
+  readFile = (p) => { try { return readFileSync(p, 'utf8') } catch { return undefined } },
+} = {}) {
+  if (platform !== 'win32') return { file: command, prefix: [], shell: false }
+  for (const dir of pathEnv.split(';')) {
+    if (!dir) continue
+    for (const ext of ['.exe', '.cmd', '.ps1']) { // 同目录内按 PATHEXT 惯例 .exe 优先
+      const p = join(dir, command + ext)
+      if (!exists(p)) continue
+      if (ext === '.exe') return { file: p, prefix: [], shell: false }
+      return resolveShimEntry(p, { execPath, exists, readFile })
+    }
+  }
+  return { file: command, prefix: [], shell: false }
+}
+
+/** 从 .cmd/.ps1 shim 解析内嵌入口；失败退回 shell 方式运行 shim（路径含空白时加引号）。 */
+function resolveShimEntry(shimPath, { execPath, exists, readFile }) {
+  const content = readFile(shimPath)
+  const entry = content ? findShimEntry(content, dirname(shimPath), exists) : null
+  if (entry) return { file: execPath, prefix: [entry], shell: false }
+  return { file: /\s/.test(shimPath) ? `"${shimPath}"` : shimPath, prefix: [], shell: true }
+}
+
+/**
+ * npm/pnpm 的 cmd/ps1 shim 内容里都内嵌 node_modules 下的入口脚本路径：
+ * cmd 形如 `"%~dp0\node_modules\@scope\pkg\bin\x.js"`（也可能先 SET 进变量再
+ * `node "%_prog%" %*`），ps1 形如 `$basedir/node_modules/...`。%~dp0 与
+ * $basedir 都展开为 shim 所在目录；取第一个真实存在的候选。
+ */
+function findShimEntry(content, shimDir, exists) {
+  const candidates = []
+  for (const m of content.matchAll(/"([^"\r\n]*node_modules[^"\r\n]*\.(?:js|cjs|mjs))"/gi)) candidates.push(m[1])
+  for (const m of content.matchAll(/[\w@.$%~\-\\\/]*node_modules[\w@.$%~\-\\\/]*\.(?:js|cjs|mjs)/gi)) candidates.push(m[0])
+  for (let raw of candidates) {
+    // `SET "_prog=%~dp0\..."` 会把变量名一起捕进来，切掉 `node_modules` 之前的 `xxx=`
+    const eq = raw.indexOf('=')
+    if (eq >= 0 && eq < raw.toLowerCase().indexOf('node_modules')) raw = raw.slice(eq + 1)
+    const p = resolve(raw.replace(/%~dp0|\$basedir/gi, `${shimDir}/`).replace(/\\/g, '/'))
+    if (exists(p)) return p
+  }
+  return null
+}

package/lib/wrap.js

@@ -6,11 +6,14 @@
  *   - 失败退出 → 从 stderr 解析坏插件，对照 patch 行后把对应行置为 disabled
  *     （写入托管区块 + 台账），然后重试；识别不出、超过重试上限、或命中
  *     第一方插件（@deepseek-ai/*，默认保护）时原样透传退出码。
+ *
+ * Windows 上经 resolveDshSpawnTarget 把 dsh 的 .cmd shim 解析成 `node <入口>`
+ * 再启动（见 dshpaths.js），其余平台原样 spawn。
  */
 import { spawn } from 'node:child_process'
 import { summarizeLine, parseFailureReport } from './failures.js'
 import { collectKnownRows, matchFailures } from './knownrows.js'
-import { detectInvocation } from './dshpaths.js'
+import { detectInvocation, resolveDshSpawnTarget } from './dshpaths.js'
 import { writeQuarantine } from './quarantine.js'
 import { t } from './i18n.js'
 
@@ -19,12 +22,17 @@ const FIRST_PARTY_PREFIX = '@deepseek-ai/'
 
 const isFirstParty = (name) => typeof name === 'string' && name.startsWith(FIRST_PARTY_PREFIX)
 
+/** shell 方式兜底时给含空白的参数补引号（正常路径不走 shell，不受影响）。 */
+const quoteShellArg = (a) => (/\s/.test(a) && !/^".*"$/.test(a) ? `"${a}"` : a)
+
 /** 运行 dsh：stdin/stdout 直通，stderr 回显并捕获（上限内）。 */
 export function spawnDsh(args, { command = 'dsh' } = {}) {
+  const target = resolveDshSpawnTarget(command)
   return new Promise((resolve) => {
-    const child = spawn(command, args, {
+    const child = spawn(target.file, [...target.prefix, ...(target.shell ? args.map(quoteShellArg) : args)], {
       stdio: ['inherit', 'inherit', 'pipe'],
       env: process.env,
+      shell: target.shell,
     })
     let captured = ''
     child.stderr?.on('data', (chunk) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyzyn/dsh-safe",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "dsh 启动保险丝：社区插件不兼容导致 dsh 启动失败时，自动禁用坏插件并重试",
   "type": "module",
   "license": "MIT",