dsh-skill-mcp-bridge
dsh（DeepSeek Harness）项目桥接插件：自动导入 .claude/.agents/.trae 下的 skills，并桥接工作区 MCP 服务器（HTTP/SSE 与 stdio 双传输），全部功能由 GUI 开关控制、状态持久化。
- 技能导入：
.claude/skills、.agents/skills、.trae/skills，以及 .claude/agents、.claude/commands
- MCP 桥接：读取
.mcp.json / .trae/mcp.json / .claude/settings.json 中的 mcpServers，注册为 dsh 工具（mcp__<server>__<name>）
- 控制面板：设置页 + 工具视图双面板（开关、扫描、重连、状态）
- 自动监听：4 秒轮询文件指纹，skills/MCP 配置变更自动重载
安装
方式一：dsh plugin add（推荐）
dsh CLI 内置插件安装命令（转发 pnpm），git 仓库与 npm 包均可：
# git 仓库源
dsh plugin --profile web add github:cstarc/dsh-skill-mcp-bridge
# 等价形式（与 dsh-at-file 的 git+https 依赖同机制）
dsh plugin --profile web add git+https://github.com/cstarc/dsh-skill-mcp-bridge.git
- 自动写入 profile
package.json 依赖与 pnpm-lock.yaml
- 包内
cordis.patch.yml 会被 loader 自动应用，装完即激活，无需手动配置
- 若已发布到 npm registry，裸包名同样可用：
dsh plugin --profile web add dsh-skill-mcp-bridge
方式二：手动放置（备选）
将本仓库复制到 dsh web profile 的 node_modules：
cp -r dsh-skill-mcp-bridge /data/.dsh/profiles/web/node_modules/
（profile 使用 pnpm nodeLinker: hoisted，直接放目录即可被解析。）
然后手动在 /data/.dsh/profiles/web/cordis.patch.yml（用户补丁层，升级不覆盖）追加：
- insert:
- id: dsh-skill-mcp-bridge
name: dsh-skill-mcp-bridge
注意：手动放置的包不会被自动激活，必须补 insert 行；dsh plugin add 方式无需此步。
3. 重启与验证
重启 dsh 后插件自动加载（无需审批）。可在不重启的情况下先验证组合：
dsh --profile web --dump-config # 应看到 dsh-skill-mcp-bridge 行
使用
技能开关
面板位于 设置页 →「项目桥接（Skills + MCP）」 与 工具视图：
| 开关 | 说明 |
|---|
.claude/skills | 导入 .claude/skills/*/SKILL.md（rank 250） |
.agents/skills | 导入 .agents/skills（rank 260） |
.trae/skills | 导入 .trae/skills（rank 270） |
.claude/agents | 导入 .claude/agents/*.md（rank 251，随 claude 开关） |
.claude/commands | 导入 .claude/commands/**/*.md（rank 252，随 claude 开关） |
frontmatter 语义
| 字段 | 行为 |
|---|
name | 技能名（必须 kebab-case） |
description | 技能描述；缺省取正文首段（≤1536 字符） |
when_to_use / when-to-use / whenToUse | 触发时机 |
disable-model-invocation: true | 模型不会自动触发该技能，在输入框发送 /技能名 手动调用 |
user-invocable: false | 禁止用户手动调用 |
metadata | 透传元数据 |
MCP 服务器
支持两种配置形态（按 .trae/mcp.json → .mcp.json → .claude/settings.json 顺序合并覆盖）：
// .mcp.json — HTTP/SSE 传输
{
"mcpServers": {
"my-http-server": {
"url": "https://example.com/mcp",
"headers": { "Authorization": "Bearer xxx" }
}
}
}
// .mcp.json — stdio 传输（换行 JSON-RPC）
{
"mcpServers": {
"my-stdio-server": {
"command": "node",
"args": ["mcp-stdio-bridge.js"],
"env": { "MCP_SERVER_URL": "http://10.0.0.1:9090/mcp" }
}
}
}
注册的工具名为 mcp__<server>__<原始名>。每个 server 可用独立开关；disabled: true 的 server 默认关闭。
状态持久化
开关状态保存于 <工作区>/.claude/skills-state.json：
{
"claude": true,
"agents": true,
"trae": true,
"mcp": { "dbquery-mcp": true, "hundsun": true }
}
诊断日志：<工作区>/.claude/bridge-diag.log（截断 8000 字符）。
架构
Host（Node.js） Client（浏览器）
┌─────────────────────────────┐ ┌──────────────────────────┐
│ skills.registerProvider │ │ settings.section 面板 │
│ · .claude/.agents/.trae │ │ tool.view.cordis 面板 │
│ · frontmatter 解析 │ │ │
│ tools.register (defineTool) │◄─────►│ ctx.remote.$mount │
│ · MCP HTTP/SSE (fetch) │ typert │ ctx.reflect.get( │
│ · MCP stdio (子进程) │ RPC │ "remote.skillMcpBridge")│
│ timer 指纹轮询 │ │ │
└─────────────────────────────┘ └──────────────────────────┘
- 面板 RPC 走 Typert Remote（
src-json 宽松 codec），host 端 @Remote 装饰器方法 + ctx.typert.register(MANIFEST)。
- 工具注册使用
@deepseek-ai/dsh-tools 的 defineTool（参数 DSL 不支持属性级 enum/const/oneOf，桥接时已做 schema 白名单净化）。
- 网络访问受限环境通过子进程
node -e 执行 fetch（沙箱无 fetch）。
构建
esbuild src/index.js --bundle --format=esm --platform=node --outfile=lib/index.js --external:node:* --target=es2020
esbuild src/client.js --bundle --format=esm --platform=browser --outfile=lib/client.js --log-level=warning
--target=es2020 必要：让 esbuild 转译 TC39 装饰器（Node 原生不支持装饰器语法）。
兼容性
- dsh web profile（
nodeLinker: hoisted 布局）
- Client 平台包注入：
@deepseek-ai/dsh-client-runtime、@deepseek-ai/dsh-client-ui-tool、@deepseek-ai/dsh-client-ui-settings
- Node.js ≥ 18（MCP HTTP 子进程使用全局
fetch）
License
MIT
