跳转到内容

为 App 和工作流配置定时运行

定时任务可在指定时间启动 App 或工作流,无需每次手动运行。任务保存在本地;下次打开 Workrun 后会继续调度。

定时任务仅在 Workrun 桌面应用保持打开时运行,并不是云端后台服务。对时间要求严格的自动化请保持 Workrun 运行。

  1. 进入 Apps,选择要自动运行的 App。
  2. 在 Schedules 中点击 New schedule。
  3. 填写易识别的名称,选择预设频率或 Custom Cron,然后选择时区。
  4. 检查预览,点击 Save schedule。

该演示展示了创建 App 定时任务、确认配置,以及等待任务触发的完整过程。

  1. 打开工作流编辑器,在设置中找到 Automation。
  2. 点击 New schedule。
  3. 填写工作流输入。保存前必须填写所有必填输入。
  4. 选择频率、时间(或自定义 Cron)与时区,检查后续触发时间,然后保存。

任务列表会在所选时区显示每条任务是否启用以及下一次运行时间。使用开关暂停或恢复,点击铅笔编辑,点击删除按钮移除。删除后无法恢复。

该演示展示了创建工作流定时任务、填写计划运行的输入,以及任务触发后的运行过程。

Every day、Every weekday 和 Every week 会自动生成表达式。需要其他规则时选择 Custom Cron。

Workrun 仅接受由五个、以空格分隔的字段组成的 Cron:

位置 字段 示例
1 分钟 0、*/15、5,35
2 小时 9、8-18、*/2
3 日期 1、1-7、*/2
4 月份 1、1,4,7,10、*
5 星期 1-5、1、*

* 表示任意值,, 表示列表,- 表示范围,/ 表示步长。星期 1 是周一,因此 1-5 表示周一至周五。不支持秒字段。

目的 Cron 表达式
每天 09:00 0 9 * * *
工作日 09:30 30 9 * * 1-5
每 15 分钟 */15 * * * *
每月 1 日 18:00 0 18 1 * *

表达式按任务设置的 IANA 时区(如 Asia/Shanghai、America/New_York)解释,而不是查看运行记录时设备所在的时区。编辑器会校验表达式与时区,并预览接下来的三次触发;夏令时切换前后尤其应检查预览。

App 定时任务会运行已保存的 App,适合独立的代码任务,例如周期性采集数据或清理数据。

工作流定时任务会保存配置好的输入,并在每次运行时使用它们。本地工作流任务在触发时解析该工作流最新保存的版本。团队模式下需选择已发布版本;任务会固定该版本,之后的编辑不会改变已调度的行为。

定时工作流必须能在无人参与时完成。包含 Human Review 或 Ask User Question 节点的工作流无法保存为定时任务;创建任务前必须移除这些节点,仅让定时路径避开它们并不足够。若原本有效的本地工作流之后被删除或变得无效,Workrun 会暂停其任务并记录错误,避免持续尝试运行。

  • 保存、编辑、暂停、恢复或删除任务后,调度器会立即唤醒并应用变更。
  • 到期的运行会写入正常的运行历史;可在运行面板和追踪中检查输出或错误。
  • Workrun 会阻止同一 App 或工作流重叠执行。目标已排队、运行中或等待输入时,本次会标为跳过,并推进到下一个匹配时间。
  • Workrun 启动时,关闭期间错过的触发会推进到下一次未来触发,不会集中补跑积压任务。

对于会写入、发送或产生其他外部副作用的任务,请让 App 或工作流可以安全地重复执行,并把频率设得长于常见执行时长。启用前请先手动测试,并检查目标的权限。