@deepwhale-cn/dsh-plugin-updater:第三方 DSH 插件版本检查与精确升级

前言

在 DSH 里装第三方插件,常见有两处别扭:官方「插件」页主要面向目录内包,第三方从 npm 装的包往往没有现成的「更新」入口;另一方面,pnpm 11 起默认 minimumReleaseAge: 1440(分钟),刚发布的版本要等满约一天才会被解析,卸载重装也未必立刻拿到最新版。

下面介绍维护者 feely0208 发布的工作流类插件 @deepwhale-cn/dsh-plugin-updater(仓库 feely0208/dsh-plugin-updater)。它对比 registry 上的最新版本,用精确版本号(pkg@x.y.z)安装,一条命令完成升级,绕过 pnpm 的新版本观察期。当前 npm 包版本为 0.3.0:自该版本起不再注入 Web 界面,仅通过 Agent 工具提供检查与升级能力(0.2.x 曾在插件页提供「插件更新」按钮,与现版行为不同,以 package 说明为准)。

这是什么

@deepwhale-cn/dsh-plugin-updater 是 DeepSeek Harness 的第三方插件,MIT 许可,作者信息见包元数据(温州深鲸智能科技有限公司)。定位是:只针对 profile 里、符合 DSH 插件判据的 npm registry 第三方插件,列出「已装版本 / 最新版本」,并在你显式确认后执行精确升级。不做后台自动更新。

核心功能

版本对比

通过工具 plugin_update_check,扫描当前 profile 下的第三方 DSH 插件依赖,与 npm registry 最新版本对比,标出可更新项。示例输出形态如下(摘自 README):

第三方插件更新检查:

  ⬆️ @deepwhale-cn/dsh-badge  已装 0.1.0  最新 0.1.1  (可更新)

共 1 个第三方插件,1 个可更新。

精确升级

通过工具 plugin_update_apply,按包名列表 names 或 all=true 升级;支持 dry_run 预览。安装时使用精确版本(等价于 --save-exact 思路),从而绕过 pnpm 11+ 对新发布版本的等待窗口。

对模型说「检查插件更新」「把 dsh-badge 更新一下」等自然语言时,会路由到上述工具。

安全边界(宿主侧判据)

资料中明确的安全约束如下,升级前宜知晓:

  • 只处理 profile 里 npm registry 依赖:link:、file:、git:、workspace: 一律跳过。
  • 只处理声明了 dsh.bundle 的包,避免误动普通 npm 依赖。
  • 不做后台自动更新;必须显式指定包名或 all=true。
  • 更新完成后需要 重启桌面端或 DSH 服务(bundle 组合在启动时定型)。

安装与启用

在目标 profile 下执行官方 README 中的安装命令:

dsh plugin --profile <你的 profile> add @deepwhale-cn/dsh-plugin-updater

package.json 中声明的运行时要求包括 Node >=20,以及 dsh 版本区间 >=0.1.0-rc.6 <0.3.0(安装前请对照你本机 DSH 版本是否落在该范围内)。插件以当前 DSH 进程权限运行,安装前应自行查看 GitHub 源码 与许可证。

典型用法

  1. 让 Agent 调用 plugin_update_check,查看哪些第三方插件落后于 registry。
  2. 确认列表后,调用 plugin_update_apply:指定 names 升级单个或若干包,或 all=true 升级全部可更新项;可先设 dry_run 看将要执行的操作。
  3. 升级结束后重启 DSH 或桌面端,新版本 bundle 才会生效。

适用场景与注意

适合经常从 npm 安装社区第三方 DSH 插件、又希望不用手工改 package.json 和反复 pnpm install 的开发者。它补的是「第三方插件没有官方页一键更新」和「pnpm 观察期拦新版本」这两块缺口,不替代你对依赖来源的信任判断。

社区插件目录为独立站点(如 SkillHub 上的条目),与 DeepSeek / 幻方无官方从属关系;DSH 生态本身是「一切皆插件」的思路,本插件属于其中的工作流辅助类工具。

若你仍在使用带界面注入的 0.2.x,README 中描述了插件页右下角「插件更新」按钮及 /plugin-updater/check、/plugin-updater/apply 路由;升级到 0.3.0 后应以 Agent 工具为唯一入口。

结尾

@deepwhale-cn/dsh-plugin-updater 把第三方 DSH 插件的版本检查和精确升级收成可对话、可预览的一步流程,并限定在 npm + dsh.bundle 范围内,降低误升级普通依赖的风险。目录页:https://www.skillhub.cn/plugins/feely0208/dsh-plugin-updater;源码与说明:https://github.com/feely0208/dsh-plugin-updater。

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

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

小夜