纯本地循环调度引擎,将自然语言定时意图转为可信赖的重复任务执行计划,无需外部同步
说明:
## 核心用法
Cron 是一个本地优先的循环调度系统,核心能力在于将用户的自然语言定时意图(如”每周一上午提醒””每三天执行一次”)转化为结构化的本地执行计划。用户通过 `add_job.py` 捕获重复任务,系统支持 `daily`、`weekly`、`monthly`、`interval` 四种调度类型,并提供 `pause_job.py`/`resume_job.py` 实现暂停与恢复控制。
关键工作流围绕可见性设计:`next_run.py` 让用户明确知晓下一次执行时间,`list_jobs.py` 与 `show_job.py` 提供全局与单任务视角,`runs.json` 与 `stats.json` 记录执行历史与统计,形成完整的”捕获-执行-追踪”闭环。
## 显著优点
– **完全本地隔离**:数据仅存储于 `~/.openclaw/workspace/memory/cron/`,零外部依赖、零云端同步,隐私风险极低
– **意图友好**:支持自然语言输入,降低非技术用户的调度配置门槛
– **状态可控**:`active/paused/archived` 三态管理,避免僵尸任务堆积
– **零依赖部署**:仅需 Python 3,无额外包安装,环境适应性极强
## 潜在局限
– **单机限制**:无多设备同步能力,跨终端场景需手动迁移数据
– **故障恢复弱**:本地存储无备份机制,系统崩溃可能导致调度丢失
– **精度约束**:作为本地引擎,无分布式时钟同步,长时间运行可能累积漂移
– **扩展性边界**:仅支持四种基础调度类型,复杂规则(如”每月最后一个工作日”)可能无法表达
## 适合人群
– 注重数据隐私、拒绝云服务的用户
– 需要简单重复提醒但不想配置系统级 crontab 的开发者
– 希望将日程意图”固化”为可检视执行计划的效率管理者
## 常规风险
– **数据丢失**:本地文件损坏或误删无法恢复,建议定期手动备份 `jobs.json`
– **执行遗漏**:若主机休眠或进程未持续运行,可能跳过预定执行点
– **权限问题**:脚本执行依赖本地 Python 环境,路径或权限变更会导致调度失败









