dsh-tiered-plugin-menu
Identified★ 11Manage DSH plugins per client, workspace and session, with independent enable/disable controls, separate configurations, inherited defaults and reuse of original plugin settings pages.
分级插件菜单
简体中文 | English
下载中心:桌面 / Web · TUI · dsh-go — 各端最新版本与历史安装包分别列出,共享核心自动安装。
让每个工作区、每个会话都能独立开关 DSH 插件、MCP 和 Skill,并使用各自不同的配置。
比如,只在写代码的工作区启用某个插件,在其他工作区关闭;同一个插件,在会话 A 使用配置 A,在会话 B 使用配置 B。直接从侧栏的小插件按钮打开菜单,在「设置」中使用原插件的配置界面。
配置按 客户端 → 父工作区 → 子工作区 → 会话 逐级继承,支持任意深度的工作区树。没有单独设置时沿用上级,需要时在工作区或单个会话里覆盖。
三端组件
同一套核心支持桌面/Web、dsh-TUI 和 dsh-go。各包独立版本、独立发布;兼容的核心修复只需发布核心包,无须同步发布三个界面。
| 包 | 职责 |
|---|---|
dsh-tiered-plugin-core | 分级继承、插件实例、依赖、MCP 与 Skill;由界面自动依赖 |
dsh-tiered-plugin-menu | 原桌面/Web 菜单,保留原包名和配置路径 |
dsh-tiered-plugin-tui | 终端侧栏面板;使用 TUI 宿主 React 与对话框 |
dsh-tiered-plugin-go | dsh-go 原生菜单,并按会话转发其他原生插件的界面注册 |
挂在同一 DSH 宿主的界面共用一份核心和实例。 关闭其中一个不会影响其他界面或后台任务;最后一个界面组件退出才释放运行中的管理器,核心宿主入口可以留待下次使用。分别启动的 DSH 进程各有自己的运行实例,不能仅靠共用文件夹实现内存共享。
三端都提供插件 / 官方插件 / MCP / Skill、本级 / 下级默认、继承 / 启用 / 关闭和配置编辑。桌面继续复用插件原设置页;TUI 逐字段编辑,手机使用 JSON 表单。详见 TUI、dsh-go 和 组件架构。
只安装对应端的一个包
| 使用的客户端 | 安装包 |
|---|---|
| 桌面 / Web | dsh-tiered-plugin-menu |
| dsh-TUI | dsh-tiered-plugin-tui |
| dsh-go | dsh-tiered-plugin-go |
每个界面包都声明「共享核心组件 + 界面组件」,并自动把核心登记到 Harness 原生包管理器。不需要再手动安装或启用核心。 多个界面仍共用一个核心。
TUI 示例(把 <profile> 换成实际 profile 名称):
dsh plugin --profile <profile> add dsh-tiered-plugin-tui
核心登记或更新后,如果 Harness 提示重启,请重启后使用。TUI 重启后在侧栏面板选择器打开「分级配置」。
在 Harness 中更新
在「插件」页点 刷新,选择需要更新的包。核心和界面各有自己的版本和更新入口;界面详情页的「组件版本」列出两者,可跳转管理核心。
按钮位置

