安装 dsh 的三个误区:桌面端不等于有 CLI、npx 不等于安装、全局安装也不等于最新
「装完还是没命令」「装完还是旧版本」,这两句话背后其实只有三个概念被混淆:桌面端、npx、全局安装。 逐个拆开,每条都给验证命令。
dsh 安装误区一:桌面端等于有 CLI
你看到的: 安装包双击装完,界面能打开,于是认为终端里也就能用 dsh。
实际发生: 桌面端与命令行是两套分发。桌面端自带运行时与图形壳,方便直接用;但它不会把 dsh 写进系统 PATH。所以终端里提示找不到命令,不是安装失败,而是本来就没有注册。
怎么验证:
- 在终端执行
which dsh,无输出说明确实没有命令行入口; - 打开桌面端,确认界面能正常启动;
- 两者结论不矛盾,说明只是缺 CLI,不是桌面端坏了。
要补什么: 需要终端能力时,单独用 npx 或全局 npm 装一份。桌面端解决「有窗口」,命令行解决「能脚本化」,两个需求各自满足。
dsh 安装误区二:npx 等于安装
你看到的: npx @deepseek-ai/dsh web 跑通了,页面也打开了,于是认为系统里已经装好。
实际发生: npx 是临时解析并执行,执行结束不注册全局命令。它可能命中缓存,也可能重新获取;版本会随解析结果变化。你得到的是「这一次能跑」,不是「这台机器装了什么」。
怎么验证:
- 另开终端执行
dsh --version,如果命令不存在,就证明没有全局入口; - 再执行
npx @deepseek-ai/dsh --version,能打印说明 npx 路径可用; - 两次结果一个失败一个成功,就是典型「只有 npx、没有安装」。
要补什么: 需要稳定命令名、脚本调用或固定版本时,改用全局安装并记录版本号。只是偶尔用一次,npx 足够,不必强求安装。
dsh 安装误区三:全局安装等于最新
你看到的: 教程说装 latest,你也照着装了;过一阵子发现行为和文档对不上,以为是 bug。
实际发生: latest 只决定「新安装时解析到哪个版本」,不会自动更新已经装好的文件,也不会在启动时去注册表检查。你机器上的版本,取决于最后一次安装或升级的时间。
怎么验证:
- 用
dsh --version看实际运行的版本; - 用
npm view @deepseek-ai/dsh version看注册表当前最新版本; - 两个数字不同,就说明本地落后,需要显式升级。
要补什么: 升级是主动动作,不是自动结果。升级前记下旧版本,出问题能回退;不要在没记录的情况下反复重装。
dsh 安装误区对照与三条确认命令
把「你以为」和「实际」并排写,最容易记住。 对照如下:
| 你以为 | 实际 | 一句话验证 |
|---|---|---|
| 装了桌面端就有命令 | 两套分发,PATH 不共享 | which dsh |
| npx 跑通就算装了 | 临时执行,不注册命令 | 另开终端 dsh --version |
| 装 latest 就是最新 | 只影响新装,不自动更新 | 对比两个版本号 |
三行的共同点是:都缺少一次「独立验证」,而验证只需要三条命令。 装完不复测,误解就会一直留着。
不用猜,顺序执行三条命令就能把现状说清:
which -a dsh:列出所有命中的可执行文件,出现多条说明有多份并存;dsh --version:看实际执行的那一份是什么版本;npm ls -g --depth=0 @deepseek-ai/dsh:看全局目录里装了哪些版本。
对照结果判断:
| 结果 | 结论 |
|---|---|
which 无输出 | 没有命令行入口,只有 npx 或桌面端 |
which 多条、版本不一 | 多份并存,需要清理 PATH 或卸载旧份 |
| 全局有、版本落后 | 需要显式升级 |
| 全都没有 | 完全没装命令行版本 |
先看现状再动手,能避免在错误的方向上重装。 很多人反复重装,其实只是 PATH 指向了另一份。
dsh 安装另两个小坑与何时该重装
除了三个大误区,还有两个高频细节值得单独点出。 一是包名写法,二是数据位置。
- 包名写法:规范包名是
@deepseek-ai/dsh,命令写成npx @deepseek-ai/dsh web。网上常见的npx deepseek-ai/dsh web是照着 GitHub 路径口述的习惯,遇到解析失败时以规范包名为准。 - 数据位置:会话与配置不在安装目录里,而在
DSH_HOME(默认~/.dsh)。重装或换安装方式不会自动迁移,也不会因为卸载命令就消失。
这两点都不影响「装没装上」,但会影响「装上之后找不到东西」。 出问题时先把它们排除掉,再判断是否该重装。
重装解决的是文件损坏,不解决概念混淆。 只有下面情况才考虑:
which -a dsh指向的路径存在但执行报错;- 全局包目录里的文件明显不完整;
- 升级过程被中断,版本号与实际行为严重不符。
如果三条命令显示「没装」「装错地方」「版本落后」,那不是重装能解决的,而是选择路径与清理 PATH 的问题。
dsh 安装下一步
先把三个概念分开,再决定装哪一种。 想看四种安装方式的对比,读 DeepSeek Harness 四条安装路;想看最小组合怎么选,读 dsh 最小安装;想比较 npx 与全局,读 npx 与全局安装的区别;想看升级不生效怎么处理,读 dsh 更新不生效。
来源:DeepSeek Harness 官方文档、dsh CLI README、deepseek-harness Releases
常见问题
装了 dsh 桌面端仍找不到命令,是因为桌面端和命令行是两套分发,互不替代。桌面端自带运行时,但不会把 dsh 注册进系统 PATH,所以终端里找不到是正常的。要在终端用命令,需要另外用 npx 或全局 npm 安装。
用 npx 跑通一次并不等于已经在本机装好了 dsh。npx 是临时解析并执行包,用完不注册全局命令,下次运行仍可能重新下载或换版本;它只证明这条命令当前可用,不证明系统里装了什么。
latest 是 npm 给 dsh 标的最新标签,不是你机器上已安装的版本。全局已装旧版时,dsh 走的是 PATH 里那个旧文件,不会因为注册表有新版就自动更新。
用 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 文档
来源
- DeepSeek Harness 官方文档· deepseek-harness
- dsh CLI README· deepseek-ai
- deepseek-harness Releases· deepseek-ai