dsh-skill-mcp-panel

dsh plugin --profile web add dsh-skill-mcp-panel

<div align="center">

dsh-skill-mcp-panel

在 DSH 侧边栏管理「技能」与「MCP」服务器，并附统一终端命令 dsh-panel






[简体中文](README.md) · [English](README.en.md)

</div>

---

DSH 插件：把技能与 MCP 服务器的管理搬进 DSH Web 的主页侧边栏——点左栏的「Skill / MCP」，中央主区直接切到整页面板（不是弹窗，也不是设置页里的 tab），改完即生效。随包附带统一终端命令 dsh-panel：面板能做的事命令行都能做，另外多一个跨 profile 升级。

• 🗂️ 技能管理 —— 列表预览、搜索、工作区分栏与分组筛选、卡片展开查看全文、热启停 / 删除，支持 .md / .zip / 技能文件夹的添加与批量迁移
• 🔌 MCP 服务器管理 —— 接管 profile cordis.patch.yml 里的每一条 MCP 服务器（表单 + 原文），Stdio / HTTP 两种调用方式，支持测试连接，保存后由 DSH HMR 热加载
• 🧩 整页面板 —— 与宿主内置「插件」页同一套槽位机制，点左栏即在中央主区切页，页面左上角另有「← 返回会话」
• ⌨️ dsh-panel 命令行 —— dsh-panel skill … 与 dsh-panel mcp … 覆盖两个面板的全部能力
• 📦 装上就能用 —— npm 与 Release tarball 安装的都是预构建产物

profile 提示：mcp 子命令必须显式写 --profile <name>，且名字必须已存在——打错会被拒绝，不会新建 profile。skill 不按 profile 分家（技能按用户根 / 工作区存放），不需要该参数。不带 --profile 的 dsh-panel update 升级全部已安装本插件的 profile（desktop 由桌面应用独占，自动跳过）。

