01 入门与界面概览

1.1 系统要求

WxTerm 是原生跨平台应用，支持以下操作系统：

平台	最低版本	备注
Windows	Windows 7	64 位；Win7 需使用专版安装包（见官网下载页），Win10 及以上用标准版
macOS	10.15 Catalina	Intel 与 Apple Silicon 均可
Linux	任意现代发行版	需有图形环境（X11 或 Wayland）

无需安装 Java、Electron 或浏览器运行时，单文件即可运行。

1.2 安装

Windows

1. 从官网下载安装包。
2. 双击运行安装程序。
3. 安装完成后从开始菜单启动「WxTerm」。

串口功能需要系统已安装对应的串口驱动（如 USB 转串口芯片的 CH340/CP2102/FT232 驱动）。

macOS

1. 下载 WxTerm-x.y.z.dmg。
2. 打开 DMG，将 WxTerm 拖入「应用程序」文件夹。
3. 首次启动若提示「无法验证开发者」，请前往「系统设置 → 隐私与安全性」点击「仍要打开」。

Linux

1. 下载对应格式的包（.AppImage / .deb / .rpm）。
2. AppImage：赋予执行权限后直接运行 chmod +x WxTerm-*.AppImage && ./WxTerm-*.AppImage。
3. deb：sudo dpkg -i wxterm_*.deb；rpm：sudo rpm -i wxterm-*.rpm。

Linux 下 X11 转发功能需要系统已安装 X11 相关库（libxcb 等，多数桌面发行版默认已具备）。

1.3 首次启动

配置目录

• Linux/BSD: ~/.wxterm/
• macOS: ~/Library/Application Support/wxterm/
• Windows: %APPDATA%\wxterm\

首次启动 WxTerm 时，应用会：

1. 在用户主目录下创建配置目录，用于存放会话、密钥、主题、快捷键等配置。
2. 加载默认的深色主题与系统语言（若系统语言在支持的 20+ 种之列）。
3. 显示欢迎屏。

欢迎屏

当没有任何终端标签页打开时，主区域显示欢迎屏，提供三个快捷入口卡片：

卡片	功能	等价操作
快速连接	弹出快速连接对话框，临时输入主机信息连接，不保存会话	菜单「文件 → 快速连接」或 Ctrl+Q
新建会话	弹出新建会话对话框，配置并保存一个会话	菜单「文件 → 新建会话」或 Ctrl+N
本地终端	直接打开一个本地 Shell 标签页（bash/zsh/PowerShell/cmd，取决于系统）	工具栏「本地终端」按钮

欢迎屏卡片在「Sci-Fi」主题下会显示 HUD 风格的科幻边角装饰，详见 09.个性化定制。

1.4 主界面布局

WxTerm 主窗口采用经典的多区域布局，从上到下、从左到右依次为：

┌─────────────────────────────────────────────────────────────┐
│  标题栏 (TitleBar, 38px)                                     │
│  [侧栏开关]  WxTerm  [语言][主题][最小化][最大化][关闭]        │
├─────────────────────────────────────────────────────────────┤
│  菜单栏 (MenuBar, 28px)                                      │
│  文件  编辑  视图  选项  工具  帮助                            │
├──────────┬──────────────────────────────────┬───────────────┤
│          │                                  │               │
│  会话    │                                  │   SSH 侧栏    │
│  侧栏    │       终端区域（标签页）          │  (仅 SSH 会话)│
│ (Session │                                  │  + AI 抽屉    │
│  Sidebar)│                                  │  (按需展开)   │
│          │                                  │               │
├──────────┴──────────────────────────────────┴───────────────┤
│  状态栏 (StatusBar)                                          │
│  [连接状态]  协议  传输任务  分屏切换  标签数  版本  时钟      │
└─────────────────────────────────────────────────────────────┘

各区域说明

标题栏（TitleBar）

• 高度 38px，无边框窗口的自绘标题栏。
• 左侧：会话侧栏显示/隐藏开关。
• 中间：应用名称「WxTerm」。
• 右侧：当前语言快捷切换、主题快捷切换、窗口最小化/最大化/关闭按钮。
• 拖动标题栏可移动窗口；双击可最大化/还原。

