构建 Dify 应用定时任务助手
作者:Leo_chen,Dify Schedule 与 智能微秘书 开源项目作者
概述
Dify 定时任务管理工具是一个基于 GitHub Actions 的自动化解决方案,用于实现 Dify Workflow 的定时执行和状态监控。无需再为缺乏定时任务支持而感到困扰,本工具可以帮助设置自动执行任务并获取实时通知,优化你的工作效率。
注意:本工具仅支持 Dify Workflow 类型应用
🌟 核心功能
🔄 支持多 Workflow 并行自动执行
⏰ 灵活的定时配置(默认执行时间:UTC+8 06:30)
📱 多渠道消息通知集成
企业级通知:企业微信、钉钉、飞书
个人通知:微信、邮件、Server 酱、Pushplus
🔒 基于 GitHub Actions 的安全执行环境
🐲 支持青龙面板部署方案
🚀 快速开始
你可以通过以下两种方式设置和运行 Dify 定时任务助手:
在线方式(GitHub Actions)
本地部署(青龙面板)
方案一:GitHub Actions 部署
按照以下简单步骤快速配置你的自动化 Workflow:
Fork 仓库 访问 Dify Workflow 定时助手代码仓库,点击 Fork 按钮,创建副本到你的 GitHub 账户。
配置密钥 进入 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
收件人邮箱(多个用
,
分隔)邮件通知
DINGDING_WEBHOOK
钉钉机器人 webhook 地址
钉钉通知
WEIXIN_WEBHOOK
企业微信机器人 webhook 地址
企业微信通知
FEISHU_WEBHOOK
飞书机器人 webhook 地址
飞书通知
AIBOTK_ROOM_RECIVER
智能微秘书群聊名称
微信群通知
AIBOTK_CONTACT_RECIVER
智能微秘书联系人昵称
微信私聊通知
启用 Workflow 前往 Actions标签页,启用 Workflow 以启动定时任务。
方案二:本地部署
青龙面板是一款开源的定时任务管理工具,项目地址。
如果你的环境无法使用 GitHub Actions,你可以选择本地部署方案。通过在青龙面板中设置定时任务实现 Dify 应用的定时触发。
安装青龙面板
详细说明请参考 项目地址。
添加订阅
在服务器中执行以下命令添加 Dify 定时任务项目 的订阅任务:
依赖安装
导航至【依赖管理】->【NodeJS】
安装
axios
依赖包
环境变量配置
DIFY_TOKENS
:Workflow API 密钥(必填)DIFY_BASE_URL
:API 接口地址(可选)多个 token 使用分号
;
分隔
通知配置
直接使用青龙面板内置的通知系统
📸 通知效果预览
❓ 故障排查指南
API 密钥获取流程
登录 Dify 控制台
进入目标 Workflow 应用
访问 API 参考页面
获取 API 密钥
常见问题
连接问题
确保私有部署的 Dify 实例具有公网访问能力
验证网络连接和防火墙配置
执行错误
验证应用类型是否为 Workflow
检查
DIFY_INPUTS
配置格式(JSON)分析执行日志,确认所需变量配置完整
如遇其他问题,欢迎在 GitHub Issues 中反馈(请注意脱敏处理)。
🤝 贡献指南
我们欢迎社区贡献,包括但不限于:
功能优化建议
Bug 修复
文档完善
新功能开发
请通过 Pull Request 或 Issue 参与项目建设。
Last updated