DSH plugin 下载失败、下载慢？npm 镜像源与 DeepSeek Harness 安装包获取指南

DSH plugin 或 DeepSeek Harness 下载慢、下载失败，先看是不是 npm 官方源的问题：切到镜像源、配上代理，大多数卡顿能立刻缓解。

概览

下载环节卡住不外乎三类原因：官方源慢、本地网络差、获取渠道单一。 排查顺序按「确认源 → 切镜像/代理 → 换渠道」来：先确认下载走的哪个源，再加速，最后换更省事的渠道。判断方向时先看报错类型：超时、断连类（ETIMEDOUT、ECONNRESET、ECONNREFUSED）多数是网络或源的问题；E404、404 Not Found 多半是包名或版本写错；401/403 则和凭证有关——先分清是哪一类，再决定换源还是换写法，不要对着错误反复盲目重试。DSH 还在开发者预览阶段，版本迭代快，具体命令以官方文档为准（来源）。

DSH plugin 下载慢、下载失败：先确认是不是官方源的问题

npm 官方源访问慢、偶发超时，下载失败多半从这里开始。 先看当前用的是哪个源：

npm config get registry

默认输出 https://registry.npmjs.org/。如果每次 npx @deepseek-ai/dsh web 都卡在 fetch 阶段很久，或报 ETIMEDOUT、ECONNRESET 一类错误，先切镜像源再重试（见下节）。插件安装同理——dsh plugin --profile web add 实际是把参数转发给 profile 目录里的 pnpm（来源），一样受 npm 源速度影响。

确认源之后，用 npm ping 快速测一下到当前源的连通性：能通且延迟低，说明问题多半不在源；超时或报错，则基本可以锁定是源或网络的问题，再决定切镜像还是配代理。另外，Node 版本过旧也可能让 npx 拉包阶段表现成"卡住不动"——顺手 node -v 确认是 18 或更高，避免方向判断错误。更完整的报错分类与排查步骤看《DeepSeek Harness 安装报错排查》。

DSH plugin 下载切镜像源与代理：两套加速方案

切镜像源最快，配代理最彻底，两套可以叠加使用。

方案一：切到 npm 镜像源。 以 npmmirror 为例：

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

执行 npm config get registry 验证，切完重跑 npx 或 dsh plugin 命令即可。用 pnpm 的用户记得同步改 pnpm 的源（pnpm config set registry 指向同一镜像），否则插件安装那一步还是会走慢源。有一点要提前知道：镜像源同步 npm 官方仓库有几分钟到几小时的延迟，刚发布的新包可能短时间在镜像上拉不到，报 E404 时别急着判死——等一会儿，或临时把源切回官方把这一次拉完再切回来。想恢复官方源，把 registry 设回 https://registry.npmjs.org/ 就行。

方案二：配代理。 终端级代理对 npx、git、pnpm 都生效。macOS / Linux 在 shell 里设置 http_proxy、https_proxy 环境变量，Windows PowerShell 用 $env:HTTP_PROXY，配好后再跑一次下载命令看是否恢复。公司或校园网这类需要内网代理才能出网的环境，通常必须走这一步；配完后用 npm ping 验证代理是否生效，比直接重跑下载命令更快。终端级代理是"全局生效"的，如果你只想让某一条命令走代理，也可以在执行那一条命令时临时带上环境变量，跑完即失效，不污染当前会话。

注意：切了镜像源后，dsh plugin --profile web add github:用户名/仓库名 的 git 部分仍然走 git 协议，git 拉不动时单独给 git 配代理：

git config --global http.proxy http://127.0.0.1:<代理端口>

改完用 git config --get http.proxy 确认已生效；不需要时 git config --global --unset http.proxy 撤掉。如果该插件作者同时发布了 npm 包，直接改装 npm 发布的版本，能一次绕开 git 协议与 GitHub 访问两重问题——这是处理 github 源插件拉不动的另一条路，详见《DSH plugin 怎么安装》。

DeepSeek Harness 本体与 DSH plugin 安装包的其他获取渠道

除了命令行拉包，还有两条更省事的渠道。

1. DSH 本体：npx 之外可以源码构建（git clone + pnpm install，来源），源码直接来自 GitHub；如果访问 GitHub 也慢，先给 git 配好代理（见上文）再拉。源码构建适合想跟踪最新开发版、或想自己改代码的用户；日常使用仍推荐 npx 一键运行，省去编译与依赖安装步骤。
2. DSH plugin：插件安装包不必全走命令行。本站的 DSH Plugin Hub 内置「设置 → 插件中心」，插件数据与 dsh-plugin.org 每日同步、收录 4,401 个人工精选插件；在插件中心直接点安装，等于把安装命令、依赖解析一次做完，绕开命令行 npm 拉取的卡顿，安装结果还会写入通知中心便于回查。

装完用 dsh plugin --profile web list 复查插件是否在列，命令行安装和插件中心安装出来的插件都会出现在同一个 profile 里，验证方式一致。

完整的插件安装命令与示例看《DSH plugin 怎么安装》。

注意事项

1. 镜像源切换只影响当前用户级配置，不污染系统全局。
2. 下载失败先看报错：超时类多与网络/代理有关，E404 类多半是包名或版本写错。
3. 装完插件用 dsh --dump-config 确认插件已注册。
4. 下载出问题先读错误信息归类，别反复重试同一命令；归类错误的话，换镜像、配代理都救不了。

来源：dsh CLI README、官方 Quickstart