yazi配置

Yazi 配置说明

Yazi v26.5.6 · 主题: Dracula · 插件增强: augment-command

新增插件的用法、快捷键和维护说明见 PLUGIN-GUIDE.md。

---

目录

• 全局设置
• 插件清单
• 快捷键总表
  • 目录跳转
  • 面板布局
  • 光标移动
  • 目录导航
  • 文件操作
  • 复制路径与重命名
  • 搜索与过滤
  • 标签页管理
  • 选择与视觉模式
  • 预览控制
  • FFmpeg 媒体工具
  • 任务与帮助
  • 设备挂载
  • 书签管理
  • 回收站管理
• 子模式键位
  • 任务管理器
  • 聚焦模式
  • 输入模式（Vim 风格）

---

全局设置

# yazi.toml

[mgr]
ratio = [1, 2, 5]              # 父目录:当前目录:预览 比例
sort_by = "extension"          # 按扩展名分组排序
sort_sensitive = true          # 区分大小写
sort_reverse = false           # 正序
sort_dir_first = true          # 目录优先
show_hidden = true             # 显示隐藏文件
show_symlink = true            # 显示符号链接目标
linemode = "btime"             # 行信息显示创建时间

[preview]
wrap = "yes"                   # 预览换行
image_filter = "lanczos3"      # 图片缩放算法（高质量）

[tasks]
image_alloc = 1073741824       # 图片缓存 1GB

核心特点:

• 默认显示隐藏文件，无需按 . 切换
• 按创建时间排序查看（可随时切换其他排序）
• 布局比例偏向预览面板
• 鼠标可直接拖拽面板分隔线调整宽度

---

插件清单

插件	用途
full-border	完整边框，视觉更现代
starship	状态栏显示 starship 提示符
mediainfo	预览音视频/图片/PDF 等媒体信息
augment-command	核心增强，智能操作、批量处理、自动解压等
mount	挂载/卸载硬盘
mdv-previewer	渲染 Markdown/TXT 预览
whoosh	书签管理（持久/临时、fzf 搜索）
fzf	模糊搜索跳转文件/目录
zoxide	智能目录跳转
gvfs	挂载 MTP/SSH/SMB/WebDAV 等远程设备
recycle-bin	回收站管理
toggle-ratio	自定义，一键切换面板布局

augment-command 核心配置

-- init.lua
require("augment-command"):setup({
    smart_enter = true,                    -- 智能进入（目录→进入，文件→打开，压缩包→解压）
    confirm_on_quit = true,                -- 多标签退出时确认
    enter_archives = true,                 -- 自动解压压缩包
    recursively_extract_archives = true,   -- 递归解压（压缩包套压缩包）
    skip_single_subdirectory_on_enter = true,  -- 进入时跳过单子目录
    skip_single_subdirectory_on_leave = true,  -- 返回时跳过单子目录
    wraparound_file_navigation = true,     -- 文件列表循环导航
    extract_retries = 3,                   -- 输错密码重试次数
    reveal_created_archive = true,         -- 创建压缩包后定位到它
})

augment-command 增强逻辑:

• ✅ 选中 vs 悬停：当光标所在的文件也被选中时，操作作用于所有选中文件，否则只操作当前文件
• ✅ 空格连续选择：按空格选中文件后，光标自动移到下一行
• ✅ 批量操作：复制/删除/粘贴/shell 命令自动适配选中的多个文件
• ✅ 自动解压：按 l/→ 进入压缩包，自动解压并进入

---

快捷键总表

目录跳转

快捷键	功能
g h	跳转到家目录 ~
g d	跳转到 ~/下载
g p	跳转到 ~/图片
g v	跳转到 ~/视频
g m	跳转到 ~/音乐
g w	跳转到 ~/文档
g u	跳转到 ~/公共
g t	跳转到 ~/模板
g c	跳转到 ~/.config
g y	跳转到 ~/.config/yazi
g /	跳转到根目录 /
g <Space>	交互式目录跳转
g f	跟随符号链接

面板布局

快捷键	功能
L（Shift+l）	循环切换 4 种布局
H（Shift+h）	重置为默认布局 [1,3,4]

四种布局：[1,3,4] 默认 → [1,2,5] 预览扩大 → [1,1,6] 预览最大 → [0,3,5] 隐藏父面板。

鼠标拖拽面板分隔线也可直接调整。

光标移动

快捷键	功能
i / k	上 / 下一个文件（增强版）
<Up> / <Down>	上 / 下一个文件（增强版）
<C-i> / <C-k>	向上 / 向下半页
<S-i> / <S-k>	向上 / 向下一整页
<PageUp> / <PageDown>	向上 / 向下半页
<S-PageUp> / <S-PageDown>	向上 / 向下一整页
g g	跳转到文件列表顶部
G	跳转到文件列表底部

i=上、k=下、j=返回上级（自定义布局，非标准 Vim）

目录导航

快捷键	功能
j / <Left>	返回上级目录（增强版，跳过单子目录）
l / <Right>	智能进入：目录→进入，文件→打开，压缩包→解压
<S-Left> / <S-Right>	后退 / 前进到历史目录

文件操作

