dsh-ssh-tui 0.8.1 → 0.8.2

package/CHANGELOG.md

@@ -0,0 +1,158 @@
+# CHANGELOG
+
+面向用户的变更记录。每个版本的**发版说明**（含头等事、兼容矩阵与已知问题）在
+`docs/release-notes-<version>.md`；本文件只记一行一条的变更，按版本倒序。
+
+变更分类：**Added** / **Changed** / **Fixed** / **Removed** / **Docs** / **Internal**。
+
+> 本文件随包发布（`package.json` → `files`），发版说明也在包里（`docs/release-notes-*.md`）；
+> 指向 `docs/decisions/`、`docs/plans/`、`docs/checkpoints.md` 的链接是**仓库内**文档，只有 GitHub 上可读。
+
+---
+
+## 0.8.2 — 2026-10-05（`latest` + `next`）
+
+发版说明：[`docs/release-notes-0.8.2.md`](release-notes-0.8.2.md)；候选版说明保留在
+[`docs/release-notes-0.8.2-rc.1.md`](release-notes-0.8.2-rc.1.md)。
+本版由 **0.8.2-rc.1**（2026-10-04，只上 `next`）沉淀一周后转正，**内容与候选版相同**，
+下列变更即候选版以来累积的全部变更。
+
+> `dsh-ssh-tui` is now presented as DSH Relay. The npm package name and the install command
+> have not changed. —— `dsh-ssh-tui` 现在以 DSH Relay 为产品名展示；包名与安装命令没有变化。
+
+B2（"what deserves to exist"）的六个阶段 B2.1 – B2.6 已完成并通过最终审计，本节汇总用户能看到的
+部分。详细证据与冻结记录见 [`docs/checkpoints.md`](checkpoints.md) 与
+[`docs/decisions/b2-architecture-decisions.md`](decisions/b2-architecture-decisions.md) §20。
+
+### Added
+
+- **报告是 Screen**：`/status`、`/help`、`/doctor`、`/subagents`、`/diag` 等报告不再写进转写、
+  不再改变历史窗口，翻页只重画正文区，Esc 回到原处。
+- **计划 artifact 投影**：计划模式下的待办与评审从会话日志折叠出来；一份计划一行引用、一个 dock、
+  一个评审 Surface，resume 后身份一致。
+- **工具卡片的审批状态**：卡片自己拥有 `waiting / approved / rejected / unknown`（以及来源：
+  live / policy / durable / inferred）；不再有独立的审批行。
+- **首启向导是 Screen**：9 步向导不再是"借工作区 composer 的对话框"，中途 detach/reattach 不丢步骤，
+  也不再清空读者已经打了一半的草稿。
+- **`npm run freeze`**：一条命令跑完 B2 的八条冻结不变量与七条退役路径扫描（CI 在 Linux 与
+  Windows 两条腿上各跑一次）。
+- **`npm run bench`**：五个动作（流式 delta / 等待时钟 / 报告翻页 / 菜单移动 / 向导打字）的性能基线，
+  并断言这五个动作都不整屏重画。
+
+### Changed
+
+- **反馈分流**：控制面的确认去页脚（echo，最低优先级，直到下一次输入），警告/失败去身份行（notice），
+  只有会改变历史的事实才进转写（[`docs/checkpoints.md`](checkpoints.md) B2.3b）。
+- **`/copy` 语法**：`/copy` 或 `/copy reply` 复制模型最后一条回复（默认）；`/copy highlight` 复制焦点卡片；
+  `/copy error` 复制最新的错误/诊断行。复制键保留"取不到焦点就退回回复"的语义。
+- **工作区在方向键后的停留**：resume 进来不再从窗口中间开始滚动，直接停在最新内容。
+
+### Fixed
+
+- **工具卡内容有多行代码时会窜到输入区**。`bash` 的摘要就是命令行原文，所以 heredoc 会带着换行进入
+  卡片标题行；而单行裁剪器（`truncateToWidth`）保留 LF/CR，于是一"行"里含多个换行 —— 终端会因此换行，
+  而按绝对行号定位的帧随后把下面每一行都写错位，卡片内容落到输入框和页脚上，还会出现两段文字拼在同一行。
+  实测：31 行的一帧里有 11 行含裸换行；修复后为 0。
+- **Windows Terminal 下输入法的预输入字符不再在处理中卡片那一行的最右边闪烁**。终端把 IME 预输入画在
+  光标处，而写一行会把光标留在该行文本末尾；跑一轮时实时区域每 tick 重画、且位于输入框上方，于是光标停在
+  处理中卡片上、预输入就闪在那里。现在除光标自己所在行外，每写一行都把光标交还输入框。
+- **命令提示不再一直占着位置**：确认（"已复制 412 字"）与警告（命令失败）显示 6 秒后自动让位、恢复原来的
+  遥测行（提交仍会立即清掉）；**"将在下个步骤生效"的排队提示例外** —— 它显示到那条消息真正被提交为止，
+  因为它是"你有话在排队"的唯一标记。
+- **全新安装不再跳过配置向导**。前端拉起后台 Host 时永远带 `--resume=<id>`（连它刚生成的新 id 也带），
+  而首启判定把 `resume` 当成"这台机器配置过"，于是**新机器永远不会自动出现向导**，也没有任何提示。
+  判定现在只看凭据存不存在。
+- **裸 400 现在会说明它是什么**：网关拒收的是请求本身（不是 key），并给出这一族的上游记录与绕法
+  （`/effort off` 或换 messages 风味路线）；**不自动重试**（实测这类失败成串出现，重发由读者决定）。
+- 流式输出不再每个 tick 整屏重画（B2.2：live 区是投影，不是转写行）。
+- 高亮的工具卡片不再把内容画进相邻卡片；处理中卡片遇到长内容不再折断成一行。
+- 计划卡不再吃掉输入法的预输入字符（dock 高度不得超过工作区一半，光标行永远在屏）。
+- resume 的历史回放不再逐帧重画（20k 事件从 51 帧 / 1.2 s 降到一次重建）。
+- 部分命令执行后没有任何提示（页脚放不下的确认现在退到身份行显示）。
+- 待办未收尾的提醒不再伪装成一条"计划转写引用"（B2 最终审计：`plan-row` → `plan-notice`）。
+- **resume 进入时不再有一段黑屏（1–3 秒）**：前端先在备用屏打出"正在载入历史会话…"，relay 接入时
+  宿主又写了一次 `?1049h` —— 终端已在备用屏时这个序列会**清屏**，而回放期间按 B2.4 不合成任何帧，
+  于是读者面对的是一块空白，直到日志重建完（实测 20k 事件：9.1 s 清屏、12.6 s 首帧，中间 3.5 s 全黑）。
+  这条"进屏"序列现在搭在第一帧上发出，与它要清出来的内容同一个 tick；没有东西要等的 reattach 行为不变。
+  （上一版试过相反的做法 —— 加载期间由宿主补画一行 —— 结果写进了 relay 的测速窗口，那版已回退。）
+- **思考卡片的文字不再发白**：`reasoning` 角色是 `2;3`，只有属性 —— "暗"完全靠 faint，不实现 faint 的
+  终端（报告的 256 色终端）就退回**默认前景色**，与旁边的回复一样亮。四个调色板现在各自给出 muted 颜色
+  （default `90`，catppuccin / gruvbox 用各自 `md-muted` 的色，mono 仍然只用属性），属性保留给支持的终端。
+- **状态行不再把"绘制节奏"当成"链路延迟"**：终端不回 `CSI 6n` 时（现场 `/diag`：Linux + xterm-256color
+  + SSH，`探测 未知`），这一格显示的是**回退的绘制节奏** 160ms，读者无法分辨它和真实延迟。现在改为
+  `SSH ○○○○ 未测` / `n/a`；测到过的链路照旧显示测量值，绘制节奏仍留在 `/diag` 那一行（写明是"绘制"）。
+- **`q` / `Q` 真的能关掉报告**：`inspectClosesOn` 一直声明接受它们（"全屏报告理应响应 q"），
+  但可打印字符的提示分支在它之前返回，于是这两个键只会打印"这是报告视图，按 Esc 返回"。
+
+### Docs
+
+- [`docs/release.md`](release.md) 新增"发布前人工门槛"：Windows 实机清单、fresh-home 首启探针命令、
+  以及 `npm run freeze` / `npm run bench` 两条发版自检。
+- [`docs/decisions/b2-architecture-decisions.md`](decisions/b2-architecture-decisions.md) §20 记录 B2 冻结：
+  八条不变量、七条退役路径、以及"表示的分类必须与它包裹的行一致"这条规则。
+
+### Internal
+
+- **链路验收补齐"带历史的 resume"**：`scripts/tui-rtt-probe.mjs` 现在有两个阶段——新会话（先慢后快的
+  链路）与**带历史的 resume**（探针自己写一份 20k 事件的持久化日志，回放期间不合成帧）。后者同时断言
+  三件事：读者画面上出现过加载行之后**不得再变空**、转写落地、chip 落在真实测量值而不是 `○○○○ 160ms`
+  占位。两条断言都做过变异校验（改回"接入即写"报 4 秒黑屏；关掉 RTT 应用报 chip 停在占位）。
+- **`verify-batch.mjs` 不再把 SKIP 说成 PASS**：有步骤跳过时收尾为 `RESULT: INCOMPLETE`（exit 2），
+  与 `FAIL`（exit 1）分开；`link` 已加入验收步骤表（`--only link` 可单跑）。
+- 表示管线：每条转写行都带 durability / class / destination；审计对未分类行、未知 destination、
+  live 源行与重复 primary 表示各自计数，四个数字都必须为 0。
+- 退役并在 CI 上禁止复活：`dedicated` Surface 角色、onboarding 的对话框渲染路径、
+  `upsertPlanRow`（计划行的第二个写入者）、`ask_user_question` 的通用工具卡。
+- **Windows 实机轮（2026-10-03）修掉五处探针缺陷，产品代码未改**：`verify-batch` 在 Windows 上
+  因 `spawn('npm')` 必然 `ENOENT`（改用 `$npm_execpath`）；`tui-route-probe` 的 `/tmp` 字面量
+  （改 `os.tmpdir()`）与目录符号链接（Windows 改 junction）；`footer-windows-probe` 补了**未测量
+  链路**档案并逐格断言时长槽（`未测` 而非 `160ms`）；`tui-mock-probe` 的鼠标坐标改由真实终端网格
+  给出（此前从字节流解析 `ESC[<row>;1H`，ConPTY 下拼出伪行，拖选看起来偏了两格——**是探针缺陷，
+  不是选择缺陷**）。
+- **新增 `scripts/tui-unmeasured-probe.mjs`**（管道父进程，进 `verify-batch` 与 CI）：ConPTY 自己回
+  `CSI 6n`，所以"终端不回 DSR"这一格在 Windows 本机摸不到，而这个形状正是读者报过两次的那个。两条腿
+  分别断言 `SSH ○○○○ 未测`（绘制节奏只留在 `/diag`）与 `SSH ●●●● <n>ms`。
+- **ConPTY 盲区改为显式 `SKIP:`**（不再是"读错就判红"）：`tui-cut-probe` 的静默半场、
+  `tui-rtt-probe` 的慢链路半场、`tui-setup-probe`/`--line-mode` 的字节形状检查。SKIP 仍收尾
+  `INCOMPLETE`。真实 home 未配置时（会进配置向导）同样 `SKIP:` 而不是超时报红；
+  `verify-batch --home <dir>` 可把读 profile 的三步指向自建 home。
+
+### 已知问题
+
+- **0.8.2-rc.1 → 0.8.2 无代码变更**：转正只改版本号与发版材料，包内 `lib/` 与候选版逐字节相同
+  （候选版沉淀期间未收到新的回归报告）。
+- Windows / ConPTY **实机人工验收已完成**（2026-10-03，维护者逐条走过 12 项清单，结论见
+  [`docs/checkpoints.md`](checkpoints.md)「Windows 实机轮」）：可自动化的部分由 `verify-batch --home
+  <dir>` 覆盖（12 PASS · 2 SKIP · 0 FAIL），**没有自动化、只能人眼的两目（输入法组合、多行中文粘贴）
+  已确认通过**。两处 `SKIP` 是覆盖边界、不是通过：ConPTY 自己回 `CSI 6n`，"慢链路"与"静默但没断连"
+  这两个形状它扮演不了（这两个形状在 Linux 腿上真跑）。
+- fresh-home 首启有两条探针覆盖（`scripts/tui-setup-probe.mjs` 断言向导自动出现 + 第二次启动不再出现；
+  `scripts/probe-onboarding.mjs` 供工作区探针识别"这是首启"并 `SKIP:` 而不是误报），命令在
+  [`docs/release.md`](release.md)。只读 pnpm store 的沙箱建不出 home，那是环境限制，不是覆盖缺口。
+- ~~`scripts/tui-drop-probe.mjs` 约 1/7 概率因自身的 `/status` 重试竞态误报~~ —— **本版已修**：
+  改为一次请求在飞、按每次请求的输出判定、并按"当前是否真有 Screen"决定关闭，连跑 20 次无失败。
+- 打包：`npm pack --dry-run` 实测 **243 个文件 / 1.4 MB（tarball）/ 解包 4.2 MB**，CHANGELOG 随包发布；
+  无凭据、无 home、无 sqlite、无 scratch。
+
+---
+
+## 0.8.1 — 2026-09-30（`latest` + `next`）
+
+发版说明：[`docs/release-notes-0.8.1.md`](release-notes-0.8.1.md)。
+
+### Fixed
+
+- 没有终端的进程（桌面版 Electron-as-Node、管道、cron）不再抛错退出，而是保持惰性：不取锁、
+  不装定时器、不查更新，记一行说明，退出码 0。
+
+### Added
+
+- `DSH_TUI_DISPLAY=stdio`（或 `--display stdio`）：宿主自带终端控件时可以把 TUI 当子进程用，
+  画面走 stdout、按键走 stdin、尺寸由 `CSI 8 ; rows ; cols t` 报告。
+
+---
+
+## 0.8.0 — 2026-09-29（`next`，随后提升为 `latest`）
+
+发版说明：[`docs/release-notes-0.8.0.md`](release-notes-0.8.0.md)。基线切到上游 `0.2.0-rc` 线
+（桌面版 Harness 的基线），兼容窗口与 CI 腿随之上移。

