dsh-skill-mover

Readme

<p align="center"><a href="README.en.md">English</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="README.md">简体中文</a></p>

# DSH Skill Mover（技能搬家助手）

把电脑上其他 Agent 已经装好的技能，一键搬进 DeepSeek Harness。

支持 Cursor / Claude Code / Codex / OpenCode / Hermes / OpenClaw / Kimi / Trae / Trae CN / CodeBuddy / Qwen Code / Qoder / Qoder CN / QoderWork 等 14 个平台的技能扫描与迁移：自动识别共享层（`~/.agents/skills`）、同名技能自动合并、重复的技能不会搬两份，迁移后 DSH 马上就能用。

## 界面预览

![Skill 迁移主界面](assets/screenshot-main.png)

设置 → Skill 迁移：按平台分组展示本机扫描到的技能，勾选后一键迁移。

## 功能特性

- 🔍 **自动扫描**：打开页面就能看到电脑上所有 Agent 都装了哪些技能，一目了然
- ☑️ **勾选即迁移**：想搬哪个勾哪个，一次可以搬几十个
- 🧩 **同名自动合并**：同一个技能在多个 Agent 里都有时，只装一份，来源随便你选
- 🔗 **不会重复搬运**：好几个 Agent 其实用的是同一份技能，这种情况会自动识别，只算一次
- ↩️ **随时反悔**：迁移错了可以一键移除，不影响其他已安装的技能
- 📦 **原样复制，原目录不动**：DSH 里是独立副本，原 Agent 照常使用
- 🧹 **自动整理**：不规范的技能名会自动改成 DSH 认识的格式，保证迁移后可用
- 🌍 **三大系统都支持**：macOS / Linux / Windows

| 平台 | 技能目录（macOS/Linux） | Windows |
|---|---|---|
| 共享层（DSH 原生） | `~/.agents/skills` | `C:\Users\<用户名>\.agents\skills` |
| Codex | `~/.codex/skills` | `C:\Users\<用户名>\.codex\skills` |
| Claude Code | `~/.claude/skills` | `C:\Users\<用户名>\.claude\skills` |
| Cursor | `~/.cursor/skills` | `C:\Users\<用户名>\.cursor\skills` |
| OpenCode | `~/.config/opencode/skills` | `C:\Users\<用户名>\.config\opencode\skills` |
| Hermes Agent | `~/.hermes/skills` | `C:\Users\<用户名>\AppData\Local\hermes\skills` |
| OpenClaw | `~/.openclaw/skills` | `C:\Users\<用户名>\.openclaw\skills` |
| Kimi Code CLI | `~/.kimi/skills` | `C:\Users\<用户名>\.kimi\skills` |
| Trae（国际版） | `~/.trae/skills` | `C:\Users\<用户名>\.trae\skills` |
| Trae CN（国内版） | `~/.trae-cn/skills` | `C:\Users\<用户名>\.trae-cn\skills` |
| CodeBuddy | `~/.codebuddy/skills` | `C:\Users\<用户名>\.codebuddy\skills` |
| Qwen Code | `~/.qwen/skills` | `C:\Users\<用户名>\.qwen\skills` |
| Qoder CLI | `~/.qoder/skills` | `C:\Users\<用户名>\.qoder\skills` |
| Qoder CN CLI | `~/.qoder-cn/skills` | `C:\Users\<用户名>\.qoder-cn\skills` |
| QoderWork | `~/.qoderwork/skills` | `C:\Users\<用户名>\.qoderwork\skills` |

> 路径均经过官方文档或源码核实，详见 [`docs/agent-skills-migration-research.md`](docs/agent-skills-migration-research.md)。

## 安装

**一条命令永久安装（推荐）**：

```sh
dsh plugin --profile web add github:mjylfz/dsh-skill-mover
```

安装完成后重启 DSH，打开 **设置 → Skill 迁移** 即可使用。

**免安装试用（会话级）**：把仓库链接 `https://github.com/mjylfz/dsh-skill-mover` 发给你的 DSH 助手，说「帮我安装这个插件并运行」，助手会自动读取插件文件并加载；批准运行后同样在 **设置 → Skill 迁移** 使用（会话级插件重启后需重新加载）。


