Claude 配置迁移 huanghouchun/dsh-claude-migrator

dsh-claude-migrator

中文 · English

Claude → DeepSeek Harness (DSH) 配置迁移插件（通用示范模板）

把 Claude 的配置（.claude/skills、.claude/rules、.mcp.json、CLAUDE.md）从用户主目录与项目根自动加载为 DSH 能力，零拖动、零配置；内置完整看板（Skills / Rules / MCP 服务器 / 连接状态），支持浅色/深色主题自适应。

本仓库是一个干净的可发布模板：不携带任何具体项目的 skills/rules/MCP，你 fork 后放入自己的配置即可发布。

✨ 功能

| 能力 | 说明 |
| Skills 自动加载 | 用户 ~/.agents/skills、~/.claude/skills + 项目根 .claude/skills + .dsh/dsh-claude-migrator/skills/ 的 SKILL.md 直接进 DSH skill 注册表，模型按 whenToUse 自动加载 |
| Rules 自动转换 | .claude/rules/.md 自动转为 skill（whenToUse 保留 paths 路径语义） |
| MCP 真实连接 | 用户/项目/插件三级的 .mcp.json 在启动时动态注册为 dsh-mcp-client 实例（真实连接 + 自动重连），密钥 ${VAR} 占位符自动展开环境变量 |
| CLAUDE.md 原生支持 | 无需处理：DSH 的 dsh-agent-instructions 默认加载（候选 AGENTS.md/CLAUDE.md） |
| 工作区隔离 | skill 唤醒走 provider 机制：按当前会话工作区隔离，项目级 .claude/skills 可正常使用且不跨项目串扰 |
| 完整看板 | 侧边栏「CLAUDE 配置中心」入口 + 工作区「⋯」菜单：Skills / Rules / MCP 列表 + 连接状态（🟢已连接 / 🟡连接中 / ⚪禁用） |
| 来源标识 | 每个 skill/rule/MCP 卡片带「全局 / 项目 / 插件」徽标，一眼看清配置来自哪一层 |
| 点击工作区切换 | 面板跟随当前工作区自动切换，切换项目后看板实时刷新 |
| 可折叠区块 | Skills / Rules / MCP 三个区块独立折叠（默认收起，刷新后保留手动状态） |
| 主题自适应 | 颜色走 --dsh-cm- CSS 变量，随 body[data-ds-dark-theme] 自动切换深/浅色 |

📦 安装

本地 link 安装（开发调试，改动实时生效）
dsh plugin --profile web add "link:<本插件绝对路径>"

发布到 npm 后
dsh plugin --profile web add dsh-claude-migrator

装完重启 dsh web 生效。验证：

dsh --profile web --dump-config | grep -i "claude-migrator"
应看到 dsh-claude-migrator 插件行

🚀 快速开始

1. 项目根原有配置直接生效：.claude/、.mcp.json、CLAUDE.md 无需移动任何文件。
2. 全局配置自动合并：用户主目录的 ~/.agents/skills、~/.claude/skills、~/.dsh/dsh-claude-migrator/ 自动进入看板与注册表。
3. 查看效果：侧边栏「CLAUDE 配置中心」入口打开看板，查看 Skills / Rules / MCP 列表与连接状态（区块可折叠、来源徽标可辨层级）。

配置层级一览

| 层级 | 位置 | 说明 |
| 用户全局级 | ~/.agents/skills、~/.claude/skills、~/.dsh/dsh-claude-migrator/ | 本机所有项目共享 |
| workspace 项目级 | 项目根 .claude/、.mcp.json、.dsh/dsh-claude-migrator/ | 每个项目各自的配置，按工作区隔离 |
| 插件级 | 插件目录 skills/、import/ | 随插件分发 / 发布自带 |

🧩 配置一个 MCP

.mcp.json 放在项目根（或 ~/.dsh/dsh-claude-migrator/.mcp.json 全局），服务器在启动时自动注册为真实连接：

{
"mcpServers": {
"my-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "my-mcp-package"],
"env": { "MY_API_KEY": "${MY_API_KEY}" }
}
}
}

- ${VAR} 占位符自动展开为系统环境变量（如 ${ZHIPU_KEY}）。
- 未设置密钥的服务器自动跳过注册，不阻塞 DSH 启动。
- 连接状态看板里实时展示（🟢 已连接 / 🟡 连接中 / ⚪ 禁用）。

📁 目录结构

dsh-claude-migrator/
├── package.json # dsh.bundle.patch → cordis.patch.yml；exports "." / "./client" ├── cordis.patch.yml # 插件行 + MCP 配置模板（注释） ├── src/index.js # host 端：扫描 skills/rules/mcp + 动态注册 MCP + /api/dsh-claude-dashboard ├── status/client.js # browser 端：侧边栏「CLAUDE 配置中心」看板 UI ├── skills/ # 随插件分发的 skill 放这里 ├── import/ # 拖入 Claude 配置的入口目录（含 README 说明） ├── README.md # 本文件（中文） ├── README_EN.md # 英文版 └── USAGE.md # 使用指南：三级配置区、新增 skill、配置 MCP

❓ 常见问题

| 问题 | 说明 |
| 新增 skill 后模型看不到？ | ① 目录名用 kebab-case、SKILL.md 含 name/description；② 只扫一层目录；③ 改完重启 dsh web |
| MCP 一直「连接中」？ | ① 检查对应环境变量是否设置；② 密钥/地址是否正确；③ 看日志确认重连状态 |
| 不同项目配置互相串扰？ | 不会：skill 按工作区隔离唤醒，看板按当前工作区显示 |
| 插件改了源码不生效？ | link: 方式改动实时可见；file: 方式会复制一份，需重新 dsh plugin add |

🗑️ 卸载

dsh plugin --profile web remove dsh-claude-migrator

📚 文档

- USAGE.md — 详细使用：三级配置区、如何新增 skill、如何配置 MCP

📄 许可

MIT