# 定时任务

> 创建单次或周期任务，查看执行记录并管理后续运行。

来源：https://vonvon.cc/docs/tasks/
更新时间：2026-11-04

定时任务让 Bot 在约定时间到指定飞书群开工。新建任务前，先确认这位 Bot 正在运行。然后在群详情创建，再从任务列表核对；Bot 页只汇总各群的任务。

**群详情创建任务****设备定时运行****飞书结果与记录**

流程示意：保存后核对下次运行时间，执行后再查看飞书回复或任务记录。

## 在群详情新建任务

1.  打开「群组」，选中目标群和要执行的 Bot，进入群详情的「任务」页。
2.  点「新建」，填写任务名字和「要做什么」。把需要检查的范围、要产出的内容和回报方式写清楚，例如“每个工作日检查昨天合入的 PR，在本群列出标题和链接”。
3.  选「什么时候」、时区和「发到哪」，再点「保存」。返回列表后核对任务名、下一次时间和状态；任务出现在目标群列表中才算建立成功。

名字最多 40 字，任务说明最多 4000 字。若保存未完成，表单会显示原因；先修正时间或内容，别把聊天里的一句“我会记得”当作任务已建立。

## 选择时间与时区

| 方式 | 怎么填写 | 例子 |
| --- | --- | --- |
| 一次 | 选具体日期和时间 | 11 月 12 日 14:00 提醒发版 |
| 间隔 | 填分钟数，1–10080 分钟 | 每 30 分钟巡检一次 |
| 每天 | 选每天的时刻 | 每天 09:00 发日报 |
| 每周 | 勾选星期，可点「工作日」，再选时刻 | 每周一、三 10:00 汇总 |
| cron | 填写五段表达式：分、时、日、月、星期 | `0 9 * * 1-5` 表示工作日 09:00 |

表单会显示运行 Bot 的电脑时区，也允许为任务指定其他可识别的时区。跨时区协作时，把任务列表中显示的时区一起核对；一次性任务换时区会改变它对应的实际时刻。若显示“不认识这个时区”，请换成有效的时区名称后再保存。

## 决定回复发到哪里

「发到哪」选“跟随群里的会话方式”，任务回复就按这个群的会话设置投递；选“每次新话题”，每次执行会另开话题。希望每次报告彼此独立时用新话题；希望报告接在群当前讨论方式里时用跟随。创建后从任务列表核对选择，首次运行后再到飞书确认实际回复位置。

## 查看、修改、暂停和删除

群详情的「任务」页每行有「记录」「编辑」「暂停/恢复」「立即运行」「删除」。Bot 页的「任务」按群汇总，点任务可回到对应群的任务页；那里没有新建表单。群已解绑时，Bot 页仍可显示原任务并提供删除入口。

-   **编辑：**修改任务内容、周期、时区或回复位置，保存后以列表的新摘要为准。若别人先改了同一任务，表单会提示冲突并显示最新内容；核对后再保存。
-   **暂停与恢复：**暂停后不按计划运行；恢复后从后续计划点继续，暂停期间错过的任务不会补跑。一次性任务若显示「已结束」，需要编辑为新时间，不能直接恢复。
-   **立即运行：**页面提示“已开始运行”只说明 Bot 接受了启动请求；到群里看最终回复，或打开「记录」核对结果。手动运行不改变下次预定时间。
-   **删除：**先确认任务名；删除会连运行记录一起移除，不能撤销。

## 查看运行结果

展开「记录」可看最近的运行情况。结果可能是完成、失败、错过、跳过或中断；列表还会显示累计运行、错过和跳过次数。若群里没有收到预期内容，先看记录中的状态，再检查 Bot 是否运行、群是否仍绑定、群权限档是否可用，以及目标设备的「诊断」。

## 设备离线后怎样补跑

任务由运行 Bot 的设备执行。电脑关机、睡眠或 Vonvon 没运行时，不会准时开工。恢复后，只会补最近 7 天内最新的一次计划点；更早或其余错过的计划点记为「错过」，不会逐条追补。需要长期准时执行，应让运行 Bot 的设备保持开机、联网且后台服务正常。

多个任务可以等待可用的执行位置；如果同一任务上一轮还在运行，它的新计划点会记为「跳过」，不会同时启动两份。群暂时停用、更新或被暂挂时也可能跳过计划点。群解绑后，启用中的任务会暂停并显示「已暂停：群已解绑」。若执行前检查发现群绑定已失效或当前权限档无法执行，该次运行会记录失败。

## 连续失败与自动暂停

一次成功会清零连续失败次数；连续 10 次计入失败的运行会让任务自动暂停，并在群主区发通知。看到「已暂停：连续失败」时，先展开记录找原因，修好连接、权限或任务内容后再点「恢复」。恢复只是重新启用后续计划，不会自动重放所有失败的执行。

若列表或记录读不到，先确认 Bot 在运行，再重开页面或重试；还不行时到「设置 → 诊断」查看后台日志。任务页出现“已开始运行”却没有最终回复，也应按这个顺序核对。