打包为本地文件并分享

本文档由 AI 自动翻译。如有任何不准确之处，请参考英文原版。

.difypkg 是 Dify 插件的可移植形式。生成该文件后，任何人都可在插件页面上传文件来安装。这种方式适用于 私有插件、内部测试，或面向小范围群体的 非公开分发。如需更广泛地分发，参见发布概览。

前提条件

manifest.yaml 以及每个 provider/*.yaml 中的 author 字段都必须与你的 GitHub 用户名一致。不一致会在安装时导致 plugin_unique_identifier is not valid 错误。完整的 manifest 规范参见通用规范。

进入项目上级目录

导航到插件项目的上级目录（使该项目成为当前工作目录的子目录）。

运行打包命令

dify plugin package ./your_plugin_project

CLI 会在当前目录生成一个 your_plugin_project.difypkg 文件。

打开插件页面

在 Dify 中，点击右上角的插件图标。

选择安装插件 > 通过本地文件

或将 .difypkg 文件拖放到插件页面的空白区域。

确认安装

查看插件请求的权限，然后点击安装。

插件现已加入工作空间，可在 Agent、工作流或工具中使用，无需任何后续操作。

自部署 Dify 默认强制执行签名验证。通过本地文件安装的未签名 .difypkg 文件会被拒绝，除非你为其签名或更改验证设置。参见第三方签名验证。

将 .difypkg 文件直接交给用户：通过电子邮件、内部文件共享，或任何你能掌控的渠道。他们使用上述相同的流程进行安装。如果你希望更广泛地分发，可考虑：

将 .difypkg 附加到 GitHub release，用户通过仓库 URL 安装。

向 langgenius/dify-plugins 提交 PR，进入官方目录。