dsh 插件市场打不开、插件列表加载不出来？DSH Plugin Hub 网络、代理与证书排查

dsh 插件市场打不开先别重装 DSH——它有三种完全不同的故障，用错方法会白折腾。 判据很简单：入口没有、列表空白、还是弹报错。本文按这三种分别给判定与处置步骤。

概览：先分清 DSH Plugin Hub 是哪一种「打不开」

「打不开」在 DSH Plugin Hub 里要拆成三层看：入口层（设置里有没有插件市场）、数据层（列表有没有拉到）、链接层（报错指向网络、源还是凭证）。 官方故障排查把下载类问题按超时/断连、404、401/403 分成三组处理，市场打不开也适用同一套分法（来源）。

症状决定排查方向，先对号入座再动手。对照下表，找到你遇到的那一行：

入口缺失：DSH Plugin Hub 没装或没生效

设置页找不到插件市场入口，几乎都是 DSH Plugin Hub 没装上或没生效（来源）。

1. 重装 Hub：

dsh plugin --profile web add dsh-plugin

预期：安装成功、终端无报错；若报错，先看是网络还是源的问题（见后文 404 一节）； 2. 重启 dsh web，预期：服务重新加载插件； 3. 刷新页面打开设置 → 插件市场，预期：看到插件卡片列表，说明入口已生效。

dsh 插件市场列表空白：目录数据没拉到

dsh 插件市场能进但一个插件都没有，说明界面在、数据没来——问题在网络链路，而不是 DSH插件本身（来源）。

1. 确认本机网络能出网，预期：浏览器能打开常访问的网站；公司或校园网这类必须走代理才能出网的环境，这一步通常会暴露问题；
2. 配好终端级代理，预期：macOS / Linux 在 shell 里设置 http_proxy、https_proxy；Windows PowerShell 用 $env:HTTP_PROXY；对 npx、git、pnpm 都生效；
3. 重启 dsh web 让它重新拉取目录，预期：列表出现插件卡片。

dsh 报错分类：超时、404 与 401/403 各查什么

dsh 的报错文本本身就能定位方向：超时/断连看网络，404 看源与包名，401/403 看凭证与来源校验（来源）。

1. ETIMEDOUT、ECONNRESET、ECONNREFUSED 一类，预期：属于网络或源的问题，按上一节的代理与镜像处置；
2. E404、404 Not Found，预期：多半是包名或版本写错；如果是装插件时报 ERR_PNPM_FETCH_404，那是镜像源同步滞后，用官方源验证：

dsh plugin --profile web add <包名> --registry=https://registry.npmjs.org

写成环境变量形式也行：npm_config_registry=https://registry.npmjs.org dsh plugin add <包名>； 3. 401，预期：与凭证有关，检查提供方密钥或相关授权配置； 4. 403，预期：属于 Host / Origin 校验失败——来源不被信任（DNS rebinding 与跨站请求防御），不是账号被限制，也不是插件市场专属错误。

国内网络想减少超时，可切换镜像源：

npm config set registry https://registry.npmmirror.com

预期：之后拉包走镜像，速度更稳；但要注意镜像同步有延迟，出现 404 时按第 2 条换回官方源验证（来源）。

Windows 特例：dsh 沙箱破坏 Schannel 导致 HTTPS 全失败

Windows 上若 HTTPS 请求整体失败、日志报 SEC_E_NO_CREDENTIALS，要查的不是网络而是沙箱与系统 TLS 栈（来源）。 该错误表示 Windows 沙箱或隔离环境拿不到 TLS 凭证，破坏了 Schannel（系统 HTTPS 栈），于是所有 HTTPS 连接都建不起来。

1. 先把运行预设改回完整访问预设，预期：重启 dsh 后 HTTPS 请求恢复正常；
2. 或改用 node / python 运行环境，预期：绕过沙箱的凭据限制；
3. 若系统提示缺少证书，按指引安装 / 导入对应 TLS 凭证，预期：凭证补齐后重试 HTTPS 成功；
4. 复核：重新打开插件市场，预期：列表能拉到、可正常安装。

在 DSH Plugin Hub 设置里配好镜像与代理，并导出系统日志

与其在终端反复调环境变量，不如在 DSH Plugin Hub 的设置页把镜像源与代理一次配好；还定位不到时，再导出它自己记录的日志轨迹取证（来源）。 设置页左侧有更新设置、安全信任、系统诊断、系统日志、恢复默认五个分组：

配好镜像与代理

「更新设置」提供启动时检查更新开关、npm 镜像源下拉选择与代理地址输入框；配完代理与镜像后重启 dsh web 再打开市场，比在多个终端窗口里改环境变量更省事：

1. 打开设置 → 插件市场 → 设置，预期：看到「更新设置」分组的三项配置；
2. 选一个可用的 npm 镜像源、填上代理地址，保存，预期：配置写入并立即生效；
3. 重启 dsh web 并刷新市场页，预期：列表加载正常、安装不再超时。

上面都试过还不行：导出系统日志

还定位不到时，直接看 Hub 自己记录的日志轨迹最快。 系统日志页记录安装、卸载、设置变更与诊断等操作，可按分类与级别查看，也能导出：

1. 进设置 → 插件市场 → 系统日志，预期：看到按时间、级别、类别排列的日志条目；
2. 复现一次「打不开」，预期：日志里出现对应时间的失败记录；
3. 用「导出日志」或「复制全文」取走，预期：拿到可直接用于比对或提问的完整错误上下文。

来源：dshplugin/dsh-plugin-hub、DeepSeek Harness 官方文档 - Quickstart、dsh CLI README、npm config 文档