前言¶
在 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
