定时任务
自 v0.7.2 起,Zagens 支持基于 RRULE 的本地定时自动化 — 在计划时间自动入队后台 Task,与手动创建的任务共用同一执行管线。
在哪里配置
| 入口 | 作用 |
|---|---|
| 设置 → 定时任务 | 创建 / 编辑 / 暂停自动化规则 |
| 侧栏 任务 | 查看运行中与历史任务;展开卡片可看时间线、工具调用;在聊天中打开完整对话(v0.7.3+) |
HTTP API:/v1/automations(与桌面 UI 读写同一数据)。
触发类型
| 类型 | 行为 |
|---|---|
| 轻量 Prompt | 入队保守默认:Agent 模式、无 shell、自动审批工具;忽略记录上的 model/mode/shell 字段 |
| 完整 Task | 使用规则中保存的 model、mode、工作区、allow_shell、trust_mode、auto_approve — 等同手动建 Task |
日常摘要、低风险扫描用 轻量 Prompt;需要 shell 或特定模型时用 完整 Task。
调度(RRULE)
桌面表单生成 iCalendar 风格 RRULE,例如:
FREQ=DAILY;BYHOUR=9;BYMINUTE=0
FREQ=WEEKLY;BYDAY=MO,WE,FR;BYHOUR=8;BYMINUTE=30
FREQ=MINUTELY;INTERVAL=15;BYDAY=MO,TU,WE,TH,FR
FREQ=ONCE;DTSTART=2030-06-10T09:00:00
Sidecar 调度器在到期时创建 AutomationRunRecord → task_manager.add_task → 与 Tasks 面板同一 thread/turn 历史。
与技能的关系
- 技能(
SKILL.md)定义 Agent 怎么做;定时任务定义 何时自动跑。 - 侧栏 任务 与 设置 → 技能 共用技能管理面板(
AutomationPanel)。 - Agent 也可通过
automation_*工具族在对话中创建规则。
建议
- 首次用 轻量 Prompt 验证 RRULE 与通知,再升级为完整 Task。
- 需要 shell 的定时作业配合 Windows 沙箱 与 审批策略 评估风险。
- 停机后 sidecar 会批量补跑错过的触发(catch-up)。