Files
nyaterm/docs-site/docs/guide/translation.md
T
KangandClaude Opus 5 e18cb3902e docs: cut the template phrasing and the authoring notes
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>
2026-08-22 11:27:47 +08:00

1.3 KiB

翻译功能

NyaTerm 内置多引擎文本翻译,用于在终端里翻译日志、报错或命令说明。

使用方式

  1. 在终端中选中要翻译的文本
  2. 右键打开上下文菜单
  3. 在 翻译 子菜单中选择一个可用 provider
  4. 翻译结果会在弹出对话框中显示

对话框中会展示:

  • 原文
  • 翻译结果
  • 检测到的源语言(如果 provider 返回)
  • 一键复制翻译结果

Provider 显示规则

终端右键菜单里并不是所有 provider 都会一直显示。

开箱即用

以下 provider 无需额外配置:

  • Google
  • Microsoft

需要凭据后才显示

以下 provider 只有在 设置 → 翻译 中填写了凭据后,才会出现在右键菜单里:

  • DeepL
  • 百度翻译
  • 阿里翻译
  • 有道翻译

翻译设置

在 设置 → 翻译 中,你可以配置:

  • 目标语言
  • 各 provider 对应的 API 凭据

需要注意的是:当前设置页主要负责目标语言和凭据管理,而不是指定“唯一默认 provider”。真正发起翻译时,仍然是你在终端右键菜单中选择具体 provider。

典型用途

  • 理解英文报错或第三方日志
  • 查阅混合语言输出中的重点信息
  • 翻译运维脚本说明或配置注释