首页/指南/插件安装

DSH 插件怎么安装?三步走完,附常见报错

这里不解释概念,只写操作。命令来自各插件的官方 README,不是我们编的。

DeepSeek Harness(简称 DSH)的插件不是 npm 全局包,也不是配置文件里加一行就完事。 它是挂在某个 profile 上的包,装错 profile 是绝大多数"装了没用"的原因。

第一步:确认 dsh 命令能用

dsh --version

如果提示找不到命令,先把 DSH 本体装好 —— 参考安装 DeepSeek Harness。 命令不存在的时候,任何插件命令都会失败,而且报错信息通常不会告诉你根因。

第二步:确认你要装到哪个 profile

dsh profile list

插件是装在 profile 里的。你平时用 dsh --profile web 启动,就必须把它装到 web 这个 profile 里;装到 default 里,你启动 web 的时候当然看不到它。 这一条能解释掉一半的"装了没反应"。

第三步:安装

dsh plugin --profile web add <包名或路径>

包名要去插件的 README 里看,不要凭感觉猜。以下是本站收录的项目里,README 明确给出了 安装命令的写法样例:

本地路径安装时必须是绝对路径,相对路径在部分版本上会静默失败。

装完必须重启

dsh --profile web

插件是启动时加载的。不重启会话,装了什么都不会生效。

装了但还是没反应?按这个顺序查

  1. profile 对不对 —— 见上面第二步,最高频原因
  2. 包名/路径对不对 —— 去 README 核对,不要用记忆里的名字
  3. node_modules 脏了 —— 删掉 profile 下的 node_modules 和 lock 文件重装
  4. 版本不匹配 —— 插件针对的 DSH 版本比你装的旧

九种原因的完整排查顺序在这篇。

去哪找插件

本站收录了 714 个 GitHub 上的 DSH 插件,其中 356 个的描述是中文写的。 按分类浏览看分类页,不知道装哪个看 每类的精选清单。

关于"插件市场"这类站点:它们大多不托管代码,只是索引 GitHub 仓库。 你真正要审的是仓库本身。

安全提醒

插件是跑在你机器上的代码,权限和你一样。装之前至少看一眼它读了哪些目录、发起了哪些网络请求。 见Is DSH safe。