让AI在你睡觉时工作:zylos-core Scheduler定时任务实战指南
让AI在你睡觉时工作:zylos-core Scheduler定时任务实战指南
想要让 AI 在你睡觉时还在自主干活?zylos-core 的 Scheduler 定时任务调度器正是为此而生。它让你用一句自然语言,就能给 Claude 或 Codex 安排一次性、周期性或定间隔任务,AI 会在后台自动醒来执行,完成后还能把结果回传到 Telegram 或飞书。本文手把手带你从安装到高级配置,玩转这套让 AI Agent 自治运行的定时任务框架。
什么是 zylos-core Scheduler?AI 定时任务能帮你做什么
大多数 AI 助手是"被动"的——你问一句,它答一句,关掉会话它就"失忆"了。zylos-core Scheduler(代号 C5 任务调度)把 AI 变成"主动"的员工:你把任务交出去,它在你离开甚至入睡后继续按点干活。
它能帮你做的典型事情:
- 🌅 每天定时汇报:每天早上 9 点自动汇总数据,结果直接推送到你的飞书。
- 🧹 深夜自动维护:凌晨 2 点执行会话压缩、数据清理,不干扰你白天的操作。
- 📬 延时提醒:告诉 AI"30 分钟后检查邮件",它到点自动去查。
- 🔄 周期巡检:每 2 小时检查一次系统健康状态。
💡 核心理念:调度器本身只是"闹钟",真正干活的是 AI Runtime(Claude / Codex)。Scheduler 负责"何时叫醒",C4 通信桥负责"如何安全地把任务递到 AI 手里"。
工作原理:调度器如何让 AI 后台自主运行
理解这套机制,你就明白为什么它"在你睡觉时也不会出错"。整个过程是一条自动闭环:
- 状态上报:activity-monitor 会把 AI 当前的运行状态(忙碌
busy/ 空闲idle)写入~/zylos/activity-monitor/agent-status.json。 - 到期检查:Scheduler 守护进程每 5 秒扫描一次 SQLite 数据库,找出"该执行且状态为 pending"的任务(见 daemon.js)。
- 存活判断:只有当 AI Runtime 处于
busy或idle状态时才派发任务,AI 离线则耐心等待其恢复(isRuntimeAlive)。 - 投递任务:把任务通过 C4 通信桥(comm-bridge)发送出去,带上优先级与空闲门控等元数据。
- 闭环收尾:派发出去的提示词里自带一句指令——完成后运行
cli.js done <任务ID>,调度器据此自动计算下一次执行时间(提示词构造)。
所有任务与执行历史都持久化在 SQLite(~/zylos/scheduler/scheduler.db),所以即使服务器重启,你的定时任务也不会丢。
四种定时方式:从一次性到循环执行
Scheduler 支持 4 种定时方式,创建任务时必须且只能指定其中一种(完整参数见 references/add.md)。CLI 路径为:
~/zylos/.claude/skills/scheduler/scripts/cli.js
一次性任务:延迟执行(--in)
"从现在开始,隔一段时间再跑一次。"时间支持自然语言、简写或纯秒数三种写法,解析逻辑见 parseDuration。
cli.js add "检查邮件并总结" --in "30 minutes" --priority 2
cli.js add "提交一次备份" --in "2h"
一次性任务:指定时刻执行(--at)
"在某个具体时间点触发",同样吃自然语言。
cli.js add "发送周报" --at "tomorrow 9am"
cli.js add "提醒开会" --at "next monday 8am"
循环任务:Cron 表达式(--cron)
标准 5 段 cron,适合"每天/每周固定时间"。
cli.js add "健康检查" --cron "0 9 * * *" # 每天 09:00
cli.js add "周报" --cron "0 9 * * 1" # 每周一 09:00
定间隔任务:每隔一段时间(--every)
"从创建时刻起,每隔固定时长跑一次",适合轮询类场景。
cli.js add "检查更新" --every "2 hours"
cli.js add "心跳监测" --every "90 minutes"
| 选项 | 类型 | 示例 | 适用场景 |
|---|---|---|---|
--in |
一次性(延迟) | --in "30 minutes" |
稍后提醒 |
--at |
一次性(定点) | --at "tomorrow 9am" |
特定时刻 |
--cron |
循环 | --cron "0 9 * * *" |
固定作息 |
--every |
定间隔 | --every "2 hours" |
周期轮询 |
任务管理命令速查:创建、查询、暂停、删除
建好任务后,用下面的命令就能掌控全局。所有命令都支持任务 ID 前缀模糊匹配,不用记全名。
cli.js list # 查看全部活跃任务
cli.js next # 查看最近 5 个待执行任务
cli.js running # 查看正在执行的任务
cli.js history [任务ID] # 查看最近 20 条执行历史
cli.js done 任务ID # 标记完成(AI 也会自动调用)
cli.js pause 任务ID # 暂停
cli.js resume 任务ID # 恢复
cli.js update 任务ID --priority 1 # 修改任意字段
cli.js remove 任务ID # 永久删除任务及历史
💡 小技巧:list 加 --json 可输出机器可读的完整字段,方便脚本处理;--reply-channel "<渠道>" 可按回传渠道过滤。
关键参数详解:优先级、空闲门控与结果回传
优先级:让重要任务先执行
--priority <1-3>,数值越小越优先,仅影响派发顺序(详见 config 说明):
| 优先级 | 含义 | 说明 |
|---|---|---|
1 |
紧急 | 最高优先,尽快执行 |
2 |
高 | 重要任务 |
3 |
普通(默认) | 标准执行 |
空闲门控:不打扰正在忙活的 AI
--block-queue-until-idle 让任务等待 AI 持续空闲后才执行,并在执行结算前阻塞后续派发。适合会话压缩、数据清理这类需要"全身心投入"的维护任务。
cli.js add "压缩会话" --cron "0 2 * * *" --block-queue-until-idle
⚠️ 注意:实时通知、时间敏感任务不要加这个门控,否则会被"等空闲"卡住。
结果回传:让结果找到你
--reply-channel 和 --reply-endpoint 决定任务结果推送到哪里(Telegram、Lark 等),这是"让 AI 睡觉时工作、醒时汇报"的关键。
# 结果推送到某个 Telegram 用户
cli.js add "每日报告" --at "9am" --reply-channel "telegram" --reply-endpoint "你的用户ID"
# 结果推送到飞书话题
cli.js add "周报" --cron "0 9 * * 1" --reply-channel "lark" --reply-endpoint "chat_id topic_id"
错过阈值:离线多久算"迟到"
--miss-threshold <秒> 控制任务逾期后还能否补跑(默认 300 秒)。
- 健康检查、实时提醒:用默认
300。 - 备份、报告、批处理:调大,如
--miss-threshold 86400(保证即使延迟也最终执行)。
时区设置:让你的定时任务按时区精确触发
定时任务的灵魂是"准时",所以时区必须配对。Scheduler 按以下顺序解析时区(见 tz.js):
~/zylos/.env中的TZ=Asia/Shanghai- 外部环境变量
process.env.TZ(如 PM2 配置块) - 都未设置则回退到
UTC
自然语言时间与 cron 都会按配置时区解析和显示,而数据库里仍统一存 UTC,避免跨时区混乱。改完时区配置后记得重启服务:
pm2 restart scheduler
🔑 配置了无效时区会"快速失败"(fail-fast),直接报错退出,而不是带着错误时区默默运行——这点能帮你省下大量排查时间。
服务管理:PM2 守护与日常运维
Scheduler 是 zylos-core 的核心服务之一。执行 zylos init 后,它会作为 PM2 托管服务被自动拉起并开机自启,无需你手动启动(服务定义见 templates/pm2/ecosystem.config.cjs)。日常运维只需这几条:
pm2 status scheduler # 查看运行状态
pm2 logs scheduler # 查看运行日志
pm2 restart scheduler # 重启(改配置后用)
zylos doctor # 自动诊断并修复安装问题
守护进程具备自恢复能力:启动时会清理"卡死"的 running 任务,周期性清理过期历史,并在 AI 离线时自动进入等待——这套自愈逻辑让你真正做到"设好就走"。
常见问题与最佳实践
Q:AI 离线时任务会丢吗?
不会。任务保持 pending,守护进程在阈值窗口内每 5 秒重试派发;窗口耗尽后,一次性任务标记为失败,循环任务跳到下一周期。
Q:想临时停一个任务?
用 cli.js pause <ID> 暂停、cli.js resume <ID> 恢复,比删除更安全。
Q:任务执行超时怎么办? 单个任务超过 1 小时会被判定为超时(stale),一次性任务标记失败,循环任务转完成并排下一次,避免"僵尸任务"永久卡住队列。
三个实用建议:
- ✅ 维护类任务加
--block-queue-until-idle,通知类任务保持默认。 - ✅ 关键备份任务调大
--miss-threshold,确保最终执行。 - ✅ 用
cli.js list定期巡检,配合--json接入你自己的监控脚本。
总结
zylos-core Scheduler 把"定时"这件小事做到了极致:自然语言设时间、优先级+空闲门控精细调度、结果多渠道回传、时区精确、PM2 自愈守护。你只管把任务描述清楚交出去,AI 就会在你睡觉时准时醒来、干完活、把结果送到你手上。
想深入源码,可以从这几个文件入手:任务处理逻辑 daemon-tasks.js、运行时投递 runtime.js、以及命令参考 references/。

