Agent Skills
返回列表
💻

Yazi 异步终端文件管理器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/yazi-async-terminal-file-manager。

技能介绍

它解决什么问题

长时间在终端里工作的人都会遇到同一个摩擦:目录层级越钻越深,cd 加上一串相对路径开始难以阅读;ls 在几千个文件的目录下既慢又没法排序筛选;想看张图片或者某个二进制是否对应项目产物,还得切到 GUI 文件管理器,把终端上下文整个丢掉。

Yazi 想解决的问题就是把文件操作留在终端里,同时不牺牲预览和操作的丰富度。相比 ranger、lf、nnn 这类老牌选择,它用 Rust 重写核心,靠异步 I/O 处理大目录遍历和缩略图解码,避免把渲染线程卡在磁盘等待上。

它如何工作

  • 异步 I/O 核心:用 Rust 编写,目录读取、文件元数据获取、图片解码都走异步任务,长目录列表渲染时不会整体阻塞。
  • 图像预览:图片文件直接在终端内联渲染缩略图,不需要额外调用外部查看器。
  • Vim 键位:h j k l 导航,配合 gg、G 跳转到顶部与底部,鼠标用户可以继续用方向键。
  • Lua 插件系统:逻辑写在 Lua 里,可以自定义按键映射、异步任务和界面组件,改配置不需要重新编译。
  • 复用现有命令行工具:内容搜索交给 ripgrep,文件名过滤交给 fd,模糊选择交给 fzf,目录跳转交给 zoxide。它不做重复造轮子的事,而是把这些已经装在你 PATH 里的工具串成一条流程。

适用边界与注意点

  • 这个技能条目本身不包含可执行的安装说明,SKILL.md 里明确说明安装与使用步骤未能自动提取。要实际跑起来,需要先到上游项目确认 Yazi 的安装方式,再确认外部工具(ripgrep、fd、fzf、zoxide)是否就位。
  • 资料建议在敏感工作流中运行之前先审查上游代码。技能只是把项目包装成可调用的形式,真正执行的是本地二进制,审计责任在使用者这边。
  • 依赖外部命令意味着功能会降级:zoxide 没装就少掉智能跳转,fzf 缺失模糊选择就用不了,插件里引用了未安装的工具会直接报错。
  • 分类属于开发编程,目标用户是终端重度使用者。如果你更习惯鼠标操作或 IDE 内置的文件树,这个方案的价值会明显下降。

使用场景

  • 在远程服务器上浏览包含数千文件的目录,需要用 fzf 快速过滤定位某个配置文件
  • 终端里翻看图片素材目录,想直接内联预览缩略图,不切到 GUI 图片查看器
  • 多层项目目录树中频繁跳转,习惯用 h j k l 和 gg/G 操作,不想每次敲长路径
  • 想给文件管理器加自定义按键或异步任务,用 Lua 写插件而不重新编译二进制

适合人员

  • 后端与运维工程师:常年在无 GUI 的远程终端里操作文件,需要预览、过滤和目录跳转一体化
  • 终端工具重度用户:习惯 Vim 键位操作,愿意用 Lua 脚本扩展和定制自己的工作流
  • 已在用 ripgrep、fd、fzf、zoxide 的开发者:想把搜索、过滤、跳转串进同一个文件管理器
  • 需要脚本化文件操作的用户:希望插件里跑异步任务并自定义按键,而不是依赖 GUI 自动化