dsh-mcp-skill-manage

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

<div align="center">

<img src="icon.svg" width="96" height="96" alt="MCP & Skill Manager icon" />

dsh-mcp-skill-manage

一个侧边栏页面，管理所有 agent 工具的 skill 与 MCP 服务器。





中文 | [English](README.en.md)

</div>

---

这是什么

dsh-mcp-skill-manage 是 DeepSeek Harness (DSH) 的 Web 插件。它在你常用的 agent 工具（DSH、Claude Code、Codex、Cursor、Windsurf、Qoder、Trae、通义灵码、CodeBuddy、Qwen Code、iFlow、Kimi、OpenCode、Cline/Roo/Kilo）之间，统一管理两样东西：

• Skills：SKILL.md 技能包，增删改查、正文编辑、跨工具共享（符号链接）、导入导出、备份恢复；
• MCP Servers：stdio / HTTP 服务器配置，增删改查、启停、跨工具复制、连接体检、备份恢复。

不用再手动打开 ~/.claude.json、~/.codex/config.toml、~/.cursor/mcp.json、profile 的 cordis.patch.yml 逐个复制粘贴。

特性

Skills

• 卡片网格浏览，搜索、按工具过滤；点击进入全宽详情页编辑，返回保留筛选。
• 全文搜索：工具栏「搜索正文」直接搜 SKILL.md 正文，卡片显示命中片段与命中次数。
• 批量操作：多选后可一次「共享到某个根目录 / 导出为一个 zip / 删除（内联确认）」。
• 新建模板：空白、代码审查、文档撰写、问题排查，一键填好 frontmatter 与正文。
• 完整编辑 frontmatter：name、description、whenToUse、metadata、disable-model-invocation、user-invocable，以及 Markdown 正文。
• 支持目录式 <name>/SKILL.md 与扁平 <name>.md；重命名自动维护已建立的符号链接。
• 跨工具共享：勾选工具即创建相对符号链接（与 ~/.claude/skills -> ~/.agents/skills 的常见做法一致），单一主副本，不复制多份。
• 卡片上可直接「打开主副本位置 / 删除（内联二次确认）」。
• 导入 / 导出：导出全部或单个 skill 为 .zip（保留 references/、scripts/ 等目录）；从 zip 或本地目录导入，重名自动避让，不覆盖。
• 非法 frontmatter、坏符号链接会标记为无效项，而不是让页面失败。

MCP

• 表格视图：服务器 / 传输方式 / 命令或 URL / 目标 / 状态；行内开关直接启停，行内可删除、打开配置位置、测试连接。
• 快速添加模板：Context7 / Filesystem / GitHub / SQLite / Playwright 一键填好 transport、command/url 与 env 占位。
• stdio（command/args/env/cwd）与 HTTP/SSE（url/headers）两种传输；支持重命名。
• 跨工具复制：把某个 server 一键复制到其它工具配置（同名已存在则跳过）。
• 连接体检：真实执行一次 MCP 握手，显示工具数量、延迟、server 名称版本与工具名，或具体失败原因；体检通过后详情页会列出全部工具。
• env/headers 默认打码，点「显示内容」才展开。
• 只修改目标条目，其它行尽量保持原样；写前备份、原子写入；解析失败拒绝写入而不是覆盖。

市场（Skills / MCP）

• Skills 市场：数据来自 skills.sh 的 Agent Skill 索引；搜索后可直接安装到任意 skill 根目录——从对应 GitHub 仓库下载整个 skill 目录（保留 references/scripts 等文件），不覆盖同名项。
• MCP 市场：数据来自官方 Model Context Protocol Registry；搜索结果可一键加入任意 MCP 配置：优先使用 registry 的 remote HTTP 端点，否则按 npm/pypi 包生成 npx/uvx stdio 配置，必填环境变量会以空值占位并提示。
• 两个市场都在同一个「市场」标签页里，可切换来源、搜索关键字、选择安装目标；网络请求只在你主动搜索/安装时发生，搜索结果缓存 5 分钟。
• Agent 工具同步提供 market_search_skills、market_install_skill、market_search_mcp、market_install_mcp。
• MCP Registry 的 version=latest 查询经常很慢，插件改为直接取无过滤列表并按 latest 标记/版本去重；registry 不可用时自动回退到内置常用服务器列表（Context7、Filesystem、GitHub、SQLite、Playwright、Memory 等）并给出提示。
• 可选：设置 GITHUB_TOKEN 环境变量可提高 GitHub API 速率限制（不设置也能用，匿名 60 次/小时）。

