@hyzyn/dsh-tty 0.20.0 → 0.20.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyzyn/dsh-tty",
-  "version": "0.20.0",
+  "version": "0.20.2",
   "description": "DSH Web GUI 的终端面板插件：侧边栏「终端」大弹窗，xterm.js + PTY 全交互终端（路线1），ssh2 原生 SSH 远程连接（方案 C），tmux 会话持久化（0.10.0），连接栏扩展点 ttyConnbar（0.13.0）、终端服务 ttyTerminal（0.14.0 open / 0.15.0 mount 就地嵌入）、面板内挂载位 ttyPanel（0.16.0 右侧 dock）、服务器状态条（0.17.0：按标签可见性采端主机 CPU / 内存 / 磁盘 / 在线时长 / TCP / 网速 / 温度，SSH 走同连接的非 PTY exec channel、本地走 os/proc，best-effort、不碰 PTY 流）、连接密码存入官方凭据存储（0.18.0：字段里只留 env: 引用、引用名按资源身份派生、候选来自凭据存储 ∪ 连接簿；设置卡片的连接编辑与连接对话框共用同一套表单）、Windows 宿主支持（0.18.1：默认 shell = %COMSPEC%、不做 POSIX 包装层、PowerShell 走 -NoLogo/-Command；shell 集成 / tmux / 状态条三项在 Windows 本地不适用，README 有完整边界）。",
   "keywords": [
     "dsh",
@@ -33,28 +33,30 @@
     "./package.json": "./package.json"
   },
   "dsh": {
+    "manifestVersion": 1,
     "bundle": {
       "patch": "./cordis.patch.yml"
     },
     "engines": {
-      "dsh": ">=0.1.2-rc.1"
+      "dsh": ">=0.1.7-rc.1"
     },
     "client": {
       "platform": "web"
     }
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@hyzyn/dsh-kit": "0.4.1",
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "@hyzyn/dsh-kit": "0.4.2",
     "@xterm/headless": "^5.5.0",
     "ssh2": "^1.17.0",
     "ws": "^8.18.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1"
+    "@deepseek-ai/dsh": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.7-rc.1"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/cordis": "^4.0.4",
     "@deepseek-ai/dsh-host-webserver": "0.1.2-rc.1",
     "@deepseek-ai/dsh-subprocess": "0.1.2-rc.1",
     "@deepseek-ai/dsh-subprocess-local": "0.1.2-rc.1",
@@ -90,6 +92,11 @@
   "publishConfig": {
     "access": "public"
   },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json && node scripts/build-client.mjs",
     "typecheck": "tsc --noEmit && node ../../scripts/client-lint.mjs",

package/scripts/integration.mjs

@@ -136,8 +136,15 @@ async function run() {
   const app = new Context()
   const wsFiber = app.plugin(WebServerRuntime, { host: '127.0.0.1', port: 0 })
   const subFiber = app.plugin(LocalSubprocessRuntime)
-  // 最小 settings 服务 stub：让插件的 settings 注入回调触发，并可手动派发
-  // settings/updated 事件（与 dsh-settings 的 dispatch 方式一致）来测配置热生效。
+  // 最小 settings 服务 stub（DSH ≥0.1.7 的 SettingsForms：describe / update /
+  // configure）：让插件的 settings 注入回调触发；配置热生效经 loader 的
+  // volatile-update 事件派发（见 emitSettingsUpdated）。
+  let settingsValue = {}
+  /** 派发 loader 的 volatile-update：真实宿主在 settings.update 之后由 loader 发出。 */
+  const emitVolatile = () => {
+    const args = ['loader/volatile-update', [], {}, 'test']
+    for (const cb of app.events.dispatch('emit', args)) cb(...args)
+  }
   const toolDefs = []
   /** 输出契约违约（§B33：返回值与声明的 output.schema 不符，真实宿主会直接判工具错）。 */
   const outputViolations = []
@@ -145,7 +152,15 @@ async function run() {
   const stubFiber = app.plugin({
     name: 'settings-stub',
     apply: (ctx) => {
-      ctx.provide('settings', { register: () => ({ get: () => ({}), update: async () => {} }) })
+      ctx.provide('settings', {
+        describe: () => [{ ns: 'tty', value: settingsValue }],
+        update: async (ns, patch) => {
+          if (ns !== 'tty') throw new Error('未知的 entry: ' + ns)
+          settingsValue = { ...settingsValue, ...patch }
+          emitVolatile()
+        },
+        configure: () => () => {},
+      })
       ctx.provide('tools', {
         register: (definition) => {
           // 输出契约看门狗（§B33）：把 execute 的返回值按**声明的 output.schema**
@@ -202,9 +217,10 @@ async function run() {
     },
   })
   await stubFiber.await()
+  /** 模拟「外部改了本 entry 的配置」：更新 stub 值再派发 loader 的 volatile-update。 */
   const emitSettingsUpdated = (ns, next) => {
-    const args = ['settings/updated', ns, next, {}, 'test']
-    for (const cb of app.events.dispatch('emit', args)) cb(...args)
+    if (ns === 'tty') settingsValue = { ...next }
+    emitVolatile()
   }
   const pluginFiber = app.plugin({ name, inject, apply }, { maxSessions: 2, term: 'xterm-256color', colorTerm: 'truecolor' })
   await wsFiber.await()
@@ -278,7 +294,18 @@ async function run() {
     if (/sid 已存在/.test(s.state.errors[0])) pass('B3 同 sid 二次 spawn 被拒')
     else fail('B3 同 sid 二次 spawn 被拒', s.state.errors[0])
     s.client.send(JSON.stringify({ t: 'kill', sid: 'tab-a' }))
-    await s.waitFor(() => s.state.exited !== null, 10000, 'exit')
+    try {
+      await s.waitFor(() => s.state.exited !== null, 10000, 'exit')
+    } catch (error) {
+      // 诊断（CI 上 Linux 专属复现）：区分「kill 没生效（服务端仍列着它）」与
+      // 「会话已消失、只是 exit 帧没发（PTY 句柄的 done 未兑现）」。
+      s.client.send(JSON.stringify({ t: 'sessions' }))
+      await sleep(500)
+      const sessionsFrame = [...s.state.frames].reverse().find((f) => f.t === 'sessions')
+      console.error('    [diag] 收到的帧类型=' + JSON.stringify(s.state.frames.map((f) => f.t)))
+      console.error('    [diag] 服务端会话清单=' + JSON.stringify(sessionsFrame?.list ?? null))
+      throw error
+    }
     s.client.close()
   }
 
@@ -1187,9 +1214,11 @@ async function run() {
         execFile(file, args, { timeout: 5000 }, (error, stdout, stderr) => resolve({ error, stdout: String(stdout), stderr: String(stderr) }))
       })
     })
+    let tmuxListError = null
     const tmuxList = async () => {
       const out = await execFileP('tmux', ['-L', 'dsh-tty', 'list-sessions', '-F', '#{session_name}'])
-      return out.error !== null && out.error !== undefined ? [] : out.stdout.trim().split('\n').filter(Boolean)
+      tmuxListError = out.error === null || out.error === undefined ? null : (out.stderr || String(out.error))
+      return tmuxListError !== null ? [] : out.stdout.trim().split('\n').filter(Boolean)
     }
     const post = async (body) => {
       const res = await fetch(`http://127.0.0.1:${port}/api/dsh-tty/config`, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) })
@@ -1274,8 +1303,18 @@ async function run() {
       await post({ reconnectGraceSec: 1 })
       const w1 = openSession(port)
       await w1.open()
+      const cfgBefore = await (await fetch(`http://127.0.0.1:${port}/api/dsh-tty/config`)).json()
       w1.client.send(JSON.stringify({ t: 'spawn', sid: 'b26a', cols: 80, rows: 24, persist: true, persistName: 'b26resume' }))
       await w1.waitFor(() => w1.state.ready, 10000, 'b26a ready')
+      {
+        const readyFrame = w1.state.frames.find((f) => f.t === 'ready' && f.sid === 'b26a')
+        const listedAfterSpawn = await tmuxList()
+        console.error('    [diag] persistence=' + String(cfgBefore?.config?.persistence)
+          + ' ready.persist=' + String(readyFrame?.persist)
+          + ' tmuxAfterSpawn=' + JSON.stringify(listedAfterSpawn)
+          + ' TMPDIR=' + JSON.stringify(process.env.TMPDIR ?? null)
+          + ' tmuxListError=' + JSON.stringify(tmuxListError))
+      }
       w1.client.send(JSON.stringify({ t: 'input', sid: 'b26a', d: 'printf "B26MARK-%s\\n" resume\n' }))
       await w1.waitFor(() => /B26MARK-resume/.test(w1.state.text), 10000, '标记输出')
       // 异常断开 → 孤儿 → 保活 1s + 回收器扫描（≤10s）只杀 PTY；tmux 会话应存活

package/scripts/preview.mjs

@@ -12,6 +12,8 @@
  *   node scripts/preview.mjs --list             # 列出场景
  *   node scripts/preview.mjs --build            # 顺带重建 client.js（默认不重建，产物落后直接报错）
  *   node scripts/preview.mjs --theme=light      # 浅色主题
+ *   node scripts/preview.mjs --width=560        # 压窄视口走查窄容器排版（默认 1680）
+ *   PREVIEW_CHROME_ARGS=--no-sandbox node scripts/preview.mjs   # 受限沙箱 / CI 里 Chrome 起不来时
  *
  * 需要本机有 Chrome/Chromium（默认找 playwright 缓存的 Chrome for Testing，
  * 也可用 CHROME_PATH 指定）。
@@ -37,6 +39,18 @@ const wantBuild = flags.has('--build')
 /** 输出子目录：--out=shots-light 之类，便于并排比较明暗主题。 */
 const outName = (argv.find((a) => a.startsWith('--out=')) || '--out=shots').split('=')[1]
 const shotsDir = join(previewDir, outName)
+/**
+ * 视口宽度（默认 1680）。真实宿主里这张卡片常挂在窄容器里（插件管理页 / 侧栏），
+ * 1680px 的宽视口会把「一行塞不塞得下」这类排版问题盖掉——走查窄排版时用
+ * `--width=560` 之类显式压窄。
+ */
+const viewportWidth = Number((argv.find((a) => a.startsWith('--width=')) || '--width=1680').split('=')[1]) || 1680
+/**
+ * 额外 Chrome 参数（空格分隔）。受限环境（文件沙箱 / CI 容器）里 Chrome 自己的
+ * sandbox 起不来，CDP 会一直卡在 `Page.enable` 直到超时——此时用
+ * `PREVIEW_CHROME_ARGS=--no-sandbox`。刻意不做默认：那会削弱所有调用方的隔离。
+ */
+const extraChromeArgs = (process.env.PREVIEW_CHROME_ARGS ?? '').split(' ').filter((a) => a !== '')
 
 /* ------------------------------- 场景清单 ------------------------------- */
 
@@ -331,6 +345,7 @@ async function launchChrome() {
     '--disable-webgl',
     '--force-color-profile=srgb',
     '--font-render-hinting=none',
+    ...extraChromeArgs,
     'about:blank',
   ], { stdio: ['ignore', 'ignore', 'pipe'] })
 
@@ -475,7 +490,7 @@ async function main() {
   await ensureVendor()
   log('启动 headless Chrome（' + theme + ' 主题）')
   const { child, cdp, userDataDir } = await launchChrome()
-  await cdp.send('Emulation.setDeviceMetricsOverride', { width: 1680, height: 1050, deviceScaleFactor: 2, mobile: false })
+  await cdp.send('Emulation.setDeviceMetricsOverride', { width: viewportWidth, height: 1050, deviceScaleFactor: 2, mobile: false })
   let failed = 0
   try {
     for (const name of wanted) {

package/scripts/probe-route-smoke.mjs

@@ -24,7 +24,9 @@ async function run() {
   const stubFiber = app.plugin({
     name: 'settings-stub',
     apply: (ctx) => {
-      ctx.provide('settings', { register: () => ({ get: () => ({}), update: async () => {} }) })
+      // DSH ≥0.1.7 的 settings 服务（SettingsForms）：describe / update / configure。
+      // 本用例不测配置持久化，空 describe 即可（插件的 settings effect 拿到空值）。
+      ctx.provide('settings', { describe: () => [], update: async () => {}, configure: () => () => {} })
       ctx.provide('tools', { register: () => () => {} })
       // 与真实契约同形（section/context 返回注销器）：插件热应用时会调用重建
       ctx.provide('systemPrompt', {

package/scripts/screen-crash-repro.mjs

@@ -0,0 +1,62 @@
+/**
+ * 复现：`@xterm/headless` 在「`scrollback: 0`（= D57 修复前 dsh-tty 虚拟屏的构造参数）
+ * + 输出与 resize 交错」下抛出未捕获 TypeError，**杀掉整个 Node 宿主进程**。
+ *
+ *   TypeError: Cannot set properties of undefined (setting 'isWrapped')
+ *       at E.lineFeed (.../@xterm/headless/lib-headless/xterm-headless.js:1:28221)
+ *       at c.parse … at n._action … at n._innerWrite … at Timeout._onTimeout
+ *
+ * 与线上 `~/.dsh/dsh-safe/last-failure-web.log` 里那次宿主崩溃的堆栈逐帧一致。
+ *
+ * 运行（`packages/tty` 下）：
+ *   node scripts/screen-crash-repro.mjs                       # 用本包解析到的 @xterm/headless
+ *   node scripts/screen-crash-repro.mjs <另一个 headless.js>   # 换版本对比（如 6.0.0，仍然崩）
+ *
+ * 期望输出：`exit=1` + 上面那段堆栈（进程被未捕获异常打死）。
+ * 若打印 `no uncaught exception`，说明该版本已修 —— 这时该复核 SCREEN_SCROLLBACK 这条护栏。
+ *
+ * 这是**排查用**的一次性脚本；日常回归看 `test/screen-crash.test.ts`（D57）。
+ */
+import { createRequire } from 'node:module'
+import { existsSync } from 'node:fs'
+
+const require = createRequire(import.meta.url)
+// 默认用本包依赖解析出来的 @xterm/headless（`packages/tty` 下运行即为本包版本）
+const defaultXterm = require.resolve('@xterm/headless')
+const xtermPath = process.argv[2] ?? defaultXterm
+if (!existsSync(xtermPath)) {
+  console.error('xterm headless 不存在：' + xtermPath)
+  process.exit(2)
+}
+
+const { Terminal } = require(xtermPath)
+
+// 刻意不装 uncaughtException 处理器 —— 与修复前的 dsh-tty / dsh 宿主现状一致，
+// 异常在 setTimeout 回调里逃逸，Node 直接打死进程（正是线上那次的表现）。
+const terminal = new Terminal({ cols: 60, rows: 3, scrollback: 0, allowProposedApi: true })
+const tick = () => new Promise((resolve) => setTimeout(resolve, 0))
+
+// D57 的 10 步最小复现序列：输出 → 设滚动区 → 反复 resize（触发 reflow）→ 末尾一个 '\n'
+const ops = [
+  ['write', 'A'.repeat(300)],
+  ['write', '\x1b[3;9r'],
+  ['write', '\r\n'],
+  ['resize', 70, 40],
+  ['write', '\r\n'],
+  ['resize', 33, 5],
+  ['resize', 118, 8],
+  ['write', 'A'.repeat(300)],
+  ['resize', 21, 11],
+  ['write', '\n'], // ← 崩在这一步：lineFeed 里 lines.get() 返回 undefined
+]
+
+for (const op of ops) {
+  if (op[0] === 'write') terminal.write(op[1])
+  else terminal.resize(op[1], op[2])
+  await tick()
+}
+for (let i = 0; i < 5; i++) await tick()
+
+// 只有没崩才会走到这里
+console.log('no uncaught exception')
+process.exit(0)

package/scripts/sftplimits-smoke.mjs

@@ -18,7 +18,9 @@ async function run() {
   const stubFiber = app.plugin({
     name: 'settings-stub',
     apply: (ctx) => {
-      ctx.provide('settings', { register: () => ({ get: () => ({}), update: async () => {} }) })
+      // DSH ≥0.1.7 的 settings 服务（SettingsForms）：describe / update / configure。
+      // 本用例不测配置持久化，空 describe 即可（插件的 settings effect 拿到空值）。
+      ctx.provide('settings', { describe: () => [], update: async () => {}, configure: () => () => {} })
       ctx.provide('tools', { register: () => () => {} })
       // 与真实契约同形（section/context 返回注销器）：插件热应用时会调用重建
       ctx.provide('systemPrompt', {

package/scripts/windows-smoke.mjs

@@ -94,7 +94,9 @@ async function run() {
   const stubFiber = app.plugin({
     name: 'windows-smoke-stub',
     apply: (ctx) => {
-      ctx.provide('settings', { register: () => ({ get: () => ({}), update: async () => {} }) })
+      // DSH ≥0.1.7 的 settings 服务（SettingsForms）：describe / update / configure。
+      // 本用例不测配置持久化，空 describe 即可（插件的 settings effect 拿到空值）。
+      ctx.provide('settings', { describe: () => [], update: async () => {}, configure: () => () => {} })
       ctx.provide('tools', { register: () => () => {} })
     },
   })