@hyzyn/dsh-tty 0.30.0 → 0.32.0

package/scripts/pty-kill-repro-plugin.mjs

@@ -0,0 +1,72 @@
+/**
+ * D100 的最小复现（**插件层**）：把 W1–W5 的形状（经插件 + WS 的 spawn → 输入回显 → kill →
+ * 关连接）在一只进程里循环 N 次，**不带** W6/W7（agent 工具与只读保留）与 W8（第二个 app + PowerShell）。
+ *
+ * 它回答的是「触发点在插件这一层，还是要更后面的档」：D100 定位时用它在**没有任何 W8 代码**的
+ * 树上崩了 2/168 个会话（≈1.2%/会话），从而把「与 W8 相关」这条排除掉——W8 只是**加多了掷骰子
+ * 的次数**（每多一条会话就多一次 kill），不是成因。
+ *
+ * 跑法（真机 / Windows VM，用 `lib/` 的构建产物）：
+ *   node -r ./scripts/pty-kill-probe.cjs ./scripts/pty-kill-repro-plugin.mjs 150
+ * 装上 D100 闸门之后：150 个会话一轮跑满、探针里 150 次 `NATIVE-KILL`、**0 次双重 kill**。
+ *
+ * 进度用 `writeSync` 直写 fd（原生崩溃会丢掉异步写队列里的行，见 D62）。
+ */
+import { writeSync } from 'node:fs'
+import { Context } from '@deepseek-ai/cordis'
+import WebServerRuntime from '@deepseek-ai/dsh-host-webserver'
+import { LocalSubprocessRuntime } from '@deepseek-ai/dsh-subprocess-local'
+import WebSocket from 'ws'
+import { name, inject, apply } from '../lib/index.js'
+
+const loops = Number(process.argv[2] ?? 12)
+const say = (s) => { try { writeSync(1, s + '\n') } catch { /* fd 没了 */ } }
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+// 同 pty-kill-repro.mjs：只在 Windows 上有意义（默认 shell 是 %COMSPEC%，打的是 ConPTY 的终止路径）。
+if (process.platform !== 'win32') {
+  say(`# 这份复现只在 Windows 上有意义（当前 ${process.platform}）：它打的是 ConPTY 的原生终止路径`)
+  process.exit(0)
+}
+
+const app = new Context()
+app.plugin(WebServerRuntime, { host: '127.0.0.1', port: 0 })
+app.plugin(LocalSubprocessRuntime)
+app.plugin({
+  name: 'repro-stub',
+  apply: (ctx) => {
+    ctx.provide('settings', { describe: () => [], update: async () => {}, configure: () => () => {} })
+    ctx.provide('tools', { register: () => () => {} })
+  },
+})
+await app.plugin({ name, inject, apply }, { maxSessions: 4, term: 'xterm-256color', colorTerm: 'truecolor' }).await?.()
+await sleep(400)
+const port = app.webServer.port
+say(`# loops=${loops} port=${port}`)
+
+for (let i = 1; i <= loops; i += 1) {
+  say(`[${i}] connect`)
+  const ws = new WebSocket(`ws://127.0.0.1:${port}/api/dsh-tty/ws`)
+  let ready = false
+  let exited = false
+  ws.on('message', (raw) => {
+    const m = JSON.parse(raw.toString())
+    if (m.t === 'ready') ready = true
+    if (m.t === 'exit') exited = true
+  })
+  await new Promise((r) => ws.once('open', r))
+  ws.send(JSON.stringify({ t: 'spawn', cols: 100, rows: 30 }))
+  let t0 = Date.now()
+  while (!ready && Date.now() - t0 < 20000) await sleep(50)
+  say(`[${i}] ready=${String(ready)}`)
+  ws.send(JSON.stringify({ t: 'input', d: 'echo x\r\n' }))
+  await sleep(200)
+  ws.send(JSON.stringify({ t: 'kill' }))
+  t0 = Date.now()
+  while (!exited && Date.now() - t0 < 15000) await sleep(50)
+  say(`[${i}] exited=${String(exited)}`)
+  try { ws.close() } catch { /* 已关 */ }
+  await sleep(150)
+}
+say(`# 全部 ${loops} 轮跑完（没崩）`)
+process.exit(0)

package/scripts/pty-kill-repro.mjs

