用 npx 运行 DeepSeek Harness:命令行安装

核验于 2026-10-31dsh 0.2.1-rc.5版本说明

前置:Node 与网络

node -v
npm -v

本页的实测环境是 Windows 11 + Node 24.18.0 + npm 11.16.0。dsh 对 Node 的最低要求以官方 README 为准,不要只照抄上面这组版本号。

npx 需要联网访问 npm registry(npm 的官方包仓库,命令从那里下载安装包)。在公司网络或代理环境下,你先确认能访问 registry,再运行命令。

一行命令启动

npx @deepseek-ai/dsh@latest web

第一次运行时,npx 要先把依赖下载到本机,可能花几分钟;依赖有了缓存,之后的启动就快很多。2026-10-31 的实测里,缓存命中后约 14 秒打印出访问地址;全新的 DSH_HOME 首次启动约 20 秒。

启动日志里会出现类似这一行:

dsh web: http://127.0.0.1:3080/?token=<redacted>

运行命令后,浏览器会自动打开带 token 的地址。不想让浏览器自动打开,就在命令后面加 --no-open:

npx @deepseek-ai/dsh@latest web --no-open

latest 与 next 的区别

npm 给同一个包准备了好几个发布通道——latest、next、alpha 这类标签,每个标签指向一个具体版本。2026-10-31 核验到的值是:

发布通道标签标签指向的版本
latest0.2.1-rc.5
next0.2.1-rc.5
alpha0.2.2-alpha.2

npx @deepseek-ai/dsh@latest web 装到的是 latest 指向的版本。本页核验时 next 与 latest 指向同一个版本,但两个标签并不保证一直相同;想明确选择通道,就在命令里写出 @next 或 @alpha:

npx @deepseek-ai/dsh@next web

latest、next、alpha 三个标签指向的版本不会自动同步,GitHub 上的最新 tag 也可能与 npm 上的版本不同。两边的对应关系见 版本对照。

确认服务起来了

dsh 服务默认监听 127.0.0.1:3080。下面这条检查命令的输出容易让人误判:

curl -I http://127.0.0.1:3080/

返回 401 Unauthorized 是正常的:请求的地址里没有启动时生成的 token,服务就会拒绝这次请求。

带 token 的地址会返回 303,服务端随后下发一个 dsh-auth-* cookie,并把请求跳转回 /;浏览器带着 dsh-auth-* cookie 再次请求,才拿到 200。实测结果:

请求结果
不带 token 直接访问 /401
带 token 访问启动日志里的地址303 → 下发 cookie
跟随跳转并携带 cookie200
已有 cookie 再访问 /200

用 curl 重复上面这套请求时要带上 cookie 文件(-c 负责写入、-b 负责读出),否则每一次请求都不带 cookie,会一直看到 401:

curl -L -c cookies.txt -b cookies.txt "http://127.0.0.1:3080/?token=..."

停止与升级

  • dsh 在终端前台运行时,按 Ctrl+C 结束进程。
  • 如果 dsh 进程已经脱离终端(关掉终端窗口之后仍在运行),先用 netstat 找到监听 3080 端口的进程号,再用 taskkill 按进程号结束:
netstat -ano | grep 3080
taskkill /PID <pid> /F
  • 升级就是重新运行一次 npx @deepseek-ai/dsh@latest web。npx 可能使用本机缓存里的旧版本,想强制用上指定版本,就在命令里写明确版本号。

常见失败

报错或现象原因处理
EADDRINUSE: address already in use 127.0.0.1:3080上一个 dsh 进程还在找到占用 3080 的 PID 并结束,或换端口重启
一直 401打开的是裸地址,没带 token用启动日志里带 ?token= 的完整地址
ETIMEDOUT / ECONNRESETregistry 或代理不可达检查网络与 npm registry 配置
command not found: nodeNode 未安装或不在 PATH先装 Node,再重开终端
启动很慢第一次下载依赖等待完成;后续走缓存

端口占用这一条是实测中真实遇到的:上一次启动留下的子进程没有随终端一起退出,3080 端口仍被占着,第二次启动直接报 EADDRINUSE。先结束占用 3080 端口的进程,再重新运行命令。