环境要求

  • Python 版本 ≥ 3.12
  • Dify 插件脚手架工具 (dify-plugin-daemon)

了解更多:初始化开发工具

获取 Dify Plugin 开发包

Dify Plugin CLI

不同平台安装方法

macOS Brew(全局安装):

brew tap langgenius/dify
brew install dify

安装完成后,新建任意终端窗口,输出 dify version 命令,若输出版本号信息,则说明安装成功。

macOS ARM (M 系列芯片):

# 下载 dify-plugin-darwin-arm64
chmod +x dify-plugin-darwin-arm64
./dify-plugin-darwin-arm64 version

macOS Intel:

# 下载 dify-plugin-darwin-amd64
chmod +x dify-plugin-darwin-amd64
./dify-plugin-darwin-amd64 version

Linux:

# 下载 dify-plugin-linux-amd64
chmod +x dify-plugin-linux-amd64
./dify-plugin-linux-amd64 version

全局安装 (推荐):

# 重命名并移动到系统路径
# 示例 (macOS ARM)
mv dify-plugin-darwin-arm64 dify
sudo mv dify /usr/local/bin/
dify version

运行开发包

这里以 dify 为例。如果你使用的是局部的安装方式,请根据情况替换指令例如 ./dify-plugin-darwin-arm64 plugin init

插件开发流程

1. 新建插件

./dify plugin init

按提示完成插件基本信息配置

了解更多:Dify 插件开发:Hello World 指南

2. 开发模式运行

配置 .env 文件,然后在插件目录下运行以下命令:

python -m main

了解更多:远程调试插件

4. 打包与部署

打包插件:

cd ..
dify plugin package ./yourapp

了解更多:发布概览

插件分类

工具标签

分类 tag class ToolLabelEnum(Enum)

class ToolLabelEnum(Enum):
    SEARCH = "search"
    IMAGE = "image"
    VIDEOS = "videos"
    WEATHER = "weather"
    FINANCE = "finance"
    DESIGN = "design"
    TRAVEL = "travel"
    SOCIAL = "social"
    NEWS = "news"
    MEDICAL = "medical"
    PRODUCTIVITY = "productivity"
    EDUCATION = "education"
    BUSINESS = "business"
    ENTERTAINMENT = "entertainment"
    UTILITIES = "utilities"
    OTHER = "other"

插件类型参考

Dify 支持多种类型的插件开发: