Yazi / ya

名称、版本与用途

名称：Yazi 文件管理器
当前版本：26.1.22
命令：yazi、ya
路径：~/.local/bin/yazi、~/.local/bin/ya
用途：异步终端文件管理、预览、批量选择和插件扩展。

基本语法（Synopsis）

yazi [OPTIONS] [ENTRY]
ya <COMMAND> [ARGS]

[] 表示可选项，... 表示可重复；大写名称表示需要替换的参数。

当前安装与更新

当前来自本地 yazi 离线包，二进制安装到 ~/.local/bin。该安装器遇到已有 Yazi 会跳过，不能直接当升级器使用。

更新流程：

使用 prepare_yazi_bundle.zsh 获取并校验新的官方 release。
在临时环境验证 yazi --version。
备份后替换 yazi 和 ya。
单独检查插件兼容性。

配置文件与插件

~/.config/yazi/init.lua
~/.config/yazi/keymap.toml
~/.config/yazi/plugins/

当前插件：

starship.yazi
smart-enter.yazi
smart-paste.yazi
smart-paste-force.yazi

当前 ya pkg list 为空，说明这些插件是手工放置，不由 Yazi 包管理器跟踪。更新时需要单独替换并测试。

基本功能与推荐用法

yazi
yazi ~/repos
yazi --help
ya pkg list
ya pkg upgrade

常用操作以界面底部提示和当前 keymap 为准：

Enter：当前配置中智能进入目录或打开文件。
p：智能粘贴。
P：强制覆盖粘贴。
/：搜索。
q：退出。

推荐把 Yazi 用于交互浏览和选择；可重复的批处理使用 fd、rsync 或 Git。执行覆盖粘贴前确认目标目录。

示例中的选项、参数与子命令

本表解释本页示例实际出现的选项、参数、子命令及必要的辅助命令语法。

语法元素	含义
`ENTRY`	启动后打开的文件或目录。
`--help`	显示命令帮助。
`ya pkg list`	列出 Yazi 包。
`ya pkg upgrade`	升级已安装的 Yazi 包。

官方资料