handmux 0.19.0 → 0.20.1

package/README.md

@@ -69,8 +69,9 @@ handmux start --tunnel cloudflare   # instant public URL (cloudflared auto-insta
 
 - **Claude Code / Codex, deeply** — an inbox status ledger, thumb-approve permissions & plans, and stable host-wide usage bars shared by every connected device.
 - **Chat view (experimental)** — read and drive a Claude session as a chat instead of a terminal: bubbles with Markdown, tool cards with colored diffs, question cards you answer with a tap, warm colour tones. Experimental — may be unstable: enable it in Settings → 启用对话视图 / Enable chat view, then switch views from the window bar.
-- **Desktop physical keyboard input** — open the same Handmux URL on a desktop browser and type into the current tmux pane immediately, without tapping “Show keyboard”. Press `Shift+Enter` or click the draft field to enter draft mode with shortcuts, upload, history, voice and multiline editing intact. `Enter` sends and stays in draft mode, `Shift+Enter` inserts a newline, and IME Enter only confirms composition; press `Esc` or click the terminal to return to direct input. Drag to select terminal text, then copy/paste with `Cmd+C` / `Cmd+V` on macOS or `Ctrl+Shift+C` / `Ctrl+V` (or `Ctrl+Shift+V`) on Windows/Linux; `Ctrl+C` remains the terminal interrupt. Settings → Keyboard mode can auto-detect or force Mobile/Desktop for this browser only. Echo still follows Handmux’s terminal snapshots rather than a real-time PTY. Browser-reserved shortcuts such as `Cmd+W/T/L/R` stay with the browser.
+- **Real-time terminal + desktop physical keyboard input** — terminal output streams as it happens on both phone and desktop. Scrolling up immediately browses recent tmux history without losing your place, pauses the stream when needed, and loads older history as you continue; returning to the bottom resynchronizes the live screen. When the source pane is shorter than the browser, spare rows show recent history above a faint dashed live boundary instead of empty space. Leaving the page pauses delivery; after 10 seconds away, returning starts from a fresh current screen instead of replaying stale output. **Live pushing** uses WebSocket, automatically falls back to **snapshot pulling** on a poor connection, and returns after 30 stable seconds. One top-right tag combines the actual mode and current latency; click it to see connection quality, the configured mode, fallback reason and retry countdown. Settings can keep this browser on snapshot pulling at an active interval from 0.8 to 2 seconds. On desktop, type into the current pane immediately without tapping “Show keyboard”; terminal-page keys keep working even after focus lands on the Window toolbar. `Shift+Enter` or the draft field opens draft mode with shortcuts, upload, history, voice and multiline editing intact. `Enter` sends and stays in draft mode, `Shift+Enter` inserts a newline, and IME Enter only confirms composition; press `Esc` or click the terminal to return to direct input. When a dialog, sheet, or menu is open, `Esc` closes only the top layer, one layer per press. Settings subpages stay stacked above Settings, so Back or `Esc` returns there before the main screen. Drag to select text, then copy/paste with `Cmd+C` / `Cmd+V` on macOS or `Ctrl+Shift+C` / `Ctrl+V` (or `Ctrl+Shift+V`) on Windows/Linux; `Ctrl+C` remains the terminal interrupt. Settings → Keyboard mode can auto-detect or force Mobile/Desktop for this browser only. Browser-reserved shortcuts such as `Cmd+W/T/L/R`, `F5`, and `F12` stay with the browser.
 - **Command & chat modes** — one bottom bar, two modes: type straight into the terminal, or talk to the agent in natural language. Both default quick bars include `Ctrl+C`. `handmux shortcuts` configures shared key/text items; each phone's ⚙ editor shows the effective quick-bar order, interleaves shared and local items, and can remove a shared item from that device only with immediate undo. Adding a phone-local item confirms success and returns directly to the list. Server changes apply live and phones reload them on foreground—no restart or polling required.
