界面概览
本页面介绍 BShellX 客户端的主要界面，以及它与 BShellX 服务端用户中心的关系。
BShellX 是桌面 SSH / SFTP 客户端；BShellXM 是官网、用户中心、许可证、设备和后台管理服务。日常连接服务器、文件传输、命令执行都在客户端完成；账号登录、许可证查看、设备管理、充值和离线激活等操作由服务端网页提供。
客户端主界面
客户端启动后默认进入「快速连接」界面。当前版本没有传统菜单栏和独立工具栏，主要操作集中在顶部标签栏、左侧主机列表、右侧连接表单，以及连接成功后的终端状态栏。
┌────────────────────────────────────────────────────┐
│ 标签栏：会话标签、新建会话、网络状态、授权、主题 │
├──────────────┬─────────────────────────────────────┤
│ │ │
│ 主机列表 │ SSH 连接表单 / 终端 / SFTP │
│ │ │
├──────────────┴─────────────────────────────────────┤
│ 终端状态栏：连接状态、主机信息、文件管理、端口转发等 │
└────────────────────────────────────────────────────┘功能区域
1. 顶部标签栏
顶部标签栏用于管理当前打开的会话。
| 区域 | 功能 |
|---|---|
| 会话标签 | 显示快速连接页、SSH 终端标签和 SFTP 标签 |
+ 按钮 | 新建一个快速连接标签 |
| 更多标签按钮 | 标签较多时展开标签列表并搜索切换 |
| 网络状态 | 显示 SSH、SFTP、文件上传下载、云端同步、AI 外发等活动 |
| Pro 授权中心 | 查看当前授权、试用状态，导入许可证或进行在线/离线激活 |
| 主题按钮 | 在亮色和暗色主题之间切换 |
2. 主机列表
左侧主机列表保存连接过的服务器，支持按分组管理。
可用操作
- 搜索主机名称或 IP 地址。
- 点击主机记录，将服务器信息填入右侧连接表单。
- 点击分组节点展开或收起主机。
- 点击记录右侧删除按钮移除单条主机。
- 使用顶部按钮导入、导出、清空主机列表。
- 使用云端同步，将本地主机列表加密上传到云端，或从云端下载并合并到本地。
连接记录保存在客户端本地。勾选「记住凭据」后，密码或私钥会通过客户端安全存储能力保存，列表中会显示凭据标记。
3. 快速连接表单
右侧连接表单用于创建 SSH 或 SFTP 会话。
填写步骤：
- 输入服务器名称和所属分组。名称与分组可选，用于后续在主机列表中识别。
- 输入主机地址、端口和用户名。
- 选择认证方式：密码认证或私钥认证。
- 如需保存凭据，勾选「记住凭据」。
- 点击「连接 SSH」进入终端，或点击「连接 SFTP」直接打开文件管理器。
连接成功后，本次连接会自动写入左侧主机列表，后续可以点击记录快速复用。
4. SSH 终端区域
点击「连接 SSH」后，当前标签会切换为 SSH 终端。
可用操作
- 在终端中输入并执行远程命令。
- 连接成功后，底部状态栏会显示「已连接」以及
用户名@主机:端口。 - 双击底部主机信息可复制主机地址。
- 通过底部状态栏打开文件管理、命令库、端口转发或 AI 助手。
- SSH 断开或异常重连时，终端会显示对应提示。
5. 终端状态栏
终端连接成功后，底部状态栏会出现。
| 按钮 | 功能 |
|---|---|
| 终端主题 | 切换终端配色和字体大小 |
| 文件管理 | 在当前 SSH 会话旁打开 SFTP 文件管理器 |
| 端口转发 | 配置端口转发，属于 Pro 功能 |
| 命令库 | 打开内置命令和「我的片段」 |
| AI 助手 | 根据终端上下文生成排查建议或命令，属于 Pro 功能 |
SFTP 文件管理
SFTP 可以通过两种方式打开：
- 在快速连接表单中点击「连接 SFTP」，直接打开独立的 SFTP 标签。
- 在 SSH 终端底部点击「文件管理」，在终端左侧打开文件管理面板，然后点击「连接 SFTP」。
文件管理器支持目录浏览、远程文件读取和保存、本地上传、下载，以及下载任务的暂停、恢复和取消。
命令库与 AI 助手
「命令库」包含内置命令和自定义片段。自定义片段可以新建、编辑、复制、执行，也可以通过云端同步加密。
「AI 助手」会读取当前终端上下文和选中文本，用于生成解释、排查步骤和命令建议。执行变更类命令前，客户端会弹出确认；高风险命令会被拦截。
快捷入口：
Ctrl+Shift+A/Cmd+Shift+A：打开 AI 助手。Esc：AI 助手打开时关闭助手面板。
授权与服务端用户中心
客户端右上角的「Pro 授权中心」用于查看当前授权状态。
可在客户端完成的操作：
- 点击右上角授权按钮，打开「Pro 授权中心」。
- 查看当前是免费版、试用中还是 Pro 已激活。
- 查看许可证 ID、绑定账号、到期时间和可用 Pro 功能。
- 点击「刷新状态」重新读取授权信息。
- 点击「导入许可证」选择
.lic或.json许可证文件。 - 在在线激活中输入激活码，或按离线激活向导生成请求码、访问服务端离线激活页并导入许可证文件。
需要在 BShellXM 服务端网页完成的操作：
| 页面 | 用途 |
|---|---|
| 官网首页 | 查看产品信息和下载入口 |
| 登录 / 注册 | 创建账号并进入用户中心 |
| 用户中心 | 查看账号概览 |
| 我的许可证 | 查看许可证列表和状态 |
| 我的设备 | 查看已绑定设备，必要时解绑设备 |
| 云端同步 | 管理服务端提供的同步配置 |
| 推荐奖励 | 查看推荐链接和积分 |
| 充值 | 使用充值码或积分兑换 |
| 离线激活 | 上传客户端请求码并生成许可证文件 |
服务端还提供管理后台，用于管理员维护用户、许可证、设备、云端同步、激活码、订单、版本和积分。普通用户无需进入管理后台。