跳到正文
MyDSH我的 DSH 实战笔记
English
独立维护,非DeepSeek官方;与mydsh.dev等其他MyDSH站点无关联。

首页/起步与安装/安装与启动

node 版本门:0.2.2 起要求 >=24.9.0,这是最常见的装不上

npm install 之后 dsh 起不来,或者一堆 EBADENGINE 警告看不懂。先查这一条,比查网络、代理、权限都快。

已核验版本与环境核验日期2026-11-14
数据来源
registry.npmjs.org逐版本engines字段
核验日期
2026-11-14

可复制指令

npm ls -g @deepseek-ai/dsh --depth=0

把44个版本逐个读一遍engines字段,分水岭非常清楚:

版本engines.node发布时间说明
0.1.2-alpha.5(未声明)2026-09-02源码checkout用的就是这一代,实际要求 ^22.19.0 || >=24.0.0
0.2.1-rc.3 / rc.4 / rc.5(未声明)2026-10-23 ~ 10-29整条线都没有engines,node 22可以装
0.2.2-alpha.2起>=24.9.02026-10-27起突然抬高门槛,一直延续到rc.3
0.2.2-rc.1(latest)>=24.9.02026-11-04npm i默认装到的就是这个
0.2.2-rc.3(next)>=24.9.02026-11-13next通道

所以在node 22上:装 @deepseek-ai/dsh(默认latest)会拿到0.2.2-rc.1,撞engines;装 @0.2.1-rc.5 才不会。

EBADENGINE默认只是警告不是硬失败——npm装完可能不报错,但跑起来会因为用到node 24才有的API而崩。所以看到EBADENGINE别当没事。

怎么办,三条路

  1. 升node:装到24.9.0或更高。这是正路,也是官方口径。
  2. 钉旧版本:npm i -g @deepseek-ai/[email protected]。代价是拿不到0.2.2的改动。
  3. 换node版本管理器:用fnm / nvm建一个24.x环境,只给dsh用,不动系统默认node。多项目并存时这条最省事。

查自己当前版本与装到的版本:

node -v
dsh --version
npm ls -g @deepseek-ai/dsh --depth=0

如果 dsh --version 直接command not found,先看全局bin在不在PATH里:npm root -g 的上一级才是bin目录,别把 node_modules 当成安装位置。

怎么算跑通

照着逐条对,全过才算完成。有一条没过,先解决它再往下。

  • node -v输出24.9.0或更高
  • npm install时没有EBADENGINE警告
  • dsh --version打印出的版本与你想装的一致
  • 能启动到打印URL那一步

会失败在哪

现象 / 原因 / 怎么办,按实际踩到的顺序写。

现象原因怎么办
npm i成功但dsh启动即崩engines只是警告,实际跑到了node 24才有的API按上表确认版本,要么升node,要么钉0.2.1-rc.5
dsh: command not found全局bin目录不在PATHnpm bin -g拿到目录(老版npm)或npm root -g的上一级bin,加进PATH后重开终端
同一台机器上别的项目也是node 22全局升node会连带影响其他项目用fnm/nvm建独立24.x环境,只在那个shell里跑dsh

来源

标「已核验」的,来自本站实跑;标「公开资料整理」的,逐条附出处。