前言¶
在 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,字段包括
ok、status、url、contentType、body、truncated。 - 重定向不自动跟随,使用
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,它不适合。
安装和启用前要注意:
- 插件以当前
dsh进程权限运行,安装前应检查源码与许可证。 - 确认宿主提供的
@deepseek-ai/cordis与@deepseek-ai/dsh-tools版本与插件要求一致。 - 配置使用部署拥有的
baseUrl,不要依赖模型选择 host 或 port。 - 响应体读取存在上限;超过上限后读取停止,并在结果中返回
truncated: true。 - 重定向不自动跟随,按
redirect: 'manual'的语义处理结果。
结尾¶
dsh-http-probe 的价值在于把模型可调用、部署侧可控、读取有界、超时受宿主持有的 HTTP GET 探针接入 DSH 工具调用。当前已核实资料未提供目录页地址,可直接从 GitHub 仓库查看源码和发布物:
https://github.com/TwistedRiCen/dsh-http-probe