One page for MCP tool names, CLI commands, and the normal command flow.把 MCP 工具名、CLI 命令和正常工作流放到一个页面里。

List devices, connect once, run, inspect, poll if async, then run again.先列设备、连一次、执行、检查，必要时轮询异步，再继续执行。

ssh-device-list
ssh-quick-connect
ssh-run
ssh-status
ssh-command-status
ssh-run

Drop to diagnostics, history, and control tools instead of blindly sending another command.不要盲目再发一条命令，而是切到诊断、历史和控制工具。

ssh-session-diagnostics
ssh-session-history
ssh-session-control
ssh-status

What does `ssh-quick-connect` do?`ssh-quick-connect` 是干什么的？

It opens or reuses the common SSH session and can also launch the viewer, so it is the recommended first step before `ssh-run`.它会打开或复用常用 SSH 会话，还可以顺手拉起 viewer，所以它是 `ssh-run` 之前推荐的第一步。

When should I use `ssh-command-status`?什么时候该用 `ssh-command-status`？

Use it when `ssh-run` returns an async command ID or when long-running remote work should be polled explicitly instead of guessed.当 `ssh-run` 返回异步命令 ID，或者远程长任务应该被显式轮询而不是靠猜时，就该用它。

What is `ssh-session-diagnostics` for?`ssh-session-diagnostics` 是做什么的？

It inspects lock state, warnings, running command state, and viewer health when the terminal is blocked, odd, or clearly stateful.当终端被阻塞、状态异常、或明显进入强状态依赖时，它用来检查锁状态、警告、运行中命令和 viewer 健康度。

When do I use `ssh-session-mcp-ctl` instead of MCP tools?什么时候该用 `ssh-session-mcp-ctl`，而不是 MCP 工具？

Use the CLI when you are acting as the local operator and need process status, device listing, launch, logs, or cleanup outside the MCP tool loop.当你是本地操作者，需要看进程状态、列设备、启动、看日志或清理，而不是走 MCP 工具回路时，就用这个 CLI。