在 Linux 上装 DeepSeek Harness：两个坑

背景

想在 Ubuntu 上把 @deepseek-ai/dsh 跑起来，只为了看看它的 Web 界面。按文档 npm i @deepseek-ai/dsh@latest 执行，先后踩了两个坑。

坑一：latest 标签指向旧版本

npm view 的结果很反直觉：

npm view @deepseek-ai/dsh dist-tags --json
# {
#   "latest": "0.2.1-rc.2",
#   "next":   "0.2.1-rc.3"
# }

latest 停在 rc.2，真正的 rc.3 挂在 next 上。所以所有 @deepseek-ai/* 都要显式钉版本，锁文件要提交。

这类"预发布版本没被提升为 latest"的情况在快速迭代的项目里很常见。装之前先 npm view 看一眼 dist-tags，比事后猜省时间。

坑二：镜像源同步不全

用国内镜像（registry.npmmirror.com）装，报了一个很迷惑的错：

npm error code ETARGET
npm error notarget No matching version found for
npm error   @deepseek-ai/dsh-deepseek-llm-api-extensions@0.2.1-rc.3

主包在镜像上有，但它依赖的一个子包没有同步过来。此时 npm error 只报缺的那个子包，很容易误判成"版本号写错了"。

切换官方源后一次成功：

npm i @deepseek-ai/dsh@0.2.1-rc.3 \
  --registry=https://registry.npmjs.org \
  --no-audit --no-fund
# added 616 packages in 4m

记下来的结论

一句话：镜像源不可信，钉版本 + 官方源，这两个动作能省掉一整轮排查。