@hyzyn/dsh-tty 0.21.0 → 0.22.0-rc.2

package/scripts/preview/harness.js

@@ -24,6 +24,29 @@
   const q = (sel) => document.querySelector(sel)
   const qa = (sel) => [...document.querySelectorAll(sel)]
 
+  /*
+   * 预览语言：`?locale=en`（或 CDP 注入 `window.__previewLocale = 'en'`）预览英文界面，
+   * 默认 zh。与 search 的 mock-host / codegraph 的 preview-card 同一个开关形状
+   * （见 docs/i18n.md § 预览与 smoke 夹具）。夹具**提供**了 locale 服务，就必须能选语言，
+   * 否则它验的是一条不存在的路（「老宿主没有 locale 服务」那条路由中文兜底覆盖）。
+   */
+  try {
+    const wanted = new URLSearchParams(location.search).get('locale')
+    if (wanted === 'en' || wanted === 'zh') window.__previewLocale = wanted
+  } catch {
+    /* file:// 下 location.search 可能不可用 */
+  }
+
+  /*
+   * 按**界面文案**找元素：文案已经进目录（i18n），所以定位串必须**双语共存**——只认中文
+   * 会把英文界面下的走查挡在门外（同 search 的 `titles: ['通用设置', 'General']`）。
+   * 三个谓词都收「任一语言」，断言的失败信息仍是中文（开发者看的）。
+   */
+  const says = (el, ...names) => names.some((name) => (el.textContent || '').includes(name))
+  const saysExact = (el, ...names) => names.some((name) => (el.textContent || '').trim() === name)
+  const attributeSays = (el, attr, ...names) => names.some((name) => (el.getAttribute(attr) || '') === name)
+  const findByAria = (root, ...names) => [...root.querySelectorAll('[aria-label]')].find((el) => attributeSays(el, 'aria-label', ...names))
+
   /* ---------- 挂载插件 ---------- */
   // 场景之间共用同一个页面 target，必须先清掉上一个场景的标签持久化
   try {
@@ -99,6 +122,30 @@
   // 宿主会话服务也进服务表：docker 那一半是经 ctx.inject(['sessions']) 取的（夹具里
   // ctx.sessions 是直接属性、不走服务表，这里补一份，免得那条 inject 永远等不到依赖）
   services.set('sessions', ctx.sessions)
+
+  /*
+   * 假 locale 服务（`@deepseek-ai/dsh-client-locale`）：插件经 `ctx.inject(['locale'], cb)`
+   * **动态**取它，所以服务表里没有它时 callback 不触发、`t` 保持中文兜底（= 老宿主那条路）。
+   * 桩的形状与 search 的 mock-host 一致：`register(ns, locale, dict)` + `bind(ns)`，
+   * 词条按 `window.__previewLocale` 选语言。
+   */
+  const localeDicts = new Map()
+  const localeStub = {
+    register: (ns, locale, dict) => {
+      const entry = localeDicts.get(ns) || {}
+      entry[locale] = dict
+      localeDicts.set(ns, entry)
+      return () => {}
+    },
+    bind: (ns) => (key, params) => {
+      const active = window.__previewLocale === 'en' ? 'en' : 'zh'
+      const dict = localeDicts.get(ns) || {}
+      const text = (dict[active] || {})[key] || key
+      if (params === undefined) return text
+      return String(text).replace(/\{(\w+)\}/g, (_match, name) => (params[name] === undefined ? '' : String(params[name])))
+    },
+  }
+  services.set('locale', localeStub)
   exports.apply(ctx)
 
   /**
@@ -136,8 +183,9 @@
     await waitFor(() => q('.tt_addMenu'))
     await sleep(80)
   }
-  const clickMenuItem = async (label) => {
-    const item = await waitFor(() => qa('.tt_addMenuItem').find((el) => el.textContent.includes(label)))
+  // 菜单项按**双语**匹配（文案已进目录，见上面的 says）
+  const clickMenuItem = async (...labels) => {
+    const item = await waitFor(() => qa('.tt_addMenuItem').find((el) => says(el, ...labels)))
     item.click()
     await sleep(200)
     return item
@@ -210,7 +258,7 @@
         if (bar === null) return '状态条 DOM 缺失'
         if (bar.hidden === true) return '状态条未显示（stats 订阅链路可能断开）'
         const text = bar.textContent
-        if (!/CPU/.test(text) || !/内存/.test(text) || !/网络/.test(text)) return '状态条内容不完整：' + text
+        if (!/CPU/.test(text) || !/(内存|Memory)/.test(text) || !/(网络|Network)/.test(text)) return '状态条内容不完整：' + text
         /*
          * 订阅时序：客户端**故意**在 spawn 之前就发一次 statsOn（switchTab 早于 spawnTab），
          * 宿主此时还没登记这个 sid，会按「未知 sid」忽略——这是设计里的正常现象，所以
@@ -309,7 +357,7 @@
       await clickMenuItem('staging-db')
       await waitFor(() => tabs().length === 3)
       await clickAdd()
-      await clickMenuItem('本地终端')
+      await clickMenuItem('本地终端', 'Local terminal')
       await waitFor(() => tabs().length === 4)
       tabs()[1].click()
       await sleep(250)
@@ -338,7 +386,7 @@
     async ssh() {
       await openPanel()
       await clickAdd()
-      await clickMenuItem('SSH 连接…')
+      await clickMenuItem('SSH 连接…', 'SSH connection…')
       await waitFor(() => q('.tt_sshCard'))
       await sleep(150)
     },
@@ -346,16 +394,16 @@
     async 'ssh-probe'() {
       await openPanel()
       await clickAdd()
-      await clickMenuItem('SSH 连接…')
+      await clickMenuItem('SSH 连接…', 'SSH connection…')
       await waitFor(() => q('.tt_sshCard'))
       const inputs = qa('.tt_sshCard input')
       inputs[0].value = '192.0.2.10'
       inputs[1].value = '22'
       inputs[2].value = 'root'
-      const probeBtn = qa('.tt_sshActions .tt_toolBtn').find((b) => b.textContent.includes('试连'))
+      const probeBtn = qa('.tt_sshActions .tt_toolBtn').find((b) => says(b, '试连', 'Test'))
       probeBtn.click()
       const resultEl = () => q('.tt_sshProbeResult')
-      await waitFor(() => resultEl() && resultEl().textContent !== '' && !resultEl().textContent.includes('测试中'))
+      await waitFor(() => resultEl() && resultEl().textContent !== '' && !says(resultEl(), '测试中', 'Testing'))
       await sleep(250)
     },
     /* SSH 连接对话框（编辑连接簿条目，含 env 选择器） */
@@ -366,7 +414,7 @@
         const r = qa('.tt_addMenuRow')
         return r.length > 0 ? r : null
       })
