DeepSeek Harness 插件安装教程,一条 dsh plugin 命令给 AI 助手装上超能力

上篇安装教程发出去之后,留言里问得最多的一个问题就是,Harness 跑起来了,然后呢?官方那句「一切皆插件」听着很酷,可真到自己动手,插件怎么装、装完怎么用、去哪找靠谱的,网上的说法五花八门。这篇把插件安装的完整链路捋一遍,从装第一个插件到卸载,一次说清楚。

装之前先准备两样东西

第一样是 Node.js,要求 ^22.19.0 或 24.0.0 以上,这个装 Harness 的时候应该已经有了。第二样容易被忽略,是 pnpm。dsh 的插件命令看起来是自己的,实际上是把操作转发给 pnpm 去执行,所以没有 pnpm 的话,装插件会直接报错。一条命令装好它。

npm install -g pnpm

装完用 pnpm –version 确认一下版本。另外建议把 dsh 全局安装,或者至少记住 npx 的写法,后面每条插件命令都要用到。

核心命令就一条

插件安装的核心命令长这样。

dsh plugin --profile web add 

拆开看,–profile 指定装到哪个环境。web 就是网页版,headless 是命令行跑一次性任务的那种,也可以自己建一个 profile 当试验田,后面安全部分会说为什么推荐这么做。add 后面跟插件来源,来源有三种,对应三种不同场景。

第一种,npm 包,最省事

如果插件作者把包发布到了 npm,直接写包名就行。

dsh plugin --profile web add @dsh-external/dsh-vision-toolkit

这种安装方式最干净,npm 上的包是作者提前编译好的产物,装的时候不用现场编译,风险最低。社区里稍微成熟一点的插件都会走这条路。

第二种,GitHub 仓库,社区主力

现在社区几百个插件,大部分只放在 GitHub 上,没发布到 npm。这种就用 github: 前缀指定仓库。

dsh plugin --profile web add github:owner/repo

有个细节值得注意,GitHub 来源的插件装的时候可能触发 prepare 编译脚本,pnpm 会弹提示让你授权,需要把打印出来的 key 加进 pnpm-workspace.yaml 的 allowBuilds 里再重跑一次。另外开发预览版迭代很快,今天能装的写法过几天可能就变了,稳妥的做法是锁 commit。

dsh plugin --profile web add github:owner/repo#commit哈希

锁了 commit 之后,仓库后续怎么改都不会影响你正在用的版本。

第三种,本地目录或压缩包,开发自测用

自己写插件,或者想先试试还没发布的版本,用本地路径。

dsh plugin --profile web add /绝对路径/到/插件目录
dsh plugin --profile web add ./插件名-0.0.2.tgz

本地目录直接给绝对路径,用 pnpm pack 打出来的 tarball 文件也可以。适合在正式装进主力环境之前先验一遍。

装完怎么确认装上了

装完别急着用,先验证插件是不是真的进了配置。

dsh --profile web --dump-config | grep 插件名

–dump-config 会把当前 profile 实际生效的插件树完整打印出来,能看到对应条目就说明装好了。排查问题的时候这个命令特别好用,插件明明装了页面却没出现,先看这棵树,比对着界面瞎猜快得多。也可以直接敲 dsh plugins list 看已装清单。

启用之前必须重启

这一步最容易踩坑。装完插件,浏览器里刷新页面,发现啥都没有,以为没装上。其实插件的宿主代码和浏览器端代码都是在 dsh web 启动那一刻加载的,只刷新页面不够,必须把 dsh web 整个重启。重启之后到设置里的插件列表确认状态是已启用,很多插件还自带 Skill,在会话里敲斜杠命令就能激活,比如 /vision-tools。

更新和卸载

dsh plugin --profile web update
dsh plugin --profile web remove 

update 不带参数会把 profile 里所有插件更新一遍,remove 按包名卸载。插件之间冲突把 dsh 搞崩了起不来,用 remove 把出问题的那个删掉就能救回来。

还有一种装法,Skill

dsh 的 Skill 契约跟 Anthropic 的 SKILL.md 是同一套格式,所以装技能的方式简单到离谱。把技能目录整个丢进 ~/.agents/skills,重启 dsh,命令面板里就出现了。你在 Claude Code 里写过的技能,可以原封不动搬过来用。

安全这件事多说两句

插件跑在宿主进程里,属于可信代码,能碰你的文件、网络、浏览器、终端,权限比想象中大得多。安装命令只有一行,不代表可以跳过检查。装之前至少看三样东西,README 里写的功能描述,仓库里的安装脚本,还有最近的提交记录。GitHub 来源的插件优先锁 commit,用单独的 profile 试装,别一上来就装进主力工作区。现在是 developer preview 阶段,官方明确说过后面会有破坏性更新,锁版本是保命习惯。

去哪找插件

官方社区聚合入口是 GitHub 的 dsh-plugin topic,仓库打上这个标签就会被自动收录。第三方目录站像 dshplugin.dev 和 deepseek-harness-plugin.com 也整理了分类列表,按 UI 增强、主题、自动化这些类别翻起来比较方便。

几个值得试的插件

想给插件做个体检,装 dsh-plugin-check,它覆盖 manifest、patch、编译产物等 33 项检查,下载社区插件之后先让它扫一遍。想要 IDE 体验,DSH-better-sidebar 给网页版加上右侧栏和底部面板,文件管理、终端、Git diff 全塞进一个页面。想在手机微信里遥控 dsh,dsh-chatnode-wechat 把 Harness 接进微信,任务审批直接在手机上回 yes 或 no。还有纯娱乐的 whale-girl,往界面右下角塞一只桌面宠物,Agent 思考它跟着思考,任务完成它会庆祝,挂机久了还会睡觉。

装好第一个插件之后,再去试试 –dump-config,看看那棵插件树长什么样。社区里几百个插件,总有一个能解决你手头的问题。要是中途卡住,把报错原样丢给 dsh 里的 Agent,让它自己查自己的问题,十有八九比对着搜索引擎快。