deepseekplugins

DeepSeek Harness plugin

dsh-fff

Fuzzy file finding and indexed content search for DSH: find_files / resolve_file / related_files / fff_grep. Pure-JS path index + subsequence scoring (no native dependencies). Port of pi-fff for the

Tools & Capabilities
Jump to install

Source facts

Repository
sleepinginsummer/dsh-fff
Latest update
Aug 14, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/sleepinginsummer/dsh-fff
Plugin: dsh-fff
Author: sleepinginsummer

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-fff

![npm version](https://www.npmjs.com/package/dsh-fff)

模糊文件查找 + 索引内容搜索——DSH 插件，移植自 Pi Coding Agent 生态的 pi-fff（FFF = fast fuzzy finder）。

功能

工具说明
find_files模糊路径搜索（fzf 风格多 token：空格分隔、每个 token 必须命中；basename 计双倍、目录段计半，连续片段加分），返回排序路径列表
resolve_file模糊引用 → 单个精确路径（并列给出 runner-up，暴露歧义），结果可直接喂给 read/replace
related_files相关文件：同 stem（.test.ts/.spec.ts/实现配对）→ 同目录 → 兄弟目录
fff_grepripgrep 内容搜索（regex/字面量、模糊 scope、glob 过滤），结果按文件分组带计数

索引：纯 JS 递归遍历工作区（fs.listDir），跳过 .git/node_modules/dist/build 等目录，5 万文件 / 16 层上限；60 秒 TTL 缓存。零 npm 依赖（Pi 原版用原生 @ff-labs/fff-node，动态插件不能 require npm 包，故纯 JS 重写；中型项目性能足够）。

内容搜索：走 subprocess 服务调用 ripgrep（rg --no-heading --line-number）；rg 未安装时给出明确错误并提示使用内置 grep 工具。

安装

dsh plugin --profile <name> add dsh-fff

安装后重启 DSH，find_files / resolve_file / related_files / fff_grep 对所有会话生效（fff_grep 需要本机装有 ripgrep）。

开发

npm test   # 15 用例：子序列打分、多 token、basename/目录权重、排序/截断、相关文件、搜索结果分组、静态求值、工具注册

与 pi-fff 的差异

  • 无原生索引库：纯 JS 路径索引 + 子序列打分（原版为 C++ FFF 索引 + 后台 watcher）；
  • 无编辑器 @... 补全（DSH 聊天输入没有该机制；如需浏览器端文件选择器 UI 可后续加 Client Slot）；
  • read/grep 工具覆盖不做（DSH 内置工具行为不同，模糊解析通过 resolve_file/fff_grep 显式提供）。

参考

Back to searchOpen GitHub repository

More related plugins

View category