插件启停管理jianbin-01/dsh-plugin-manager

🎛️ dsh-plugin-manager

在 Web 设置里直接启停 DeepSeek Harness 插件 —— 一键开关、整包管理,内置 / 用户安装一目了然。
Enable or disable DeepSeek Harness plugins straight from the Web settings — one-click row & bundle toggles, native vs user-installed at a glance.

一个可即装即用的 dsh bundle:给 Web 设置 → 插件 页新增「启停管理」标签,在浏览器里直接控制插件的启用与停用,并清楚区分内置插件(随 dsh 安装提供)与用户安装的插件。不修改任何 dsh 源码,通过标准的 profile bundle 机制挂载。

✨ 亮点 / Highlights

| | 功能 | 说明 |
|---|---|---|
| 🎚️ | 行级开关 | 任意 loader 条目一键启停;Host 行即时生效,无需重启 |
| 📦 | 整包开关 | 用户安装的 bundle 一键停用其全部行;内置包只读 |
| 🏷️ | 内置 / 用户安装 | 每个插件和 bundle 都带来源标识,一眼分辨 |
| 🛡️ | 核心保护 | loader / typert / 传输 / 存储等核心行禁止关闭,防误伤 |
| 🔍 | 搜索过滤 | 按名称 / 条目 / 包名实时过滤 |
| ⚡ | 即装即用 | 一条 dsh plugin add 命令 + 重启,零配置 |

Screenshot

🚀 安装 / Install

从 git 安装(推荐分发方式)

$env:DSH_HOME = ''
dsh plugin --profile web add "git+https://github.com/jianbin-01/dsh-plugin-manager.git#v0.1.0"

然后重启 web 服务器(dsh web)并硬刷新页面即可。

本包没有任何 prepare/build 脚本,pnpm 不会触发 allowBuilds 拦截,对方装完即用。

从 tarball / 本地目录安装

tarball(推荐,无需 junction)
dsh plugin --profile web add ".\dsh-plugin-manager-0.1.0.tgz"

或本地源码目录(link: 安装,需先让依赖可解析)
New-Item -ItemType Junction -Path "\node_modules"
-Target "\profiles\node_modules"
dsh plugin --profile web add "\dsh-plugin-manager"

卸载 / 升级

dsh plugin --profile web remove dsh-plugin-manager   # 卸载
dsh plugin --profile web update                      # 升级

⚙️ 工作原理 / How it works

- cordis.patch.yml 挂载 plugin-manager host 行,模块即本包;默认导出是 Typert Remote 服务(pluginManager.list / setRowEnabled / setBundleEnabled)。
- api gateway 通过 严格 typert 描述符(lib/typert.host.js 的 ./typert 导出,由 typert-loader 自动注册)认领 pluginManager/* 端点 —— 与官方 plugin-inventory 同一机制,不受 profile junction 布局下重复模块实例的影响。
- package.json 的 dsh.client 声明浏览器半部;lib/client.js 注册进 settings.plugins.tab 插槽,通过通用 /api RPC 通道调用远端。
- origin(内置 / 用户安装)按双锚点解析:包从 profile 自身 node_modules 链接而来即为用户安装,其余为内置。

📁 文件 / Files

| Path | Role |
| --- | --- |
| cordis.patch.yml | bundle patch:挂载 plugin-manager host 行 |
| lib/index.js | host 半部:pluginManager Remote 服务 |
| lib/typert.host.js | host 面 typert 清单(严格 wire 描述符) |
| lib/client.js | 浏览器半部:「启停管理」标签页 |
| package.json | dsh.bundle.patch + dsh.client + ./typert 声明 |

📝 说明 / Notes

- 停用 bundle 的行不会从 dsh.profile.bundles 移除该包(即不卸载);完整卸载请用 dsh plugin ... remove。
- 重新启用被下层(如 dsh-web-app)停用的行,会写入显式 disabled: false 覆盖,符合补丁层语义。
- 开关写入 profile 的用户补丁层(cordis.patch.yml),保留文件头部注释。
- 本项目是上游功能(设置页启停 + 来源区分)的落地原型;长期理想归宿是 deepseek-harness 源码(dsh-host-plugin-inventory + dsh-client-ui-settings-plugin-inventory + dsh-app-boot)。

📄 License

MIT © jianbin-01