前言¶
在 DeepSeek Harness (DSH) 的開發流程中，智能體經常需要直接與外部 API 交互。在沒有直接網絡訪問的情況下，調試這些 HTTP 請求、查看響應頭、對比歷史記錄或執行 curl 命令變得非常繁瑣。dsh-http-tools 爲 DSH 智能體提供了一個完整的 REST 客戶端，使其能夠在對話中發送任意請求、解析 curl 命令並管理會話內的歷史記錄。
它是什麼¶
dsh-http-tools 是一個 HTTP/API 調試工具集，由 lussey820 維護，採用 MIT 許可證。它爲 DSH 插件體系增加了網絡請求能力，解決智能體無法直接調用外部接口的問題。
核心功能¶
該插件提供了三個核心工具以及配套的日誌與 UI 支持。
-
http_request
全功能的 REST 客戶端。支持 GET/POST/PUT/PATCH/DELETE/HEAD 等方法。你可以自定義請求頭、Body 和認證信息。返回結果包含狀態碼、耗時、大小、響應頭、截斷的 Body 以及一個去除了敏感信息的等效curl命令。 -
curl_parse
解析 curl 命令的工具。可以將 curl 命令解析爲結構化參數，或者直接執行它（通過設置execute: true）。 -
request_history
管理會話內請求的工具。可以查詢當前會話中的所有請求，查看單條請求的詳情，或者對比兩條請求的響應差異。 -
Pagination-aware
分頁感知。插件會自動提取響應頭中的Link字段，暴露rel='next'和rel='last'信息，方便智能體進行分頁導航而無需手動解析原始 Header。 -
Preview-slimmed logging
日誌瘦身。會話日誌在持久化時會保留 6000 字符的 Body 預覽，確保隨着請求量的增加，日誌依然保持可讀性。 -
DeepSeek-branded UI cards
(通過可選的 UI 包) 提供 DeepSeek 品牌化的 UI 卡片展示。包含魚形 logo、方法徽章、狀態指示點（帶動畫）、以及可摺疊的 JSON Body。
安裝與啓用¶
安裝過程不需要額外配置，但需要確保運行環境滿足依賴要求。
- 確保系統已安裝 Node.js，版本需大於等於 22（插件依賴原生
fetch）。 - 執行以下命令安裝插件：
dsh plugin --profile web add dsh-http-tools
- 若希望在 Web 界面獲得 DeepSeek 品牌的 UI 卡片展示，可同時安裝 UI 伴侶包：
dsh plugin --profile web add dsh-http-tools-ui
典型用法¶
以下是基於工具功能的典型操作示例。
- 調用 API 檢查狀態
指令示例：
用 http_request 調 https://api.github.com/repos/deepseek-ai/deepseek-harness 看看 star 數
- 發送 POST 請求
指令示例：
POST https://httpbin.org/post，body 傳 {"hello":"world"}，看看返回什麼
- 解析並重發 curl 命令
指令示例：
粘貼這個 curl 命令解析一下，然後改個 header 再重發：
curl -X POST https://api.example.com/v1/users -H "Content-Type: application/json" -d '{"name":"ada"}'
- 對比歷史請求
指令示例：
用 request_history 對比兩次請求的響應差異
注意事項¶
- 零配置運行：插件開箱即用，默認允許所有 URL 的訪問。
- 安全與審計：默認情況下，每個請求都會被標記
X-DSH-Request審計頭，以便服務器識別代理流量。敏感憑證（如 Bearer Token、Cookie）會在生成的curl命令和日誌中被屏蔽。 - 運行環境：插件在 DSH 進程的當前權限下運行，安裝前請檢查源碼與許可證。
