前言¶
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 插件的生命周期管理。对于需要频繁调试或管理大量插件的开发者,它能显著提升效率。