-      const editBtn = rows[1].querySelector('.tt_addMenuEdit[title="编辑连接"]')
+      const editBtn = [...rows[1].querySelectorAll('.tt_addMenuEdit')].find((b) => attributeSays(b, 'title', '编辑连接', 'Edit connection'))
       editBtn.click()
       await waitFor(() => q('.tt_sshCard'))
       await sleep(200)
@@ -407,7 +455,7 @@
       // 「编辑」按钮是本次新增的能力：先在第一条隧道行上找到它
       const firstRow = rowOf('staging-pg')
       if (firstRow === undefined) throw new Error('找不到 staging-pg 行（fixture 应有该隧道）')
-      const editBtn = buttonsIn(firstRow).find((b) => b.textContent === '编辑')
+      const editBtn = buttonsIn(firstRow).find((b) => saysExact(b, '编辑', 'Edit'))
       if (editBtn === undefined) throw new Error('隧道行没有「编辑」按钮')
       editBtn.click()
       await sleep(150)
@@ -421,7 +469,7 @@
       await sleep(120)
 
       // 回填：本地转发那边「127.0.0.1:<端口>」成对呈现，端口输入带 aria-label 标识
-      const localPortInput = document.querySelector('#preview-settings [aria-label="本机监听端口"]')
+      const localPortInput = findByAria(document.querySelector('#preview-settings') || document, '本机监听端口', 'Local listen port')
       if (localPortInput === null) throw new Error('本地转发表单没渲染（找不到本机监听端口输入）')
       if (localPortInput.value !== '15432') throw new Error('编辑未回填本地端口：' + String(localPortInput.value))
 
