docs(zh): translate cli reference and developer pages

2026-07-18 05:44:07 +02:00 · 2026-06-08 09:21:59 +02:00
parent ce619bcff2
commit 88900a80b8
2 changed files with 125 additions and 0 deletions
--- a/docs/zh-CN/cli/cli.md
+++ b/docs/zh-CN/cli/cli.md
@@ -1 +1,68 @@
 # 命令行用法
+
+termscp 可以通过以下调用形式启动：
+
+```sh
+termscp [options]... [protocol://user@address:port:wrkdir] [protocol://user@address:port:wrkdir] [local-wrkdir]
+```
+
+或
+
+```sh
+termscp [options]... -b [bookmark-name] -b [bookmark-name] [local-wrkdir]
+```
+
+以及两者的任意组合。
+
+如果未提供额外参数，termscp 会显示身份验证表单。如果提供了地址参数或书签名称，termscp 会跳过该表单并直接连接到远程服务器。当提供地址或书签时，你还可以将本地主机的起始工作目录作为最后一个位置参数提供。
+
+## 选项
+
+| Key                  | 说明                                                                                                                                |
+| -------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `-b <bookmark-name>` | 将位置地址参数解析为书签名称。重复使用该标志可以打开多个书签。                                                                       |
+| `-D`                 | 启用 `TRACE` 日志级别（调试/详细日志）。                                                                                            |
+| `-P <password>`      | 从命令行提供密码。重复使用该标志可为多个远程主机提供密码；其顺序必须与地址参数一致。不推荐使用。                                     |
+| `-q`                 | 禁用日志记录。                                                                                                                      |
+| `-T <ticks>`         | 设置 UI 的 tick 间隔（以毫秒为单位）。默认值为 `10`。                                                                               |
+| `--wno-keyring`      | 禁用系统 keyring 支持。                                                                                                             |
+| `-v`                 | 打印版本信息。                                                                                                                      |
+| `--help`             | 打印帮助页面。                                                                                                                      |
+
+不推荐使用 `-P` 选项，因为密码可能会保留在 shell 历史记录中。请参阅书签和密码安全章节，了解更安全的凭据提供方式。
+
+## 子命令
+
+termscp 提供以下子命令。
+
+### 导入主题
+
+```sh
+termscp theme <theme-file>
+```
+
+导入在 `<theme-file>` 中定义的主题。
+
+### 安装最新版本
+
+```sh
+termscp update
+```
+
+下载并安装 termscp 的最新可用版本。
+
+### 导入 ssh 主机
+
+```sh
+termscp import-ssh-hosts [ssh-config-file]
+```
+
+将指定 ssh 配置文件中的所有主机作为书签导入到 termscp 中。如果未提供 `[ssh-config-file]`，则使用默认位置 `~/.ssh/config`。身份文件也会作为 ssh 密钥导入到 termscp 中。
+
+### 打开配置
+
+```sh
+termscp config
+```
+
+直接在配置（setup）界面中启动 termscp。