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.
5.8 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
SFTP 文件传输
NyaTerm 的远程文件能力建立在 SSH 会话之上。也就是说，文件浏览器、SFTP 传输、远程文件本地编辑后回传 都只在 SSH 会话中可用；本地终端、Telnet、串口不会显示这一套能力。
文件浏览器
连接 SSH 会话后，文件浏览器面板可以直接浏览远程目录。
你会得到这些基础能力：
- 自动进入远端用户主目录
- 进入文件夹、返回上级、刷新当前目录
- 点击路径栏直接编辑并跳转到目标路径
- 与终端当前工作目录同步
- 在不支持路径跟踪的会话中关闭自动同步
- 复制当前目录路径，或把路径直接发送到终端输入区
路径栏支持 ~ 和 ~/subdir 形式的输入，适合快速跳转到主目录或常用子目录。
常见文件操作
在文件列表、工具栏或右键菜单中，你可以执行：
| 操作 | 说明 |
|---|---|
| 打开 | 下载到本地临时目录后，用默认编辑器打开 |
| 上传文件 | 选择一个或多个本地文件上传到当前目录 |
| 上传文件夹 | 整个目录上传到当前远端路径 |
| 下载 | 下载单个文件、多个已选文件，或整个目录 |
| 重命名 | 修改远端名称 |
| 移动 | 把文件或目录移动到新路径 |
| 删除 | 删除单个文件，或批量删除当前选中的多个条目 |
| 属性 | 查看大小、时间、UID/GID、权限等信息 |
| 新建文件 / 文件夹 / 符号链接 | 在当前目录中直接创建 |
其中“打开”并不只是只读预览，而是为后续本地修改后回传做准备。
选择、多选与批量操作
当前文件浏览器已经支持更接近日常文件管理器的选择方式：
- 单击选择单个条目
Ctrl / Cmd多选Shift范围选择Ctrl / Cmd + A全选当前目录条目Delete删除当前选中条目
当你选中了多个条目后，工具栏中的下载和删除会直接对当前选择生效；如果在多选状态下对某个已选条目打开右键菜单，相关批量操作也会作用于整组选中项。
上传与下载
上传
可通过工具栏、右键菜单或拖拽把本地内容上传到当前目录。
- 上传文件时可一次选择多个本地文件
- 上传目录时会保留目录结构
- 上传目录与上传文件会统一进入传输队列
- 适合用来同步脚本、配置文件、发布包或整组静态资源
外部拖拽上传
文件浏览器支持把系统文件管理器中的文件或文件夹直接拖到 NyaTerm 文件浏览器区域进行上传。
典型流程：
- 打开一个 SSH 会话并进入文件浏览器
- 把本地文件或文件夹拖到文件列表区域
- 出现拖拽覆盖层后松手
- NyaTerm 自动把它们加入上传流程
需要注意：
- 只有拖到文件浏览器列表区域才会触发上传
- 某些拖拽来源如果没有暴露本机真实路径，NyaTerm 无法直接解析，这时会提示你改用 上传文件 或 上传文件夹
下载
下载时有两种常见工作方式：
- 使用默认下载目录，直接保存到固定位置
- 每次都询问保存位置，适合临时排障或按任务分类归档
目录下载与文件下载都支持，远端目录会落到你选择的本地目标目录中。
传输面板与传输设置
NyaTerm 会把上传 / 下载任务统一放进传输队列中，便于你查看：
- 当前进度
- 成功、暂停、取消与失败状态
- 同时进行中的任务
- 当前下载目录
单个传输项支持：
- 暂停
- 继续
- 取消
- 失败后重试
- 完成后从列表移除
面板顶部还提供批量操作：
- 全部暂停
- 全部继续
- 全部取消
- 清理已完成项
在 设置 → 传输 中还可以按需调整：
- 上传 / 下载线程数
- 冲突时的处理策略
- 最大重试次数
- 传输缓冲区大小
- 是否保留时间戳
- 是否继续断点传输
- 默认文件权限
- 默认下载路径
- 是否每次询问保存位置
- 默认打开远程文件所使用的本地编辑器
与终端路径同步
文件浏览器可以和当前 SSH 终端的工作目录配合使用：
- 手动同步：点击同步按钮，把浏览器直接跳到终端当前路径
- 自动同步：开启自动同步后，终端
cd到新目录时，文件浏览器自动跟随 - 发送到终端：把当前目录路径或某个文件路径直接发到终端输入区，便于继续补命令
这对边跑命令边查文件非常有用，例如你在终端里进入某个发布目录后，文件浏览器会更容易保持在同一位置。
如果当前会话没有可用的终端路径跟踪能力，手动 / 自动同步入口会变为不可用状态；这通常意味着该会话暂时不能向后端稳定报告 cwd 变化。
本地编辑后自动回传
这是 NyaTerm 很适合真实运维场景的一项能力。
工作方式
- 在 SSH 文件浏览器中对远程文件执行 打开
- NyaTerm 先把文件下载到本地临时目录
- 同时启动文件监听
- 你在本地编辑器里保存后，应用会弹出上传提示窗口
上传提示窗口
文件被修改后，你可以选择：
- 上传一次
- 始终上传
- 取消
如果你对某个文件选择了“始终上传”，那么在当前会话内后续再次保存时会直接回传，不再重复询问。
适合的使用场景
- 修改远程配置文件
- 调整部署脚本
- 打开日志或状态文件做本地分析
- 为文档准备“编辑后回传”的演示截图
文件属性与权限
在 属性 中可以查看：
- 文件大小
- 修改时间、访问时间
- 所有者和组
- UID / GID
- 权限的八进制表示
如果你的流程需要先核对权限再替换文件，这里会比单纯依赖 ls -l 更直观。