zeusinsight/FinderSearch

选用指南

AI 根据 README 整理 · 2026/10/10 22:55:54

适用场景

适用于需要快速按文件名查找本地文件、浏览文件夹并进行日常文件操作（如复制、移动、重命名）的场景。

查看 README 依据

# FinderSearch <img src="assets/logo.png" alt="FinderSearch logo" width="96" height="96"> A native Mac file browser built around fast filename search. FinderSearch puts [fsearch](https://github.com/noahdunnagan/fsearch) behind a familiar macOS interface. Browse folders, preview files, and find what you need without switching to a terminal.  <details> <summary>List view</summary>  </details> ## What works

- **Fuzzy filename search.** Typo tolerance, relevance ranking, folder scope, and filters such as `ext:pdf` and `mtime:<7d`. - **Four views.** Icons, a sortable native list, columns, and a gallery with Quick Look. - **Everyday file work.** Tabs, copy/move, rename, tags, sharing, Trash, and undo. - **Quick navigation.** Recent folders are cached; clearing search restores your browsing view. Uncached folders show loading placeholders. Built with SwiftUI and AppKit. Search runs locally. Files aren't uploaded. ## Search performance

目标用户

面向 macOS 用户，特别是需要高效文件搜索和管理的用户。

查看 README 依据

# FinderSearch <img src="assets/logo.png" alt="FinderSearch logo" width="96" height="96"> A native Mac file browser built around fast filename search. FinderSearch puts [fsearch](https://github.com/noahdunnagan/fsearch) behind a familiar macOS interface. Browse folders, preview files, and find what you need without switching to a terminal.  <details> <summary>List view</summary>  </details> ## What works

使用方式

通过图形界面使用，支持快捷键操作，如搜索（⌘F）、切换视图（⌘1-4）等。

查看 README 依据

the app to include protected folders. Let the first index build before judging search. The app is ad-hoc signed and not notarized. The current build has been checked on Apple Silicon; Intel and installation on a second Mac remain unverified. ## A few shortcuts | Action | Shortcut | | --- | --- | | Search | ⌘F | | Change view | ⌘1–4 | | Quick Look | Space | | New tab | ⌘T | | Go to folder | ⇧⌘G | | Copy / paste / move here | ⌘C / ⌘V / ⌥⌘V | | Undo | ⌘Z | [More usage, permissions, and troubleshooting](docs/USAGE.md) ## Still early

部署要求

下载版需要 macOS 15+ 和 Apple Silicon；源码构建需要 Xcode 16+ 或兼容的命令行工具，以及 Rust 1.85+ / Cargo。

查看 README 依据

end-to-end latency. The app also waits 150 ms after typing stops. [Method, p95 timings, raw samples, and reproduction](docs/benchmarks/README.md). ## Download **[Download FinderSearch for Apple Silicon](https://github.com/zeusinsight/FinderSearch/releases/latest)** (macOS 15 or newer). Open the `.dmg`, drag FinderSearch into Applications, then eject the disk image and launch the app. No developer tools are required. This early release is not Developer ID-signed or notarized. If macOS blocks it, open **System Settings → Privacy & Security → Open Anyway** for FinderSearch.

Grant **Full Disk Access** there to search protected folders, then quit and reopen the app. Let the first index build before judging search. ## Build from source You'll need **macOS 15+**, **Xcode 16+ or compatible Command Line Tools**, and **Rust 1.85+ / Cargo**. ```sh git clone https://github.com/zeusinsight/FinderSearch.git cd FinderSearch ./scripts/build.sh open dist/FinderSearch.app ``` The script bundles fsearch; you don't need to install it separately. Grant **Full Disk Access** in System Settings → Privacy & Security, then quit and reopen

已知限制

当前版本不支持 AirDrop、Finder 扩展、智能文件夹、批量重命名、持久会话/撤销历史，且未提供内容搜索。

查看 README 依据

This is a file browser, not a replacement for the macOS shell. No AirDrop, Finder extensions, saved smart folders, batch rename, or persistent session/undo history yet. Content search isn't exposed in the UI. File conflicts refuse overwrites; there is no merge dialog. Slow disks and cloud providers can still take time. ## Development ```sh swift test -c release ``` See [CONTRIBUTING.md](CONTRIBUTING.md) for the code layout and checks. Bug reports with a reproducible query or navigation sequence are welcome. ## License