Linux Retroism应用启动器实战:fuzzysort模糊搜索让任意程序秒开
Linux Retroism应用启动器实战:fuzzysort模糊搜索让任意程序秒开
Linux Retroism 是一款基于 Quickshell 的复古风 Linux 桌面方案(面向 Hyprland / Sway),其内置应用启动器用 fuzzysort 模糊搜索技术,让你只敲几个字母就能秒开任意程序。本文带你 3 分钟上手这个启动器,并看懂模糊搜索背后的源码设计。
为什么复古桌面也需要"秒开"体验?
Linux Retroism 以 1980–1990 年代的用户界面美学为核心:方框窗体、像素图标、仿 Win95 风格的任务栏。但"复古"只是皮肤,体验不能倒退——它用 Quickshell(Quickshell 是运行在 Wayland 之上的 Qt/QML 外壳工具)重写了整套前端,包括任务栏、启动器、设置面板等。
其中最实用的就是应用启动器:不用逐层翻菜单,敲下 fir 就能找到 Firefox,敲下 term 就能定位终端,回车直接启动。
打开应用启动器的 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_<屏幕名>),多屏用户可以在任意一块屏幕上独立唤起,互不干扰。
模糊搜索是怎么"秒出"的?
启动器底层的模糊匹配由 fuzzysort.js 提供——它是知名 JavaScript 模糊搜索库 fuzzysort 的移植版(MIT 许可)。它的核心机制分两步:
- 预计算(prepare):程序启动时,把每个应用名称预处理成紧凑的内部结构,并算好"位标记"(bitflags)。
- 快速筛选(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每次输入被调用一次,返回按相关度排好序的应用数组。
交互细节:为"手不离键盘"而设计
打开 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 激活。
相关文件速查
- 启动器界面:configs/quickshell/popups/AppLauncher.qml
- 搜索数据层:configs/quickshell/utils/AppSearch.qml
- 模糊算法封装:configs/quickshell/utils/Fuzzy.qml 与 fuzzysort.js
- 任务栏与按钮逻辑:configs/quickshell/taskbar/Bar.qml
- 快捷键绑定:configs/hypr/hyprland.conf、configs/sway/config
- 安装脚本:install.sh
总结:Linux Retroism 的应用启动器证明了"复古"与"高效"并不冲突——预计算 + 模糊匹配的三层结构,让启动任意程序只需几个字母。如果你想在自己的 Hyprland / Sway 桌面里复刻这套体验,上面这些源码文件就是最好的起点。


