dsh_workspace_switch

dsh-workspace-switch

DeepSeek Harness 的按工作区启用控制： 每个工作区自行决定它的会话能用哪些插件、MCP 服务器与 Skills， 并通过工作区行菜单里的弹窗来配置。

English | 中文

它做什么

一个插件，两半：

• 宿主半（index.js，构建到 lib/index.js）在该工作区创建 Agent 时读取该工作区的配置， 并把配置应用到这个 Agent 自己的 Cordis 作用域，因此同一进程里两个工作区的两个 Agent 看到的能力可以不同：
  • 被禁用的 skill 会在该作用域被一个同名、不可调用的注册遮蔽，从模型的 skill 目录里消失；
  • 被禁用的 MCP 服务器，其 mcp__<serverName>__* 工具在该作用域被拒绝；
  • 被禁用的 插件，其条目里声明的工具名在该作用域被拒绝。 同一半还提供弹窗使用的配置路由。
• 浏览器半（src/client/，构建到 lib/client.js）在工作区行的 ... 菜单里加一项， 打开弹窗列出当前组合在各分类下提供的能力，每项一个开关。

没有任何条目的工作区完全继承部署原有的组合，因此在有人配置之前这个插件不改变任何行为。

配置

两个来源描述同一个工作区，后者优先：

1. <DSH_HOME>/workspace-switch.json，其 workspaces 映射以工作区目录为键；
2. <workspace>/.dsh/workspace-switch.json，存在时整体替换该工作区的共享条目。

{
  "workspaces": {
    "E:\\my_project\\godot-game": {
      "plugins": { "mcp-godot-ai": { "enabled": false, "tools": ["mcp__godot-ai__run"] } },
      "mcp": { "godot-ai": { "enabled": false } },
      "skills": { "godot-scene-authoring": { "enabled": false } }
    }
  }
}

enabled: false 表示在该工作区关闭；缺省即启用。插件条目还要声明该插件注册的工具名—— 门禁是按名字拒绝工具的，所以没有 tools 的插件条目没有可拒绝的东西。

弹窗写入当前对该工作区生效的那份文档：存在项目文件时写项目文件，否则写共享配置。 写入通过临时文件重命名发布，读方不会看到写了一半的文档。

安装

这是一个 DSH bundle：把它加进 profile 并选中。

dsh plugin add link:/path/to/dsh_workspace_switch

然后把 dsh-workspace-switch 加入该 profile 的 dsh.profile.bundles。新的 bundle 行在下次启动 harness 时加载。

构建

浏览器半是 DSH 客户端 bundle，必须构建；需要仓库工具链（本插件在 scripts/tsdown.client.ts 内联了自己的客户端构建预设副本，它会从所在检出目录解析 harness 源码）。

# 在 deepseek-harness 检出目录里
pnpm exec tsdown --config dsh_workspace_switch/tsdown.config.ts   # 或在插件目录里执行 pnpm build
pnpm exec tsc -p dsh_workspace_switch/tsconfig.typecheck.json     # 类型检查浏览器半
node --test "tests/**/*.test.js"                                  # 单元测试

lib/ 已提交进版本库。 包的 main 与 ./client 都指向它，而一份克隆里既没有 harness 源码也没有构建工具链， 否则「从源码安装」（dsh plugin add github:…）装到的包会没有任何入口文件。任何改动发布后请把重建的文件一并提交。

独立克隆无法执行构建：内联的预设会 import 只存在于检出目录里的 harness 源码（../../packages/…、../../scripts/…）。 请在检出目录里构建，再把 lib/ 提交到这里。

已知限制

• Skill 只是被门禁遮蔽，并未卸载 —— 文件仍在磁盘上，只是对该工作区从目录中移除且无法加载。
• 插件必须声明工具名 —— 门禁按名字拒绝工具，关闭插件只影响其条目 tools 里列出的名字。
• 弹窗列出的是宿主能寻址的东西 —— 插件行来自 profile 的插件管理器（或只读清单）； 组合里没有暴露的能力无法配置。

许可证

MIT。