前言¶
DeepSeek Harness（DSH）插件生态里，很多能力可以通过插件接入已有工具链。dsh-agent-sync 解决的是一个具体重复劳动：本机其他 AI agents 已经配置好的 MCP servers 和 Skills，如果想在 DSH 里继续使用，需要逐个搬运。
dsh-agent-sync 通过扫描本机 AI agents 的真实配置，发现其中的 MCP servers 和 Skills，并写入 DSH 的 profile 或 workspace。下面介绍它的能力、安装方式和典型用法。
这是什么¶
dsh-agent-sync 是一个 DSH 插件，由 kuaiyukuaikuai 维护，许可证为 MIT。
它面向 20+ AI agents 的 MCP servers 与 Skills，提供同步、管理、手动添加、迁移、过滤和模型工具调用。
核心能力¶
扫描与同步¶
插件可以自动扫描本机已安装 AI agents 的真实配置，并发现 MCP servers 和 Skills。
同步时，它会：
- 一键将 MCP servers 写入各 profile 的
cordis.patch.yml，并作为@deepseek-ai/dsh-mcp-client实例。 - 一键将 Skills 复制或链接到全局
$DSH_HOME/skills或工作区<workspace>/.dsh/skills。
MCP 与 Skills 管理¶
插件提供 MCP/Skills 管理能力，包括：
- 启用/禁用。
- 删除。
- 按全局和工作区分组。
- 在
global和workspaces之间迁移或复制 Skills。 - 创建 Skill groups、绑定 skills、按 group 过滤。
- 查看 Skill 详情和
SKILL.md正文。
手动添加也支持两类对象：
- MCP：
stdio / streamable-http。 - Skill：
folder / single .md / .zip / drag & drop。
同步配置¶
可以在设置中配置：
Skill 同步方式：copy / link/junction
MCP 同步目标：all / desktop / web profiles
启用/禁用已同步项也有不同效果：
- 禁用 MCP 时，该项会从对应 profile patch 中移除。
- 禁用 Skill 时，
SKILL.md会被重命名为SKILL.md.disabled，可恢复。
模型工具¶
插件提供以下模型工具：
agent_sync_scan
agent_sync_do
agent_sync_status
agent_sync_config
agent_sync_add_skill
agent_sync_toggle
agent_sync_remove
agent_sync_sources
其中：
agent_sync_scan用于查看可同步项。agent_sync_do用于执行同步。agent_sync_scan的结果隐藏 env values，仅显示 keys。
扩展¶
插件通过 AGENT_DEFS 支持扩展新 agent。
安装与启用¶
环境要求¶
- Node.js ≥
22.5。 - 需要同步的 agents 必须安装在同一台机器上。
- 插件不随附这些 agents。
安装到 profile¶
进入目标 profile 目录：
cd "$DSH_HOME/profiles/<name>"
然后安装插件：
pnpm add dsh-agent-sync
也可以从 GitHub 安装：
pnpm add github:kuaiyukuaikuai/dsh-agent-sync
安装完成后重启 DSH。
手动写入配置行¶
也可以在 $DSH_HOME/profiles/<name>/cordis.patch.yml 中追加一行插入配置：
- insert:
- id: dsh-agent-sync
name: 'dsh-agent-sync'
保存后重启 DSH。
MCP 同步会写入各 profile 的 cordis.patch.yml 的 dsh-agent-sync managed 区域，并在文件无效时修复。
典型用法¶
使用 GUI 同步¶
打开：
Settings → MCP/Skills
然后选择要同步的源，选择全选或自定义目标，目标可以是 global，也可以是某个 workspace。确认后执行同步。
手动添加 Skill¶
在添加 Skill 的 dialog 中，可以选择：
folder / single .md / .zip
也可以将上述对象拖拽到 dialog，并选择目标 scope。
配置同步参数¶
在 settings dialog 中设置：
Skill 同步方式：copy / link/junction
MCP 同步目标：all / desktop / web profiles
这些参数会影响后续同步 Skill 与 MCP 的位置和方式。
调用模型工具¶
先用 agent_sync_scan 查看可同步项：
agent_sync_scan
确认要同步的对象后，执行：
agent_sync_do
适用场景与注意¶
适合谁¶
适合在同一台机器上使用多个 AI agents，并希望把已有 MCP servers 与 Skills 引入 DSH 的开发者。
注意¶
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。
- 需要同步的 agents 必须在同一台机器上，插件不随附这些 agents。
- 禁用 Skill 时，
SKILL.md会被重命名为SKILL.md.disabled，可恢复。 agent_sync_scan的结果隐藏 env values，仅显示 keys。- 支持 Windows / macOS / Linux，路径为 home-relative。
相关链接¶
项目仓库：
https://github.com/kuaiyukuaikuai/dsh-agent-sync
