Cronicle：声明式定时工作流引擎

30 秒速读：定时任务散落在各服务器的 crontab 里、AI Agent 的定时执行靠手工点跑？本篇介绍开源项目 Cronicle——一套用声明式配置同时调度 Shell 任务和 AI Agent 任务的工作流引擎，关键词：Cronicle、定时任务调度、AI Agent、工作流引擎、开源项目。

项目信息表

核心功能

• 一套配置两种任务：Shell 脚本和 AI Agent 任务共用同一个调度器、同一份配置文件和同一套审计日志，不再是两套割裂的运行体系。
• 声明式 HCL 配置：用 HCL 文件描述调度计划、任务列表以及任务之间的 DAG 依赖，配置文件即文档，还能纳入版本管理。
• Git 版本化管理：调度配置走 Git 管理，变更历史可追溯；远程 Git 模式下变更统一从远程仓库同步，保证多机器配置一致。
• 单次运行成本上限：对 AI Agent 任务可以设置单次运行预算，令牌使用量和成本会记录在运行日志里，防止一次定时任务把 API 额度烧光。
• Agent 生态原生支持：支持 Anthropic Agent Skills 与 Model Context Protocol（MCP）服务器，Agent 可以按 Skills 和 MCP 工具链扩展能力。
• 多格式日志：终端友好的 pretty 输出、纯文本、逐行 JSON、JSONL 文件多种日志形式，方便接入 Loki/Grafana 等日志聚合平台。
• 丰富示例场景：仓库提供多工作节点扇出、取消与重试恢复、日报 Agent 扇出、SSE 实时流等部署示例。

上手指南

Cronicle 以预编译二进制分发，没有复杂依赖，上手门槛主要在配置文件和模型接入两处。

1. 下载二进制：到仓库 Releases 页下载对应操作系统和架构（Linux/macOS，amd64/arm64）的二进制文件，放入 PATH。
2. 写 cronicle.hcl：以这个文件为配置入口，声明计划（cron 表达式）、任务和任务间的依赖关系；建议从单任务无依赖开始验证。
3. 确认模型接入方式：如果要用 AI Agent 任务，务必先看清 README 里支持的模型提供商、认证方式和凭据配置——这是最容易卡住的一步。
4. 把配置纳入 Git：把 cronicle.hcl 及相关文件放进仓库管理；若用远程 Git 模式，注意本地修改可能被刷新流程覆盖，变更要从远程仓库走。
5. 启用文件日志：日志写入 JSONL 并按 500MB、3 个备份、28 天规则轮转压缩，部署前核对好磁盘容量和保留策略。

同类对比

常见问题

Q1：模型凭据怎么管理？
公开资料没有完整说明凭据管理机制，接入前必须结合 README 或源码确认支持哪些模型提供商、认证走什么通道，避免把密钥写进配置文件里裸奔。

Q2：DAG 的失败传播规则是怎样的？
公开摘要没有完整说明循环检测、失败传播和并发限制规则。做复杂编排前，建议用非生产任务先跑通失败场景，结合源码验证行为是否符合预期。

Q3：远程 Git 模式下本地改配置会被吃掉？
会。远程 Git 模式要求变更通过远程仓库进行，本地直接修改可能被刷新流程移除。把”只改远程仓库”定成团队纪律。

Q4：多工作节点和 SSE 实时流能直接上生产吗？
这些能力在仓库里以部署示例的形式出现，具体生产部署边界需要查看对应文档再做决定，不建议照抄示例就上线。

开源地址

前往 GitHub 仓库

GitHub 国内访问较慢，如打不开可多刷新几次

适用人群一句话：适合需要把定时 Shell 脚本和 AI Agent 任务放进同一套声明式调度体系的开发者与平台工程团队。

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

开源项目WallpaperMachine 免费下载开发node-rs 免费下载｜Rust 原生绑定包集合开发Roundhouse 免费下载｜Ruby 静态分析开发Flatcar Container Linux 免费下载开发Nature Skills 免费下载开发bddisasm 免费下载｜轻量级 C 指令解码库