DSH 工作区插件管理:按工作区维护独立插件表

前言

DeepSeek Harness(DSH)里插件通常在整次会话或进程层面启用。不同工作区如果承担不同任务——例如一个专做前端、一个挂 MCP 工具链——往往要在设置里反复开关同一批插件,或靠记忆维持「当前工区该用谁」。社区插件 dsh-workspace-plugin-manager(维护者 Oreo2408,分类为客户端)给每个工作区维护一张自己的插件表:切换工作区时按表挂载或卸载,界面类似常见 mod 管理器的浮窗表格。下面按定位、功能、安装与用法说明,事实以 GitHub README 为准。

这是什么

一句话:为 DSH 的每个工作区单独配置一套插件集合;切换工作区时应用对应表,而不是全局一套配置打到底。

状态保存在本机 profile 目录下的 workspace-plugin-manager.json,刷新、重启或换窗口后不丢。插件在 SkillHub 等社区目录中归类为客户端,与 DeepSeek / 幻方无官方从属关系,安装前宜自行查看源码与 MIT 许可证。

核心功能

入口在左侧工作区标题:右击或点「⋯」→「插件管理」,菜单里会显示当前工区的 开/总数。

浮窗与表格

  • 窗口可拖动、可缩放,位置和大小会记住。
  • 主表列出本工作区要用的插件;左下角「未启用插件」池中的项双击即可加入表。
  • 支持文件夹:新建、重命名、删除、整组开关;工具栏支持剪切、复制、粘贴、删除,剪切/复制可跨工作区使用。

提示与同步

  • 新装插件后首次进入某工作区,顶部黄条可询问:加入本工作区、加入所有工作区、或加入指定文件夹;可折叠或忽略。
  • 表与当前实际插件状态不一致时,切换工作区会弹窗询问「应用」或「这次不换」;若其他工区任务在跑,则改为顶部黄条(按钮约 2 秒冷却,可在设置里关闭)。
  • 某插件返回 restart-required 时弹窗说明;设置页可预览该类提示。

模板、备份与依赖

  • 可将某工区的表设为模板;支持导出 / 导入 JSON。
  • 可标记插件 A 依赖 B:删除 B 时提醒;应用时缺依赖会有黄色提示。
  • 描述优先用插件市场里写过的备注,否则用插件自带说明。

存储与宿主

  • Host 侧提供 GET/PUT /dsh-workspace-plugin-manager/state,仅接受本机回环请求,原子写入状态文件;客户端逻辑在 client.js,通过 window.__ModuleLoader__.load 加载。

安装与启用

需要 DSH 0.2.2-rc.1 或更新(package.json 中 dsh.engines.dsh 为 >=0.2.2-rc.1)。README 给出的安装方式为本地路径链接,而非从名称拼接 github:owner/repo。

  1. 将插件目录放到本机任意路径(示例:F:\plugins\dsh-workspace-plugin-manager)。
  2. 用 CLI 或 Web GUI 以 link: 形式安装。

CLI:

dsh plugin --profile <你的 profile> add link:<上面那个路径>

Web GUI:侧边栏「插件」→「添加插件」,填入 link:<路径> 后启用。

Host 半边首次安装后需重启一次插件行或重启 DSH,才会注册状态文件路由;之后若只改 client.js,刷新页面即可。插件以当前 DSH 进程权限运行,安装前应检查仓库源码与许可证。

典型用法

  1. 右击左侧任务栏里的工作区标题(或点 ⋯)。
  2. 选择「插件管理」。
  3. 首次打开时三选一:从空表开始、放进当前已启用的插件、或套用模板。
  4. 在左下角「未启用插件」中双击加入;在表里用工具栏管理文件夹与剪贴板。
  5. 点「保存并应用」,将表同步到实际插件状态。

数据文件路径示例:

<DSH profile 目录>/workspace-plugin-manager.json

Windows 下类似:%USERPROFILE%\.dsh\profiles\<profile>\workspace-plugin-manager.json。

适用场景与注意

适合谁

  • 同一 DSH 实例里开多个工作区,且各工区希望固定不同的插件组合(UI 增强、MCP、locale 等)。
  • 需要跨工区复制插件布局,或用 JSON 备份 / 模板复用工区配置。

已知限制(README 原文)

  • 插件树在整个 Host 进程一份,同一时刻只有一套插件实际生效;同时打开两个不同工作区的会话时,它们共用当前这套。
  • 切换工作区会实时卸载/挂载插件,MCP 会重连,通常耗时数秒。
  • 多数开关依赖 HMR 即时生效;仅当插件管理器返回 restart-required 时才需要重启。
  • 目前在 Windows + DSH Desktop 上验证;其他环境行为以自行测试为准。

结尾

dsh-workspace-plugin-manager 把「工区 ↔ 插件集合」落到一张可编辑、可备份的表上,并用切换提示、新插件黄条和重启说明减少误操作。更多介绍见社区目录页与仓库:

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

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

Xiaoye