本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
.difypkg 是 Dify 插件的可移植形式。生成该文件后，任何人都可在插件页面上传文件来安装。这种方式适用于 私有插件、内部测试，或面向小范围群体的 非公开分发。
如需更广泛地分发，参见发布概览。
前提条件#
- 已安装 Dify 插件 CLI。运行
dify version进行确认。 - 一个开发完成的插件项目。如果尚未构建过插件，可从 Tool 插件教程 开始。
- 打包前已通过远程调试测试插件。
Note
manifest.yaml 以及每个 provider/*.yaml 中的 author 字段都必须与你的 GitHub 用户名一致。不一致会在安装时导致 plugin_unique_identifier is not valid 错误。完整的 manifest 规范参见通用规范。
打包插件#
进入项目上级目录
导航到插件项目的 上级 目录（使该项目成为当前工作目录的子目录）。
运行打包命令
CLI 会在当前目录生成一个 your_plugin_project.difypkg 文件。
从文件安装#
打开插件页面
在 Dify 中，点击右上角的 插件 图标。
选择安装插件 > 通过本地文件
或将 .difypkg 文件拖放到插件页面的空白区域。
确认安装
查看插件请求的权限，然后点击 安装。
Check
插件现已加入工作空间，可在 Agent、工作流或工具中使用，无需任何后续操作。
Warning
自部署 Dify 默认强制执行签名验证。通过本地文件安装的未签名 .difypkg 文件会被拒绝，除非你为其签名或更改验证设置。参见第三方签名验证。
分享文件#
将 .difypkg 文件直接交给用户：通过电子邮件、内部文件共享，或任何你能掌控的渠道。他们使用上述相同的流程进行安装。
如果你希望更广泛地分发，可考虑：