+- **Client reload after updates** — once the server update has finished, use Settings → Reload app to load the new client without quitting and reopening the home-screen app.
 - **Script push** — notify your phone from any script or CI step with `handmux push`; target all devices, a named session, or a specific device.
 - **Workspace recovery** — handmux silently keeps the metadata needed to rebuild your latest tmux workspace. After a computer or tmux-server restart, restore it beside any new sessions from the phone or with `handmux restore`; existing sessions are never replaced.
 - **Git viewer** — changes / commit history / any branch / full-screen colored diff, multi-repo tabs, read-only, never touches your tree.

package/README.zh-CN.md

@@ -69,8 +69,9 @@ handmux start --tunnel cloudflare   # 即时公网地址(自动装 cloudflared)
 
 - **Claude Code / Codex 深度**——收件箱状态台账、拇指批授权批计划，以及所有设备共享的本机最新 agent 用量。
 - **对话视图（实验性）**——把 Claude 会话当成聊天来看、来驱动,而不是终端:气泡 + Markdown 正文、带彩色 diff 的工具卡、点按即答的问题卡、暖色配色。实验性功能,可能不稳定:在设置里开启「启用对话视图(实验性功能)」后,从窗口栏切换视图。
-- **电脑物理键盘直输**——电脑浏览器打开同一个 Handmux URL，无需点「展开键盘」即可直接输入当前 tmux pane。按 `Shift+Enter` 或点击草稿框进入草稿模式，快捷用语、上传、历史、语音和多行自动增高全部保留；`Enter` 发送后仍停留在草稿模式，`Shift+Enter` 换行，输入法合成中的 Enter 只确认候选词，按 `Esc` 或点击终端回到直通模式。终端文字可直接用鼠标拖选，macOS 按 `Cmd+C` / `Cmd+V`、Windows / Linux 按 `Ctrl+Shift+C` / `Ctrl+V`（或 `Ctrl+Shift+V`）复制粘贴，`Ctrl+C` 仍是终端中断。设置里的「键盘模式」可选自动识别、手机或电脑，选择只影响当前浏览器。终端回显仍跟随 Handmux 的快照刷新，并非实时 PTY；`Cmd+W/T/L/R` 等浏览器保留组合不承诺发送到终端。
+- **实时终端 + 电脑物理键盘直输**——手机和电脑上的终端输出都会实时出现；首次向上滑动即可查看最近的 tmux 历史，继续向上会加载更早内容，回到底部再重新同步，不会丢位置。远端 pane 比浏览器矮时，多出的区域会展示最近历史，并用一条很浅的破折线标出实时画面的起点，不再留出大片空白。离开页面会立即暂停传输；超过 10 秒后回来会直接抓取最新画面，不再补画旧输出。「实时推送」使用 WebSocket，网络较差时自动临时回退到「快照拉取」，持续稳定 30 秒后自动切回；右上角用一个标签合并显示当前模式和延迟，点击后可查看连接状态、设置模式、降级原因和恢复倒计时。也可在设置里固定使用「快照拉取」，并选择 0.8–2 秒的活跃刷新频率。电脑浏览器打开同一个 Handmux URL，无需点「展开键盘」即可直接输入当前 tmux pane；即使焦点落在 Window 工具栏，终端页面上的按键仍会继续发送给当前 pane。按 `Shift+Enter` 或点击草稿框进入草稿模式，快捷用语、上传、历史、语音和多行自动增高全部保留。`Enter` 发送后仍停留在草稿模式，`Shift+Enter` 换行，输入法合成中的 Enter 只确认候选词，按 `Esc` 或点击终端回到直通模式；有弹窗、浮窗或菜单时，`Esc` 每次只关闭最上层，连续按键可逐层返回。设置中的二级页面会保留设置父层，返回或 `Esc` 会先回到设置，再回到主屏。终端文字可直接用鼠标拖选，macOS 按 `Cmd+C` / `Cmd+V`、Windows / Linux 按 `Ctrl+Shift+C` / `Ctrl+V`（或 `Ctrl+Shift+V`）复制粘贴，`Ctrl+C` 仍是终端中断。设置里的「键盘模式」可选自动识别、手机或电脑，选择只影响当前浏览器；`Cmd+W/T/L/R`、`F5`、`F12` 等浏览器保留按键不发送到终端。
 - **命令 / 聊天双模式**——底部一栏两种模式:直接敲进终端,或用自然语言发给 agent;两种默认快捷栏都有 `Ctrl+C`。`handmux shortcuts` 配置所有设备共享的按键 / 文字项;每台手机的 ⚙ 编辑器按快捷栏实际顺序统一显示共享与本机项,可自由混排,也可只从本机移除共享项并即时撤销。本机新增成功后会明确提示并直接返回列表。服务端修改立即生效,手机回到前台自动读取,无需重启或轮询。
