> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 打包为本地文件并分享

> 将 Dify 插件打包为 `.difypkg` 文件，可直接安装或分发给他人，无需发布到市场或 GitHub

> 本文档由 AI 自动翻译。如有任何不准确之处，请参考 [英文原版](/en/develop-plugin/publishing/marketplace-listing/release-by-file)。

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

如需更广泛地分发，参见[发布概览](/zh/develop-plugin/publishing/marketplace-listing/release-overview)。

## 前提条件

* 已安装 [Dify CLI](/zh/develop-plugin/getting-started/cli)。运行 `dify version` 进行确认。
* 一个开发完成的插件项目。如果尚未构建过插件，可从 [Tool 插件教程](/zh/develop-plugin/dev-guides-and-walkthroughs/tool-plugin) 开始。
* 打包前已通过[远程调试](/zh/develop-plugin/features-and-specs/plugin-types/remote-debug-a-plugin)测试插件。

<Note>
  `manifest.yaml` 以及每个 `provider/*.yaml` 中的 `author` 字段都必须与你的 GitHub 用户名一致。不一致会在安装时导致 `plugin_unique_identifier is not valid` 错误。完整的 manifest 规范参见[通用规范](/zh/develop-plugin/features-and-specs/plugin-types/general-specifications)。
</Note>

## 打包插件

<Steps>
  <Step title="进入项目上级目录">
    导航到插件项目的 **上级** 目录（使该项目成为当前工作目录的子目录）。
  </Step>

  <Step title="运行打包命令">
    ```bash theme={null}
    dify plugin package ./your_plugin_project
    ```

    CLI 会在当前目录生成一个 `your_plugin_project.difypkg` 文件。
  </Step>
</Steps>

<Frame>
  ![生成的插件文件](https://assets-docs.dify.ai/2024/12/98e09c04273eace8fe6e5ac976443cca.png)
</Frame>

## 从文件安装

<Steps>
  <Step title="打开插件页面">
    在 Dify 中，点击右上角的 **插件** 图标。
  </Step>

  <Step title="选择安装插件 > 通过本地文件">
    或将 `.difypkg` 文件拖放到插件页面的空白区域。
  </Step>

  <Step title="确认安装">
    查看插件请求的权限，然后点击 **安装**。
  </Step>
</Steps>

<Frame>
  ![安装插件文件](https://assets-docs.dify.ai/2024/12/8c31c4025a070f23455799f942b91a57.png)
</Frame>

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

<Warning>
  自部署 Dify 默认强制执行签名验证。通过本地文件安装的未签名 `.difypkg` 文件会被拒绝，除非你为其签名或更改验证设置。参见[第三方签名验证](/zh/develop-plugin/publishing/standards/third-party-signature-verification)。
</Warning>

## 分享文件

将 `.difypkg` 文件直接交给用户：通过电子邮件、内部文件共享，或任何你能掌控的渠道。他们使用上述相同的流程进行安装。

如果你希望更广泛地分发，可考虑：

<CardGroup cols={2}>
  <Card title="发布到 GitHub" icon="github" href="/zh/develop-plugin/publishing/marketplace-listing/release-to-individual-github-repo">
    将 `.difypkg` 附加到 GitHub release，用户通过仓库 URL 安装。
  </Card>

  <Card title="提交到市场" icon="store" href="/zh/develop-plugin/publishing/marketplace-listing/release-to-dify-marketplace">
    向 `langgenius/dify-plugins` 提交 PR，进入官方目录。
  </Card>
</CardGroup>

## 相关资源

* [发布概览](/zh/develop-plugin/publishing/marketplace-listing/release-overview)
* [Dify CLI](/zh/develop-plugin/getting-started/cli)
* [远程调试](/zh/develop-plugin/features-and-specs/plugin-types/remote-debug-a-plugin)
* [第三方签名验证](/zh/develop-plugin/publishing/standards/third-party-signature-verification)
* [通用规范](/zh/develop-plugin/features-and-specs/plugin-types/general-specifications)