DSH 插件目录:DeepSeek Harness 里真正有人在用的插件

最后更新 2026-11-04 · 数据抓取于 2026-08-16

DeepSeek Harness(DSH)是一个 agent 框架,它的插件模型不是「宿主留几个扩展点给你」,而是宿主自己就由插件组成。一个插件是一个在 package.json 里声明了 dsh.bundle 的 npm 包,里面导出 apply(ctx, config);它能注册模型可调用的工具、注册一个由 schema 直接渲染出来的设置页、往界面的插槽里挂组件,也能整个替换掉某项内置能力。正因为没有二等公民,社区在几天内就把它铺满了。

这份目录的价值不在于全 —— 全量镜像既维护不动也帮不到人。它的价值在于有一条你能自己复算的收录规则,以及按「解决什么问题」而不是按名字排列。想接入模型而不是装插件,看 在 DeepSeek Harness 里跑任意模型 —— 那条路不需要写插件。

这个生态有多大,又有多空

全部数字抓于 2026-08-16,来源是 npm 的公开搜索接口(text=keywords:dsh-plugin,分页取满 795 条),每一行都可以自己跑一遍复算。

换句话说:每 14 个挂着这个关键词的包里,大约只有 1 个有人下载过。这不是在批评谁 —— 一个五天大的生态本来就该是这个形状。它只是说明,面对 795 这个数字时,「有没有人用」比「有没有」更值得先看一眼。npm 的下载统计有约一天延迟,所以抓取当天新发布的包会被低估。

收录规则

取 npm 上带 dsh-plugin 关键词的全部 795 个包,筛出「有公开仓库地址」且「周下载量不少于 100」的,命中 45 个;其中一个实际上是给另一个 harness 写的、关键词挂错了,人工剔除,剩 44 个。条目描述由我们依据各包自己的 npm manifest 重写,中英各写各的。我们没有逐个跑过这些插件 —— 这是目录,不是评测,收录不等于推荐。

怎么装一个

1. 1. 选一个 profile插件是按 profile 装的,不是全局。网页界面跑在名为 web 的 profile 里,所以带界面的插件都装到它上面。
2. 2. 安装执行 dsh plugin --profile web add <包名>。这条命令会在 profile 目录里转发给 pnpm,所以 pnpm 的参数都能用,本地路径和 git 地址也行。
3. 3. 让它自己登记只要依赖的 package.json 里声明了 dsh.bundle 字段,就会被自动登记进 profile 的 bundle 列表。不需要手改 profile 的 package.json。
4. 4. 重启并确认重启 DSH。想先看合成后的插件树而不启动,用 dsh --profile web --dump-config —— 这是判断某个插件层到底有没有生效最快的办法。

# install into the profile behind the browser UI
dsh plugin --profile web add dsh-better-edit

# see the composed plugin tree without booting DSH
dsh --profile web --dump-config

装之前该知道的一件事

静态安装的插件在 harness 进程内运行,harness 够得到的它全都够得到:你的文件系统、你的 shell、你配在设置里的 API key。没有沙箱。这不是 DSH 做得不好,而是「插件能力和内置能力完全对等」这个设计的必然代价 —— 换来的是第三方能做的事和官方一样多。会话中现写的动态插件走的是另一条路:审批门控,一次确认只授权当前这版代码,双重确认才授权该插件的后续版本。上面「体检与护栏」那一类读的是打包结构和静态特征,能筛掉一装就废的包,但请不要当成安全背书。

很多插件底下缺的是模型

目录里最大的两类 —— 视觉和接入别家模型 —— 存在的原因是同一个:DeepSeek 系列模型只吃文本,而 DSH 自带的模型来源只有 DeepSeek 自己和一个通用 OpenAI 兼容适配器。所以视觉路由、第二模型审查、记忆抽取、搜索摘要这些插件,几乎都要你另外给一个端点和一把 key。

它们大多接受任意 OpenAI 兼容的 base URL,这意味着一把网关 key 就能同时喂全部,不必给每家厂商单开账号、各充一笔预付款。APIMODELS 就是这样一个网关:一个端点后面挂着 Claude、GPT、Gemini、Grok、DeepSeek 等 60 多个模型,共用一份余额按量结算。

想自己写一个

三个文件就够:一个声明了 dsh.bundle 的 package.json、一个描述你贡献那一层的 cordis.patch.yml、一个导出 name / inject / apply(ctx, config) 的 ES 模块。在 apply 里用 ctx.tools.register 注册模型可调用的工具,用 ctx.settings.register 交出一份 schema 就白得一个设置页(界面由 schema 渲染,所以页面上的选项永远不会和你的代码接受的参数漂移)。一条硬规矩:每项贡献都要交回 disposer,否则停用插件时残留的监听器会慢慢把进程拖坏。

常见问题