前言¶

在 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