FinderSearch

zeusinsightMIT活跃维护

一款原生 macOS 文件浏览器，用 fsearch 实现快速模糊文件名搜索，帮你在大量文件里秒定位目标。

A native macOS file browser with fast fuzzy filename search, powered by fsearch.

v0.4.9发布于 2026-10-13 07:25 UTC698star +1 / 7 天29fork同步于 2026-11-10 17:56 UTC

文件浏览器模糊搜索 macOS 文件名检索 Swift

对比 GitHub appkit file-manager macos search swift

怎么上手

由 README 提炼，执行前请确认

原文

下载 DMG 后把 FinderSearch 拖入 Applications，首次运行需在系统设置→隐私与安全性中开启完全磁盘访问权限

硬件要求按 README 说明

需要 macOS 15+；README 只提供 Apple Silicon 版下载，Intel 构建未经验证；搜索性能数据在 Apple M4 上测得。

支持 Apple Silicon

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

原生 macOS 文件浏览器，用 fsearch 做快速模糊文件名搜索，替代 Finder 找文件

一款原生 macOS 文件浏览器，用 fsearch 实现快速模糊文件名搜索，帮你在大量文件里秒定位目标。

核心能力

用 fsearch 做模糊匹配并按相关度排序
支持 ext:pdf、mtime:<7d 等搜索过滤语法
提供图标、列表、分栏、画廊四种视图和 Quick Look 预览
支持批量重命名、ZIP 打包、标签、分享与撤销
搜索在本地完成，文件不上传

容易踩的坑

应用未做 Developer ID 签名和公证，被 macOS 拦截时需在隐私与安全性里选「仍要打开」；不开启完全磁盘访问就搜不到受保护目录；首次搜索索引需要时间建完，期间结果可能不全；从源码构建还需 Xcode 16+ 和 Rust 1.85+/Cargo。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

FinderSearch

A native Mac file browser with fast, fuzzy filename search. Browse folders, preview files, and manage your files in a familiar macOS interface.

Download for Apple Silicon · macOS 15+ · Usage & shortcuts · Release notes

FinderSearch demo with the sidebar visible: type a filename and see search results narrow

Still preview

Features

Find files quickly. Fuzzy matching, relevance ranking, folder scope, and filters like ext:pdf and mtime:<7d.
Browse your way. Icon, list, column, and gallery views, Quick Look previews, and tabs that restore when you reopen the app.
Get file work done. Drag selection, copy and move, batch rename, ZIP tools, tags, sharing, Trash, and undo.
Stay in control. Transfer progress, cancellation, and clear choices when files conflict.

Built with SwiftUI and AppKit, powered by fsearch. Search runs locally; your files aren't uploaded.

Install

Download the DMG and drag FinderSearch into Applications. When updating, quit the old app first and replace it.
Eject the disk image and open FinderSearch.
Enable Full Disk Access in System Settings → Privacy & Security to search protected folders, then quit and reopen the app.

The app is not yet Developer ID-signed or notarized. If macOS blocks it, choose Privacy & Security → Open Anyway. Allow the first search index to finish building.

Permissions and troubleshooting →

Performance

In three warm, exact-filename benchmarks over 10,000 generated files, fsearch returned results in 0.49–1.14 ms, versus 7.06–7.30 ms for Spotlight (median times on an Apple M4).

These measure the search backend, including its IPC round trip, rather than rendered UI latency. FinderSearch waits 50 ms after typing stops; Return submits a pending search immediately.

Benchmark method, results, and reproduction →

Build from source

Requires macOS 15+, Xcode 16+ or compatible Command Line Tools, and Rust 1.85+ / Cargo.

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

The build bundles fsearch automatically. Run tests with swift test -c release. See CONTRIBUTING.md for development checks and the code layout. Apple Silicon is verified; Intel builds remain unverified.

Current limits

FinderSearch is still early. Content search, AirDrop, Finder extensions, saved smart folders, folder merging, and persistent undo history aren't supported yet. Slow disks and cloud providers can still take time.

License & credits

MIT. The search engine is fsearch by Noah Dunnagan, vendored unmodified at v0.2.0 under its MIT license. FinderSearch adds the native interface and file workflows. See third-party notices.

FinderSearch

怎么上手

项目说明