---
sidebar_position: 100
---

# 常见问题

## 会话与连接

### SSH 能连，本地终端 / Telnet / 串口为什么行为不一样？

因为 NyaTerm 支持多种会话类型，但能力并不完全相同：

- **SSH**：功能最完整，支持 SFTP、OTP、资源监控、代理、跳板机、隧道
- **本地终端**：只负责本地 shell 工作流
- **Telnet**：轻量远程终端，不包含 SSH 专属能力
- **串口**：用于串口调试，不属于 SSH 网络链路

如果你希望使用文件浏览器、远程资源监控或 OTP，请确认当前打开的是 **SSH 会话**。

### 为什么某些会话没有文件浏览器？

文件浏览器基于 SFTP，因此只会在 **SSH 会话** 下可用。

以下类型不会提供远程文件浏览器：

- 本地终端
- Telnet
- 串口

### 为什么没有看到远程资源监控？

请同时检查两件事：

1. 当前标签是否为 **SSH 会话**
2. 是否已在 **设置 → 终端** 中开启 **显示远程资源信息**

资源监控默认开启；如果关闭该设置，右侧活动栏里的资源监控图标也会隐藏。

### 串口列表为空怎么办？

先确认：

- 设备已经连接到系统
- 当前系统已经识别该串口
- 串口未被其他工具独占

切换到串口标签并重新展开端口下拉时，NyaTerm 会重新加载可用串口列表。

## 终端体验

### 为什么动作链接不能点击？

通常有两种原因：

1. 你还没有在 **设置 → 终端** 中启用 **动作链接**
2. 点击时没有使用 **Ctrl / Cmd + 点击**

动作链接默认关闭，而且为了避免误触，打开链接时需要配合修饰键。

### 为什么看不到关键词高亮？

关键词高亮默认关闭。请先到 **设置 → 终端** 中启用它，再确认当前输出里确实包含可匹配的文本。

### 为什么行号和时间戳没有显示？

这两项也都是按需开启的可选增强项，需要在 **设置 → 终端** 中分别打开。

### 为什么 AI Assistant 里没有可用模型？

通常需要检查：

1. **设置 → AI** 是否已经启用 AI 功能
2. 是否已经配置并启用了至少一个 provider
3. 是否已经为 provider 启用至少一个模型

如果你使用的是自定义 provider，请确认它兼容 OpenAI 风格接口，并且 base URL、API Key 和模型发现结果都正确。

### 为什么点关闭窗口后应用没有完全退出？

请检查 **设置 → 常规** 里的 **关闭时最小化到托盘** 是否已经开启。

开启后，关闭主窗口会把应用转为托盘驻留，而不是直接退出。这适合需要保留后台会话、同步或后续快速唤起窗口的场景。

## 文件传输

### 打开远程文件后，为什么没有弹出自动上传提示？

自动上传提示只会在下面这种流程里出现：

1. 你从 SSH 文件浏览器中对远程文件执行 **打开**
2. NyaTerm 下载该文件到本地临时目录并启动监听
3. 你在本地编辑器里保存这个文件

如果你是自己另外复制了一个文件再编辑，NyaTerm 不会知道它和远端文件之间的关系。

### 文件浏览器为什么没有跟着 `cd` 自动切换目录？

自动跟随依赖会话的终端路径跟踪能力。如果当前会话不支持，自动同步会被关闭；这时你仍然可以手动执行同步。

### 上传 / 下载保存到哪里？

取决于你的传输设置：

- 如果启用了“每次询问保存位置”，每次下载都会让你选择路径
- 否则会使用默认下载目录

你也可以在设置里修改默认下载目录和默认编辑器。

## 安全与认证

### 锁屏后为什么不需要输入密码也能解锁？

这是因为你启用了锁屏，但**还没有设置主密码**。

当前实现中：

- 有主密码：锁屏后必须输入主密码
- 没有主密码：可以直接点击解锁

### 忘记主密码怎么办？

当前没有内建的“找回主密码”流程。如果本地数据已经受主密码保护，而你又无法提供正确密码，那么相关敏感配置将无法按原方式继续使用。

这也会影响：

- 锁屏后的解锁
- 云同步相关操作
- `.nya` 配置导入 / 导出

在手动处理前，建议先备份 `~/.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/` 目录会保留作为回滚备份。