Dify Master SKILL
一個模組化、漸進式披露的 Dify 開發技能體系
快速導航
什麼是 Dify
Dify 是一個開源的 LLMOps 平台,提供可視化的工作流編排和強大的插件系統,幫助開發者快速構建和部署 AI 應用。
核心特性
- 可視化工作流: 拖拽式編排,無需編碼即可構建複雜 AI 應用
- 插件系統: 支援工具、模型、資料來源等多種插件類型
- 生產就緒: 從本地開發到大規模分散式部署的完整支援
- 開源生態: 114K+ GitHub Stars,活躍的社群和豐富的插件市場
技術架構
- Beehive 架構: 模組化、可擴展的系統設計
- 佇列驅動圖引擎: 事件驅動、平行執行、高效能
- 多運行時支援: Local、Debug、Serverless 三種運行模式
- MCP 協定集成: 與 Claude 等 AI 助手的標準化集成
SKILL 體系概覽
Dify Master SKILL 採用模組化設計,包含 6 個核心子 SKILL,覆蓋從開發到部署的完整流程。
dify-master (總入口)
├── 01-workflow # 工作流設計
├── 02-plugin # 插件開發
├── 03-performance # 性能優化
├── 04-security # 安全和部署
├── 05-integration # 集成和擴展
└── 06-reference # 參考資料
設計理念
- 模組化: 每個子 SKILL 獨立完整,可單獨使用
- 漸進式披露: 從概覽到細節,按需深入
- 上下文優化: 最小化單次載入的內容量
- 實用導向: 提供可直接使用的程式碼和配置
快速開始
場景 1: 建立第一個工作流
# 簡單問答工作流
workflow:
graph:
nodes:
- data:
type: start
variables: []
id: start
- data:
type: llm
model:
provider: openai
name: gpt-4
prompt_template:
- role: system
text: "你是一個助手"
- role: user
text: "{{#sys.query#}}"
id: llm
- data:
type: answer
answer: "{{#llm.text#}}"
id: answer
edges:
- source: start
target: llm
- source: llm
target: answer
下一步: 學習 01-workflow SKILL 了解更多節點類型和設計模式
場景 2: 開發第一個插件
# 簡單工具插件
from typing import Any, Generator
from dify_plugin.entities.tool import ToolInvokeMessage
from dify_plugin import Tool
class MyTool(Tool):
def _invoke(
self,
tool_parameters: dict[str, Any]
) -> Generator[ToolInvokeMessage, None, None]:
# 獲取參數
input_text = tool_parameters.get("text", "")
# 處理邏輯
result = input_text.upper()
# 返回結果
yield self.create_text_message(result)
下一步: 學習 02-plugin SKILL 了解完整的插件開發流程
場景 3: 優化工作流性能
# 使用平行分支提升性能
- data:
type: parallel
branches:
- nodes: [tool1, process1]
- nodes: [tool2, process2]
- nodes: [tool3, process3]
id: parallel_execution
下一步: 學習 03-performance SKILL 了解更多優化技術
子 SKILL 索引
01. 工作流設計 SKILL
適用場景: 設計和開發 Dify 工作流
觸發關鍵詞: 節點, LLM, Agent, 工作流, 變數, 知識檢索, HTTP Request, Code, If-Else, Iteration, 範本, DSL, YAML
核心內容:
- 10+ 節點類型詳解 (Start, LLM, Agent, Knowledge Retrieval, Code, HTTP Request, Tool, If-Else, Iteration, Answer)
- 5 種設計模式 (順序管道、條件分支、迭代處理、知識檢索、多源聚合)
- 開箱即用的工作流範本
- 變數系統和引用語法
- 最佳實踐和常見問題
快速訪問: 01-workflow/SKILL.md
推薦給: 工作流設計者、AI 應用開發者、產品經理
02. 插件開發 SKILL
適用場景: 開發自訂工具、模型、資料來源插件
觸發關鍵詞: 插件, plugin, Tool, Provider, 開發, manifest, OAuth, 資料來源, 模型, 擴展
核心內容:
- 4 種插件類型 (Tool, Model, Datasource, Extension)
- 完整的開發流程 (初始化、實作、測試、打包、發布)
- 標準專案結構和配置檔案
- Provider 和 Tool 開發指南
- 插件範本和程式碼範例
- 測試策略和除錯技巧
快速訪問: 02-plugin/SKILL.md
推薦給: 插件開發者、後端工程師、工具集成者
03. 性能優化 SKILL
適用場景: 優化工作流和插件的執行性能
觸發關鍵詞: 性能, performance, 優化, 快取, 平行, 延遲, 吞吐量, 監控, benchmark
核心內容:
- 工作流優化 (圖結構、平行執行、變數池)
- LLM 優化 (模型選擇、Prompt 工程、快取、結構化輸出)
- 插件優化 (運行時選擇、資源限制、非同步處理)
- 監控和分析工具
- 性能基準測試
快速訪問: 03-performance/SKILL.md
推薦給: 性能工程師、架構師、維運人員
04. 安全和部署 SKILL
適用場景: 生產環境部署和安全加固
觸發關鍵詞: 安全, security, 部署, deploy, Docker, Kubernetes, SSL, 認證, 授權, 沙箱, SSRF
核心內容:
- 安全實踐 (SSRF 防護、沙箱隔離、資料加密、認證授權)
- 部署指南 (Docker Compose, Kubernetes, Serverless, 高可用)
- 維運實踐 (監控、日誌、備份、故障排查)
- 環境配置和資源規劃
- 最佳實踐和案例
快速訪問: 04-security/SKILL.md
推薦給: DevOps 工程師、安全工程師、系統管理員
05. 集成和擴展 SKILL
適用場景: 與外部系統和服務集成
觸發關鍵詞: 集成, integration, API, Webhook, MCP, Server, Client, 資料庫, Redis, 訊息佇列, RabbitMQ, Kafka, S3
核心內容:
- API 集成 (REST API, Webhook, Streaming)
- MCP 協定 (MCP Server, MCP Client, 雙向通訊)
- 外部服務 (資料庫、儲存、訊息佇列)
- 集成案例和最佳實踐
- 故障排查和除錯
快速訪問: 05-integration/SKILL.md
推薦給: 集成工程師、全端開發者、架構師
06. 參考資料 SKILL
適用場景: 查找語法、API、CLI 等參考資訊
觸發關鍵詞: 參考, reference, API, SDK, CLI, DSL, YAML, 命令, 文件, 語法
核心內容:
- DSL 語法參考 (完整的 YAML 結構和欄位說明)
- API 參考 (RESTful API 介面文件)
- SDK 參考 (Python SDK 類別和方法)
- CLI 參考 (dify 命令列工具)
- 常見問題和解決方案
- 學習資源和社群連結
快速訪問: 06-reference/SKILL.md
推薦給: 所有 Dify 開發者
常用參考
變數引用語法
# 系統變數
{{#sys.query#}} # 用戶查詢
{{#sys.files#}} # 上傳的檔案
{{#sys.conversation_id#}} # 對話 ID
# 節點輸出
{{#節點ID.輸出欄位#}} # 引用節點輸出
{{#llm.text#}} # LLM 文字輸出
{{#knowledge.result#}} # 知識檢索結果
# 對話變數
{{#conversation.變數名#}} # 對話級變數
# 迭代變數
{{#item#}} # 當前迭代項
{{#index#}} # 當前索引
常用節點配置
# LLM 節點
- data:
type: llm
model:
provider: openai
name: gpt-4
completion_params:
temperature: 0.7
max_tokens: 2000
prompt_template:
- role: system
text: "系統提示"
- role: user
text: "{{#sys.query#}}"
context:
enabled: true
variable_selector: ["knowledge", "result"]
# Agent 節點
- data:
type: agent
agent_parameters:
instruction:
value: "根據用戶需求調用工具"
model:
value:
provider: openai
model: gpt-4
query:
value: "{{#sys.query#}}"
tools:
value:
- enabled: true
provider_name: time
tool_name: current_time
type: builtin
agent_strategy_name: function_calling
# 知識檢索節點
- data:
type: knowledge-retrieval
dataset_ids: ["dataset-id"]
query_variable_selector: ["start", "sys.query"]
retrieval_mode: single
single_retrieval_config:
model:
provider: openai
name: text-embedding-3-small
top_k: 3
score_threshold: 0.7
插件配置範本
# manifest.yaml
version: 0.0.1
type: plugin
author: your-name
name: plugin-name
label:
en_US: Plugin Name
zh_Hans: 插件名稱
description:
en_US: Plugin description
zh_Hans: 插件描述
icon: icon.svg
resource:
memory: 268435456 # 256MB
plugins:
tools:
- provider/provider.yaml
meta:
version: 0.0.1
arch: [amd64, arm64]
runner:
language: python
version: "3.12"
entrypoint: main
tags:
- utilities
CLI 常用命令
# 插件開發
dify plugin init # 初始化插件專案
dify plugin run # 本地除錯插件
dify plugin package # 打包插件
dify plugin publish # 發布插件
# 工作流管理
dify workflow export <id> # 匯出工作流
dify workflow import <file> # 匯入工作流
dify workflow validate <file> # 驗證工作流
# 環境管理
dify env list # 列出環境變數
dify env set <key> <value> # 設定環境變數
dify env get <key> # 取得環境變數
學習路徑
新手路徑 (0-1 週)
- 閱讀本 SKILL 了解 Dify 全貌
- 學習 01-workflow SKILL 掌握工作流基礎
- 使用範本建立第一個工作流
- 在 Dify 平台上測試和除錯
進階路徑 (1-4 週)
- 深入學習 01-workflow SKILL 的設計模式
- 學習 02-plugin SKILL 開發自訂插件
- 學習 03-performance SKILL 優化性能
- 構建實際專案並部署
專家路徑 (1-3 個月)
- 掌握所有子 SKILL 的內容
- 學習 04-security SKILL 進行生產部署
- 學習 05-integration SKILL 集成外部系統
- 參與社群貢獻和最佳實踐分享
取得幫助
官方資源
- 官方文件: https://docs.dify.ai/
- GitHub: https://github.com/langgenius/dify
- 插件市場: https://marketplace.dify.ai/
- 官方部落格: https://dify.ai/blog/
社群資源
- Discord: https://discord.gg/FngNHpbcY7
- Reddit: https://reddit.com/r/difyai
- 中文社群: https://github.com/langgenius/dify/discussions
SKILL 支援
- 架構文件: ARCHITECTURE.md
- 問題回饋: 透過 GitHub Issues 提交
- 貢獻指南: 參與 SKILL 內容的改進和擴展
版本資訊
- 目前版本: v1.1.0
- 最後更新: 2026-03-05
- Dify 相容版本: 0.15.x - 1.9.x
- 更新內容: 完善 05-integration 和 06-reference SKILL,添加按需載入機制
- 下一版本計畫: v1.2.0 (增加更多範本和案例)
許可證
本 SKILL 基於 MIT 許可證開源,歡迎使用、修改和分發。
開始你的 Dify 開發之旅吧!選擇一個子 SKILL 深入學習,或直接使用範本快速開始。