Skip to main content
本文档由 AI 自动翻译。如有任何不准确之处，请参考 英文原版。
Dify 命令行界面（CLI）负责管理插件开发的整个流程，从项目初始化到打包。本指南介绍如何安装 CLI、搭建插件项目，并将其连接到 Dify 实例运行。

​
前提条件

开始之前，请确保具备：
  • Python 3.12
  • Homebrew（仅 macOS，用于安装 CLI）

​
安装 CLI

brew tap langgenius/dify
brew install dify
验证安装： 
dify version

​
创建插件项目

使用以下命令创建新的插件项目： 
dify plugin init
根据提示填写必填字段： 
Edit profile of the plugin
Plugin name (press Enter to next step): hello-world
Author (press Enter to next step): langgenius
Description (press Enter to next step): hello world example
Repository URL (Optional) (press Enter to next step): Repository URL (Optional)
  Enable multilingual README: [✔] English is required by default

Languages to generate:
    English: [✔] (required)
  → 简体中文 (Simplified Chinese): [✔]
    日本語 (Japanese): [✘]
    Português (Portuguese - Brazil): [✘]

Controls:
  ↑/↓ Navigate • Space/Tab Toggle selection • Enter Next step
选择 python 并按 Enter 使用 Python 插件模板，然后选择要构建的插件类型： 
Select the type of plugin you want to create, and press `Enter` to continue
Before starting, here's some basic knowledge about Plugin types in Dify:

- Tool: Tool Providers like Google Search, Stable Diffusion, etc. Used to perform specific tasks.
- Model: Model Providers like OpenAI, Anthropic, etc. Use their models to enhance AI capabilities.
- Endpoint: Similar to Service API in Dify and Ingress in Kubernetes. Extend HTTP services as endpoints with custom logic.
- Trigger: Webhook-based providers that turn third-party platform events into workflow start signals.
- Agent Strategy: Implement your own agent strategies like Function Calling, ReAct, ToT, CoT, etc.

Based on the ability you want to extend, Plugins are divided into six types: Tool, Model, Extension, Agent Strategy, Datasource, and Trigger.

- Tool: A tool provider that can also implement endpoints. For example, building a Discord Bot requires both sending and receiving messages.
- Model: Strictly for model providers, no other extensions allowed.
- Extension: For simple HTTP services that extend functionality.
- Agent Strategy: Implement custom agent logic with a focused approach.
- Datasource: Provide datasource for Dify Knowledge Pipeline.
- Trigger: Build webhook integrations that emit events to kick off workflows.

We've provided templates to help you get started. Choose one of the options below:
-> tool
  agent-strategy
  llm
  text-embedding
  rerank
  tts
  speech2text
  moderation
  extension
  datasource
  trigger
提示输入最低 Dify 版本时，留空即可使用最新版本： 
Edit minimal Dify version requirement, leave it blank by default
Minimal Dify version (press Enter to next step):
CLI 会创建一个以插件名命名的新目录，并搭建基本项目结构。进入该目录： 
cd hello-world

​
运行插件

在 hello-world 目录下，复制示例环境文件： 
cp .env.example .env
编辑 .env 文件，设置插件的环境变量，例如 API 密钥或其他配置。要获取调试凭据，请登录 Dify 环境，点击右上角的 插件，再点击调试图标。在弹出窗口中，复制 API Key 和 Host Address。 
INSTALL_METHOD=remote
REMOTE_INSTALL_URL=debug-plugin.dify.dev:5003
REMOTE_INSTALL_KEY=********-****-****-****-************
REMOTE_INSTALL_URL 以 host:port 形式合并主机和端口。主机和端口一同显示在插件页面的 API Key 卡片中。
安装依赖并运行插件： 
pip install -r requirements.txt
python -m main
Last modified on June 25, 2026