## 使用

1. 打开 **设置 → Skill 迁移**
2. 页面自动扫描本机各 Agent 的技能目录，按平台分组展示
3. 展开平台卡片查看技能列表，勾选要迁移的技能（同名多来源技能可展开切换来源）
4. 点底部「迁移所选 N 个技能」（固定复制模式：DSH 内是独立副本，原目录删除不受影响）
5. 迁移完成后 DSH 自动发现新技能，**无需重启**；结果页可「移除本次迁移」回滚

### 交互规则

- 标着「DSH 原生支持」的共享层技能默认就是勾选状态，不用管它——DSH 本来就能直接用
- 同一个技能在多个平台都有时，勾选任何一个平台的版本，就等于选了那个平台的来源，其他平台栏会同步变化
- 已经在 DSH 里的技能默认不勾选，避免重复安装（想更新覆盖就勾「覆盖已安装」）
- 和共享层其实是同一份的技能（比如只是链接过去的）默认不勾选，搬了也是重复

### 迁移后能不能直接用？

能。技能是一份「说明书 + 配套素材」，不是安装包。迁移后：

- **DSH 马上就能认出它**：AI 在遇到相关任务时，会自动打开这份说明书照着做，不需要你额外操作（已经实测验证）
- **个别技能需要程序库**：比如要用到 Python 的库、Node 的包。DSH 不会偷偷执行安装命令（防止来源不可信的技能乱装东西）。如果技能确实需要这些库，AI 会按说明书自己安装；迁移结果页也会提示你哪些技能带了依赖声明，必要时手动装一次即可

## 常见问题

**Q: 迁移后怎么使用这个技能？需要额外操作吗？**

不需要额外操作。迁移后 DSH 会自动识别技能，AI 在遇到相关任务时会自动调用。你也可以直接说，例如「用 baoyu-cover-image 给这篇文章生成封面」。如果技能没有自动触发，明确说一句「请使用 xx 技能」即可。

**Q: 迁移会影响原来的 Agent 吗？**

不会。迁移是复制，不是移动。原目录原样保留，原来的 Agent 照常使用。

**Q: 同一个技能在多个平台都有，会装重复吗？**

不会。同名技能会合并成一组，只迁移一份，来源可以自己选（默认推荐共享层或优先级最高的来源）。

**Q: 迁移后技能找不到或不生效怎么办？**

先看技能是否出现在 `~/.dsh/skills/` 目录下；再确认技能的说明文件格式没问题（插件迁移时会自动修正不规范的名字）；最后开一个新会话再试。

**Q: 技能需要安装依赖（pip / npm）吗？**

看技能本身。纯指令型技能直接可用；带脚本依赖的技能，AI 会按技能的说明自动安装，或者按迁移结果页的提示手动安装。插件不会自动执行安装脚本（安全考虑）。

**Q: 怎么撤销迁移？**

迁移结果页点「移除本次迁移」，本次迁移的技能会被删除，原目录不受影响。

**Q: Windows 支持吗？**

支持。路径规则、复制命令（robocopy）和链接方式（junction）都已按 Windows 适配。

## 项目结构

```
dsh-skill-mover/
├── skill-migrator-host.js      # 插件 Host 半：扫描 / 冲突规划 / 迁移执行 / RPC
├── skill-migrator-client.js    # 插件 Client 半：设置页 UI（settings.section）
├── docs/
│   ├── agent-skills-migration-research.md   # 15 个平台技能目录调研
│   └── dsh-skill-migrator-design.md         # 完整设计文档（架构 / 冲突策略 / Windows 验证）
```

## 开发与测试

插件为纯 JavaScript（无构建步骤），Host 侧无外部依赖（手写 frontmatter 解析器、路径工具），通过 DSH 的 `ctx.fs` / `ctx.shell` 服务工作。

本地回归测试方法：用 mock 的 `fs`/`shell` 服务 + 真实文件系统运行 `runScan` / `runMigrate` / `runRemove`，并用 DSH 官方 `dsh-skill-filesystem` 发现器验证迁移后的技能可被发现、可完整加载（已实测通过）。

## 许可证

[MIT](LICENSE)