<p align="center"><a href="README.en.md">English</a> | <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 迁移：按平台分组展示本机扫描到的技能，勾选后一键迁移。
功能特性
- 🔍 自动扫描：打开页面就能看到电脑上所有 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)。
安装
一条命令永久安装（推荐）：
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)