安装失败排查

先看报错信息#

排查的第一步永远是读完整的报错输出，而不是直接重试。报错里通常会指出失败阶段：解析仓库、下载、依赖安装还是构建脚本。带着具体错误信息搜索，比漫无目的地换命令有效得多。

Node 版本过低#

DSH 需要 Node.js 20 LTS 或更高版本，先确认：

node -v

版本不足时的升级方式见安装 DSH 与第一个插件。

网络问题#

GitHub 访问不稳定是国内环境最常见的失败来源。可尝试：

• 配置可用的网络代理后重试
• 换用 GitHub 镜像或加速服务（自行评估安全性）
• 稍后重试——偶发的超时重试一次往往就好

构建脚本被拦截#

安装 GitHub 来源的包时，pnpm 默认不执行其构建脚本，插件可能因此装不完整。需要在 profile 的 pnpm-workspace.yaml 里把该仓库加入 allowBuilds，配置示例见插件配置与版本锁定。

commit-sha 锁定绕过#

如果最新版本本身就装不上（上游刚引入了问题），可以锁定到上一个确认可用的提交：

dsh plugin add github:<owner>/<name>#<commit-sha>

在 GitHub 仓库的提交历史里找到目标提交的完整 sha 即可。

还是不行#

带着完整报错去提 issue，渠道见反馈与社区渠道。