dsh-ssh-tui 0.3.1 → 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
@@ -35,6 +49,26 @@ Singles: [headless stdout](docs/screenshots/headless.png) · [dsh-ssh-tui](docs/
 
 ## Install
 
+On a remote box with `dsh` and pnpm already installed (no clone):
+
+```sh
+dsh plugin --profile tui add dsh-ssh-tui
+# optional: reuse a SuperGrok / grok-bridge token already on the machine
+dsh plugin --profile tui add github:cyjyyd/dsh-llm-xai-oauth
+dsh plugin --profile headless add github:cyjyyd/dsh-llm-xai-oauth
+```
+
+Smoke the route before opening the TUI. The TUI exits immediately without a TTY:
+
+```sh
+dsh --profile headless "Reply with exactly: tui-install-ok. Do not use tools."
+dsh --profile tui
+```
+
+From a checkout: `bash scripts/smoke-headless.sh` (prints an outcome summary, never a token).
+
+From git:
+
 ```sh
 git clone https://github.com/cyjyyd/dsh-ssh-tui.git
 cd dsh-ssh-tui
@@ -49,14 +83,6 @@ npm run build
 dsh plugin --profile tui add "link:$(pwd)"
 ```
 
-Or install the published npm package directly (requires `@deepseek-ai/dsh` and
-`pnpm`, no local clone needed):
-
-```sh
-dsh plugin --profile tui add dsh-ssh-tui
-# or from a repo checkout: bash scripts/install-npm.sh
-```
-
 For the optional **智能路由模式 (routing-suite)** mode, also run:
 
 ```sh
@@ -151,7 +177,7 @@ The plugin runs on Linux, macOS, and Windows (Node ≥ 22.19):
 | `Ctrl+R` | expand or collapse all cards |
 | `Ctrl+T` | fold the input box (display-only) |
 | `Alt+1` / `2` / `3` / `4` | jump to latest thinking / plan / subagent / reply |
-| `/find [kind] query` | search cards (`thinking` `plan` `subagent` `reply`). `Ctrl+/` or `Alt+/` opens it |
+| `/find [kind] query` | search and jump to the full matching message (`thinking` `plan` `subagent` `reply`). `Ctrl+/` or `Alt+/` opens it |
 | `Ctrl+G` / `Alt+N` | next search hit; `Alt+P` previous |
 | `Esc` | drop selection → scroll to bottom → cancel the running turn |
 | `Ctrl+C` | cancel the running turn; exit when idle |
@@ -195,7 +221,9 @@ into the parent stream.
 The plan strip pins only the **latest incomplete plan**. When the model
 opens a new plan in the same turn, the previous one archives into the
 scrolling transcript and the dock shows the new one. A finished plan says
-「计划任务已全部完成」, not 「计划模式已关闭」. The `/` menu and
+「计划任务已全部完成」, not 「计划模式已关闭」. If a turn ends with open todos, the strip says 「本轮未收尾」, stops
+spinning, and sends one follow-up asking the model to `todo_write` the
+real statuses. The `/` menu and
 approval/question dialogs yield that bottom space. `exit_plan_mode` is
 markdown. `ask_user_question` still opens a dialog and leaves a collapsed
 `提问用户` card. `/goal` is a collapsed `目标` card. `/find thinking foo`
@@ -309,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 120 ms. On high-RTT paths raise it:
-
-```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；
@@ -53,7 +61,25 @@ SuperGrok / X Premium 订阅走配套插件 [dsh-llm-xai-oauth](https://github.c
 
 ## 部署指南
 
-### 方式一：一键脚本（推荐）
+远程机器最短路径（已有 `dsh` 和 pnpm，无需 clone）：
+
+```bash
+dsh plugin --profile tui add dsh-ssh-tui
+# 可选：本机已有 SuperGrok / grok-bridge token 时
+dsh plugin --profile tui add github:cyjyyd/dsh-llm-xai-oauth
+dsh plugin --profile headless add github:cyjyyd/dsh-llm-xai-oauth
+```
+
+先确认链路再开 TUI（无 TTY 时 TUI 会直接退出）：
+
+```bash
+dsh --profile headless "Reply with exactly: tui-install-ok. Do not use tools."
+dsh --profile tui          # 必须在真实终端 / SSH 会话里
+```
+
+仓库内也可：`bash scripts/smoke-headless.sh`（记录出口摘要，不打印 token）。
+
+### 方式一：从 git clone 安装
 
 ```bash
 git clone https://github.com/cyjyyd/dsh-ssh-tui.git
@@ -79,14 +105,10 @@ npm run build
 dsh plugin --profile tui add "link:$(pwd)"
 ```
 
-### 方式三：npm 安装（发布后）
-
-前置要求：已全局安装 `@deepseek-ai/dsh`（`npm i -g @deepseek-ai/dsh`）且有 pnpm。
+### 方式三：指定其它 profile 的 npm 安装
 
 ```bash
-dsh plugin --profile tui add dsh-ssh-tui
-# 或在仓库内快捷执行：bash scripts/install-npm.sh
-# 指定其它 profile：bash scripts/install-npm.sh work
+bash scripts/install-npm.sh work
 ```
 
 `dsh plugin add` 会从 npm 拉取包、写入 profile 依赖，并自动把 `dsh-ssh-tui`
@@ -132,7 +154,7 @@ dsh --profile tui --no-color
 | `Ctrl+R` | 全部展开或全部收起 |
 | `Ctrl+T` | 折叠输入框（只影响显示） |
 | `Alt+1` / `2` / `3` / `4` | 跳到最新思考 / 计划 / 子代理 / 回复 |
-| `/find [类] 关键字` | 搜索卡片。类：`思考` `计划` `子代理` `回复`。`Ctrl+/` 或 `Alt+/` 打开 |
+| `/find [类] 关键字` | 搜索并跳到该条完整消息（反色高亮）。类：`思考` `计划` `子代理` `回复`。`Ctrl+/` 或 `Alt+/` 打开 |
 | `Ctrl+G` / `Alt+N` | 下一条搜索结果；`Alt+P` 上一条 |
 | 鼠标左键 | 点击卡片标题展开/收起 |
 | `PgUp` / `PgDn`、滚轮 | 转录回看 |
@@ -171,7 +193,9 @@ SuperGrok / X Premium 走本机 OAuth，不需要填 Key。`/status` 和底栏
 
 计划条只钉**最新一条未完成的计划**。同一轮次里模型再开新计划时，旧计划归档进
 工作区随转录上滚，底栏换成新计划。任务全部完成后计划条会说「计划任务已全部完成」，
-不再误报「计划模式已关闭」。打开 `/` 命令选单或批准/提问对话框时，计划条让出底栏。
+不再误报「计划模式已关闭」。一轮结束时若待办仍是进行中/待处理，计划条改成「本轮未收尾」并停止转圈，
+同时自动追问模型补一次 `todo_write`（同一列表只问一次，不改会话里的旧状态）。
+打开 `/` 命令选单或批准/提问对话框时，计划条让出底栏。
 `exit_plan_mode` 按 markdown 渲染。`ask_user_question` 仍弹对话框，并留下折叠的
 `提问用户` 卡片。`/goal` 是折叠的 `目标` 卡片。`/find 思考 padAnsi` 或 `Alt+1..4`
 可跳到对应类别的最新卡片。
@@ -274,10 +298,7 @@ npm run build
 - **标题栏或铃声不生效**：确认终端支持 OSC 0 与 BEL；铃声可用
   `DSH_TUI_NO_BELL=1` 关闭。
 - **滚轮误触取消**：已加入转义序列缓冲，网络拆包也不会把 `ESC` 当取消。
-- **跳板机 / 多层代理 SSH 发画**：每一帧只发脏行，并且拼成一次 `stdout.write`，避免一行一个 SSH 包。默认约 120 ms 合一帧。穿透代理、RTT 很大时：
-  ```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/cordis.patch.yml

@@ -81,4 +81,4 @@
         maxToolOutputLines: 6
         color: !!js ctx.sshTuiStartup.noColor !== true
         # Jump-host SSH: coalesce token ticks into one stdout write per frame.
-        paintIntervalMs: !!js Number.parseInt(process.env.DSH_TUI_PAINT_MS ?? '120', 10) || 120
+        paintIntervalMs: !!js Number.parseInt(process.env.DSH_TUI_PAINT_MS ?? '160', 10) || 160