Skip to main content
⚠️ 本文档由 AI 自动翻译。如有任何不准确之处，请参考英文原版。
Bundle 插件包是多个插件的集合。它允许在单个插件中打包多个插件，实现批量安装并提供更强大的服务。 你可以使用 Dify CLI 工具将多个插件打包成一个 Bundle。Bundle 插件包分为三种类型：
  • Marketplace 类型。存储插件的 ID 和版本信息。导入时，将从 Dify Marketplace 下载特定的插件包。
  • GitHub 类型。存储 GitHub 仓库地址、发布版本号和资源文件名。导入时，Dify 将访问对应的 GitHub 仓库下载插件包。
  • Package 类型。插件包直接存储在 Bundle 内部。它不存储引用来源，但这可能导致 Bundle 包体积较大。

​
前置条件

  • Dify 插件脚手架工具
  • Python 环境，版本 ≥ 3.10
有关如何准备插件开发脚手架工具的详细说明，请参阅初始化开发工具。

​
创建 Bundle 项目

在当前目录下，运行脚手架命令行工具创建新的插件包项目。 
./dify-plugin-darwin-arm64 bundle init
如果你已将二进制文件重命名为 dify 并复制到 /usr/local/bin 路径，可以运行以下命令创建新的插件项目： 
dify bundle init

​
1. 填写插件信息

按照提示配置插件名称、作者信息和插件描述。如果你是团队协作，也可以输入组织名称作为作者。
名称长度必须为 1-128 个字符，只能包含字母、数字、连字符和下划线。
Bundle 基本信息 填写信息并按 Enter 后，将自动创建 Bundle 插件项目目录。

​
2. 添加依赖

  • Marketplace
执行以下命令： 
dify-plugin bundle append marketplace . --marketplace_pattern=langgenius/openai:0.0.1
其中 marketplace_pattern 是插件在 marketplace 中的引用，格式为 organization_name/plugin_name:version_number。
  • GitHub
执行以下命令： 
dify-plugin bundle append github . --repo_pattern=langgenius/openai:0.0.1/openai.difypkg
其中 repo_pattern 是插件在 GitHub 上的引用，格式为 organization_name/repository_name:release/asset_name。
  • Package
执行以下命令： 
dify-plugin bundle append package . --package_path=./openai.difypkg
其中 package_path 是插件包的目录。

​
打包 Bundle 项目

运行以下命令打包 Bundle 插件： 
dify-plugin bundle package ./bundle
执行命令后，将在当前目录自动创建 bundle.difybndl 文件。该文件即为最终的打包结果。
编辑此页面 | 报告问题