Kang
f7875d7871
This commit replaces all instances of "Dragonfly" with "NyaTerm" in various files, including documentation, configuration, and UI elements. The changes ensure consistency in branding and improve clarity for users transitioning from the previous version. Additionally, updates to the changelog and README reflect the new application name and its features.
6.7 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
快速开始
本章帮助你在最短路径内体验 NyaTerm 的核心工作流：创建连接、打开会话、使用分屏、查看文件、启用终端增强功能，并了解迁移、AI 辅助与备份入口。
第一步：选择会话类型
点击 新建连接，你会看到四类可选会话：
- SSH — 最完整的远程运维场景
- 本地终端 — 直接在 NyaTerm 中打开本地 shell
- Telnet — 适合旧系统或实验环境
- 串口 — 适合串口调试设备
如果你只是第一次体验，建议优先创建一个 SSH 会话，再额外创建一个 本地终端 对比工作区效果。
第二步：创建第一个 SSH 连接
在新建连接窗口中填写：
- 连接名称 — 便于识别的显示名称
- 主机 与 端口
- 用户名
- 认证方式 — 密码或私钥
如有需要，还可以展开高级区域配置：
- 代理
- 跳板机
- OTP 绑定与自动填充
- 图标、分组、描述等元数据
保存后，连接会出现在已保存连接列表中。
第三步：如果你已有旧配置，直接导入
如果你之前已经在别的客户端维护了大量主机，不必手动重建。
NyaTerm 支持从以下来源导入：
- Xshell（
.xts） - MobaXterm（
.mxtsessions） - WindTerm（
.sessions） - NyaTerm 自己的加密备份文件（
.dgfy）
其中：
- 会话导入适合迁移连接清单
.dgfy导入适合恢复完整本地配置.dgfy导入 / 导出需要先设置 主密码
如果你只是想迁移 SSH 主机，通常从 已保存连接 面板的导入入口开始更快；如果你要恢复完整 NyaTerm 环境，再使用 .dgfy 更合适。
第四步：启动并理解工作区
双击已保存连接，或者右键选择连接，即可启动会话。
连接建立后，你会看到：
- 中央区域 — 当前终端标签页与分屏窗格
- 左侧活动栏 — 文件浏览器、网络、Security/Auth、云同步与备份、设置等面板入口
- 右侧活动栏 — 已保存连接、AI Assistant、活动会话、命令历史、资源监控等入口
- 底部区域 — 快捷命令、串口发送、录制、锁屏等辅助区域
如果你希望关闭主窗口时保留应用在后台运行，可以到 设置 → 常规 开启 关闭时最小化到托盘。
第五步：试试这些高频能力
1. 再打开一个本地终端
使用快捷键 Ctrl/Cmd + ` 或菜单入口创建本地终端，这样你可以在一个应用里同时看本地和远程环境。
2. 试一次终端分屏
在标签页上右键，选择：
- 水平分屏
- 垂直分屏
这适合同时观察日志、执行命令和对照不同主机输出。
3. 打开远程文件浏览器和传输队列
SSH 会话激活后，文件浏览器面板可直接浏览远程目录，并支持：
- 上传文件 / 上传文件夹
- 下载、删除、移动、重命名、属性查看
- 路径栏点击编辑并跳转
- 复制路径或发送路径到终端
- 与终端当前目录手动 / 自动同步
如果你发起上传或下载，传输面板会显示队列进度，并支持暂停、继续、取消和失败重试。
如果你在 Windows 上使用 NyaTerm，还可以尝试把本地文件或文件夹直接拖进文件浏览器上传。
4. 打开命令历史和快捷命令
- 命令历史 适合回溯与模糊检索
- 快捷命令 适合保存固定操作，并支持变量输入、分类和执行模式
- 命令建议 会在输入时根据历史与内置命令给出补全候选
如果建议太多或混入了超长历史命令，可以到 设置 → 交互 调整：
- 最小历史命令长度
- 最大历史命令长度
这些长度限制只影响历史命令建议，不影响快捷命令本身的可用性。
5. 试一次终端搜索 / 在线搜索 / 翻译
在终端中选中文本后，可以通过右键菜单：
- 查找 当前输出
- 用自定义搜索引擎做在线搜索
- 按已启用的翻译 provider 做翻译
6. 试试 AI Assistant
右侧活动栏中的 AI Assistant 适合这些场景：
- 让 AI 根据你的目标生成一条命令
- 解释最近终端输出或当前选中文本
- 分析错误信息并给出修复建议
- 将生成的结构化命令卡片保存为快捷命令
如果你第一次打开时没有可用模型，可以先到 设置 → AI 配置 provider、模型和风险控制。
7. 启用终端增强项
可在 设置 → 终端 中按需打开：
- 行号
- 时间戳
- 动作链接
- 关键词高亮
- 远程资源监控
这些能力默认更偏保守，需要你按场景开启。
8. 试一次录制
NyaTerm 支持把当前会话输出录制为日志文件。
如果你希望把录制文件集中保存到固定目录，可以先在 设置 → 传输 里设置 录制保存路径。
9. 看一下通用设置和诊断入口
在正式长期使用前，建议先快速看一遍这些设置分组：
- 设置 → 常规：启动恢复、关闭时最小化到托盘、关闭确认
- 设置 → 交互：命令建议、历史命令长度过滤、复制与右键粘贴
- 设置 → 终端：回滚缓冲区、Keep-Alive、动作链接、关键词高亮
- 设置 → 传输：下载目录、默认编辑器、录制路径、传输并发
- 设置 → 安全：主密码、锁屏、主机密钥策略
- 设置 → AI：provider、模型、风险门槛、历史记录和上下文限制
如果你在排查问题，设置 → 常规 里还能直接：
- 打开本地日志目录
- 导出诊断包
第六步：可选配置同步与备份
如果你希望把常用配置做跨设备同步，或给当前设备准备可恢复的加密备份，可以继续：
- 打开 设置 → 安全，先设置 主密码
- 再打开 设置 → 同步与备份
- 选择 WebDAV 或 S3 兼容存储提供方
- 填写连接信息后先执行 测试连接
- 再决定是否启用自动同步和定时备份
如果你只是首次试用 NyaTerm，这一步不是必须的；更详细的配置方式见 同步与备份。