ESC
开源 1 分钟阅读

FinderSearch：原生 macOS 文件浏览器，搭载 fsearch 实现快速模糊文件名搜索

FinderSearch 是一款原生 macOS 文件浏览器，基于开源搜索引擎 fsearch 提供快速模糊文件名搜索，支持多种视图、Quick Look 预览、批量重命名等功能。基准测试显示其搜索仅需 0.49–1.14 毫秒，远快于 Spotlight 的 7 毫秒左右，且完全本地运行。应用采用 SwiftUI 与 AppKit 构建，MIT 协议开源。

来源：GitHub

FinderSearch logo

FinderSearch

一款原生 Mac 文件浏览器，具备快速模糊文件名搜索功能。在熟悉的 macOS 界面中浏览文件夹、预览文件并管理你的文件。

下载 Apple Silicon 版本 · macOS 15+ · 使用方法与快捷键 · 发行说明

FinderSearch 演示：侧边栏可见，输入文件名后搜索结果逐渐缩小范围

静态预览图

功能特性

  • 快速查找文件。 模糊匹配、相关性排序、文件夹范围限定，以及 ext:pdf、mtime:<7d 等过滤器。
  • 以你的方式浏览。 图标、列表、分栏和画廊视图，Quick Look 预览，以及重新打开应用时可恢复的标签页。
  • 高效完成文件操作。 拖拽选择、复制和移动、批量重命名、ZIP 工具、标签、共享、废纸篓以及撤销。
  • 尽在掌控。 传输进度显示、可取消操作，以及文件冲突时的清晰选项。

基于 SwiftUI 和 AppKit 构建，由 fsearch 提供支持。搜索完全在本地运行；你的文件不会被上传。

安装

  1. 下载 DMG 并将 FinderSearch 拖入 Applications。更新时，请先退出旧版应用再进行替换。
  2. 弹出磁盘映像并打开 FinderSearch。
  3. 在 系统设置 → 隐私与安全性 中启用 完全磁盘访问权限，以便搜索受保护的文件夹，然后退出并重新打开应用。

该应用尚未进行 Developer ID 签名或公证。如果 macOS 阻止其运行，请选择 隐私与安全性 → 仍要打开。请等待首次搜索索引完成构建。

权限与故障排除 →

性能

在三项针对 10,000 个生成文件的预热精确文件名基准测试中，fsearch 返回结果仅需 0.49–1.14 毫秒，而 Spotlight 需要 7.06–7.30 毫秒（Apple M4 上的中位数时间）。

这些测试衡量的是搜索后端（包括其 IPC 往返耗时），而非渲染后的 UI 延迟。FinderSearch 会在输入停止后等待 50 毫秒；按 Return 键可立即提交待处理的搜索。

基准测试方法、结果与复现 →

从源码构建

需要 macOS 15+、Xcode 16+ 或兼容的 Command Line Tools，以及 Rust 1.85+ / Cargo。

git clone https://github.com/zeusinsight/FinderSearch.git
cd FinderSearch
./scripts/build.sh
open dist/FinderSearch.app

构建过程会自动打包 fsearch。使用 swift test -c release 运行测试。开发检查和代码布局请参阅 CONTRIBUTING.md。已验证 Apple Silicon；Intel 构建尚未验证。

当前限制

FinderSearch 仍处于早期阶段。尚不支持内容搜索、AirDrop、Finder 扩展、已保存的智能文件夹、文件夹合并以及持久化撤销历史。慢速磁盘和云存储服务仍可能需要较长时间。

许可证与致谢

MIT。搜索引擎为 Noah Dunnagan 开发的 fsearch，以其 MIT 许可证原样引入。FinderSearch 在其基础上添加了原生界面和文件工作流。参见第三方声明。