package/README.en.md

@@ -1,17 +1,52 @@
-# dsh-ssh-tui
+# DSH Relay
 
 [![npm](https://img.shields.io/npm/v/dsh-ssh-tui?style=flat-square&color=4b6fff)](https://www.npmjs.com/package/dsh-ssh-tui)
 [![npm downloads](https://img.shields.io/npm/dm/dsh-ssh-tui?style=flat-square)](https://www.npmjs.com/package/dsh-ssh-tui)
 [![CI](https://github.com/cyjyyd/dsh-ssh-tui/actions/workflows/ci.yml/badge.svg)](https://github.com/cyjyyd/dsh-ssh-tui/actions/workflows/ci.yml)
 [![dshfind](https://dshfind.com/api/badge/cyjyyd/dsh-ssh-tui)](https://dshfind.com/en/plugins/cyjyyd/dsh-ssh-tui?ref=badge)
 
-A DeepSeek Harness terminal for jump hosts, headless servers, and high-latency
-SSH. Plain ANSI and incremental redraws. No browser required. **When the SSH
-session drops mid-turn, the Host keeps the turn; reconnecting with the same
-command attaches back to it, so the session is not lost.**
+**A resilient terminal workspace for DeepSeek Harness.**
+remote-first · reconnectable · in your terminal
+
+**SSH drops. The session survives.**
+**Reconnect. Reattach. Continue.**
+
+That is the whole idea behind the name: the *display* can disappear without the
+*session* disappearing. The host process stays up, and the same command attaches
+back to the same session — transcript, plan cards, approvals, queued messages, all
+where you left them. It is a remote-first terminal workspace, not just an
+SSH-flavoured screen.
+
+> **What happens to the turn that was running? That depends on `/disconnect`:**
+> the default `pause` stops the in-flight turn when the display goes away and keeps
+> the session — you reconnect and carry on; `continue` lets that turn keep running
+> in the background and finish without you. The host survives under both. The demo
+> below runs `continue` (the caption says so); do not read it as the default.
+
+> **The npm package name has not changed, and neither has the install command.**
+> The published coordinate is still `dsh-ssh-tui`; `DSH Relay` is the product's
+> display name. See [`docs/decisions/brand-dsh-relay.md`](docs/decisions/brand-dsh-relay.md).
+
+```bash
+npm i -g @deepseek-ai/dsh
+dsh plugin --profile tui add dsh-ssh-tui@latest
+dsh --profile tui
+```
+
+Reconnect with `dsh --profile tui --resume`.
+
+![Reconnect demo: a turn streams, the window is closed, the host keeps running, the same command attaches back, and the session is where it was; the demo runs the continue policy, so that turn also finished in the background](docs/screenshots/reconnect.gif)
+
+*Recorded, not staged: a real PTY, a real host, a real SIGHUP, a real resume
+(`npm run screenshots:reconnect` regenerates it). The demo sets `/disconnect
+continue`, which is why the turn finishes on screen after the window is gone; under
+the default `pause` the same run would stop mid-turn and the session would still be
+there to attach back to.*
 
 中文部署指南：[README.md](README.md)
 
+Plain ANSI and incremental redraws. No browser required.
+
 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.
@@ -47,7 +82,7 @@ dsh --profile tui
 Current `dsh` requires `--profile` (`dsh plugin add …` errors without it).
 Swap `tui` for another profile name.
 
-**On the 0.2.0-rc host line?** 0.8.0 is the release that supports it (older versions are refused by the launcher's version check), but it is published under `next` for now — `latest` is still 0.7.4 until 2026-10-01. Until then install with `dsh plugin --profile tui add dsh-ssh-tui@next`; on the 0.1.7-rc line `@latest` (0.7.4) is enough, and moving to 0.8.0 later costs nothing. **0.1.5 and older hosts are no longer supported as of 0.8.0.**
+**Which host line?** `0.8.1` is `latest` and supports the `0.2.0-rc` line (the desktop harness's baseline) as well as `0.1.7-rc`; older releases are refused by the launcher's version check. **0.1.5 and older hosts are no longer supported as of 0.8.0.**
 
 **Updates must use `@latest`.** `dsh plugin` forwards the rest of the line to
 pnpm in the profile directory. A bare `add dsh-ssh-tui` keeps the version
@@ -55,6 +90,40 @@ already pinned in `pnpm-lock.yaml` (often 0.3.7). Do not put `--profile`
 after `add`: `dsh plugin add --profile tui add dsh-ssh-tui` is not valid.
 Remove with `dsh plugin --profile tui remove dsh-ssh-tui`.
 
+## Verified, not assumed
+
+<!-- bench:begin -->
+Measured on 100×20, median of 40 runs per action (`npm run bench`; this block is
+generated by `npm run bench:report`, not typed by hand):
+
+| Action | ms | bytes | rows addressed | full clears |
+|---|---|---|---|---|
+| one streamed delta while an answer is arriving | 1.64 | 501 | 3 | **0** |
+| one repaint while the agent is busy (the wait card’s clock) | 1.28 | 465 | 3 | **0** |
+| one page key inside a report Screen (PgDn, then PgUp) | 1.41 | 2457 | 17 | **0** |
+| one cursor key inside an open control-plane menu (↓, then ↑) | 1.27 | 588 | 4 | **0** |
+| one character into the wizard’s own field | 0.38 | 140 | 1 | **0** |
+
+**0 full-screen clears** across all five actions. That is the performance promise for this
+version: however slow the terminal and however bad the link, frames repaint by row — no tick
+repaints the whole screen.
+<!-- bench:end -->
+
+Both commands above are the evidence: `npm run bench` (the numbers), `npm run freeze`
+(that the architecture stayed what it claims). CI re-runs them on every leg — Linux and
+Windows, four host versions. The link-side promises have their own real-PTY probes:
+drop/reattach, a host that outlives the window mid-turn, a resume with history, and the
+"terminal does not answer cursor probes" case; `npm run freeze` lists them.
+
+**Tested DSH Relay on a terminal we have not covered yet?**
+[Add a compatibility report](https://github.com/cyjyyd/dsh-ssh-tui/issues/new?template=terminal-compatibility.yml) — one
+form, no code required; results land in the community section of
+[`docs/terminals.md`](docs/terminals.md).
+
+If DSH Relay makes remote Harness sessions more reliable for you,
+[starring the repository](https://github.com/cyjyyd/dsh-ssh-tui) helps other terminal
+users find it.
+
 ## Official headless vs this TUI
 
 There is no shipped TUI. The default terminal entry on a remote box is
@@ -92,8 +161,13 @@ OSC 52 into your local clipboard; a tool card still expands on click; an SSH ses
 into the local terminal and no longer warns that it cannot) · a reply is a selectable card too:
 one `↑` on an empty input lands on the newest reply-or-card (marked `▶`, in screen order;
 `Alt+4` selects the latest reply), `/copy` then takes that one as written rather than the
-wrapped screen text, and `Enter` opens it full-screen · the footer is one priority-ordered chip
-strip, and `⚠` opens `/doctor` · the quota bar is on screen from the first frame and names
+wrapped screen text, and `Enter` opens it full-screen · the status row answers five questions
+in one order — link health, what is running, tokens per second, quota left, context used — and
+degrades by dropping cells as the terminal narrows (`⚠` still opens `/doctor`; the install
+warning outranks everything), and the row under it is *ordered* by priority and cut from the
+right — `dir:… · search n/m · queued n · sub:…`, closed by `OpenCode-GO` or
+`CommandCode-GOAT` on those two subscriptions, so a narrow terminal loses the least
+load-bearing part first · the quota meter is on screen from the first frame and names
 its window (`5Hr`/`1Wk`/`1Mo`, smallest window by default, `?%` with a 15-second retry until
 a reading arrives) · `/mode` groups presets and filters with `/` · the compact view names
 every changed file · tool diffs are line-level, emphasise only what changed, and go
@@ -117,6 +191,19 @@ suite and the real-PTY probes — not "no errors, so it probably works". Many te
 stranded on the 0.1.5 line; few terminal UIs install on the 0.2.0-rc line at all, which is why the window is
 maintained this tightly.
 
+## A warning before the Desktop section
+
+> ⚠ **Do not add this plugin to a Desktop (or `web`) profile.** It is not "installed but
+> idle" — it crashes the application. The desktop host's command line belongs to the web
+> app (it passes `--no-open`), and dsh does not arbitrate: every app plugin parses the
+> same argv with *its own* grammar, and an unknown flag exits the process. From 0.8.2 the
+> plugin's startup row declines a command line that is not its own (the desktop launcher,
+> or a web app that has already taken over); 0.8.1 and earlier exited 1 with
+> `error: unknown option '--no-open'`, and the app reported
+> `dsh desktop host exited with 1` and died. If it is already in there, remove the four
+> `ssh-tui-*` rows from `profiles\desktop\cordis.patch.yml` (or restore that file from a
+> backup) and the application works again.
+
 ## Desktop Harness users, read this first
 
 **The official desktop app (<https://www.deepseek.com/harness/>) does not need this plugin** — use its own UI
@@ -463,11 +550,14 @@ model, and sends unrecognized shapes (`npm publish`, interpreter `-c`/`-e`)
 to the subagent-model reviewer (user message + args/reason/sandbox; English
 UI uses the English reviewer; `authorization=yes` required). `/approval
 status` also reports how many AI reviews ran this session.
-The identity footer row shows a one-cell Braille ring after the
-remaining-quota bar for occupancy of the routed model's context window
-(DSH `contextPressure`, provider-agnostic); green / yellow / red map
-to ok / 80% / 95%.
-`/status` prints the same figures. Warnings fire near 80%/95%; idle
+The status row shows context occupancy as a capacity meter over the routed
+model's context window (DSH `contextPressure`, provider-agnostic); the bands are
+the harness's own pressure levels, so 80% turns the meter yellow and 95% red —
+exactly where compaction starts warning.
+`/status` prints the same figures, plus everything the row gave up: turns,
+steps, input/output/cached tokens, the session total (with the accounting it
+came from), model time, tool time, cache hit and the exact last-step and
+running `tokens/sec`. Warnings fire near 80%/95%; idle
 auto-`/compact` starts near 72% so recovery is not left to a mid-turn
 overflow. `/compact` shows a spinning compact card and footer until it
 finishes, then the tokens recovered. `Tab` completes, `Enter` runs.
@@ -720,8 +810,10 @@ at the slowest tier. `DSH_TUI_PAINT_MS` always wins (40–1000). The stats line
 starts with `SSH ●●●○ 90ms` (1 pip red, 2 yellow, 3+ green). The probe
 does not write into the transcript.
 
-Idle hangup exits the Host. A busy turn keeps it; `--resume` attaches to that
-process. Do not start a second Host.
+Idle hangup exits the Host. A *busy* session keeps the Host alive so you can attach
+back; whether the turn itself keeps running across the gap is the `/disconnect`
+policy (`pause` stops it by default, `continue` finishes it in the background).
+`--resume` attaches to that process. Do not start a second Host.
 
 ## Troubleshooting (Q&A)
 
@@ -891,8 +983,19 @@ src/i18n/                 zh/en UI catalogs
 ```sh
 npm install
 npm run build
+npm test
+```
+
+Two commands that do not ask "is anything broken" but "is anything still held":
+
+```sh
+npm run freeze   # the B2 freeze: eight invariants + seven retired paths (unclassified / live source rows / …)
+npm run bench    # the perf baseline: stream / wait / report paging / menu move / wizard typing, all incremental
 ```
 
+The release rules — including the two things CI cannot cover (a Windows machine, and a
+first-run home) — are in [docs/release.md](docs/release.md) (Chinese).
+
 ## Privacy
 
 All sessions, credentials, and settings live under `$DSH_HOME` (default

package/README.md

@@ -1,23 +1,26 @@
-# dsh-ssh-tui
+# DSH Relay
+
+**A resilient terminal workspace for DeepSeek Harness.**
+远端优先 · 可重连 · 就在终端里
 
 [![npm](https://img.shields.io/npm/v/dsh-ssh-tui?style=flat-square&color=4b6fff)](https://www.npmjs.com/package/dsh-ssh-tui)
 [![npm downloads](https://img.shields.io/npm/dm/dsh-ssh-tui?style=flat-square)](https://www.npmjs.com/package/dsh-ssh-tui)
 [![CI](https://github.com/cyjyyd/dsh-ssh-tui/actions/workflows/ci.yml/badge.svg)](https://github.com/cyjyyd/dsh-ssh-tui/actions/workflows/ci.yml)
 [![dshfind](https://dshfind.com/api/badge/cyjyyd/dsh-ssh-tui)](https://dshfind.com/zh/plugins/cyjyyd/dsh-ssh-tui?ref=badge)
 
-**A resilient terminal frontend for DeepSeek Harness.**
-
-纯 ANSI · 增量重绘 · SSH 断线重接 · Windows / ConPTY · Host-aware activation · 无需浏览器
-
-**连接可以断，终端可以换，Harness 可以升级；正在工作的会话不应该因此变得脆弱。**
-
-English: [README.en.md](README.en.md)
+**SSH 断了。会话还在。接回来继续。**
 
----
+“Relay” 说的是这件事：**显示可以消失，会话不必跟着消失**。宿主进程活着，同一句命令接回来
+就回到原来的会话 —— 转写、计划卡片、审批、排队中的消息都在原处。
+这是远程优先的终端工作区，不只是“一个 SSH 风格的界面”。
 
-## 30 秒开始
+> **断线时正在跑的那一轮会怎样？取决于 `/disconnect`：**
+> 默认 `pause` —— **当前这一轮在窗口离开时停下**，会话本身不丢，接回来接着用；
+> 显式设成 `continue` —— 当前这一轮在显示端离开后**继续在后台跑完**。
+> 两种策略下宿主都不退出。演示动图用的是 `continue`（字幕里标了），别把它当成默认行为。
 
-需要 Node.js ≥ 22.19 和 DeepSeek Harness CLI。
+> **npm 包名没有变，安装命令也没有变。** 发布坐标仍然是 `dsh-ssh-tui`；
+> `DSH Relay` 是产品展示名。见 [`docs/decisions/brand-dsh-relay.md`](docs/decisions/brand-dsh-relay.md)。
 
 ```bash
 npm i -g @deepseek-ai/dsh
@@ -25,6 +28,51 @@ dsh plugin --profile tui add dsh-ssh-tui@latest
 dsh --profile tui
 ```
 
+需要 Node.js ≥ 22.19 和 DeepSeek Harness CLI。断开之后接回来：`dsh --profile tui --resume`。
+
+![重连演示：一轮正在流式输出时窗口关闭，宿主进程不退出，同一条命令接回来，这个会话还在原处；演示用 continue 策略，所以这一轮也在后台跑完了](docs/screenshots/reconnect.gif)
+
+*实拍，不是摆拍：真 PTY、真宿主、真 SIGHUP、真 resume（`npm run screenshots:reconnect` 可重放）。
+演示显式设了 `/disconnect continue`，所以画面上这一轮在窗口消失后跑完了；换成默认的 `pause`，
+同一段会停在中断处，会话照样接得回来。*
+
+English: [README.en.md](README.en.md)
+
+---
+
+## 已测，不是号称
+
+<!-- bench:begin -->
+在 100×20 下实测，每个动作 40 次取中位（`npm run bench`；本节由 `npm run bench:report` 生成，
+不是手抄的）：
+
+| 动作 | 毫秒 | 字节 | 寻址行 | 整屏清屏 |
+|---|---|---|---|---|
+| 流式输出时的一次重绘 | 1.64 | 501 | 3 | **0** |
+| 等待卡片时钟走一格 | 1.28 | 465 | 3 | **0** |
+| 报告屏翻一页（PgDn / PgUp） | 1.41 | 2457 | 17 | **0** |
+| 菜单里移动一次光标 | 1.27 | 588 | 4 | **0** |
+| 向导字段里打一个字符 | 0.38 | 140 | 1 | **0** |
+
+五个动作合计 **0 次整屏清屏**。这条是这一版的性能承诺：不管终端多慢、链路多差，
+画面按行增量重绘，不会因为一次 tick 把整屏重画一遍。
+<!-- bench:end -->
+
+跑法就是上面两条命令；这两条断言在 CI 的每一条腿上都会重跑（Linux 与 Windows、四个宿主版本）。
+链路上的承诺另有真 PTY 探针：断链重接、断线后宿主存活、带历史的 resume、以及"终端不回光标位置"
+时的链路显示，各自一个脚本，全部在 CI 里跑（`npm run freeze` 会把它们列出来）。
+
+**你在我们没覆盖过的终端上试过 DSH Relay 吗？**
+[提一份终端兼容报告](https://github.com/cyjyyd/dsh-ssh-tui/issues/new?template=terminal-compatibility.yml) —— 不用读代码，填一张表就行，
+结果会进 [`docs/terminals.md`](docs/terminals.md) 的「社区实测」区。
+
+如果 DSH Relay 让你的远程会话更可靠了，
+[给仓库点个 star](https://github.com/cyjyyd/dsh-ssh-tui) 能帮别的终端用户找到它。
+
+## 30 秒开始
+
+上面三条命令装好就进工作区。之后常用的几条：
+
 恢复旧会话：
 
 ```bash
@@ -196,7 +244,7 @@ docs/screenshots/slow-link.json
 - reasoning 折叠与实时查看；
 - plan / approval / ask-user-question；
 - 子代理独立状态卡；
-- 会话 token、速度、额度与活动状态；
+- 状态行按一眼扫读的顺序回答五个问题：链路健康、正在做什么、tok/s、额度余量、上下文占用（宽度不够时按优先级逐项收敛，窄屏更简洁而不是更拥挤）；轮数 / 步数 / 模型时间 / 工具时间 / 缓存命中移出常驻行，仍可在 `/status` 与 `/diag` 查看；
 - `/model`、`/mode`、`/submodel` 等 Harness 能力直接进入终端。
 
 ### Session continuity
@@ -237,7 +285,8 @@ docs/screenshots/slow-link.json
 - 调工具；
 - 运行子代理；
 
-TUI 可以保留 Host，并允许重新接入。
+TUI 可以保留 Host，并允许重新接入（保留的是**宿主**；这一轮本身是否在断线期间继续跑，看
+[`/disconnect`](#ssh-断了之后) 的策略）。
 
 ```bash
 dsh --profile tui --resume
@@ -295,6 +344,14 @@ dsh --profile tui
 
 ## 官方 Harness Desktop
 
+> ⚠ **不要把本插件加进 Desktop（或 `web`）profile。** 这不是"装了没用"，是**会让应用崩**：
+> Desktop 的宿主命令行走的是 web app 的语法（它传 `--no-open`），而命令行在 dsh 里没有仲裁——profile 里每个 app
+> 都会用**自己的**语法解析同一份 argv，遇到不认识的旗标直接退出进程。0.8.2 起本插件的 startup 行会在识别到
+> "这条命令行不属于我"（Desktop 启动器，或 web app 已接管）时**不认领**它；0.8.1 及更早则会以
+> `error: unknown option '--no-open'` 让宿主退出 1，应用随即报 `dsh desktop host exited with 1` 并崩。
+> 万一已经加进去了：从 `profiles\desktop\cordis.patch.yml` 里删掉 `ssh-tui-startup` / `ssh-tui` /
+> `ssh-tui-routes` / `ssh-tui-subagent` 四行（或从备份恢复该文件），应用立刻恢复。
+
 官方 Desktop 是 GUI 应用，本身**不需要这个 TUI**。
 
 Desktop 内部的 Harness Host 和真正的 console runtime 也不是一回事。
@@ -498,6 +555,13 @@ npm run build
 npm test
 ```
 
+两条不跑"有没有坏"、而跑"有没有守住"的命令：
+
+```bash
+npm run freeze   # B2 冻结：八条不变量 + 七条退役路径（unclassified / live source rows / …）
+npm run bench    # 性能基线：流式 / 等待 / 报告翻页 / 菜单移动 / 向导打字，并断言都不整屏重画
+```
+
 真实终端、断线与平台行为由额外 probe 覆盖。
 
 项目的目标不是让模拟测试代替终端，而是让：
@@ -522,6 +586,7 @@ cross-platform CI
 | [remote-ops.md](docs/remote-ops.md) | SSH、断线、attach、Host 生命周期 |
 | [desktop.md](docs/desktop.md) | 官方 Harness Desktop / no-TTY Host |
 | [platform.md](docs/platform.md) | 平台生命周期设计与维护者约束 |
+| [release.md](docs/release.md) | 发版流程（硬性规则）与发布前人工门槛 |
 | [terminals.md](docs/terminals.md) | Terminal capability 与兼容矩阵 |
 | [upstream-desktop-report.md](docs/upstream-desktop-report.md) | 可复现的上游 Desktop 问题记录 |
 

package/docs/release-notes-0.7.4.md

@@ -0,0 +1,91 @@
+# 0.7.4 发版说明（草稿）
+
+> **状态：未发版。** 版本号、tag、GitHub Release、npm 都还没动（`docs/release.md` 第 1 条）。
+> 本文件是发版时要粘进 GitHub Release 的正文草稿 + 当次核对清单，写完就不必临场回想。
+> 上一次发版：**0.7.3**（2026-09-24，commit `e505768` / tag `v0.7.3` / npm `latest`+`next`）。
+
+## 头等事
+
+这一版是「把已经做出来的东西做对」：0.7.3 之后落的六个功能各自被真机与对抗式审查拧了一遍，
+修掉了 8 个实际缺陷（含两个只有读代码才看得见的：现场思考卡被挤出焦点环、覆盖层里的复制
+拿到的是另一份正文）。行为上最明显的变化是**回复变成了可选中的卡片**。
+
+## 回复可以选中、可以复制（本版主线）
+
+`/copy` 取的是"被选中的那一行"，而可选列表里**从来没有回复**——所以只要按过一次 ↑/↓ 选中
+任何卡片，`/copy` 就再也拿不到回复，最新回复只是"没有选中时"的兜底。现在：
+
+- 空输入 `↑`/`↓` 在**回复与卡片**之间按屏幕顺序走，选中的那一行带 `▶` 标记；`Alt+4` 直接选中最新回复。
+- `/copy`（或 `Ctrl+Shift+C`）复制的是**选中的那一条的原文**——不是折行后的屏幕文本；
+  复制后保留选中，连按两次拿到的是同一条。
+- 在选中的回复上按 `Enter`：打开「回复全文」（可滚动、`Esc` 返回），长回复里的表格与代码块
+  不再被窗口宽度切碎。**覆盖层里也能复制**，取的是屏幕上那份正文，并在覆盖层底部回显「已复制 …」。
+- 工具卡 / 子代理 / 改动卡的「全文」覆盖层里，复制键取的同样是**屏幕上那份正文**（工具全文、那份 diff、
+  子代理日志），不再是卡片摘要。
+- **拖选**照旧：被选中回复第一行前面的 `▶` 是装饰，拖过它不会把标记复制进去。
+
+## 底栏与链路
+
+- 链路质量**在会话运行中持续重测**并按中位数读数：进会话那一瞬间的网络抖动不再把整场会话钉在最低档
+  （绘制节奏与每帧字节预算都跟着这档走）。
+- 选择器把「可接入 / 已占用」两个词固定下来，并且**在首帧之前**就把"已经挂掉的窗口"判完——列表不会先
+  显示「已占用」再改口。判定走一次真实往返（光标探针），因为断掉的 SSH 链路会让 launcher 还连着显示通道。
+- 接管（把别人的窗口接过来）现在**要确认**，`Esc` 是取消而不是退出。
+
+## 空回合不再被误读为完成
+
+上游网关偶尔只回思考、`finish_reason: stop`、正文为零（实测某网关 10/35 个回合如此），
+宿主如实组装成"只有思考的助手消息"，状态栏显示完成/空闲。现在转录里会补一行明确提示
+（含 `finish_reason: stop` 与"按 Enter 继续"），回放/中断/报错的回合不提示。
+
+## 上游兼容
+
+- `dsh` 声明窗口：`>=0.1.7-rc.1 <0.1.8`（`next`）与本条线并行；`0.1.7-rc.2` 已按完整流程验过并声明
+  `compatible`（干净树安装、`tsc` 0 错、套件全绿、六个真 PTY 探针全过），CI 里单独一条腿。
+- CI 现有 5 条腿：`0.1.7-rc.1`（默认，提交的 manifest）、`0.1.7-rc.2`、`0.1.5-rc.3`、`0.1.5-rc.1`
+  （只跑类型与单元）、`test-windows`（ConPTY 真机）。默认腿新增一条 **Reply copy probe**：真 PTY 跑一轮
+  脚本化模型，断言拖选复制、`/find` 高亮、以及**选中回复后按复制键拿到原文**。
+
+## 发版核对清单（执行时逐条打勾）
+
+```sh
+# 0. 版本号（改这一处，然后重新生成锁）
+#    package.json "version": 0.7.4
+npm install --package-lock-only --cache <可写目录>   # 只重算锁，不动 node_modules
+
+# 1. 门禁（本地）
+npx tsc --noEmit -p tsconfig.json
+node --test "tests/*.test.mjs"                       # 期望：1009 pass / 0 fail / 4 skip
+node scripts/tui-mock-probe.mjs                      # 脚本化一轮：拖选 + 选中回复复制 + /find
+node scripts/tui-mock-probe.mjs --busy                # 窗口中途关闭
+node scripts/probe-home.mjs --probe                   # boot/resize/diag/doctor/copy/preset/exit
+node scripts/probe-home.mjs --probe --script tui-term-probe.mjs
+node scripts/probe-home.mjs --probe --script tui-cut-probe.mjs
+node scripts/probe-home.mjs --probe --script tui-rtt-probe.mjs
+node scripts/probe-home.mjs --probe --script tui-drop-probe.mjs
+npm pack --dry-run                                    # 189 个文件、无 tgz 落盘
+
+# 2. GitHub（先）
+git commit -am "Release 0.7.4"
+git push origin main
+git tag -a v0.7.4 -m "0.7.4" && git push origin v0.7.4
+#    → 建 GitHub Release（正文用本文件"头等事"起的那几段 + 当日热度基线）
+#    → 等 CI 五条腿全 success（tag 与 main 都要看）
+
+# 3. npm（CI 全绿之后；token 需先刷新）
+npm whoami --registry https://registry.npmjs.org/      # 必须是登录态，否则不要往下走
+npm publish --registry https://registry.npmjs.org/ --tag latest
+npm dist-tag add dsh-ssh-tui@0.7.4 next                # 0.7.3 时 latest 与 next 同值
+```
+
+**注意**：本机 `~/.npmrc` 的默认 registry 是 npmmirror，发布必须显式
+`--registry=https://registry.npmjs.org/`；`_authToken` 目前是过期状态（`npm whoami` → `E401` /
+`ENEEDAUTH`），刷新之前不要执行第 3 步。
+
+## 已知限制（写进 Release）
+
+- 真实 Windows 上仍只能人工确认的两条：宿主控制台窗口确实隐藏；`%USERPROFILE%` 与 `$HOME` 不一致的账户行为。
+- 纯问答会话（尚无任何卡片）或刚 `/clear` 时，空输入 `↑` 仍是**历史召回**而不是选中回复——这是刻意保留的；
+  那种会话用 `Alt+4` / `Ctrl+N` / `Ctrl+P` 选回复。选中后 `Enter` 正常打开全文。
+- 把 `Ctrl+Shift+C` 折叠成 `Ctrl+C` 的老终端上，覆盖层里那个键等于关闭；请用 `ssh-tui.keys` 改绑 `copy`
+  （改绑后的键在覆盖层内同样生效）。