Cron 表达式翻译官

解决什么具体问题

• crontab -e 里写了一行调度规则，但要在脑子里来回拆字段才能确定它到底什么时候跑
• CI 定时任务、K8s CronJob 或调度器里只给了一个表达式，担心下一次触发落在非工作时段
• 看到字段越界、写法奇怪时，只能靠记忆判断，容易误判成另一个时间规则

这个技能把标准 5 字段 cron 翻译成中文语义，并按分钟遍历推算未来多次执行时间，减少“看错规则”的风险。

它如何工作

核心能力集中在三处：

• 语义翻译：把 分 时 日 月 周 转成中文描述，解释各字段的限制和组合含义
• 执行时间推算：真实遍历时间，输出未来若干次触发点并附带星期，不是凭规则猜
• 合法性校验：字段数量错误、取值越界时明确报错，定位问题字段并给出修正建议

推荐工作流很直接：

• 从消息里提取 5 字段 cron 表达式
• 运行 python3 scripts/cron_tool.py explain "" --count 5
• 把中文含义和未来执行时间一起返回；若报错，指出具体字段与修改方向

适用边界与注意点

• 仅支持标准 5 字段 cron，不处理 Quartz 的 6/7 字段（含秒、年）
• 不解析 L、W、# 等特殊符号；语法范围覆盖 *、,、-、/
• ? 等价于 *；星期 0 或 7 均表示周日
• 执行时间按运行机器的本地时区计算
• 当“日”和“星期”都被限制时，按 cron 惯例取或关系（任一满足即触发）
• 纯本地计算，不联网，也不采集任何数据