@hyzyn/dsh-tty 0.19.2 → 0.19.3

package/README.en.md

@@ -491,12 +491,24 @@ session belongs to (visually aligned with FinalShell’s session monitor bar):
   session exit, orphan reaping, plugin disable and configuration off all stop the meter and close the remote
   channel, leaving no timers or remote loops.
 - **Best-effort**: a field that cannot be obtained is omitted (the frontend shows “n/a”); a collection
-  failure silently stops the meter and hides the whole status bar (it collapses after 3s without a new
-  frame) — it never writes to the PTY and never raises an error. Progress-bar thresholds:
-  <70 normal / 70~90 yellow / >90 red.
+  failure silently stops the meter and hides the whole status bar (it collapses after **8s** without a new
+  frame — not 3s: when a sampling subprocess on the host occasionally slows down, frames get further apart,
+  and too tight a window makes the whole bar blink) — it never writes to the PTY and never raises an error.
+  Progress-bar thresholds: <70 normal / 70~90 yellow / >90 red.
+- **A slow command cannot stall the cadence**: subprocess-backed fields (df / netstat / vm_stat) are awaited
+  only on the very first sample; afterwards the sampler uses the last known value and refreshes in the
+  background, so a command that hangs on some machine only leaves that one field briefly stale instead of
+  stretching the one-frame-per-second timeline (measured: 3000ms → 3~12ms per frame).
 - **Hot effect**: turning `statsEnabled` off stops collection at once (the status bar disappears and no more
   stats frames go over the WS), and turning it back on restores automatically from the subscriptions still in
   place — no restart and no need to reopen tabs.
+- **Fixed slots + incremental repaint**: every value owns a fixed-width character slot (right
+  aligned, so even the widest form only takes that one slot), and the items are built once — afterwards only
+  text that actually changed is written. Hence `CPU 5% → 12%`, `TCP 36 → 1024` and
+  `memory 9.2 GB → 17.8 GB` no longer push every following item sideways (which showed up as the whole bar
+  jumping once a second), the progress-bar width can finally animate through its CSS transition, and
+  horizontally scrolling to `Network` in a narrow window is no longer snapped back to the start by the next
+  refresh.
 
 ## Configuration (Settings → Plugins → “Terminal Panel”, saving takes effect immediately)
 

package/README.md

@@ -436,10 +436,19 @@ tmux server（专用 socket `dsh-tty`，与用户自己的 tmux 完全隔离）
   宿主首个订阅才起采集；退订清零、会话退出、孤儿回收、插件禁用、配置关闭
   都会停表并关掉远端 channel，不留定时器/远端循环。
 - **best-effort**：某项拿不到就省略该字段（前端显示「无」），采集失败静默停表、
-  状态条整条隐藏（3s 收不到新帧即收起）——绝不写 PTY、绝不弹错误。进度条阈值
+  状态条整条隐藏（8s 收不到新帧即收起——**不是 3s**：宿主某个采集子进程偶发变慢时帧间隔
+  会被拉长，窗口太紧就会整条一闪一闪）——绝不写 PTY、绝不弹错误。进度条阈值
   配色：<70 正常 / 70~90 黄 / >90 红。
+- **慢命令不拖垮节奏**：走子进程的字段（df / netstat / vm_stat）只在首次采样时等一次，
+  之后一律「用上一次的值 + 到点后台刷新」，某台机器某个命令卡住只会让那一格短暂显示旧值，
+  不会把「每秒一帧」的时间轴拖散（实测 3000ms/帧 → 3~12ms/帧）。
 - **热生效**：关掉 `statsEnabled` 立刻停采集（状态条消失、WS 不再发 stats 帧），
   重新打开后按仍存留的订阅自动恢复，无需重启或用例重开标签。
+- **固定槽位 + 增量刷新**：每个值的字符槽位固定（右对齐，最宽的一档照样只占
+  自己那一格），条目只建一次、之后只写真的变了的文本。所以 `CPU 5% → 12%`、
+  `TCP 36 → 1024`、`内存 9.2 GB → 17.8 GB` 都不会把后面的条目推着横移（曾表现为整条
+  每秒跳一次），进度条宽度也能真正走 CSS 过渡；窄窗口下横向滚到右侧看 `网络` 时，
+  滚动位置不会被下一秒的刷新弹回开头。
 
 ## 配置（设置 → 插件 → 终端面板，保存即热生效）
 
