构建 Dify 应用定时任务助手

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

​

概述

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

​

🌟 核心功能

• 🔄 支持多 Workflow 并行自动执行
• ⏰ 灵活的定时配置（默认执行时间：UTC+8 06:30）
• 📱 多渠道消息通知集成
  • 企业级通知：企业微信、钉钉、飞书
  • 个人通知：微信、邮件、Server 酱、Pushplus
• 🔒 基于 GitHub Actions 的安全执行环境
• 🐲 支持青龙面板部署方案

​

🚀 快速开始

1. 在线方式（GitHub Actions）
2. 本地部署（青龙面板）

​

方案一：GitHub Actions 部署

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 以启动定时任务。

​

方案二：本地部署

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

1. 安装青龙面板

2. 添加订阅

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

3. 依赖安装
   • 导航至【依赖管理】->【NodeJS】
   • 安装 axios 依赖包
4. 环境变量配置
   • DIFY_TOKENS：Workflow API 密钥（必填）
   • DIFY_BASE_URL：API 接口地址（可选）
   • 多个 token 使用分号 ; 分隔
5. 通知配置
   • 直接使用青龙面板内置的通知系统

​

📸 通知效果预览

​

❓ 故障排查指南

​

API 密钥获取流程

1. 登录 Dify 控制台
2. 进入目标 Workflow 应用
3. 访问 API 参考页面
4. 获取 API 密钥

​

常见问题

1. 连接问题
   • 确保私有部署的 Dify 实例具有公网访问能力
   • 验证网络连接和防火墙配置
2. 执行错误
   • 验证应用类型是否为 Workflow
   • 检查 DIFY_INPUTS 配置格式（JSON）
   • 分析执行日志，确认所需变量配置完整

​

🤝 贡献指南

• 功能优化建议
• Bug 修复
• 文档完善
• 新功能开发