DSH Plugin Steward: Integrated Management for Update Checks, Automated Upgrades, and Rollbacks

前言

DeepSeek Harness(DSH)把能力拆成大量插件,装得多了之后,常见问题是:不知道哪些能更新、升级会不会把中文名冲掉、两个插件功能重叠却看不出来、磁盘上留了失效引用。手动 pnpm 或逐个在市场里点,成本高,出错也难回滚。

插件管家(dsh-plugin-steward)是维护者 lihao178 发布的客户端类插件:左侧栏一个面板,外加同一套 CLI(dsh-pm / dsh-plugin-steward),零运行时依赖的纯 Node 工具,专门围绕「已装插件」做查更新、自动安装(装前快照、失败回滚)、体检、查重和清理。

这是什么

一句话:DSH 的插件 steward——更新检查、带快照回滚的自动更新、健康检查、重复分析、清理,面板与命令行共用一套逻辑。

社区目录站点与 DeepSeek / 幻方无官方从属关系;DSH 生态本身是「一切皆插件」的思路,管家解决的是本机已装插件的生命周期,不是替代官方应用商店。

核心功能

下面只列资料中明确描述的能力。

面板(三个主页面)

打开 Harness 左侧栏「插件市场」页,标签行最右侧 「插件管家」:

  1. 我的插件:查看已装列表、可更新项;点「更新」后,1.4.0 起面板内升级/安装/卸载/停用后会自动重启 Harness,无需手动关软件。
  2. 有风险吗:静态扫描各插件代码,提示谁会联网、谁执行命令、谁可能触及密钥;只提示,不拦截。
  3. 设置:例如「全部打开 (N)」——为所有市场插件开启自动查新版 + 自动装新版;有新版本时自动安装,装前备份,出错回滚。

设置里还有 备份还原;命令行也可用 snapshot list 查看备份。

命令行

入口示例(资料原文):

npx dsh-plugin-steward status
npx dsh-plugin-steward check
npx dsh-plugin-steward auto --write      # 有新版本就装, 装前自动备份

Windows 开发目录下可直接用内置 Node 的 dsh-pm.cmd(README 示例路径为 D:\智能\dsh-plugin-manager\dsh-pm.cmd),无参数进交互菜单。

常用子命令包括:status、list、check、update、auto、doctor、fix、dupes、clean、snapshot、schedule、report、daily、label 等。默认只预演;真正改磁盘需加 --write。通用参数含 --profile(默认 desktop)、--json、--only、--refresh。

分类与分组

工具区分 自创插件(link/file/workspace、@local/ 或路径不在 node_modules 真目录)、市场插件(自 npm 拉取)、宿主自带(在 app.asar,不应判损)、缺失(配置引用但磁盘无且宿主不带)。另按功能打 14 类标签(如市场管理、记忆知识、搜索联网等),可用 list --group <功能组> 筛选。

中文名与「怎么用」

升级可能冲掉插件目录内 locale/zh.json 的中文名;管家用 .state/labels.json 对账,体检可报 label-drift / label-wiped,fix --write 可写回。面板会补 中文名 + 说明 + 来源;缺中文可经 API 或「补齐中文」批量从市场目录填充。

1.5.0 起从各插件 README 按常见标题抽取 「怎么用」 段落,存入登记表(非插件目录,避免升级覆盖);面板行内 ▸ 怎么用 可展开,工具行有 补怎么用。

更新源

除 npm dist-tags.latest 外,对 spec 中明写的 github:owner/repo 等形式走 GitHub Releases(SemVer tag);结果缓存在 .state/github-cache.json。自更新时不先 remove,原地覆盖并配合快照。

安装与启用

推荐(GitHub,资料原文):

dsh plugin --profile desktop add github:lihao178/dsh-plugin-steward

Harness 内(面板 + HTTP 接口):

plugin_manager action=install_bundle target=dsh-plugin-steward

或在插件市场搜索「插件管家」/ dsh-plugin-steward 安装。

也可对 AI 说:「装这个插件: github:lihao178/dsh-plugin-steward」,装完重启一次 Harness 以加载(面板内操作 1.4.0 起多数情况会自动重启)。

只想 CLI、不要面板时,用上文 npx dsh-plugin-steward … 即可。

典型用法

日常:开自动更新

  1. 安装并进入左侧 插件管家 → 设置。
  2. 点 「全部打开 (N)」,之后市场插件会自动查新、装新;装前备份,失败回滚。

手动查更与升级

dsh-pm.cmd check
dsh-pm.cmd update --write          # 预演时不加 --write

体检与修复

dsh-pm.cmd doctor
dsh-pm.cmd fix --write

查重与清理

dsh-pm.cmd dupes
dsh-pm.cmd clean --write           # 默认仅预演

备份回滚

dsh-pm.cmd snapshot list
dsh-pm.cmd snapshot restore ...

出问题可在面板 设置 → 备份还原 退回插件管家自身上一备份。

适用场景与注意

适合:本机 DSH 插件数量较多、需要统一查更新与自动升级、希望升级前快照与失败回滚、想静态扫一遍「联网/执行命令」风险、需要查重和清理无效引用、关心升级后中文名与用法说明是否还在。

注意:

  1. 插件以当前 DSH 进程权限运行;安装前请自行阅读仓库源码与 MIT 许可证,确认可接受其扫描与自动修改 node_modules 的行为。
  2. 「有风险吗」为静态提示,不替代你自己的安全审查。
  3. 命令行 auto 等路径仍可能提示手动重启;与面板自动重启行为以 README 说明为准。
  4. GitHub API 匿名限额下,check 对 GitHub 源插件会走缓存;可配置 GITHUB_TOKEN / GH_TOKEN / GITHUB_PAT。

结尾

插件管家把「查更新、自动装、备份回滚、体检、查重、清理」收到左栏与一套 CLI 里,并针对 DSH 常见的 GitHub 装包、中文名被升级冲掉、README 用法分散等问题做了专门处理。进一步了解可打开 SkillHub 目录页 与 GitHub 仓库 README。

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

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

Xiaoye