构建 Dify 应用定时任务助手

作者：Leo_chen，Dify Schedule 与 智能微秘书 开源项目作者

概述

Dify 定时任务管理工具是一个基于 GitHub Actions 的自动化解决方案，用于实现 Dify Workflow 的定时执行和状态监控。无需再为缺乏定时任务支持而感到困扰，本工具可以帮助设置自动执行任务并获取实时通知，优化你的工作效率。

注意：本工具仅支持 Dify Workflow 类型应用

🌟 核心功能

• 🔄 支持多 Workflow 并行自动执行

• ⏰ 灵活的定时配置（默认执行时间：UTC+8 06:30）

• 📱 多渠道消息通知集成

  • 企业级通知：企业微信、钉钉、飞书

  • 个人通知：微信、邮件、Server 酱、Pushplus

• 🔒 基于 GitHub Actions 的安全执行环境

• 🐲 支持青龙面板部署方案

🚀 快速开始

你可以通过以下两种方式设置和运行 Dify 定时任务助手：

1. 在线方式（GitHub Actions）

2. 本地部署（青龙面板）

方案一：GitHub Actions 部署

按照以下简单步骤快速配置你的自动化 Workflow：

1. Fork 仓库 访问 Dify Workflow 定时助手代码仓库，点击 Fork 按钮，创建副本到你的 GitHub 账户。
2. 配置密钥 进入 Fork 代码仓库，依次点击 Settings -> Secrets -> New repository secret，添加以下密钥：

   密钥名称	填写内容	是否必填
   DIFY_BASE_URL	Dify 接口地址（默认：https://api.dify.ai/v1）	否
   DIFY_TOKENS	Dify Workflow API 密钥（多个用 ; 分隔）	是
   DIFY_INPUTS	Workflow 所需变量（JSON 格式）	否

   通知配置（可选，推荐设置）

   如果希望通过通知及时了解任务状态，可添加以下产品服务的密钥：

   密钥名称	填写内容	用途
   EMAIL_USER	发件人邮箱（需开启 SMTP）	邮件通知
   EMAIL_PASS	邮箱 SMTP 密码	邮件通知
   EMAIL_TO	收件人邮箱（多个用 , 分隔）	邮件通知
   PUSHPLUS_TOKEN	Pushplus 的 token	微信通知
   SERVERPUSHKEY	Server 酱 的密钥	微信通知
   DINGDING_WEBHOOK	钉钉机器人 webhook 地址	钉钉通知
   WEIXIN_WEBHOOK	企业微信机器人 webhook 地址	企业微信通知
   FEISHU_WEBHOOK	飞书机器人 webhook 地址	飞书通知
   AIBOTK_KEY	智能微秘书 API Key	微信通知
   AIBOTK_ROOM_RECIVER	智能微秘书群聊名称	微信群通知
   AIBOTK_CONTACT_RECIVER	智能微秘书联系人昵称	微信私聊通知

3. 启用 Workflow 前往 Actions标签页，启用 Workflow 以启动定时任务。

方案二：本地部署

青龙面板是一款开源的定时任务管理工具，项目地址。

如果你的环境无法使用 GitHub Actions，你可以选择本地部署方案。通过在青龙面板中设置定时任务实现 Dify 应用的定时触发。

1. 安装青龙面板

详细说明请参考 项目地址。

1. 添加订阅

在服务器中执行以下命令添加 Dify 定时任务项目 的订阅任务：

ql repo https://github.com/leochen-g/dify-schedule.git "ql_" "utils" "sdk"

1. 依赖安装

   • 导航至【依赖管理】->【NodeJS】

   • 安装 axios 依赖包

2. 环境变量配置

   • DIFY_TOKENS：Workflow API 密钥（必填）

   • DIFY_BASE_URL：API 接口地址（可选）

   • 多个 token 使用分号 ; 分隔

3. 通知配置

   • 直接使用青龙面板内置的通知系统

📸 通知效果预览

微信通知示例	邮件通知示例

❓ 故障排查指南

API 密钥获取流程

1. 登录 Dify 控制台

2. 进入目标 Workflow 应用

3. 访问 API 参考页面

4. 获取 API 密钥

常见问题

1. 连接问题

   • 确保私有部署的 Dify 实例具有公网访问能力

   • 验证网络连接和防火墙配置

2. 执行错误

   • 验证应用类型是否为 Workflow

   • 检查 DIFY_INPUTS 配置格式（JSON）

   • 分析执行日志，确认所需变量配置完整

如遇其他问题，欢迎在 GitHub Issues 中反馈（请注意脱敏处理）。

🤝 贡献指南

我们欢迎社区贡献，包括但不限于：

• 功能优化建议

• Bug 修复

• 文档完善

• 新功能开发

请通过 Pull Request 或 Issue 参与项目建设。