+- **更新后重新加载客户端**——服务端更新完成后，在设置里点「重新加载应用」即可载入新版客户端，无需退出主屏应用再重新打开。
 - **脚本推送**——用 `handmux push` 从脚本或 CI 步骤推消息到手机,可指定全部设备、某个会话或某台设备。
 - **工作区恢复**——handmux 静默保存重建最新 tmux 工作区所需的元数据。电脑或 tmux server 重启后,可从手机或 `handmux restore` 把旧工作区恢复到新会话旁边,绝不替换现有会话。
 - **Git 查看器**——改动 / 提交历史 / 任意分支 / 全屏彩色 diff,多仓库分页,只读不动工作区。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handmux",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "description": "A mobile vibe-coding cockpit — built on tmux: drive your live session, Claude Code / Codex — anything a terminal can run — from your phone.",
   "type": "module",
   "license": "AGPL-3.0-only",
@@ -49,7 +49,8 @@
     "compression": "^1.8.1",
     "express": "^4.19.2",
     "tunlite": "^0.10.0",
-    "web-push": "^3.6.7"
+    "web-push": "^3.6.7",
+    "ws": "^8.21.0"
   },
   "optionalDependencies": {
     "qrcode-terminal": "^0.12.0"
@@ -59,13 +60,13 @@
     "vitest": "^2.0.0"
   },
   "whatsNew": [
+    {"version":"0.20.1","date":"2026-07-26","zh":"聊天发送修复 · 电脑键盘不中断","en":"Reliable chat sending · uninterrupted desktop input"},
+    {"version":"0.20.0","date":"2026-07-26","zh":"终端实时推送 · 弱网自动回退","en":"Live terminal pushing · automatic network fallback"},
     {"version":"0.19.0","date":"2026-07-25","zh":"电脑物理键盘直输 · Window 切换更流畅","en":"Desktop keyboard input · faster window switching"},
     {"version":"0.18.0","date":"2026-07-22","zh":"Tmux 工作区恢复 · 快捷栏自由定制","en":"Tmux workspace recovery · customizable shortcuts"},
     {"version":"0.17.8","date":"2026-07-20","zh":"分屏地图显示尺寸 · iPhone 交互修复","en":"Pane dimensions in the map · iPhone interaction fixes"},
     {"version":"0.17.7","date":"2026-07-20","zh":"单实例启动兜底 · WSL 状态命令修复","en":"Single-instance startup guard · WSL status fix"},
     {"version":"0.17.6","date":"2026-07-20","zh":"推送结果可追踪 · 对话与权限操作更可靠","en":"Traceable push results · safer chats and permissions"},
-    {"version":"0.17.5","date":"2026-07-20","zh":"通知开启修复 · 长会话与设置可靠性提升","en":"Notification setup fixed · stronger chat and settings reliability"},
-    {"version":"0.17.4","date":"2026-07-19","zh":"HTTPS 本机预览修复 · 通知链接安全加固","en":"HTTPS localhost previews fixed · safer notification links"},
-    {"version":"0.17.3","date":"2026-07-19","zh":"三修官方一键安装的 Claude 识别,真机已验证","en":"Third fix for native-install Claude detection, device-verified"}
+    {"version":"0.17.5","date":"2026-07-20","zh":"通知开启修复 · 长会话与设置可靠性提升","en":"Notification setup fixed · stronger chat and settings reliability"}
   ]
 }