dsh-ssh-tui 0.8.2-rc.1 → 0.8.3

package/CHANGELOG.md

@@ -10,9 +10,39 @@
 
 ---
 
-## 0.8.2-rc.1 — 2026-10-03（候选版；本版本地已就位，未打 tag、未发布）
+## 0.8.3 — 2026-10-13（`latest` + `next`）
 
-发版说明：[`docs/release-notes-0.8.2-rc.1.md`](release-notes-0.8.2-rc.1.md)。
+发版说明：[`docs/release-notes-0.8.3.md`](release-notes-0.8.3.md)。
+**紧急修复**：三个缺陷都是 0.8.2 把首启向导改成 Screen 时引入的，全部在"首次安装 / `/setup`"这条路上。
+
+### Fixed
+
+- **首启向导 / `/setup` 的粘贴**：终端粘贴（Ctrl+V / Cmd+V / 右键，即括号粘贴）此前落到 Screen
+  *背后*的工作区草稿里——向导字段一个字都收不到，读者只能手敲 API Key。现在粘贴归字段所有：字段步骤
+  直接落进字段（行尾换行折叠掉，多行按分隔拼接成一行），没有字段的步骤（模型多选、确认）不接收，
+  两种情况下草稿都不再被改写。
+- **走完向导没有退回工作区**：保存成功后 Screen 仍然占着屏，要随便按一个键才退得出去（那个键的兜底
+  才是真正的退场）。现在**保存本身就是退场**，与 Esc 对称；保存失败则**保留向导与错误**（此前错误写在
+  一个立刻被丢弃的状态上：Screen 留着、错误没了、填好的答案也没了）。完成语改为转写行，回到工作区
+  仍可读到。
+- **一次读取里的多个按键**：`text\r` 这样的读取会收下文字却丢掉回车，步骤停住不动。现在按 composer
+  一直以来的规则拆开（转义序列完整、CRLF 一个回车、控制字节各自成键、可打印文本连成一段）。
+- **Screen 打开时的 composer 编辑键**：`Enter` / `Backspace` / `Ctrl+H` / `Ctrl+U` / `Ctrl+K` /
+  `Ctrl+A` / `Ctrl+E` / `Ctrl+R` / `Ctrl+T` 不再作用于 `/diag`、`/status`、diff 全览等 Screen 背后
+  那个看不见的草稿（此前 `Enter` 会把草稿当消息发出去，`Ctrl+U` / `Ctrl+K` 会清空或截断它）。
+- **Screen 里的 `Ctrl+L`**：任意 Screen（不只是向导）都能整屏重画，用于清理花屏的终端；此前只有向导认这个键。
+
+---
+
+## 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) 与
@@ -113,6 +143,8 @@ B2（"what deserves to exist"）的六个阶段 B2.1 – B2.6 已完成并通过
 
 ### 已知问题
 
+- **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），**没有自动化、只能人眼的两目（输入法组合、多行中文粘贴）

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.
@@ -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
@@ -741,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)
 

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 可以升级；正在工作的会话不应该因此变得脆弱。**
+**SSH 断了。会话还在。接回来继续。**
 
-English: [README.en.md](README.en.md)
-
----
+“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
@@ -237,7 +285,8 @@ docs/screenshots/slow-link.json
 - 调工具；
 - 运行子代理；
 
