最近一段时间我继续完善了自己的 C/Qt Windows 桌面项目 DirBridge。在上一篇文章中我主要介绍了 DirBridge 的第一阶段能力本地与远程双栏文件管理、FTP/SFTP 目录浏览、站点配置、多远程会话、上传下载、拖拽传输和全局传输队列。这些功能解决了“文件怎样在本地与服务器之间流动”的问题。但在真实的开发和部署过程中传完文件通常并不意味着工作结束。上传构建产物之后往往还需要执行脚本修改配置之后可能需要重新加载服务发现异常时还要继续查看进程、日志和运行状态。如果每次都要离开文件管理工具再单独打开终端、查找服务器信息并重新连接整个操作过程就会被拆成几段。因此DirBridge 在原有远程文件管理能力的基础上加入了内嵌 SSH 终端希望把文件操作和远程命令连接成一条连续的工作流在同一个界面中浏览和传输文件然后直接打开对应服务器的 SSH 终端继续完成命令操作。项目地址GitHubhttps://github.com/shy117/DirBridgeReleaseshttps://github.com/shy117/DirBridge/releases一、DirBridge 当前的整体形态DirBridge 目前仍然是一款面向 Windows 的 FTP/SFTP 双栏文件管理工具但它已经不再只处理文件传输。当前主要工作区域包括左侧的站点和会话管理中间的本地与远程文件面板底部的传输队列、日志和 SSH 终端多个彼此独立的远程文件会话与终端标签。文件面板负责浏览目录、上传下载、拖拽传输和远程文件操作SSH 终端负责执行交互式命令。两者放在同一个主窗口中但在实现和生命周期上保持独立。这种组合不是简单地“再增加一个终端页面”而是让 DirBridge 从单一的文件传输工具逐步变成一个面向远程操作的桌面工作台。当前内嵌终端已经支持多个独立 SSH 终端标签ANSI 颜色和基础终端属性光标、滚动历史和窗口尺寸变化文本选择、复制和粘贴中文输入、双宽字符和组合字符Tab、方向键及常用终端键盘操作终端区域最大化右键直接粘贴。二、为什么文件管理之后还需要 SSH以一次常见的部署过程为例操作可能包括在本地找到构建产物或配置文件通过 SFTP 上传到服务器的目标目录登录同一台服务器检查文件是否到位执行部署脚本、重启服务或查看日志根据结果继续修改和上传文件。文件传输与命令操作本来就是连续发生的但传统工作方式经常需要在文件管理器和终端软件之间来回切换。DirBridge 加入 SSH 终端后可以从当前 SFTP 站点或远程文件会话直接进入同一服务器的终端。连接信息来自已有站点文件面板和终端也可以同时保留在界面中。这样用户关注的不再是“应该打开哪个工具”而是当前任务本身文件是否上传成功命令是否执行完成服务器返回了什么结果。三、文件操作与命令操作形成连续工作流加入 SSH 终端后DirBridge 可以覆盖一条更完整的远程操作流程选择本地文件 ↓ 上传到 SFTP 远程目录 ↓ 从当前站点或会话打开 SSH 终端 ↓ 进入相同的远程目录 ↓ 检查文件并执行命令 ↓ 根据结果继续上传、下载或编辑整个过程中本地文件、远程目录、传输结果和终端输出都能在同一个窗口中看到。1. 上传文件首先在文件面板中选择本地文件并上传到目标目录通过传输状态确认任务已经完成。2. 打开 SSH 终端DirBridge 为 SSH 终端保留了两个入口SSH 终端可以复用已保存 SFTP 站点的连接信息。上传完成后可以从已保存的 SFTP 站点直接打开 SSH 终端如果当前正在操作一个已经打开的 SFTP 远程文件会话也可以从对应的会话标签打开终端这两个入口是同一步骤的两种选择不需要依次执行。前者适合从站点开始操作后者适合在文件管理过程中继续进入终端。3. 进入目录并执行命令SSH 连接建立后可以进入刚才上传文件的远程目录使用pwd、ls -l或其他测试命令检查文件和环境。上面的四张截图分别展示了文件上传、两种终端入口和命令执行结果完整呈现了从文件管理进入远程命令操作的过程。这种体验对远程编辑同样有帮助。远程文件可以使用 Windows 默认应用打开保存后同步回原路径随后可以直接切换到终端进行格式检查、运行脚本或观察程序输出。DirBridge 并没有把所有功能强行揉成一个流程而是让文件管理、远程编辑和终端在需要时自然衔接。四、SSH 终端与 SFTP 不是同一条连接虽然 SFTP 和 SSH 都与远程服务器有关但它们在 DirBridge 中承担不同职责。SFTP 文件链路主要负责远程目录读取文件上传和下载新建、删除、重命名和移动远程文件编辑同步传输任务、进度和失败状态管理。SSH 终端链路主要负责启动交互式远程 Shell接收键盘输入并持续显示远程输出维护光标、颜色、屏幕状态和滚动历史处理窗口尺寸变化管理每个终端标签的连接与关闭过程。DirBridge 的 SFTP 文件功能继续由 libcurl 和原有传输体系负责SSH 终端则通过 Windows ConPTY 与系统 OpenSSH 客户端建立独立链路。这样划分有几个直接好处关闭或断开一个文件会话不会自动关闭已经创建的终端一个终端连接失败不会中断正在进行的文件传输多个终端标签可以分别维护自己的输入、输出和生命周期文件传输队列不需要承担交互式终端字节流。两条链路共享用户入口和工作场景但不会因为界面整合而混淆各自职责。五、Windows 原生 SSH 终端技术路线DirBridge 当前采用的终端链路可以概括为输入会从 Qt 界面传递到终端会话再经过 ConPTY 和ssh.exe发送到远程服务器服务器返回的内容则沿相反方向进入终端内核最终由 Qt 控件绘制到界面上。1. 使用系统 OpenSSH 建立连接DirBridge 没有重新实现 SSH 协议而是使用 Windows 自带的 OpenSSH 客户端也就是ssh.exe完成远程登录和数据传输。主机指纹验证、SSH 密钥、Agent 和known_hosts等能力仍由 OpenSSH 负责。这样既可以复用 Windows 已有的 SSH 环境也能避免在应用内部维护另一套 SSH 协议实现。2. 使用 ConPTY 承载交互式终端ssh.exe是一个控制台程序Qt 图形界面不能只靠普通输入输出重定向就完整支持光标移动、窗口尺寸变化和全屏终端程序。DirBridge 使用 Windows ConPTY 在图形界面与ssh.exe之间建立伪终端通道。它负责传递键盘输入、终端输出和窗口尺寸变化让远程 Shell 获得接近真实终端的运行环境。每个终端标签都有独立的终端代理进程用来管理自己的 ConPTY、ssh.exe和输入输出通道。关闭某个终端标签不会影响其他终端也不会因为文件会话断开而结束已经建立的 SSH 连接。3. 使用终端内核解析和绘制内容ConPTY 负责传递终端数据但不会替应用解释颜色、光标位置、字符宽度和屏幕状态。DirBridge 使用 Ghostty VT 运行库维护终端状态再把解析后的画面交给 Qt 控件绘制。Qt Widgets 负责标签、布局、键盘、输入法、文本选择和最终显示。这也是为什么内嵌终端不能简单地使用一个多行文本框实现。一个真正可交互的终端还需要正确处理 ANSI 颜色、中文双宽字符、滚动历史、光标控制以及vim、top等全屏终端程序使用的屏幕模式。六、运行环境、兼容性与当前限制DirBridge 当前面向 Windows x64内嵌 SSH 终端还依赖以下系统能力Windows ConPTYWindows 系统 OpenSSH 客户端。发布包已经包含 Qt、libcurl、Ghostty VT 和必要的运行组件但系统 OpenSSH 仍需由当前 Windows 环境提供。DirBridge 将 SSH 终端作为一项相对独立的能力。即使当前环境不满足终端运行条件FTP/SFTP 文件浏览和传输功能也不应该受到影响。这种边界可以避免为了增加终端功能直接提高整个文件管理工具的最低系统要求。不同 Windows 版本在 ConPTY 的关闭和资源回收行为上可能存在差异。为此DirBridge 使用独立终端代理进程隔离每个终端会话使终端标签关闭或异常退出时相关进程和资源能够沿明确边界回收而不会影响长期运行的主界面进程。目前项目已经验证了终端创建、输入输出、窗口尺寸调整、重复连接和关闭流程。不过不同 Windows 版本、服务器环境、远程 Shell 和网络条件仍可能带来差异。vim、nano、top等全屏程序以及中文输入、复制粘贴和长时间运行会话仍需要在更多真实环境中持续验证。项目当前仍处于迭代阶段在重要数据环境中使用前建议保留备份并优先在专用测试目录中确认自己的工作流程。七、当前状态与后续方向截至本文编写时DirBridge 已发布v0.7.2。SSH 终端并不是一个孤立增加的页面。它与文件浏览、文件传输和远程编辑共同组成了 DirBridge 当前的远程操作流程通过本地与远程文件面板管理文件使用传输队列查看上传、下载和目录任务使用 Windows 默认应用编辑远程文件并同步回服务器从 SFTP 站点或文件会话直接打开 SSH 终端在终端中继续执行命令、检查文件和查看运行结果。在加入 SSH 终端之后项目也继续完善了远程文件操作、目录传输状态、任务取消、列表状态保持和远程编辑缓存等基础体验。这些改进的目标不是单纯增加功能数量而是让用户在处理文件、执行命令和查看结果时始终能够明确当前操作对象和执行状态不同文件会话、传输任务和终端连接之间也不会互相干扰。接下来DirBridge 会重点推进在更多 Windows 版本和真实服务器环境中验证 SSH 终端完善全屏终端程序、中文输入和复制粘贴体验优化终端连接失败、关闭和异常退出时的提示继续提高远程文件操作和传输流程的稳定性根据实际使用反馈完善文件管理、远程编辑与命令操作之间的协作体验。DirBridge 仍处于持续开发阶段。当前目标不是快速扩展成一个大而全的远程管理平台而是在清晰的模块边界下把文件管理、文件传输、远程编辑和 SSH 命令操作逐步连接成一套稳定、顺畅的工作流。总结第一阶段的 DirBridge 解决了本地与远程服务器之间的文件管理问题。加入内嵌 SSH 终端后它开始继续解决文件到达服务器之后的操作问题。从 SFTP 站点或远程文件会话打开终端可以减少重复查找连接信息和切换工具的过程独立的 SFTP 与 SSH 链路则让文件传输和交互式命令各自保持清晰职责。对我来说这次迭代的价值不只是把 ConPTY 和 OpenSSH 接入 Qt 界面而是让“上传文件、执行命令、查看结果、继续调整”成为一条更自然的工作流。如果你也对 C/Qt 桌面开发、Windows 终端、OpenSSH 或远程文件管理工具感兴趣欢迎关注 DirBridge也欢迎反馈实际使用中遇到的问题。GitHubhttps://github.com/shy117/DirBridgeReleaseshttps://github.com/shy117/DirBridge/releases
)