目录：[界面预览](#界面预览) · [安装](#安装) · [功能](#功能) · [命令行](#命令行) · [工作原理](#工作原理) · [开发](#开发) · [卸载](#卸载) · [更新日志](#更新日志) · [链接](#链接) · [License](#license)

界面预览

面板入口在主页左侧栏「插件」下方（v2.1.0 起由设置页迁移到侧边栏），点「技能」/「MCP」即在中央主区打开；两个页面左上角都有「← 返回会话」，可直接回到进面板前那个会话。

<p align="center">

<img src="https://raw.githubusercontent.com/Fishquito7/dsh-skill-mcp-panel/main/docs/images/sidebar-entry.png" width="260" alt="DSH 主页侧边栏：插件 / Skill / MCP">

<br>_{入口 · 主页侧边栏中的「Skill / MCP」（v2.1.5 起两个面板合并为一行，标签固定用英文写法）}

</p>

<p align="center">

<img src="https://raw.githubusercontent.com/Fishquito7/dsh-skill-mcp-panel/main/docs/images/skills-panel.png" width="1000" alt="技能面板（三栏布局）：工作区 / 分组 / 内容三栏，搜索、全部启停、显示插件技能开关与技能卡片">

<br>_{技能面板 · 三栏布局（工作区 / 分组 / 内容）· 搜索 / 全部启停 / 显示插件技能开关}

</p>

<p align="center">

<img src="https://raw.githubusercontent.com/Fishquito7/dsh-skill-mcp-panel/main/docs/images/skills-panel-compact.png" width="1000" alt="技能面板（简洁布局）：收起左右两栏，工作区折叠成下拉、分组横排 chip、一行两个技能">

<br>_{技能面板 · 简洁布局（工具栏最右按钮切换）· 收起左右两栏 / 工作区折叠下拉 / 一行两个技能}

</p>

<p align="center">

<img src="https://raw.githubusercontent.com/Fishquito7/dsh-skill-mcp-panel/main/docs/images/skill-groups.png" width="1000" alt="分组编辑器：新建分组、选择工作区并批量勾选成员">

<br>_{技能分组 · 新建 / 重命名 / 批量勾选成员}

</p>

<p align="center">

<img src="https://raw.githubusercontent.com/Fishquito7/dsh-skill-mcp-panel/main/docs/images/skill-migrate.png" width="1000" alt="批量迁移技能：源工作区、多选目标工作区、复制或移动">

<br>_{批量迁移 · 源工作区 / 多选目标 / 复制或移动}

</p>

<p align="center">

<img src="https://raw.githubusercontent.com/Fishquito7/dsh-skill-mcp-panel/main/docs/images/mcp-panel.png" width="1000" alt="MCP 面板：注册机制说明、服务器卡片、工具数量、启停、测试连接与删除">

<br>_{MCP 面板 · 注册机制说明 / 服务器卡片 / 工具数 / 启停 / 测试连接}

</p>

<p align="center">

<img src="https://raw.githubusercontent.com/Fishquito7/dsh-skill-mcp-panel/main/docs/images/mcp-add-server.png" width="1000" alt="添加 MCP 服务器：STDIO 与 HTTP 两种调用方式">

<br>_{添加 MCP 服务器 · STDIO / HTTP 两种调用方式}

</p>

安装

1. 安装本包，二选一（桌面端用户请在内置插件安装器中输入'...add'后面的内容）：

方式一：GitHub Release tarball（推荐，恒定指向最新版）

   dsh plugin --profile web add https://github.com/Fishquito7/dsh-skill-mcp-panel/releases/latest/download/dsh-skill-mcp-panel.tgz

这是无版本号的稳定链接：每次发版都同时上传别名 dsh-skill-mcp-panel.tgz（恒定指向最新版）与带版本号的

dsh-skill-mcp-panel-<版本>.tgz，所以这条命令不随版本改。需要锁定具体版本时，把 latest/download/dsh-skill-mcp-panel.tgz

换成 download/v<版本>/dsh-skill-mcp-panel-<版本>.tgz 即可。

方式二：npm（预构建，插件市场同款通道）

   dsh plugin --profile web add dsh-skill-mcp-panel

> 两种方式都安装预构建产物，无需本地构建。也可以从 Git 安装（Git 来源的依赖默认禁止运行 prepare 构建脚本；若报

> git-hosted plugins build on install...，把 pnpm 在上面打印的 key 加到 profile 目录 pnpm-workspace.yaml

> 的 allowBuilds 下再重跑）：

>

> ```bash

> dsh plugin --profile web add github:Fishquito7/dsh-skill-mcp-panel

> ```

2. 重启网关

重启后刷新页面：左侧栏「插件」下面就是合并后的「Skill / MCP」一行——点它把中央主区切成面板，面板内部再用页签切换「技能」与「MCP」。

功能

面板和宿主自带的「插件」页是同一套机制：左栏一行「Skill / MCP」，点它把中央主区切过去——不是设置页的 tab，也不是弹窗。面板内用页签切换「技能」与「MCP」，并记住你上次停在哪一页；左上角「← 返回会话」随时退回进面板前的会话。

技能面板

• 列表与卡片 —— 按名称搜索，点开卡片看全文；按工作区（全局 / 各工作区）分栏，可按分组或按来源筛选
• 启停与删除 —— 开关热生效（改的是磁盘上的 SKILL.md），删除可撤销；插件自带的技能可一键隐藏
• 添加 —— 点「+」或直接把文件 / 压缩包 / 技能文件夹拖进页面：.md、.zip、整个文件夹都认，含多个技能的文件夹一次导入；不合法、目标作用域内重名的逐条跳过并说明原因
• 迁移 —— 批量复制或移动到多个工作区，单条失败不影响其余
• 分组 —— 新建 / 重命名 / 删除、批量勾选成员；只写插件自己的显示配置，不动技能目录

MCP 面板

• 服务器管理 —— 支持 Stdio 与 HTTP 两种方式：新增、编辑、启停、删除、测试连接；保存后由 DSH HMR 热加载，不用重启网关。文件里每一条 @deepseek-ai/dsh-mcp-client 都能操作（不区分受管块内外，也不看 id 前缀）。表单改常规项并保留还没做成表单的字段；原文按字节改这一条。非 MCP 的行（含块内别人的条目）仍然逐字节保留
• 密钥 —— env / headers 在页面与 RPC 里脱敏，编辑时留空即保留旧值；值里写 ${NAME} 就是读该环境变量
• 单工具禁用 —— 按工具名关掉其中一部分，被禁的工具会从模型看到的工具表里消失（不是调用时才拒绝），上下文立刻省下来
• OAuth 登录 —— 远程 streamable-http 服务器支持时一键登录（按 RFC 8414 / OIDC / RFC 9728 逐级发现授权服务器，兼容带路径端点；动态注册客户端、授权码 + PKCE + RFC 8707 resource），令牌写回该行配置并热加载；可随时断开

DSH 版本兼容

只支持 DSH 0.2.x（peer 声明 >=0.2.0-rc.1 <0.3.0-0）。DSH 会在安装时和 profile 启动时校验这条声明，不满足就拒绝加载并打印精确豁免命令——不会静默崩。上界写成 <0.3.0-0 是因为该校验带 includePrerelease，<0.3.0 会把 0.3.0-rc.1 也放进来。

确需在老宿主上使用，用宿主打印的精确版本豁免：

dsh plugin --profile web allow-version dsh-skill-mcp-panel@2.3.7 --dsh-version <宿主版本> --accept-risk

命令行

统一父命

…(truncated)