dsh插件市场

教程 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。

上次核对: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-plugin topic,别人在 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 有官方插件商店吗?

官方 README 没有提供中心商店。插件通过 npm/Git 分发,发现靠 GitHub dsh-plugin 话题、社区目录和插件市场类插件。

GitHub 上加了 dsh-plugin 话题就安全吗?

不。话题只是发现标记,没有审核。安装前仍要看仓库维护状态、README、权限和源码。

index.json 和单个插件是什么关系?

index.json 是给 Discover 页面用的批量索引,列出插件和版本;单个插件仍然通过它自己的 npm 包、Git 仓库或 release 地址安装。

接着看

教程目录