DSH 常见报错与修复实操：装不上、启动崩溃、更新出错对照排查
按「你看到的报错」对照排查 DeepSeek Harness：npm.ps1 被执行策略拦下、npx 首次启动干等、插件冲突触发启动修复弹窗、更新翻车后的版本核对——每一步都配来自真实录屏的截图，命令与官方 Discussions 核对过。
最近更新: 2026-09-30
这页按报错的实际出现方式组织：以现象为纲，不做报错码大全。三段真实录屏驱动全文——一段 Windows 安装撞上经典的 npm.ps1 拦截，一段 macOS 桌面版因两个插件相撞拒绝启动，一段 Windows 更新后翻车。每一节先给你「坏掉的样子」，再演示正在被执行的修复。
范围说明：Windows 沙箱权限类报错（0xC0000142、Win32 5）是另一族问题，在专门的排查手册里承接： 故障排查手册
症状 → 先查什么 → 怎么修
| 你看到的 | 先查 | 解法 |
|---|---|---|
| 装到一半红字刷屏：npm.ps1 cannot be loaded… PSSecurityException | PowerShell 执行策略是不是默认的 Restricted | 放行脚本后验证（步骤 1） |
| npx @deepseek-ai/dsh web 首次运行几分钟没动静 | 是在下载依赖还是真卡死 | 换镜像源 + 详细日志（步骤 2） |
| 一启动就弹「发现导致启动失败的插件」 | 弹窗点名的插件和冲突组件 | 在修复弹窗里卸载肇事插件（步骤 4） |
| 更新之后插件批量不对劲、版本对不上 | dsh --version 实际报出的版本号 | 定版重装再验收（步骤 6） |
对症修复步骤
症状一 · 装不上（安装失败）
- 1
放行 PowerShell 的脚本执行策略
Windows 上第一次装 dsh，最常见的红字是 npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system，后面跟着 PSSecurityException 和 UnauthorizedAccess。这不是 DeepSeek Harness 坏了，是 PowerShell 默认的 Restricted 策略禁止运行任何脚本。用管理员身份打开 PowerShell，执行 set-ExecutionPolicy RemoteSigned 并输入 Y，再用 get-ExecutionPolicy 确认输出 RemoteSigned；node -v 和 npm -v 各返回一个版本号，环境就通了。
$set-ExecutionPolicy RemoteSigned$get-ExecutionPolicy$node -v$npm -v
最典型的拦截现场：npm.ps1 被执行策略拒之门外，记事本教程写明原因和 RemoteSigned 解法。去视频 7:00 处看 - 2
下载卡住：换镜像源、打开详细日志
Node.js 装好后如果 npm install 长时间停在同一行，多半是到 npm 官方源的网络太慢。录屏里的做法是改用 npmmirror 镜像安装：npm install -g --registry=https://registry.npmmirror.com @deepseek-ai/dsh；再用 npx --verbose @deepseek-ai/dsh web 启动，详细日志能看到正在拉哪些包。官方 Discussions 也记录过 Windows 首次运行 8 分钟零反馈的情况（#176）——慢不等于死，别急着关窗口。
$npm install -g --registry=https://registry.npmmirror.com @deepseek-ai/dsh$npx --verbose @deepseek-ai/dsh web
首次启动会先征求同意：在 Ok to proceed? 后输入 y，npx 拉完 dsh 包才会启动网页界面。去视频 11:40 处看 - 3
认准启动成功的信号
输入 npx @deepseek-ai/dsh web 回车。首次运行会先问 Ok to proceed? (y)，输入 y 等它装完 dsh 包。只有终端打印出 dsh web: http://127.0.0.1:3080/…（带 token）并提示 opening the default browser，才算启动成功；浏览器没自动弹，就手动打开这个地址。
$npx @deepseek-ai/dsh web
症状二 · 一启动就崩（插件冲突）
- 4
在启动修复弹窗里认领肇事插件
桌面版弹出「发现导致启动失败的插件」，说明某个插件在注册阶段把 Harness 拦死了——录屏里的原因是「插件注册了重复的服务组件」：session-reference 组件被重复定义，插件之间存在加载冲突，弹窗直接点名 dsh-tui。官方 Discussions 里有同款案例：@deepseek-ai/dsh-session-reference 在 Harness 升级后注册失败，web 直接起不来（#7872）。放心点「卸载此插件并继续检测」——弹窗自己写明：工作区、会话、模型配置和其他插件不会被删除。
插件冲突把启动挡死：修复弹窗点名被重复注册的 session-reference 组件和肇事者 dsh-tui。去视频 0:05 处看 - 5
等重新检测跑完再重启
点击卸载此插件并继续检测后，按钮变成「正在处理并重新检测…」，dsh 会移除冲突插件并重扫启动项。让这次重扫跑完、确认弹窗不再出现，再重启 dsh。之后还想用这个插件，先去插件市场看它有没有适配当前 Harness 版本的新版，再装回去。
修复进行中：点击卸载后按钮进入「正在处理并重新检测」状态，重扫结束冲突才算清掉。去视频 1:45 处看
症状三 · 更新之后不对劲（版本错乱）
- 6
先问版本，再定版重装
更新后插件批量异常，第一件事是 dsh --version 确认真装上的版本。社区多次踩到 npm 的 latest 标签指向旧构建（#7872、#5813），所以录屏和 Discussions 的标准自救一致：定版重装 npm install -g @deepseek-ai/dsh@<version>，精确到补丁号，不要 @latest。升级潮后插件批量失联的报告编号是 #8145，老插件在新 Harness 上报格式错误是 #8432——先卸载不兼容插件，等它发适配版。
$dsh --version$npm install -g @deepseek-ai/dsh@<version>
重装之前先问版本：dsh --version 报出 0.1.5-rc.2，告诉你这次翻车的更新实际留下了哪个构建。去视频 2:00 处看 - 7
回浏览器做最后验收
定版重装完成后重新执行 npx @deepseek-ai/dsh web，等终端给出新的 127.0.0.1:3080 地址并打开：工作台能加载、模型下拉挂上 DeepSeek 模型，这一轮更新故障就算翻篇。下次大版本升级前先备份 dsh 配置，坏版本随时可回退——回退细节见排查手册。
修复完成后的验收画面：工作台渲染出提示框，模型一栏已挂上 DeepSeek-V4.1-Flash。去视频 16:20 处看
常见问题
这三类报错之后，大家问得最多的几件事。
报 npm.ps1 cannot be loaded 是 DeepSeek Harness 坏了吗？
不是。这是 Windows PowerShell 默认的 Restricted 执行策略在拦截所有脚本，Node.js 自带的 npm.ps1 也跑不了。按步骤 1 用管理员 PowerShell 执行一次 set-ExecutionPolicy RemoteSigned 即可继续安装。RemoteSigned 只要求下载来的脚本带签名，是微软文档推荐的开发机配置，装完不用改回去。
npx @deepseek-ai/dsh web 卡住没输出，是死了吗？
大概率还在下载。首次运行要拉完整的 dsh 包和依赖，官方 Discussions 记录过 Windows 首次运行 8 分多钟零进度反馈的案例（#176）。网络不好就按步骤 2 换 npmmirror 镜像并加 --verbose 看进度。真出问题时终端会打出明确的红字，到时再按报错内容处理。
启动修复弹窗卸载插件，会丢我的会话和配置吗？
不会。弹窗写得很清楚：工作区、会话、模型配置和其他插件不会被删除，它只移除点名的肇事插件然后重扫。真正会动数据的是手动清空 dsh 主目录这类操作，没备份别做。
更新后插件全挂了，该等官方修复还是回退版本？
先 dsh --version 确认版本。官方 Discussions 里有升级潮后插件批量失联（#8145）、老插件在新版 Harness 上格式不兼容（#8432）的报告，也出现过 latest 标签指向旧构建的先例（#7872、#5813）——被标签错位波及的机器定版重装立刻恢复。想长期锁版本或整体回退，按排查手册的版本回退小节操作。
这页的报错和 Windows 沙箱权限错误（0xC0000142 / Win32 5）是一回事吗？
不是。0xC0000142、Access is denied、SetNamedSecurityInfoW Win32 5 属于升级后出现的沙箱配置问题，是另一族报错，本页不展开；遇到它们直接去排查手册的 Windows sandbox 部分，那里有逐条对应的处理方案。
相关攻略
按你的报错最终指向，接着读这几篇。
故障排查手册
沙箱权限报错、cordis.patch.yml 冲突、profile 不生效与版本回退的深度手册，本页的报错追到底都会落到这里。
阅读指南DSH Web UI 从启动到手机
dsh web 一条命令启动网页版，吃透 3080 工作台、斜杠技能与模型设置，再用 dsh-web 生态把手机接进来——9 步实测截图
阅读指南dsh-pocket：把 DSH 装进口袋
电脑跑 dsh web，手机扫码即同屏：局域网直连或 Cloudflare 免费隧道，输出实时同步、手机可反向操作——7 张逐帧核对截图。
阅读指南远程与手机访问合集
dsh-web、dsh-pocket、Agents-Anywhere、dsh-mobile——精选远程客户端一次看全。
阅读指南手机远程访问 DSH（ngrok 隧道）
把同一个 3080 网页端通过免费隧道发出去，在外网浏览器里也能指挥家里的 Agent。
阅读指南Windows 安装教程
从 Node.js 到 dsh web 跑通的完整 Windows 安装路径，环境先做对，报错少一半。
阅读指南macOS 安装教程
在 Mac 上从终端配置到首次启动，干净装好 DeepSeek Harness。
阅读指南插件更新指南
什么时候跟 latest、什么时候锁版本的升级节奏，从源头减少步骤 6 的症状。
阅读指南插件卸载指南
干净移除插件并恢复 profile——步骤 4 启动修复弹窗的手动版。
阅读指南视频来源
本页截图裁剪自三位 UP 主的公开教程录屏；画面里每个修复步骤都由 UP 主实际执行，并与官方 Discussions 的对应报告交叉核对。深链直达对应秒数。