dsh-ssh-tui 0.3.2 → 0.3.3

package/README.en.md

@@ -1,12 +1,13 @@
 # dsh-ssh-tui
 
 A DeepSeek Harness terminal for jump hosts, headless servers, and high-latency
-SSH. Plain ANSI and incremental redraws. No browser, no Ink/React skin.
+SSH. Plain ANSI and incremental redraws. No browser required.
 
 中文部署指南：[README.md](README.md)
 
-Who it is for: a keyboard-only SSH session on a remote box. Who it is not for:
-a local desktop TUI with many themes — that lane already has a clear winner.
+If you mostly work over SSH — a jump host, a test box, a keyboard-only
+session — start here. A local desktop terminal with themes and layout
+you already like can stay as it is.
 
 ## Official headless vs this TUI
 
@@ -27,6 +28,19 @@ own card, the plan strip pinned above the input.
 
 Singles: [headless stdout](docs/screenshots/headless.png) · [dsh-ssh-tui](docs/screenshots/workspace.png)
 
+## Still visible on a slow SSH pipe
+
+Same task, replayed at **2 kB/s** through the real incremental painter
+(88×30, one `stdout.write` per frame). Official headless on that pipe
+would stay blank until the final markdown. Here reasoning, the edit
+diff, subagent cards, and the plan strip appear as the bytes arrive.
+
+![Same task replayed at 2 kB/s SSH](docs/screenshots/slow-link.gif)
+
+Reproducible, no model in the loop: `npm run screenshots:slow` writes
+`docs/screenshots/slow-link.json`. This capture is 14 paints, about
+**15.5 KB**, **7.6 s** at 2 kB/s. Byte ledger for this event sequence.
+
 ## Requirements
 
 - Node.js >= 22.19
@@ -323,12 +337,10 @@ switching while running.
 ## Jump-host / proxied SSH
 
 Each paint is one `stdout.write` of dirty rows only, so a jump host or
-corporate proxy does not see one SSH packet per line. Default cadence is
-about 160 ms, enough for most jump hosts. On a very slow path:
-
-```sh
-export DSH_TUI_PAINT_MS=250   # 40–1000; higher = fewer packets, choppier stream
-```
+corporate proxy does not see one SSH packet per line. Local ttys use 80 ms.
+Over SSH the TUI probes CSI 6n once and picks 80 / 160 / 250 / 400 ms from
+the round-trip. `DSH_TUI_PAINT_MS` always wins (40–1000). `/status` and the
+footer show the active tier.
 
 ## Development
 

package/README.md

@@ -1,12 +1,12 @@
 # dsh-ssh-tui
 
 给跳板机、无桌面服务器、高延迟 SSH 用的 DeepSeek Harness 终端。纯 ANSI、增量重绘，
-不需要浏览器，也不需要 Ink / React 那套皮肤。
+不需要浏览器。
 
 English: [README.en.md](README.en.md)
 
