有界 HTTP 探测TwistedRiCen/dsh-http-probe

dsh-http-probe

第三方 DeepSeek Harness 插件包，提供面向模型的 http_probe 工具：针对部署方拥有的探测目标执行受控的 HTTP GET 请求。

功能特性

- 受控探测：只有 URL 路径由模型控制；主机和端口来自部署配置。
- 部署方拥有的 baseUrl。
- 有界响应体读取：超过字节上限后读取停止，规范结果携带 truncated: true。
- 协作式超时集成：预算在工具上声明，并由宿主工具调用超时策略强制执行。
- 结构化规范工具结果（ok、status、url、contentType、body、truncated），面向模型的文本由 output.render 单独生成。
- 不自动跟随重定向（redirect: 'manual'）。

安装

预构建的 GitHub Release tarball（当前已验证的分发路径）：

1. 从 Releases 页面下载 dsh-http-probe-0.1.0.tgz。
2. 使用以下命令安装：

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

该包声明了 dsh.bundle，因此 dsh plugin add 会自动将其注册为 profile bundle 层。使用以下命令移除：

dsh plugin --profile  remove dsh-http-probe

配置

| 字段 | 类型 | 默认值 | 含义 |
|---|---|---|---|
| baseUrl | string | http://127.0.0.1:3199 | 探测目标基础 URL（http/https，规范化时带尾部 /）。 |
| maxBodyBytes | number | 8192 | 从网络读取的最大响应体字节数；超过后读取停止，规范结果携带 truncated: true。 |
| timeoutMs | number | 2000 | 协作式工具调用超时预算，由宿主的 @deepseek-ai/dsh-tool-call-timeout-policy 强制执行。 |

配置在插件加载时进行校验（无 schema 依赖）：未知字段和非正整数限制会显式报错。

工具

- 名称：http_probe
- 参数：仅 path —— 必须以单个 / 开头；不得包含 .. 段、查询、片段或控制字符。

示例：Use the http_probe tool to GET /ok.

安全

- 模型无法选择完整 URL：仅暴露 path。
- baseUrl 属于部署配置。
- 不自动跟随重定向。
- 这是固定目标探测，而非通用的任意 URL 抓取器。

兼容性 / 开发者预览

- 要求宿主提供 @deepseek-ai/cordis@4.0.1 和 @deepseek-ai/dsh-tools@0.1.0-rc.5（硬性 peer 依赖）。
- @deepseek-ai/dsh-tools@0.1.0-rc.5 目前未发布在 npm registry 上，因此：
- 预构建 tarball 安装已验证并受支持。
- Git 源码自包含安装未经验证，目前被阻止。
- 不要替换为其他 @deepseek-ai/dsh-tools 版本；保持与宿主版本完全一致。

开发

- 公开的 tsconfig.json 不包含机器特定路径，由 pnpm build 使用。
- 虽然 @deepseek-ai/dsh-tools@0.1.0-rc.5 的类型无法从注册表获取，但本地开发使用一个被 gitignore 的 tsconfig.local.json，它继承 ./tsconfig.json，并通过 paths 映射指向本地的 rc.5 声明构建；运行 pnpm build:local 即可使用它。
- tsconfig.local.json 永远不会打包进 tarball，也永远不会进入 Git。