前言¶
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。
- 将插件目录放到本机任意路径(示例:
F:\plugins\dsh-workspace-plugin-manager)。 - 用 CLI 或 Web GUI 以
link:形式安装。
CLI:
dsh plugin --profile <你的 profile> add link:<上面那个路径>
Web GUI:侧边栏「插件」→「添加插件」,填入 link:<路径> 后启用。
Host 半边首次安装后需重启一次插件行或重启 DSH,才会注册状态文件路由;之后若只改 client.js,刷新页面即可。插件以当前 DSH 进程权限运行,安装前应检查仓库源码与许可证。
典型用法¶
- 右击左侧任务栏里的工作区标题(或点 ⋯)。
- 选择「插件管理」。
- 首次打开时三选一:从空表开始、放进当前已启用的插件、或套用模板。
- 在左下角「未启用插件」中双击加入;在表里用工具栏管理文件夹与剪贴板。
- 点「保存并应用」,将表同步到实际插件状态。
数据文件路径示例:
<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 把「工区 ↔ 插件集合」落到一张可编辑、可备份的表上,并用切换提示、新插件黄条和重启说明减少误操作。更多介绍见社区目录页与仓库: