🎛️ 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 命令 + 重启,零配置 |
🚀 安装 / Install
从 git 安装(推荐分发方式)
$env:DSH_HOME = '<harness data 目录>'
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 "<bundle-parent-dir>\node_modules" `
-Target "<dsh-home>\profiles\node_modules"
dsh plugin --profile web add "<bundle-parent-dir>\dsh-plugin-manager"卸载 / 升级
dsh plugin --profile web remove dsh-plugin-manager # 卸载
dsh plugin --profile web update # 升级⚙️ 工作原理 / How it works
cordis.patch.yml挂载plugin-managerhost 行,模块即本包;默认导出是 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插槽,通过通用/apiRPC 通道调用远端。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