dsh-ssh-hub

Usage

1. Click SSH 终端 at the sidebar foot, or press Ctrl+Shift+` — the Terminal Window opens (centred, remembered position/size). Double-click its title bar to maximize; Esc exits magnify/maximize one level (closing the window is the explicit ✕). Drag the title bar to move (it stays on screen), the corner handle to resize.

2. Click 管理服务器 (Manage servers) → 添加服务器 (Add server) and fill in:

   Field	Description
   名称 (Name)	Display name, e.g. prod-db-1
   主机 (Host)	IP or hostname
   端口 (Port)	SSH port, default 22
   用户名 (Username)	SSH login user
   认证方式 (Auth)	password / privateKey / SSH Agent / none
   密码 / 私钥	Secret — left blank on edit keeps the stored one
   远程初始目录 (Cwd)	Optional initial working directory on the remote
   连接超时 (Ready timeout)	Optional, in seconds; blank = inherit the Server Default (default 15 s)
   Keepalive 间隔	Optional, in seconds, 0 disables; blank = inherit the Server Default (default 30 s)
   严格主机密钥校验 (Strict host key)	Inherit / on / off; on requires a known-hosts entry

   Use 测试连接 (Test) to verify before saving.

3. Open a session: click the 新会话 (New session) button in the window's tab bar and pick a server (a session opens as its own tab; 加入当前 appends it to the active group). Or use the 会话 (Sessions) panel, or 管理服务器 (Manage servers) → click/double-click a row. The empty state guides you by what you have: no servers → 添加第一台服务器; servers but no sessions → 新会话; sessions in the background → 打开会话面板.

4. Watch several at once: click the 新建组合 (New group) button, tick the sessions, and they open side-by-side. Or drag a tab onto another tab to merge them into a group, and onto a group's tab to append a member. Connect more servers with 加入当前 (Join current) to append them to the active group; drag the dividers to resize; magnify a member (hover it, or Alt+m) to fill the window. Drag members within a group to reorder them (before/after/swap); drag one out onto the tab strip to make it its own tab again. A group's ✕ dissolves it back into its member tabs.

5. Sessions you're not watching: closing a tab removes the view only — the session keeps running on the host (a toast reminds you) and appears in the 会话 (Sessions) panel. From there you can place it back (放入当前 into the active item, or 新标签 as its own tab) or terminate it (终止, two clicks to confirm). A detached session shows its reclaim countdown in the panel.

6. Type, select-to-copy, right-click-to-paste. Theme: the toolbar 跟随界面 / 深色 / 浅色 button cycles the terminal theme; remembered per browser, applied to every open terminal instantly.

7. Your shells survive: closing the window, removing a view, refreshing the page, or switching conversations detaches the UI but the sessions keep running on the host, reattaching with recent output replayed. A brief network blip reconnects automatically. Closing a session for good: 终止 it in the 会话 (Sessions) panel (or delete the server). Sessions with no viewers are reclaimed after 30 minutes by default — the window is configurable in the settings card (会话回收时长), and the countdown shows in the window's status strip. If DSH restarts (sessions and layout live in memory), the window comes back empty — the status strip offers 恢复上次布局 (Restore last layout) to reopen the same sessions.

8. Shortcuts are configurable: 设置 → 插件 → 插件配置 → DSH-SSH-HUB → 快捷键 (toggle window, maximize, new tab, close block, close tab, magnify). Values are validated, DSH conflicts warn (not blocked), and changes apply immediately.

9. On DSH ≥ 0.1.0-rc.7, the same card also sets the Server Defaults blank server fields inherit — including a default terminal theme used when a browser's override is 跟随界面. The card's 管理服务器… link jumps straight to the window's server drawer.

10. Moving to a new machine? Use 导出配置 (Export) / 导入配置 (Import) in the manage-servers dialog. The exported JSON contains no secrets — re-enter passwords/keys after importing. Import always adds entries as new servers and never overwrites existing ones.