前言¶
DeepSeek Harness (DSH) 采用插件化架构,但在开发扩展功能时,开发者往往需要在 Core 代码中修改布局以适配侧边栏或底部面板。relay-dsh-plugin-workbench 插件提供了一个通用的 Workbench 容器,允许其他插件在不触碰 DSH 核心代码的情况下,注册和管理右侧与底部的面板视图。
插件定位¶
该插件由 yangbobo2021 维护,是一个扩展性的 Workbench Shell 插件。它为 DSH Web UI 提供了通用的面板区域和注册机制,确保了不同功能插件间布局的一致性。
核心能力¶
- 通用面板区域:提供右侧面板和底部面板的通用容器。
- 公开注册表:通过
ctx.workbench提供注册接口,供视图插件使用。 - 公开契约:在
relay-dsh-plugin-workbench/contracts导出公共契约。 - 幂等性:支持多次激活,多个功能插件可以安全地引入同一个 Workbench 布局。
安装与启用¶
安装前请确保已安装 DeepSeek Harness 0.1.2-rc.1 版本,并停止正在运行的 DSH Web 进程。
使用以下命令安装 Workbench 插件:
npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@0.2.2
安装完成后,重新启动 DSH Web:
npx @deepseek-ai/dsh@0.1.2-rc.1 web
典型用法¶
该插件本身不直接展示可见功能,它作为一个“壳”供其他插件使用。以下是几种典型使用场景:
- 独立测试 Shell:在开发过程中,单独安装此插件以验证侧边和底部面板的容器结构是否正常。
- 开发视图插件:开发新的 DSH 插件时,利用
ctx.workbench和 DSH 关键槽位注册视图。 - 开发环境依赖:在使用 GitHub 开发构建版的
relay-dsh-plugin-files或relay-dsh-plugin-terminal时,需要手动安装 Workbench,因为 DSH 的 pnpm Profile 会阻止 GitHub 包作为依赖传递。 - 功能插件集成:安装 Files 或 Terminal 插件后,Workbench 会自动承载这些插件注册的侧边或底部视图。
注意事项¶
- 权限与源码:DSH 处于开发者预览阶段,可能引入破坏兼容性的变更。
- 插件边界:功能插件应使用
ctx.workbench、关键 DSH 槽位以及公开契约入口,不应直接导入 Workbench 的源文件。 - 交互逻辑:安装 Workbench 后,如果未安装其他功能插件(如 Files 或 Terminal),界面布局不会发生变化。
- 修改前停止:在修改 Profile 插件列表之前,必须停止正在运行的 DSH Web 进程。
结语¶
该插件解决了 DSH 生态中面板布局共享的痛点,通过提供标准化的注册机制,降低了开发难度。更多细节与源码可参考下方链接。
- GitHub 仓库:https://github.com/yangbobo2021/relay-dsh-plugin-workbench
- 插件目录:https://www.skillhub.cn/plugins/yangbobo2021/relay-dsh-plugin-workbench