菜单栏（MenuBar）

• 高度 28px，包含 6 个顶级菜单：文件 / 编辑 / 视图 / 选项 / 工具 / 帮助。
• 各菜单的详细功能见后续章节，速查见 12.键盘快捷键参考。

工具栏（ToolBar）

• 高度 38px，位于菜单栏下方（可通过「视图」菜单隐藏）。
• 提供常用操作的快捷按钮：快速连接、本地终端、重新连接、新建会话、断开、复制、粘贴、查找、设置、快捷键编辑器、公钥助手、登录。
• 最右侧为账户登录区域，显示当前登录状态与套餐信息。

会话侧栏（Session Sidebar）

• 左侧栏，以树形结构展示已保存的会话与文件夹。
• 支持搜索过滤、右键菜单（新建文件夹/会话、编辑、删除、导入导出、连接）。
• 拖拽会话可调整顺序或移动到不同文件夹。
• 可通过 Ctrl+B 或标题栏开关、菜单「视图 → 侧栏」切换显示。

终端区域

• 主工作区，显示当前活跃标签组的终端内容。
• 支持多标签页、标签组、垂直分屏（详见 03.终端、标签页与分屏）。
• 终端支持真彩色、Unicode、连字（ligatures）。

SSH 侧栏（SSH Sidebar）

• 仅在当前活跃标签为 SSH 会话时显示，位于右侧。
• 由一个 28px 的图标条 + 320px 的内容面板组成，包含三个面板：
  • 系统概览：远程主机的 CPU、内存、磁盘、网络、操作系统信息。
  • 文件浏览：SFTP 远程文件管理器，支持上传/下载/拖拽/右键操作。
  • 传输列表：当前会话的文件传输任务列表与进度。
• 可通过图标条切换面板或折叠侧栏。

AI 抽屉（AI Drawer）

• 每个标签组右侧的 [AI] 按钮或 Ctrl+Shift+A 展开，与 SSH 侧栏并列。
• 用自然语言指挥 AI 在当前连接的机器上执行命令、读写文件、诊断故障。
• 详见 15 AI 助手。

状态栏（StatusBar）

• 底部状态栏，显示：
  • 左侧：连接状态图标与文字（连接中 / 已连接 / 已断开）。
  • 右侧：传输任务数、接收任务数、Modem 传输数、分屏方向切换、标签组数、当前协议、版本号、实时时钟。
• 点击传输任务数可恢复显示传输队列面板。

1.5 基本操作流程

一个典型的使用流程如下：

1. 连接远程主机：通过「快速连接」临时连接，或先「新建会话」保存后再从会话侧栏双击连接。
2. 进行终端操作：在终端区域输入命令，使用复制/粘贴/查找等编辑功能。
3. 传输文件（SSH）：通过 SSH 侧栏的文件浏览面板拖拽传输，或使用菜单「工具 → 上传/下载」。
4. 使用高级功能：按需打开系统管理、端口转发、脚本录制等工具。
5. 结束会话：关闭标签页或使用菜单「文件 → 断开」；远程登出后会自动断开并关闭窗口。

1.6 配置文件位置

配置目录

• Linux/BSD: ~/.wxterm/
• macOS: ~/Library/Application Support/wxterm/
• Windows: %APPDATA%\wxterm\

所有用户配置均存储在配置目录下，便于备份与迁移：

路径	内容
sessions.json	会话与文件夹配置（含加密的密码）
keys	SSH 密钥文件存放目录
themes.json	自定义主题文件
keymap.json	自定义快捷键映射
scripts	录制的终端脚本存放目录
settings.json	全局设置（终端、连接、键盘等）
logs	终端日志存放目录（开启日志记录时）

会话密码使用主密钥（masterKey）加密存储，详见 10.账户、激活与云端同步。

1.7 退出应用

• 菜单「文件 → 退出」或按 Alt+F4。
• 关闭主窗口时若有活跃连接，会弹出确认对话框（可在设置中关闭确认）。
• 退出时会自动保存会话侧栏状态、窗口大小、最近使用的会话等。