@@ -444,7 +492,7 @@
 
       // 切到「远程 -R」：固定端应换到**右侧**（本机拨号），左侧变成可填的服务器侧监听地址
       // ——两个方向的固定端不同，这正是不能照搬单一形状的原因
-      segBtns.find((b) => (b.textContent ?? '').includes('远程')).click()
+      segBtns.find((b) => says(b, '远程 -R', 'Remote -R')).click()
       await sleep(200)
       scrollTunnelIntoView()
       const remoteEndpoints = [...document.querySelectorAll('#preview-settings .tt_tunnelEndpoint')]
@@ -460,7 +508,7 @@
         throw new Error('远程方向的箭头没有翻转标记')
       }
       // 切回本地 -L，后续断言按本地方向的期望继续
-      segBtns.find((b) => (b.textContent ?? '').includes('本地')).click()
+      segBtns.find((b) => says(b, '本地 -L', 'Local -L')).click()
       await sleep(200)
       scrollTunnelIntoView()
       await sleep(80)
@@ -499,13 +547,13 @@
       }
 
       // 方向切换会重渲表单：DOM 节点可能被替换，重新取一次（别用切换前的引用）
-      const localPortInput2 = document.querySelector('#preview-settings [aria-label="本机监听端口"]')
+      const localPortInput2 = findByAria(document.querySelector('#preview-settings') || document, '本机监听端口', 'Local listen port')
       if (localPortInput2 === null) throw new Error('切回本地后表单没渲染')
 
       const body = q('#preview-settings .tt_cardBody')
