前言¶

DeepSeek Harness（dsh）的理念是“一切皆插件”。当多个第三方插件部署到同一环境后，用户需要在 Web UI 中查看这些插件、搜索插件项目，并能按需要关闭或启动它们。

dsh-plugin-manager 是面向 DeepSeek Harness（dsh）的第三方插件管理器：在 Web UI 设置页选择第三方插件库文件夹，搜索其中所有第三方插件，并一键关闭/启动。

这是什么¶

huabai-flowerwhite/dsh-plugin-manager 由 huabai-flowerwhite 维护，许可证为 MIT。

它的核心作用不是替代 dsh 的插件加载机制，而是给已经部署的第三方插件提供一个设置页入口：选择第三方插件库文件夹、扫描插件项目、展示插件列表，并通过 cordis.patch.yml 中的 disabled: true 标记切换启停状态。

核心功能¶

下面介绍几个已明确的能力。

选择插件库文件夹并扫描¶

设置页「第三方插件」支持选择第三方插件库文件夹，也支持手动粘贴路径。点击「扫描」后，插件会查找其中的第三方插件项目。

扫描时会识别：

dsh.plugin.yaml
package.json

并跳过：

node_modules
.git
dist
DSH 自身

设置页启停开关¶

「第三方插件」设置页包含：

• 文件夹选择
• 扫描
• 插件列表
• 启停开关

在列表中点击「关闭 / 启动」即可切换插件状态。

写入 disabled 标记¶

一键关闭/启动会写入：

disabled: true

目标文件是：

cordis.patch.yml

写入前会自动备份 .bak。

查询当前状态¶

插件提供：

/dsh-plugin-manager/status

该接口返回当前 patch 路径与各插件启停状态。

安装脚本¶

插件提供 Windows 与 POSIX 的幂等安装脚本，重复运行无害。

安装与启用¶

安装¶

安装命令如下，按运行环境选择对应脚本。

Windows¶

git clone https://github.com/huabai-flowerwhite/dsh-plugin-manager dsh-plugin-manager
cd dsh-plugin-manager
powershell -ExecutionPolicy Bypass -File install.ps1

Linux / macOS¶

git clone https://github.com/huabai-flowerwhite/dsh-plugin-manager dsh-plugin-manager
cd dsh-plugin-manager
bash install.sh

启用¶

装完后重启 dsh：

npx dsh web

或：

dsh web

如果当前已经在运行 dsh，先按 Ctrl+C 停止，再重新启动。

本插件随 host composition 自动加载，启动后进入 Web UI 即可使用。

典型用法¶

1、启动 dsh，本插件随 host composition 自动加载。

2、进入「设置 → 第三方插件」。

3、点击「选择文件夹」选择第三方插件库文件夹，也可以手动粘贴路径，然后点击「扫描」。

4、在插件列表中点击「关闭 / 启动」切换插件状态。

注意：插件所在的文件夹名称应为“xx-xx-……”形式，即应当为插件名，方可被本插件正确控制。

适用场景与注意¶

适合谁¶

适合已经在 dsh 中部署多个第三方插件、希望在 Web UI 里集中查看和启停这些插件的开发者。

生效时机¶

插件启停在重启 dsh 后生效。原因是 composition 在启动时加载，本插件不改动运行中的 Loader。

启动未挂载插件的前提¶

如果某个插件当前未挂载，点击「启动」时，要求该插件包已在：

profiles/node_modules

中可解析，否则 dsh 无法 import 该插件包。

目录选择¶

pickDirectory() 依赖官方目录选择器服务。该服务不可用时，可回退为手动输入路径。

manifest 与权限¶

manifest 为声明式合规文档；实际权限以运行时沙箱策略为准。

运行权限¶

插件以当前 dsh 进程权限运行。安装前应检查源码与许可证，确认其操作范围符合你的预期。

版本与依赖¶

package.json 中声明：

{
  "version": "1.1.0",
  "engines": {
    "node": ">=22 <25"
  }
}

同时声明 dsh 兼容范围：

harness >=0.1.1-rc.2 <0.2.0

链接¶

• 目录页：https://www.skillhub.cn/plugins/huabai-flowerwhite/dsh-plugin-manager
• GitHub：https://github.com/huabai-flowerwhite/dsh-plugin-manager