前言¶
DeepSeek Harness (DSH) 通过插件机制扩展功能。dsh-workspace-presets 是一个插件，旨在解决在不同工作区手动配置 Agent 预设的繁琐过程。它允许开发者将一个 Agent 预设与特定工作区绑定，该工作区下的新会话将自动应用该预设。
插件简介¶
- 名称: dsh-workspace-presets
- 核心功能: 每个工作区的 Agent 预设绑定
- 维护者: GBDJXB
- 许可证: MIT
- 兼容版本: DSH 0.1.5, 0.1.7, 0.2.0
核心功能¶
- 原生设置页面: 在 DSH 的设置面板中添加一个原生的“Workspace presets”页面，以表格形式展示工作区与预设的绑定关系。
- 自动应用: 当工作区存在绑定关系时，该工作区下的空白会话会自动应用绑定的预设。这包括侧边栏中为每个工作区维护的隐藏空白会话。
- 回退机制: 如果工作区没有绑定预设，或绑定不存在，系统会回退到 DSH 的默认行为（全局默认或启动页的选择器）。
- 会话隔离: 插件不会对已启动的会话、子代理会话或已归档的会话产生任何影响。
- 手动优先: 在空白会话上，手动选择芯片（Chip）的选择始终优先于自动绑定的预设。
安装与启用¶
在安装前，请确保 DSH 部署已包含 Agent 预设配置，且系统环境变量中包含 pnpm。
方式一：从 npm 安装¶
dsh plugin --profile web add dsh-workspace-presets
方式二：从 GitHub 安装¶
dsh plugin --profile web add github:GBDJXB/dsh-workspace-presets
方式三：从本地文件夹安装¶
- 克隆仓库：
git clone https://github.com/GBDJXB/dsh-workspace-presets.git
cd dsh-workspace-presets
- 安装依赖（本地安装必须执行此步）：
npm install
- 添加插件：
dsh plugin --profile web add .
安装完成后，重启 DSH 进程并刷新浏览器（Ctrl+Shift+R），在侧边栏底部的“设置”中即可找到“Workspace presets”页面。
兼容性与注意事项¶
- 版本要求: 插件支持 DSH 的 0.1.5、0.1.7 和 0.2.0 版本。0.1.7 版本需要将预设声明在 Composition 中，如遇预设缺失，需运行对应的镜像脚本。
- 本地安装依赖: 使用本地文件夹安装时，必须在仓库目录内先执行
npm install，否则启动时可能会报ERR_MODULE_NOT_FOUND错误。 - 生效范围: 绑定仅在空白会话上生效。已启动的会话、子代理会话和归档会话不受影响。在空白会话上手动选择 Agent 芯片会覆盖自动绑定的行为。
- DSH Desktop: Desktop 2.x 使用独立的 profile 安装插件，命令需指定
--profile desktop。
结语¶
dsh-workspace-presets 通过在设置层面提供可视化的预设绑定功能，降低了 DSH 在多工作区场景下的配置成本。安装并配置后，新会话的启动将变得确定且零延迟，无需额外模型调用成本。
详细信息请参考项目主页：
https://github.com/GBDJXB/dsh-workspace-presets
