前言¶
在 DeepSeek Harness（DSH）裏接模型 Provider 時，「連不上」往往分散在宿主環境、插件是否裝上、註冊是否生效、憑據是否可用、目錄能否讀到等多個環節。單靠日誌或反覆改配置，很難一次看清斷點在哪，也容易把未執行的檢查誤判爲已通過。
DSH Provider Doctor（dsh-provider-doctor）是維護者 tangyixiao 發佈的只讀診斷插件，歸類爲 admin-security。它在一份報告裏彙總宿主、插件、註冊、憑據與目錄等證據，幫你定位模型連接不可用的原因，而不代爲改配置或登錄。
這是什麼¶
dsh-provider-doctor 面向「模型 Provider 在 DSH 中不可用」這一類問題：沿宿主 → 安裝 → 註冊 → 憑據 → 目錄逐環取證，輸出只讀診斷報告。源碼與發行見 GitHub 倉庫，社區目錄頁爲 skillhub.cn/plugins/tangyixiao/dsh-provider-doctor。
插件明確只做診斷：不修復配置、不代爲登錄，也不發送會消耗額度的模型請求。報告中出現 not checked 表示該項未執行，不能當作通過。
當前 package 版本爲 0.1.7（以倉庫內 package.json 爲準），許可證爲 MIT；通過 npm 與 GitHub Releases 分發。
核心功能¶
下面介紹 README 中已說明、且與實現定位一致的能力。
逐環取證¶
診斷按多個檢查項逐項給出結果，並標明依據來源，便於對照「是環境、註冊還是憑據」哪一環出問題。
按需連接檢查¶
默認運行的是基礎檢查，不會爲此啓動額外子進程。只有你在界面中顯式選擇「連接檢查」時，纔會運行 Provider 側的診斷命令。
脫敏分享¶
報告支持按白名單字段導出，便於把現象發給他人排查，而不帶上賬號與令牌等敏感信息。
目錄讀取的副作用¶
若檢查路徑涉及通過 ZCode 讀取目錄，可能啓動 app-server。使用前若在意進程側影響，可先只做基礎檢查。
安裝與啓用¶
安裝方式分 Desktop 與命令行兩類，命令須與官方 README 一致。
Desktop： 從 GitHub Releases 下載 .tgz，在 DSH 的「擴展 → 插件管理 → 添加插件」中安裝。
命令行（Web profile）： 適用於你明確使用 Web profile 的場景：
dsh plugin --profile web add dsh-provider-doctor@0.1.7
環境要求¶
| 項目 | 當前依據 |
|---|---|
| 插件版本 | 0.1.7 |
| DSH | 0.2.2-rc.1（見 package.json 的 engines.dsh） |
| Node.js | ^22.19.0 \|\| >=24.0.0 |
升級 DSH 或 Node 後若插件報錯，應先覈對上述版本約束是否與本地一致。
典型用法¶
- 安裝並啓用插件後，在左側打開 Provider Doctor。
- 先運行基礎檢查，查看宿主、插件安裝、註冊、憑據與目錄等各環證據。
- 僅在需要驗證真實連通性時，再顯式勾選或選擇連接檢查；避免不必要的 Provider 診斷命令與子進程。
更細的選項、配置與故障排查見倉庫內 docs/guide.zh-CN.md。
適用場景與注意¶
適合誰： 已在 DSH 中配置模型 Provider，但狀態異常或連不通，希望用只讀報告縮小排查範圍、再自行改配置或查文檔的開發者與運維。
權限與安全： 插件在當前 DSH 進程權限下讀取環境與配置證據。安裝前應瀏覽源碼與 LICENSE，並確認分類 admin-security 與你的策略一致。社區目錄站點與 DeepSeek / 幻方無官方從屬關係，不等同於官方應用商店。
侷限： 不能替代官方登錄流程或自動修復；連接檢查可能觸發 Provider 或 app-server 行爲，與「零副作用瀏覽配置」不是同一回事。
結尾¶
DSH Provider Doctor 把模型連接問題拆成可覈對的檢查鏈，默認偏保守（基礎檢查、脫敏分享），需要時再加深連接檢查。目錄入口：skillhub.cn/plugins/tangyixiao/dsh-provider-doctor；源碼與發行：github.com/tangyixiao/dsh-provider-doctor。
