安装第一个插件

像装 App 一样给 AI 加能力：读懂安装命令的每一段，实战安装最火的 open-design，绕开 GitHub 安装的构建授权坑。

约 6 分钟读完

读完这篇你会

  • 理解插件是怎么装进 DSH 的（其实就一条命令）
  • 学会看懂并修改安装命令
  • 成功装上第一个插件并让它生效

插件是怎么装进 DSH 的

DSH 的插件本质上是普通的 npm 包，安装走的是 dsh plugin 命令。整体感受和"手机装 App"差不多，只是操作从点按钮变成了敲命令。

一条典型的安装命令长这样：

dsh plugin --profile web add github:nexu-io/open-design

拆开看，每个词都有含义：

片段含义
dshDeepSeek Harness 的命令行入口
plugin插件管理子命令
--profile web装进哪套组合（绝大多数人只有 web 这一套，写它就对了）
add安装
github:nexu-io/open-design从 GitHub 安装 nexu-io/open-design 这个仓库

在哪个终端敲？ 就是启动 dsh 的那个终端也可以，另开一个新的终端窗口也可以，都一样。

去哪里找插件

本站插件目录收录了 4000 多个社区插件，按 Star 数排序、支持搜索，每个插件都有详情页。也可以直接在搜索引擎搜"deepseek harness 插件 + 你想要的功能"。

挑插件的三条经验法则：

  1. 看 Star 数：Star 高通常说明用的人多、踩坑的人也多，问题更容易搜到答案；
  2. 看更新时间：DSH 迭代很快，半年没更新的插件可能跟不上最新版；
  3. 看 README：插件详情页有完整 README，确认功能符合预期再装。

实战：安装 open-design

open-design 是目前整个生态最火的插件（8 万+ Star），装上后可以直接让 AI 帮你做 PPT、海报、网页原型。

第一步，确保 dsh 正在运行（终端窗口开着）。

第二步，另开一个终端，粘贴：

dsh plugin --profile web add github:nexu-io/open-design

第三步，等安装跑完。重启 dsh（在原终端按 Ctrl + C 停止，再执行 dsh web），让插件加载进来。

第四步，回到浏览器刷新页面，对 AI 说一句"帮我做一份介绍 DeepSeek Harness 的 PPT"——它就会调用设计工作区出成品了。

安装命令的各种写法

在本站每个插件的详情页，都会给出可直接复制的安装命令。它们可能长这样：

# 从 GitHub 安装（最常见）
dsh plugin --profile web add github:nexu-io/open-design

# 从 npm 安装（插件发布到了 npm 的话）
dsh plugin --profile web add some-plugin-name

# 从本地文件夹安装（自己在写插件时用）
dsh plugin --profile web add ./my-plugin

规律很简单：add 后面跟"从哪来"。GitHub 来源写 github:作者/仓库，npm 来源直接写包名，本地写路径。

网页右上角的 profile 切换器可以记住你的 profile 名，本站所有安装命令会自动替换——如果你用的不是默认 web，先去点一下。

装不上？多半是这个坑

从 GitHub 安装时，如果终端报错提到 prepare 脚本或 allowBuilds，不用慌，这是 pnpm 的安全机制（DSH 用 pnpm 管理插件，它默认拒绝在安装时执行陌生包的构建脚本）。

两步解决：

  1. 看报错信息里提到的包名（例如 dsh-xxx），打开 ~/.dsh/profiles/web/pnpm-workspace.yaml，加上：
allowBuilds:
  dsh-xxx: true
  1. 重新执行一遍 add 命令。

这相当于你亲自授权"这个包可以在我的电脑上跑构建脚本"。只给你信任的插件开这个授权，不确定的插件先看看它的仓库源码和 Star 数。

更多报错场景（权限、网络、找不到命令等）见常见问题。

装多少个合适

建议从"按需安装"开始：遇到"要是有个 XX 功能就好了"的时刻，再去目录里搜对应的插件。一次装几十个不但拖慢启动，还可能互相冲突——DSH 的乐趣在于像拼乐高一样慢慢组装，而不是一次买空商店。

下一步

装多了就需要管理：怎么升级？怎么卸载？数据怎么清理？

插件的升级与卸载 →

全部教程