@@ -781,7 +790,7 @@ node scripts/preview.mjs --theme=light   # 浅色主题
 - **SSH 密码 / 口令建议 `env:VAR` 引用**：连接簿随 settings 文件落盘，
   `password` / `passphrase` 明文入库有泄露面；建议 `env:VAR` +
   dsh-env-manager 托管，或直接用 `agent` 认证（凭证不落盘）。
-- **服务器状态条（0.17.0）边界**：远端靠两跳兜底：先 POSIX（要 `/proc` + `awk`），一帧未出则回退 PowerShell——**Windows 远端**由此覆盖（温度多数组件没有、显示「无」，磁盘取系统盘 `%SystemDrive%`，TCP 走 `netstat -an`，网速走 `Get-NetAdapterStatistics` 差值；只输出整数，从根上避开区域小数点与科学计数法），**macOS/BSD 远端**两跳都不成立、一个字段都拿不到、状态条整条隐藏；非 Linux 远端的每次（重新）订阅会多一跳注定失败的 exec（约百毫秒，不影响出帧延迟）；Linux 上 CPU 温度只在暴露 `/sys/class/thermal` 的机器上有（多数云主机/虚拟机没有，显示「无」）；磁盘固定取 `/`（Windows 取系统盘）所在文件系统（不做多挂载点）；远端脚本经 `sh -c` 单引号包裹（登录 shell 是 fish/csh 也能跑）；本地会话的指标属于**宿主机器**（多个本地标签共享同一份采样，CPU/网速差值窗口连续），macOS 没有 /proc、`ss`、sysfs，改用 os/netstat/vm_stat，故温度恒为「无」，内存按 vm_stat 的 active+wired+compressed 计（os.freemem 会把文件缓存算成已用、长期 99%）；指标是**瞬时值**，没有历史曲线，也不提供 agent 工具（agent 侧仍用 tty_* 命令粒度能力）。
+- **服务器状态条（0.17.0）边界**：远端靠两跳兜底：先 POSIX（要 `/proc` + `awk`），一帧未出则回退 PowerShell——**Windows 远端**由此覆盖（温度多数组件没有、显示「无」，磁盘取系统盘 `%SystemDrive%`，TCP 走 `netstat -an`，网速走 `Get-NetAdapterStatistics` 差值；只输出整数，从根上避开区域小数点与科学计数法），**macOS/BSD 远端**两跳都不成立、一个字段都拿不到、状态条整条隐藏；非 Linux 远端的每次（重新）订阅会多一跳注定失败的 exec（约百毫秒，不影响出帧延迟）；Linux 上 CPU 温度只在暴露 `/sys/class/thermal` 的机器上有（多数云主机/虚拟机没有，显示「无」）；磁盘固定取 `/`（Windows 取系统盘）所在文件系统（不做多挂载点）；远端脚本经 `sh -c` 单引号包裹（登录 shell 是 fish/csh 也能跑）；本地会话的指标属于**宿主机器**（多个本地标签共享同一份采样，CPU/网速差值窗口连续），macOS 没有 /proc、`ss`、sysfs，改用 os/netstat/vm_stat（网速那条是 `netstat -ibn`——**必须带 `-n`**：不带时 netstat 会对接口地址做反查，DNS 不响应就挂几十秒，D50 的根因就是它），故温度恒为「无」，内存按 vm_stat 的 active+wired+compressed 计（os.freemem 会把文件缓存算成已用、长期 99%）；指标是**瞬时值**，没有历史曲线，也不提供 agent 工具（agent 侧仍用 tty_* 命令粒度能力）。
 - **SSH 会话没有本地 pid**：ssh2 shell channel 不是本机进程，`ready.pid`
   为 `null`、`tty_list` 显示 `target` 而非 pid，本机 `ps` / `kill` 对远程
   进程无效——关闭请用标签 ✕ 或 `kill` 帧（关闭的是 ssh2 channel）。