问题排查

另一个 SSH 客户端能连接，eShell 提示 Connection refused

先对比两边的主机、端口、用户名、代理或跳板设置。常见情况是另一个客户端使用 10022，eShell 仍填默认 22。

查看 eShell 连接日志中的 Connecting TCP: 地址:端口。连接拒绝发生在 TCP 阶段，此时尚未进入密码认证。确认实际端口和服务器监听；若另一个客户端使用单级 SSH 跳板，请在目标会话选择已保存的跳板配置；网关需允许 TCP 转发。通用 SSH 代理尚不支持。

第一次打开只有空白或 Reconnect

启动时只恢复标签描述，不自动连接。新版首次点击恢复的标签或侧栏会话会开始连接并显示日志。此前失败或取消过的实例需要显式点击 Reconnect。若点击仍无日志，核对启动的是已更新的安装目录，而非旧快捷方式。

记住了密码，为什么还出现登录窗口

依次检查：上一次是否成功连接后才保存、是否仍是同一个保存配置与配置路径、服务器密码是否更换、当前是否选择私钥认证。保存密码被拒绝后，会显示登录窗口让你更正，不会无限重试。

首次主机指纹确认独立于密码保存。参考连接与认证。

找不到复制会话、IP 粘贴或其他菜单

复制会话在标签右键菜单；IP 粘贴在内容区右键菜单。新版分别放在顶部。长菜单有滚动条，部分操作需要向下滚动。远端程序启用鼠标模式时，按 Shift+右键。

未连接时 Duplicate SSH Channel 和 IP 粘贴会灰显。确认运行的是包含新菜单的版本。

本机 IP 为什么不是公网 IP

该操作取当前 SSH TCP 连接使用的本地端点地址。经过 VPN 时可能是 VPN 地址，局域网直连时可能是局域网地址；它不查询公网出口地址。

SSH 能登录，但 SFTP 无法打开

请确认服务器启用了 SFTP 子系统，以及登录用户拥有目标目录权限。某些精简 SSH 服务只开放 Shell。查看传输窗口中的具体错误，不要把它当作密码一定失效。

上传同名文件会失败；当前上传不覆盖远端文件。网络中断后检查是否有残留临时文件，详见 SFTP。

文件预览与原文档排版不同

PDF 使用原生页面渲染；Word 和 PowerPoint 主要提取文字，Excel 展示保存的数据值，不是完整 Office 编辑器。需要完整排版时在 Files 中按 Enter 用默认应用打开。

文件树为什么没有跟随 cd

Files 根目录来自项目或会话启动目录，不读取 Shell 当前目录。切换项目后核对根路径，文件变更后刷新。旧版本若没有自动切换根目录，请更新应用。

无法覆盖 exe 或更新后仍是旧界面

先退出对应应用。核对快捷方式目标和实际运行路径，再替换完整运行目录。不要只替换压缩包里的某一个 DLL。

Alt+O 没有打开会话管理器

使用包含此快捷键修复的 eShell 构建，终端获得焦点后按 Alt+O。它打开本机 SSH 会话管理器，不发送到服务器；普通 Shell、tmux/Claude 和移到独立窗口的终端均支持。先关闭已有设置、认证或粘贴确认对话框，再重试。旧版本可通过 + Session 或 SSH 标签的右键菜单打开管理器。

输入或回显有延迟

更新后的构建移除了 SSH 输入逐条等待和额外的输出刷新延后。文字仍由服务器回显，因此实际响应也受网络和远端程序影响；光标闪烁不会让文字等待下一次闪烁才显示。

请在同一连接中分别测试普通 Shell 与 tmux/Claude，记录连续输入、退格和调整窗口尺寸时的差异。若仅 tmux/Claude 出现明显延迟，反馈该场景及版本；若全部场景都有延迟，请一并提供是否经 VPN/代理及其他客户端的对照结果。真实桌面响应仍需手测，回环测试数据不代表服务器体验。

如何反馈

记录应用版本/构建、Windows 版本、DPI、操作步骤、期望和实际结果。SSH 问题可附连接阶段与脱敏后的错误。截图避免包含密码、私钥、令牌和无关终端输出。可通过源码仓库反馈。