安装失败排查
先读报错#
排查的第一步是读完整报错，而不是直接重试。报错通常会指出失败阶段：下载、依赖安装还是构建脚本。带着具体错误信息对号入座，比盲目换命令有效得多。
症状一：命令不存在或启动报错#
症状：node 提示 command not found，或启动 DSH 时报兼容性错误。
原因：Node.js 没装，或版本低于 DSH 要求的 20 LTS。
解决：先确认版本：
node -v输出 v20.x 或更高即可；不满足就回到第 1 课，按系统装好 Node.js 20 LTS。
症状二：下载卡住或网络超时#
症状：npx 拉包长时间不动，或报 ETIMEDOUT 之类的网络错误。
原因：npm 默认源与 GitHub 在国内访问不稳定，这是最常见的失败来源。
解决：回到第 2 课换源——临时用 npx --registry=https://registry.npmmirror.com @deepseek-ai/dsh web，或永久 npm config set registry https://registry.npmmirror.com。偶发超时直接重试一次，往往就好。
症状三：插件装了但功能不完整#
症状：GitHub 来源的插件安装过程没报错，装完却跑不起来。
原因：pnpm 默认不执行 GitHub 来源包的构建脚本，插件没构建完整。
解决：回到第 5 课，在 profile 的 pnpm-workspace.yaml 里把该仓库加入 allowBuilds 后重装。
还不在这三类里#
其余情况——版本锁定、冷门报错等——查完整的安装失败排查文档；收录时效等疑问看常见问题速查。
找人帮忙#
自助排查仍解决不了，就带着完整报错求助：插件问题去其 GitHub 仓库提 issue，DSH 本体问题去官方仓库，站点问题在交流群反馈，详见反馈与社区渠道。
系列完结#
恭喜，六课教程到此完结。回教程目录随时复习，接下来推荐：
