dsh-plugin-runcat-inventory:DSH 插件总览与管理工具

前言

DeepSeek Harness(DSH)采用“一切皆插件”的架构,随着插件生态的扩展,手动维护配置、查看运行状态和排查问题变得繁琐。现有的插件管理方式缺乏直观的集中视图。dsh-plugin-runcat-inventory 旨在解决这一问题,它提供了一个统一的仪表盘,帮助开发者快速浏览、管理和维护 DSH 插件。

它是什么

这是一个由 runcat-tommy 维护的 DSH 插件。它提供了比原生列表更友好的表格视图、状态过滤、启用/停用开关(热生效)、卸载功能、更新提醒、配置查看与复制,以及中英双语界面自动切换。

核心功能

  • 表格视图:采用 4 列固定比例布局(名称 36% / 状态 15% / 来源 21% / 操作 28%)。
  • 状态与信息:显示“已启用/已停用”状态,并映射 Cordis 状态(如已挂载、等待依赖、加载中);描述和版本从各包 package.json 读取;来源显示仓库地址或安装方式。
  • 启用 / 停用(热生效):通过编辑 profile 的 cordis.patch.yml 实现,DSH 的 HMR 机制会自动应用更改,无需重启 Web UI。
  • 卸载:操作列提供“卸载”按钮和二次确认,从 profile 移除依赖与 bundle 层,重启 Web UI 后生效。
  • 更新提醒:检测 npm registry 的 latest 版本。本插件自身更新在面板顶部显示醒目卡片;其他插件在版本列显示 vX → vY 高亮。
  • 搜索与排序:支持关键字联合搜索(名称/id/描述/来源/版本),支持按配置顺序或名称排序。
  • 多语言:内置简体中文/English 双语,界面语言跟随 DSH 环境(设置 → 通用 → Language)自动切换。

安装与启用

在安装前,请确保已安装 Node.js、DSH CLI 和 pnpm(dsh plugin 命令依赖 pnpm)。

使用 npm 安装(推荐):

dsh plugin --profile web add dsh-plugin-runcat-inventory

安装完成后,重启 Web UI。进入 设置 → 逃咪-插件总览(英文环境显示 Runcat Plugin Overview)即可查看。

验证与使用

  • 验证安装:执行 dsh --profile web --dump-config,在输出末尾确认存在 id 为 runcat-inventory、name 为 dsh-plugin-runcat-inventory 的条目。
  • 启用 / 停用:编辑 ~/.dsh/profiles/web/cordis.patch.yml,添加或移除条目即可热生效。
  • 卸载:执行以下命令移除插件:
dsh plugin --profile web remove dsh-plugin-runcat-inventory

已知限制

  • 零依赖:本插件自身不依赖任何外部包。
  • JS 表达式冲突:若 cordis.patch.yml 中包含 !!js 表达式,启用/停用功能会提示失败。
  • 停用匹配逻辑:停用补丁时按 {id, name, disabled: true} 精确匹配移除;若与用户手写内容冲突,以“恰好三个键”的格式为准。

总结

dsh-plugin-runcat-inventory 通过表格化视图和热生效配置,简化了 DSH 插件的生命周期管理。对于需要频繁调试或管理大量插件的开发者,它能显著提升效率。

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

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

小夜