前言¶

DSH 的理念是「一切皆插件」。对 DSH 智能体开发者来说，Web 端插件越来越多之后，光看插件名称或模块名，往往不容易快速判断某个插件是内置能力、第三方能力，还是只负责某块 UI/运行时能力。

dsh-web-plugin-explain 针对这个问题做了一件具体的事：增强 Web 设置里的「插件列表」标签页，让每个插件卡片展开后显示插件包自身 package.json 的 description，并对第三方插件打标签、支持按描述搜索。

这是什么¶

dsh-web-plugin-explain 是 2710165659 维护的 DSH Web 端插件，许可证为 MIT，包版本为 0.1.0。

它增强的是 DSH Web 中的设置页面：

设置 → 插件 → 「插件列表」

打开某个插件卡片后，可以看到该插件包 package.json 里的 description 原文；如果解析不到描述，则显示 —。插件已发布到 npm，普通安装不需要克隆仓库或本地构建。

核心功能¶

下面介绍它已核实的能力。

统一描述来源¶

内置插件与第三方插件使用同一套展示规则：展开卡片时，显示插件包自身 package.json 的 description 原文。

解析不到 description 时，描述行显示：

—

第三方标签¶

模块名不以 @deepseek-ai/ 或 cordis: 开头的插件，会在名字后面显示「第三方」小标签。

@deepseek-ai/* 与 cordis:* 这类内置行即使字典未覆盖，也不会被误标为第三方。

按描述搜索¶

搜索框会匹配：

• id
• 模块名
• 描述

对于带「第三方」标签的行，还会匹配「第三方」标签文本。

容错展示¶

描述解析失败时，例如 Remote 不可用，只影响描述行；插件列表本身仍然正常渲染。

包声明信息¶

package.json 中的名称为：

"name": "dsh-web-plugin-explain"

dsh.client.platform 声明为：

"web"

dsh.client.inject 声明了多个 @deepseek-ai/dsh-client-* 包。dependencies 中包含：

"zod": "^4.4.3"

peerDependencies 中包含：

"@deepseek-ai/cordis": "4.0.1"

资料说明 zod 与 @deepseek-ai/dsh-client-* 等依赖由 pnpm 自动安装。

安装与启用¶

npm 安装¶

插件已发布到 npm，安装命令如下：

dsh plugin --profile web add dsh-web-plugin-explain

安装完成后重启 dsh web。

重启 dsh web 时，typert-loader 会在启动时注册本插件的 strict 端点。

dsh plugin add 会自动识别包里的 dsh.bundle 声明，把它追加为 web profile 的一层。

从源码安装¶

开发、改代码或需要从本地构建时，可以先克隆仓库：

git clone https://github.com/2710165659/dsh-web-plugin-explain.git
cd dsh-web-plugin-explain
npm install
npm run build          # 构建 lib/（index.js + client.js + typert.host.js）
dsh plugin --profile web add ./dsh-web-plugin-explain

构建会生成 lib/ 下的 index.js、client.js、typert.host.js。

同样需要重启 dsh web 后生效。

典型用法¶

1、安装插件：

dsh plugin --profile web add dsh-web-plugin-explain

2、重启 dsh web。

3、打开：

设置 → 插件 → 「插件列表」

4、展开任意插件卡片，查看 package.json 的 description。

5、在搜索框输入插件 id、模块名或描述，定位目标插件；第三方插件还可以搜索「第三方」。

卸载¶

卸载命令如下：

dsh plugin --profile web remove dsh-web-plugin-explain

重启 dsh web 后，可恢复内置的插件列表。

适用场景与注意¶

这个插件适合以下场景：

• 维护多个 DSH Web 插件，需要快速查看插件包说明。
• 区分内置插件与第三方插件。
• 在设置页面的「插件列表」里按描述搜索插件。
• 开发 DSH Web 插件时，从源码安装并本地构建验证。

使用前需要注意：

• 许可证为 MIT。
• 插件以当前 dsh 进程权限运行；安装前应检查源码、依赖与许可证。
• 该插件是社区插件线索中收录的 Web 客户端插件；社区目录是独立站点，不与 DeepSeek / 幻方构成官方从属关系。
• 描述解析不到时显示 —；描述解析失败不会导致插件列表本身渲染失败。

链接¶

• GitHub：https://github.com/2710165659/dsh-web-plugin-explain
• 目录页：https://www.skillhub.cn/plugins/2710165659/dsh-web-plugin-explain（来自插件线索，建议自行核实）