前言¶
在 DSH、Claude Code、Codex、Cursor 等 agent 工具之间切换时,Skill 包(SKILL.md)和 MCP 服务器往往分散在各自的用户目录与配置文件里:~/.claude.json、~/.codex/config.toml、~/.cursor/mcp.json、DSH profile 的 cordis.patch.yml 等。增删改、跨工具同步、启停 MCP、做连接检查,通常只能逐个文件手工复制粘贴。下面介绍社区插件 dsh-mcp-skill-manage,它把上述能力收拢到 DSH Web 界面左侧栏的一个页面里。
这是什么¶
dsh-mcp-skill-manage(npm 包名同插件 id)是 DeepSeek Harness (DSH) 的 Web 插件,由维护者 sunChargedd 发布,许可证 MIT。插件在侧边栏提供「MCP 与技能」入口(id:mcp-skill-manager),在同一界面管理:
- Skills:
SKILL.md的增删改查、正文编辑、跨工具符号链接共享、导入导出与备份恢复; - MCP Servers:stdio / HTTP(SSE) 配置的增删改查、启停、跨工具复制、连接体检与备份恢复。
README 描述的目标工具包括 DSH、Claude Code、Codex、Cursor、Windsurf、Qoder、Trae、通义灵码、CodeBuddy、Qwen Code、iFlow、Kimi、OpenCode、Cline/Roo/Kilo 等;具体路径以插件检测到的文件为准,也可在设置里用「自定义位置」接入。
核心功能¶
Skills¶
- 卡片网格:搜索、按工具过滤;进入详情页编辑 frontmatter(
name、description、whenToUse、metadata等)与 Markdown 正文;支持目录式<name>/SKILL.md与扁平<name>.md。 - 工具栏「搜索正文」可对
SKILL.md全文检索,卡片展示命中片段与次数。 - 多选后批量「共享到某个根目录 / 导出 zip / 删除」;新建时可选用空白、代码审查、文档撰写、问题排查等模板。
- 跨工具共享:勾选目标工具后创建相对符号链接,单一主副本(与
~/.claude/skills -> ~/.agents/skills一类做法一致);重命名时维护已有链接。 - 导入 / 导出:zip 保留
references/、scripts/等;重名自动避让,不覆盖。非法 frontmatter、坏符号链接会标记为无效项。
MCP¶
- 表格展示服务器、传输方式、命令或 URL、目标与状态;行内启停、删除、打开配置位置、测试连接。
- 快速模板:Context7、Filesystem、GitHub、SQLite、Playwright 等;支持 stdio(command/args/env/cwd)与 HTTP/SSE(url/headers)。
- 跨工具复制:一键复制到其他工具配置,同名已存在则跳过。
- 连接体检:执行 MCP 握手,显示工具数量、延迟、失败原因等;写配置前备份、原子写入,解析失败拒绝覆盖。
- env/headers 默认打码,需点「显示内容」才展开。
市场、备份与其它¶
- 市场标签页:Skills 索引来自 skills.sh,MCP 来自 Model Context Protocol Registry;搜索后可安装到选定 skill 根目录或 MCP 配置;registry 不可用时会回退内置常用服务器列表。可选设置环境变量
GITHUB_TOKEN提高 GitHub API 速率限制。 - 备份:删除 skill 或改动 MCP 前自动快照,保留最近 80 份;备份页可按时间恢复。
- 项目管理:添加项目路径后纳入项目级 skill / MCP;诊断汇总非法 skill、坏链接、同名冲突等。
- Agent 侧注册工具
mcp_skill_manager(如list_skills、save_skill、market_install_mcp、mcp_health、doctor等),与页面共用同一套 Host 逻辑。
共享 hub 的 Skills 根目录为 ~/.agents/skills;DSH 为 ~/.dsh/skills 与当前 profile 的 cordis.patch.yml;Cursor 为 ~/.cursor/skills 与 ~/.cursor/mcp.json。完整路径表见 GitHub README。
安装与启用¶
npm 包 dsh-mcp-skill-manage 当前版本为 0.5.5。推荐安装方式:
dsh plugin add dsh-mcp-skill-manage@0.5.5
或在 DSH 内使用 plugin_manager:
plugin_manager action=install_bundle target=dsh-mcp-skill-manage@0.5.5
安装后刷新 Web 页面,左侧栏出现插头图标「MCP 与技能」。
兼容性(以 README 为准):
| 项 | 要求 |
|---|---|
| DSH | >=0.2.1-rc.3 <0.3.0(实机验证版本含 DSH Desktop / @deepseek-ai/dsh-app-boot 0.2.1-rc.3) |
| Node.js | >=20 |
| 平台 | 实机验证 macOS;CI 在 Linux |
版本不满足时 DSH 会阻止加载并提示;请勿在 DSH 0.3 上直接安装当前版本。手动接入可在 profile 的 cordis.patch.yml 中插入 id 为 mcp-skill-manager 的插件条目,并确保包可被 profile 解析。
典型用法¶
- 打开 DSH Web,左侧栏进入「MCP 与技能」。
- Skills:搜索或按工具过滤;点卡片编辑;需要多工具共用时在详情或批量操作中勾选目标工具建立符号链接。
- MCP:表格内启停;点「测试连接」做体检;需要新 server 时可用快速模板或「市场」搜索安装。
- 备份:误删或改坏配置时,在备份标签按时间恢复;写回配置文件前插件会再备份当前文件。
- 设置与诊断:添加要跟踪的项目路径、自定义 skill 目录或 MCP 配置文件,并查看问题列表。
本地开发可将仓库目录 link 进 profile:
plugin_manager action=install_bundle target=<仓库绝对路径>
适用场景与注意¶
适合经常在多款 agent 工具之间共用 Skill 与 MCP、又不想手改多份 JSON/TOML/YAML 的开发者。插件以当前 DSH 进程权限读写本机配置与 skill 文件;安装前应阅读 源码与 MIT 许可证,确认可接受其扫描路径与市场安装时的网络行为(搜索/安装时才会请求外部索引,结果缓存 5 分钟)。
DSH 生态强调「一切皆插件」;社区目录 skillhub.cn 为独立站点,与 DeepSeek / 幻方无官方从属关系。
结尾¶
经过上面的步骤,可以在一个 DSH 侧边栏页面里完成 Skills 与 MCP 的浏览、编辑、跨工具同步、市场安装与备份恢复,减少在多份配置文件之间来回粘贴。更多信息见插件目录页与仓库:
- 目录页:https://www.skillhub.cn/plugins/sunChargedd/dsh-mcp-skill-manage
- GitHub:https://github.com/sunChargedd/dsh-mcp-skill-manage