u9521/dsh-session-settings

dsh-session-settings

DeepSeek Harness (DSH) Web GUI 会话设置、MCP 服务器与 Skill（技能）管理插件。

支持在 Web 界面中为各个会话独立或全局统一配置：
1. 子代理模型与思考等级：包含 subagent、subagent_fork、workflow 等调用的底层模型（Provider / Model）与推理思考等级（Reasoning Effort）。
2. MCP 服务器集中管理：在设置左侧栏独立管理 Model Context Protocol (MCP) 服务器，支持 2 阶段兼容性探测、自动协议降级接入、工具列表查看与入参检查。
3. 会话级 MCP 工具细粒度控制：为特定会话按需启用/禁用 MCP 服务及单独禁用指定工具，或选择跟随全局默认。
4. 会话级 Skill（技能）启停与管控：支持为各个会话单独启用/禁用内置、用户及项目 Skill，自动过滤提示词  目录与快捷指令，严格阻断已禁用技能的执行。

界面预览

1. 会话独立设置（模型 / MCP 工具 / 技能）
会话独立设置

2. MCP 服务器集中管理
MCP 服务器集中管理

3. 技能管理与独立规则详情
技能管理与独立规则详情

目录

- 功能特性
- 界面预览
- 主线兼容说明
- 插件安装
- 🚀 一行命令安装（推荐）
- 从源码安装教程（开发者）
- 插件更新与升级
- 方式 1：在线安装更新（推荐）
- 方式 2：本地源码升级（开发者）
- 插件卸载
- 常用开发与维护命令
- 常见问题 (FAQ)
- 开源协议

功能特性

- 设置侧边栏独立入口：位于 Web 界面「设置」左侧导航栏一级菜单（专属图标），一键直达 MCP 服务器与技能集中管理。
- 会话独立 Tab 标签页：位于会话详情页右侧顶部（轨迹旁），方便针对当前会话进行模型、MCP 与技能隔离配置。
- 三层模式按需切换：
- 使用全局默认：当前会话不作覆盖，直接沿用全局统一规则。
- 跟随当前会话：子代理无条件继承父会话选用的模型与思考等级。
- 自定义配置：为当前会话单独指定子代理模型、可用 MCP 服务及单独禁用指定工具或技能。
- 即时动态生效：配置保存后对下一次子代理调用、MCP 工具执行及技能调用立即生效，无需重启服务或刷新页面。

主线兼容说明

| 插件分支 | 兼容的 DeepSeek Harness (DSH) 主线版本 | 架构与机制支持 |
| :--- | :--- | :--- |
| main 分支 | >= 0.1.5-rc.1 | 原生对齐 Session Format V3、Cordis 4.0.2 响应式框架、全新 subagent/descriptor 会话契约与 SystemPromptProjection 动态提示词组装机制。 |

⚠️ 注意：本插件的 main 分支已针对 DSH 0.1.5-rc.1 及以上主线版本进行原生对齐，移除了旧版格式补丁，不再向下兼容 DSH ≤ 0.1.2 的旧版本。请确保运行环境的 DSH 已升级至最新主线版本。

插件安装

🚀 一行命令安装（推荐）

本仓库已配置 GitHub Actions 自动构建最小发布分支（dist 分支包含完整编译产物与元数据，无多余源码与依赖）。

直接运行以下命令即可一行安装，无需本地编译：

dsh plugin --profile web add github:u9521/dsh-session-settings#dist

提示：安装完成后，启动或重启 Web 服务即可生效：
dsh web

从源码安装教程（开发者）

第 1 步：获取源码

将插件代码克隆到本地：

mkdir -p ~/.dsh/plugins
cd ~/.dsh/plugins

git clone https://github.com/u9521/dsh-session-settings.git
cd dsh-session-settings

第 2 步：安装依赖与构建

pnpm install
pnpm run build

第 3 步：安装到 DSH Web Profile

dsh plugin --profile web add .

验证安装状态
列出 Web Profile 中的已安装插件，确认包含 @local/dsh-session-settings：

dsh plugin --profile web list

第 4 步：启动并验证

dsh web

插件更新与升级

方式 1：在线安装更新（推荐）

若通过 GitHub dist 分支一行命令安装，可直接使用 dsh plugin --profile web update 更新至最新发布：

dsh plugin --profile web update github:u9521/dsh-session-settings#dist

提示：更新完成后，启动或重启 Web 服务即可生效：
dsh web

方式 2：本地源码升级（开发者）

若从本地源码克隆安装，请拉取 main 分支最新提交并重新构建：

第 1 步：进入插件源码目录
cd ~/.dsh/plugins/dsh-session-settings

第 2 步：拉取 main 分支最新代码
git pull origin main

第 3 步：更新依赖并重新编译生成产物
pnpm install
pnpm run build

第 4 步：重启 Web 服务生效
dsh web

插件卸载

若需停用并彻底移除本插件，可使用 DSH CLI 从 web profile 中移除：

dsh plugin --profile web remove @local/dsh-session-settings

提示：若安装时使用的是 github 别名源形式，亦可执行：
dsh plugin --profile web remove github:u9521/dsh-session-settings#dist

卸载完成后，启动或重启 dsh web 即可恢复 DSH 默认原生界面。

常用开发与维护命令

| 命令 | 描述 |
| :--- | :--- |
| pnpm run build | 完整构建（TypeScript 类型检查 + 生成 lib/ 构建产物） |
| pnpm run check | 仅执行类型检查（tsc --noEmit），不生成文件 |
| pnpm run fmt | 使用 Prettier 自动格式化源码与配置文件 |
| pnpm run fmt:check | 检查代码格式规范 |

常见问题 (FAQ)

Q1: 修改会话配置或禁用工具/技能后，需要重启 dsh web 吗？
A: 不需要。插件在宿主端挂载了实时请求拦截器与动态规则注入机制，保存后后端即时更新并生效。

Q2: 如何卸载或移除本插件？
A: 请参考 插件卸载 章节，使用 dsh plugin --profile web remove 命令从对应 profile 中移除即可。

开源协议

本项目基于 MIT License 授权开源。