Lumio 是一个跑在 Mac 上的键盘启动器,仓库在 2026 年 11 月 6 日建立,到 11 月 17 日有 43 颗星、2 个未结问题,还没有人提交分支。项目用 Rust 写核心、SwiftUI 写界面,按 Option 加空格唤起,输入关键字就能找应用、文件、文件夹和剪贴板历史。它是 kunkka19xx/look 的分支,采用 GPL-3.0 许可,README 写明永远开源免费。
目前一共六个版本,最新 v0.0.7 在 11 月 14 日发布,下载 32 次,是各版里最多的。它要求苹果芯片的 macOS 15 及以上,安装包是临时签名且没有公证,手动安装需要先去掉隔离属性。GitHub 的一句话介绍写着跨平台,README 和安装说明都只给出 Mac 版本,本稿按 README 的口径来写。

界面归 Swift,搜索归 Rust
架构文档把分工写得很清楚:Swift 负责用户看到的一切和所有 macOS 接口,Rust 负责搜索、排序和存储。窗口、视图、快捷键、OCR 与更新检查都留在上层 SwiftUI 应用里,下层的 Cargo 工作区只处理数据与计算。两层之间隔着一条 FFI 桥,走 C 应用二进制接口,用 JSON 字符串传消息。
一次按键的流程有五步。视图把查询交给 EngineBridge,桥接层调用 lumio_search_json_compact,共享的查询引擎拿它去做匹配;Rust 侧先做模糊评分,再用使用历史给靠前的结果重排,最后序列化成 JSON 交回 Swift 解码成列表行。搜索全程在内存里进行,SQLite 只在启动时载入索引、顺便记录使用次数。
核心被拆成七个 crate,各自只管一件事。indexing 定义应用、文件、文件夹、设置这些候选及其编号,matching 负责大小写与重音折叠后的模糊打分,ranking 用精确匹配、前缀匹配和使用历史调整得分,storage 管 SQLite 里的候选、使用事件、网址历史与剪贴板记录,engine 把配置、发现、搜索和模式串起来,tools 决定用哪个编辑器和终端打开,answers 管网址处理和文字翻译。
core 的构建要求 Rust 1.88 及以上、edition 2024。发现应用、文件和设置各跑一条线程,通过有界通道把候选流式送出去;评分阶段用一个堆保留前 K 名,再对一小批候选做重排。性能测试单独放在 tools/perf 里,不会被打进正式安装包。
搜的不只是文件名
启动器默认能搜应用、文件、文件夹和剪贴板历史,按 Tab 切换结果过滤器,Cmd+1 到 Cmd+4 直接进入应用、文件夹、文稿和 OCR 标签。选中一个结果后,回车打开,Cmd+Enter 用网页搜索,Cmd+F 在访达里显示,Cmd+E 和 Cmd+T 分别送进编辑器与终端,Cmd+K 展开还能做什么。
搜索别名写在配置文件里,格式类似 alias_code 指向 Visual Studio Code、Cursor 与 Zed,应用查询在打分前先过一遍别名。排序会考虑精确匹配、前缀匹配和过去的使用记录,同一种文件类型和路径还会有各自的加减分。
选中单词后按 Option 加空格,Lumio 会直接打开这个词的字典条目。这项功能要读其他应用里选中的文字,所以只在第一次用到时申请辅助功能权限,不用的话应用不需要任何特殊授权。字典和翻译各有独立界面,翻译由 answers 模块通过超文本请求完成。


