前言¶
DSH 的理念是「一切皆插件」。装得多了之后,几个问题会逐渐浮现:某个插件为什么没生效,时候还兼容当前 DSH 版本,哪个插件最近根本没人用、却一直占着进程,某个插件到底花掉多少 Token。DeepSeek Harness 自带的插件管理器能装能卸,但不会给健康状态、兼容性、使用频率和成本提示。
dsh-plugin-supervisor 补的就是这一栏:把这些信息收进一个侧栏面板,并支持在页面内完成更新、禁用、卸载和版本回滚。
这是什么¶
dsh-plugin-supervisor 是一个 DeepSeek Harness 插件,仓库位于 2033453490/dsh-plugin-supervisor,包名 dsh-plugin-supervisor,当前版本 1.0.0,许可证 MIT,README 署名作者为 CYKshaozi。它面向装了多个插件的 DSH Desktop 用户,用一个面板集中回答「插件现在是什么状态、能不能更新、值多少钱」。
它在目录页的分类是 admin-security,属于管理与安全侧的插件。
核心功能¶
下面列出的是 README 中明确写到的能力。
健康状态与冲突提示¶
- 汇总插件行是否激活、是否被禁用、是否激活失败。
- 检测重复工具名、激活失败、版本不兼容,以及同分类功能重叠的插件。
DSH 兼容性¶
按包声明的 engines.dsh / peerDependencies 与当前 DSH 版本比对,判断是否兼容;没有声明的插件标记为未知。更新建议会对比 npm 最新版和兼容版,避免把不支持当前 DSH 的版本装进来。
使用频率与 Token 成本¶
- 使用频率从本机会话日志统计工具调用次数、会话数和最后使用时间;没有工具的界面型插件标记为「不可观测」。
- Token 成本按工具结果内容与工具 Schema 的常驻开销估算,逐插件给出;可以填写费率折算成金额。
版本备份与页内操作¶
- 更新前自动备份旧包,插件行和详情页都能查看、恢复、删除历史版本。
- 更新、禁用、卸载、恢复都在页面内完成,不需要跳转插件市场。
插件市场¶
读取 awesome-dsh-plugin 公共索引,展示周下载榜、新锐插件和新收录,并支持页内安装。注意这是社区目录,与 DeepSeek / 幻方没有官方从属关系。
安装与启用¶
从 npm 安装(发布后可用):
dsh plugin --profile desktop add dsh-plugin-supervisor
从 GitHub 安装:
dsh plugin --profile desktop add github:2033453490/dsh-plugin-supervisor
本地源码方式:
git clone https://github.com/2033453490/dsh-plugin-supervisor.git
dsh plugin --profile desktop add ./dsh-plugin-supervisor
安装后左侧栏会出现盾牌图标。Host 端 HTTP 前缀为 /__plugin-supervisor/api/。
这里有一处容易踩:改动 index.js(Host 端)之后,需要在插件管理器里禁用再启用本插件才会加载新模块;改 client.js 则刷新页面即可。
典型用法¶
1、打开左侧栏盾牌图标进入监管面板,先看一遍健康状态和冲突提示,处理激活失败和重复工具名。
2、每个插件行查看兼容性与更新建议,对标注「未知」的插件回到包声明里确认 engines.dsh。
3、对未使用的插件先禁用观察一段时间,确认不再需要再卸载,卸载前可先看版本历史。
4、更新前确认自动备份已覆盖目标插件,更新后如行为异常,在历史版本里恢复。
5、需要折算成本时,在面板中填写费率,查看逐插件 Token 估算。
数据与隐私¶
插件只读取本机数据:插件清单、node_modules 中的包声明、~/.dsh 下的会话日志。只写入本机,设置与版本备份位于 ~/.dsh/plugin-supervisor/。
网络请求仅用于查询 npm registry 和 https://awesome-dsh-plugin.com/plugins.json,不会上传插件清单、会话内容或使用数据。更新、卸载、恢复等操作由本机 DSH 插件管理器执行,执行前会在页面内确认。
环境要求¶
- DeepSeek Harness Desktop,带 Web UI。
- 在 DSH
0.2.1-rc.5上完成开发与实测。 - Node.js >= 20(Host 端)。
适用场景与注意¶
适合装了多个插件、需要长期维护插件列表的 DSH Desktop 用户和插件开发者。它以当前 DSH 进程的权限运行,更新、禁用、卸载直接调用本机插件管理器,因此安装前应先检查源码与许可证。本插件自身采用 MIT 许可证,脚本无构建步骤,纯 ESM,index.js 负责 Host 端数据采集、HTTP 路由和插件操作,client.js 负责侧栏面板 UI。
目录页:https://www.skillhub.cn/plugins/2033453490/dsh-plugin-supervisor
GitHub:https://github.com/2033453490/dsh-plugin-supervisor