npx 无法安装 | npm 也无法安装

[321Fontsize]

当前版本

$ node -v
v22.23.2
$ npm -v
10.9.8

运行 npx @deepseek-ai/dsh web后最后一句输出为npm warn deprecated node-domexception@1.0.0: Use your platform's native DOMException instead，然后直接退出，无成功迹象。

运行npm install -g @deepseek-ai/dsh，报错，部分报错信息如下：

npm error code 1
npm error path ~/.npm-global/lib/node_modules/@deepseek-ai/dsh/node_modules/node-pty
npm error command failed
npm error command sh -c node scripts/prebuild.js || node-gyp rebuild
npm error > Checking prebuilds...
npm error > Rebuilding because directory ~/.npm-global/lib/node_modules/@deepseek-ai/dsh/node_modules/node-pty/prebuilds/linux-x64 does not exist
....................................

[shinjiyu]

官方入口就是 Node + npx @deepseek-ai/dsh web。npx/npm 挂了时，很多人卡在第一扇门。

easy-dsh 只做进门，不是 Electron 壳：没有 dsh 就装，密钥贴一次，选文件夹后打开 Web UI。Windows 可以先装 Node LTS，再双击仓库里的 启动.cmd。

npx github:shinjiyu/easy-dsh

或先 npx github:shinjiyu/easy-dsh doctor 看缺哪一步。介绍：#1738

[denial123789]

这里最后显示的 node-domexception 是 deprecated warning，不是导致退出的错误。真正失败点是后面的 node-pty native addon：

prebuilds/linux-x64 does not exist
node-gyp rebuild

我刚核对了 npm registry：当前 latest 和 next 都仍是 0.1.0-rc.6。这个版本已有同类报告：discussion #1686——发布包包含 Windows prebuild，但 Linux x64 路径缺失，因此安装会回退到本机 node-gyp rebuild。

先确认环境：

uname -a
node -p "process.platform + ' ' + process.arch"
npm view @deepseek-ai/dsh version
python3 --version
make --version
g++ --version

在 Ubuntu/Debian 上，如果只是缺本机构建工具，可以安装：

sudo apt-get update
sudo apt-get install -y python3 make g++

然后清理这次不完整安装并保留完整日志重试：

npm install -g @deepseek-ai/dsh --foreground-scripts --loglevel verbose

如果仍失败，请贴出 node-gyp rebuild 之后出现的第一条 compiler error，而不是最后几十行汇总；它能区分：

• 仅缺 Python / make / C++ compiler；
• node-pty 与当前 Node ABI 不兼容；
• npm 包本身缺 Linux 产物且源码 fallback 也无法构建。

npx 的“警告后退出”很可能是临时安装阶段发生了同一个构建失败，只是当前输出没有把完整 npm debug log 展示出来。可以用下面的方式确认退出码并保留日志：

npx --yes @deepseek-ai/dsh web
echo "exit=$?"
ls -lt ~/.npm/_logs | head

短期最稳妥的官方修复仍然是重新发布 rc 包并包含 linux-x64 的 pty.node prebuild；本地装编译工具只是 fallback，不应替代发布物修复。

Handbook 的 startup troubleshooting guide 也整理了“进程 / profile / plugin load”三层证据收集顺序，可用于继续缩小范围。