- 客户端插件:图中「工作区」总标题右侧的插头图标,设置整个客户端的默认插件与配置。
- 工作区插件:鼠标悬停在工作区名称这一行,点击出现的插头图标。
- 会话插件:鼠标悬停在会话名称这一行,点击出现的插头图标。
- 新会话:选择工作区后,在输入框上方「工作区 / 标准模式」这一行右侧点击「分级配置」,即可在发送第一条消息前设置当前会话及其下级默认配置。
- 会话标签页:打开会话顶部的「分级配置」,直接调整当前会话的「本级 / 下级」插件、MCP 和 Skill 设置。进入子代理或孙代理时,配置对象跟随当前显示的会话,沿父代理逐层继承。标签页使用 DSH 官方插槽,可与 Context 等插件的标签页并列使用。
工作区和会话按钮在悬停时显示,上图未悬停的行里不会显示按钮。
rc.1 中,「分级配置」只是原会话菜单的另一个入口;rc.2 中也可从子代理导航进入后使用。两者共用同一套配置和继承逻辑,不要求升级到 rc.2。
安装
在 DSH 的 插件 → 添加插件 中输入 npm 包名:
dsh-tiered-plugin-menu
也可以在命令行安装:
dsh plugin --profile desktop add dsh-tiered-plugin-menu
也可以从 下载中心 按客户端选择构建好的 .tgz 安装;完整发布记录见 Releases。
Web 版换成自己的 profile 名称,通常是 web。未开启热重载时重启 DSH。不需要预先安装临时消息等其他插件。
发行包包含宿主、浏览器构建产物、bundle patch 与许可,不需要安装时运行构建脚本。GitHub 源码需要先构建,直接安装请使用 Release 的 tarball。这是 DSH 官方打包教程支持的分发方式。
使用
- 侧栏「工作区」总标题旁的插件图标打开客户端配置;各工作区、会话行上的图标打开对应层级配置。
- 外层一个包显示一项,继承|启用|关闭按钮同时作用于包内全部组件。
- 点击包进入组件列表,才能逐个控制。组件开关不一致时,外层显示「部分启用」。
- 「设置」展开原插件的配置卡;没有可复用的配置卡时提供 JSON 编辑器。设置页与详情页都有配置卡时分别显示,中间用横线分隔。
- 本层关闭后不再执行继承来的实例;下级明确启用仍可覆盖上级关闭。
- 客户端级使用 DSH 原有入口和开关,下两级创建独立实例;可选的实验性隔离开关也会给客户端入口提供独立环境。离开页面不会卸载后台会话的实例。
- 关闭界面时移除其界面入口;最后一个界面组件关闭时,释放下级实例与接口,保留持久化配置;再次开启时恢复。只有客户端级原本启用的插件会恢复原生前端。
- 选中另一个会话时切换前端绑定;进入洞察、设置等页面保留当前绑定。
- 更新已安装插件时,等待 DSH 完成模块与 CSS 重载,再更新下级前端和已打开的配置卡,保留选中的会话及其配置。
例如客户端配置 A、工作区配置 B、其中一个会话配置 C:该会话用 C,同工作区其他继承的会话用 B,其他工作区继承 A。
MCP 与 Skill
菜单左侧可切换 插件 / 官方插件 / MCP / Skill,使用同一套本级、下级默认设置和树状继承规则。「下级」可直接逐项配置,「全部重置为继承」清除当前层级所有类别的下级默认覆盖;默认值只在新建下级时应用。
「官方插件」自动读取 Harness 提供的官方组合包信息,包括安装目录内已经提供、但尚未在客户端启用的插件。可以保持客户端关闭,只在指定工作区或会话启用;组合包默认同开同关,进入详情后可分别配置组件。尚未下载安装的可选包,先通过 Harness 安装。不会把宿主基础服务当作普通插件列出。
官方插件与第三方插件共用实例隔离和依赖处理,没有按具体插件名称打补丁。兼容声明以包元数据为准,不因官方身份自动跳过确认。
官方和第三方插件都可以在本级「关闭」时修改并保存配置,之后启用时应用;已启用的插件保存后立即应用。保存配置不会改变「继承/启用/关闭」状态。继承中的配置由上级管理,先选择本级启用或关闭即可单独编辑。菜单左侧分类固定,右侧内容独立滚动。
- MCP:自动识别 DSH 配置中的
@deepseek-ai/dsh-mcp-client入口,也可点击「添加 MCP」。设置中填写连接参数 JSON,支持 stdio 与 streamable-http。继承时共用上级连接;本级独立启用时创建独立连接,stdio 会启动独立进程。工具、资源及服务器提示信息一起按作用域生效,离开会话页面不会断开后台连接。 - Skill:显示 DSH 技能注册表中本作用域可用的文件技能和插件注册技能,支持逐项开关,并可覆盖说明、正文和模型/用户调用权限。覆盖只存入菜单配置,不修改原始
SKILL.md。技能来源、附带脚本和资源目录仍共用,未复制为独立执行环境。更改影响后续技能查询和加载,不改写已经进入对话的内容。
例如,一个 MCP 的本级配置可以是:
{
"serverName": "my-server",
"transport": "streamable-http",
"url": "http://127.0.0.1:3000/mcp",
"headers": {}
}
MCP 的命令、环境变量、目录、URL 和请求头可以分级设置;远端服务和外部进程的存储是否独立仍取决于这些配置。关闭菜单时,菜单新增的 MCP 连接会释放,DSH 原有入口交回 DSH 管理;保存的分级设置在再次开启菜单后恢复。
按工作区树继承
菜单自己的设置页中,按工作区树继承 默认开启,修改后立即保存生效。各层插件仍在侧栏菜单中配置。
父级取最近的已注册上级目录,与 DSH 的「工作区树」分组一致;未注册的中间目录会跳过。每个插件沿树寻找最近的明确配置,继承时共用上级实例。关闭开关后,各工作区直接继承客户端,已有独立配置和下级默认设置仍保留。改变或删除上级时,依赖其服务的组件也会重新连接。
删除工作区后,会话按新归属继承:有父工作区则继承父工作区,未分组则继承客户端。会话自己的配置保留,被删工作区的本级配置和下级默认值清除;重启后也按新归属恢复。
目录层级与 Agent 的父子关系分别处理:Superagent 的 Worker 目录位于 Router 目录下时,可以继承 Router 所在工作区的配置,即使 Worker 并不是 DSH 原生子 agent。
插件隔离(实验性)
菜单设置页的第二个开关是 插件隔离(实验性),默认关闭,升级后也不会自动开启。修改后立即保存,重启 DSH 生效。
给插件提供相对独立的环境,可能能修复一些兼容性问题,但也可能带来更多兼容性问题。
开启后从客户端级开始隔离,复用工作区/会话实例已有的模块加载、目录重定向、服务路由和释放逻辑。工具、技能、命令、提示词片段、统计投影使用带插件标识的稳定名称,让两个工具同名的插件也能在同一个会话中共存。有明确声明的服务依赖继续连接,其余服务保持独立。
客户端私有数据首次从 <配置文件名>.data/ 中的新目录开始,原插件目录保留;关闭隔离并重启后,客户端入口恢复使用原目录。固定端口、外部进程、同名 Agent 预设,以及依赖其他插件原始公开名称的代码不在此次覆盖范围内。隔离机制与限制。
下级默认设置
每个菜单都有 本级|下级 选项卡,默认打开本级。下级页面可直接调整各项开关,并复用原插件的配置卡。点击 全部重置为继承,会清除当前层级保存的插件、官方插件、MCP 和 Skill 下级默认配置,不影响本级及已有下级实例。
| 在哪里设置「下级」 | 用于哪些新实例 |
|---|---|
| 客户端 | 新顶层工作区(关闭树继承时为所有新工作区),以及没有归属工作区的新会话 |
| 工作区 | 新普通会话;开启树继承时也用于新子工作区 |
| 会话 | 新子 agent,包括后续各级子 agent |
下级设置中明确启用或关闭的项目,会在新建时复制到对应实例;仍选「继承」的项目继续沿用上级。编辑默认值不会启动测试实例,也不会改写已有工作区、会话或子 agent。恢复会话、重启和重新打开工作区都不会重新应用默认值。
新会话页面中为本次会话单独设置的项目优先于这些默认值;没有单独设置的项目继续采用下级默认值或继承配置。
子 agent 按实际父子关系逐项查找最近的下级默认设置;某项没有另设时,继续沿用父会话的下级默认设置,因此可以传到孙 agent,修改一项不影响其他项的继承。它们各自获得独立的配置副本。普通会话分叉不会因为记录了父会话 ID 就被当成子 agent。
嵌套工作区同样逐项查找上级工作区的下级默认设置;更改默认值不会覆盖已经创建的下级。
分层配置保存在 $DSH_HOME/plugins/tiered-plugin-menu.json,可通过菜单插件的 dataFile 更改。客户端配置通过 DSH 原生配置编辑器写入 profile。已有的整包配置会迁移到组件配置项。
依赖处理
修改开关前,菜单先计算完整的影响范围:
- 启用组件时,如果依赖尚未启用,列出依赖并提供自动启用/取消。
- 关闭被依赖的组件时,列出仍在使用它的组件并提供自动关闭/取消,也包含继承该依赖的下级会话。
- 依赖根本没安装或不可用时直接报错,开关保持原状,不会自动安装。
- 属于同一个包不代表互相依赖。外层开关按整包操作;详情页的单独开关根据 DSH 服务声明及已观察到的运行依赖处理。
这些确认规则作用于本菜单内的操作;DSH 自带插件页仍按其原生逻辑运行。
自动目录隔离
下级实例通过 Node 文件接口创建或确保目录存在时,菜单为它分配私有目录;同样的逻辑路径可以在不同实例中保存不同数据。继承上级实例时共用上级目录,独立启用时使用自己的目录。配置里的路径保持原样,不依赖 stateDir 等字段名,也不按插件名称适配。
相对路径和 .. 先在原来的逻辑路径中解析,再决定是否重定向;realpath 返回逻辑路径,因此继续拼接子路径或访问上级不会误入内部存储目录。
数据保存在菜单配置文件旁的 <配置文件名>.data/ 中,按作用域和包区分;重开菜单或恢复会话继续使用原来的私有数据。首次使用隔离功能时创建新的私有数据目录,已有目录不会被搬动或删除。目录隔离说明。
兼容能力
菜单采用通用机制,不修改 DSH 或第三方插件源码,也不按具体插件名称写适配:
- 实例与配置隔离:工作区、会话独立实例;继承时共用上级实例,配置和生命周期随作用域管理。
- 服务隔离与依赖连接:隔离插件私有服务,让声明的依赖连接到对应作用域的提供者。
- 注册与名称处理:按作用域转发工具、技能、命令、提示词、统计投影和 HTTP 注册,处理不同会话中的重名。
- 前端和配置卡复用:加载原插件的前端、CSS 和设置页,支持客户端关闭、下级独立启用及插件更新后的重载。
- Agent 预设隔离:不同作用域使用同名预设的不同配置,保留子 agent 的版本引用。
- 私有目录重定向:为实例分配独立数据目录,保持相对路径、
..和realpath的逻辑路径语义。 - 组合包和资源管理:整包或逐组件控制依赖;MCP、Skill 使用同一套继承规则。
- 启动与错误处理:合并重复列表读取、按变更刷新插件清单;单个插件加载或配置出错时单独提示,保留菜单与其他插件的操作入口。
实验性隔离还可将隔离扩展到客户端级,并通过带插件标识的名称处理部分同会话冲突。这些机制不是安全沙箱,也不保证任意插件组合都兼容;固定端口、外部进程和绕过受支持接口的访问不在隔离范围。
完整机制、适用范围、限制与测试记录见 兼容性详细文档。
作者兼容声明
插件作者自行测试与分级菜单兼容后,可以在 package.json 中用布尔值 Compatible 声明:
{
"dsh": {
"tieredPluginMenu": {
"Compatible": true
}
}
}
true 表示作者已测试与本菜单兼容,包括工作区、会话和子 agent 的独立实例及配置。false 或未填写视为未验证,在下级显示于「未验证兼容性」分组,启用前需要确认。官方插件和第三方插件遵循同一规则。
这是作者声明,不是 DSH 官方认证,也不保证与其他所有插件互相兼容。菜单不会替作者写入声明。作者测试建议与字段说明
开发
npm ci --ignore-scripts
npm run check
npm run pack # 打包四个组件到 dist/
npm run pack -- core # 只打包核心
可以在独立 checkout 中构建。vendor/ 包含未经改动的 MIT 测试依赖,不需要访问私有仓库。构建与验证方式见 组件开发说明。
主要文件:packages/core/src/manager.ts 管理实例和继承;同目录的 dependencies.ts 计算依赖,runtime-tree.ts 管理 Loader 入口,scoped-services.ts 转发共享注册。packages/web/src/client/ 保留原菜单;packages/tui/ 与 packages/dsh-go/ 是独立界面适配包。
卸载目前保留包目录之外的配置和插件私有数据。DSH 的更新也会使用移除/重装流程,因此不把删配置绑定到普通卸载或实例释放;重装会恢复原设置。
许可
MIT,允许商用、修改和分发,保留许可声明即可。打包的校验库及源码测试依赖保留原许可,见 THIRD_PARTY_NOTICES.txt。
Versions
| Latest version | Published | Size |
|---|---|---|
| 0.6.4 | — | — |
Comments
Loading…
Similar plugins
by I-am-shy
"My Plugins" Management Panel: Only manages plugins you have installed yourself (view / enable / disable / uninstall) 「我的插件」管理面板:只管理你自己安装的插件(查看 / 启用 / 关闭 / 卸载)
★ 0
MIT
TypeScript
Sep 11, 2026
dsh plugin --profile web add dsh-my-pluginsby penglai-doll
Plugin management tab for the Web Plugins settings: manage agent presets (list/read/validate/copy/remove, per-row enable/disable) and the dynamic Cordis plugin inventory, through a same-origin /plugin
★ 0
MIT
JavaScript
Aug 17, 2026
dsh plugin --profile web add dsh-plugin-managerby xiyue718
DSH 第三方插件管理插件:从设置页启用、禁用、卸载插件。 / Manage third-party DSH plugins from the Plugins settings page.
★ 0
TypeScript
Sep 20, 2026
dsh plugin --profile web add @dsh-external/ui-plugin-managerby ftima-w
GUI in the DSH settings panel: toggle/delete MCP servers, browse and trash skills, stop/enable/delete installed plugins, list built-in plugin packages — hot-applied without restart.
★ 0
MIT
JavaScript
Aug 16, 2026
dsh plugin --profile web add dsh-plugin-managerby jackxiao-hub
A DSH web client plugin that turns the Settings → Plugins page into a dependency-layered plugin tree, plus an interactive dependency graph. Dependencies are prerequisites: see at a glance how plugins
★ 0
MIT
TypeScript
Aug 16, 2026
dsh plugin --profile web add @dsh-external/dsh-client-ui-plugin-treeby Alail691
把 DSH 侧栏的「插件」整体收进设置:在「设置 → 插件」里新增一个「插件管理」标签页,内嵌官方插件面板的全部能力(浏览 / 安装 / 开关 / 卸载)。Bring the sidebar's Plugins page into Settings as a tab, embedding the official plugin manager.
★ 0
MIT
JavaScript
Oct 16, 2026
dsh plugin --profile web add dsh-plugins-in-settings