前言¶
在 DeepSeek Harness（DSH）中管理多個供應商模型時，確認特定模型的連通性、延遲和輸入能力有時是困難的。現有的日誌可能不夠直接，或者很難提取具體的診斷信息。dsh-provider-probe 插件旨在解決這個問題，通過提供一個手動、低成本的機制來測試供應商路由和適配器配置。
插件介紹¶
這是一個名爲 dsh-provider-probe 的社區插件，由 Wanbinyu 維護，採用 MIT 許可證。它不與 DeepSeek 官方有隸屬或背書關係。
插件通過 DSH 已註冊的適配器發送一個極小的真實模型請求，僅展示首個 token 延遲、總耗時、結束原因、token 用量或脫敏錯誤。它不創建會話、不寫入 session log、不保存或展示模型回覆。
核心功能¶
- 路由與目錄查看：自動列出當前活動的供應商路由和適配器模型目錄。
- 輸入能力展示：顯示活動模型路由聲明的文本、圖片或未知輸入能力。
- 手動檢測：支持手動輸入未出現在目錄中的模型 ID。
- 按需觸發：只在用戶點擊“開始檢測”後發送請求，不做後臺輪詢。
- 參數限制：默認限制爲 8 個輸出 token，20 秒強制超時。
- 結果統計：展示首個 token 延遲、總耗時、結束原因和實際 token 用量。
- 錯誤處理：保留錯誤碼、HTTP 狀態和 Request ID，並嘗試移除密鑰、令牌與用戶目錄。
- 錯誤分類與建議：根據明確的狀態碼和錯誤特徵區分憑據、權限、模型/地址、限流/額度、超時、網絡、流兼容與供應商 5xx，並顯示下一步建議。
- 報告導出：一鍵複製適合粘貼到 Issue/Discussion 的脫敏診斷報告。
- 併發控制：同一時間只允許一個檢測，可隨時取消，避免重複計費和限流。
安裝與配置¶
安裝前請確認環境滿足要求：Node.js >= 22.19 和 DeepSeek Harness 0.1.0-rc.6 或更高版本。
安裝插件：
dsh plugin --profile web add https://github.com/Wanbinyu/dsh-provider-probe/releases/download/v0.3.6/dsh-provider-probe-0.3.6.tgz
安裝或更新後重啓 DSH Web：
dsh web
插件支持通過 YAML 配置調整參數：
- insert:
- id: provider-probe
name: dsh-provider-probe
config:
timeoutMs: 20000
maxTokens: 8
maxMessageLength: 1200
配置項說明：
* timeoutMs：單次檢測強制超時，默認 20000 毫秒，範圍 1000-120000。
* maxTokens：單次檢測最大輸出 token，默認 8，範圍 1-32。
* maxMessageLength：脫敏錯誤的最大字符數，默認 1200，範圍 256-8000。
使用方法¶
- 打開 DSH Web 的“設置 -> 供應商檢測”。
- 在列表中選擇供應商和模型，或手動輸入模型 ID。
- 點擊“開始檢測”。
- 查看結果面板，獲取首個 token 延遲、總耗時、錯誤分類及診斷報告。
費用與隱私¶
檢測請求會經過 DSH 的正常適配器和用戶已經保存的供應商配置，因此可能產生少量模型費用。插件不會讀取或返回 API Key；憑據仍由適配器按正常路徑解析。模型輸出會被丟棄，只保留時延、用量和終止狀態。
輸入能力來自 DSH 當前模型路由的聲明，不會額外發送圖片進行驗證，因此不增加附件、網絡請求或費用。複製的診斷報告只使用頁面已經顯示的路由、能力、時延、用量和脫敏錯誤；發佈前仍應人工檢查。
錯誤脫敏屬於縱深防禦，無法保證覆蓋每個供應商自定義的敏感格式。公開錯誤信息前仍應人工檢查。
適用場景¶
此插件適合在以下場景使用：排查供應商連通性問題、驗證特定模型 ID 是否可用、測試網絡延遲、分析錯誤碼以及準備技術討論所需的診斷報告。
總結¶
dsh-provider-probe 提供了一個輕量級、手動觸發的方式來驗證 DeepSeek Harness 的供應商配置和模型狀態。通過清晰的錯誤分類和脫敏報告功能，它能夠有效輔助開發者定位問題。
