---
slug: /
---

# 项目介绍

**NyaTerm** 是一个围绕远程终端工作流设计、基于 GPUI 构建的原生桌面客户端。它通过 Rust workspace 统一实现桌面界面、终端渲染、SSH、SFTP、会话管理、隧道、认证、AI 能力、云同步与配置持久化，让你在同一个工作区中处理远程服务器、本地 shell、串口设备和网络辅助能力。

## 使用场景

- 同时维护多台 SSH 主机
- 在本地终端、Telnet、串口设备之间切换排障
- 边看终端输出边操作远程文件
- 为常用运维命令、登录流程和跳板机链路做标准化配置
- 需要 OTP、录制、资源监控、自动上传、AI 辅助、跨设备配置同步或本地加密备份等增强能力
- 想从 Xshell、MobaXterm、WindTerm、SecureCRT、FinalShell、Termius 或 NyaTerm 备份文件快速迁移现有配置

## 核心能力

### 多种会话类型

NyaTerm 当前支持六类会话：

- **SSH** — 远程登录、文件传输、资源监控、隧道、OTP 等完整能力
- **本地终端** — 在同一套 UI 中打开本地 shell
- **Telnet** — 兼容旧设备或实验环境
- **串口** — 网络设备、嵌入式板卡、调试口
- **RDP** — Windows 远程桌面和图形化运维
- **VNC** — 传统 RFB/VNC 服务和虚拟机控制台；真实服务器互通范围仍在持续验证

### 可组合的工作区

- 多标签页管理多个会话
- 标签页内支持**横向/纵向分屏**，并可通过拖拽把标签停靠到目标分屏区域
- 可恢复终端窗口布局，并通过 Workspace Padding 调整终端区域间距
- 命令面板与会话快速切换器可快速查找动作、会话和已保存连接
- 左右活动栏可放置文件浏览器、网络、Security/Auth、云同步、设置、AI 助手、会话列表、命令历史、资源监控等面板
- 底部辅助区可承载快捷命令、串口发送、录制与锁屏入口
- 设置、新建连接、快捷命令、远程文件编辑、自动上传提示均使用独立子窗口，减少主工作区干扰
- 支持托盘最小化和隐藏主窗口，让关闭动作可以转为后台驻留

### 面向终端操作的增强

- 命令历史与模糊建议，可在交互式程序中自动抑制建议干扰
- 可配置命令建议的历史命令长度上下限，减少超长命令带来的噪音
- 终端搜索、搜索历史、结果计数、复制/粘贴、上下文菜单
- 支持终端缩放、字体粗细、工作区间距、原生输入法和图片路径粘贴
- 选中文本后可直接做**在线搜索**或按 provider **翻译**
- 可选的**行号 / 时间戳 gutter**
- 可选的**动作链接**（如 IPv4、`host:port`、压缩包文件名）
- 可选的**关键词高亮**与自定义规则
- 大输出场景下的保护机制、会话录制与 SSH Keep-Alive
- 支持直接在终端中使用 **Zmodem**（`rz`/`sz`）和 **trzsz**（`trz`/`tsz`）进行文件传输
- 支持自定义终端与界面操作的**键盘快捷键**

### 远程文件与传输队列

- SSH 会话下内置 SFTP 文件浏览器
- 上传、下载、重命名、移动、删除、属性查看、新建文件 / 文件夹 / OpenSSH 兼容符号链接
- 传输队列支持速度显示、暂停、继续、取消、失败重试、重复目标处理、断点续传、时间戳保留
- 在本地编辑下载的远程文件后，可通过 watcher 流程快速上传回远端
- Windows 下支持把本地文件或文件夹直接拖进文件浏览器上传

### AI 助手与自动化辅助

- 右侧活动栏内置 **AI Assistant** 面板
- 支持两种模式：**Ask**（单次问答）和 **Agent**（多步自主执行）
- 可从终端输出、选中文本、文件操作或手动输入发起 AI 请求
- 支持命令生成、错误分析、输出解释、修复建议等典型场景
- Agent 模式使用 ReAct 循环自主执行命令并观察结果，可配置最大步数和超时
- Agent 命令执行与最终回答分离，审批后的真实命令输出和面向用户的总结更容易追踪
- 可配置内置 provider、自定义 **OpenAI Compatible** provider、手动模型和凭据分组
- 支持结构化命令卡片、风险等级控制、审批后执行和保存为快捷命令
- 支持推理内容展示（适配 DeepSeek R1、QwQ 等模型的推理通道）
- 输入 `@` 可提及其他会话，跨会话引入上下文
- 多会话管理、历史搜索与分组浏览
- 终端输入时的实时命令风险评估与安全替代建议

### 安全、迁移与网络能力

- 私钥、密码、主机密钥策略、本地加密存储
- **凭据管理**：基于正则匹配的终端密码自动填充
- OTP 管理（TOTP / HOTP）、二维码导入、SSH 自动填充
- 支持 SOCKS5、HTTP、ProxyCommand、跳板机链路校验、本地 / 远程 / 动态隧道和 SSH X11 转发
- 锁屏、主密码与空闲应用锁定能力
- 支持导入 **Xshell / MobaXterm / WindTerm / SecureCRT / FinalShell / Termius** 会话，以及 NyaTerm/Electerm JSON
- 支持导入 / 导出 NyaTerm 自身的加密 `.nya` 配置备份
- 可打开日志目录并导出诊断包，便于问题排查与支持协作

### 云同步

- 支持 **WebDAV**、**S3 兼容**存储、**Gitee 代码片段**、**GitHub Gist**、**Google Drive**、**OneDrive** 和 **AliyunDrive** 七类远程存储
- 在 **设置 → 安全** 配置主密码后，才能启用 **设置 → 云同步** 中的相关能力
- 支持启动检查、保存后的防抖自动推送和手动推送 / 拉取
- 当本地和云端都发生变化时，可在设置页或工作区历史面板中手动处理冲突

## 文档导航建议

第一次使用时按下面顺序阅读：

1. [安装指南](./getting-started/installation)
2. [快速开始](./getting-started/quick-start)
3. [会话类型](./guide/session-types)
4. [SSH 连接管理](./guide/ssh-connection)
5. [工作区与布局](./guide/layout-and-workspace)
6. [终端功能](./guide/terminal)
7. [SFTP 文件传输](./guide/file-transfer)
8. [代理、跳板机与隧道](./guide/tunnels-and-proxy)
9. [OTP 与认证](./guide/otp-and-auth)
10. [AI 助手](./guide/ai-assistant)
11. [安全功能](./guide/security)
12. [云同步](./guide/sync-and-backup)