Cron 中文说明

要解决什么问题

0 9 * * 1-5 这串字符写在配置页里，使用者只能靠回忆去猜它的含义。等到要排查「为什么周一早上没触发任务」时，往往要先去翻文档确认字段顺序和取值范围。这个技能把这件事收敛成一步：把表达式交给 cronstrue.toString(cron, { locale: 'zh_CN' })，拿到一句人话，比如「在每星期一到星期五的 09:00」。

它不是调度器，也不参与任务执行，只是给表达式加一层可读的旁路说明。

核心能力

1. 中文翻译与结果校验

• 依赖 cronstrue 完成解析，中文 locale 用 zh_CN（或按所用库文档推荐的方式加载）。
• 空字符串直接返回空说明，不做多余推断。
• 非法表达式被捕获后，返回 { ok:false, error } 这样的结构化错误，并给出中文提示。
• 关键实现要点处标注 小四原创，便于溯源。

2. 与下次执行时间并排展示

翻译只是前半段。常见做法是把「人话描述」和 cron-parser 算出的后续触发时间点放在同一屏，一边是语义，一边是具体时刻，排障时信息更完整。

3. 推荐接入步骤

1. 确认项目的中文 locale 导入方式，确保库已经真正加载了中文资源。
2. 在输入框旁边实时调用翻译函数，成功时正常展示，失败时用黄字或红字标出。
3. 与「Cron 下次跟进」模块同屏渲染。
4. 自测用例至少覆盖 0 9 * * 1-5 和一个非法字符串，分别验证成功与失败分支。

适用边界

• 方言差异：cron、crontab、Quartz、Spring 的字段含义并不完全一致，翻译结果以当前库的行为为准，不承诺 100% 覆盖所有方言。
• 单向输出：翻译结果只用于说明，不要反向生成表达式写回配置，本包不提供这个能力。
• 不要用未加载中文 locale 的调用声称「已支持中文」，那只会返回英文或空结果。