DSH Plugins
返回列表
⚙️

dsh-search-path-guard

工作流 更新于 2026.11.16

在终端中运行以下命令:

dsh plugin install chocobo77/dsh-search-path-guard

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

在 DeepSeek Harness 中执行 dsh plugin install chocobo77/dsh-search-path-guard,即可从 https://github.com/chocobo77/dsh-search-path-guard 安装本搜索路径预检守卫插件。

插件介绍

在 Agent 工作流里,模型常会对着不存在的目录或文件发起 grep、glob 乃至 read、edit。这类调用往往要等 ripgrep 或工具真正跑起来才失败,exit 2 和本地化 stderr 还会以乱码形式塞进上下文,既浪费轮次又放大误判。历史会话数据也显示,相当一部分工具错误来自坏路径搜索——尤其容易在臆测仓库布局时踩坑。

dsh-search-path-guard 挂在 tools/pre-execute 上,在工具执行前做存在性与内容主张校验:grep/glob 的 path 不存在则直接拒绝,并给出 glob-near 风格的一行修正建议;read、read_image 对缺失文件同样拦截,对误用 read_image 读非图片会提示改用 read;edit 在文件不超过配置上限时会预读内容,old_string 缺失或多次匹配时拒绝并说明可能需先 read。路径存在则放行,不可读等问题仍交给底层工具处理;无路径、路径非字符串或 workdir 无法解析时一律放行,避免误杀。

同一目标路径上 grep 连续零结果达到阈值(默认 5 次)会触发策略升级,强制换思路而非反复换关键词空转。若 Agent 连续被守卫拒绝,从第三次起会在文案中追加「换目标/换方法或告知用户」等指引,并提醒不要把不会被执行的文本形态调用写进正文。可通过 disabled、maxEditBytes、zeroResultBlock 等配置调节行为;与内核 search-core 中的 preflight 可共存,插件先拦、内核兜底。

适合在 DeepSeek Harness 或类似编排里跑 coding Agent、且常被无效搜索与 edit 断言失败拖慢会话的团队或个人;希望把失败前置为一行可读诊断、减少 stderr 污染和「再搜一轮」循环的人,会最受益。

使用场景

  • 模型反复对不存在的目录做 grep 或 glob
  • edit 因 old_string 不匹配或并发修改反复失败
  • 同一路径 grep 零结果多次仍不换策略

适合人员

  • 在 Harness 上跑 coding Agent 的开发者
  • 希望减少工具错误污染上下文的团队
  • 需要可配置预检与零结果熔断的运维