Skip to main content
本文档由 AI 自动翻译。如有任何不准确之处,请参考 英文原版
Bundle 插件包是多个插件打包在一起的集合,用户一步即可全部安装。 使用 Dify CLI 工具将多个插件打包成一个 Bundle。Bundle 依赖分为三种类型:
  • Marketplace:存储插件的 ID 和版本。导入时,Dify 从 Dify 市场下载插件包。
  • GitHub:存储 GitHub 仓库地址、发布版本号和资源文件名。导入时,Dify 从对应的 GitHub 仓库下载插件包。
  • Package:将插件包直接存储在 Bundle 内部。不存储引用来源,但会使 Bundle 文件体积较大。

前置条件

  • Dify 插件脚手架工具
  • Python 环境(版本 3.12)
要配置插件开发脚手架工具,参见 初始化开发工具

创建 Bundle 项目

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

1. 填写插件信息

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

2. 添加依赖

Marketplace

dify-plugin bundle append marketplace . --marketplace_pattern=langgenius/openai:0.0.1
marketplace_pattern 是插件在市场中的引用,格式为 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 文件,即最终的打包结果。
Last modified on June 25, 2026