-适合谁：SSH 直连的远程机器、慢链路、只有键盘的会话。不适合谁：本机想要多主题、
-官网级交互的桌面终端——那条赛道已经有明确赢家。
+如果你主要在 SSH 里写代码——公司跳板、测试机、只有键盘的会话——可以从这里开始。
+本机桌面终端若更在意主题和布局，也可以继续用你已经习惯的界面。
 
 SuperGrok / X Premium 订阅走配套插件 [dsh-llm-xai-oauth](https://github.com/cyjyyd/dsh-llm-xai-oauth)，复用本机 grok-bridge token，不需要 xAI API Key。
 
@@ -23,6 +23,14 @@ SuperGrok / X Premium 订阅走配套插件 [dsh-llm-xai-oauth](https://github.c
 
 单独看：[headless stdout](docs/screenshots/headless.png) · [dsh-ssh-tui](docs/screenshots/workspace.png)
 
+## 弱网 SSH 上过程还在
+
+同一条任务，按 **2 kB/s** 限速回放真实增量绘制（88×30，一帧一次 `stdout.write`）。官方 headless 这条链路上只会在全部结束后突然打出最终 Markdown；这里思考、`edit` diff、子代理卡和计划条是随着字节到达逐步出现的。
+
+![2 kB/s SSH 上回放同一任务](docs/screenshots/slow-link.gif)
+
+协议（可复现，不靠模型估）：`npm run screenshots:slow` → `docs/screenshots/slow-link.json`。这次回放 14 次绘制、约 **15.5 KB**，在 2 kB/s 上大约 **7.6 s** 画完。数字是这条固定事件序的 stdout 字节账。
+
 ## 功能一览
 
 - 纯终端渲染，无需浏览器/鼠标/重量级终端框架，适合慢速或远程 SSH；
@@ -290,10 +298,7 @@ npm run build
 - **标题栏或铃声不生效**：确认终端支持 OSC 0 与 BEL；铃声可用
   `DSH_TUI_NO_BELL=1` 关闭。
 - **滚轮误触取消**：已加入转义序列缓冲，网络拆包也不会把 `ESC` 当取消。
-- **跳板机 / 多层代理 SSH 发画**：每一帧只发脏行，并且拼成一次 `stdout.write`，避免一行一个 SSH 包。默认约 160 ms 合一帧，多数跳板机不用改。特别慢时：
-  ```bash
-  export DSH_TUI_PAINT_MS=250   # 40–1000；越大越省链路，流式字越顿
-  ```
+- **跳板机 / 多层代理 SSH 发画**：每一帧只发脏行，并且拼成一次 `stdout.write`。本机 80 ms；SSH 启动时用 CSI 6n 测往返，按 RTT 选 80/160/250/400 ms。`DSH_TUI_PAINT_MS` 始终优先（40–1000）。`/status` 和底栏显示当前档。
 
 ## License
 

package/lib/tui.js

@@ -7,7 +7,8 @@
  *
  * The renderer uses plain ANSI and coalesces each frame into one stdout
  * write of dirty rows only — jump-host / proxied SSH should see one packet
- * per paint, not one per line. Cadence is DSH_TUI_PAINT_MS (default 160).
+ * per paint, not one per line. Cadence is DSH_TUI_PAINT_MS, else local 80 ms
+ * or an SSH tier from a CSI 6n round-trip (default 160 ms).
  */
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
@@ -60,18 +61,45 @@ const PROVIDER_TEMPLATES = {
     },
 };
 const RENDER_INTERVAL_MS = 160;
+const LOCAL_PAINT_INTERVAL_MS = 80;
 const WAIT_INDICATOR_MS = 8000;
 const MIN_PAINT_INTERVAL_MS = 40;
 const MAX_PAINT_INTERVAL_MS = 1000;
+const DSR_PROBE_TIMEOUT_MS = 800;
 /**
- * Paint cadence for jump-host / proxied SSH. Token ticks coalesce into one
- * frame; the default stays snappy, slower links raise `DSH_TUI_PAINT_MS`.
+ * Explicit env/config always wins. Otherwise local TTYs stay snappy and SSH
+ * sessions pick a tier from a measured round-trip (CSI 6n), falling back to
+ * 160 ms when the probe is missing.
  */
-export function resolvePaintIntervalMs(configured, env = process.env) {
+export function resolvePaintIntervalMs(configured, env = process.env, options = {}) {
     const raw = configured ?? Number.parseInt(env.DSH_TUI_PAINT_MS ?? '', 10);
-    if (!Number.isFinite(raw) || raw <= 0)
+    if (Number.isFinite(raw) && raw > 0) {
+        return Math.min(MAX_PAINT_INTERVAL_MS, Math.max(MIN_PAINT_INTERVAL_MS, Math.floor(raw)));
+    }
+    if (options.ssh === true)
+        return paintIntervalForRtt(options.rttMs);
+    return LOCAL_PAINT_INTERVAL_MS;
+}
+/** True when this process is attached to an SSH session (jump host / proxy). */
+export function detectSshSession(env = process.env) {
+    return Boolean(env.SSH_CONNECTION || env.SSH_CLIENT || env.SSH_TTY);
+}
+/** Map a CSI-6n round-trip to a paint cadence. Unknown RTT uses the SSH default. */
+export function paintIntervalForRtt(rttMs) {
+    if (rttMs === undefined || !Number.isFinite(rttMs) || rttMs < 0)
         return RENDER_INTERVAL_MS;
-    return Math.min(MAX_PAINT_INTERVAL_MS, Math.max(MIN_PAINT_INTERVAL_MS, Math.floor(raw)));
+    if (rttMs < 50)
+        return LOCAL_PAINT_INTERVAL_MS;
+    if (rttMs < 150)
+        return 160;
+    if (rttMs < 350)
+        return 250;
+    return 400;
+}
+export function paintLinkLabel(kind, intervalMs, probed) {
+    if (kind === 'local')
+        return `本机绘制 ${intervalMs}ms`;
+    return probed ? `SSH 绘制 ${intervalMs}ms` : `SSH 绘制 ${intervalMs}ms（未测到往返）`;
 }
 /** One incremental paint as a single stdout write (one SSH packet when corked). */
 export function composePaintOutput(options) {
@@ -994,10 +1022,58 @@ export function isEscapePrefix(text) {
         return true;
     if (/^\x1b\[\d+~?$/u.test(text))
         return true;
+    if (/^\x1b\[\d+(?:;\d+)?R?$/u.test(text))
+        return true;
     if (/^\x1b\[<(?:\d*;?)*[Mm]?$/u.test(text))
         return true;
     return false;
 }
+/** Parse a Device Status Report cursor reply (`CSI row;col R`). */
+export function parseCursorPositionReply(text) {
+    const match = /^\x1b\[(\d+);(\d+)R$/u.exec(text);
+    if (match === null)
+        return undefined;
+    return { row: Number(match[1]), column: Number(match[2]) };
+}
+/**
+ * Round-trip to the attached terminal via CSI 6n. Returns undefined when the
+ * reply never arrives (dumb pipe, blocked DSR). Does not interpret the
+ * coordinates — only the elapsed milliseconds matter.
+ */
+export async function probeTerminalRttMs(stdin = process.stdin, stdout = process.stdout, timeoutMs = DSR_PROBE_TIMEOUT_MS) {
+    if (!stdin.isTTY || !stdout.isTTY)
+        return undefined;
+    return await new Promise(resolve => {
+        let buffer = '';
+        let settled = false;
+        const started = Date.now();
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            stdin.removeListener('data', onData);
+            resolve(value);
+        };
+        const onData = (chunk) => {
+            buffer += chunk.toString('utf8');
+            if (parseCursorPositionReply(buffer) !== undefined) {
+                finish(Math.max(0, Date.now() - started));
+                return;
+            }
+            if (buffer.length > 32 && !buffer.includes('\x1b['))
+                finish(undefined);
+        };
+        const timer = setTimeout(() => finish(undefined), timeoutMs);
+        stdin.on('data', onData);
+        try {
+            stdout.write('\x1b[6n');
+        }
+        catch {
+            finish(undefined);
+        }
+    });
+}
 /** Parse a tool call's raw arguments JSON into an object; null when unparsable. */
 function parseJsonArgs(args) {
     try {
@@ -1839,6 +1915,8 @@ export class SshTui {
     lastPaintWidth = 0;
     lastPaintHeight = 0;
     paintIntervalMs;
+    paintLink = 'local';
+    paintProbed = false;
     searchHits = [];
     searchIndex = -1;
     searchQuery = '';
@@ -1864,7 +1942,10 @@ export class SshTui {
         this.presetId = config.presetId ?? 'standard';
         this.presetName = config.presetName ?? this.presetId;
         this.useAlternateScreen = process.env.DSH_TUI_NO_ALT_SCREEN !== '1' && process.env.DSH_TUI_NO_ALT_SCREEN !== 'true';
-        this.paintIntervalMs = resolvePaintIntervalMs(config.paintIntervalMs);
+        this.paintLink = detectSshSession() ? 'ssh' : 'local';
+        this.paintIntervalMs = resolvePaintIntervalMs(config.paintIntervalMs, process.env, {
+            ssh: this.paintLink === 'ssh',
+        });
         this.pushRow({ kind: 'brand-logo' });
         this.pushRow({ kind: 'system', text: 'DeepSeek Harness — SSH TUI' });
         this.pushRow({ kind: 'system', text: '输入 /help 查看快捷键 · /find 搜索思考/计划/子代理/回复 · 空输入时 ↑/↓ 选卡片' });
@@ -1873,7 +1954,6 @@ export class SshTui {
     start() {
         process.stdin.setRawMode(true);
         process.stdin.resume();
-        process.stdin.on('data', this.handleData);
         process.stdout.on('resize', this.markDirty);
         process.on('SIGWINCH', this.markDirty);
         this.disposers.push(this.ctx.on('session/event', this.handleSessionEvent), this.ctx.on('agent/status', this.handleStatus), this.ctx.on('agent/error', this.handleError), this.ctx.on('agent/disposed', this.handleDisposed), this.ctx.on('agent/inbox/claimed', this.handleInboxClaimed), this.ctx.on('agent/inbox/discarded', this.handleInboxDiscarded), this.ctx.on('agent/request', this.handleAgentRequest), this.ctx.on('subagent/start', this.handleSubagentStart), this.ctx.on('subagent/end', this.handleSubagentEnd), this.ctx.on('approval/request', this.handleApproval));
@@ -1887,6 +1967,30 @@ export class SshTui {
         if (this.resumePicker) {
             void this.runResumeCommand('', true);
         }
+        void this.calibratePaintInterval().finally(() => {
+            if (this.disposed)
+                return;
+            process.stdin.on('data', this.handleData);
+            this.startRenderTimer();
+        });
+        void this.maybeRunOnboarding().catch((error) => {
+            if (this.disposed)
+                return;
+            this.pushRow({ kind: 'error', text: `首次配置检查失败: ${errorChain(error)}` });
+            this.markDirty();
+        });
+        void this.syncSubagentToProvider(this.currentProviderId()).catch((error) => {
+            if (this.disposed)
+                return;
+            this.pushRow({ kind: 'error', text: `同步子代理模型失败: ${errorChain(error)}` });
+            this.markDirty();
+        });
+    }
+    startRenderTimer() {
+        if (this.renderTimer !== undefined) {
+            clearInterval(this.renderTimer);
+            this.renderTimer = undefined;
+        }
         this.renderTimer = setInterval(() => {
             const now = Date.now();
             if (this.agent.status === 'running')
@@ -1899,13 +2003,9 @@ export class SshTui {
             if (animating && now - this.lastPaintAt >= Math.max(this.paintIntervalMs, 200)) {
                 this.dirty = true;
             }
-            // While a turn is waiting on the provider with no new events, repaint at
-            // most once per second so slow SSH links do not drown in redraws.
             const idleWaiting = this.agent.status === 'running' && !this.dirty;
             if (idleWaiting && now - this.lastPaintAt < 1000)
                 return;
-            // Running with no fresh events only needs the seconds-bearing status
-            // line refreshed; force one repaint per second instead of every tick.
             if (this.agent.status === 'running' && !this.dirty && now - this.lastPaintAt >= 1000) {
                 this.dirty = true;
             }
@@ -1915,18 +2015,33 @@ export class SshTui {
             }
         }, this.paintIntervalMs);
         this.renderTimer.unref?.();
-        void this.maybeRunOnboarding().catch((error) => {
-            if (this.disposed)
-                return;
-            this.pushRow({ kind: 'error', text: `首次配置检查失败: ${errorChain(error)}` });
-            this.markDirty();
-        });
-        void this.syncSubagentToProvider(this.currentProviderId()).catch((error) => {
-            if (this.disposed)
-                return;
-            this.pushRow({ kind: 'error', text: `同步子代理模型失败: ${errorChain(error)}` });
-            this.markDirty();
+    }
+    async calibratePaintInterval() {
+        const envOverride = Number.parseInt(process.env.DSH_TUI_PAINT_MS ?? '', 10);
+        if (Number.isFinite(envOverride) && envOverride > 0) {
+            this.paintProbed = false;
+            this.pushRow({
+                kind: 'system',
+                text: `${paintLinkLabel(this.paintLink, this.paintIntervalMs, false)} · DSH_TUI_PAINT_MS`,
+            });
+            return;
+        }
+        if (this.paintLink !== 'ssh') {
+            this.pushRow({ kind: 'system', text: paintLinkLabel('local', this.paintIntervalMs, false) });
+            return;
+        }
+        const rtt = await probeTerminalRttMs();
+        if (this.disposed)
+            return;
+        this.paintProbed = rtt !== undefined;
+        this.paintIntervalMs = resolvePaintIntervalMs(undefined, {}, { ssh: true, rttMs: rtt });
+        this.pushRow({
+            kind: 'system',
+            text: rtt === undefined
+                ? paintLinkLabel('ssh', this.paintIntervalMs, false)
+                : `${paintLinkLabel('ssh', this.paintIntervalMs, true)} · 往返 ${Math.round(rtt)}ms`,
         });
+        this.markDirty();
     }
     /** Replay the durable session log so a resumed session renders its history. */
     replayHistory() {
@@ -2921,6 +3036,7 @@ export class SshTui {
             statusText += ' · Ctrl+T 折叠输入';
         if (this.pendingMessages.size > 0)
             statusText += ` · 排队 ${this.pendingMessages.size}`;
+        statusText += ` · ${this.paintLink === 'ssh' ? 'ssh' : '本机'}${this.paintIntervalMs}ms`;
         const idleMs = Date.now() - this.lastActivity;
         const livePlan = this.findLivePlanRow();
         const waitingQuestions = this.rows.some(row => row.kind === 'question' && row.status === 'waiting');
@@ -4732,6 +4848,8 @@ export class SshTui {
             this.markDirty();
             return;
         }
+        if (parseCursorPositionReply(combined) !== undefined)
+            return;
         if (combined === '\x1b[H' || combined === '\x1b[1~') {
             this.cursor = 0;
             this.markDirty();
@@ -5664,6 +5782,7 @@ export class SshTui {
                         `preset: ${this.presetName}`,
                         `subagents: ${this.activeSubagents.size}`,
                         `plan: ${plan === undefined ? 'off' : plan.pending ? 'pending' : plan.active ? 'on' : 'off'}`,
+                        `paint: ${paintLinkLabel(this.paintLink, this.paintIntervalMs, this.paintProbed)}`,
                         waiting > 0 ? `questions: waiting ${waiting}` : 'questions: none',
                     ];
                     this.pushRow({ kind: 'system', text: lines.join('\n') });