Tabby 全解析：跨平台终端模拟、SSH 客户端与串口终端的功能实现指南

2026-09-03 15:34:29作者：宗隆裙

Tabby（前身为 Terminus）是一个面向 Windows、macOS 和 Linux 的终端模拟器，内置 SSH/Telnet 客户端与串口终端能力，以"插件化 monorepo + Electron"为技术底座。本文基于项目官方 README（西班牙语版本，见 README.es-ES.md）逐节展开其功能定位、终端特性、SSH 客户端、串口终端、便携模式与插件/主题体系，并结合仓库内各子包源码（如 tabby-ssh、tabby-serial、tabby-terminal、app/lib/portable.ts）给出可验证的实现佐证，帮助读者建立从功能到源码的完整认知。

一、Tabby 是什么：定位与能力总览

官方文档对 Tabby 的定位非常明确：

Tabby 是：Windows 自带终端（cmd/PowerShell ISE）、PuTTY、macOS Terminal.app、iTerm 的替代方案；
Tabby 不是：一个新的 shell，也不是 MinGW 或 Cygwin 的替代品。它也不追求轻量——如果 RAM 占用是硬指标，官方建议考虑 ConEmu 或 Alacritty 这类更轻的工具。

README 列出的核心能力清单如下，每一项都能在当前仓库中找到对应的代码包：

README 中的能力	仓库内实现位置
集成的 SSH/Telnet 客户端与连接管理	tabby-ssh、tabby-telnet
内置串口终端	tabby-serial
配色方案与主题	tabby-community-color-schemes、tabby-core/src/theme.ts
全量可配置、多键位快捷键	tabby-core/src/hotkeys.ts、tabby-settings
分屏面板	tabby-core/src/components/splitTab.component.ts
记住上次的标签页（会话恢复）	tabby-core/src/services/tabRecovery.service.ts
PowerShell（含 PS Core）、WSL、Git-Bash、Cygwin、MSYS2、Cmder、CMD 支持	tabby-electron/src/shells
通过 Zmodem 从 SSH 会话直接传文件	依赖 zmodem.js（见 tabby-terminal/patches/zmodem.js+0.1.10.patch）
完整 Unicode 支持，包括全角（双宽）字符	渲染层由 xterm 前端提供，见 tabby-terminal/src/frontends
内置加密容器（Vault）存放 SSH 密钥与配置	tabby-core/src/services/vault.service.ts
Web 版 SSH/SFTP/Telnet 客户端	tab/、tabby-web

从源码结构看，整个项目是一个 monorepo：根 package.json 中声明了 Electron 38、Angular 15、TypeScript 与 Webpack 工具链；HACKING.md 也说明了这一点——"Tabby 是一个 Electron 应用，前端使用 TypeScript + Angular 编写，通过 Webpack 构建"。子包划分与 HACKING.md 中"Project layout"一节一致：tabby-core 提供基础 UI 与标签管理，tabby-terminal 提供终端标签页，tabby-local 提供本地 shell 与配置项，tabby-electron 封装 Electron 平台能力，tabby-plugin-manager 负责插件安装，tabby-settings 提供设置界面。

二、终端特性（Terminal Features）

README 在"Características de Terminal"一节列出 10 项终端能力，下面逐条对照仓库源码说明其实现位置：

VT220 及扩展协议的终端仿真：终端渲染由 xterm 前端封装完成，入口在 tabby-terminal/src/frontends（xtermFrontend.ts 等）。每个标签页是一个 Angular 组件（tabby-terminal/src/components/baseTerminalTab.component.ts），底层会话抽象为 tabby-terminal/src/session.ts 中的 BaseSession。
嵌套多分屏：分屏由 tabby-core/src/components/splitTab.component.ts 及其配套的 splitTabDropZone、splitTabSpanner 组件实现，支持拖拽分屏与嵌套。
窗口任意位置的标签页 + 可停靠"Quake 控制台"：标签位置与窗口停靠逻辑在 tabby-core/src/services/docking.service.ts 与 tabby-electron/src/services/docking.service.ts，全局快捷键在 tabby-electron/src/hotkeys.ts 注册。
进度检测与进程结束通知：终端会话通过 tabby-terminal/src/middleware 中的 OSC 处理中间件解析转义序列（OSCProcessor 见 tabby-terminal/src/session.ts 第 13 行），进度条与 cwd 上报均走这条 OSC 通道；通知走 tabby-core/src/services/notifications.service.ts。
括号粘贴（bracketed paste）与多行粘贴提醒：该特性在 tabby-terminal/src/config.ts 中作为终端配置项暴露，渲染端在 tabby-terminal/src/frontends/frontend.ts 中控制。
字体连字（ligatures）：在外观设置组件 tabby-terminal/src/components/appearanceSettingsTab.component.pug 中提供开关。
自定义 shell 配置项（profiles）：本地 shell 由 tabby-local/src/profiles.ts 提供；Windows 下具体 shell（PowerShell、WSL、Git-Bash、Cygwin、MSYS2、Cmder、CMD 等）逐一封装在 tabby-electron/src/shells 目录下，每个 shell 一个文件。
右键选择即复制（PuTTY 风格）：作为终端行为选项在 tabby-terminal/src/components/terminalSettingsTab.component.pug 中配置。
记住上次的标签页：由 tabby-core/src/services/tabRecovery.service.ts 配合各子包的 recoveryProvider.ts（如 tabby-ssh/src/recoveryProvider.ts、tabby-local/src/recoveryProvider.ts）实现，会话断开重开时按配置恢复。