@@ -0,0 +1,101 @@
+/**
+ * D100 的最小复现（**裸层**）：只做 `spawnTerminal` + 一层或多层终止，不跑 smoke 其余部分。
+ *
+ * 用途有两个：
+ *   1. 隔离变量——「单次 kill 无害、双重 kill 致命」这句话是拿它跑出来的 A/B（各 150 轮）：
+ *        无闸门      `node -r ./scripts/pty-kill-probe.cjs ./scripts/pty-kill-repro.mjs kill+terminate 150`
+ *        一次性闸门  `PTY_PROBE_GATE=1 node -r ./scripts/pty-kill-probe.cjs ./scripts/pty-kill-repro.mjs kill+terminate 150`
+ *        单次对照    `node -r ./scripts/pty-kill-probe.cjs ./scripts/pty-kill-repro.mjs terminate 150`
+ *      真机（Win11 ARM64）实测：无闸门 188 次原生 kill / 94 次双重 → 第 75 轮崩
+ *      （退出码 -1073740940 = `0xC0000374`）；装了闸门 150/150 每 pty 恰好 1 次、跑满不崩。
+ *   2. 复现**插件实际用的那条顺序**：`kill+terminate` 才是本包 `killSessionNow` 的顺序
+ *      （先 D48 的预杀、后 DSH 的 `terminate()`）；反过来（`terminate+kill`）也留着做对照。
+ *
+ * `kill+terminate` 为什么会双重（D100 的正文）：DSH 的 `stopShellWindows()` 在
+ * `rootIdentity === undefined` 时**也**调 `terminal.kill()`，而 Windows 上 rootIdentity 恒为
+ * undefined（`pid` 要等 conout 连接才有值，DSH 构造 handler 时取到 0）⇒ 两个调用方叠加。
+ * 想看这条证据就跑上面的第一行：探针会打出两行 `NATIVE-KILL id=N`。
+ *
+ * 进度用 `writeSync` 直写 fd（原生崩溃会丢掉异步写队列里的行，见 D62）。
+ *
+ * 用法（在包根）：node ./scripts/pty-kill-repro.mjs <mode> <iterations>
+ *   mode: spawn-only | terminate | nodepty-kill | terminate+kill | kill+terminate
+ *       | kill+kill | terminate+terminate | write+<上面任意终止组合>
+ *   例：write+kill+terminate（最接近插件真实路径：先写输入，再预杀，再 terminate）
+ */
+import { writeSync } from 'node:fs'
+import { Context } from '@deepseek-ai/cordis'
+import { LocalSubprocessRuntime } from '@deepseek-ai/dsh-subprocess-local'
+
+const mode = process.argv[2] ?? 'kill+terminate'
+const iterations = Number(process.argv[3] ?? 15)
+const say = (s) => { try { writeSync(1, s + '\n') } catch { /* fd 没了 */ } }
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+// 这份复现针对的是 Windows 的 ConPTY 终止路径：非 win32 上既没有 `cmd.exe` 也没有那条原生
+// `PtyKill`，跑起来只会得到「命令不存在」——直接说清楚，别让人以为复现失败。
+if (process.platform !== 'win32') {
+  say(`# 这份复现只在 Windows 上有意义（当前 ${process.platform}）：它打的是 ConPTY 的原生终止路径`)
+  process.exit(0)
+}
+
+const ALLOWED = new Set([
+  'spawn-only', 'terminate', 'nodepty-kill', 'terminate+kill', 'kill+terminate',
+  'kill+kill', 'terminate+terminate',
+  'write+kill', 'write+terminate', 'write+kill+terminate', 'write+terminate+kill',
+])
+if (!ALLOWED.has(mode)) {
+  say(`# 未知 mode=${mode}；可选：${[...ALLOWED].join(' | ')}`)
+  process.exit(2)
+}
+const steps = mode.split('+')
+const doWrite = steps[0] === 'write'
+const kills = doWrite ? steps.slice(1) : steps
+
+say(`# mode=${mode} iterations=${iterations} node=${process.version} kills=[${kills.join(',')}]`)
+const app = new Context()
+const fiber = app.plugin(LocalSubprocessRuntime)
+await fiber.await()
+const subprocess = app.get('subprocess')
+if (subprocess === undefined) { say('# subprocess 服务缺失!'); process.exit(2) }
+
+/** 走一层终止：`terminate` = DSH 的 handle.terminate()（closeOnce）；其余 = node-pty 的 kill。 */
+const callKill = (handle, kind) => {
+  if (kind === 'terminate') {
+    return handle.terminate().then(
+      () => { say('      terminate() 返回') },
+      (e) => { say(`      terminate() 抛: ${e?.message ?? e}`) },
+    )
+  }
+  const kill = handle.terminal?.kill
+  if (typeof kill !== 'function') { say('      terminal.kill 不存在'); return Promise.resolve() }
+  try {
+    kill.call(handle.terminal)
+    say('      kill() 返回')
+  } catch (e) {
+    say(`      kill() 抛: ${e?.message ?? e}`)
+  }
+  return Promise.resolve()
+}
+
+for (let i = 1; i <= iterations; i += 1) {
+  say(`[${i}] before-spawn`)
+  const handle = await subprocess.spawnTerminal({
+    argv: ['cmd.exe'], rows: 30, cols: 100, cwd: process.cwd(), env: { ...process.env }, graceMs: 5000,
+  })
+  // Windows 上当轮拿到的 pid 就是 0（D100 的另一半证据：node-pty 的 pid 要等 conout 连接才有值）
+  say(`[${i}] spawned pid=${handle.pid} (${new Date().toISOString()})`)
+  if (doWrite) { await handle.write('echo x\r\n'); await sleep(150); say(`[${i}] wrote`) }
+  for (const kind of kills) {
+    say(`[${i}] -> ${kind}`)
+    await callKill(handle, kind)
+    await sleep(kind === 'terminate' ? 0 : 50)
+  }
+  await Promise.race([
+    handle.done.then((d) => say(`[${i}] done ${JSON.stringify(d)}`)),
+    sleep(4000).then(() => say(`[${i}] done 超时（不等待）`)),
+  ]).catch(() => {})
+  await sleep(60)
+}
+say(`# 全部 ${iterations} 轮跑完（没崩） mode=${mode}`)
+process.exit(0)

