前言¶

在 DSH 的插件化工作流中，動態 Cordis Plugin 常只在當前會話裏使用。如果需要把它帶到另一個會話或另一個環境，手動複製配置不方便。zby1211/cordis-transfer-plugin 提供了導入和導出動態 Cordis Plugins 的入口，包含瀏覽器 Settings 面板和 model tools 兩類操作方式。

這是什麼¶

cordis-transfer-plugin 是一個持久化 DSH plugin，用於導入和導出動態 Cordis Plugins。資料將其描述爲 static profile bundle，而不是 in-memory dynamic plugin。它由 zby1211 維護，許可證爲 MIT，聲明的 dsh.client.platform 爲 web。

這個插件提供兩類接口：

• 瀏覽器 Settings 面板，用於列出、導出和導入插件。
• model tools，供 agent 調用，用於列出、導出和導入當前會話的動態 Cordis Plugins。

核心功能¶

已覈實的能力包括：

• 導入和導出動態 Cordis Plugins。
• 在瀏覽器 Settings 面板中列出當前會話的動態插件，並支持多選。
• 將一個或多個插件導出爲 .dsh-cordis-bundle.zip。
• 從本地 .zip 文件上傳並導入插件。
• 提供三個 model tools：
• cordis_plugin_list
• cordis_plugin_bundle_export
• cordis_plugin_bundle_import

安裝與啓用¶

在 web profile 下安裝該插件時，使用：

dsh plugin --profile web add cordis-transfer-plugin

這條命令用於安裝 cordis-transfer-plugin。安裝後需要重啓 dsh web。

如果在一個普通的 Node 項目中處理它，也可以執行：

npm install cordis-transfer-plugin

該插件聲明瞭以下 peerDependencies，安裝前可以先確認當前環境滿足這些依賴：

{
  "peerDependencies": {
    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6",
    "@deepseek-ai/dsh-typert-protocol": ">=0.1.0-rc.6",
    "fflate": "^0.8.3"
  }
}

典型用法¶

瀏覽器操作路徑爲：

Settings → Plugins → Import / Export

導出插件包時：

1、在列表中選擇一個或多個動態 Cordis Plugin。
2、執行導出。
3、下載 .dsh-cordis-bundle.zip。

導入插件包時：

1、選擇一個本地 .zip 文件。
2、將該文件上傳到 Host。
3、執行導入。

如果通過 model tools 操作：

• cordis_plugin_list：列出當前會話中的動態 Cordis Plugins。
• cordis_plugin_bundle_export：將一個或多個插件導出爲 zip bundle。
• cordis_plugin_bundle_import：從 zip bundle 導入插件。

適用場景與注意¶

這個插件適合需要在 web profile 中複用動態 Cordis Plugin 的場景，例如將當前會話中的插件導出爲本地文件，再在另一處導入。

使用前注意：

• 插件以當前 DSH 進程權限運行。
• 安裝前應檢查源碼、許可證和依賴版本。
• 許可證爲 MIT。
• 插件聲明的 dsh.client.platform 爲 web，因此安裝命令使用 --profile web。
• 導入和導出依賴本地 .zip 文件，建議對插件包保留備份。

結尾¶

cordis-transfer-plugin 把動態 Cordis Plugins 的列出、導出和導入放到同一個入口，減少在會話之間手動搬運插件的步驟。相關資料可以從以下地址查看：

• 目錄頁：https://www.skillhub.cn/plugins/zby1211/cordis-transfer-plugin
• GitHub：https://github.com/zby1211/cordis-transfer-plugin