让AI在你睡觉时工作:zylos-core Scheduler定时任务实战指南

原创2026-10-14 13:50:371,446 阅读

让AI在你睡觉时工作:zylos-core Scheduler定时任务实战指南

想要让 AI 在你睡觉时还在自主干活?zylos-core 的 Scheduler 定时任务调度器正是为此而生。它让你用一句自然语言,就能给 Claude 或 Codex 安排一次性、周期性或定间隔任务,AI 会在后台自动醒来执行,完成后还能把结果回传到 Telegram 或飞书。本文手把手带你从安装到高级配置,玩转这套让 AI Agent 自治运行的定时任务框架。

zylos-core 系统架构图,展示 Task Scheduler(C5)任务调度模块如何让 AI 后台自主执行定时任务

什么是 zylos-core Scheduler?AI 定时任务能帮你做什么

大多数 AI 助手是"被动"的——你问一句,它答一句,关掉会话它就"失忆"了。zylos-core Scheduler(代号 C5 任务调度)把 AI 变成"主动"的员工:你把任务交出去,它在你离开甚至入睡后继续按点干活。

它能帮你做的典型事情:

  • 🌅 每天定时汇报:每天早上 9 点自动汇总数据,结果直接推送到你的飞书。
  • 🧹 深夜自动维护:凌晨 2 点执行会话压缩、数据清理,不干扰你白天的操作。
  • 📬 延时提醒:告诉 AI"30 分钟后检查邮件",它到点自动去查。
  • 🔄 周期巡检:每 2 小时检查一次系统健康状态。

💡 核心理念:调度器本身只是"闹钟",真正干活的是 AI Runtime(Claude / Codex)。Scheduler 负责"何时叫醒",C4 通信桥负责"如何安全地把任务递到 AI 手里"。

工作原理:调度器如何让 AI 后台自主运行

理解这套机制,你就明白为什么它"在你睡觉时也不会出错"。整个过程是一条自动闭环:

  1. 状态上报:activity-monitor 会把 AI 当前的运行状态(忙碌 busy / 空闲 idle)写入 ~/zylos/activity-monitor/agent-status.json。
  2. 到期检查:Scheduler 守护进程每 5 秒扫描一次 SQLite 数据库,找出"该执行且状态为 pending"的任务(见 daemon.js)。
  3. 存活判断:只有当 AI Runtime 处于 busy 或 idle 状态时才派发任务,AI 离线则耐心等待其恢复(isRuntimeAlive)。
  4. 投递任务:把任务通过 C4 通信桥(comm-bridge)发送出去,带上优先级与空闲门控等元数据。
  5. 闭环收尾:派发出去的提示词里自带一句指令——完成后运行 cli.js done <任务ID>,调度器据此自动计算下一次执行时间(提示词构造)。

zylos-core C4 统一通信网关,Scheduler 定时任务经由此处把任务安全投递给 AI 统一会话

所有任务与执行历史都持久化在 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):

  1. ~/zylos/.env 中的 TZ=Asia/Shanghai
  2. 外部环境变量 process.env.TZ(如 PM2 配置块)
  3. 都未设置则回退到 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/。

登录后查看全文
zylos-core