前言¶
在 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。