dsh-skill-mcp

DSH 技能与MCP插件（v0.4），两大功能：

1. 技能软链接管理：把任意源目录下的技能目录以目录联接（Windows 上是 junction，macOS/Linux 上是 symlink）批量链接进用户技能根目录 ~/.dsh/skills，让 DSH 直接加载它们；同时提供技能生命周期管理：启用/停用、取消链接、删除。
2. MCP 管理与按项目自动加载：面板内可直接添加/编辑/删除 MCP 服务，或从其他 agent（Claude Code / Codex / Cursor / Gemini CLI）扫描导入；同时监测当前会话工作区，读取用户级 ~/.dsh/mcp.json 与项目级 <项目根>/.dsh/mcp.json（回退 <项目根>/.mcp.json，Claude 格式），通过 loader 热加载 / 热卸载该项目声明的 MCP 服务——每个项目自动带上自己的 MCP（如 quick-java 项目里的 codegraph）。

入口在设置弹窗的 技能与MCP 页面，面板内部 tab 切换「技能 / MCP」。

安装

前置：已装好 DSH（dsh web 能正常运行），Node.js ≥ 20、pnpm ≥ 10。

支持的 DSH 版本：peer 依赖 @deepseek-ai/dsh-client-* ^0.1.1-rc.2（基于 DSH 0.1.1-rc.2 的客户端运行时适配）。

方式一：npm 安装

dsh plugin --profile web add dsh-skill-mcp@latest

装完硬刷新浏览器（Cmd/Ctrl+Shift+R）即可在设置弹窗看到「技能与MCP」页面（DSH 对 client 改动热加载；host 半有更新时需重启 dsh web）。

方式二：让 DSH 自己装——把下面这段提示词发给任意一个 DSH 会话

帮我安装 dsh-skill-mcp 插件（DSH 技能与MCP管理），步骤：
1. 执行 dsh plugin --profile web add dsh-skill-mcp@latest
2. 完成后提醒我硬刷新浏览器（Cmd/Ctrl+Shift+R）
遇到报错先查 dsh-skill-mcp README 的常见问题表。

更新

重跑 dsh plugin --profile web add dsh-skill-mcp@latest 即可升级到最新版，完成后硬刷新浏览器。

常见问题

| 现象 | 处理 | | --- | --- | | 安装时 pnpm 拦截 node-pty 构建脚本（仅旧版 dshmarket ≤1.37 的依赖） | 在 ~/.dsh/profiles/web 执行 pnpm approve-builds --all 放行后重跑安装 | | 装完看不到入口 | 硬刷新浏览器（Cmd/Ctrl+Shift+R）；host 半有改动时需重启 dsh web | | 设置弹窗里没有「技能与MCP」页 | 先硬刷新；仍没有则检查客户端半边是否被加载——package.json 的 exports 必须包含 "./package.json"，缺了会被静默丢弃 | | 宿主启动报 loader entry failed / RPC_CHANNEL is not defined | 运行副本（~/.dsh/profiles/web/node_modules/dsh-skill-mcp）版本过旧，与 dsh ≥ 0.1.5 不匹配；升级到 0.4.x 后重启 dsh web |

从源码安装（可选，替代 npm 方式）

# 1. 在 ~/.dsh/profiles/web/package.json 的 dependencies 里加入：
#    "dsh-skill-mcp": "file:F:/workspace/deepseek-harness/plugins/dsh-skill-mcp"
#    并把 "dsh-skill-mcp" 加进 dsh.profile.bundles 数组

# 2. 安装依赖
cd ~/.dsh/profiles/web
pnpm install

# 3. 重启 DSH Web（配置在宿主启动时加载）
dsh web

改动插件源码后（lib/ 已随包提供，无需构建）：重新执行 pnpm install 刷新 file: 依赖，然后重启 dsh web。

功能

链接技能（核心）

点击 选择文件夹… 打开宿主的原生目录选择器（或直接粘贴路径），再点 链接，源目录下每个技能子目录都会在 ~/.dsh/skills 里创建一个 junction。已有 junction 会被替换；目标是普通目录或文件时中止。这样技能源目录可以放在任何地方（比如 git 仓库），DSH 照常加载。

脚本化的等价操作：node scripts/link-skills.mjs <目录>——按当前系统自动切换（Windows 走 junction 脚本 link-skills.ps1，macOS/Linux 走 symlink 脚本 link-skills.sh），也可直接调用对应平台的脚本；目标目录默认 $DSH_HOME/skills 或 ~/.dsh/skills。

启用 / 停用（switch 开关）

对 SKILL.md 的 frontmatter 做原子改写：

• 停用：写入 disable-model-invocation: true + user-invocable: false——前者让模型不再自动调用，后者让聊天框 / 技能选择器不再列出（只写前者时聊天框仍然可选）；
• 启用：移除这两个标记。

写入穿透 junction（直接改源目录里的文件）；宿主进程内写入被技能 watcher 锁定拒绝（EPERM/EBUSY）时自动降级为 PowerShell 子进程写入，并做内容回读校验。操作成功后客户端广播 connection/reset，聊天框的选择器立即重新拉取目录，无需刷新页面。