-TUI 可以保留 Host，并允许重新接入。
+TUI 可以保留 Host，并允许重新接入（保留的是**宿主**；这一轮本身是否在断线期间继续跑，看
+[`/disconnect`](#ssh-断了之后) 的策略）。
 
 ```bash
 dsh --profile tui --resume

package/docs/release-notes-0.8.2.md

@@ -0,0 +1,64 @@
+# 0.8.2 发版说明
+
+> **发布方式：`latest` + `next`。** 上一次发版：**0.8.1**（2026-09-30，`latest` + `next`）。
+> 本版由 **0.8.2-rc.1**（2026-10-04 只上 `next`）沉淀一周后转正：候选版期间没有收到新的回归报告，
+> CI 五条腿与全部真 PTY 探针持续全绿，Windows / ConPTY 实机人工验收也已完成（见
+> [`checkpoints.md`](checkpoints.md)「Windows 实机轮」）。**运行时内容与候选版逐字节相同**（转正后从 registry 分别取回两个 tarball，`lib/` 整目录
+> `diff -r` 无差异）；自候选版以来新增的只有 README 与文档（DSH Relay 软品牌那一批）以及
+> `docs/screenshots/reconnect.gif`。
+> 逐项说明见 [`release-notes-0.8.2-rc.1.md`](release-notes-0.8.2-rc.1.md)。
+
+> `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 为产品名展示；npm 包名与安装命令没有变化。**
+> 发布坐标仍是 `dsh-ssh-tui`，安装命令仍是
+> `dsh plugin --profile tui add dsh-ssh-tui@latest`。依据：[`decisions/brand-dsh-relay.md`](decisions/brand-dsh-relay.md)。
+
+## 头等事：全新安装**第一次就会出现配置向导**（此前根本不会出现）
+
+0.8.1 及以前，一台没有任何配置的机器上装好插件、启动 `dsh --profile tui`，看到的是一个空工作区、
+一行提示都没有，模型调用必然失败——**配置向导永远不会自动出现**。原因是前端拉起的 Host 永远带
+`--resume=<id>`（连它自己刚铸的新 id 也带），而首启判定把 `resume` 当成"这台机器配置过"。
+0.8.2 起只看凭据存不存在。详见候选版说明第一节。
+
+## 另外两件用户直接看得见的事
+
+- **resume 不再有一段 1–3 秒黑屏**：进屏序列现在跟着第一帧一起发出，加载提示全程在屏
+  （20k 事件实测：清屏与落地同一 tick，此前中间有 3.5 秒全黑）。
+- **思考卡片不再发白**：`reasoning` 角色此前只写属性、不写颜色，"暗"完全靠 faint；不实现 faint 的终端
+  会退回默认前景色。四个调色板现在各自给出 muted 颜色。
+- **链路那一格不再把"绘制节奏"当延迟**：终端不回 `CSI 6n` 时显示 `未测` / `n/a`，不再印一个看起来像
+  测量值的 160ms。
+
+## 兼容
+
+上游兼容窗口与 0.8.1 相同：`0.2.0-rc.1` / `0.2.0-rc.2` / `0.1.7-rc.1` / `0.1.7-rc.2`。
+**0.1.5 及更早的宿主不再支持。** 本版不改协议、不加命令、不动上游接口。
+
+## 安装 / 升级
+
+```sh
+dsh plugin --profile tui add dsh-ssh-tui@latest
+```
+
+装完退出再启动。`/status` 可确认当前版本；装不上先看 `/doctor`。
+更新时请显式带 `@latest`，否则已有 lockfile 可能继续沿用旧版本。
+
+## 实测数字（本版，100×20）
+
+| 动作 | 毫秒（中位） | 字节 | 寻址行 | 全屏清屏 |
+|---|---|---|---|---|
+| 流式 delta | 1.47 | 501 | 3 | **0** |
+| 等待卡时钟 | 1.26 | 465 | 3 | **0** |
+| 报告屏翻页 | 1.40 | 2457 | 17 | **0** |
+| 菜单光标移动 | 1.09 | 588 | 4 | **0** |
+| 向导字段打字 | 0.25 | 140 | 1 | **0** |
+
+复现：`npm run bench`；README 里的同一张表由 `npm run bench:report` 从这次真跑生成。
+
+## 已知问题
+
+见候选版说明的「已知限制」一节。要点：Windows / ConPTY 实机人工验收**已完成**（12 项清单；
+两处 ConPTY 盲区在探针里显式 `SKIP` 并在 Linux 腿上真跑，`SKIP` 不算通过）；`未测` 那一格在
+Windows 本机看不到（ConPTY 代答光标位置），由管道父进程形状的探针覆盖。

package/docs/release-notes-0.8.3.md

@@ -0,0 +1,72 @@
+# 0.8.3 发版说明
+
+> **发布方式：`latest` + `next`。** 上一次发版：**0.8.2**（2026-10-05，`latest` + `next`）。
+> 本版是**紧急修复**：0.8.2 把首启向导改成 Screen 之后，向导的输入与退场出了三个缺陷，
+> 都在"首次安装 / `/setup`"这条路上。没有协议变更、没有配置变更、没有数据损坏；
+> 升级即修复，不需要任何迁移动作。
+
+## 头等事：向导收得下粘贴，也走得掉
+
+三个缺陷都是 0.8.2 引入的（0.8.1 的向导借工作区的输入行，所以既收得到粘贴、也不需要自己退场）。
+
+### 1. 粘贴的 API Key 进不了字段，只能手敲
+
+终端粘贴（Ctrl+V / Cmd+V / 右键，即括号粘贴）此前落到了向导 **Screen 背后**那个看不见的工作区草稿里：
+向导字段一个字都收不到，而粘贴并没丢——它会留在草稿里，Esc 离开向导后在输入行现形，按回车就会被当成
+一条消息发出去。受影响的是**所有做括号粘贴的终端**（Windows Terminal、iTerm2、GNOME Terminal、WezTerm、
+kitty、VS Code 终端、tmux……），也就是几乎所有现代终端；受影响的是**每一个字段步骤**（提供商过滤、
+Provider ID、Base URL、**API Key**、模型列表、上下文窗口）。
+
+现在粘贴归字段所有：字段步骤直接落进字段（行尾换行折叠掉，多行按分隔拼成一行），没有字段的步骤
+（模型多选、确认）不接收，两种情况都不再改写工作区草稿。老控制台不发括号粘贴时，多行 burst 也按粘贴处理。
+
+### 2. 走完向导没有退回工作区
+
+保存成功后向导仍然占着屏，读者要随便按一个键才退得出去（那个键的"Screen 背后没有向导 → 关掉它"兜底
+才是真正的退场）。**保存本身就是退场**，现在与 Esc 一致：按 `y` 的同一帧，工作区回来。
+
+同一处的失败路径也修了：保存失败时错误写在了一个立刻被丢弃的状态上——Screen 留着、错误没了、填好的答案
+也没了，下一次按键还把这套流程当作没发生过。现在失败**保留向导与错误**，改完可以直接重试。
+
+向导自己的提示行会随 Screen 消失，所以"配置完成，已记住 X / Y"现在落在**转写行**里（凭据那一行是
+footer 回显，会过期），回到工作区后还读得到。
+
+### 3. 一次读取里的多个按键（顺带修掉的同类）
+
+一次终端读取里的多个按键此前被当成一个键：`text\r`（慢链路上的快速输入、终端合并写入）会收下文字却
+**丢掉那个回车**，步骤停住不动——读者只能再按一次回车。现在一次读取按 composer 一直以来的规则拆开：
+转义序列保持完整、CRLF 算一个回车、控制字节各自成键、可打印文本连成一段（所以没有括号粘贴的
+"yes" 仍然不会替读者按下确认）。
+
+## 兼容
+
+上游兼容窗口与 0.8.2 相同：`0.2.0-rc.1` / `0.2.0-rc.2` / `0.1.7-rc.1` / `0.1.7-rc.2`。
+**0.1.5 及更早的宿主不再支持。** 本版不改协议、不加命令、不动上游接口，也不改任何配置文件的形状。
+
+## 安装 / 升级
+
+```sh
+dsh plugin --profile tui add dsh-ssh-tui@latest
+```
+
+装完退出再启动。`/status` 可确认当前版本；装不上先看 `/doctor`。
+更新时请显式带 `@latest`，否则已有 lockfile 可能继续沿用旧版本。
+
+## 实测数字（本版，100×20）
+
+| 动作 | 毫秒（中位） | 字节 | 寻址行 | 全屏清屏 |
+|---|---|---|---|---|
+| 流式 delta | 1.67 | 501 | 3 | **0** |
+| 等待卡时钟 | 1.12 | 465 | 3 | **0** |
+| 报告屏翻页 | 1.21 | 2457 | 17 | **0** |
+| 菜单光标移动 | 0.90 | 588 | 4 | **0** |
+| 向导字段打字 | 0.19 | 140 | 1 | **0** |
+
+复现：`npm run bench`；README 里的同一张表由 `npm run bench:report` 从这次真跑生成。
+本版没有触碰绘制路径，数字与 0.8.2 同一量级。
+
+## 已知问题
+
+- 向导字段没有左右光标键，粘贴总是追加在末尾（掩码字段 + 中间光标这条组合目前不存在）。
+- `未测` 那一格在 Windows 本机看不到（ConPTY 代答光标位置），由管道父进程形状的探针覆盖。
+- 完整已知问题与人工验收清单见 [`checkpoints.md`](checkpoints.md) 的 0.8.2 一节。

package/docs/terminals.md

@@ -52,6 +52,29 @@
 - **`?` 的含义**：该终端*可能*生效但需要用户配置（xterm 的 `allowWindowOps`、tmux 的 `set-clipboard on`），
   所以仍然**照发**；而 `—` 的终端上一次会话只提醒一次，告诉你剪贴板可能没写进去。
 
+### 证据等级：作者/CI 实测 vs 社区实测
+
+上面那张表是**作者与 CI 实测**的一等证据：判定代码有单元用例（`tests/terminal-caps.test.mjs`），
+每种终端真起一次 TUI 看它到底发了哪些序列（`scripts/tui-term-probe.mjs`），CI 每条腿都跑。
+下面这张表是**社区实测**：读者在自己的终端上试出来的结果，**证据等级不同，不要混着读**。
+
+| 终端 | 环境（OS / 传输） | 结论 | 来源 | 日期 |
+|---|---|---|---|---|
+| _(待填)_ | | | | |
+
+**怎么贡献一行**：在 GitHub 上提一份
+[终端兼容报告](https://github.com/cyjyyd/dsh-ssh-tui/issues/new?template=terminal-compatibility.yml) ——
+不用读代码，填一张表（OS、终端、本地/SSH、TERM、版本，以及哪些能力试过、哪些没试过）。
+报告会由维护者整理到这里，并注明来源与日期。
+
+两栏的差别要一直保留：
+
+- **作者/CI 实测** = 有可复现的判定代码与探针，改坏了 CI 会红；
+- **社区实测** = 一个人的一次观察，能证明"在这个环境下能跑"，不能证明"在别的版本上也行"。
+
+一条报告即使结论是"能用"，也只进社区栏——除非它同时补上了对应的 fixture 或探针，那时它升级为
+作者/CI 一栏，并在矩阵表里出现一行。
+
 ## 覆盖方式（用户可强制指定）
 
 自动判定错了就手动覆盖，两个环境变量都长期有效：