dsh插件市场

教程 05 · 排错

dsh 命令找不到怎么办:command not found 排查

dsh 提示 command not found 怎么办:先分清你是用 npx 还是源码方式,再查 PATH、Node 版本和 profile。官方 README 只教 npx 与源码两种运行方式,按对应路线排查,不要混用命令。文中命令均可在官方仓库核对,数据更新于 2026-11-20。

上次核对:2026-11-20

症状 / 是什么

你在终端输入 dsh,系统说找不到这个命令;或者你照着某个教程输入了 dsh web,但官方 README 里的示例是 npx @deepseek-ai/dsh web。

为什么会这样

dsh 这个词在不同的安装方式里含义不同:

  • npx 方式:npx @deepseek-ai/dsh web 会临时解析并执行 npm 包,不保证在系统里留下一个叫 dsh 的全局命令。
  • 源码方式:官方 README 用 pnpm dsh web 启动,命令由仓库里的脚本提供,同样不是系统全局的 dsh。
  • 其他方式:如果你从别处装过全局命令,才会在 PATH 里出现 dsh。

所以「找不到 dsh」很可能不是装坏了,而是你用了不带全局命令的安装方式。

步骤

1. 先回到官方命令

如果你是照官方 README 装的,直接用完整命令:

npx @deepseek-ai/dsh web

不要把它简写成 dsh web。npx 每次会检查包,第一次会下载,之后走缓存。

2. 源码方式用 pnpm 脚本

在仓库目录里:

pnpm dsh web

不是 dsh web,也不是 pnpm dsh 后随便加参数;按 README 的写法来。

3. 如果你确实装过全局命令

先确认它真的装上了:查全局包列表,看有没有对应的包;再确认全局 bin 目录在 PATH 里。macOS/Linux 和 Windows 的全局目录不同,用 npm prefix -g 看实际位置,把它加进 PATH。

4. 确认 Node 版本和实际使用的 Node

跑 node -v,对照 npm 包声明的 engines。如果你用 nvm、fnm 这类版本管理器,可能装在一个版本里、当前用的是另一个;切换后重新装一次。

5. 新开一个终端窗口

改完 PATH 或重装后,旧窗口里的 PATH 还是旧的。这是最常见的「明明改了还是不行」。

常见坑

  • 把 npx 命令拆开。 npx @deepseek-ai/dsh web 是一个整体,不要只记后半段。
  • 在错误的目录找 pnpm 脚本。 源码方式要先 cd deepseek-harness,再 pnpm dsh web。
  • 版本管理器切来切去。 装和运行不在同一个 Node 版本里,命令会时有时无。
  • PATH 里有多个同名命令。 用 which dsh(Windows 用 where dsh)看实际命中的是哪一个。

相关

相关插件

按用途找插件看分类总览;终端界面类见界面与主题,插件管理见市场与趣味。

常见问题

为什么官方 README 不教全局安装 dsh?

官方 README 给的是 npx 和源码两种运行方式,没有把全局命令作为推荐路径。按官方方式用时,`dsh` 不是必须存在的命令。

npx 每次启动都很慢怎么办?

npx 会检查并缓存包;慢通常发生在首次下载或网络不稳定时。可以改用源码方式,或按你所用插件的 README 选择固定安装方式。

Windows 上提示不是内部或外部命令,和 macOS 一样排查吗?

思路一样:先确认你用的是不是完整命令,再查 PATH、Node 版本和实际命中的可执行文件。Windows 用 `where`,macOS/Linux 用 `which`。

接着看

教程目录