dsh-cron

在 DSH Automation 生态中，事件驱动触发由 dsh-webhook 覆盖，但按分钟、按天、按固定时刻发起一次 Agent 会话的时间驱动场景此前缺少独立的触发器层。dsh-cron 正是为此而生：它是一个持久化日历适配器，将五字段 cron 表达式、RFC 3339 一次性时间戳或带 IANA 时区的周期性计划统一转化为幂等的新 Session Run 提交给 Automation 引擎，自身不执行任何 Agent 回合。

核心设计围绕确定性展开。每个日历实例在提交前即落盘，生成由 job id 与计划时刻派生的稳定标识；若进程在 Automation 已提交但源存储尚未写入 Run id 时崩溃，重启后以同一幂等键重新提交即获得同一条 Run，杜绝重复执行。错过的周期实例采用仅最新追补策略，一次性任务触发后保留为持久历史。多进程部署时，仅持有调度锁的进程负责武装定时器与对账，其余进程提供管理服务并在锁持有人退出后无缝接管；管理写入使用独立短锁与三向合并，避免覆盖或删除冲突。

适合需要以 cron 粒度编排 Agent 工作流的团队，尤其是多 worker 环境、跨时区调度、要求崩溃恢复与幂等保证的生产部署。若已在用 dsh-automation 跑事件驱动流水线，dsh-cron 可无缝补定时触发这一半，二者共同构成完整的时间与事件双触发体系。