前言¶
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
