前言¶
DeepSeek Harness(DSH)把能力拆成大量插件,装得多了之后,常见问题是:不知道哪些能更新、升级会不会把中文名冲掉、两个插件功能重叠却看不出来、磁盘上留了失效引用。手动 pnpm 或逐个在市场里点,成本高,出错也难回滚。
插件管家(dsh-plugin-steward)是维护者 lihao178 发布的客户端类插件:左侧栏一个面板,外加同一套 CLI(dsh-pm / dsh-plugin-steward),零运行时依赖的纯 Node 工具,专门围绕「已装插件」做查更新、自动安装(装前快照、失败回滚)、体检、查重和清理。
这是什么¶
一句话:DSH 的插件 steward——更新检查、带快照回滚的自动更新、健康检查、重复分析、清理,面板与命令行共用一套逻辑。
- 仓库:github.com/lihao178/dsh-plugin-steward
- 目录页:skillhub.cn 插件条目
- 许可:MIT(见仓库
package.json) - 宿主要求:
dsh引擎>=0.2.1-rc.3(见package.json的dsh.engines)
社区目录站点与 DeepSeek / 幻方无官方从属关系;DSH 生态本身是「一切皆插件」的思路,管家解决的是本机已装插件的生命周期,不是替代官方应用商店。
核心功能¶
下面只列资料中明确描述的能力。
面板(三个主页面)¶
打开 Harness 左侧栏「插件市场」页,标签行最右侧 「插件管家」:
- 我的插件:查看已装列表、可更新项;点「更新」后,1.4.0 起面板内升级/安装/卸载/停用后会自动重启 Harness,无需手动关软件。
- 有风险吗:静态扫描各插件代码,提示谁会联网、谁执行命令、谁可能触及密钥;只提示,不拦截。
- 设置:例如「全部打开 (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 … 即可。
典型用法¶
日常:开自动更新¶
- 安装并进入左侧 插件管家 → 设置。
- 点 「全部打开 (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 插件数量较多、需要统一查更新与自动升级、希望升级前快照与失败回滚、想静态扫一遍「联网/执行命令」风险、需要查重和清理无效引用、关心升级后中文名与用法说明是否还在。
注意:
- 插件以当前 DSH 进程权限运行;安装前请自行阅读仓库源码与 MIT 许可证,确认可接受其扫描与自动修改
node_modules的行为。 - 「有风险吗」为静态提示,不替代你自己的安全审查。
- 命令行
auto等路径仍可能提示手动重启;与面板自动重启行为以 README 说明为准。 - GitHub API 匿名限额下,
check对 GitHub 源插件会走缓存;可配置GITHUB_TOKEN/GH_TOKEN/GITHUB_PAT。
结尾¶
插件管家把「查更新、自动装、备份回滚、体检、查重、清理」收到左栏与一套 CLI 里,并针对 DSH 常见的 GitHub 装包、中文名被升级冲掉、README 用法分散等问题做了专门处理。进一步了解可打开 SkillHub 目录页 与 GitHub 仓库 README。