dsh-skill-mcp-panel（Fishquito7）把技能与 MCP 服务器的管理搬进 DSH Web 主页侧边栏：点左栏那行「Skill/MCP」，中央主区直接切到整页面板，不是弹窗也不是设置页里的 tab。站内分类 UI / 主题，星标 166★，MIT 许可；本站已于 dsh 0.2.0-rc.2 下真实安装成功（L4 · 真实安装）。同类插件的中文清单可对照 完整插件清单与汉化避坑指南，按症状定位的横向入口同样见 完整插件清单与汉化避坑指南。
排错前先分清坏的是哪一层：面板层（左栏那行Skill/MCP与中央主区页面）、插件树层（网关能否启动，由 TypertCodec 的create()契约决定）、CLI 层（dsh-panel命令）。关键判据是即使侧栏槽位缺失，插件树与 CLI 仍然可用——先跑dsh-panel skill list，能省掉一半排查。
坑一 · 侧栏那行入口整个消失了
现象。宿主升到0.2.0-rc.2后，左栏的「Skill/MCP」不见了，面板像被卸载一样整体消失。
原因。peer 上界在更早版本里写小了。evaluatePluginCompatibility在安装时与profile 启动时各校验一次，不满足就拒绝加载——宿主直接禁用整行，日志是dsh: disabling profile plugin row "skill-mcp-panel": ...。
解决。升到v2.1.3 及以后（上界已抬到<0.3.0-0）；临时救急用精确版本豁免：dsh plugin --profile web allow-version dsh-skill-mcp-panel@2.1.5 --dsh-version <宿主版本> --accept-risk。
坑二 · 网关起不来，日志里是 codec 抛错
现象。装完插件整个网关启动失败——不是面板打不开，而是根本不启动。
原因。自0.1.6-alpha.2起 strict codec 改为持schema工厂create()；仍写schema:的插件在注册阶段直接抛错，而插件树加载失败会拖垮整个网关（Issue #20）。
解决。用同时携带schema与create的版本——一份构建通吃两代宿主，仓库有test-codec.mjs守卫。
坑三 · bash 里说 dsh-panel: command not found
现象。Windows 上 CMD、PowerShell 都能跑dsh-panel，一到 Git Bash / MSYS2 / Cygwin 就说找不到命令。
原因。宿主写三份 shim：.cmd、.ps1与无扩展名的 sh 脚本，第三份正是 Git Bash 那类环境靠的，v2.1.5 之前缺这一份。
解决。升到 v2.1.5+。三份 shim 是全局单例，都指向「最后启动的那个 profile」装的副本。
坑四 · mcp 命令说 profile 不存在
现象。dsh-panel mcp list --profile web2被拒，或以为打错名字会自动建 profile。
原因。mcp子命令要求--profile名字必须已存在（判据$DSH_HOME/profiles/<name>/package.json），打错以退出码 2拒绝，不会像dsh plugin那样顺手新建。
解决。先dsh-panel profiles看清有哪些 profile；skill子命令不需要--profile，技能按用户根 / 工作区分家。
MCP 连不上，先看是谁在连接
配置没问题、dsh-panel mcp test也通，会话里却看不到工具。分工是——本插件只负责把配置写进 profile 的cordis.patch.yml受管块；真正连接并注册工具的是官方插件@deepseek-ai/dsh-mcp-client，由 DSH 的 HMR 自动加载，所以插件侧的排查范围只有「配置写入」这一层。另注意客户端 bundle 热更新刷新页面即可，服务端改动需重启网关。
版本兼容对照表
宿主版本 | ① 插件树加载 | ② 技能页图标 | ③ 侧栏面板槽位 |
| ✅ 读 schema | ✅ 旧名 | ⚠️ 未验证 |
| ✅ 读 create | ✅ 旧名 | ✅ |
| ✅ 读 create | ✅ 新名 | ✅ |
| ✅ 读 create | ✅ 新名 | ✅ |
上界必须写成<0.3.0-0——该校验带includePrerelease，<0.3.0会把0.3.0-rc.1放进来；下限0.1.5-rc.0只是「插件树还能加载」的边界，区间内不等于面板已验证。
安全扫描与安装
安全扫描（自动 · 静态分析 v2.7.0）结论是🔵 含敏感能力：可执行外部命令、读写 / 删除本地文件、读取剪贴板或密钥类环境变量、发起外部网络请求，共89 处证据（展示前 78 条），且尚无人工评估。这是能力清单，不是危险判定，也不等于无风险。安装走dsh plugin --profile web add dsh-skill-mcp-panel（另有 Release tarball 与 Git 两条路径），装完重启网关再刷新页面。
总结
四类症状对应四个层次：入口消失看 peer 区间与宿主禁用日志，网关不启动看 codec 的create()契约，命令找不到看 shim 是否齐全，mcp报 profile 不存在则是名字必须已存在。想对照同类插件的中文清单，见 完整插件清单与汉化避坑指南。
适合与不适合
适合：在 DSH Web 里同时管技能与 MCP 服务器、对技能做热启停与工作区迁移、习惯用命令行批量操作多个 profile。不适合：纯 TUI / 无头场景面板不可用；不装官方 mcp-client 就只想靠面板把工具跑起来；把「含敏感能力 89 处证据尚无人工评估」当安全背书。
标签：dsh-skill-mcp-panel、DeepSeek Harness、排错速查、DSH Web UI、MCP 配置
本文由 DeepSeek Harness Hub 自动整理，数据来源于插件详情页。
 管理文档渲染器注册表)