前言¶
在 DSH Web 插件中，MCP 服务器和 Skill 目录会影响模型可见的工具集合，也会带来上下文占用。lilyblessing/dsh-mcp-skill-panel 把这两类对象放进设置页面板，用于查看、启停和按需恢复，并提供可选 AI 中间层，让停用的 MCP 通过 mcp_search / mcp_call 被模型按需使用。
这是什么¶
该插件是 DSH Web 插件，仓库 owner 为 lilyblessing，资料版本为 0.5.3，npm latest 为 0.5.3，许可证为 MIT。它解决的是 MCP 与 Skill 启停不直观、上下文占用难以临时释放的问题。
核心功能¶
MCP 管理¶
- MCP 实时启停。
- 工具级禁用。
- 停用态回填。
- 粘贴
mcpServersJSON 快速迁移添加。 - 项目级 MCP，读取工作空间
.dsh/mcps/**/mcp.json，仅该项目工作空间的会话可见。 - 启停意图重启保持，持久化路径为
~/.dsh/dsh-mcp-skill-panel/state.json，catalog快照用于重启后回填。
Skill 管理¶
- Skill 启停。
- 创建技能：填写名称、描述、指令，可选上传
SKILL.md预填。 - 手动管理：编辑
SKILL.mdfrontmatter 中的disable-model-invocation。
AI 中间层¶
- 可选开关为
autoManage。 - 开启后，停用的 MCP 由模型通过
mcp_search/mcp_call按需调用。 - 用户手动打开的 MCP 永不被自动关闭；回收器只回收 AI 从停用态临时启用的 server。
生效时机¶
- 手动开关可选立即生效或下次会话生效。
- 立即生效会使下一轮前缀 KV-Cache 100% 失效，该轮按 miss 费率计费，约为 hit 的 5 ~ 12.5 倍。
- 下次会话生效零缓存失效、零额外费用。
- 必要时可点击立即应用待生效变更按钮强制生效。
安装与启用¶
下面命令用于安装 git 源插件：
dsh plugin --profile web add "github:lilyblessing/dsh-mcp-skill-panel#main"
安装后需重启 dsh web，热更新无效。重启后进入设置页，使用 MCP 与技能管理面板。
如果从 npm 包名 dsh-mcp-skill-panel 安装或升级：
pnpm add dsh-mcp-skill-panel@latest
如果升级 git 源安装：
pnpm update dsh-mcp-skill-panel
典型用法¶
1、在设置页进入 MCP 与技能管理面板。
2、在 MCP 服务器标签页启停服务器，或展开工具列表逐个禁用。
3、在技能标签页启停技能，或创建技能时填写名称、描述、指令，并可选上传 SKILL.md 预填。
4、开启 AI 中间层开关后，停用的 MCP 由模型通过 mcp_search / mcp_call 按需调用。
5、为手动开关选择立即生效或下次会话生效；必要时点击立即应用待生效变更。
6、在 MCP 页添加 MCP：粘贴其它 harness 的 mcpServers JSON，预览后选择全局或项目添加。
7、手动管理：直接编辑预设组合文件中的 disabled 行，或编辑 SKILL.md frontmatter 的 disable-model-invocation。
鉴权与面板行为¶
写操作鉴权从 0.4.7 版本开始要求 POST 请求携带令牌头：
x-panel-token: <token>
未携带时返回 401。GET 只读端点保持开放。
面板采用乐观更新与事件驱动失效，界面支持双语，插件自身零上下文占用。
适用场景与注意¶
适合需要在 DSH Web 插件中集中管理 MCP 服务器与 Skill、控制上下文占用、并按需启用工具的开发者。
该插件以当前 dsh 进程权限运行。安装前应检查源码与 MIT 许可证。使用手动开关时，需要理解立即生效与下次会话生效在 KV-Cache 费用上的差异。
获取¶
GitHub 仓库：
https://github.com/lilyblessing/dsh-mcp-skill-panel
