npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-tiered-plugin-menu

v1.1.5

Published

为每个工作区和会话独立配置 DSH 插件、MCP 和 Skill,支持逐级继承与插件实例隔离。

Readme

分级插件菜单

简体中文 | 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。