leave

返回到当前悬停文件的父目录；如果当前没有悬停文件，则返回当前工作目录的父目录。

enter

进入子目录。

back

返回上一个目录。

forward

前进到下一个目录。

seek

滚动预览面板中的内容。

spot

使用预设或用户自定义的 spotter 显示文件信息。

cd

切换当前目录。

你可以添加自己的 g 系列按键，来实现简单的书签功能：

[[mgr.prepend_keymap]]
on   = [ "g", "d" ]
run  = "cd ~/Downloads"
desc = "Cd to ~/Downloads"
[[mgr.prepend_keymap]]
on   = [ "g", "p" ]
run  = "cd ~/Pictures"
desc = "Cd to ~/Pictures"

对于 Windows 用户，也可以通过 cd 动作切换盘符：

[[mgr.prepend_keymap]]
on   = [ "g", "d" ]
run  = "cd D:"
desc = "Switch to D drive"
[[mgr.prepend_keymap]]
on   = [ "g", "p" ]
run  = 'cd "E:\\Pictures"'  # 需要转义反斜杠
desc = 'Cd to E:\Pictures'

更完整的书签 plugin 可参见 resources page。

follow

如果当前悬停文件是符号链接，则跟随它。

reveal

将光标悬停到指定文件上。

如果该文件不在当前目录中，会先切换当前目录到该文件的父目录。

toggle

切换当前悬停文件的选中状态。

toggle_all

切换当前工作目录中所有文件的选中状态。

注意，toggle_all --state=off 只会取消当前工作目录（CWD）中的选中项；如果你在多个目录中选中了文件，并想全部取消，请使用 escape --select。

visual_mode

进入可视模式。

open

使用 [open] 中定义的规则 打开所选文件。

yank

Yank 选中的文件。

unyank

取消文件的 yank 状态。

paste

粘贴已 yank 的文件。

link

为已 yank 的文件创建符号链接。（在 Windows 上这是特权操作，必须以管理员身份运行。）

hardlink

为已 yank 的文件创建硬链接。

remove

在 macOS / Windows 上将文件移动到废纸篓 / 回收站。对于 Linux，则遵循 FreeDesktop.org Trash Specification。

在 Android 平台上，由于不存在回收站概念，因此只能结合 --permanently 选项使用。

create

创建文件或目录。以 /（Unix）或 \（Windows）结尾时表示创建目录。

rename

重命名文件或目录；如果选中了多个文件，则执行批量重命名（默认使用 $EDITOR 编辑文件名，详见 Specify a different editor for bulk renaming）。

• --hovered：无论当前是否有选中项，都始终重命名当前悬停文件
• --force：如果目标文件已存在，则直接覆盖，不显示确认对话框

• --empty：清空文件名的一部分

  • "stem"：清空主文件名，例如 "foo.jpg" -> ".jpg"
  • "ext"：清空扩展名，例如 "foo.jpg" -> "foo."
  • "dot_ext"：清空点号和扩展名，例如 "foo.jpg" -> "foo"
  • "all"：清空整个文件名，例如 "foo.jpg" -> ""

• --cursor：指定重命名输入框中的光标位置

  • "end"：文件名末尾
  • "start"：文件名开头
  • "before_ext"：扩展名前

你也可以将 --cursor 与 --empty 结合使用。例如，rename --empty=stem --cursor=start 会清空文件主名，并把光标移动到开头。

这会让文件名 foo.jpg 在输入框中显示为 |.jpg，其中 | 表示光标位置。

copy

复制已选中或当前悬停的文件/目录的 URL。

[what] 可取以下值之一：

--separator 可取以下值之一：

shell

运行 shell 命令。

你可以在 [template] 中使用以下格式化参数：

• %h：当前悬停文件的路径；如果当前目录为空且没有悬停文件，则为空
• %s：所有已选文件的路径
• %sN：第 N 个已选文件的路径，例如 %s1、%s2
• %d：所有已选文件所在目录的路径
• %dN：第 N 个已选文件所在目录的路径，例如 %d1、%d2
• %%：转义后的 % 字符本身

以及它们的 URL 版本：

• %H：当前悬停文件的 URL；如果当前目录为空且没有悬停文件，则为空
• %S：所有已选文件的 URL
• %SN：第 N 个已选文件的 URL，例如 %S1、%S2
• %D：所有已选文件所在目录的 URL
• %DN：第 N 个已选文件所在目录的 URL，例如 %D1、%D2

你可以使用 end-of-options marker（--）来避免转义问题——-- 之后的所有内容都会被当作原始字符串处理：

[[mgr.prepend_keymap]]
on = "d"
- run = "shell \"trash-put %s\""
+ run = "shell -- trash-put %s"
desc = "Trash selected files"

对于复杂的 shell 脚本，你可以使用 TOML 的基础字符串（''' 或 """）将其写成多行，示例见 this tip。

hidden

设置隐藏文件的可见性。

linemode

设置 line mode。

search

你可以通过 fd 配合空关键字（""）来实现平铺视图（flat view）。

或者把一个按键绑定到 search_do 动作上，以便快速切换到平铺视图：

[[mgr.prepend_keymap]]
on   = [ "g", "f" ]
run  = 'search_do --via=fd --args="-d 3"'
desc = "Switch to the flat view with a max depth of 3"

find

在当前工作目录中以交互、增量的方式查找文件。

find_arrow

将光标移动到下一个或上一个匹配项。

filter

sort

• [by]：可选；如果不提供，则保持当前排序方式不变

  • "none"：不排序
  • "mtime"：按最后修改时间排序
  • "btime"：按创建时间排序
  • "extension"：按文件扩展名排序
  • "alphabetical"：按字母顺序排序，例如 1.md < 10.md < 2.md
  • "natural"：按自然顺序排序，例如 1.md < 2.md < 10.md
  • "size"：按文件大小排序
  • "random"：随机排序
• --reverse：倒序显示文件。--reverse 或 --reverse=yes 为启用，--reverse=no 为禁用。
• --dir-first：目录优先显示。--dir-first 或 --dir-first=yes 为启用，--dir-first=no 为禁用。
• --translit：对文件名进行音译转换排序，详见 sort_translit。--translit 或 --translit=yes 为启用，--translit=no 为禁用。

tab_create

如果既没有指定 [url]，也没有指定 --current，则会使用启动目录创建标签页。

tab_close

如果你想关闭当前标签页，请改用 close 动作。

tab_switch

tab_swap

help

打开帮助菜单。

plugin

参见 Functional plugin。

noop

如果你想禁用某些预设快捷键，而不重写整个 keymap，可以使用虚拟动作 noop。

例如，要禁用默认的 g ⇒ c：

[[mgr.prepend_keymap]]
on  = [ "g", "c" ]
run = "noop"

或者如果你更喜欢数组写法：

[[mgr.prepend_keymap]]
on  = [ "g", "c" ]
run = [ "noop" ]  # 数组只能有一个元素，且必须是 "noop"

被禁用的按键按下后不会触发任何动作，也不会显示在 which 组件中。

[tasks]

show

显示任务管理器。

close

隐藏任务管理器。

arrow