dsh-fff

在大型代码仓里，Agent 往往只能凭模糊路径或片段文件名去猜该读哪份文件；内置 grep 也未必能按「fzf 式」多关键词快速筛路径。dsh-fff 把 Pi 生态里的 fast fuzzy finder 思路搬进 DSH：先对工作区做轻量路径索引，再提供模糊查找、歧义消解和相关文件联想，需要时还能用 ripgrep 做带分组计数的内容搜索。

核心能力集中在四个工具上。find_files 用空格分隔的多 token 做 fzf 风格路径匹配，basename 与目录段有不同权重，返回排序后的候选列表。resolve_file 把一句模糊引用收成一条可交给 read/replace 的精确路径，并在并列时给出 runner-up，方便暴露歧义。related_files 按同 stem（如测试与实现配对）、同目录、兄弟目录等规则拉相关文件。fff_grep 在本机已安装 rg 的前提下，支持 regex/字面量、模糊 scope 与 glob 过滤，结果按文件分组并带计数。

索引层是纯 JavaScript 递归遍历，跳过 .git、node_modules、dist、build 等常见目录，设有约 5 万文件与 16 层深度上限，并带 60 秒 TTL 缓存；为适配 DSH 动态插件不能 require npm 包，实现上零 npm 依赖，中型项目通常够用。若未安装 ripgrep，fff_grep 会给出明确错误，内容搜索仍可走 DSH 内置 grep。

适合经常在 monorepo 或多模块项目里让 Agent 定位文件、消歧路径、顺带找测试/实现配对的开发者；也适合希望聊天会话里统一使用 find_files / resolve_file，而不是反复手写完整路径的人。