From ce0b7c6cd01aee2a51fec2a7a25a93364aa3a4a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=B0=8F=E5=BC=9F=E8=B0=83=E8=B0=83?= <398188662@qq.com>
Date: Fri, 30 May 2025 13:47:40 +0800
Subject: [PATCH] doc: update docs/yazi.md
---
docs/yazi.md | 175 ++++++++++++++++++++++++++++++++++++++++++---------
1 file changed, 147 insertions(+), 28 deletions(-)
diff --git a/docs/yazi.md b/docs/yazi.md
index 1eb08382..bbb151a7 100644
--- a/docs/yazi.md
+++ b/docs/yazi.md
@@ -51,34 +51,132 @@ yazi --help
| `l` | 进入选中的目录或打开文件 |
-### 文件操作
+更多导航命令
-:- | :-
-:- | :-
-| `y` | 复制选中的文件或目录 |
-| `d` | 剪切选中的文件或目录 |
-| `p` | 粘贴文件或目录 |
-| `x` | 删除选中的文件或目录 |
-| `r` | 重命名选中的文件或目录 |
-
+| 快捷键 | 操作说明 |
+| --------------------------- | --------------------------------------------------------- |
+| `K` | 在预览中向上移动 5 个单位 |
+| `J` | 在预览中向下移动 5 个单位 |
+| `g` ⇒ `g` | 将光标移动到顶部 |
+| `G` | 将光标移动到底部 |
+| `z` | 通过 fzf 进入目录或显示文件（[cd](https://yazi-rs.github.io/docs/configuration/keymap#mgr.cd) 或 [reveal](https://yazi-rs.github.io/docs/configuration/keymap#mgr.reveal)） |
+| `Z` | 通过 zoxide 进入目录（[cd](https://yazi-rs.github.io/docs/configuration/keymap#mgr.cd)） |
+
+
+### 选择操作
+
+| 快捷键 | 操作说明 |
+| ------------------------------ | --------------------------------------------- |
+| Space | 切换当前悬停的文件/目录的选择状态 |
+| v | 进入可视模式（选择模式） |
+| V | 进入可视模式（取消模式） |
+| Ctrl + a | 选择所有文件 |
+| Ctrl + r | 反转当前所有文件的选择状态 |
+| Esc | 取消所有选择 |
+
+
+用于选择文件和目录的快捷键命令
+
+### 文件操作
+
+
+| 快捷键 | 操作说明 |
+| ----------------------------------- | ----------------------------------------------------------------------------- |
+| o | 打开选中的文件 |
+| O | 以交互方式打开选中的文件 |
+| Enter | 打开选中的文件 |
+| Shift + Enter | 以交互方式打开选中的文件（部分终端尚不支持） |
+| Tab | 显示文件信息 |
+| y | 复制选中的文件 |
+| x | 剪切选中的文件 |
+| p | 粘贴已复制/剪切的文件 |
+| P | 粘贴已复制/剪切的文件（如目标存在则覆盖） |
+| Y 或 X | 取消已复制/剪切状态 |
+| d | 将选中的文件移至回收站 |
+| D | 彻底删除选中的文件 |
+| a | 新建文件（以 / 结尾表示新建目录） |
+| r | 重命名选中的文件 |
+| . | 切换隐藏文件的显示状态 |
+
+
+更多文件操作命令如下：
+
+| 快捷键 | 操作说明 |
+| ------------------------------ | -------------------------------------------- |
+| ; | 执行一个 Shell 命令 |
+| : | 执行一个 Shell 命令（阻塞，直到命令完成） |
+| - | 创建已复制文件的绝对路径符号链接 |
+| \_ | 创建已复制文件的相对路径符号链接 |
+| Ctrl + - | 创建已复制文件的硬链接 |
+
+
+要操作选中的文件或目录
+
+### 复制路径
+
+| 快捷键 | 操作说明 |
+| ---------------------------- | ---------------------------------- |
+| c ⇒ c | 复制文件路径 |
+| c ⇒ d | 复制目录路径 |
+| c ⇒ f | 复制文件名 |
+| c ⇒ n | 复制不带扩展名的文件名 |
+
+
+**复制路径** _说明：c ⇒ d 表示先按下 c 键，然后按下 d 键。_
### 搜索与过滤
-:- | :-
-:- | :-
-| `/` | 开始搜索模式 |
-| `n` | 在搜索模式中跳到下一个匹配项 |
-| `N` | 在搜索模式中跳到上一个匹配项 |
+| 快捷键 | 操作说明 |
+| ------------ | -------------------- |
+| f | 过滤文件 |
+| / | 查找下一个文件 |
+| ? | 查找上一个文件 |
+| n | 跳转到下一个匹配项 |
+| N | 跳转到上一个匹配项 |
+
+
+### 搜索文件
+
+| 快捷键 | 操作说明 |
+| ---------------------------- | ------------------------------------------------------- |
+| s | 使用 [fd](https://github.com/sharkdp/fd) 按名称搜索文件 |
+| S | 使用 [ripgrep](https://github.com/BurntSushi/ripgrep) 按内容搜索文件 |
+| Ctrl + s | 取消当前进行中的搜索 |
-### 视图操作
+### 排序
+
-:- | :-
-:- | :-
-| `gg` | 跳到列表的顶部 |
-| `G` | 跳到列表的底部 |
-| `Ctrl+f` | 向下滚动一页 |
-| `Ctrl+b` | 向上滚动一页 |
+| 快捷键 | 操作说明 |
+| ---------------------- | ------------------------ |
+| , ⇒ m | 按修改`时间`排序 |
+| , ⇒ M | 按修改`时间倒序`排序 |
+| , ⇒ b | 按`创建时间`排序 |
+| , ⇒ B | 按`创建时间`倒序排序 |
+| , ⇒ e | 按文件`扩展名`排序 |
+| , ⇒ E | 按文件`扩展名倒序`排序 |
+| , ⇒ a | 按`字母顺序`排序 |
+| , ⇒ A | 按`字母倒序`排序 |
+| , ⇒ n | 按`自然`排序 |
+| , ⇒ N | 按`自然倒序`排序 |
+| , ⇒ s | 按文件`大小`排序 |
+| , ⇒ S | 按文件`大小倒序`排序 |
+| , ⇒ r | `随机`排序 |
+
+
+对文件/目录进行排序说明： _, ⇒ a 表示先按下 , 键，再按下 a 键。_
+
+### 多标签页
+
+| 快捷键 | 操作说明 |
+| ------------------------------------------- | ---------------------------- |
+| t | 以当前工作目录创建新标签页 |
+| 1, 2, ..., 9 | 切换到第 N 个标签页 |
+| [ | 切换到上一个标签页 |
+| ] | 切换到下一个标签页 |
+| { | 当前标签页与上一个互换位置 |
+| } | 当前标签页与下一个互换位置 |
+| Ctrl + c | 关闭当前标签页 |
## 自定义配置
@@ -98,38 +196,59 @@ yazi --help
[general]
# 设置主界面主题为 dark 或 light
theme = "dark"
+```
-# 启动时的默认路径
+启动时的默认路径
+
+```toml
default_path = "~"
+```
-# 是否启用自动保存配置
+是否启用自动保存配置
+
+```toml
auto_save_config = true
+```
+自定义快捷键绑定
+
+```toml
[keybindings]
-# 自定义快捷键绑定
quit = "q" # 退出
copy = "y" # 复制文件
paste = "p" # 粘贴文件
delete = "d" # 删除文件
+```
+界面相关配置
+
+```toml
[ui]
-# 界面相关配置
preview_enabled = true # 是否启用文件预览
show_hidden_files = true # 显示隐藏文件
columns = 2 # 文件列表列数
+```
+搜索行为配置
+
+```toml
[search]
-# 搜索行为配置
case_sensitive = false # 搜索是否区分大小写
search_timeout = 30 # 搜索超时时间（秒）
+```
+排序规则配置
+
+```toml
[sorting]
-# 排序规则配置
sort_by = "name" # 排序方式: name,size,date
reverse_sort = false # 是否反向排序
+```
+插件加载配置
+
+```toml
[plugins]
-# 插件加载配置
enabled_plugins = ["git", "archive"]
```