package/scripts/windows-smoke.mjs

@@ -15,6 +15,7 @@
  * 用法：pnpm --filter @hyzyn/dsh-tty windows-smoke
  * 退出码：0 = 全部 PASS 或跳过，1 = 任一 FAIL。
  */
+import { existsSync } from 'node:fs'
 import { Context } from '@deepseek-ai/cordis'
 import WebServerRuntime from '@deepseek-ai/dsh-host-webserver'
 import { LocalSubprocessRuntime } from '@deepseek-ai/dsh-subprocess-local'
@@ -85,6 +86,8 @@ process.on('exit', (code) => {
 const RESULTS = []
 function pass(label) { RESULTS.push(['PASS', label]); console.log('  ✔ PASS  ' + label) }
 function fail(label, detail) { RESULTS.push(['FAIL', label, detail]); console.error('  ✘ FAIL  ' + label + (detail ? ' — ' + detail : '')) }
+/** SKIP 单列一档：**不许混进 PASS 计数**，否则「跳过」会伪装成 12/12（W8 在本机没有 PowerShell 时走这条）。 */
+function skip(label) { RESULTS.push(['SKIP', label]); console.log('  ⏭  SKIP  ' + label) }
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
 
 /** 简易 ws 会话客户端（与 integration.mjs 同形，只保留本脚本要用的部分）。 */
@@ -142,6 +145,22 @@ const ENTER = '\r\n'
  */
 const TOOLS = new Map()
 
+/** 本机可用的 PowerShell（优先 PowerShell 7，再 Windows PowerShell 5.1）；都没有则 null（W8 跳过）。 */
+function resolvePowerShell() {
+  const candidates = [
+    'C:/Program Files/PowerShell/7/pwsh.exe',
+    'C:/Windows/System32/WindowsPowerShell/v1.0/powershell.exe',
+  ]
+  for (const candidate of candidates) {
+    try {
+      if (existsSync(candidate)) return candidate
+    } catch {
+      /* 权限等异常一律当「没有」 */
+    }
+  }
+  return null
+}
+
 async function run() {
   const app = new Context()
   const wsFiber = app.plugin(WebServerRuntime, { host: '127.0.0.1', port: 0 })
@@ -341,6 +360,77 @@ async function run() {
     }
   }
   tracer.leave('W7 退出后的只读保留')
+
+  // W8：PowerShell 家族的 shell 集成（OSC 133/7）必须真的从 ConPTY 里穿出来
+  //
+  // 为什么在这一档而不只在单测里：单测只能断言「spawn 计划长什么样」，而这条链路真正
+  // 容易断的地方在 ConPTY —— 标记是 conhost **直通转发**的旁路（渲染路径之外），被吞掉
+  // 或晚到只有真机才看得出。另起一个 app 实例是为了改 shell 配置：W1–W7 必须保持真实的
+  // `%COMSPEC%` 链路（它们钉的正是「没有 POSIX 包装层、跑的就是 cmd.exe」）。
+  //
+  // **不再按 CI 跳过**（2026-10-13）：2026-10-12 那版「CI 上默认跳过 W8」是**绕开**当时未定性的
+  // `0xC0000374`，而根因已经定位并修好（同一个 PTY 被两个调用方各原生 kill 一次 → 见
+  // packages/tty/DEFECTS.md 的 D100 / ROADMAP 的 2026-10-13 一节）。装上闸门后真机（Win11 ARM64）
+  // 强制带 W8 连跑 6 轮全部 `12/12 PASS`。**动这里之前先读那条**：它记着当时的崩点分布与 A/B。
+  console.log('\n[W8] PowerShell + shell 集成（OSC 133/7）')
+  tracer.enter('W8 PowerShell 集成')
+  try {
+    const shellPath = resolvePowerShell()
+    if (shellPath === null) {
+      // 本机没有 PowerShell：这是**真跳过**（不是「按设计绕过」），如实进 SKIP 一档——
+      // 分母扣掉它、汇总行点名，不许装成 12/12。
+      skip('W8 PowerShell shell 集成（本机没找到 pwsh.exe / powershell.exe）')
+    } else {
+      const app2 = new Context()
+      const ws2Fiber = app2.plugin(WebServerRuntime, { host: '127.0.0.1', port: 0 })
+      const sub2Fiber = app2.plugin(LocalSubprocessRuntime)
+      const stub2Fiber = app2.plugin({
+        name: 'windows-smoke-stub-2',
+        apply: (ctx) => {
+          ctx.provide('settings', { describe: () => [], update: async () => {}, configure: () => () => {} })
+          ctx.provide('tools', { register: () => () => {} })
+        },
+      })
+      await stub2Fiber.await()
+      const plugin2Fiber = app2.plugin({ name, inject, apply }, { shell: shellPath, term: 'xterm-256color', colorTerm: 'truecolor' })
+      await ws2Fiber.await()
+      await sub2Fiber.await()
+      await plugin2Fiber.await()
+      await sleep(400)
+
+      const s3 = openSession(app2.webServer.port)
+      await s3.open()
+      s3.client.send(JSON.stringify({ t: 'spawn', cols: 100, rows: 30 }))
+      await s3.waitFor(() => s3.state.ready !== null, 25000, 'PowerShell ready')
+      // 桩装好 prompt 就发首个 A 标记：到了 = `-File` 桩真的被载入并生效
+      await s3.waitFor(() => /\]133;A/.test(s3.state.text), 20000, 'PowerShell 首个 A 标记')
+      pass('W8a PowerShell 桩生效（ConPTY 里收到 OSC 133;A）')
+
+      // `$env:OS` 由 PowerShell 展开（回显里只有字面量），与 W2/W3 同一条判据
+      s3.client.send(JSON.stringify({ t: 'input', d: `echo IT_PS_$env:OS${ENTER}` }))
+      await s3.waitFor(
+        () => /IT_PS_Windows_NT/.test(s3.state.text) && /\]133;D;0/.test(s3.state.text),
+        25000,
+        'PowerShell 的 B/D 与命令输出',
+      )
+      pass('W8b PowerShell 发全 B/D（退出码 0），且命令真的被执行')
+
+      s3.client.send(JSON.stringify({ t: 'kill' }))
+      try {
+        await s3.waitFor(() => s3.state.exited !== null, 15000, 'PowerShell exit')
+      } catch {
+        /* 没收到 exit 也不影响上面两条结论 */
+      }
+      try {
+        s3.client.close()
+      } catch {
+        /* 已关闭 */
+      }
+    }
+  } catch (error) {
+    fail('W8 PowerShell shell 集成', error.message)
+  }
+  tracer.leave('W8 PowerShell 集成')
 }
 
 await run()