理解这些特性的关键入口是 BaseSession 的中间件栈机制：tabby-terminal/src/session.ts 中，BaseSession 构造时向 SessionMiddlewareStack 压入 OSCProcessor，会话输出经 middleware.feedFromSession(data) 逐层处理后才渲染到终端，登录脚本（login scripts）也可以通过 setLoginScriptsOptions 动态挂入/替换中间件。README 中"登录脚本（Scripts de inicio de sesión）"特性在 tabby-terminal/src/components/loginScriptsSettings.component.pug 中有对应的配置界面。

三、SSH 客户端（Cliente SSH）

README 对 SSH 客户端的描述是五个要点：SSH2 客户端 + 连接管理器、X11 与端口转发、跳板机自动处理、agent 转发（含 GnuPG pageant 与 Windows 原生 OpenSSH agent）、登录脚本。仓库中 tabby-ssh 子包逐一印证了这些能力：

SSH2 协议实现：会话核心在 tabby-ssh/src/session/ssh.ts，基于 russh 库（第 19 行 import * as russh from 'russh'），认证方法类型覆盖 none、password、keyboard-interactive、publickey 与 agent（第 28-51 行 AuthMethod 类型定义）。
agent 转发：源码同时支持三类 agent 通道——Unix socket、命名管道、pageant（第 43-51 行）。其中第 21 行定义了 Windows 原生 OpenSSH agent 的管道名 \\.\pipe\openssh-ssh-agent，与 README"OpenSSH nativo de Windows"的表述完全对应。
端口转发与 X11：分别由 tabby-ssh/src/session/forwards.ts 与 tabby-ssh/src/session/x11.ts 实现；SFTP 通道在 tabby-ssh/src/session/sftp.ts。
跳板机（jump host）：tabby-ssh/src/session/ssh.ts 中 SSHSession 持有 jumpChannel 成员（第 101 行），即通过 SSH 隧道内再开一条通道连接最终目标，实现自动跳板。
连接管理与安全细节：known hosts 管理在 tabby-ssh/src/services/sshKnownHosts.service.ts，密码与密钥的加密存储在 tabby-core/src/services/vault.service.ts（对应 README"内置加密容器"能力），连接复用由 tabby-ssh/src/services/sshMultiplexer.service.ts 提供。
文件传输：README 提到的 Zmodem 直传走 zmodem.js，仓库甚至维护了对它的补丁 tabby-terminal/patches/zmodem.js+0.1.10.patch；右键 SFTP 上下文菜单在 tabby-electron/src/sftpContextMenu.ts。
算法协商：tabby-ssh/src/algorithms.ts 定义了可协商的算法集合，tabby-ssh/src/sshImporters.ts 支持从既有配置导入连接。

四、串口终端（Terminal Serie）

README 列出的串口能力是：保存的连接、类行读取输入、逐字节十六进制输入与可选 hexdump 输出、换行符转换、自动重连。对应实现集中在 tabby-serial 子包：

串口检测与打开在 tabby-serial/src/services/serial.service.ts：桌面端使用 @serialport/bindings-cpp，Web 端自动切换为 Web Serial API 绑定（第 16-18 行 detectBinding）。值得注意的是该服务提供 quickConnect 快捷连接——COM3@115200 这种"路径@波特率"语法可快速打开一个串口，默认波特率 115200（第 32-49 行）。
串口标签页与设置界面（波特率、换行转换、hex 模式等选项）在 tabby-serial/src/components/serialProfileSettings.component.ts 与 tabby-serial/src/components/serialTab.component.ts。
原生依赖 @serialport 的 C++ 绑定打了补丁维护在 app/patches/@serialport+bindings-cpp+11.0.3.patch，说明串口能力是桌面端的一等公民功能。

五、便携模式（Portable）

README 中的便携模式说明很短，但很具体：只要在 Tabby.exe 所在目录创建一个名为 data 的文件夹，Tabby 就以便携应用方式运行（配置、密钥等用户数据全部落在该目录，不写入系统用户目录）。

这条行为的完整实现就在 app/lib/portable.ts，全文仅 11 行，逻辑清晰：

通过 electron.app.getPath('exe') 拿到可执行文件所在目录；
检查该目录下是否存在 data 子目录；
若存在，则调用 app.setPath('userData', portableData) 把 Electron 的用户数据路径整体重定向到 data 目录（源码第 5-11 行，并打印 reset user data to ... 日志）。

