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 明确给出了 安装命令的写法样例:
npx @deepseek-ai/dsh plugin --profile web add @memtensor/memos-cloud-dsh-plugin@latest(MemTensor/MemOS)dsh plugin --profile web add /绝对路径/dsh-our-free-model(本地路径安装)
本地路径安装时必须是绝对路径,相对路径在部分版本上会静默失败。
装完必须重启
dsh --profile web
插件是启动时加载的。不重启会话,装了什么都不会生效。
装了但还是没反应?按这个顺序查
- profile 对不对 —— 见上面第二步,最高频原因
- 包名/路径对不对 —— 去 README 核对,不要用记忆里的名字
- node_modules 脏了 —— 删掉 profile 下的
node_modules和 lock 文件重装 - 版本不匹配 —— 插件针对的 DSH 版本比你装的旧
九种原因的完整排查顺序在这篇。
去哪找插件
本站收录了 714 个 GitHub 上的 DSH 插件,其中 356 个的描述是中文写的。 按分类浏览看分类页,不知道装哪个看 每类的精选清单。
关于"插件市场"这类站点:它们大多不托管代码,只是索引 GitHub 仓库。 你真正要审的是仓库本身。
安全提醒
插件是跑在你机器上的代码,权限和你一样。装之前至少看一眼它读了哪些目录、发起了哪些网络请求。 见Is DSH safe。