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