教程 03 · 插件发现
dsh 插件是怎么被发现的:dsh.bundle 与 dsh plugin add
dsh 插件是怎么被发现和安装的:包在 package.json 声明 dsh.bundle,发布到 npm 或 Git,社区用 GitHub dsh-plugin 话题聚合;命令行用 dsh plugin --profile web ad。命令可在官方仓库核对,数据更新于 2026-11-20。
症状 / 是什么
你听说某个 dsh 插件,但不确定它是不是「真的插件」,也不知道该用哪条命令装。官方仓库里找不到一个「插件市场」入口。
为什么会这样
dsh 的插件机制是分布式的:插件是一个普通的 npm 包或 Git 仓库,只要在自己的 package.json 里声明 dsh.bundle,就能被插件管理器识别。发布权在作者手里,发现靠社区约定,没有一个中心审核机构。
一个包怎么才算 dsh 插件
看它的 package.json 有没有 dsh 字段,并且里面有 bundle。常见的形态是:
{
"dsh": {
"bundle": {
"patch": "./cordis.patch.yml"
}
}
}
patch 指向这个包的补丁层文件。宿主加载插件时,会把这些 patch 层按顺序组合起来。没有 dsh.bundle 的普通 npm 包,不会被当成插件。
别人怎么发现它
- npm:直接搜包名;本站目录里的
install字段就是 npm 包名或 release 地址。 - GitHub 话题:作者给仓库加
dsh-plugintopic,别人在 GitHub 的话题页能翻到。官方 README 也建议插件作者加这个 topic。 - 社区目录:awesome-dsh-plugin 这类人工整理的列表,以及本站这种按用途重新分类的目录。
- 插件市场类插件:例如 dsh-market,把目录搬进 dsh 的设置页。
话题和目录都只是发现渠道,不代表审核、背书或安全。
命令行怎么装
官方 CLI 帮助里的用法是:
dsh plugin --profile <name> add <package>
Web UI 用 web profile:
dsh plugin --profile web add <包名>
dsh plugin 会把参数转给该 profile 目录里的 pnpm,所以 add、remove、why 都能用。<包名> 可以是 npm 包名,也可以是 Git 仓库地址或 release tarball 地址。装完通常要重启宿主或刷新页面。
索引文件是什么
dsh 的 Discover 页面可以添加「索引源」,读取一个 format-1 的 index.json。社区维护的 dsh-plugin-catalog 就是这个格式:它把大量插件、版本、描述和安装地址预先整理成一个 JSON,宿主拉一次就能展示,不需要一个个请求 npm。索引解决的是「一次看到很多」,不改变单个插件的安装方式。
常见坑
- 把 topic 当审核。 任何人都能加
dsh-plugin,加了不等于安全。 - 装错 profile。 桌面端和 CLI 的 profile 不同,装进
web不一定出现在桌面端。 - 用裸包名装 Git-only 插件。 有些插件只发 GitHub release,按 README 的 tarball 地址装。
- 不重启。 装完没生效,先重启宿主。
相关
相关插件
- dsh-market 怎么安装使用:在图形界面里浏览和安装插件。
- dsh-mnemon 怎么安装使用:一个声明了 dsh.bundle 的持久记忆插件实例。
常见问题
dsh 有官方插件商店吗?
官方 README 没有提供中心商店。插件通过 npm/Git 分发,发现靠 GitHub dsh-plugin 话题、社区目录和插件市场类插件。
GitHub 上加了 dsh-plugin 话题就安全吗?
不。话题只是发现标记,没有审核。安装前仍要看仓库维护状态、README、权限和源码。
index.json 和单个插件是什么关系?
index.json 是给 Discover 页面用的批量索引,列出插件和版本;单个插件仍然通过它自己的 npm 包、Git 仓库或 release 地址安装。