DeepSeek Harness 插件

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(英文原文)

跳到安装方式

来源信息

GitHub 仓库
sleepinginsummer/dsh-fff
最近更新
2026年8月14日
分类
工具与能力
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/sleepinginsummer/dsh-fff
插件名:dsh-fff
作者:sleepinginsummer

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器2 个文件
README.md来源说明 · 只读预览

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 显式提供)。

参考