取消链接

只删除 junction 本身，源目录不受影响；拒绝操作普通目录。

删除

三重防护：仅限带 created_by: agent 标记的技能、pinned: true 的不删、junction/符号链接不删、路径限定在技能根目录内。

按项目自动加载 MCP（v0.2 新增）

在技能与MCP面板切到 MCP tab 查看。切换工作区（会话）时，插件把项目根推送给宿主，宿主读取三层配置并合并（同名时后者覆盖前者）：

| 层级 | 路径 | 格式 | | --- | --- | --- | | 用户级（全局共享） | ~/.dsh/mcp.json | dsh 原生或 Claude | | 项目级 | <项目根>/.mcp.json | Claude（mcpServers） | | 项目级（优先） | <项目根>/.dsh/mcp.json | dsh 原生或 Claude |

配置示例（Claude 格式，codegraph 接入 quick-java 项目）：

{
  "mcpServers": {
    "codegraph": { "command": "codegraph", "args": ["serve", "--mcp"] }
  }
}

dsh 原生格式（{ "servers": { … } } 或顶层直接是 name→config 映射）：

{
  "servers": {
    "codegraph": {
      "transport": "stdio",
      "command": "codegraph",
      "args": ["serve", "--mcp"],
      "cwd": "."
    }
  }
}

行为说明：

• 每个条目热加载为独立 MCP client（stdio 的 cwd 相对路径按项目根解析，缺省即项目根——codegraph 靠项目根下的 .codegraph/ 定位索引）；
• 切换到没有配置的项目时自动卸载，绝不触碰其它来源的 MCP 条目；
• 配置文件改动约 0.5 秒内自动生效（文件监听），无需重启；
• tab 里可对每个服务热启停（写入 ~/.dsh/project-mcp-state.json，重启后保持），状态点显示连接情况（绿=已连接、黄=加载中、红=失败、灰=停用）与工具数。

MCP 服务管理与跨 agent 导入（v0.3 新增）

MCP tab 工具栏提供 添加 / 导入 / 重新加载：

• 添加 / 编辑：表单与 JSON 两种编辑方式（stdio / http 传输，支持 env、headers、args 等字段），写入作用域可选「全局」（~/.dsh/mcp.json）或「当前项目」（<项目根>/.dsh/mcp.json）；保存后立即 reconcile 热生效；
• 删除：二次确认后从所在配置文件移除并热卸载，按项目自动加载的条目不受影响；
• 从其他 agent 导入：扫描本机已有 agent 的 MCP 配置（纯读取，不改动原文件），按 agent 分组勾选导入，已存在的条目自动跳过：

| agent | 扫描路径 | | --- | --- | | Claude Code | ~/.claude/settings.json、~/.claude.json（后者覆盖同名） | | Cursor | ~/.cursor/mcp.json | | Gemini CLI | ~/.gemini/settings.json（httpUrl 归一为 http 传输） | | Codex | ~/.codex/config.toml 的 [mcp_servers.*]（内置零依赖 TOML 子集解析） |

导入时同样选择写入作用域（全局 / 当前项目）；SSE 等不支持的条目形状会被跳过。

界面

• 入口在设置弹窗的「技能与MCP」页，面板顶部 tab 切换「技能 / MCP」（无侧栏入口）；
• 技能 tab：可搜索的技能列表（按名称/描述过滤；仅列表区滚动，头部固定），每行技能卡片带状态徽章（linked、pinned、已停用、agent）；
• MCP tab：服务状态列表 + 工具栏（添加 / 导入 / 重新加载），添加/编辑表单与导入面板均为内联展开卡片，下拉菜单不嵌套滚动、编辑时不自动弹出；
• 操作按颜色区分：启停 switch（绿=启用、灰=停用）、取消链接（蓝）、删除（红色悬停）、MCP 状态点（绿=已连接、黄=加载中、红=失败、灰=停用）。

技术说明

• 宿主半边与客户端半边走 dsh v0.1.5 的 /api 传输模型：宿主用 connection.fetch.register 注册 15 个精确 POST 路由 /api/skill-mcp/<endpoint>（fetchRoutes 优先于网关 interceptor；register 内部经 owner.webServer.register 落路由，因此调用方 fiber 链上必须同时有 connection 与 webServer——本插件静态 inject 已含二者），浏览器侧固定 POST 调用；信封为 client-request {rpcId, method, payload} → server-response {rpcId, result:{ok, value | error}}，端点覆盖 skills/* 与 mcp/*；
• 按项目 MCP 通过 ctx.loader 把条目热加载为 @deepseek-ai/dsh-mcp-client（id 前缀 pmcp-），运行状态由 loader fiber 阶段 + 工具目录派生；
• 客户端半边通过 settings.section 扩展点注册设置页（单一面板，不再注册侧栏入口）；
• package.json 的 exports 必须包含 "./package.json"——宿主用 require.resolve('<pkg>/package.json') 定位客户端 bundle，缺了这一项客户端半边会被静默丢弃。