前言¶
DeepSeek Harness 的设计理念是「一切皆插件」。在扩展能力时,手动编辑配置文件管理第三方插件容易出错。dsh-plugin-manager-lite 是一个静态 bundle 插件,通过 Web GUI 的「设置 -> 插件 -> 第三方插件」页面,提供对第三方插件的统一管理入口,支持列表查看、启用/停用、卸载以及检查更新。
核心功能¶
该插件主要解决第三方插件分散管理的问题,提供以下能力:
- 列表与过滤:自动读取
package.json,展示非官方(非@deepseek-ai/*)插件的名称、版本、作者及描述,并标注来源类型(本地安装 / npm)。 - 启用与停用:支持热切换插件运行状态。停用状态会持久化写入
~/.dsh/cordis.patch.yml,重启 DSH 后依然生效。 - 卸载:执行停用操作,并从 profile 配置中移除依赖。
- 更新管理:对比 npm registry 检查更新,支持一键安装/升级到最新版本(仅限 npm 安装的插件,本地
file:安装的插件不支持)。 - 调试:提供
/tppm/debug排错端点,可查看列表数据源的各环节实际值。
前置要求¶
- DeepSeek Harness (DSH):版本 0.1.0-rc.7 或更高(需为 developer preview)。
- Node.js:版本 >= 18。
- Peer Dependency:
@deepseek-ai/cordis^4.0.1。
安装¶
使用 dsh plugin 命令安装,该命令会自动处理 profile 依赖的添加:
dsh plugin --profile web add github:ShanHaiFish/dsh-plugin-manager-lite
安装完成后,Host 会从 ~/.dsh/profiles/web/node_modules/dsh-plugin-manager-lite/ 加载该插件。
使用方法¶
- 重启 DSH:确保新插件生效。
- 进入界面:打开浏览器,进入 Web GUI -> 设置 -> 插件 -> 第三方插件。
- 操作插件:
- 点击「刷新」重新拉取插件列表。
- 点击「启用」或「停用」切换插件运行状态。
- 点击「检查更新」或「卸载」执行相应操作。
- 操作成功后列表会自动刷新。
开发与注意事项¶
- 同步机制:Host 实际加载的是 profile 目录下的副本(
~/.dsh/profiles/web/node_modules/dsh-plugin-manager-lite/)。如果在开发期修改源码,必须将改动同步到该副本再重启 DSH 才能生效。 - 调试:遇到问题时,可访问调试端点
/tppm/debug获取诊断信息。 - 许可证:本项目采用 MIT 许可证。