dsh-plugin-suite:一次安装装配整套 DSH 工作流插件

前言

在 DSH(DeepSeek Harness)里做日常开发,往往会用到锁屏、环境变量管理、进程重启、会话归档、侧栏标签操作等多块能力。若逐个从社区目录挑选并安装,既要重复确认包名与版本,也要在「设置 → 插件」里面对一长串条目。另一种做法是把所有功能代码合并进一个仓库发一个包,但任一模块在 apply 阶段抛错时,容易拖垮同包内的其他功能——包括锁屏这类基础能力。

dsh-plugin-suite(GitHub:felixpu/dsh-suite,维护者 felixpu)采用聚合包形态:本包几乎不含业务代码,通过 cordis.patch.yml 把多个独立维护的 npm 插件装配成一组。一次安装后,在设置里看到一个分组即可展开全部子插件;单个插件故障时,平台按行加载,一般只影响该插件自身。下面介绍它包含什么、如何安装,以及安装时需要注意的限制。

这是什么

dsh-plugin-suite 是 DSH 插件合集,分类上属于工作流向的装配方案。npm 包名为 dsh-plugin-suite,当前资料中的版本为 0.2.0,许可证为 MIT。

它的 lib/index.js 仅做空导出,功能代码仍在各子插件各自的仓库中独立发版。本包在 package.json 的 dependencies 里声明子包,并用 Cordis patch 里的 cordis:group 把它们显示为同一分组。社区目录页:https://www.skillhub.cn/plugins/felixpu/dsh-suite;源码与说明:https://github.com/felixpu/dsh-suite。

聚合包包含的插件

装妥本包后,下列插件会作为一组出现(名称与作用以仓库 README 为准):

插件 作用
dsh-lock 密码门禁:打开 DSH 需输入密码解锁,支持手动/自动锁定
dsh-settings-params 设置分页:集中管理注入宿主的环境变量
dsh-env-inspector-plus 设置分页:宿主进程身份与环境变量分组概览(值不出宿主)
dsh-restart-autostart 进程控制:重启按钮与「跟随系统启动」
dsh-archive-session-manager 归档会话管理
dsh-sidebar-tab-actions 右侧栏标签页右键菜单:关闭左侧 / 关闭右侧 / 关闭全部

各子插件仍有自己的 GitHub 仓库;若只需要其中某一个,可以直接安装对应包,本聚合包不强制全家桶。

聚合包与「单包合并代码」的区别

README 用表格概括了设计取舍:功能代码留在各仓库;故障隔离上,单个插件出错通常只影响自己那一行;各子包可单独升级,本聚合包不必为子版本改代码;排障时可定位到具体插件名。

另有平台约束:客户端 bundle 的 id 必须等于包名,各插件客户端半身各有自己的 id,无法物理合并进同一个 bundle。

想自定义组合时,可改仓库中的 cordis.patch.yml 嵌套列表:每条 id 为组合内短名;name 必须是真实 npm 包名,且出现在 package.json 的 dependencies 中。

安装与启用

安装命令须使用 npm 包名,不要用 github:owner/repo 规格。资料中的实测结论是:pnpm 对 github: tarball 依赖不解析其 dependencies,lockfile 的 snapshots 段不记录依赖关系,结果子插件不会被装上,node_modules 里往往只有本包自身;走 npm registry 时依赖才会被正确解析。

在 web profile 下执行:

dsh plugin --profile web add dsh-plugin-suite

装完后打开 DSH 的「设置 → 插件」,应能看到 dsh-plugin-suite 一个分组,展开即为本包装配的全部插件。

典型用法

本包本身不提供额外 CLI 或配置面板,用法即「安装聚合包 → 在设置里启用/查看分组 → 按需使用各子插件在 UI 中的入口」。

例如:dsh-lock 在打开 DSH 时要求密码解锁;dsh-settings-params 与 dsh-env-inspector-plus 在设置里分别承担环境变量编辑与只读概览;dsh-restart-autostart 提供重启与随系统启动;dsh-archive-session-manager 管理归档会话;dsh-sidebar-tab-actions 在右侧栏标签上提供批量关闭菜单。具体交互以各子插件文档为准。

若某子插件行为不符合预期,可在分组内单独禁用或改为只安装该子插件的独立包,便于缩小排障范围。

适用场景与注意

适合希望一次性装配 felixpu 维护的上述工作流插件、又希望保持子包独立升级与故障隔离的 DSH 用户。不适合已经用手动方式装好部分同名插件、且不想在设置里出现重复分组的情况——此时应只保留一种安装路径。

DSH 插件以当前 dsh 进程的权限运行;安装前建议阅读本包及子插件源码与许可证(本包为 MIT)。社区目录站点 skillhub.cn 与 DeepSeek / 幻方无官方从属关系,插件来源以 GitHub 与 npm 为准。

结尾

dsh-plugin-suite 用聚合包把锁屏、环境变量、进程控制、会话归档和侧栏标签操作等插件收成一组,安装命令简单,子功能仍各自发版。目录页:https://www.skillhub.cn/plugins/felixpu/dsh-suite;仓库:https://github.com/felixpu/dsh-suite。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye