如果您想进一步缩小命令返回的结果，请按 Ctrl-Q 切换交互模式。

执行外部程序

您可以设置键绑定，以便在不离开 skim 的情况下启动外部进程（execute、execute-silent）。

# Press F1 to open the file with less without leaving skim
# Press CTRL-Y to copy the line to clipboard and aborts skim (requires pbcopy)
sk --bind 'f1:execute(less -f {}),ctrl-y:execute-silent(echo {} | pbcopy)+abort'

预览窗口

这是 fzf 的一个很棒的功能，skim 借用了它。例如，我们使用 'ag' 来查找匹配的行，一旦我们缩小到目标行，我们最终想通过检查该行周围的环境来决定选择哪些行。 grep 和 ag 有一个选项 --context，skim 可以通过预览窗口做得更好。例如

sk --ansi -i -c 'ag --color "{}"' --preview "preview.sh {}"

（注意 preview.sh 是一个根据文件名：行：列打印上下文的脚本）你会得到这样的东西

它是如何工作的？

如果通过 --preview 选项提供了预览命令，skim 将将当前高亮显示的行（用单引号括起来）替换为 {}，调用命令获取输出，并在预览窗口中打印输出。

有时调用命令不需要整行。在这种情况下，您可以使用 {}，{1..}，{..3} 或 {1..5} 来选择字段。语法在“字段支持”部分中解释。

最后，您可能想配置预览窗口的位置，使用 --preview-window。

• --preview-window up:30% 将窗口放置在上方，高度为 skim 总高度的 30%。
• --preview-window left:10:wrap，指定 wrap 允许预览窗口包裹预览命令的输出。
• --preview-window wrap:hidden 在启动时隐藏预览窗口，之后可以通过 toggle-preview 动作显示。

字段支持

通常只有插件用户需要理解这一点。

例如，您有如下格式的数据源

<filename>:<line number>:<column number>

但是，您只想在输入查询时搜索 <filename>。这意味着当您输入 21 时，您希望找到一个包含 <filename> 的 21，但不是匹配行号或列号。

您可以使用 sk --delimiter ':' --nth 1 来实现这一点。

您还可以使用 --with-nth 来重新排列字段的顺序。

范围语法

• <num> -- 指定第 num 个字段，从 1 开始。
• start.. -- 从第 start 个字段开始，一直到其余字段。
• ..end -- 从第 0 个字段开始，一直到第 end 个字段，包括 end。
• start..end -- 从第 start 个字段开始，一直到第 end 个字段，包括 end。

作为库使用

Skim 可以作为 Rust 包的库使用。

首先，将 skim 添加到您的 Cargo.toml。

[dependencies]
skim = "*"

然后尝试运行这个简单的示例

extern crate skim;
use skim::prelude::*;
use std::io::Cursor;

pub fn main() {
    let options = SkimOptionsBuilder::default()
        .height(Some("50%"))
        .multi(true)
        .build()
        .unwrap();

    let input = "aaaaa\nbbbb\nccc".to_string();

    // `SkimItemReader` is a helper to turn any `BufRead` into a stream of `SkimItem`
    // `SkimItem` was implemented for `AsRef<str>` by default
    let item_reader = SkimItemReader::default();
    let items = item_reader.of_bufread(Cursor::new(input));

    // `run_with` would read and show items from the stream
    let selected_items = Skim::run_with(&options, Some(items))
        .map(|out| out.selected_items)
        .unwrap_or_else(|| Vec::new());

    for item in selected_items.iter() {
        print!("{}{}", item.output(), "\n");
    }
}

给定一个 Option<SkimItemReceiver>，Skim 会相应地读取项目，执行其任务，并返回用户选择，包括所选项目、查询等。注意：

• SkimItemReceiver 是 crossbeam::channel::Receiver<Arc<dyn SkimItem>>
• 如果为空，它将调用给定的命令并从命令输出中读取项目
• 否则，它将从（crossbeam）通道中读取项目。

通过提供 SkimItem 特性来自定义行如何显示、比较和预览。它默认实现了对 AsRef<str>

SKIM_DEFAULT_COMMAND="fd --type f || git ls-tree -r --name-only HEAD || rg --files || find ."
sk

let $SKIM_DEFAULT_COMMAND = "git ls-tree -r --name-only HEAD || rg --files || ag -l -g \"\" || find ."

$ for n in {1..10}; do echo "$n"; done | sk
  0/10 0/0.> 10/10  10  9  8  7  6  5  4  3  2> 1

export TERMINFO=/data/data/com.termux/files/usr/share/terminfo