fff

Rust 核心文件搜索 SDK，让 AI 与编辑器秒级找文件

开源 🏷️定价信息待确认 ⚠️ 链接可跳转，访问体验不确定自动化工作流 🍴 复刻 481 🐛 待处理 96 👀 关注 21

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 11216

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类自动化工作流

开发团队dmtrKovalenko

官网地址https://fff.dmtrkovalenko.dev

GitHubhttps://github.com/dmtrKovalenko/fff

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态⚠️ 链接可跳转，访问体验不确定

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型bun,fff,filesearch,fzf,grep,lua,neovim,neovim-plugin,nodejs,python,rust

GitHub 星标★ 11216

上线时间2025-07-31 00:00:00

代码更新2026-11-06

仓库体积11.2 MB

本站数据更新2026-11-06

维护状态活跃

收录时间2026-09-22

浏览次数2

项目介绍

fff 是一个用 Rust 编写的高性能文件搜索 SDK，主打“最快且最准确”，面向 AI 智能体、Neovim、C、Python、Bun 和 Node.js 等场景提供统一的文件查找能力。它解决的是传统文件搜索工具在跨语言集成、模糊匹配精度与速度之间难以兼顾的问题：fzf 偏交互、grep 偏内容、系统 find 偏慢且接口不统一。fff 将搜索逻辑下沉到 Rust 核心，通过多语言绑定暴露简洁 API，让 AI agent 能快速定位工作区文件，让 Neovim 插件获得低延迟补全体验，也让脚本语言无需重复造轮子。核心能力包括快速遍历目录、模糊匹配与过滤、可嵌入的 SDK 设计，以及覆盖 Lua、Python、Node、Bun、C 的绑定。项目已获上万星标，属于该领域知名项目，适合需要把文件搜索作为基础设施嵌入到自身工具链中的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 11216

技术标签

bun lua neovim neovim-plugin nodejs

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Linux、macOS 或 Windows 环境
Neovim 插件使用需已安装 Neovim 并支持 Lua 配置
使用 Codex 集成需已安装 Codex CLI
部分安装方式需要网络可访问 GitHub 与 npm

安装与启动步骤

1一键安装 MCP 服务

Linux/macOS 官方一键脚本，会安装 fff-mcp 并打印对应客户端的接入说明。建议先阅读 install-mcp.sh 再执行。
```
curl -L https://dmtrkovalenko.dev/install-fff-mcp.sh | bash
```
2Windows 一键安装

Windows 用户在 PowerShell 中执行官方脚本，安装完成后同样会输出接入指引。
```
irm https://raw.githubusercontent.com/dmtrKovalenko/fff/main/install-mcp.ps1 | iex
```
3注册到 Codex

把已安装的二进制以绝对路径注册给 Codex，避免桌面会话未继承交互 shell 的 PATH。Homebrew 安装用此命令。
```
codex mcp add fff -- "$(brew --prefix)/bin/fff-mcp"
```
4脚本安装后注册

若使用一键安装脚本，二进制默认位于 ~/.local/bin，用该绝对路径注册到 Codex。
```
codex mcp add fff -- "$HOME/.local/bin/fff-mcp"
```
5安装 pi 绑定

如需在 pi 中使用 fff，可通过 npm 包 @ff-labs/pi-fff 安装。
```
pi install npm:@ff-labs/pi-fff
```
6配置 Neovim 插件

在 Neovim 配置中调用 require('fff').setup() 并覆盖需要的选项，默认值已较合理，通常只需改少量项。
```
require('fff').setup({
  base_path = vim.fn.getcwd(),
  max_results = 100,
  max_threads = 4,
  lazy_sync = true,
})
```

关键配置

配置项	必填	说明	示例
`base_path`	否	搜索的基准目录，默认当前工作目录	`vim.fn.getcwd()`
`max_results`	否	返回结果的最大数量	`100`
`max_threads`	否	搜索使用的最大线程数	`4`
`lazy_sync`	否	是否开启惰性同步	`true`
`follow_symlinks`	否	是否跟随符号链接进行索引	`false`
`enable_home_dir_scanning`	否	是否允许扫描用户 HOME 目录，默认开启	`true`