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.0 KiB
sidebar_position
| sidebar_position |
|---|
| 100 |
常见问题
会话与连接
SSH 能连，本地终端 / Telnet / 串口为什么行为不一样？
因为 NyaTerm 支持多种会话类型，但能力并不完全相同：
- SSH：功能最完整，支持 SFTP、OTP、资源监控、代理、跳板机、隧道
- 本地终端：只负责本地 shell 工作流
- Telnet：轻量远程终端，不包含 SSH 专属能力
- 串口：用于串口调试，不属于 SSH 网络链路
如果你希望使用文件浏览器、远程资源监控或 OTP，请确认当前打开的是 SSH 会话。
为什么某些会话没有文件浏览器？
文件浏览器基于 SFTP，因此只会在 SSH 会话 下可用。
以下类型不会提供远程文件浏览器：
- 本地终端
- Telnet
- 串口
为什么没有看到远程资源监控？
请同时检查两件事：
- 当前标签是否为 SSH 会话
- 是否已在 设置 → 终端 中开启 显示远程资源信息
资源监控默认是关闭的。
串口列表为空怎么办？
先确认：
- 设备已经连接到系统
- 当前系统已经识别该串口
- 串口未被其他工具独占
切换到串口标签并重新展开端口下拉时，NyaTerm 会重新加载可用串口列表。
终端体验
为什么动作链接不能点击？
通常有两种原因：
- 你还没有在 设置 → 终端 中启用 动作链接
- 点击时没有使用 Ctrl / Cmd + 点击
动作链接默认关闭，而且为了避免误触，打开链接时需要配合修饰键。
为什么看不到关键词高亮？
关键词高亮默认关闭。请先到 设置 → 终端 中启用它，再确认当前输出里确实包含可匹配的文本。
为什么行号和时间戳没有显示？
这两项也都是按需开启的可选增强项，需要在 设置 → 终端 中分别打开。
为什么 AI Assistant 里没有可用模型？
通常需要检查：
- 设置 → AI 是否已经启用 AI 功能
- 是否已经配置并启用了至少一个 provider
- 是否已经为 provider 启用至少一个模型
如果你使用的是自定义 provider，请确认它兼容 OpenAI 风格接口，并且 base URL、API Key 和模型发现结果都正确。
为什么点关闭窗口后应用没有完全退出？
请检查 设置 → 常规 里的 关闭时最小化到托盘 是否已经开启。
开启后，关闭主窗口会把应用转为托盘驻留，而不是直接退出。这适合需要保留后台会话、同步或后续快速唤起窗口的场景。
文件传输
打开远程文件后，为什么没有弹出自动上传提示？
自动上传提示只会在下面这种流程里出现：
- 你从 SSH 文件浏览器中对远程文件执行 打开
- NyaTerm 下载该文件到本地临时目录并启动监听
- 你在本地编辑器里保存这个文件
如果你是自己另外复制了一个文件再编辑，NyaTerm 不会知道它和远端文件之间的关系。
文件浏览器为什么没有跟着 cd 自动切换目录？
自动跟随依赖会话的终端路径跟踪能力。如果当前会话不支持，自动同步会被关闭；这时你仍然可以手动执行同步。
上传 / 下载保存到哪里？
取决于你的传输设置：
- 如果启用了“每次询问保存位置”，每次下载都会让你选择路径
- 否则会使用默认下载目录
你也可以在设置里修改默认下载目录和默认编辑器。
安全与认证
锁屏后为什么不需要输入密码也能解锁？
这是因为你启用了锁屏，但还没有设置主密码。
当前实现中：
- 有主密码：锁屏后必须输入主密码
- 没有主密码：可以直接点击解锁
忘记主密码怎么办？
当前没有内建的“找回主密码”流程。如果本地数据已经受主密码保护，而你又无法提供正确密码，那么相关敏感配置将无法按原方式继续使用。
这也会影响：
- 锁屏后的解锁
- 同步与备份相关操作
.dgfy配置导入 / 导出
在手动处理前，建议先备份 ~/.nyaterm/ 目录，再决定如何重建本地配置。
OTP 应该在哪里管理？
请到 Security/Auth 面板中的 OTP 标签页统一管理；创建或编辑 SSH 连接时，再把某个 OTP 条目绑定到具体连接。
导入与迁移
可以从哪些客户端导入会话？
目前支持：
- Xshell（
.xts） - MobaXterm（
.mxtsessions） - WindTerm（
.sessions）
导入后建议检查用户名、端口、认证方式，以及是否需要补充代理 / 跳板机 / OTP。
NyaTerm 的配置文件存放在哪里？
当前主要用户数据保存在 ~/.nyaterm/nyaterm.redb 中，其中会保存设置、连接、密钥、密码、OTP、隧道、代理、历史、AI 历史等本地数据。
从 Dragonfly 升级时，NyaTerm 会在首次启动时复制 ~/.dragonfly/dragonfly.redb；如果旧环境只有 .dragonfly JSON / 文本文件，也会复制后迁入 redb。旧 ~/.dragonfly/ 目录会保留作为回滚备份。