Nexus/docs/changelog/2026-06-08-schedule-cycle-picker.md

2026-06-08 — 调度执行周期可视化（对齐宝塔）

摘要

新建/编辑循环调度时，将「Cron 表达式（5 字段）」改为「执行周期」选择窗口：每天、每 N 天、每小时、每 N 小时、每 N 分钟、每 N 秒、每周、每月；一次性调度改为「指定日期（年-月-日 时:分）」。底层仍写入 cron_expr，与 schedule_runner 兼容。

动机

• 手工 Cron 门槛高、易错
• 宝塔 aaPanel 计划任务已验证该交互模式（crontab.py GetCrondCycle）

涉及文件

层	文件
前端工具	frontend/src/utils/scheduleCycle.ts
组件	frontend/src/components/schedules/ScheduleCyclePicker.vue
页面	frontend/src/pages/SchedulesPage.vue
后端镜像	server/utils/schedule_cycle.py
测试	tests/test_schedule_cycle.py
设计	docs/design/specs/2026-06-08-schedule-cycle-picker-design.md

是否需迁移/重启

• 否 — 仅前端 UI + 工具函数；cron_expr 字段不变
• 前端需 vite build 后部署

验证方式

pytest tests/test_schedule_cycle.py tests/test_schedule_next_run.py -q
cd frontend && npm run build

• 新建调度 → 选「每天 02:00」→ 列表显示「每天 02:00」
• 编辑 0 2 * * * 旧任务 → 表单反解析为每天
• 无法识别 Cron → 自定义模式保留原表达式

行为说明

• 每 N 秒：调度引擎 60 秒轮询，N 秒折算为 ceil(N/60) 分钟 Cron 步进
• 每 N 天：与宝塔一致，使用 */N 日字段（从每月 1 日起算）