备份与恢复

• 删除 skill、修改/删除 MCP 配置前自动留快照，保留最近 80 份。
• 「备份」标签页按时间列出快照：skill 可恢复到任意可写根目录（重名加 -restored），配置文件可写回原目标（写回前再备份当前文件）；支持打开备份目录、删除快照。

其它

• 项目管理：添加项目路径后自动纳入其项目级 skill / MCP 配置。
• 自定义位置：任意 skill 目录、任意 JSON / JSONC / TOML / YAML-patch MCP 配置文件都可手动接入。
• 诊断：汇总非法 skill、坏链接、同名冲突、不可读配置等问题。
• Agent 工具：mcp_skill_manager 把页面能力开放给模型（overview、list_skills、read_skill、save_skill、delete_skill、set_skill_visibility、search_skills、market_search_skills、market_install_skill、market_search_mcp、market_install_mcp、list_mcp、save_mcp、delete_mcp、copy_mcp、list_backups、restore_backup、export_skills、import_skill、mcp_health、doctor），与页面走同一套 Host 逻辑。
• 深色 / 浅色主题、窄屏自适应，全部使用 DSH 主题 token。

支持的工具

工具 · Skills 根目录（用户级） · MCP 配置

共享 hub · ~/.agents/skills · —

DSH · ~/.dsh/skills · 当前 profile 的 cordis.patch.yml（HMR 即时生效）

Claude Code · ~/.claude/skills · ~/.claude.json

Codex · ~/.codex/skills · ~/.codex/config.toml

Cursor · ~/.cursor/skills · ~/.cursor/mcp.json

Windsurf · ~/.codeium/windsurf/skills · ~/.codeium/windsurf/mcp_config.json

Gemini CLI · ~/.gemini/skills · ~/.gemini/settings.json

OpenCode · ~/.config/opencode/skills · ~/.config/opencode/opencode.json

Qwen Code · ~/.qwen/skills · ~/.qwen/settings.json

iFlow CLI · ~/.iflow/skills · ~/.iflow/settings.json

Kimi Code CLI · ~/.kimi/skills · ~/.kimi/config.json

Qoder · ~/.qoder/skills · ~/.qoder/mcp.json

Trae · ~/.trae/skills · ~/.trae/mcp.json

通义灵码 · ~/.lingma/skills · ~/.lingma/mcp.json

CodeBuddy · ~/.codebuddy/skills · ~/.codebuddy/mcp.json

Cline / Roo / Kilo · — · VS Code globalStorage 下的 MCP 设置

部分工具的路径为社区约定，只有在检测到对应文件/目录时才会显示；你的版本路径不同也没关系，在「设置」里用「自定义位置」接入即可。项目级根目录（.dsh/、.agents/、.claude/、.codex/、.cursor/、.gemini/、.opencode/、.qwen/、.iflow/、.kimi/、.qoder/、.trae/、.lingma/、.codebuddy/ 下的 skills/）会按已跟踪项目自动发现。

安装

通过 Plugin Manager（推荐）

把这个仓库目录安装到你的 DSH profile：

plugin_manager action=install_bundle target=<仓库绝对路径>

安装后刷新 Web 页面，左侧栏会出现插头图标「MCP 与技能」。入口 id 为 mcp-skill-manager。

手动

在 profile 的 cordis.patch.yml 中加入：

- insert:
    - id: mcp-skill-manager
      name: 'dsh-mcp-skill-manage'
      config: {}

并确保包已可被 profile 解析（例如 link: 到本地目录）。

兼容性

· 要求

DSH · >=0.2.1-rc.3 <0.3.0（开发与实机验证版本：DSH Desktop / @deepseek-ai/dsh-app-boot 0.2.1-rc.3）

Node.js · >=20（跟随 DSH 内置运行时；插件本身零 npm 依赖）

平台 · 实机验证 macOS；测试套件跨平台（CI 在 Linux 运行，不依赖 DSH 运行时）

• package.json 声明了 engines.dsh。DSH 在安装/启动前会做兼容性检查：版本不满足时会阻止加载并给出提示，而不是加载后崩溃。
• 自建市场索引 market/index.json 的版本条目同样携带 engines.dsh，Discover 可据此展示兼容性。
• 用到的 DSH 扩展点：sidebar.panellist / main 槽位、ctx.locale、ctx.webServer.register、ctx.tools.register、profileContext、connection.requestRejection。Host 侧在激活时会检查 `webServ

…(truncated)