前言¶
DeepSeek Harness (DSH) 采用插件化架构，支持通过 Web GUI 进行配置。在使用过程中，针对特定会话调整子代理模型、MCP 工具或技能的行为，往往需要修改配置文件或重启服务。dsh-session-settings 插件提供了在 Web 界面直接管理这些会话级配置的能力，实现了无需重启的实时生效。
插件定位¶
这是一个为 DeepSeek Harness (DSH) Web GUI 设计的插件，由 u9521 维护，基于 MIT License。它通过 Web 界面提供会话设置、MCP 服务器和技能的集中管理功能，允许用户在全局默认、父会话继承和会话自定义之间灵活切换。
核心功能¶
该插件主要包含以下能力：
- 侧边栏导航入口：在设置导航侧边栏中增加顶层入口，用于集中管理 MCP 服务器和技能。
- 会话专用标签页：在对话视图中新增专用标签页，用于配置当前会话的子代理模型、MCP 工具和技能。
- 灵活的模式切换：支持三种模式。
- 使用全局默认：自动继承全局默认规则。
- 跟随父会话：继承父会话的模型和推理努力程度。
- 会话自定义：为当前会话指定自定义模型、可用 MCP 服务器以及具体的工具/技能禁用规则。
- 即时生效：通过运行时请求拦截和按需 MCP 客户端生命周期管理，修改配置后无需重启 DSH 即可生效。
- 集中式 MCP 服务器管理：提供侧边栏导航，支持 MCP 服务器的两阶段兼容性探测、自动协议降级和工具模式检查。
- 会话级 MCP 工具控制：可以独立控制每个会话的 MCP 服务器启用状态及具体工具的启用/禁用。
- 会话级技能管理：可以独立启用或禁用每个会话的内置、用户和项目技能，并支持动态提示目录过滤。
安装与启用¶
通过 DSH CLI 安装插件。
dsh plugin --profile web add github:u9521/dsh-session-settings#dist
安装完成后，启动或重启 Web 服务以加载插件。
dsh web
常用操作¶
更新插件
如果已通过上述命令安装，可以使用 update 命令更新到最新版本。
dsh plugin --profile web update github:u9521/dsh-session-settings#dist
卸载插件
移除插件以恢复到默认配置。
dsh plugin --profile web remove github:u9521/dsh-session-settings#dist
环境要求¶
该插件对 DSH 主线版本和运行环境有特定要求。
- DSH 版本：目标版本为
>= 0.1.5-rc.1，原生支持 Session Format V3 和 Cordis 4.0.2。不支持 DSH<= 0.1.2。 - Node.js 版本：要求
^22.19 || >=24。
开发与维护¶
若需从源码构建或维护插件，可参考以下命令。
pnpm install
pnpm run build
注意事项¶
- 插件以当前 DSH 进程的权限运行，修改配置涉及系统级操作，请在安装前检查源码与许可证。
- 更新会话设置或禁用工具/技能后无需重启服务，修改将在下一条请求中立即生效。
结尾¶
dsh-session-settings 为 DSH 用户提供了细粒度的会话控制能力，通过 Web 界面简化了模型路由、MCP 协议和技能调度的配置流程。更多细节可查阅其 GitHub 仓库。
