dsh-cron-parse

dsh-cron-parse

DSH 插件：解析 5 段标准 cron 表达式，提供校验、中文人性化描述、各字段展开值，以及未来若干次运行时间预览。纯 ESM、零依赖、无构建。

安装

sh
dsh plugin --profile <name> add file:./plugins/dsh-cron-parse
或 npm 发布后：dsh plugin --profile <name> add dsh-cron-parse

安装后组合层会挂载 cron_parse 工具（cron-parse 层 id）。

工具：cron_parse

参数：

| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| expression | string | 是 | 5 段标准 cron：minute hour dayOfMonth month dayOfWeek |
| count | number | 否 | 未来运行次数（1–10），默认 5 |
| tz | string | 否 | IANA 时区名（如 Asia/Shanghai、UTC），默认本地时区 |
| now | string | 否 | ISO 8601 基准时间，默认当前时间 |

返回规范值：{ ok, valid, description, fields: { minute, hour, dom, month, dow }, nextRuns, timezone, errors }。

支持语法表

| 语法 | 示例 | 含义 |
|---|---|---|
| | | 全部取值 |
| /n | /15（分钟） | 每 n（自最小值起） |
|