dsh-http-probe:为 DSH 增加固定目标的 http_probe 工具

前言

在 DeepSeek Harness(DSH)里,给模型增加工具通常走插件化路径。很多场景下,模型不需要任意 URL 抓取能力,只需要对一个部署方控制的目标做受限的 HTTP GET 检查。dsh-http-probe 就是为此提供 http_probe 工具的第三方 DSH 插件。

这是什么

dsh-http-probe 是一个第三方 DeepSeek Harness 插件,仓库 owner 为 TwistedRiCen,许可证为 MIT。它给模型提供一个 http_probe 工具,用于对部署方拥有的 probe target 执行受控 HTTP GET。

GitHub 仓库:

https://github.com/TwistedRiCen/dsh-http-probe

核心功能

下面介绍它已核实的几个能力:

  • 提供模型可用的 http_probe 工具,执行受控 HTTP GET。
  • 仅 URL path 可由模型控制;host 和 port 来自部署配置。
  • 使用部署拥有的 baseUrl
  • 限制响应体读取;超过字节上限后读取停止,并在结果中返回 truncated: true
  • 协作式超时集成;预算在工具上声明,并由宿主工具调用超时策略执行。
  • 返回结构化 canonical Tool result,字段包括 okstatusurlcontentTypebodytruncated
  • 重定向不自动跟随,使用 redirect: 'manual'

插件配置在加载时验证;未知字段和非正整数限制会导致失败。

安装与启用

安装前需要满足宿主依赖要求。该插件要求宿主提供以下硬 peer 依赖:

@deepseek-ai/cordis@4.0.1
@deepseek-ai/dsh-tools@0.1.0-rc.5

其中,@deepseek-ai/dsh-tools@0.1.0-rc.5 当前未在 npm registry 发布。已核实的安装方式是使用预构建 tarball;Git 源码自包含安装未验证且当前阻塞。不要替换其他版本的 @deepseek-ai/dsh-tools,必须保持精确宿主版本。

Node 要求为:

^22.19.0 || >=24.0.0

先准备本地 tarball,再执行下面命令安装到指定 profile:

dsh plugin --profile <profile> add /path/to/dsh-http-probe-0.1.0.tgz

这条命令把 dsh-http-probe-0.1.0.tgz 作为插件安装到对应 DSH profile。

典型用法

已核实的调用示例是:

Use the http_probe tool to GET /ok.

在这个用法中,模型侧暴露的是 path,而不是完整 URL。host 和 port 由部署配置提供,因此它不是通用任意 URL 抓取器,而是固定目标探针工具。

适用场景与注意

它适合需要把“对固定 probe target 做受限 GET”加入 DSH 工具链的场景。如果你的需求是让模型访问任意外部 URL,它不适合。

安装和启用前要注意:

  1. 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。
  2. 确认宿主提供的 @deepseek-ai/cordis@deepseek-ai/dsh-tools 版本与插件要求一致。
  3. 配置使用部署拥有的 baseUrl,不要依赖模型选择 host 或 port。
  4. 响应体读取存在上限;超过上限后读取停止,并在结果中返回 truncated: true
  5. 重定向不自动跟随,按 redirect: 'manual' 的语义处理结果。

结尾

dsh-http-probe 的价值在于把模型可调用、部署侧可控、读取有界、超时受宿主持有的 HTTP GET 探针接入 DSH 工具调用。当前已核实资料未提供目录页地址,可直接从 GitHub 仓库查看源码和发布物:

https://github.com/TwistedRiCen/dsh-http-probe
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye