From defd118ea6e4594803e15d47df3bc957859e7e12 Mon Sep 17 00:00:00 2001 From: ThearchyHelios Date: Mon, 5 Oct 2026 10:26:22 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=9A=E6=97=B6=E4=BB=BB=E5=8A=A1=E5=89=8D?= =?UTF-8?q?=E7=AB=AF=E5=A4=8D=E6=A0=B8=E4=BF=AE=E6=AD=A3=EF=BC=88=E7=AC=AC?= =?UTF-8?q?=201=20=E8=BD=AE=EF=BC=89=EF=BC=9A=E6=97=B6=E5=8C=BA=E6=A3=80?= =?UTF-8?q?=E6=9F=A5=E6=94=B9=E6=88=90=E7=9C=9F=E8=83=BD=E6=8B=A6=E4=BD=8F?= =?UTF-8?q?=EF=BC=8C=E6=9C=8D=E5=8A=A1=E7=AB=AF=E4=BC=9A=E6=8B=92=E7=9A=84?= =?UTF-8?q?=E7=BB=84=E5=90=88=E5=BD=93=E5=9C=BA=E6=8B=A6=E4=B8=8B=EF=BC=8C?= =?UTF-8?q?=E4=BF=AE=E5=87=A0=E5=A4=84=E6=97=B6=E5=BA=8F=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - check-schedules:浏览器本机时区改成 America/Los_Angeles,和夹具里的 Asia/Shanghai、America/New_York 都不同。列表的下次运行和上次触发、触发历史 20 行、预览 5 个时刻,都改为比对按定时任务时区写出的原文;假预览照真服务端那样按所选时区排时刻。把页面改成按本机时区显示的变异会让 6 项变红。原先恒为真的「只读」断言改为真正检查写请求。 - 测试消息的结果:服务端的 message 只是补充说明时接在结局后面,已经是整句时不再套一层,状态码只写一次(webhookTestText)。 - 正式运行 + 工作流没发布、必填输入没填、填了已发布版本里没有的字段:照服务端保存时的核对规则当场拦下(新建总查;修改只在改了工作流、运行类别或输入时查),说明写在对应那一项下面。保存被拒、服务端指明 run_class 或 misfire_grace_s 时,说明也写在那一项下面。 - 保存被 422 拒绝后,改了被指出的那一项,字段下的说明和底部的「保存失败」就收起;名称框的 aria-invalid 和 aria-describedby 也把服务端的说明算进去。 - 时序:列表和详情页在写操作成功时作废还在路上的读,晚到的刷新不再把开关盖回旧值。详情页先开触发历史再切到设置时,版本对齐到表单所基于的那一份。保存途中又改了别的字段时,只保留途中改的那几项,替换过的 Webhook 地址不再以明文留在输入框里。 - 其他:预览时间改用 parseServerTime 解析;换工作流时,自动填的名称跟着换;开关遇到 409 用前端自己的说明,服务端原话放进详情;错过且超出宽限、没有补发的触发,类型写「定时」而不是「补发」;记录页的「定时」标记让读屏念出是哪个定时任务发起的。 - 未达标:记录页的「定时」标记在整行的按钮里面,键盘到不了。键盘能到的入口要加在运行详情的页头,或者把整行改成「打开运行」按钮和链接并排的结构,这两处都不在本包的文件范围内,留给集成时处理。 --- frontend/src/lib/terms.ts | 33 +- .../src/pages/schedules/ScheduleDetail.tsx | 22 +- .../src/pages/schedules/ScheduleEditor.tsx | 140 +++-- .../src/pages/schedules/SchedulesPage.tsx | 15 +- .../src/pages/schedules/WebhookFields.tsx | 6 +- frontend/src/pages/schedules/model.ts | 136 ++++- frontend/src/pages/schedules/parts.tsx | 30 +- scripts/check-all.mjs | 2 +- scripts/check-schedules.mjs | 506 ++++++++++++++++-- 9 files changed, 771 insertions(+), 119 deletions(-) diff --git a/frontend/src/lib/terms.ts b/frontend/src/lib/terms.ts index 0476d596..c3c1e80e 100644 --- a/frontend/src/lib/terms.ts +++ b/frontend/src/lib/terms.ts @@ -2776,8 +2776,8 @@ export const SCHEDULE_TEXT = { deleteConsequences: ['不再按计划发起运行,删除后不可恢复', '已发起的运行及其记录不受影响'], deleteConfirm: '删除定时任务', deleted: (name: string) => `已删除定时任务「${name}」`, - /** 写操作遇到 409:服务端的原话后面接这句 */ - conflictReloaded: '已重新载入最新设置,请确认后再操作', + /** 启用开关遇到版本不符(409):服务端那句是写给表单保存的,开关用这句,原话放进详情 */ + toggleConflict: (name: string) => `「${name}」已在别处被修改,已重新载入最新状态,请确认后再切换`, // ---- 立即运行的结果 runStarted: '已发起运行', @@ -2792,6 +2792,8 @@ export const SCHEDULE_TEXT = { manual: '手动「立即运行」', misfire: '错过触发时间后,在补发宽限内恢复时补发的一次', } as Record, + /** 错过且超出补发宽限、没有补发的(服务端记 kind=misfire、status=skipped_misfire):类型按「定时」写 */ + fireKindMissedHint: '按计划应在此时触发,错过后已超出补发宽限,没有补发', fireStatus: { started: '已发起', skipped_overlap: '上次未结束已跳过', @@ -2868,7 +2870,8 @@ export const SCHEDULE_TEXT = { formalVersion: (v: number) => `每次按当时的发布版本发起,当前为 v${v}`, exploratory: '探索运行', exploratoryHint: '使用工作流当前保存的内容,结果不出具', - notPublished: '这个工作流尚未发布:到点时无法发起正式运行,会记为发起失败。请先发布,或改用探索运行', + /** 已保存的定时任务、这次没动工作流和运行类别,工作流后来撤了发布:保存照常,到点会发起失败 */ + notPublished: '这个工作流目前没有发布版本:到点时无法发起正式运行,会记为发起失败。请先发布,或改用探索运行', // ---- 表单:输入 inputs: '输入', @@ -2880,7 +2883,10 @@ export const SCHEDULE_TEXT = { inputsFromVersion: (v: number) => `字段取自已发布的 v${v}`, inputsFromDraft: '字段取自工作流当前保存的内容', required: '必填', + /** 已保存的定时任务、这次没动输入:保存照常,留空到点会发起失败 */ requiredNoDefault: '必填且没有默认值:留空时到点会发起失败', + /** 新建、或者这次改了工作流、运行类别、输入:服务端保存时就会拒 */ + requiredFill: '必填且没有默认值,请填写后再保存', defaultValue: (v: string) => `默认:${v}`, variables: '插入变量', variablesClose: '收起变量', @@ -2890,6 +2896,10 @@ export const SCHEDULE_TEXT = { rendered: (v: string) => `下次触发时为:${v}`, renderedEmpty: '下次触发时为空', staleField: '工作流中已没有这个字段', + /** 画布上有、正式运行用的已发布版本里没有 */ + staleNotInVersion: (v: number) => `已发布的 v${v} 中没有这个字段`, + /** 接在上面两句后面:交上去会被拒 */ + staleRemove: '保存前请移除', removeField: '移除', // ---- 表单:重叠与补发 @@ -2945,8 +2955,11 @@ export const SCHEDULE_TEXT = { testing: '正在发送…', testNeedSave: '保存后才能发送测试消息', testDirty: '测试使用已保存的设置,请先保存修改', - testOk: (status: number | null, message: string) => `测试消息已送达${status != null ? `(HTTP ${status})` : ''}${message ? `:${message}` : ''}`, - testFailed: (status: number | null, message: string) => `测试消息发送失败${status != null ? `(HTTP ${status})` : ''}${message ? `:${message}` : ''}`, + testOk: '测试消息已送达', + testFailed: '测试消息发送失败', + /** 结局后面接状态码和说明(两样都可能没有) */ + testResult: (head: string, status: number | null, detail: string) => + `${head}${status != null ? `(HTTP ${status})` : ''}${detail ? `:${detail}` : ''}`, // ---- 通知里的运行链接(设置 notify 组,所有定时任务共用) linkBase: '通知中的运行链接', @@ -2997,11 +3010,15 @@ export const SCHEDULE_TEXT = { urlInvalid: '请输入以 http:// 或 https:// 开头的地址', secret: '请填写新的签名密钥', events: '至少选择一个事件', + notPublished: '这个工作流还没有发布版本,正式运行需要已发布的版本。请先发布,或改用探索运行', + inputsMissing: (names: string) => `必填输入「${names}」还没有填写`, + inputsUnknown: (names: string) => `输入「${names}」对不上工作流的输入字段,请移除`, }, /** 「还需处理」里各项的叫法 */ problemField: { - name: '名称', workflow: '工作流', freq: '频率', timezone: '时区', url: 'Webhook 地址', secret: '签名密钥', events: '通知事件', - } as Record<'name' | 'workflow' | 'freq' | 'timezone' | 'url' | 'secret' | 'events', string>, + name: '名称', workflow: '工作流', freq: '频率', timezone: '时区', runClass: '运行类别', inputs: '输入', url: 'Webhook 地址', + secret: '签名密钥', events: '通知事件', + } as Record<'name' | 'workflow' | 'freq' | 'timezone' | 'runClass' | 'inputs' | 'url' | 'secret' | 'events', string>, // ---- 相对时间(将来) until: { @@ -3029,6 +3046,8 @@ export const SCHEDULE_TEXT = { // ---- 记录页的定时标记 runTag: '定时', runTagTitle: (name?: string | null) => (name ? `由定时任务「${name}」发起,点击查看` : '由定时任务发起,点击查看'), + /** 读屏念的来源(整行是打开运行的按钮,标记本身点不到,至少在名字里听到) */ + runTagSr: (name?: string | null) => (name ? `由定时任务「${name}」发起` : '由定时任务发起'), } /** 运行对比:记录页里两次运行的对照。配方前后对照另有 COMPARE_TEXT,别混用 */ diff --git a/frontend/src/pages/schedules/ScheduleDetail.tsx b/frontend/src/pages/schedules/ScheduleDetail.tsx index 653646f8..bb5f3a2b 100644 --- a/frontend/src/pages/schedules/ScheduleDetail.tsx +++ b/frontend/src/pages/schedules/ScheduleDetail.tsx @@ -45,7 +45,8 @@ type TabKey = 'settings' | 'history' * 和触发历史(?tab=history)。切到触发历史时表单不卸载,改到一半的内容还在。 * * 两份状态分开记:schedule 是页头和摘要显示的、随时可以刷新的最新值;version 是表单保存时带的版本,只跟着自己的 - * 写操作(开关、保存)和明确的「重新载入」走。别人在这期间改过时表单保存就该 409,不能因为页头顺手刷新过就悄悄覆盖 + * 写操作(开关、保存)和明确的「重新载入」走。别人在这期间改过时表单保存就该 409,不能因为页头顺手刷新过就悄悄覆盖。 + * 唯一的例外是表单第一次挂上的那一刻:表单基于的就是那时的 schedule,版本对齐到它 */ export function ScheduleDetailPage({ id }: { id: string }) { const navigate = useNavigate() @@ -62,11 +63,19 @@ export function ScheduleDetailPage({ id }: { id: string }) { const [busy, setBusy] = useState(null) const now = useTicker(30_000) const loaded = useRef(false) + /** + * 读的序号:后发的读胜过先发的读;开关、保存成功时也加一,作废还在路上的读。那次读可能在写之前读到旧值、 + * 在写的答复之后才回来,落地会把页头的开关、名字盖回旧的(详情页没有定时刷新,错的会一直挂着) + */ + const seq = useRef(0) + const wrote = () => { seq.current++ } /** 读最新的定时任务,读到了返回 true。adopt:表单保存时也改用它的版本(首次打开、重新载入) */ const load = useCallback(async (adopt: boolean): Promise => { + const n = ++seq.current try { const s = await api.schedules.get(id) + if (n !== seq.current) return false rememberScheduleNames([s]) setSchedule(s) setError(null) @@ -74,6 +83,7 @@ export function ScheduleDetailPage({ id }: { id: string }) { loaded.current = true return true } catch (e) { + if (n !== seq.current) return false // 读到过之后刷新失败:页头照旧显示手上的,只在首次打开时整页报错 if (!loaded.current || (e instanceof ApiError && e.status === 404)) setError(e) else if (adopt) toast.error(e) @@ -90,6 +100,14 @@ export function ScheduleDetailPage({ id }: { id: string }) { if (tab === 'history') setHistorySeen(true) else setSettingsSeen(true) }, [tab]) + // 表单第一次挂上时版本对齐到此刻的 schedule(渲染中改状态,React 当场重渲染,表单挂上时两者已经一致)。 + // 直接打开触发历史时表单要等切过来才挂,这期间页头可能已经刷新过(立即运行之后、重连、开关冲突之后), + // 表单显示的是刷新后的内容,还拿首次打开时的版本保存就会撞上并不存在的 409 + const [formBased, setFormBased] = useState(false) + if (settingsSeen && schedule && !formBased) { + setFormBased(true) + if (version !== schedule.version) setVersion(schedule.version) + } const pickTab = (k: string) => setParams((p) => { const next = new URLSearchParams(p) @@ -111,6 +129,7 @@ export function ScheduleDetailPage({ id }: { id: string }) { const out = await setEnabled(s, enabled) if (out === 'conflict') await load(false) else if (out) { + wrote() setSchedule(out) // 表单的版本只在开关前后没有别人插进来时跟着走:页头是在别人改过之后刷新出来的,表单还是旧的那份, // 照旧带旧版本,保存时由服务端说清 @@ -189,6 +208,7 @@ export function ScheduleDetailPage({ id }: { id: string }) { schedule={schedule} version={version} onSaved={(s) => { + wrote() rememberScheduleNames([s]) setSchedule(s) setVersion(s.version) diff --git a/frontend/src/pages/schedules/ScheduleEditor.tsx b/frontend/src/pages/schedules/ScheduleEditor.tsx index bbe8b216..6250fd75 100644 --- a/frontend/src/pages/schedules/ScheduleEditor.tsx +++ b/frontend/src/pages/schedules/ScheduleEditor.tsx @@ -5,15 +5,15 @@ import clsx from 'clsx' import { ApiError, api } from '../../api/client' import { Field, Notice, Skeleton, Spinner, confirmDialog, toast, useRadioGroup } from '../../components/ui' import { errorMessage } from '../../lib/errors' +import { parseServerTime } from '../../lib/format' import { useLeaveGuard } from '../../lib/leave' import { SCHEDULE_TEXT as T } from '../../lib/terms' import { useCatalog, useCatalogListState } from '../../store/catalog' -import type { - Schedule, SchedulePreview, ScheduleRunClass, ScheduleVariable, Workflow, WorkflowVersion, -} from '../../types' +import type { Schedule, SchedulePreview, ScheduleRunClass, ScheduleVariable, Workflow } from '../../types' import { FREQ_PRESETS, GRACE_OPTIONS, HOUR_STEPS, WEEKDAY_ORDER, createBody, cronOf, formOf, formProblems, formatZoned, freqProblem, - graceLabel, patchBody, templateOf, timezoneOptions, type Freq, type FormField, type FreqPreset, type ScheduleForm, + graceLabel, graphFields, patchBody, rebaseForm, serverFieldValue, templateOf, timezoneOptions, type Freq, type FormField, + type FreqPreset, type InputField, type ScheduleForm, } from './model' import { isUnsupported } from './parts' import { WebhookFields } from './WebhookFields' @@ -42,8 +42,16 @@ export function ScheduleEditor({ schedule, version, onSaved, onReload }: { const [touched, setTouched] = useState>>({}) /** 新建时没动过运行类别:选工作流时按它发没发布替人选上 */ const runClassTouched = useRef(!!schedule) + /** 名称是选工作流时替人填的哪个名字:人没改过它时,换工作流名称跟着换;人改过就不再动 */ + const autoName = useRef(null) const [saving, setSaving] = useState(false) - const [saveError, setSaveError] = useState<{ message: string; detail?: string; conflict?: boolean; field?: string } | null>(null) + /** + * 上一次保存的失败。field 是服务端 422 指的那一项,at 是交上去时那一项的值(serverFieldValue): + * 人改了那一项,说明就不再摆着,免得看上去新值也不行 + */ + const [saveError, setSaveError] = useState<{ + message: string; detail?: string; conflict?: boolean; field?: string; at?: string | null + } | null>(null) const workflow = workflows.find((w) => w.id === form.workflowId) const cron = cronOf(form.freq) @@ -54,8 +62,14 @@ export function ScheduleEditor({ schedule, version, onSaved, onReload }: { const fields: FieldsState = !workflow && form.workflowId && workflowsState !== 'ok' ? { status: 'loading' } : fieldsOf const variables = useVariables() - const problems = formProblems(form, base) const changes = base ? patchBody(form, initial, base) : null + // 服务端保存时只在新建、或者改了工作流、运行类别、输入时才核对这三样:照着拦,不多拦也不少拦 + const recheck = !base || (!!changes && ('workflow_id' in changes || 'run_class' in changes || 'input_template' in changes)) + const problems = formProblems(form, base, { + published: workflow ? workflow.published_version ?? null : undefined, + fields: fields.status === 'ok' ? fields.fields : undefined, + recheck, + }) const dirty = base ? changes != null : JSON.stringify(form) !== JSON.stringify(initial) const previewField = preview.status === 'invalid' ? preview.field : undefined /** 预览判定非法、并指明是这一项时,服务端的说明 */ @@ -73,14 +87,20 @@ export function ScheduleEditor({ schedule, version, onSaved, onReload }: { const setFreq = (patch: Partial) => setForm((f) => ({ ...f, freq: { ...f.freq, ...patch } })) const touch = (k: FormField) => setTouched((t) => (t[k] ? t : { ...t, [k]: true })) - const pickWorkflow = (w: Workflow) => setForm((f) => { - if (w.id === f.workflowId) return f - // 换了工作流:新工作流里没有的字段的模板丢掉(同名的留着),名字空着时用工作流名 - const keep = new Set(graphFields(w.graph).map((x) => x.name)) - const inputs = Object.fromEntries(Object.entries(f.inputs).filter(([k]) => keep.has(k))) - const runClass: ScheduleRunClass = runClassTouched.current ? f.runClass : w.published_version ? 'formal' : 'exploratory' - return { ...f, workflowId: w.id, name: f.name.trim() ? f.name : w.name, inputs, runClass } - }) + const pickWorkflow = (w: Workflow) => { + if (w.id === form.workflowId) return + // 名字空着、或者还是上次替人填的工作流名:跟着换成新工作流的名字。在这里判、不在 setForm 的回调里改 ref: + // 回调在严格模式下会调两遍 + const follow = !form.name.trim() || form.name === autoName.current + if (follow) autoName.current = w.name + setForm((f) => { + // 换了工作流:新工作流里没有的字段的模板丢掉(同名的留着) + const keep = new Set(graphFields(w.graph).map((x) => x.name)) + const inputs = Object.fromEntries(Object.entries(f.inputs).filter(([k]) => keep.has(k))) + const runClass: ScheduleRunClass = runClassTouched.current ? f.runClass : w.published_version ? 'formal' : 'exploratory' + return { ...f, workflowId: w.id, name: follow ? w.name : f.name, inputs, runClass } + }) + } const save = async () => { if (!canSave) return @@ -99,8 +119,9 @@ export function ScheduleEditor({ schedule, version, onSaved, onReload }: { const next = formOf(saved) setBase(saved) setInitial(next) - // 保存的这段时间里人又改了:留着新改的,它们相对刚存下的设置照样算未保存 - setForm((cur) => (cur === sent ? next : cur)) + // 保存的这段时间里人又改了:只留途中改的那几项(相对刚存下的设置照样算未保存),其余换成刚存下的。 + // 整份留着的话,交上去的替换地址会以完整明文留在框里,下次保存再发一遍 + setForm((cur) => rebaseForm(cur, sent, next)) setTouched({}) if (base) toast.ok(T.saved) onSaved(saved, !base) @@ -110,7 +131,7 @@ export function ScheduleEditor({ schedule, version, onSaved, onReload }: { } else if (isUnsupported(e)) { setSaveError({ message: T.unsupportedHint }) } else if (e instanceof ApiError && e.kind === 'http' && e.status >= 400 && e.status < 500) { - setSaveError({ message: e.message, field: e.field }) + setSaveError({ message: e.message, field: e.field, at: e.field ? serverFieldValue(e.field, sent) : null }) } else { toast.error(e) } @@ -132,9 +153,12 @@ export function ScheduleEditor({ schedule, version, onSaved, onReload }: { setSaveError(null) } - // 保存被 422 拒了、服务端指了是哪一项:写在那一项下面 - const serverError = (keys: string[]) => (saveError?.field && keys.includes(saveError.field) ? saveError.message : undefined) + // 保存被 422 拒了、服务端指了是哪一项:写在那一项下面;那一项改过之后不再摆着(认不出的项留到下次保存) + const stillSays = !!saveError && (saveError.at == null || !saveError.field || serverFieldValue(saveError.field, form) === saveError.at) + const serverError = (keys: string[]) => (stillSays && saveError?.field && keys.includes(saveError.field) ? saveError.message : undefined) const shown = (k: FormField) => (touched[k] ? problems[k] : undefined) + const nameError = shown('name') ?? serverError(['name']) + const misfireError = serverError(['misfire_grace_s']) return (
- + set({ name: e.target.value })} onBlur={() => touch('name')} data-field="name" />
- { runClassTouched.current = true; set({ runClass }) }} /> set({ inputs })} />

{T.overlap}

{T.overlapText}

- +