mirror of
https://github.com/nyakang/nyaterm.git
synced 2026-11-06 16:07:55 +00:00
KangandClaude Opus 5
e18cb3902e
The migrated prose leaned on a small set of constructions and repeated them
until they stopped carrying information. Across ~3.7k lines the source had 78
uses of "适合", 63 of "如果你", and 34 contrastive "而不是" clauses, most of
them attached to bullet lists that restated the feature name.
What changed:
- Replaced the "适合场景 / 适合：" tail hanging off nearly every section with
either a plain sentence or nothing. "适合" is now 0, "如果你" is 0, and the
18 remaining "而不是" clauses each rule out an assumption a reader would
actually make (a rejected password is not truncated; a font name is not a
bundled file; a decoder panic must not exit silently).
- Removed the closing editorial lines that asserted significance without adding
information ("这也是 NyaTerm 和普通多标签终端差异较大的地方"), and the
meta-commentary where the docs explained their own conventions.
- Dropped the relative time anchors that were already going stale: "新的 SFTP
后端", "较新的工作区", "现在可以", "Newer Agent workflows".
- Deleted the "如果你准备录制文档素材" passage, which told the reader how to
stage screenshots for the docs rather than how to use the recorder.
- Removed seven `:::tip Screenshot suggestion` blocks that shipped only in the
English pages. They were internal authoring notes and pointed at a
/img/docs/ tree and scripts/demo-*.sh files that do not exist in this repo.
- Dropped "推荐的工作流组合", four permutations of features documented
elsewhere, and gave the synchronized input group one home instead of the
three partial copies it had across two pages.
- Rewrote the cloud-sync conflict choices to lead with what is lost, since
"适合：你确认云端版本才是应该保留的版本" buried the fact that local
unsynced changes are discarded.
Also closes the remaining English gaps found while doing this: selection and
bulk operations, content-fingerprint upload, two FAQ entries, and two
quick-start steps existed only in Chinese. Chinese and English now carry the
same heading count on every page.
Verified with `pnpm --dir docs-site build` (both locales) and by re-resolving
all 22 cross-page anchors against the generated heading ids.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
149 lines
5.4 KiB
Markdown
149 lines
5.4 KiB
Markdown
# 常见问题
|
||
|
||
## 会话与连接
|
||
|
||
### SSH 能连，本地终端 / Telnet / 串口 / RDP / VNC 为什么行为不一样？
|
||
|
||
因为 NyaTerm 支持多种会话类型，但能力并不完全相同：
|
||
|
||
- **SSH**：功能最完整，支持 SFTP、OTP、资源监控、代理、跳板机、隧道
|
||
- **本地终端**：只负责本地 shell 工作流
|
||
- **Telnet**：轻量远程终端，不包含 SSH 专属能力
|
||
- **串口**：用于串口调试，不属于 SSH 网络链路
|
||
- **RDP**：图形远程桌面，不提供文本终端能力
|
||
- **VNC**：传统 RFB 图形远程桌面；部分真实服务器组合仍在验证
|
||
|
||
要使用文件浏览器、远程主机监控或 OTP，确认当前打开的是 **SSH 会话**。
|
||
|
||
### 为什么某些会话没有文件浏览器？
|
||
|
||
文件浏览器基于 SFTP，因此只会在 **SSH 会话** 下可用。
|
||
|
||
以下类型不会提供远程文件浏览器：
|
||
|
||
- 本地终端
|
||
- Telnet
|
||
- 串口
|
||
- RDP
|
||
- VNC
|
||
|
||
### 为什么没有看到远程资源监控？
|
||
|
||
请同时检查两件事：
|
||
|
||
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/`，portable 模式是程序旁的 `data/`，再决定如何重建本地配置。
|
||
|
||
### OTP 应该在哪里管理？
|
||
|
||
请到 **Security/Auth** 面板中的 **OTP** 标签页统一管理；创建或编辑 SSH 连接时，再把某个 OTP 条目绑定到具体连接。
|
||
|
||
## 导入与迁移
|
||
|
||
### 可以从哪些客户端导入会话？
|
||
|
||
Xshell、MobaXterm、WindTerm、SecureCRT、FinalShell、Termius 和 NyaTerm / Electerm JSON。各自的文件格式和注意事项见 [导入其他客户端的会话](./guide/ssh-connection#导入其他客户端的会话)。
|
||
|
||
导入后检查用户名、端口、认证方式，以及是否需要补充代理 / 跳板机 / OTP 绑定。
|
||
|
||
### NyaTerm 的配置文件存放在哪里？
|
||
|
||
安装模式下主要用户数据默认保存在 `~/.nyaterm/nyaterm.redb`；portable 模式使用程序旁 `data/config/` 下的配置数据。数据包括设置、连接、密钥、密码、OTP、隧道、代理、历史、AI 历史等本地内容。
|
||
|
||
旧 Dragonfly 数据只按当前兼容读取路径处理：应用保留旧加密前缀和旧存储文档的 fallback，不会承诺首次启动自动复制整个 `~/.dragonfly/` 目录或创建回滚副本。
|