The homepage keeps a short summary, but this page gathers the common questions in one place so you can skim them quickly.首页只放了简短摘要，这一页把常见问题集中在一起，方便你快速扫一遍。
This page keeps the answers short and direct so you can get unstuck quickly, then keep going if needed.这里的答案都会尽量短而直接，方便你先把问题解决，再决定下一步往哪看。
A normal wrapper executes one command at a time. SSH Session MCP preserves a shared PTY, so the user and AI agent see the same terminal state, prompts, history, and long-running process lifecycle.普通包装层通常一次执行一条命令。SSH Session MCP 会保留共享 PTY，让用户和 AI Agent 看到同一份终端状态、提示符、历史和长任务生命周期。
Use `npx -y ssh-session-mcp --viewerPort=auto` as the default install path, then register that command in the MCP client. Client-specific examples are collected in the install guide and `llms-install.md`.默认安装路径是 `npx -y ssh-session-mcp --viewerPort=auto`，然后把这条命令注册到对应的 MCP client。客户端示例可以在安装指南和 `llms-install.md` 里找到。
Because the human can inspect prompts, manually intervene, and confirm what the AI is doing on the same terminal instead of guessing from disconnected command outputs.因为人可以直接看到提示符、手工介入、确认 AI 在做什么，而不是只能从断开的命令输出里猜测。
It prevents the AI and the human from typing over each other in the same terminal. That is important when a shell becomes interactive, risky, or stateful.它防止 AI 和人同时往同一个终端里乱打字。这在 shell 进入交互态、高风险态或强状态依赖时尤其重要。
Use Docker when you need a pinned runtime, image-based distribution, or a fixed mapped viewer port. For normal desktop setup, `npx -y ssh-session-mcp --viewerPort=auto` is still the lower-friction default.当你需要固定运行时、镜像分发或稳定的 viewer 映射端口时，用 Docker。对普通桌面端接入来说，`npx -y ssh-session-mcp --viewerPort=auto` 仍是摩擦更小的默认方案。
Use `cmd /c npx -y ssh-session-mcp --viewerPort=auto` as the fallback. Some MCP clients spawn stdio commands differently on native Windows.用 `cmd /c npx -y ssh-session-mcp --viewerPort=auto` 作为回退方案。部分 MCP client 在原生 Windows 上拉起 stdio 命令的方式并不一样。
These usually show up after the basic setup is already clear.这些问题通常会出现在你已经弄清基本接入方式之后。
Because remote shell state, prompts, editors, pagers, and long-running commands often matter across steps. A shared PTY preserves that context instead of forcing every turn to pretend it starts from zero.因为远程 shell 状态、提示符、编辑器、分页器和长任务经常会跨步骤持续存在。共享 PTY 能保住这些上下文，而不是让每一步都假装从零开始。
Because the terminal may be inside a pager, editor, or password prompt. In those states, diagnostics, history, or control inputs are safer than blindly sending another command string.因为终端可能已经进了分页器、编辑器或密码提示。在这些状态里，诊断、历史查看或控制输入会比盲发下一条命令更安全。
It stops the AI from typing over the human during interactive or risky shell moments, which is a common failure mode when both sides share one remote terminal.它能阻止 AI 在交互态或高风险时刻覆盖人的输入，而这正是共享同一远程终端时最常见的失败模式之一。
Because terminal output alone does not give the human a live, interruptible window into prompts, shell state, or operator takeover. The browser viewer does.因为单纯的终端输出并不能给人一个可实时旁观、可中断、可接管的窗口去看提示符和 shell 状态，而浏览器 viewer 可以。
Install keeps the commands together, resources keeps the links together, and use cases adds context.安装页集中命令，资源页集中链接，场景页补背景。