OCR 按图片里的文字找文件
OCR 标签是最后一个标签,点过滤栏上的 OCR、按 Cmd+4,或者用 Tab 切到它都能进入。搜索框会出现一枚 OCR 标记,输入三个及以上字符才开始找。每条结果会显示命中的那一行文字,右侧给出文件预览,按 Esc 或点 All 回到普通的文件名搜索。
它读的是图片和文稿里写着的字。png、jpg、jpeg、heic、heif、tiff、gif、bmp、webp 这些图片会走文字识别;带文字层的 PDF 先读文字层,页面里的截图和照片再识别一遍;扫描版 PDF 则逐页识别。纯文本文件不进 OCR 索引,还是按文件名正常查找。匹配时忽略大小写和重音,所以输入不带声调的拼写也能找到带声调的词,三个字符以上的每个词都要在文件里出现,顺序不限。
识别任务不跑在启动器进程里。打开 OCR 标签才会启动一个独立的 content-index-worker 进程,读新文件或改动过的文件,做完就退出,最多每十五分钟跑一次。文字识别用苹果的 Vision 框架在本机完成,不上传;识别结果存在应用支持目录的 content-index.db 里。启动器本身常驻的内存不会被识别时几百兆的占用撑大。
限制同样写在文档里。默认最多索引三千个文件,这个数可以在一百到两万之间调;超过 40 MB 的图片和超过 200 MB 的 PDF 会被跳过,每份 PDF 最多读三百页、其中十五页做识别,每个文件保留三万个字符,小于 48 像素的图标不读。首次打开 OCR 标签大约要等一分钟,系统在加载文字识别模型,之后每张图只要一小段时间。
六个版本一路加到剪贴板
六个 release 都挤在 11 月 6 日到 14 日。v0.0.2 到 v0.0.5 在同一天里连续发出,v0.0.6 在 11 月 11 日,v0.0.7 在 11 月 14 日。版本之间的提交记录能从官方的对比页面逐条查到,发布说明本身只留了一行对比链接。
v0.0.4 是功能变化最大的一版,加入 OCR 搜索,同时降低空闲时的内存占用并去掉结果里的前缀。v0.0.5 继续压内存,修了颜色标签和剪贴板相关的问题。v0.0.6 又修一次剪贴板,把持续集成和发布流程迁走,不再往已删除的镜像源推包。
v0.0.7 的提交写得很具体:剪贴板支持全部清除、复制后自动关闭窗口、给网页预览加摘要,还修了一排按钮互相遮挡的问题。这些细节加起来说明这条线还在早期,改动集中在剪贴板与结果列表的交互上。
应用每天检查一次更新,装新版本前会先问一声。设置里的关于页可以立刻检查,也能把每日检查关掉;用 Homebrew 装的那份还能通过升级命令更新。

配置文件与命令模式
设置放在 ~/.lumio/config,第一次启动自动生成。文件里能写要索引哪些文件夹、扫描深度与上限、忽略规则、搜索别名、标签页顺序、剪贴板历史条数,以及 Cmd+E 和 Cmd+T 调用的编辑器与终端。改完文件按 Cmd+Shift+分号就能重新载入,不必重启应用。
输入冒号或者按 Cmd+/ 进入命令模式。已知命令有三条,跟名字、进程号或端口输 kill 结束进程,emptytrash 清空废纸篓,help 看帮助。清空废纸篓被 macOS 保护,所以只有用到这条命令时才申请 Finder 的自动化权限。
剪贴板历史也是一个独立标签,复制过的文本留在本地数据库里。v0.0.7 给这一页加了全部清除,并且复制一条记录后窗口自动收起。要彻底卸载的话,Homebrew 装的用卸载命令加 zap 参数连数据一起删,手动装的还要自己清掉配置文件夹和应用支持目录。
装上前先看这几条
安装途径有两条。Homebrew 用户先添加 tap 再装 cask,顺带会把 lumio 命令加进命令行;手动安装从最新发布页下载 dmg,把应用拖进应用程序文件夹。因为安装包是临时签名、没有经过公证,手动装完要先执行去掉隔离属性的命令,否则首次打开会被系统拦下。
系统要求写得明确:Apple 芯片,macOS 15 及以上。仓库的一句话介绍虽然用了跨平台这个词,核心代码里也确实留了 Linux 与 Windows 的平台分支,但当前发布的应用只有 Mac 版,安装说明也只列了这条门槛。
代码来源同样要写清楚。Lumio 是 look 的分支,README 两处致谢都点名了原始作者,上层界面与新增的 OCR、剪贴板功能建在这份代码之上。GPL-3.0 许可意味着源码公开、可以修改和再分发,但衍生项目同样要按这个许可开放。

声明:本文来自苹果迷投稿,不代表苹果家园立场,版权归原作者所有,欢迎分享本文,转载请保留出处!