@ff-labs/pi-fff
用 Rust 原生 SIMD 引擎 FFF 替换 Pi 内置 find / grep 与 @ 自动补全,支持常驻预索引和访问频率排序。
安装命令
pi install npm:@ff-labs/pi-fff 临时试用 / 替代安装命令
pi -e npm:@ff-labs/pi-fff 挂接事件钩子与注册入口
session_startbefore_agent_startsession_shutdown
pi.registerTool()(fffind / ffgrep / fff-multi-grep)pi.setActiveTools()ctx.ui.addAutocompleteProvider()(接管 @ 文件补全)pi.registerCommand("fff-mode" / "fff-health" / "fff-rescan")pi.registerFlag() / pi.appendEntry()ctx.ui.setStatus() / notify() 1. 是什么
@ff-labs/pi-fff 是 FFF(Fast File Finder)官方 monorepo 中的 Pi 扩展包。
它把底层由 Rust 编写、带 SIMD 加速和 mmap 缓存的文件与内容检索引擎通过 Node 原生绑定直接接入 Pi。
2. 解决什么问题
Pi 内置的 find 与 grep 每次调用都要重新拉起外部 fd 或 rg 子进程重新扫磁盘,在大仓库里既慢又缺少跨查询记忆,用户和模型刚刚频繁修改过的文件,排名和冷门目录里的文件完全一样。
3. 作用原理(事件钩子与工具注册层)
在会话启动时对仓库建立内存预索引,注册并接管 find/grep 工具与编辑器 @ 自动补全提供器。
- 在 session_start 时启动 Rust FFF 引擎对工作区执行后台文件与内容预索引,同时读取并维护本地访问频率(frecency)与查询历史。
- 将内置基于 fd 的 find 替换为 fffind(模糊匹配 + Git 状态感知 + frecency 排序),把内置基于 rg 的 grep 替换为 ffgrep(SIMD + mmap 缓存、零子进程启动开销),并新增支持 Aho-Corasick 多模式 OR 匹配的 fff-multi-grep 工具。
- 通过 ctx.ui.addAutocompleteProvider() 把用户在终端输入框敲 @ 触发的文件路径补全也切到 FFF 内存索引上。
4. 怎么装与基本配置
- 运行 pi install npm:@ff-labs/pi-fff 即可使用,无需手动安装外部 fd 或 rg。
- 重要兼容提示:由于 Pi 扩展不支持对同一工具名做组合共享,如果已加载内置 FFF 的 UI 扩展(如 @heyhuynhgiabuu/pi-pretty 的 FFF 模式),请勿同时加载 @ff-labs/pi-fff。
- 可用 /fff-health 检查索引覆盖率,用 /fff-rescan 触发全量重扫,用 /fff-mode 切换接管模式。
5. 和同类怎么选
在代码智能方向里,@ff-labs/pi-fff 专注把“找文件”和“搜代码”做到极致速度与排序精准度,常作为底层检索基建搭配 pi-lens 等诊断包一起用。
与同类方案的选型对照
聚焦机制差异与适用边界,结合自身运行环境判断是否引入或保留同类替代包。
| 对比对象 | 机制差异 | 怎么选 |
|---|---|---|
@heyhuynhgiabuu/pi-pretty(方向 09) | pi-pretty 主打终端结果美化渲染,并顺带内置了 FFF 检索接管;@ff-labs/pi-fff 是 FFF 上游官方维护的纯粹检索扩展。 | 想要更纯净、紧跟 FFF 上游更新的检索能力(包括 fff-multi-grep)选 @ff-labs/pi-fff;想一套同时美化全部终端输出选 pi-pretty。 |
pi-ast-grep | pi-ast-grep 按抽象语法树匹配代码结构,适合精准重构模式查找;FFF 适合极速文件名与文本多模式检索。 | 两个工具名不冲突,可根据大型仓库重构需求同时安装互补。 |
看完「@ff-labs/pi-fff」后的下一步
可先读已公开的入门实操文章,或点击下方制作中项目表达关注度(不收集邮箱或隐私)
从 Claude Code / Codex 切到 Pi:最小可用配置单与实机演示视频
已上线入门参考: 《Pi 入门笔记》 (比 Codex 更自由,但也更折腾)
说明:此处未向后台提交个人资料或邮件表单。配置单与实机演示视频正在制作中,你的匿名点击已计入站点热度,用于排定优先录制方向。
Coding Agent 实战交付课:如何可控地把想法做成线上产品
由 kuhung 策划主讲。面向希望把 Coding Agent 用到真实工程与产品交付的开发者,讲清需求拆解、上下文控制、安全边界与上线验证。
说明:此处未向后台提交报名或收集任何个人信息。课程模块仍在筹备阶段,你的匿名点击将作为模块排期的优先参考。