Linux Retroism应用启动器实战:fuzzysort模糊搜索让任意程序秒开

原创2026-10-27 21:11:511,981 阅读
文章标签:桌面应用UI组件设计系统

Linux Retroism应用启动器实战:fuzzysort模糊搜索让任意程序秒开

Linux Retroism 是一款基于 Quickshell 的复古风 Linux 桌面方案(面向 Hyprland / Sway),其内置应用启动器用 fuzzysort 模糊搜索技术,让你只敲几个字母就能秒开任意程序。本文带你 3 分钟上手这个启动器,并看懂模糊搜索背后的源码设计。

为什么复古桌面也需要"秒开"体验?

Linux Retroism 以 1980–1990 年代的用户界面美学为核心:方框窗体、像素图标、仿 Win95 风格的任务栏。但"复古"只是皮肤,体验不能倒退——它用 Quickshell(Quickshell 是运行在 Wayland 之上的 Qt/QML 外壳工具)重写了整套前端,包括任务栏、启动器、设置面板等。

其中最实用的就是应用启动器:不用逐层翻菜单,敲下 fir 就能找到 Firefox,敲下 term 就能定位终端,回车直接启动。

Linux Retroism 应用启动器桌面效果:复古任务栏与 Your Computer 开始菜单

打开应用启动器的 3 种方式

方式 操作 说明
⌨️ 快捷键 Super + D 默认绑定,最快
🖱️ 任务栏按钮 点击任务栏正中的放大镜图标 图形化入口
📡 IPC 调用 quickshell ipc call appLauncher_<屏幕名> toggleAppLauncher 可写入其他脚本

1. 快捷键(推荐)

Hyprland 配置中,启动器入口定义在 hyprland.conf:

$mainMod = SUPER
$menu = quickshell ipc call appLauncher_$(hyprctl monitors -j | jq -r '.[] | select(.focused == true) | .name') toggleAppLauncher
bind = $mainMod, D, exec, $menu

思路很简单:通过 quickshell ipc 向当前聚焦屏幕上的 Quickshell 实例发送 IPC 消息,触发 toggleAppLauncher 切换开/关。Sway 用户同理,见 sway/config。

2. 任务栏按钮

任务栏 Bar.qml 中,居中的放大镜按钮会调用 appLauncher.openAppLauncher(),并用 isToggled 状态高亮表示启动器已打开。

3. IPC 自定义

因为 IPC 目标名带屏幕前缀(appLauncher_<屏幕名>),多屏用户可以在任意一块屏幕上独立唤起,互不干扰。

Linux Retroism 复古桌面 Cherry 主题:任务栏与应用启动器入口

模糊搜索是怎么"秒出"的?

启动器底层的模糊匹配由 fuzzysort.js 提供——它是知名 JavaScript 模糊搜索库 fuzzysort 的移植版(MIT 许可)。它的核心机制分两步:

  1. 预计算(prepare):程序启动时,把每个应用名称预处理成紧凑的内部结构,并算好"位标记"(bitflags)。
  2. 快速筛选(go):每次输入时,先用位运算一步排除"不可能匹配"的候选项,再对剩余项逐字符打分排序。

这带来两个直观好处:

  • 输入可以乱序、缺字:firfo 能匹配 Firefox,firfox、firfox 打错也能中;
  • 列表自动按相关度排序:输入 te 时,Terminal 会排在 TeamViewer 之前。

源码走读:三层结构各司其职

整个搜索功能由 3 个单例模块组成,层层封装,非常适合作为学习 Quickshell 模块化的样本:

模块 文件 职责
① 算法层 Fuzzy.qml 薄封装,向 QML 暴露 go() 与 prepare()
② 数据层 AppSearch.qml 枚举 .desktop 应用条目并执行查询
③ 界面层 AppLauncher.qml 搜索框、结果列表与动画

数据层的 AppSearch.qml 是整个启动器的"大脑",核心逻辑只有几行:

readonly property var preppedNames: list.map(a => ({
                name: Fuzzy.prepare(`${a.name} `),
                entry: a
            }))

function fuzzyQuery(search: string): var {
    return Fuzzy.go(search, preppedNames, { all: true, key: "name" })
        .map(r => r.obj.entry);
}
  • 应用列表来自 DesktopEntries.applications(Quickshell 内置能力,枚举系统中全部 .desktop 条目)并按名称排序;
  • preppedNames 在启动时一次性预计算,之后每次按键只做打分,所以输入延迟极低;
  • fuzzyQuery 每次输入被调用一次,返回按相关度排好序的应用数组。

Linux Retroism 桌面壁纸 Metropolis:搭配复古任务栏与应用启动器

交互细节:为"手不离键盘"而设计

打开 AppLauncher.qml 可以看到多处面向效率的设计:

  • 打开即聚焦:searchInput.forceActiveFocus() 让弹出瞬间输入框就有焦点,不需要先挪鼠标;
  • 输入即时过滤:onTextChanged 信号里直接调用 Utils.AppSearch.fuzzyQuery(searchInput.text) 刷新结果列表;
  • 回车直达:当筛选结果只剩 1 个时,按回车立即 execute() 启动该应用并关闭启动器(onAccepted 分支);
  • Esc / 点击外部关闭:输入框绑定 Keys.onEscapePressed,背景点击也会触发关闭回调;
  • 图标即时渲染:每条结果的图标通过 Quickshell.iconPath(iconName, true) 按图标主题解析,配合仓库自带的 RetroismIcons 呈现复古外观。

常见问题 FAQ

Q1:我安装的应用搜不到? 启动器读取的是系统全部 .desktop 桌面条目。确认它安装在标准目录(如 ~/.local/share/applications/ 或 /usr/share/applications/)且文件有效,之后重启启动器即可。

Q2:Super + D 没反应? 确认 Quickshell 正在运行、且当前焦点屏幕名与 IPC 目标 appLauncher_<屏幕名> 匹配;可手动执行 quickshell ipc call ... toggleAppLauncher 验证。

Q3:想换一套外观主题? 任务栏有内置主题切换菜单(ThemeMenu.qml),GTK 与图标主题可参考 install.sh 说明手动放入 ~/.local/share 并用 nwg-look 激活。

相关文件速查

总结:Linux Retroism 的应用启动器证明了"复古"与"高效"并不冲突——预计算 + 模糊匹配的三层结构,让启动任意程序只需几个字母。如果你想在自己的 Hyprland / Sway 桌面里复刻这套体验,上面这些源码文件就是最好的起点。

登录后查看全文
linux-retroism