前言¶
在使用 DeepSeek Harness 或開發智能體時，經常需要切換服務商或接入中轉站。拿到一個陌生的 API 地址和 Key，往往不知道它到底能不能用、網絡是否通暢、響應速度如何。簡單的 curl 或日誌檢查難以定位是網絡問題、Key 權限問題還是模型本身的問題。
插件介紹¶
lfy-bot/dsh-api-probe 是一個專爲 DeepSeek Harness 打造的插件，在配置前驗證 API Key 和模型可用性。它提供保姆級的中文報錯診斷，幫助用戶在接入前確認服務狀態。
核心功能¶
該插件主要包含以下能力：
- 驗證 API Key 和模型可用性：確認 Key 是否有效，模型是否可調用。
- 網絡診斷：檢測 DNS 解析、TCP 端口連通以及 TLS 握手情況。
- 測速：測量首字延遲、輸出速度和成功率。
- 37 個服務商預設：覆蓋 OpenAI 兼容、Anthropic 原生和 Gemini 原生等多種接口類型。
- 動態獲取模型列表：不硬編碼模型名，而是從接口自身的
/models獲取。 - 本地運行，Key 不寫盤：請求在本地執行，Key 僅在本次請求中使用，不會寫入磁盤或發送給第三方。
安裝與啓用¶
安裝前請確保 DeepSeek Harness 版本 >= 0.2.0-rc.2。
- 將
dsh-api-probe代碼放置在本地絕對路徑下。 - 在終端執行安裝命令：
dsh plugin --profile desktop add link:"/絕對路徑/dsh-api-probe"
- 安裝完成後，完全關閉並重新打開 DeepSeek Harness，左側欄會出現「API 體檢」選項。
典型用法¶
- 在 Harness 左側欄點擊「API 體檢」。
- 填寫服務商地址和 API Key，點擊開始檢測。
- 如需走代理，展開「高級設置」，在「代理地址」填入
http://127.0.0.1:7890。 - 測速結束後，查看首字延遲、輸出速度和成功率三個指標。
適用場景與注意¶
適用場景：
* 接入新的 API 服務商或中轉站前的健康檢查。
* 排查網絡不通、連接超時或 Key 無效等問題。
* 對比不同服務商的響應速度和穩定性。
注意事項：
* 安全：插件運行在本地，Key 不會被寫入文件，僅用於本次測試。
* 診斷文案：診斷報告使用中文，界面其餘部分爲中英雙語。
* 流式限制：不支持 SSE 中途斷流後的續傳，也不支持流式中途改參數。
* HTTP 版本：當前走 HTTP/1.1，不支持 HTTP/2，對測速結果無影響。
* 預設可靠性：預設裏的 base URL 是起點，廠商可能會隨時更換域名，建議結合 check_providers.mjs 定期覈驗。
結尾¶
dsh-api-probe 提供了從網絡層到應用層的全鏈路診斷能力，讓 API 接入更加透明可控。通過它，可以快速識別服務商的可用性與性能指標，避免因盲目配置導致的故障。
項目地址：https://github.com/LFY-bot/dsh-api-probe
