DSH Plugins
返回列表
⚙️

dsh-find-file

工作流 更新于 2026.10.11

在终端中运行以下命令:

dsh plugin install Ronniealgo/dsh-find-file

将以下提示词粘贴到 DeepSeek Harness 对话框中:

在 DeepSeek Harness 中执行 dsh plugin install Ronniealgo/dsh-find-file 即可从 https://github.com/Ronniealgo/dsh-find-file 安装并启用该插件。

插件介绍

在 Windows 等环境里,DSH 内置 glob 常委托给 ripgrep。扫到受 ACL 保护的目录时,rg 非零退出,整条搜索连同已找到的路径一并作废,模型往往只剩一条 Error,与「确实没找到」难以区分,容易误推文件不存在。

dsh-find-file 为 Harness 注册 find_file 工具:在指定根目录下用文件名通配符(星号、问号)查找,纯 Node 实现且无额外运行时依赖。无法读取的目录会跳过并在结果中记录 errno;因权限、时间预算、结果上限或深度上限导致覆盖不完整时,complete 为 false 并附带 incompleteReason,并以 VERDICT 行明确本次结论是否可信。

仅匹配文件名,不支持路径式 glob 或内容搜索;符号链接与 junction 不跟随,以避免环路与范围失控。适合需要在宽目录树中让 Agent 找文件、且要求搜索过程可解释、可审计的 DSH 用户。

使用场景

  • 在 Windows 宽目录下按文件名通配符查找配置或脚本
  • 内置 glob 因拒绝访问整次失败时需要可继续的替代方案
  • 需要区分「搜全未命中」与「搜索不完整不能下结论」

适合人员

  • 经常在 Program Files 或用户主目录让 Agent 找文件的 DSH 用户
  • 受 Windows ACL 影响、需要可解释搜索结果的开发者
  • 希望用纯 Node、无 ripgrep 依赖完成文件名查找的工作流维护者