快捷键	功能
o / <Enter>	打开选定文件（增强版，支持批量）
O / <S-Enter>	交互式打开（选择打开方式）
y	复制（标记）文件
x	剪切（标记）文件
Y / X	取消复制/剪切状态
p p	粘贴
p f	强制粘贴（覆盖）
d	移动到回收站
D	永久删除
a	创建文件/目录（以 / 结尾创建目录）
c r	创建文件
c l / c L	创建符号链接（绝对/相对）
c h	创建硬链接
c p	修改文件权限
c z	创建压缩包（augment-command.archive）
;	交互式 shell 命令（自动传入选中文件路径）
:	阻塞式 shell 命令（自动传入选中文件路径）

复制路径与重命名

快捷键	功能
c c	复制文件完整路径
c d	复制目录路径
c f	复制文件名
c n	复制文件名（不含扩展名）
r r	重命名（光标在扩展名前）
r i	重命名（光标在文件名开头）
r a	重命名（光标在文件名末尾）
r f / r c	重命名（清空整个文件名）
c m	清空文件名重命名

搜索与过滤

快捷键	功能
f	智能过滤文件（逐字输入缩小列表）
/	智能查找下一个文件
?	智能查找上一个文件
n / N	下一个 / 上一个匹配项
s	通过 fd 搜索文件名
S	通过 rg 搜索文件内容
<C-s>	取消正在进行的搜索
z	通过 fzf 模糊搜索跳转文件/目录
Z	通过 zoxide 智能跳转目录

标签页管理

快捷键	功能
t	创建新标签页（当前目录）
1-9	切换到第 1-9 个标签页
- / =	切换至上 / 下一个标签页
_ / +	与上 / 下一个标签页交换位置
<C-c>	关闭当前标签页（最后一个是退出）

选择与视觉模式

快捷键	功能
<Space>	切换当前选择状态（光标保持不动）
<C-a>	全选
<C-r>	反选
u	取消全部选择
v	进入视觉模式（选择模式）
V	进入视觉模式（取消模式）

预览控制

快捷键	功能
<C-Up>	预览向上滚动 5 行
<C-Down>	预览向下滚动 5 行
<Tab>	聚焦到预览面板（spot 模式）
F p	显示/隐藏媒体图片预览
F i	显示/隐藏媒体元数据
F r	重置媒体预览设置

FFmpeg 媒体工具

快捷键	功能
F f	对当前悬停文件或多选文件打开 FFmpeg 动态操作菜单

ff-tools.yazi 会根据文件类型和数量显示可用操作。单个视频支持裁剪、压缩、
提取音频、变速、GIF、水印和编码预设；多个视频支持拼接、批量转码、批量静音
和完整性验证；同时选择一个视频和一个字幕文件时可直接烧录字幕。

Yazi 在 Foot 中使用 Sixel 图片协议进行像素级预览。独立的 FZF 媒体预览也会
自动检测 Foot 并切换到 Chafa Sixel，必要时可设置
FZF_MEDIA_IMAGE_PROTOCOL=symbols 强制回退到字符模式。

任务与帮助

快捷键	功能
w	显示任务管理器
~ / <C-F1>	打开帮助
q	退出（多标签时确认）
Q	退出且不保存 cwd 文件
<C-z>	挂起 Yazi

设备挂载

快捷键	功能
M m	选择设备并挂载并跳转
M R	重新挂载当前目录的设备
M u / M U	卸载 / 强制卸载设备
M a / M e / M r	添加 / 编辑 / 移除挂载 URI
G m	跳转到设备挂载点
` `	跳回上一个目录
M p	挂载硬盘

书签管理

快捷键	功能
[	通过快捷键跳转书签
}	通过 fzf 搜索书签
] a / ] A	添加书签（文件/目录）
] t / ] T	添加临时书签
] f	通过 fzf 搜索跳转
<A-k>	直接跳转到书签 k
] d / ] D	通过快捷键 / fzf 删除书签
] C	清空所有书签
] r / ] R	通过快捷键 / fzf 重命名书签

回收站管理

快捷键	功能
R b	打开回收站管理

---

子模式键位

任务管理器

按 w 打开任务管理器，键位：

快捷键	功能
w / <Esc> / <C-c>	关闭任务管理器
j / k / <Up> / <Down>	上下移动
<Enter>	查看任务详情
x	取消任务

聚焦模式

按 <Tab> 进入聚焦模式（预览面板），键位：

快捷键	功能
j / k	上下滚动
h / l	浏览上一个/下一个文件
<Tab> / <Esc>	关闭聚焦模式
c c	复制选中单元格

输入模式（Vim 风格）

重命名/搜索/创建文件时的完整 Vim 键位：

模式切换:   i/I(插入)  a/A(追加)  v(视觉)  r(替换)
光标移动:   h/l(左右)  b/w/e(单词)  0/$/_(行首/尾/首非空)
删除:       x(字符)  dd(行)  dw(单词)  D(到行尾)
复制粘贴:   y yank  p/P 粘贴
撤销重做:   u / <C-r>
剪切:       <C-u>(到行首)  <C-k>(到行尾)  <C-w>(到单词首)

---

日常使用流程

1. 浏览文件：i/k 上下移动，l 进入目录/打开文件/解压压缩包
2. 多选操作：空格连续选择，然后 y 复制或 d 删除或 ; 执行 shell 命令
3. 快速跳转：g h 回家，z fzf 搜索，Z zoxide，[/] 书签
4. 预览调整：L 扩大预览，鼠标拖拽分隔线，H 恢复
5. 压缩解压：选中文件 c z 创建压缩包，光标在压缩包上按 l 自动解压
6. 退出：单个标签按 q 直接退出，多个标签按 q 确认