也就是说，便携模式本质上是一个"启动时检测 + 用户数据路径重定向"机制，判断时机在应用启动最早期（app/lib 主进程代码），因此后续所有依赖 userData 路径的配置、密钥、插件目录都会自动落进便携目录。

六、插件与主题体系（Plugins y Temas）

README 指出：插件与主题可以直接在 Tabby 的"设置"视图中安装，并列举了社区插件清单（docker 容器连接、title-control、quick-cmds、save-output、sync-config、workspace-manager、sftp-tab、mcp-server 等）以及主题清单（hype、relaxed、gruvbox、windows10、altair 等）。仓库内这些能力的基础设施如下：

插件管理界面：tabby-plugin-manager 子包提供设置页（tabby-plugin-manager/src/components/pluginsSettingsTab.component.ts）与安装/更新服务（tabby-plugin-manager/src/services/pluginManager.service.ts）。
插件加载协议：HACKING.md 给出了明确的加载规则——只有 package.json 中包含 tabby-plugin 关键字的模块才会被加载；开发模式下从源码检出加载，此外始终从用户插件目录（Settings → Plugins 中的 "Open Plugins Directory"）以及 TABBY_PLUGINS 环境变量指定目录加载。在插件目录中可用 TABBY_PLUGINS=$(pwd) tabby --debug 启动调试。
插件的形态：插件默认导出一个 Angular NgModule（或带依赖的 NgModuleWithDependencies），作为根模块的依赖注入；功能通过导出 provider 提供（如 ToolbarButtonProvider）。插件的标准目录结构（src/components、src/services、api.ts、index.ts、package.json、webpack.config）在 HACKING.md 的"Plugin layout"一节中有完整示例。
仓库自带插件就是最佳范例：tabby-local、tabby-ssh、tabby-serial、tabby-telnet、tabby-community-color-schemes 等子包本身就是按上述结构编写的插件；其中 tabby-community-color-schemes 内置了数百个配色方案文件（tabby-community-color-schemes/schemes），由 tabby-community-color-schemes/src/colorSchemes.ts 统一导出。
主题与配色：核心主题能力在 tabby-core/src/theme.ts 与 tabby-core/src/services/themes.service.ts；终端配色方案的设置组件为 tabby-terminal/src/components/colorSchemeSettingsTab.component.ts，调色板生成逻辑见 tabby-terminal/src/generatePalette.ts。
插件黑名单与 Web 端限制：app/src/pluginBlacklist.ts 与 app/src/plugins.ts 管理应用启动时实际加载的插件集合。

从源码构建 Tabby（供二次开发与插件开发）

HACKING.md 给出了完整的构建流程，适用于希望从源码运行 Tabby 或开发插件的读者：

# 1. 安装依赖（Node.js 15+、Yarn）
# macOS & Windows:
yarn
# Linux（以 Debian/Ubuntu 为例，需先安装系统库）:
sudo apt install libfontconfig-dev libsecret-1-dev libarchive-tools libnss3 \
  libatk1.0-0 libatk-bridge2.0-0 libgdk-pixbuf2.0-0 libgtk-3-0 libgbm1 cmake
yarn

# 2. 构建并启动
yarn run build
yarn start

构建安装程序则先完成普通构建，再运行 node scripts/prepackage-plugins.mjs，然后按平台选择 node scripts/build-windows.mjs、node scripts/build-linux.mjs 或 node scripts/build-macos.mjs，产物输出到 dist 目录。需要说明的前提：若从上游 fork 了仓库，安装依赖前可能需要 git pull --tags upstream master 拉取 tag。

七、下载与分发渠道

README"Descargas"一节的分发渠道为：官方 releases 最新版本、基于 PackageCloud 的 Debian/Ubuntu 与 RPM 软件仓库、以及基于 CI 产出的 nightly 构建。与之对应的仓库侧证据：

应用自动更新配置在 app/dev-app-update.yml，更新逻辑在 tabby-electron/src/services/updater.service.ts；
Linux 打包描述文件为 electron-builder.yml 与 snap/snapcraft.yaml（Snap 渠道）；
仓库自带多语言本地化文件（locale 目录，含 zh-CN、ja-JP 等），与 README 顶部"本 README 可用多种语言阅读"（README.es-ES.md 中列出的语言切换表，其中 README.md 为英文版）相呼应。

八、小结：文档能力与源码实现的映射

把 README.es-ES.md 的功能清单当作"需求规格"，当前仓库的每个子包都能对号入座：终端能力落在 tabby-terminal + tabby-core，SSH/SFTP/跳板/agent 转发落在 tabby-ssh，串口落在 tabby-serial，Telnet 落在 tabby-telnet，本地 shell 与 Windows 生态适配落在 tabby-local + tabby-electron，加密 Vault 落在 tabby-core 的服务层，插件与主题体系则同时有运行时（tabby-plugin-manager）与开发规范（HACKING.md）双重文档化。这种"README 声明功能 → 子包提供实现"的一一对应关系，使得本文中的每一节结论都可以直接沿相对路径追溯到具体源码文件，便于进一步深入阅读。