dify自定义插件

最近折腾了一下Dify的插件开发，发现用工作流直接生成Word文档，确实是个挺实用的场景。整个过程不算复杂，但官方文档的步骤比较零散，这里把完整的操作流程整理出来，方便直接照着做。

先看效果

自己做了一个插件，可以在Dify工作流里调用，最终生成一个排版规整的Word文档。具体效果如下：

<iframe src="https://mp.weixin.qq.com/mp/readtemplate?t=pages/video_player_tmpl&action=mpvideo&auto=0&vid=wxv_4023029929875865607"></iframe>

开发环境搭建全流程

第一步：准备脚手架

先进入Dify官方文档的插件开发页面：https://docs.dify.ai/plugin-dev-zh/0211-getting-started-dify-tool

然后访问 GitHub 上的脚手架仓库：https://github.com/langgenius/dify-plugin-daemon/releases，根据自己电脑的系统下载对应版本。

第二步：重命名与组织文件夹

Windows 用户下载后，直接手动把文件名改成方便识别的名称（官方文档里的命令行重命名在 Windows 下不起作用）。然后新建一个文件夹（名字随意），把刚才的脚手架文件放进去，后面所有操作都在这个文件夹里进行。

第三步：初始化项目

在刚才的文件夹目录下打开终端（Windows 用 cmd 或 PowerShell），执行：

./dify.exe plugin init

然后按提示依次填写：

• 插件名称
• 作者
• 插件描述功能
• 仓库地址（可选）

按照官方文档的说明操作即可。

第四步：配置开发环境

初始化完成后，会生成一个插件项目文件夹。如果有多个插件，就会看到多个文件夹。进入对应的文件夹：

cd 文件夹名称
示例：cd html2word

创建 Python 虚拟环境：

python -m venv venv

激活虚拟环境（推荐用 PowerShell，即列表中最下面那个选项）。激活后终端前面会出现 (venv) 标识，然后安装依赖：

pip install -r requirements.txt

核心：编写插件功能

这个插件的功能不需要调用第三方 API，所以很多步骤可以简化。直接编辑 tools 目录下的 .py 文件——这就是你的工具代码。可以借助 AI 辅助生成，再根据实际需求微调。

接着修改 yaml 配置文件，它控制着插件在 Dify 界面中的展示形式（比如输入参数、输出样式等）。

配置环境变量：复制 .env.example 为 .env，并填入对应的配置项。

然后运行本地开发服务器：

python -m main

返回 Dify 页面刷新，就能在工具列表中看到你刚刚编写的插件了。

打包与安装

确认插件功能符合预期后，退回到项目根目录（cd ..），执行打包命令（Windows 下）：

./dify.exe plugin package 你的工具名
示例：./dify.exe plugin package html2word

打包完成后会生成一个 .difypkg 文件。之后通过 Dify 的插件管理页面上传安装即可。

整个过程下来，核心就是：脚手架初始化 → 编写工具代码 → 配置 yaml → 本地调试 → 打包分发。每个环节都不复杂，但细节容易踩坑。把这篇流程保存下来，下次开发新插件时可以直接复用。