如何让AI Agent定时自动干活？Luvus Agent Automation自动化调度指南：一次任务与时区感知周期任务-平芜编程栈

【免费下载链接】luvus

Mission control for your AI agents

项目地址：https://gitcode.com/gh_mirrors/lu/luvus

Luvus 是一个 AI Agent 任务控制台（Mission Control），它的Agent Automation功能可以把任意一条提示词（prompt）变成「定时自动干活」的计划任务：到点自动拉起 Agent 执行、自动隔离工作区、自动记录运行历史，全程不需要你守在电脑前。

什么是 Agent Automation？

简单说：你负责写清"干什么"和"什么时候干"，Luvus 负责到点可靠地执行。

它和普通 cron 脚本的区别在于：

任务持久化：调度定义由 Luvus 服务端持有并持久化（存于automations.json台账），关闭 TUI 界面不影响计划继续生效；
去重与幂等：每次触发以「定义 ID + 计划时间」为唯一键，重启恢复后不会重复执行同一时刻的任务；
安全边界：每次运行可限定访问级别（只读 / 工作区 / 完全访问）和运行模式（独立 worktree / 现有工作区）；
历史可审计：每次运行都留下状态快照，可查、可重试、可排查。

调度核心实现在 src/automation/mod.rs，时区安全的日历计算在 src/automation/schedule.rs，数据模型见 src/automation/model.rs。

4 种调度类型：一次任务、固定间隔、每日、每周

在 TUI 或 CLI 中创建时，可以选 4 种触发器（trigger）：

调度类型	CLI 写法	说明
一次任务（Once）	`--once 2026-09-08T06:30:00Z`	只执行一次，执行后自动停用
固定间隔（Interval）	`--every 3600`	每 N 秒执行，最小 60 秒
每日（Daily）	`--daily 08:00 --timezone Asia/Shanghai`	按指定 IANA 时区的本地时间执行
每周（Weekly）	`--weekly mon,wed,fri --at 09:30 --timezone Asia/Shanghai`	指定星期几 + 本地时间

创建前可以先「预览未来几次触发时间」，存盘前确认无误：

luvus automation preview \ --weekly mon,tue,wed,thu,fri \ --at 08:00 \ --timezone Asia/Makassar

时区感知周期任务：跨夏令时也不会"跑偏"

这是 Luvus 调度最值得称道的一点：

界面会自动识别你系统使用的IANA 时区（如Asia/Shanghai、America/New_York）；
内部所有截止时间统一换算成UTC存储，但保留原始时区信息；
每天 08:00 的任务，会在当地时钟 08:00触发——即使跨过年初夏令时切换，墙钟时间依然稳定。

对于夏令时造成的"不存在的时刻"（如春季跳空），Luvus 会自动顺延；"重复的时刻"（如秋季回拨）则只取第一次出现。日历计算的细节与单元测试可以在 src/automation/schedule.rs 中看到。

一键创建你的第一个周期任务

一条命令创建"工作日早上只读代码审查"：

luvus automation create "Weekday code review" \ --title "Review workspace changes" \ --prompt "Inspect the current changes. Report correctness, security, and test risks without modifying files." \ --agent codex \ --workspace-id workspace_example \ --weekly mon,tue,wed,thu,fri \ --at 08:00 \ --timezone Asia/Makassar \ --access read-only

仓库里还提供了一个可直接抄的完整示例脚本，含时区预览和幂等键（idempotency key）防重复：examples/automation/weekday-readonly-review.sh，用法说明在 examples/automation/README.md。

💡幂等键技巧：给create加上--idempotency-key 唯一名称，即使网络抖动导致请求重发，也只会创建一条定义，不会产生重复任务。

两种执行目标：新起 Agent，还是续上正在跑的会话？

目标	行为
New agent（默认）	每次触发都新建一个 ORCH 任务，启动全新 worker，隔离性最好
Active agent	把计划好的提示词直接投递给 Luvus 里某个正在运行的 Agent 面板，延续它当前的上下文对话

Active agent 模式投递前会二次校验面板 ID、终端生命周期和 Agent 身份，绝不误投到别的会话；目标 Agent 忙时可以选wait（排队等空闲）或skip（记为跳过）。

错时触发与任务重叠策略

电脑休眠、服务重启错过触发点怎么办？两个策略旋钮：

策略	取值	行为
Misfire（错过触发）	`run_latest`（默认）	只补跑最近一次错过，不会重放积压
`skip`	错过超过宽限期（默认 3600 秒）直接跳过
Overlap（任务重叠）	`skip`（默认）	上一轮还在跑，本轮记为 skipped
`queue_one`	保留一个待执行任务，等上一轮结束后启动

常用管理命令速查

luvus automation list # 查看所有定义与下次触发时间 luvus automation get a1 # 查看单个定义 luvus automation history a1 --limit 20 # 查看运行历史 luvus automation enable a1 # 启用 / 停用（disable） luvus automation run a1 # 立即手动跑一次，不影响原计划 luvus automation health # 汇总健康状态 luvus automation delete a1 # 删除空闲定义

完整的 CLI 与 UHP（远程协议）用法参考官方文档：website/src/content/docs/docs/guides/automation.mdx。

常见问题排查

现象	先检查什么
到点没跑	对应的 Luvus 服务端是否在运行？用`automation health`和`automation history <id>`排查
报`workspace_not_found`	用`luvus workspace list`重新拿稳定的 workspace ID
运行卡在 pending	Active agent 模式的 busy 策略是`wait`，等目标空闲后自动投递
休眠后一次任务被跳过	查看定义的 misfire 策略和宽限期设置

写在最后

Luvus Agent Automation 把「AI Agent 定时自动干活」做成了三件小事：选好时区感知的计划 → 指定访问级别 → 交给服务端托管执行。一次任务适合"明晚 23 点跑一批测试"，周期任务适合"每个工作日早上自动代码审查"——任务定义持久化、触发去重、失败可追溯，真正做到了你睡觉、Agent 干活。