npm 全局安装后 dsh web 启动失败：node-pty 原生模块 pty.node 缺失

[Ninomoriaty]

Linux 上 npm 全局安装 dsh 后，dsh web 直接报错退出，原因是 node-pty 的原生模块 pty.node 不存在。

复现步骤：

1. Ubuntu 24.04，npm install -g @deepseek-ai/dsh（0.1.0-rc.5，npm 11.17.0），安装显示成功、无报错
2. 运行 dsh web
3. 启动即崩溃，报 Failed to load native module: pty.node
   实际结果：
   Error: dsh: plugin tree failed to load: failed to apply loader entry include (cordis:include):
   failed to import loader entry subprocess (@deepseek-ai/dsh-subprocess-local):
   Failed to load native module: pty.node, checked: build/Release, build/Debug, prebuilds/linux-x64:
   Error: Cannot find module './prebuilds/linux-x64//pty.node'

根因分析：

• dsh 依赖树中的 node-pty 为 1.1.0（2021 年发布）。其 npm 包内只打包了 darwin/win32 的预编译二进制，linux-x64 的预编译需安装时下载，而 Node 24（ABI 137）没有对应预编译产物，prebuilds/linux-x64/ 目录最终不存在。
• node-pty 的 install script 是 node scripts/prebuild.js || node-gyp rebuild，理论上会回退到源码编译，但编译在安装期间静默失败（机器上 g++ 13.3.0 / make / node-gyp 13.0.1 齐全，头文件缓存就绪后手动 npx node-gyp rebuild 一次成功，说明工具链本身可用，失败点在安装链路）。
• npm 对依赖的 install script 失败只警告不中断，导致安装"成功"但产物缺失，直到运行期才暴露。

预期结果：

• 干净环境下 npm i -g @deepseek-ai/dsh && dsh web 直接可用；或安装时显式失败/警告，提示需要编译工具链或 pty.node 构建失败，而不是静默产出不可运行的安装。
  环境：
• OS：Ubuntu 24.04（glibc 2.39，linux-x64）
• Node：v24.19.0（经 conda-forge 安装于 anaconda 环境）
• npm：11.17.0（node-gyp 13.0.1）
• dsh：0.1.0-rc.5
• 工具链：g++ 13.3.0、make 4.3

验收条件：

• 在无预编译依赖、工具链齐全的 Linux 干净环境执行全局安装，dsh web 能启动；或安装阶段即明确报错，不再静默成功。
• 补充：手动进入 /node_modules/node-pty 执行 npx node-gyp rebuild 后 pty.node 生成Linux 上 npm 全局安装 dsh 后，dsh web 直接报错退出，原因是 node-pty 的原生模块 pty.node 不存在。

复现、预期与验收

• 复现步骤：

1. Ubuntu 24.04，npm install -g @deepseek-ai/dsh（0.1.0-rc.5，npm 11.17.0），安装显示成功、无报错
2. 运行 dsh web
3. 启动即崩溃，报 Failed to load native module: pty.node
   实际结果：
   Error: dsh: plugin tree failed to load: failed to apply loader entry include (cordis:include):
   failed to import loader entry subprocess (@deepseek-ai/dsh-subprocess-local):
   Failed to load native module: pty.node, checked: build/Release, build/Debug, prebuilds/linux-x64:
   Error: Cannot find module './prebuilds/linux-x64//pty.node'

根因分析：

• dsh 依赖树中的 node-pty 为 1.1.0（2021 年发布）。其 npm 包内只打包了 darwin/win32 的预编译二进制，linux-x64 的预编译需安装时下载，而 Node 24（ABI 137）没有对应预编译产物，prebuilds/linux-x64/ 目录最终不存在。
• node-pty 的 install script 是 node scripts/prebuild.js || node-gyp rebuild，理论上会回退到源码编译，但编译在安装期间静默失败（机器上 g++ 13.3.0 / make / node-gyp 13.0.1 齐全，头文件缓存就绪后手动 npx node-gyp rebuild 一次成功，说明工具链本身可用，失败点在安装链路）。
• npm 对依赖的 install script 失败只警告不中断，导致安装"成功"但产物缺失，直到运行期才暴露。

预期结果：

• 干净环境下 npm i -g @deepseek-ai/dsh && dsh web 直接可用；或安装时显式失败/警告，提示需要编译工具链或 pty.node 构建失败，而不是静默产出不可运行的安装。
  环境：
• OS：Ubuntu 24.04（glibc 2.39，linux-x64）
• Node：v24.19.0（经 conda-forge 安装于 anaconda 环境）
• npm：11.17.0（node-gyp 13.0.1）
• dsh：0.1.0-rc.5
• 工具链：g++ 13.3.0、make 4.3

验收条件：

• 在无预编译依赖、工具链齐全的 Linux 干净环境执行全局安装，dsh web 能启动；或安装阶段即明确报错，不再静默成功。
• 补充：手动进入 /node_modules/node-pty 执行 npx node-gyp rebuild 后 pty.node 生成、dsh web 正常，可作为修复路径参考。
  、dsh web 正常，可作为修复路径参考。