Dify 插件开发入门

这篇适合谁

适合想给 Dify 写自己插件的开发者，包括工具、模型、扩展等类型。读完你能装好 dify 命令，生成一个 Python 插件项目，配好远程调试，并把插件跑起来。

插件是什么

Dify 插件是模块化组件，用外部服务、自定义功能和专业工具扩展你用 Dify 构建的 AI 应用。通过插件，AI 应用可以连接外部 API、处理不同类型的数据、执行专业计算，也能执行实际操作^[1]。

插件分六类：模型、工具、Agent 策略、扩展、数据源和触发器^[1]。两类容易混淆的情况值得留意：工具插件也可以实现端点，比如做 Discord Bot 既要发送消息也要接收消息；模型插件只能用于模型提供商，不允许加其他扩展^[2]。

准备工作

• Python 3.12^[2]
• Homebrew，仅 macOS 需要，用于安装 CLI^[2]

还要注意，这里的 dify 命令是插件开发用的 CLI，和用来管理 Dify 应用的 difyctl 不是同一个工具^[2]。

第一步：安装 CLI

macOS 用 Homebrew 安装：

brew tap langgenius/dify
brew install dify

Linux 需要到 GitHub 上 Dify Plugin Daemon 的发布页下载最新的二进制文件。x86_64 主机选 dify-plugin-linux-amd64，ARM 主机选 dify-plugin-linux-arm64^[2]。下载后加上执行权限，并移动到 /usr/local/bin/dify^[2]：

chmod +x dify-plugin-linux-amd64
sudo mv dify-plugin-linux-amd64 /usr/local/bin/dify

Windows 下载 dify-plugin-windows-amd64.exe（ARM 设备选 arm64 版本），改名为 dify.exe，再把它所在的文件夹加入 PATH^[2]。这一步如果漏掉，终端里就找不到 dify 命令。

装好后运行下面的命令检查：

dify version

第二步：创建插件项目

用下面的命令创建新项目^[2]：

dify plugin init

向导会依次询问插件名称、作者、描述和可选的仓库地址，还可以生成多语言 README，英文默认必选^[2]。接着选择 python 使用 Python 模板，再选插件类型。模板包括 tool、agent-strategy、llm、text-embedding、rerank、tts、speech2text、moderation、extension、datasource 和 trigger 等^[2]。问到最低 Dify 版本时留空，即使用最新版本^[2]。

CLI 会以插件名建一个目录，里面是基本的项目结构。示例插件叫 hello-world，进入目录的命令是：

cd hello-world

如果还不确定该选哪种插件类型，可以先看 Dify 文档里的「选择插件类型」指南，它对比了工具、模型、Agent 策略、扩展、数据源和触发器六类^[1]。CLI 只覆盖开发流程，打包后分享到 Marketplace 的步骤在另外的文档中^[1]。

第三步：配置远程调试

先复制环境变量模板^[2]：

cp .env.example .env

然后获取调试凭据。登录 Dify 环境，点击右上角的插件，再点调试图标，在弹窗里复制 API Key 和 Host Address^[2]。把它们填进 .env，示例如下：

INSTALL_METHOD=remote
REMOTE_INSTALL_URL=debug-plugin.dify.dev:5003
REMOTE_INSTALL_KEY=********-****-****-****-************

REMOTE_INSTALL_URL 把主机和端口合成 host:port 的形式，两者在插件页面的 API Key 卡片上一起显示^[2]。

装好之后，如果终端找不到 dify 命令，就回到安装步骤检查它是否已经放进了 PATH 所在的文件夹，Windows 用户尤其要注意这一点^[2]。

第四步：安装依赖并运行

在项目目录下依次运行^[2]：

pip install -r requirements.txt
python -m main

插件运行时会通过 .env 里的远程安装地址和密钥连接到 Dify 环境的调试入口。这两个值都来自 Dify 页面，所以换一个 Dify 环境，就要重新从那个环境的插件页面复制凭据^[2]。

这篇只覆盖 CLI 从项目初始化到本地运行的几步。CLI 的完整能力还包括打包，打包的说明在 CLI 文档里^[2]。

下一步

插件类型的选择指南，以及开发、调试和发布的说明，都在 Dify 文档的插件开发部分^[1]。

本文改编自 Dify 文档中的「Dify 插件」入门页和「Dify 插件 CLI」页面^[1][2]，原文以 CC BY 4.0 许可证发布。