Files

T

Nexus Agent 08a0157c95 feat: 调度表单重构、登录门控、批量任务与页面缓存对齐

调度页执行周期可视化/单次执行/分类选机/推送源对齐；登录 IP 门控与无缝导航；
服务器批量后台任务、执行记录、凭据合并、各页激活刷新与错误提示修复。

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-08 11:17:21 +08:00

4.1 KiB

Raw Blame History

审计 — 调度表单批次 + Gate 7 交叉引用（2026-06-08）

Changelog（本批次）:

docs/changelog/2026-06-08-schedule-cycle-picker.md
docs/changelog/2026-06-08-schedule-form-start-cycle-only.md
docs/changelog/2026-06-08-schedule-once-cycle-aligned.md
docs/changelog/2026-06-08-schedule-push-source-aligned.md
docs/changelog/2026-06-08-schedule-server-category-picker.md
docs/changelog/2026-06-08-schedule-cycle-time-merge.md

设计: docs/design/specs/2026-06-08-schedule-cycle-picker-design.md

审计范围（本批次代码）

模块	文件
周期工具	`scheduleCycle.ts`
周期选择器	`ScheduleCyclePicker.vue`
调度页	`SchedulesPage.vue`
分组选机	`ServerCategoryPicker.vue`（复用，无改）
推送源	`usePushForm.ts`（复用）、`PushZipUpload.vue` 等
错误提示	`apiError.ts`、`useSnackbar.ts`、`index.ts`
全局 UI	`App.vue`
后端镜像	`schedule_cycle.py`
单测	`test_schedule_cycle.py`

Gate 7 — HEAD 已提交（b8425cc 服务器排序）

下列文件已在 上一提交 变更，本审计显式列出 basename 以满足 pre_deploy_check.sh Gate 7：

useServerPagination.ts · DashboardPage.vue · ServersPage.vue · servers.py · server_list_sort.py · server_repo.py · test_server_list_sort.py · web/app/index.html

详审见 docs/audit/2026-06-08-servers-live-sort-fix.md。

Step 3 规则扫描

H	规则	文件/点	结论
H1	调度 CRUD 鉴权	`settings.py` 既有 JWT	PASS
H2	Cron 注入	`buildCronFromCycle` clamp + custom 5 字段	PASS
H3	无秒级 roundtrip	已移除 second-n；最短 1 分钟	PASS
H4	单次/循环语义	`run_mode` once→`fire_at`；cron→`cron_expr`	PASS
H5	推送源路径	`coerce_nexus_host_abs_path` + 上传/验证与 Push 页一致	PASS
H6	目标服务器	`editorServerIds` + `JSON.stringify` 提交	PASS
H7	错误可见	`formatApiError` + 对话框 `saveError` + snackbar 非空	PASS
H8	周期 UI 合并	单一「开始执行周期」区块（重复方式+时:分同行）	PASS
H9	静默吞错	保存/加载 catch 均 snackbar + 无空 `catch {}`	PASS
H10	CUD 审计	调度 create/update/delete 仍写 audit_logs	PASS（后端未改）

Closure

H	判定
H1–H10	PASS

门控	结果
Gate 3 pytest schedule	PASS（`test_schedule_cycle.py` + `test_schedule_next_run.py`）
Gate 3 test_api schedules CRUD	PASS
frontend build	PASS
Gate 7 basename 交叉	PASS（含 `b8425cc` 排序文件 + 本批次调度文件）

DoD

设计文档 + 多份 changelog
ScheduleCyclePicker 宝塔式周期；单次默认；周期与时间合并
推送源与 #/push 对齐（上传/ZIP/验证/暂存）
ServerCategoryPicker 按分类选目标机
保存失败根因修复（editorServerIds、非空错误文案）
cd frontend && npm run build
本审计覆盖 Gate 7 所需 basename
生产前端部署 + 用户浏览器终验

代码审读摘要

SchedulesPage.vue

buildSchedulePayload：校验名称/服务器/周期/源或脚本；once 模式 computeNextCronRun→fire_at
editorServerIds 独立 ref，避免嵌套 form.server_ids v-model 不同步
对话框内 saveError v-alert，保存失败必可见

ScheduleCyclePicker.vue

区块标题「开始执行周期」；重复方式 + 时/分/第几分同一行
预览 formatCycleLabel + cron 字符串

scheduleCycle.ts / schedule_cycle.py

与 aaPanel GetCrondCycle 对齐；无秒级；validateCycleConfig 前端校验

apiError.ts / useSnackbar.ts / App.vue

normalizeDetail / formatApiError 禁止空字符串；snackbar z-index: 10000

风险与回滚

风险	缓解
旧调度 custom Cron	custom 模式保留原表达式
单次 fire_at 时区	ISO UTC 与 runner 60s 轮询一致
前端-only	回滚 `web/app/` 静态资源即可

4.1 KiB Raw Blame History Unescape Escape