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>
6.9 KiB
Quick Start
This chapter helps you experience NyaTerm's core workflow as quickly as possible: create a connection, open sessions, split the workspace, browse files, turn on terminal enhancements, and find the migration, AI assistance, and backup entry points.
Step 1: Pick a session type
When you click New Connection, NyaTerm offers six session types:
- SSH — the most complete remote-operations workflow
- Local Terminal — open a local shell inside NyaTerm
- Telnet — legacy systems or lab environments
- Serial — serial debugging devices
- RDP — Windows Remote Desktop
- VNC — VNC services or VM consoles; real-server interoperability is still being validated
If this is your first time using NyaTerm, start with one SSH session and then add one Local Terminal to compare the mixed-workspace experience.
Step 2: Create your first SSH connection
In the new-session window, fill in:
- Connection Name — a friendly display name
- Host and Port
- Username
- Authentication — password or private key
If needed, expand the advanced section to configure:
- Proxy
- Jump host
- OTP binding and auto-fill
- Icon, group, description, and other metadata
After saving, the connection appears in the saved-connections list.
Step 3: Import existing configuration if you have it
If you already maintain many hosts in another client, you do not need to rebuild them manually. NyaTerm can import from Xshell, MobaXterm, WindTerm, SecureCRT, FinalShell, Termius, and NyaTerm / Electerm JSON — the format list and caveats are in Importing sessions from other clients.
The two paths serve different goals:
- Migrating a connection inventory: start from the import entry in the Saved Connections panel
- Restoring a complete NyaTerm environment: use a
.nyaencrypted backup, which requires a master password first
Step 4: Understand the workspace
Double-click a saved connection, or use the connection context menu, to launch the session.
After the connection is established, you will see:
- Center area — the current terminal tab and any split panes inside it
- Left activity bar — entry points for file explorer, network, Security/Auth, Cloud Sync, settings, and related panels
- Right activity bar — saved connections, AI Assistant, active sessions, command history, and resource monitor
- Bottom area — quick commands, serial send, recording, and lock actions
If you want the app to keep running in the background when the main window closes, enable Minimize to tray when closing in Settings → General.
Step 5: Try the highest-frequency workflows
1. Open a local terminal too
Use the Ctrl/Cmd + ` shortcut or the menu entry to create a local terminal so you can compare local and remote work in one app.
2. Try split panes
Right-click a tab and choose:
- Horizontal Split
- Vertical Split
Use it to watch logs, run commands, and compare output from different hosts at the same time.
3. Open the remote file explorer and transfer queue
Once an SSH session is active, the file explorer lets you browse remote directories and perform upload, download, delete, move, rename, properties, path-bar navigation, path copy/send-to-terminal, and terminal-cwd sync actions.
When you start uploads or downloads, the transfer panel shows queue progress, transfer speed, and supports pause, resume, cancel, retry, and duplicate-target handling.
On Windows, you can also try dragging files or folders from the system file manager directly into the file explorer.
4. Open command history and quick commands
- Command History for recall and fuzzy lookup
- Quick Commands for reusable actions, with categories, execution modes, and variable prompts
- Command suggestions appear while typing based on history and built-in commands
If suggestions are too noisy or include very long commands, tune Minimum history command length and Maximum history command length in Settings → Interaction.
5. Try search / online search / translation
When text is selected in the terminal, the context menu can:
- Find inside the current output
- Send text to an online search engine
- Open a translation dialog with a configured provider
6. Try AI Assistant
The AI Assistant in the right activity bar can:
- Generating a command from your goal
- Explaining recent terminal output or selected text
- Analyzing errors and suggesting fixes
- Saving approved structured command cards as quick commands
If no model is available the first time you open it, configure providers, models, and risk controls in Settings → AI.
7. Turn on optional terminal enhancements
In Settings → Terminal, you can enable:
- Line numbers
- Timestamps
- Action links
- Keyword highlighting
- Remote resource stats
These are off by default; enable the ones that help your workflow.
8. Try session recording
Ctrl / Cmd + Shift + R records the active session's output to a log file.
To collect recordings in a fixed directory, set Recording path in Settings → Transfer first.
9. Review the settings
Before settling in, read through these settings groups: General (startup restore, minimize to tray on close), Interaction (command suggestions, copy and paste behavior), Terminal (scrollback, Keep-Alive, optional enhancements), Transfer (download directory, default editor, concurrency), Security (master password, screen lock, host key policy), and AI (provider, model, risk thresholds).
When troubleshooting, Settings → General can open the local log directory and export a diagnostics bundle directly.
Step 6: Optionally configure Cloud Sync
If you want cross-device configuration sync, continue with:
- Open Settings → Security and set a Master Password
- Open Settings → Cloud Sync
- Choose WebDAV, S3-compatible storage, Gist, or a drive provider
- Fill in the connection details and run Test Connection first
- Then decide whether to enable startup checks and auto-push
If you are just evaluating NyaTerm for the first time, this step is optional. For the full workflow, see Cloud Sync.
Step 7: Keep exploring by use case
- Want to understand the differences between sessions? See Session Types
- Want to configure auth, proxy, or jump hosts? See SSH Connection Management
- Want to manage files and auto-upload? See SFTP File Transfer
- Want to learn terminal enhancements and recording? See Terminal Features
- Want to configure OTP? See OTP and Authentication
- Want to enable AI assistance? See AI Assistant
- Want to enable cloud sync? See Cloud Sync