-      if (buttonsIn(body).find((b) => b.textContent === '保存修改') === undefined) throw new Error('编辑态没有「保存修改」')
-      if (buttonsIn(body).find((b) => b.textContent === '取消') === undefined) throw new Error('编辑态没有「取消」')
-      if (buttonsIn(body).find((b) => b.textContent === '添加隧道') !== undefined) {
+      if (buttonsIn(body).find((b) => saysExact(b, '保存修改', 'Save changes')) === undefined) throw new Error('编辑态没有「保存修改」')
+      if (buttonsIn(body).find((b) => saysExact(b, '取消', 'Cancel')) === undefined) throw new Error('编辑态没有「取消」')
+      if (buttonsIn(body).find((b) => saysExact(b, '添加隧道', 'Add tunnel')) !== undefined) {
         throw new Error('编辑态仍显示「添加隧道」（会误加一条而不是改这条）')
       }
       if (document.querySelectorAll('#preview-settings .tt_sshHostRow[data-editing]').length !== 1) {
@@ -530,7 +578,7 @@
       }
       setReactInput(localPortInput2, '15433')
       await sleep(150)
-      buttonsIn(body).find((b) => b.textContent === '保存修改').click()
+      buttonsIn(body).find((b) => saysExact(b, '保存修改', 'Save changes')).click()
       await sleep(400)
 
       window.__previewAssert = async () => {
@@ -546,7 +594,7 @@
         if (!names.some((n) => n.startsWith('prod-redis'))) {
           problems.push('编辑波及了别的隧道')
         }
-        if (buttonsIn(document.querySelector('#preview-settings .tt_cardBody')).find((b) => b.textContent === '添加隧道') === undefined) {
+        if (buttonsIn(document.querySelector('#preview-settings .tt_cardBody')).find((b) => saysExact(b, '添加隧道', 'Add tunnel')) === undefined) {
           problems.push('保存后没有退出编辑态')
         }
         return problems.length > 0 ? problems.join('；') : null
@@ -839,7 +887,7 @@
       await clickMenuItem('staging-db')
       await waitFor(() => tabs().length === 2)
       await sleep(200)
-      const btn = qa('.tt_connAct').find((b) => b.textContent.includes('隧道'))
+      const btn = qa('.tt_connAct').find((b) => says(b, '隧道', 'Tunnel'))
       if (btn) btn.click()
       await waitFor(() => q('.tt_tunnelPop'))
       await sleep(300)
@@ -861,17 +909,17 @@
 
       const acts = qa('.tt_connAct')
       // 没有隧道 ⇒ 不该出现常驻「隧道 N」按钮
-      if (acts.some((b) => b.textContent.includes('隧道'))) {
+      if (acts.some((b) => says(b, '隧道', 'Tunnel'))) {
         throw new Error('没有隧道的连接却出现了常驻「隧道」按钮')
       }
-      const more = acts.find((b) => b.textContent.includes('更多'))
+      const more = acts.find((b) => says(b, '更多', 'More'))
       if (more === undefined) throw new Error('没有隧道的连接缺少「⋯ 更多」入口')
       more.click()
       await waitFor(() => q('.tt_connMore'))
       await sleep(250)
 
       // 闭环：菜单项必须真的可点、并给出可执行的信息（该连接没有启用隧道 + 去哪配）
-      const item = qa('.tt_connMore .tt_addMenuItem').find((el) => el.textContent.includes('端口转发'))
+      const item = qa('.tt_connMore .tt_addMenuItem').find((el) => says(el, '端口转发', 'Port forwarding'))
       if (item === undefined) throw new Error('「⋯」菜单里没有端口转发项')
       item.click()
       await waitFor(() => q('.tt_tunnelPop'))
@@ -880,8 +928,8 @@
         const pop = q('.tt_tunnelPop')
         if (pop === null) return '点击菜单项后没有打开隧道弹层'
         const text = pop.textContent ?? ''
-        if (!text.includes('暂无启用')) return '弹层没有说明「该连接暂无启用的隧道」：' + text
-        if (!text.includes('插件配置') && !text.includes('设置')) return '弹层没有告诉用户去哪配置'
+        if (!text.includes('暂无启用') && !text.includes('No enabled tunnels')) return '弹层没有说明「该连接暂无启用的隧道」：' + text
+        if (!/插件配置|设置|Settings/.test(text)) return '弹层没有告诉用户去哪配置'
         return null
       }
     },
@@ -1081,7 +1129,7 @@
       await openPanel()
       window.__PREVIEW_AT_LIMIT = true
       await clickAdd()
-      await clickMenuItem('本地终端')
+      await clickMenuItem('本地终端', 'Local terminal')
       await waitFor(() => q('.tt_toast'))
       await sleep(200)
     },

package/scripts/probe-route-smoke.mjs

@@ -13,6 +13,15 @@ import net from 'node:net'
 import { name, inject, apply } from '../lib/index.js'
 import { startSftpSshd, TEST_USER, TEST_PASSWORD } from './lib/test-sshd.mjs'
 
+/*
+ * 变更端点要求「同源证明」（docker D32 口径，见 docs/architecture.md § 7 与
+ * packages/tty/src/index.ts 的 gateRoute）：浏览器同源 fetch 必带
+ * `sec-fetch-site: same-origin`——本脚本模拟的正是**面板**这条调用路径，所以照带。
+ * 少了它，/probe 与 /sftp 的写动作会被 403「缺少同源证明」（本脚本此前就踩在这里）。
+ */
+const SAME_ORIGIN = { 'sec-fetch-site': 'same-origin' }
+
+
 const RESULTS = []
 function pass(name) { RESULTS.push(['PASS', name]); console.log('  ✔ PASS  ' + name) }
 function fail(name, detail) { RESULTS.push(['FAIL', name, detail]); console.error('  ✘ FAIL  ' + name + (detail ? ' — ' + detail : '')) }
@@ -44,7 +53,7 @@ async function run() {
   const probe = async (body) => {
     const res = await fetch(`http://127.0.0.1:${port}/api/dsh-tty/probe`, {
       method: 'POST',
-      headers: { 'content-type': 'application/json' },
+      headers: { ...SAME_ORIGIN, 'content-type': 'application/json' },
       body: JSON.stringify(body),
     })
     return res.json()

package/scripts/proxycommand-smoke.mjs

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+/**
+ * @hyzyn/dsh-tty — 代理命令（ProxyCommand）的真机冒烟。
+ *
+ * 为什么必须真机跑一遍：`child_process.spawn → Duplex.from({readable, writable}) → ConnectConfig.sock`
+ * 这条链路的正确性单测证明不了——测试里只能断言「sock 是个 Duplex」；「stdin/stdout 真的把字节
+ * 送到了对端 sshd、目标真的在这条流上完成了握手、会话与 SFTP 都通、收尾真的没留下子进程」
+ * 只有真实现能给。这里刻意**不用系统 ssh / nc**（CI 上未必有、参数还各不相同），而是自己写一个
+ * 十几行的桥（`scripts/lib/proxy-bridge.mjs`）：把 stdio 接到 `host port`——这正是
+ * `ssh -W %h:%p bastion` 的原语，于是 `%h` / `%p` 的展开也被一并验到。
+ *
+ * 用例：
+ *   P1 终端会话经代理命令连上（spawnSsh：握手 + shell channel + 命令往返）
+ *   P2 SFTP 经代理命令列目录（同一份传输被 sftp.ts 那条路径复用）
+ *   P3 未获宿主授权 → 明确失败（文案点名环境变量），**且没有起进程**（即便「开关想开着」）
+ *   P4 命令本身失败（桥不存在）→ 文案带上代理命令的失败事实（stderr 摘要），而不是笼统的目标超时
+ *   P5 含 shell 特殊字符的主机名 → 拒绝代入（不执行任何命令）
+ *   P6 收尾后没有残留的桥进程（子进程不许变常驻孤儿）
+ *
+ * 退出码：全部 PASS → 0；任一 FAIL → 1（已进 CI 的 dsh-tty 端到端那一档）。
+ */
+import { execFileSync, spawn } from 'node:child_process'
+import fsp from 'node:fs/promises'
+import os from 'node:os'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { generateKeyPairSync } from 'node:crypto'
+import ssh2 from 'ssh2'
+import { SftpManager } from '../lib/sftp.js'
+import { bindCapabilitySources, capabilityGranted } from '@hyzyn/dsh-kit'
+import { setProxyCommandPolicy, spawnSsh } from '../lib/ssh.js'
+import { startSftpSshd, TEST_PASSWORD, TEST_USER } from './lib/test-sshd.mjs'
+
+const here = path.dirname(fileURLToPath(import.meta.url))
+const BRIDGE = path.join(here, 'lib', 'proxy-bridge.mjs')
+
+let failed = 0
+function pass(name) {
+  console.log(`  ✔ PASS  ${name}`)
+}
+function fail(name, detail) {
+  failed += 1
+  console.log(`  ✘ FAIL  ${name}${detail === undefined ? '' : ` — ${detail}`}`)
+}
+
+/* 全局看门狗：任何环节卡死时留痕退出（正常路径会先 process.exit）。 */
+setTimeout(() => {
+  console.error('[watchdog] 60s 看门狗触发：proxycommand-smoke 卡死')
+  process.exit(1)
+}, 60_000).unref?.()
+
+/**
+ * 数一数现在还活着几个桥进程（按命令行里的脚本路径匹配）。
+ *
+ * 返回 **-1 = 这个平台数不了**（Windows 没有 `ps`）。调用方必须把 -1 当「无法判定」而不是
+ * 0——否则「没有残留进程」在 Windows 上会变成一个**假通过**（第一次写这个脚本时就是这么比的）。
+ */
+function bridgeProcessCount() {
+  try {
+    const out = execFileSync('ps', ['-A', '-o', 'command'], { encoding: 'utf8' })
+    return out.split('\n').filter((line) => line.includes('proxy-bridge.mjs')).length
+  } catch {
+    return -1
+  }
+}
+
+const root = await fsp.mkdtemp(path.join(os.tmpdir(), 'dsh-tty-proxycmd-'))
+await fsp.writeFile(path.join(root, 'hello.txt'), 'via proxy command\n')
+
+const target = await startSftpSshd({ rootDir: root })
+
+/**
+ * 最小「能开 shell」的内存 sshd（只做密码认证 + pty + 回一句标记）。
+ *
+ * 为什么要另一个服务端：`test-sshd.mjs` 是 SFTP 专用（不接 pty 请求），而终端那条路
+ * `spawnSsh` 一定要 pty（`shell channel 打开失败: Unable to request a pseudo-terminal`）。
+ * 这里只需要能证明「终端真的跑在代理命令的 stdio 上」与「收尾后子进程没了」。
+ */
+async function startShellSshd() {
+  const { privateKey } = generateKeyPairSync('rsa', {
+    modulusLength: 2048,
+    publicKeyEncoding: { type: 'spki', format: 'pem' },
+    privateKeyEncoding: { type: 'pkcs1', format: 'pem' },
+  })
+  const server = new ssh2.Server({ hostKeys: [privateKey] }, (client) => {
+    client.on('authentication', (ctx) => {
+      if (ctx.method === 'password' && ctx.username === TEST_USER && ctx.password === TEST_PASSWORD) {
+        ctx.accept()
+        return
+      }
+      ctx.reject()
+    })
+    client.on('ready', () => {
+      client.on('session', (accept) => {
+        const session = accept()
+        session.on('pty', (acceptPty) => acceptPty())
+        session.on('shell', (acceptShell) => {
+          const stream = acceptShell()
+          stream.on('data', (chunk) => {
+            // 极简伪 shell：收到 printf 就回一句可匹配标记（传输通了就够，不解释命令）
+            if (chunk.toString('utf8').includes('printf')) stream.write('PROXYCMD:OK\r\n')
+          })
+        })
+      })
+    })
+    client.on('error', () => {
+      /* 断开：用例自己断言 */
+    })
+  })
+  await new Promise((resolve, reject) => {
+    server.once('error', reject)
+    server.listen(0, '127.0.0.1', () => resolve())
+  })
+  return {
+    port: server.address().port,
+    close: () => new Promise((resolve) => server.close(() => resolve())),
+  }
+}
+
+const shellTarget = await startShellSshd()
+
+/**
+ * 代理命令串：`"<node>" "<bridge>" %h %p`。
+ *
+ * 用 JSON.stringify 包引号是为了两平台都对：POSIX 的 sh 与 Windows 的 cmd 都认双引号，
+ * 而 execPath 在 Windows 上常含空格（`C:\Program Files\nodejs\node.exe`）。
+ */
+const proxyCommand = `${JSON.stringify(process.execPath)} ${JSON.stringify(BRIDGE)} %h %p`
+
+/**
+ * 闸门的两个维度：`granted` 来自宿主侧环境变量（进程启动时采样一次，见 kit 的 capability.js），
+ * `enabled` 是界面上那个开关。这里**照插件宿主半体的做法**拼出同样的组合，而不是直接传 true
+ * ——否则冒烟就绕过了这一轮新加的那一层授权。
+ */
+const GRANT_ENV = 'DSH_TTY_ALLOW_PROXY_COMMAND'
+const applyPolicy = (enabled) => setProxyCommandPolicy({ granted: capabilityGranted(GRANT_ENV), enabled })
+const specOf = (extra = {}) => ({
+  host: '127.0.0.1',
+  port: target.port,
+  username: TEST_USER,
+  auth: 'password',
+  password: TEST_PASSWORD,
+  proxyCommand,
+  ...extra,
+})
+
+/** 读一条 SSH 会话的输出直到匹配（或超时）。 */
+async function readUntil(handle, pattern, timeoutMs = 8000) {
+  let text = ''
+  return await new Promise((resolve) => {
+    const timer = setTimeout(() => resolve({ text, matched: pattern.test(text) }), timeoutMs)
+    handle.output.on('data', (chunk) => {
+      text += chunk.toString('utf8')
+      if (pattern.test(text)) {
+        clearTimeout(timer)
+        resolve({ text, matched: true })
+      }
+    })
+  })
+}
+
+try {
+  // ---- P3 放在最前：**未获宿主授权**时不该起任何进程（先测这条，后面的用例才有干净的计数） ----
+  const before = bridgeProcessCount()
+  delete process.env[GRANT_ENV]
+  // 绑定 = 「这次宿主启动时带了什么环境」（见 kit 的 bindCapabilitySources）：先改变量再绑定，顺序不能反
+  bindCapabilitySources(undefined)
+  applyPolicy(true) // 即便「开关想开着」，没有宿主授权也必须拒绝
+  try {
+    await new SftpManager({ info: () => {}, warn: () => {} }).list(specOf(), root)
+    fail('P3 闸门关着 → 明确失败', '竟然连上了')
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    await new Promise((resolve) => setTimeout(resolve, 150))
+    const after = bridgeProcessCount()
+    if (message.includes('未获宿主授权') && message.includes(GRANT_ENV) && (after === -1 || after <= before)) {
+      const count = after === -1 ? '本平台数不了进程（无 ps）' : `桥进程 ${String(before)} → ${String(after)}`
+      pass(`P3 未授权 → 明确失败${after === -1 ? '（未起进程这一条跳过：' + count + '）' : `且没起进程（${count}）`}`)
+    } else {
+      fail('P3 未授权 → 明确失败且没起进程', `msg=${message} before=${String(before)} after=${String(after)}`)
+    }
+  }
+
+  // ---- P5：代入值含 shell 特殊字符 → 拒绝执行（连进程都不该起） ----
+  // 从这里开始模拟「宿主启动时就带了授权环境变量」：先设变量再绑定（顺序不能反）
+  process.env[GRANT_ENV] = '1'
+  bindCapabilitySources(undefined)
+  applyPolicy(true)
+  if (!capabilityGranted(GRANT_ENV)) fail('P3b 宿主侧授权生效', '设了环境变量却没被采到')
+  else pass('P3b 宿主侧授权生效（DSH_TTY_ALLOW_PROXY_COMMAND=1）')
+  try {
+    await new SftpManager({ info: () => {}, warn: () => {} }).list(specOf({ host: '127.0.0.1; touch /tmp/dsh-pwned' }), root)
+    fail('P5 主机名含 shell 特殊字符 → 拒绝代入', '竟然没报错')
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    if (message.includes('无法代入')) pass('P5 主机名含 shell 特殊字符 → 拒绝代入')
+    else fail('P5 主机名含 shell 特殊字符 → 拒绝代入', message)
+  }
+  const pwned = await fsp.access('/tmp/dsh-pwned').then(() => true).catch(() => false)
+  if (pwned) {
+    await fsp.rm('/tmp/dsh-pwned', { force: true })
+    fail('P5b 注入没有落地', '竟然真的创建了 /tmp/dsh-pwned')
+  } else {
+    pass('P5b 注入没有落地（/tmp/dsh-pwned 不存在）')
+  }
+
+  // ---- P1：终端会话经代理命令连上，并在上面跑一条命令 ----
+  let session = null
+  try {
+    session = await spawnSsh(specOf({ port: shellTarget.port }), { term: 'xterm-256color', cols: 80, rows: 24, logger: { info: () => {}, warn: () => {} } })
+    session.write('printf "PROXYCMD:%s\\n" OK\n')
+    const { text } = await readUntil(session, /PROXYCMD:OK/)
+    if (text.includes('PROXYCMD:OK')) pass('P1 终端会话经代理命令连上并完成命令往返')
+    else fail('P1 终端会话经代理命令连上并完成命令往返', JSON.stringify(text.slice(-200)))
+  } catch (error) {
+    fail('P1 终端会话经代理命令连上并完成命令往返', error instanceof Error ? error.message : String(error))
+  } finally {
+    if (session !== null) await session.terminate().catch(() => {})
+    session?.forceKill?.()
+  }
+
+  // ---- P2：SFTP 走同一条准备路径（prepareSshConnect） ----
+  const sftp = new SftpManager({ info: () => {}, warn: () => {} })
+  try {
+    const listed = await sftp.list(specOf(), root)
+    const names = listed.entries.map((entry) => entry.name)
+    if (names.includes('hello.txt')) pass(`P2 SFTP 经代理命令列目录（${String(names.length)} 项）`)
+    else fail('P2 SFTP 经代理命令列目录', JSON.stringify(names))
+  } catch (error) {
+    fail('P2 SFTP 经代理命令列目录', error instanceof Error ? error.message : String(error))
+  } finally {
+    sftp.disposeAll()
+  }
+
+  // ---- P4：命令自己失败 → 文案点名「代理命令已退出」+ 退出码 ----
+  try {
+    const dial = new SftpManager({ info: () => {}, warn: () => {} })
+    await dial.list(specOf({ proxyCommand: `${JSON.stringify(process.execPath)} ${JSON.stringify(path.join(os.tmpdir(), 'definitely-missing-bridge.mjs'))} %h %p` }), root)
+    fail('P4 命令失败 → 文案点名代理命令', '竟然连上了')
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    /*
+     * 断言刻意宽松：子进程「结束输出」与「exit」相差 1~2ms，而 ssh2 一看流断了就报错——
+     * 谁先到不确定。两种时序都必须**至少**把 stderr 摘要交出来（那才是可排查的信息）：
+     *   - exit 先到 → 「代理命令已退出（退出码 1）…」；
+     *   - 传输先关 → 「代理命令传输已关闭；stderr: …」。
+     */
+    const named = message.includes('代理命令')
+    const explained = message.includes('Cannot find module') || message.includes('退出码')
+    if (named && explained) pass('P4 命令失败 → 文案带上代理命令的失败事实（stderr 摘要可见）')
+    else fail('P4 命令失败 → 文案带上代理命令的失败事实（stderr 摘要可见）', message)
+  }
+
+  // ---- P6：收尾后没有残留的桥进程 ----
+  await new Promise((resolve) => setTimeout(resolve, 400))
+  const leaked = bridgeProcessCount()
+  if (leaked === 0) pass('P6 收尾后没有残留的代理命令进程')
+  else if (leaked === -1) console.log('  ⊘ SKIP  P6 收尾后没有残留的代理命令进程 — 本平台没有 ps，数不了')
+  else fail('P6 收尾后没有残留的代理命令进程', `ps 里还有 ${String(leaked)} 个 proxy-bridge.mjs`)
+} finally {
+  await target.close().catch(() => {})
+  await shellTarget.close().catch(() => {})
+  await fsp.rm(root, { recursive: true, force: true }).catch(() => {})
+}
+
+console.log(failed === 0 ? '\nproxycommand smoke: 全部 PASS' : `\nproxycommand smoke: ${String(failed)} 个 FAIL`)
+process.exit(failed === 0 ? 0 : 1)