ChatGPTClaudeGrok / X / CursorGemini

安装 dsh 的三个误区:桌面端不等于有 CLI、npx 不等于安装、全局安装也不等于最新

安装与快速上手发布于 2026-11-02作者: DeepSeek Plugin 插件市场
安装dshdsh 安装安装误区npx版本管理
按教程装完却发现命令还是没有、版本还是旧的,多半是三个概念被混在了一起。本文逐个拆开误区,并给出三条能立刻验证的命令。

「装完还是没命令」「装完还是旧版本」,这两句话背后其实只有三个概念被混淆:桌面端、npx、全局安装。 逐个拆开,每条都给验证命令。

dsh 安装误区一:桌面端等于有 CLI

你看到的: 安装包双击装完,界面能打开,于是认为终端里也就能用 dsh。

实际发生: 桌面端与命令行是两套分发。桌面端自带运行时与图形壳,方便直接用;但它不会把 dsh 写进系统 PATH。所以终端里提示找不到命令,不是安装失败,而是本来就没有注册。

怎么验证:

  1. 在终端执行 which dsh,无输出说明确实没有命令行入口;
  2. 打开桌面端,确认界面能正常启动;
  3. 两者结论不矛盾,说明只是缺 CLI,不是桌面端坏了。

要补什么: 需要终端能力时,单独用 npx 或全局 npm 装一份。桌面端解决「有窗口」,命令行解决「能脚本化」,两个需求各自满足。

dsh 安装误区二:npx 等于安装

你看到的: npx @deepseek-ai/dsh web 跑通了,页面也打开了,于是认为系统里已经装好。

实际发生: npx 是临时解析并执行,执行结束不注册全局命令。它可能命中缓存,也可能重新获取;版本会随解析结果变化。你得到的是「这一次能跑」,不是「这台机器装了什么」。

怎么验证:

  1. 另开终端执行 dsh --version,如果命令不存在,就证明没有全局入口;
  2. 再执行 npx @deepseek-ai/dsh --version,能打印说明 npx 路径可用;
  3. 两次结果一个失败一个成功,就是典型「只有 npx、没有安装」。

要补什么: 需要稳定命令名、脚本调用或固定版本时,改用全局安装并记录版本号。只是偶尔用一次,npx 足够,不必强求安装。

dsh 安装误区三:全局安装等于最新

你看到的: 教程说装 latest,你也照着装了;过一阵子发现行为和文档对不上,以为是 bug。

实际发生: latest 只决定「新安装时解析到哪个版本」,不会自动更新已经装好的文件,也不会在启动时去注册表检查。你机器上的版本,取决于最后一次安装或升级的时间。

怎么验证:

  1. 用 dsh --version 看实际运行的版本;
  2. 用 npm view @deepseek-ai/dsh version 看注册表当前最新版本;
  3. 两个数字不同,就说明本地落后,需要显式升级。

要补什么: 升级是主动动作,不是自动结果。升级前记下旧版本,出问题能回退;不要在没记录的情况下反复重装。

dsh 安装误区对照与三条确认命令

把「你以为」和「实际」并排写,最容易记住。 对照如下:

你以为实际一句话验证
装了桌面端就有命令两套分发,PATH 不共享which dsh
npx 跑通就算装了临时执行,不注册命令另开终端 dsh --version
装 latest 就是最新只影响新装,不自动更新对比两个版本号

三行的共同点是:都缺少一次「独立验证」,而验证只需要三条命令。 装完不复测,误解就会一直留着。

不用猜,顺序执行三条命令就能把现状说清:

  1. which -a dsh:列出所有命中的可执行文件,出现多条说明有多份并存;
  2. dsh --version:看实际执行的那一份是什么版本;
  3. npm ls -g --depth=0 @deepseek-ai/dsh:看全局目录里装了哪些版本。

对照结果判断:

结果结论
which 无输出没有命令行入口,只有 npx 或桌面端
which 多条、版本不一多份并存,需要清理 PATH 或卸载旧份
全局有、版本落后需要显式升级
全都没有完全没装命令行版本

先看现状再动手,能避免在错误的方向上重装。 很多人反复重装,其实只是 PATH 指向了另一份。

dsh 安装另两个小坑与何时该重装

除了三个大误区,还有两个高频细节值得单独点出。 一是包名写法,二是数据位置。

  1. 包名写法:规范包名是 @deepseek-ai/dsh,命令写成 npx @deepseek-ai/dsh web。网上常见的 npx deepseek-ai/dsh web 是照着 GitHub 路径口述的习惯,遇到解析失败时以规范包名为准。
  2. 数据位置:会话与配置不在安装目录里,而在 DSH_HOME(默认 ~/.dsh)。重装或换安装方式不会自动迁移,也不会因为卸载命令就消失。

这两点都不影响「装没装上」,但会影响「装上之后找不到东西」。 出问题时先把它们排除掉,再判断是否该重装。

重装解决的是文件损坏,不解决概念混淆。 只有下面情况才考虑:

  1. which -a dsh 指向的路径存在但执行报错;
  2. 全局包目录里的文件明显不完整;
  3. 升级过程被中断,版本号与实际行为严重不符。

如果三条命令显示「没装」「装错地方」「版本落后」,那不是重装能解决的,而是选择路径与清理 PATH 的问题。

dsh 安装下一步

先把三个概念分开,再决定装哪一种。 想看四种安装方式的对比,读 DeepSeek Harness 四条安装路;想看最小组合怎么选,读 dsh 最小安装;想比较 npx 与全局,读 npx 与全局安装的区别;想看升级不生效怎么处理,读 dsh 更新不生效。

来源:DeepSeek Harness 官方文档、dsh CLI README、deepseek-harness Releases

ChatGPTClaudeGrok / X / CursorGemini

常见问题

装了 DeepSeek Harness 桌面端,为什么终端里 dsh 命令还是没有?

装了 dsh 桌面端仍找不到命令,是因为桌面端和命令行是两套分发,互不替代。桌面端自带运行时,但不会把 dsh 注册进系统 PATH,所以终端里找不到是正常的。要在终端用命令,需要另外用 npx 或全局 npm 安装。

用 npx 跑通过一次,是不是就等于已经在本机装好了 dsh?

用 npx 跑通一次并不等于已经在本机装好了 dsh。npx 是临时解析并执行包,用完不注册全局命令,下次运行仍可能重新下载或换版本;它只证明这条命令当前可用,不证明系统里装了什么。

npm 提示装的是 latest,为什么 dsh --version 还是旧版本?

latest 是 npm 给 dsh 标的最新标签,不是你机器上已安装的版本。全局已装旧版时,dsh 走的是 PATH 里那个旧文件,不会因为注册表有新版就自动更新。

怎么一次性确认自己装了几个 dsh、分别在哪、各是什么版本?

用 which -a dsh 看所有命中路径,用 dsh --version 看实际执行的那个版本,再用 npm ls -g @deepseek-ai/dsh 看全局安装了哪些。三条命令对照,就能看出是否存在多份并存。

相关术语

桌面端
桌面端是通过系统安装包分发的图形界面版本,自带运行时,但不向系统 PATH 注册命令行入口。— deepseek-harness Releases
npx
npx 是 npm 附带的临时执行器,按包名解析后执行,不把命令注册到全局,除非缓存命中否则每次都可能重新获取。— npm 文档
PATH
PATH 是 shell 查找可执行文件的目录列表,只有落在这些目录里的命令才能被直接调用。— dsh CLI README
latest 标签
latest 标签是 npm 注册表上标记的默认版本,它只影响新安装时解析到哪个版本,不会改动已经装好的文件。— npm 文档

来源