@@ -348,9 +438,14 @@ await run()
 // **异常终止**用的，断言失败被说成「崩溃」只会误导。
 exitingNormally = true
 const failed = RESULTS.filter((row) => row[0] === 'FAIL')
-console.log('\n==== Windows 冒烟：' + String(RESULTS.length - failed.length) + '/' + String(RESULTS.length) + ' PASS ====')
+const skipped = RESULTS.filter((row) => row[0] === 'SKIP')
+/** 分母扣掉 SKIP：**跳过的档不许算进 PASS 数**（否则「跳过」看起来像全过，正是要防的假绿）。 */
+const counted = RESULTS.length - skipped.length
+const summary = String(counted - failed.length) + '/' + String(counted) + ' PASS' +
+  (skipped.length > 0 ? '（另 ' + String(skipped.length) + ' 项 SKIP：' + skipped.map((row) => row[1]).join('；') + '）' : '')
+console.log('\n==== Windows 冒烟：' + summary + ' ====')
 // 同步再打一份结论：万一下面的 flush 屏障之前进程就没了（原生崩溃），至少这一行一定在。
-traceSync(`Windows 冒烟结论：${String(RESULTS.length - failed.length)}/${String(RESULTS.length)} PASS`)
+traceSync(`Windows 冒烟结论：${summary}`)
 for (const row of failed) console.error('  ✘ ' + row[1] + (row[2] ? ' — ' + row[2] : ''))
 clearTimeout(watchdog)
 /**