这是什么
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 侧在激活时会检查 webServer.register 是否存在，缺失时抛出明确错误。
- 如果 DSH 提示不兼容：升级到 0.2.x 即可；确需在其它版本上试用，可在 Plugin Manager 里对精确版本授予豁免（
dsh plugin allow-version），风险自负。
- DSH 0.3 若调整上述扩展点，本插件会同步升级并更新此表；请勿在 0.3 上直接安装当前版本。
使用
左侧栏 →「MCP 与技能」：
- Skills：搜索 / 过滤 skill；卡片右侧按钮可直接打开位置或删除；点击卡片进入编辑页。
- MCP：表格里直接启停、删除、测试连接；点击行进入详情页编辑。
- 备份：任何一次删除或配置写入都会出现在这里，可恢复。
- 设置与诊断：跟踪项目、自定义 skill 目录 / MCP 配置文件、查看检测到的工具位置与问题列表。
架构
┌───────────────────────────── 浏览器 ─────────────────────────────┐
│ client.js │
│ sidebar.panellist 入口 + main 面板（列表页 / 详情页） │
│ React（module table）+ ctx.slots / ctx.locale，无第三方依赖 │
└───────────────▲───────────────────────────────┬──────────────────┘
│ GET /mcp-skill-manager/state │ POST /mcp-skill-manager/action
│ (JSON, 同源 + connection 鉴权) │
┌───────────────┴───────────────────────────────▼──────────────────┐
│ index.js（Host 插件） │
│ action 分发 · 快照组装 · 设置持久化 · `mcp_skill_manager` 工具 │
└───────┬──────────────────────┬──────────────────────┬────────────┘
│ │ │
┌───────▼────────┐ ┌─────────▼────────┐ ┌─────────▼─────────┐
│ lib/adapters.js│ │ lib/zip.js │ │ lib/probe.js │
│ 扫描 / 解析 / │ │ 无依赖 zip 读写 │ │ MCP 握手探测 │
│ 写入 / 链接 / │ │ STORE + DEFLATE │ │ stdio / HTTP / SSE│
│ 备份恢复 │ └──────────────────┘ └───────────────────┘
└───────┬────────┘
│
agent 工具配置文件（skills + MCP）+ ~/.dsh/.mcp-skill-manager/
| 文件 | 职责 |
|---|
index.js | Host 插件：路由、action 分发、mcp_skill_manager 工具、设置。 |
client.js | 浏览器插件：侧边栏入口与管理页；不 import 任何 Harness Client 包。 |
lib/adapters.js | 文件系统数据层：SKILL.md / JSON(C) / TOML / YAML-patch 读写、符号链接、备份恢复。 |
lib/presets.js | 各工具路径候选表（纯数据）。 |
lib/zip.js | 无依赖 zip 读写。 |
lib/market.js | skills.sh / MCP Registry 搜索与安装计划（可注入 fetch）。 |
lib/probe.js | MCP 连接探测。 |
docs/CONTRACT.md | Host / adapters / client 之间的内部契约。 |
docs/PUBLISHING.md | 发布、收录与市场索引指南。 |
market/ | 自建市场索引与 Awesome 收录模板。 |
数据与安全
- 只操作 README 表格里列出的目录与文件，以及
~/.dsh/.mcp-skill-manager/（设置、导出、备份）。
- 所有写操作：先备份 → 原子写入；文本配置只改目标条目，尽量保留其它内容。
- 两条 Host 路由使用
connection.requestRejection 鉴权，未认证请求返回 401。
- 插件本身不向外发送任何数据；「测试连接」只会访问你为该 MCP server 配置的地址或命令。
- 「市场」只在主动搜索/安装时访问 skills.sh、GitHub API/raw 与 MCP Registry；安装的是第三方内容，运行前请自行审查。
- DSH 的 MCP 修改写入当前 profile 的 patch 文件，由 loader 监听热生效。
开发
要求 Node.js >= 20，无运行时依赖、无构建步骤。
git clone https://github.com/sunChargedd/dsh-mcp-skill-manage.git
cd dsh-mcp-skill-manage
npm test
| 命令 | 说明 |
|---|
npm run check | 所有源文件语法检查 |
npm run test:adapters | 数据层（临时 HOME） |
npm run test:tools | zip 与 MCP 探针 |
npm run test:market | 市场搜索、skill 下载合并、MCP 安装计划（假网络） |
npm run test:actions | Host action 端到端（含真实 stdio MCP 握手、备份恢复、zip 往返、全文搜索） |
npm run test:render | 无头渲染 UI（临时 HOME，覆盖列表→详情→返回、快捷操作、备份页） |
npm test | 以上全部 |
贡献流程、代码约定与如何新增一个工具支持见 CONTRIBUTING.md。
版本与发布
本项目遵循 Semantic Versioning 与 Keep a Changelog。
每次面向用户的功能变更都要加版本号：
- 在
CHANGELOG.md 的 ## [Unreleased] 下记录改动；
- 发布时执行
npm run bump:patch（修复/文档）、npm run bump:minor（新功能）或 npm run bump:major（破坏性变更）；
脚本会把 [Unreleased] 切成带日期的版本段，并同步 package.json；
- 提交后打 tag 并推送：
git tag vX.Y.Z && git push --follow-tags。
推送 tag 后，GitHub Actions 的 Release workflow 会自动创建 GitHub Release：优先使用 docs/release-notes/<version>.md（可写中英双语），没有则使用该版本的 CHANGELOG 段落（见 .github/workflows/release.yml）。
发布到插件市场
三条路径（自建索引 / Awesome 列表收录 / npm + 默认市场）的完整步骤、当前 npm 包名占用情况与收录要求，见 docs/PUBLISHING.md。仓库内已包含：
npm run market:build：生成自建 format-1 市场索引（git source，固定 commit）；market/awesome-plugin.yml：提交给 Awesome DSH Plugin 的条目模板。
已知限制
- 部分工具的配置路径是社区约定（Qoder、Trae、灵码、CodeBuddy 等），检测不到时用「自定义位置」补。
- JSONC 文件写入会丢失注释（写前有备份）；TOML 目前仅用于 Codex。
- 直接在卡片/表格里的快捷删除不会再次弹窗，但会内联二次确认并保留备份。
- MCP 体检会按配置真实启动进程或发起请求，请只对自己信任的 server 使用。
- 市场安装不改写已有同名条目：skill 会自动加后缀，MCP server 名冲突会自动追加序号；匿名 GitHub API 有速率限制。
参与贡献
欢迎 Issue、PR、以及「支持某个新工具」的路径情报。开始之前请阅读
CONTRIBUTING.md 与 CODE_OF_CONDUCT.md；
安全问题请按 SECURITY.md 私下报告。
如果这个插件帮到了你，点个 ⭐ Star 是最好的支持。
许可证
MIT © 2026 sunChargedd
