用 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 核验到的值是:
| 发布通道标签 | 标签指向的版本 |
|---|---|
| latest | 0.2.1-rc.5 |
| next | 0.2.1-rc.5 |
| alpha | 0.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 |
| 跟随跳转并携带 cookie | 200 |
已有 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 / ECONNRESET | registry 或代理不可达 | 检查网络与 npm registry 配置 |
command not found: node | Node 未安装或不在 PATH | 先装 Node,再重开终端 |
| 启动很慢 | 第一次下载依赖 | 等待完成;后续走缓存 |
端口占用这一条是实测中真实遇到的:上一次启动留下的子进程没有随终端一起退出,3080 端口仍被占着,第二次启动直接报 EADDRINUSE。先结束占用 3080 端口的进程,再重新运行命令。