diff --git a/docs/vision-continuity-integration.md b/docs/vision-continuity-integration.md index f780285..c8ae33f 100644 --- a/docs/vision-continuity-integration.md +++ b/docs/vision-continuity-integration.md @@ -1,6 +1,6 @@ # 首帧审核与固定几何连续性接入 -日期:2026-11-07。前端起点 `dbf97e6f`,只读核对后端 `6721a4df`,本轮不修改后端。 +日期:2026-11-07。前端起点 `dbf97e6f`,只读核对后端 `6721a4df`;完整执行历史增量对接后端 `b254cfca`,本轮不修改后端。 ## 已接入 @@ -8,7 +8,7 @@ - 候选历史展示 `legacyTermination` 的原状态、终止时间、审计编号、费用结论和新授权要求。终止不改写原始审核,不解除 Primary 门禁。 - 独立新审核只传 `legacyVisionAuthorizationId`;物理专项补跑同时传原任务、请求指纹和 `physicalRetryAuthorizationId`。均须手动输入已有授权、明确勾选费用并从弹窗底栏提交,不提供签发入口,不自动重试。 - 202 只观察已受理执行。200 按实际质量与来源结果展示;409 刷新历史并保留任务及费用门禁。执行完成、质量通过和正式 Primary 分别表达。 -- 多次执行保持审核任务身份,采用历史返回的最新执行,保留本机曾观察到的旧执行编号。已被更新执行取代的本机旧提交不会永久保留未知状态锁。 +- 多次执行保持原审核任务身份,按需读取正式分页接口;不再读写本机执行历史缓存。当前执行只按服务端指针标记,逐次步骤、复用来源与计量分别展示。已有未结提交的会话保护继续保留。 - 分镜设计与生产页复用一个全屏连续性审核抽屉,当前集正式顺序连续选择两到三镜,并从正式生成规格求共同 Scene Form。展示 Primary、原图、摄影设计、布局母版、场景形态当前性及原始来源依据。 - 人工分别填写观察面、地标顺序、固定结构位置或数量及其证据。未知明确保留;不把开关门即时状态自动投影成固定结构变化。免费诊断支持 passed、failed、needs_review、insufficient_evidence、stale。 - 审核保存绑定本次已诊断观察的来源指纹,编辑后须重新诊断。刷新可恢复本机最近审核编号,也可手动读取其他正式编号。回读分别展示审核人、时间、原始结论和当前失效原因,不修改 Primary。 @@ -18,15 +18,15 @@ ## 后端契约限制 -### 同一审核任务的完整执行历史尚无公开读取能力 +### 完整执行历史已接入正式分页接口 -`GET /storyboard-shots/:shotId/keyframes/:keyframeId/validations` 经 `shot-keyframe-asset.service.ts` 与 `readVisionRecovery()` 仅投影任务当前 `executionId`。项目工作流路由只有 latest 与 events,单执行路由需要已知编号,没有按 `validationTaskId` 枚举全部执行的接口。物理专项授权的旧执行及旧回执虽保存在内部审计记录,当前历史 DTO 未公开。 +后端 `b254cfca` 新增 `GET /storyboard-shots/:shotId/keyframes/:keyframeId/validations/:validationTaskId/executions`。前端按原审核任务展开读取,显式传项目和每页 20 条,原样传回 nextCursor;刷新首屏或切换范围废弃旧游标及迟到响应。不以 total 推断下一页。 -因此本轮实现的是:正式最新执行恢复 + 本机已实际观察到的执行记录。不能宣称从新浏览器完整找回未曾观察到的旧执行。后续需要后端正式提供任务执行列表及其公开摘要;本轮未猜测 URL,也未新增后端接口。 +本机历史模块已移除。当前执行仅依据正式 currentExecutionId/isCurrent;关联未记录或不可用、旧执行缺步骤快照时明确显示未知,不把第一条当当前执行。General 复用的原用量和来源与本次新调用分开,不重复计量。旧失败不覆盖当前执行,执行完成与质量待复核、失败、通过分别表达。 -### 专项补跑入口按公开证据提供,最终资格由后端确认 +无法恢复的旧证据仍按后端契约返回 unknown/null/not_recorded。历史 metadata 缺少完整关联的行不会被猜测纳入;这属于历史证据边界,不能依靠当前任务结果补齐。 -步骤摘要含完成状态、issues、用量,但没有 General 的独立 passed 字段及完整 Physical 原始失败回执。前端仅在最新任务 General 已完成且无硬问题、Physical 失败且有计量时提供已有授权输入,文案明确为“补跑要求”。正式授权受理后才能确认原 General 通过并显示本次单步范围。实际原图、来源、模型、原费用回执与一次性授权继续由后端核对;不向用户伪造缺失证据。 +新页与原候选摘要共用步骤组件;后台摘要刷新不卸载已展开的执行列表。现有 GET/SSE 仅更新相同执行,逐次步骤始终由正式历史接口读取;没有新增列表 SSE 或改变授权、费用和 Primary 门禁。 ## 验证边界 @@ -35,3 +35,12 @@ 本地 Chrome 复用已有 `localhost:4312` 标签页:真实项目只读核对三张 Primary、正式设计、当前布局与来源失效;写入交互使用临时隔离页面拦截全部 API,验证布局正式确认与审核失效保留原结论。检查桌面、390 × 844 手机、长内容滚动、固定底栏、深浅主题及授权按钮禁用/确认状态。临时验收文件在提交前移除。 真实付费 Provider 调用为 0,未提交真实授权、连续性审核或布局修改,未改动正式数据。 + + +## 完整执行历史增量验证 + +本轮使用正式 DTO 的 Mock 补充 API、分页状态和真实 Vue 组件回归,覆盖按需读取、缓存失效、游标原样传回、同时间顺序、翻页取消、资源切换迟到 404、当前指针不在本页、证据缺失、复用计量、终态刷新、400/404/409、人工终止旧任务和摘要刷新保留展开状态。所有读取均为 GET,没有触发新审核、授权消费或 Primary 修改。 + +Chrome 复用 localhost:4312 标签页,在临时隔离页面检查桌面及 iPhone SE 375×667、长内容滚动、固定关闭入口、分页结束、深浅主题和指针不可用/旧任务空历史/证据冲突状态。临时页面在提交前删除。 + +常驻本机服务的只读核对:候选原历史可读,但新 executions 路由返回 Cannot GET 的 404,说明该进程尚未加载新路由;未重启服务,未写正式数据。页面新接口成功、翻页和异常状态由隔离 Mock 验收,正式运行需后端服务加载已推送的版本。 diff --git a/src/features/production/components/KeyframeExecutionHistory.vue b/src/features/production/components/KeyframeExecutionHistory.vue new file mode 100644 index 0000000..3d2f6d8 --- /dev/null +++ b/src/features/production/components/KeyframeExecutionHistory.vue @@ -0,0 +1,191 @@ + + + diff --git a/src/features/production/components/KeyframeExecutionStatus.vue b/src/features/production/components/KeyframeExecutionStatus.vue index f517e08..4871ec6 100644 --- a/src/features/production/components/KeyframeExecutionStatus.vue +++ b/src/features/production/components/KeyframeExecutionStatus.vue @@ -8,10 +8,15 @@ import { userFacingText } from '../../../lib/user-facing-text' import { formatDate } from '../../../lib/format' /** 单次视觉审核执行状态,完成和质量通过分别表达。 */ -const props = defineProps<{ - /** 正式执行记录。 */ execution: WorkflowExecution - /** 只读刷新状态。 */ loading: boolean -}>() +const props = withDefaults( + defineProps<{ + /** 正式执行记录。 */ execution: WorkflowExecution + /** 只读刷新状态。 */ loading: boolean + /** 历史记录与当前观察使用不同标题。 */ title?: string + /** 历史列表统一刷新,不对每行重复放置按钮。 */ refreshable?: boolean + }>(), + { title: '当前审核执行', refreshable: true } +) /** 仅触发只读刷新。 */ const emit = defineEmits<{ refresh: [] }>() /** 只有明确质量通过且未标记恢复才使用成功语义。 */ @@ -26,26 +31,40 @@ const passed = computed( const label = computed(() => { if (passed.value) return '审核质量通过' if (props.execution.status === 'failed') return '执行失败,质量未确认' - if (props.execution.status === 'completed') - return props.execution.result?.passed === false ? '执行完成,质量未通过' : '执行完成,质量待核对' - return props.execution.status === 'pending' ? '等待审核' : '审核进行中' + if (props.execution.status === 'completed') { + const quality = props.execution.result?.qualityDecision + const labels: Record = { + failed: '质量未通过', + needs_review: '质量待复核', + stale: '审核来源已失效', + blocked: '质量受阻', + insufficient_evidence: '证据不足' + } + return `执行完成,${typeof quality === 'string' && labels[quality] ? labels[quality] : props.execution.result?.passed === false ? '质量未通过' : '质量待核对'}` + } + return props.execution.status === 'pending' + ? '等待审核' + : props.execution.status === 'running' + ? '审核进行中' + : '状态待确认' })

{{ label }} · {{ executionStageLabel(execution.stage) }}

-

已处理步骤:{{ execution.current }} / {{ execution.total }}

+

审核计划进度:{{ execution.current }} / {{ execution.total }}

尚无可确认的步骤进度。

执行编号:{{ execution.id }} · {{ formatDate(execution.updatedAt) }}

+

{{ userFacingText(execution.result.summary) }}

{{ userFacingText(execution.error) }}

diff --git a/src/features/production/components/KeyframeValidationHistory.vue b/src/features/production/components/KeyframeValidationHistory.vue index cf6b7be..8b293a5 100644 --- a/src/features/production/components/KeyframeValidationHistory.vue +++ b/src/features/production/components/KeyframeValidationHistory.vue @@ -5,13 +5,15 @@ import FeedbackMessage from '../../../components/ui/FeedbackMessage.vue' import ContextNotice from '../../../components/ui/ContextNotice.vue' import { computed, ref, watch } from 'vue' -import { NButton, NCollapse, NCollapseItem, NInput } from 'naive-ui' +import { NButton, NInput } from 'naive-ui' import { errorMessage } from '../../../lib/http' import ReadonlyInspection from '../../../components/ui/ReadonlyInspection.vue' import { useQuery } from '../../../composables/useQuery' import { formatDate } from '../../../lib/format' import { physicalRetryTarget, submitKeyframeVision, useKeyframeVision } from '../keyframe-vision' -import KeyframeExecutionStatus from './KeyframeExecutionStatus.vue' +import KeyframeExecutionHistory from './KeyframeExecutionHistory.vue' +import KeyframeValidationSteps from './KeyframeValidationSteps.vue' +import { validationStatusLabels as stepLabels } from '../validation-execution-labels' import { useActionMessage, showActionFeedback } from '../../../components/ui/useActionMessage' import { qualityApi } from '../quality-api' import { parseKeyframeValidationOutput, keyframeValidationPassed } from '../quality' @@ -54,7 +56,6 @@ const { execution, state, uncertain, - observedExecutions, submissionMode } = props.observation ?? useKeyframeVision(visionKey) /** 后台结束时同步刷新人工复核与候选状态。 */ @@ -67,19 +68,6 @@ watch( } } ) -/** 公开步骤状态的中文名称。 */ -const stepLabels: Record = { - pending: '等待', - running: '执行中', - received: '已收到回执', - completed: '完成', - failed: '失败', - needs_review: '需要人工核查' -} -/** 不显示内部模型名称作为审核步骤。 */ -const stepNames = { general: '通用画面', physical: '物理关系', gaze: '视线' } -/** 仅显示公开词元计量。 */ -const usageLabels = { inputTokens: '输入', outputTokens: '输出', totalTokens: '合计', reasoningTokens: '推理' } /** 复核证据仅在展开历史时读取,不触发 Vision 或写入审核结论。 */ const reviewQuery = useQuery(key, (value, signal) => { if (!value) return Promise.resolve(null) @@ -296,7 +284,7 @@ const records = computed(() => :collapsible="!initialOpen" :show-header="!initialOpen" title="首帧校验历史" - :loading="query.loading.value" + :loading="query.loading.value && !query.data.value" :error="query.error.value" @refresh=" () => { @@ -395,26 +383,9 @@ const records = computed(() =>

仅补跑物理专项

原通用检查已通过,原费用已记录;本次仅补跑一个物理步骤,不重复提交通用检查。

-

当前审核状态以以下正式执行及最新质量结论为准。

+

当前状态以审核结果及执行记录为准。

-

{{ execution.error.value }}

- - -

- 显示本机已观察到的执行;刷新会读取服务保存的最新执行。较早且未观察到的执行暂不可查询。 -

-

- 审核任务:{{ item.taskId }} · 执行:{{ item.executionId - }}{{ item.status ? ` · 观察时状态:${stepLabels[item.status] ?? '待确认'}` : '' }} -

-
-

: '暂无结论' }}

-

- 审核任务:{{ record.id - }} -

+

审核任务:{{ record.id }}

历史审核已人工终止,原任务状态:{{ stepLabels[record.status] ?? '待确认' }};未标记通过。

人工终止时间:{{ formatDate(record.legacyTermination.terminatedAt) }}

@@ -483,39 +451,16 @@ const records = computed(() => {{ userFacingText(issue.description) }}

- - - - - -
-
开始:{{ formatDate(step.startedAt) }}
-
完成:{{ formatDate(step.finishedAt) }}
-
请求编号:{{ step.requestId }}
-
模型服务请求编号:{{ step.providerRequestId }}
-
- {{ usageLabels[unit] }}词元:{{ count }} -
-
-
-
-
    -
  • - {{ issue.subjectRef ? issue.subjectRef + ' · ' : '' - }}{{ userFacingText(issue.description) }} -
  • -
-

- {{ step.issues ? '未发现问题。' : '暂无问题记录。' }} -

-

{{ userFacingText(step.error) }}

-
-
+ + + diff --git a/src/features/production/components/KeyframeValidationSteps.vue b/src/features/production/components/KeyframeValidationSteps.vue new file mode 100644 index 0000000..2cb773b --- /dev/null +++ b/src/features/production/components/KeyframeValidationSteps.vue @@ -0,0 +1,91 @@ + + + diff --git a/src/features/production/keyframe-vision.ts b/src/features/production/keyframe-vision.ts index f867281..1fc1553 100644 --- a/src/features/production/keyframe-vision.ts +++ b/src/features/production/keyframe-vision.ts @@ -3,7 +3,6 @@ import { useQuery } from '../../composables/useQuery' import { ApiError } from '../../lib/http' import type { WorkflowExecution } from '../workflows/execution.types' import { workflowExecutionApi } from '../workflows/execution-api' -import { rememberVisionExecutions, type ObservedVisionExecution } from './vision-execution-history' import { qualityApi } from './quality-api' import { isVisualValidation } from './quality' import type { KeyframeValidationHistoryItem, ResumeKeyframeValidation, KeyframeVisionInput } from './quality.types' @@ -225,11 +224,6 @@ export function useKeyframeVision(key: Ref, observeExecution = true) { ) watch(history.data, records => { - if (records && key.value) - rememberVisionExecutions( - key.value, - records.flatMap(item => (item.executionId ? [{ taskId: item.id, executionId: item.executionId }] : [])) - ) const saved = submission.value if (!records || !saved || saved.settled) return const latest = records[0] @@ -262,30 +256,6 @@ export function useKeyframeVision(key: Ref, observeExecution = true) { } }, 2500) onScopeDispose(() => clearInterval(timer)) - /** 公开最新任务与本机已知的多次执行,读取不提交审核。 */ - const observedExecutions = ref([]) - watch( - [history.data, execution.data, key], - ([records, current, target]) => { - observedExecutions.value = target - ? rememberVisionExecutions( - target, - (records ?? []).flatMap(item => - item.executionId - ? [ - { - taskId: item.id, - executionId: item.executionId, - ...(current?.id === item.executionId ? { status: current.status } : {}) - } - ] - : [] - ) - ) - : [] - }, - { immediate: true } - ) /** 本机已提交且仍对应当前正式任务的授权范围。 */ const submissionMode = computed(() => { const saved = submission.value @@ -296,7 +266,7 @@ export function useKeyframeVision(key: Ref, observeExecution = true) { ? saved.mode : undefined }) - return { history, state, execution, uncertain, blocked, resume, observedExecutions, submissionMode } + return { history, state, execution, uncertain, blocked, resume, submissionMode } } /** @@ -364,12 +334,6 @@ export async function submitKeyframeVision( if (result.shotId !== shotId || result.keyframeId !== assetId || !result.validationTaskId) throw new Error('审核回执与当前候选不一致,请刷新审核记录。') if ('executionId' in result && result.status === 'pending' && result.executionId) { - rememberVisionExecutions(key, [ - ...records.flatMap(item => - item.executionId ? [{ taskId: item.id, executionId: item.executionId }] : [] - ), - { taskId: result.validationTaskId, executionId: result.executionId, status: 'pending' } - ]) saveSubmission(key, { ...pending, taskId: result.validationTaskId, executionId: result.executionId }) return null } diff --git a/src/features/production/quality-api.ts b/src/features/production/quality-api.ts index edf71bc..aeba9d8 100644 --- a/src/features/production/quality-api.ts +++ b/src/features/production/quality-api.ts @@ -1,3 +1,4 @@ +import type { ValidationExecutionHistory, ValidationExecutionQuery } from './validation-executions.types' import { keyframeScope } from './keyframe-scope' import { request } from '../../lib/http' import type { @@ -58,6 +59,29 @@ export const qualityApi = { `/storyboard-shots/${encodeURIComponent(shotId)}/keyframe-provider-capability${provider ? `?provider=${encodeURIComponent(provider)}` : ''}`, { signal } ), + /** + * 按原审核任务读取正式执行历史,游标原样传递,不调用模型。 + * @param shotId 正式镜头 + * @param keyframeId 当前候选 + * @param validationTaskId 原审核任务 + * @param query 当前项目、分页大小与原始游标 + * @param signal 取消旧范围读取 + * @returns 本页执行及当前指针完整性 + */ + keyframeExecutions: ( + shotId: string, + keyframeId: string, + validationTaskId: string, + query: ValidationExecutionQuery = {}, + signal?: AbortSignal + ) => { + const params = new URLSearchParams() + if (query.projectId !== undefined) params.set('projectId', query.projectId) + if (query.limit !== undefined) params.set('limit', String(query.limit)) + if (query.cursor !== undefined) params.set('cursor', query.cursor) + const path = `/storyboard-shots/${encodeURIComponent(shotId)}/keyframes/${encodeURIComponent(keyframeId)}/validations/${encodeURIComponent(validationTaskId)}/executions` + return request(path + (params.size ? '?' + params : ''), { signal }) + }, /** * 显式请求一次审核,互斥提交新文字、原任务继续或独立授权。 * @param shotId 正式镜头编号 diff --git a/src/features/production/useValidationExecutions.ts b/src/features/production/useValidationExecutions.ts new file mode 100644 index 0000000..651008a --- /dev/null +++ b/src/features/production/useValidationExecutions.ts @@ -0,0 +1,166 @@ +import { computed, onScopeDispose, ref, watch, type Ref } from 'vue' +import { ApiError, errorMessage } from '../../lib/http' +import { useFeedbackMessage } from '../../composables/useFeedbackMessage' +import { qualityApi } from './quality-api' +import type { ValidationExecutionHistory, ValidationExecutionHistoryItem } from './validation-executions.types' + +/** + * 验证本页完整归属及当前指针,不能把排序第一条当成当前执行。 + * @param page 正式接口的本页数据 + * @param target 固定的项目、镜头、候选、审核任务 + * @param cursor 本次请求的原始游标 + */ +function assertPage( + page: ValidationExecutionHistory, + target: [string | undefined, string, string, string], + cursor?: string +) { + const [projectId, shotId, keyframeId, taskId] = target + if ( + !page || + !page.projectId || + (projectId && page.projectId !== projectId) || + page.shotId !== shotId || + page.keyframeId !== keyframeId || + page.validationTaskId !== taskId || + !Number.isSafeInteger(page.total) || + page.total < 0 || + !Array.isArray(page.items) || + page.items.length > 20 || + !['valid', 'not_recorded', 'unavailable'].includes(page.integrity?.currentExecution) || + (page.integrity.currentExecution === 'valid' ? !page.currentExecutionId : page.currentExecutionId !== null) || + !( + page.nextCursor === null || + (typeof page.nextCursor === 'string' && page.nextCursor.length > 0 && page.nextCursor !== cursor) + ) || + new Set(page.items.map(item => item.execution?.id)).size !== page.items.length || + page.items.some( + item => + !item.execution?.id || + item.execution.projectId !== page.projectId || + item.execution.workflowName !== 'shot-keyframe-validation' || + item.execution.metadata?.validationTaskId !== taskId || + item.execution.metadata?.shotId !== shotId || + item.execution.metadata?.keyframeId !== keyframeId || + item.isCurrent !== (item.execution.id === page.currentExecutionId) + ) + ) { + throw new Error('执行记录与当前审核范围不匹配,请刷新核对。') + } +} + +/** + * 按任务按需读取正式分页,不读取或写入任何本机执行历史缓存。 + * @param key 展开时的项目、镜头、候选、任务 JSON,收起时为空 + * @returns 当前页信息、已加载记录及只读刷新入口 + */ +export function useValidationExecutions(key: Ref) { + /** 最新一页的正式任务状态、指针和游标。 */ + const data = ref(null) + /** 本次展开已加载的执行,刷新首屏时重新建立。 */ + const records = ref([]) + /** 当前请求状态,防止连续点击重复翻页。 */ + const loading = ref(false) + /** 区分首屏与后续页,保留已加载内容的滚动位置。 */ + const loadingMore = ref(false) + /** 只显示当前范围的可读错误。 */ + const error = ref('') + useFeedbackMessage(error) + /** 下一页仅由正式游标决定,不以实时 total 计算。 */ + const nextCursor = computed(() => data.value?.nextCursor ?? null) + /** 每页可返回更新后的当前指针,同步已加载旧页的标记。 */ + const items = computed(() => + records.value.map(item => ({ ...item, isCurrent: item.execution.id === data.value?.currentExecutionId })) + ) + /** 请求代次覆盖取消失效的底层实现。 */ + let generation = 0 + /** 当前分页请求,切换或关闭时中止。 */ + let controller: AbortController | undefined + /** 卸载后不更新状态或展示迟到错误。 */ + let disposed = false + + /** 取消旧页并清空旧范围,保留提交保护由原观察器负责。 */ + function clear() { + generation++ + controller?.abort() + data.value = null + records.value = [] + error.value = '' + loading.value = false + loadingMore.value = false + } + /** + * 固定当前资源和游标读取一页,错误不启动审核或探测其他项目。 + * @param cursor 正式下一页游标,省略时读取首屏 + * @returns 本页读取结束 + */ + async function read(cursor?: string) { + if (disposed || !key.value) return + const identity = key.value + const current = ++generation + controller?.abort() + controller = new AbortController() + const signal = controller.signal + loading.value = true + loadingMore.value = cursor !== undefined + error.value = '' + try { + const target = JSON.parse(identity) as [string | undefined, string, string, string] + const [projectId, shotId, keyframeId, taskId] = target + const page = await qualityApi.keyframeExecutions( + shotId, + keyframeId, + taskId, + { ...(projectId ? { projectId } : {}), limit: 20, ...(cursor ? { cursor } : {}) }, + signal + ) + if (disposed || signal.aborted || current !== generation || identity !== key.value) return + assertPage(page, target, cursor) + const merged = new Map((cursor ? records.value : []).map(item => [item.execution.id, item])) + for (const item of page.items) merged.set(item.execution.id, item) + records.value = [...merged.values()] + data.value = page + } catch (cause) { + if (disposed || signal.aborted || current !== generation || identity !== key.value) return + error.value = errorMessage(cause) + if (cause instanceof ApiError && cause.status === 400 && data.value) + data.value = { ...data.value, nextCursor: null } + else if (!(cause instanceof ApiError) || [404, 409].includes(cause.status)) { + data.value = null + records.value = [] + } + } finally { + if (!disposed && current === generation) { + loading.value = false + loadingMore.value = false + } + } + } + /** + * 刷新首屏并废弃旧游标,使新执行进入新的分页序列。 + * @returns 首屏查询完成 + */ + async function refresh() { + clear() + await read() + } + /** + * 明确点击后原样读取下一页,同一时刻只允许一个请求。 + * @returns 下一页查询完成 + */ + async function loadMore() { + if (!loading.value && nextCursor.value) await read(nextCursor.value) + } + watch( + key, + () => { + void refresh() + }, + { immediate: true, flush: 'sync' } + ) + onScopeDispose(() => { + disposed = true + clear() + }) + return { data, items, loading, loadingMore, error, nextCursor, refresh, loadMore } +} diff --git a/src/features/production/validation-execution-labels.ts b/src/features/production/validation-execution-labels.ts new file mode 100644 index 0000000..837574f --- /dev/null +++ b/src/features/production/validation-execution-labels.ts @@ -0,0 +1,25 @@ +/** 审核步骤共用中文名称,内部枚举不变。 */ +export const validationStepNames = { general: '通用画面', physical: '物理关系', gaze: '视线' } +/** 执行和步骤的公开状态,仅完成不能推断质量通过。 */ +export const validationStatusLabels: Record = { + pending: '等待', + running: '执行中', + received: '已收到回执', + completed: '完成', + failed: '失败', + needs_review: '需要人工核查' +} +/** 已记录的质量结论。 */ +export const validationQualityLabels = { + passed: '质量通过', + failed: '质量未通过', + needs_review: '质量待复核', + unknown: '质量未确认' +} +/** 原始计量单位,不显示缺失项或补零。 */ +export const validationUsageLabels: Record = { + inputTokens: '输入', + outputTokens: '输出', + totalTokens: '合计', + reasoningTokens: '推理' +} diff --git a/src/features/production/validation-executions.types.ts b/src/features/production/validation-executions.types.ts new file mode 100644 index 0000000..5457452 --- /dev/null +++ b/src/features/production/validation-executions.types.ts @@ -0,0 +1,45 @@ +import type { WorkflowExecution } from '../workflows/execution.types' +import type { KeyframeValidationStep, KeyframeStepIssue } from './quality.types' + +/** 视觉审核的三个正式步骤名称。 */ +export type ValidationStepName = KeyframeValidationStep['name'] +/** 单次执行独立存证的公开步骤,不以完成状态推断通过。 */ +export interface ValidationExecutionStep extends Omit { + /** 已解析证据的真实质量结论。 */ quality: 'passed' | 'failed' | 'needs_review' | 'unknown' + /** 公开问题;没有解析结果时为空值。 */ issues: KeyframeStepIssue[] | null + /** 安全的失败原因。 */ error: string | null + /** 本次实际执行、复用或无法确认。 */ executionKind: 'executed' | 'reused' | 'unknown' + /** 有可靠证据时的复用来源执行。 */ sourceExecutionId: string | null + /** 用量归属,只有本次调用可计为新增计量。 */ usageAttribution: 'this_execution' | 'reused' | 'unknown' +} +/** 原审核任务的一次正式执行及其独立证据。 */ +export interface ValidationExecutionHistoryItem { + /** 复用单执行接口的公开记录。 */ execution: WorkflowExecution + /** 依据原任务正式当前指针判断。 */ isCurrent: boolean + /** 已保存的本次执行模式。 */ mode: 'initial' | 'resume' | 'physical_retry' | 'unknown' + /** 本次需新提交的步骤,未记录时为 null。 */ scheduledSteps: ValidationStepName[] | null + /** 本次复用或解析已有回执的步骤,未记录时为 null。 */ reusedSteps: ValidationStepName[] | null + /** 本次自己的步骤,不使用任务当前 output 补齐。 */ steps: ValidationExecutionStep[] | null + /** 公开证据来源。 */ stepsEvidence: 'execution_snapshot' | 'archived_audit' | 'not_recorded' +} +/** 同一审核任务的正式分页结果。 */ +export interface ValidationExecutionHistory { + /** 正式项目。 */ projectId: string + /** 正式镜头。 */ shotId: string + /** 镜头候选。 */ keyframeId: string + /** 原审核任务。 */ validationTaskId: string + /** 原任务状态,独立于执行和质量。 */ taskStatus: string + /** 经核对的当前执行,可以不在当前页。 */ currentExecutionId: string | null + /** 每次请求时的实时合法记录总数。 */ total: number + /** 当前页,按正式创建顺序倒序。 */ items: ValidationExecutionHistoryItem[] + /** 正式当前指针是否完整。 */ integrity: { + /** 有效、未保存或当前不可用。 */ currentExecution: 'valid' | 'not_recorded' | 'unavailable' + } + /** 原样传回的不透明游标,为 null 时停止。 */ nextCursor: string | null +} +/** 正式接口仅接受明确的项目、分页大小和原始游标。 */ +export interface ValidationExecutionQuery { + /** 当前项目,历史调用允许省略。 */ projectId?: string + /** 一次读取的条数,默认 20。 */ limit?: number + /** 后端返回的下一页位置。 */ cursor?: string +} diff --git a/src/features/production/vision-execution-history.ts b/src/features/production/vision-execution-history.ts deleted file mode 100644 index 2818d64..0000000 --- a/src/features/production/vision-execution-history.ts +++ /dev/null @@ -1,45 +0,0 @@ -/** 客户端曾实际观察到的执行,仅用于补充正式历史的最新执行编号。 */ -export interface ObservedVisionExecution { - /** 原审核任务编号。 */ taskId: string - /** 已实际取得的执行编号。 */ executionId: string - /** 最近观察到的公开执行状态。 */ status?: string -} - -/** - * 读取本机曾观察到的执行,不推断服务端未公开的历史。 - * @param key 项目和候选范围 - * @returns 已知执行记录 - */ -export function readVisionExecutions(key: string): ObservedVisionExecution[] { - try { - const parsed: unknown = JSON.parse(localStorage.getItem('vision-executions:' + key) || '[]') - return Array.isArray(parsed) - ? parsed.filter(item => item && typeof item.taskId === 'string' && typeof item.executionId === 'string') - : [] - } catch { - return [] - } -} - -/** - * 合并真实编号,同一任务的新执行不会覆盖旧执行。 - * @param key 项目和候选范围 - * @param entries 正式响应或事件中取得的记录 - * @returns 合并后的已知记录 - */ -export function rememberVisionExecutions(key: string, entries: ObservedVisionExecution[]) { - const records = readVisionExecutions(key) - for (const item of entries) { - const existing = records.find( - record => record.executionId === item.executionId && record.taskId === item.taskId - ) - if (existing) Object.assign(existing, item) - else records.push(item) - } - try { - localStorage.setItem('vision-executions:' + key, JSON.stringify(records)) - } catch { - /* 存储不可用不影响正式查询。 */ - } - return records -} diff --git a/src/features/workflows/execution.ts b/src/features/workflows/execution.ts index 6c28312..ba8f67c 100644 --- a/src/features/workflows/execution.ts +++ b/src/features/workflows/execution.ts @@ -95,6 +95,10 @@ export function executionStageLabel(stage: string | null) { submitting: '提交视频候选', generating: '生成视频', validating: '质量校验', + vision: '视觉审核', + general: '通用画面审核', + physical: '物理关系审核', + gaze: '视线审核', repairing: '自动修复', passed: '校验通过', exhausted: '修复次数已用完', diff --git a/src/lib/user-facing-text.ts b/src/lib/user-facing-text.ts index e603ec9..c40549f 100644 --- a/src/lib/user-facing-text.ts +++ b/src/lib/user-facing-text.ts @@ -1,5 +1,6 @@ /** 项目配置的确定性业务状态说明,不将配置限制显示为系统故障。 */ const configurationErrorLabels: Record = { + KEYFRAME_VALIDATION_EXECUTION_CONFLICT: '执行关联或历史证据需要核查,请刷新记录后核对。', KEYFRAME_VALIDATION_ACTIVE: '已有审核正在进行,请查看当前执行进度。', KEYFRAME_VALIDATION_RECOVERY_REQUIRED: '原审核结果或费用待核查,请刷新历史并核对,勿重复提交。', KEYFRAME_VALIDATION_AUTHORIZATION_INVALID: '授权无效、已使用或不适用于当前候选,请核对授权编号。', diff --git a/tests/features/production/validation-executions-ui.test.ts b/tests/features/production/validation-executions-ui.test.ts new file mode 100644 index 0000000..bce4722 --- /dev/null +++ b/tests/features/production/validation-executions-ui.test.ts @@ -0,0 +1,181 @@ +import { mount, flushPromises, type VueWrapper } from '@vue/test-utils' +import { afterEach, describe, expect, it, vi } from 'vitest' +import KeyframeExecutionHistory from '@/features/production/components/KeyframeExecutionHistory.vue' +import KeyframeValidationHistory from '@/features/production/components/KeyframeValidationHistory.vue' +import ReadonlyInspection from '@/components/ui/ReadonlyInspection.vue' +import { + physicalHistoryFixture, + validationExecutionFixture, + validationHistoryFixture +} from '../../fixtures/validation-executions' + +/** 只操作隔离挂载,浏览器布局另在本地 Chrome 验收。 */ +let wrapper: VueWrapper +/** + * 通过实际折叠标题触发按需查询,不直接调用组件私有方法。 + * @param label 可见折叠标题 + */ +async function expand(label: string) { + const heading = wrapper.findAll('.n-collapse-item__header-main').find(item => item.text().includes(label)) + expect(heading).toBeDefined() + await heading!.trigger('click') + await flushPromises() +} +/** + * 包装正式响应。 + * @param data 公开返回值 + * @returns Mock HTTP + */ +function response(data: unknown) { + return new Response(JSON.stringify({ data })) +} +afterEach(() => { + wrapper?.unmount() + localStorage.clear() + sessionStorage.clear() + vi.unstubAllGlobals() +}) +describe('按任务读取执行历史的页面流程', () => { + it('无缓存按需分页,原 General 计量只标复用;旧失败和未记录步骤独立展示', async () => { + const fetcher = vi.fn(async input => + response( + String(input).includes('cursor=opaque') + ? validationHistoryFixture([validationExecutionFixture('old-run')]) + : validationHistoryFixture([physicalHistoryFixture], { nextCursor: 'opaque' }) + ) + ) + vi.stubGlobal('fetch', fetcher) + wrapper = mount(KeyframeExecutionHistory, { + props: { projectId: 'project', shotId: 'shot', keyframeId: 'keyframe', validationTaskId: 'task' } + }) + await flushPromises() + expect(fetcher).not.toHaveBeenCalled() + await expand('执行记录') + expect(wrapper.text()).toContain('仅补跑物理专项') + expect(wrapper.text()).toContain('执行完成,质量待复核') + expect(wrapper.text()).toContain('本次新提交步骤:物理关系;复用已有步骤:通用画面') + await expand('通用画面') + expect(wrapper.text()).toContain('原调用计量,不重复计入本次') + await expand('高级详情') + expect(wrapper.text()).toContain('输入词元:100') + expect(wrapper.text()).toContain('复用来源执行:old-run') + expect(wrapper.text()).not.toContain('合计词元:0') + await wrapper + .findAll('button') + .find(item => item.text() === '加载更多')! + .trigger('click') + await flushPromises() + expect(wrapper.text()).toContain('历史执行') // 显示历史行,具体错误由该执行本身提供 + expect(wrapper.text()).toContain('未记录本次步骤证据') + expect(wrapper.text()).not.toContain('加载更多') + expect(fetcher).toHaveBeenCalledTimes(2) + expect(fetcher.mock.calls.every(([, init]) => init?.method === 'GET')).toBe(true) + }) + it('当前关联不可用不选择第一条;归档步骤的未知范围不补成空计划', async () => { + vi.stubGlobal( + 'fetch', + vi.fn(async () => + response( + validationHistoryFixture( + [validationExecutionFixture('archive', { stepsEvidence: 'archived_audit' })], + { currentExecutionId: null, integrity: { currentExecution: 'unavailable' } } + ) + ) + ) + ) + wrapper = mount(KeyframeExecutionHistory, { + props: { projectId: 'project', shotId: 'shot', keyframeId: 'keyframe', validationTaskId: 'task' } + }) + await expand('执行记录') + expect(wrapper.text()).toContain('当前执行关联需要核查') + expect(wrapper.text()).toContain('执行范围未记录') + expect(wrapper.text()).toContain('本次新提交步骤:未记录') + expect(wrapper.text()).toContain('已核对的历史审计') + expect(wrapper.text()).not.toContain('当前执行 ·') + }) + it('只接收同一范围的实时变化,终态只刷新首屏一次,不新建 SSE', async () => { + const fetcher = vi.fn(async () => response(validationHistoryFixture([physicalHistoryFixture]))) + vi.stubGlobal('fetch', fetcher) + const source = vi.fn<() => void>() + vi.stubGlobal('EventSource', source) + wrapper = mount(KeyframeExecutionHistory, { + props: { projectId: 'project', shotId: 'shot', keyframeId: 'keyframe', validationTaskId: 'task' } + }) + await expand('执行记录') + await wrapper.setProps({ + liveExecution: { + ...physicalHistoryFixture.execution, + id: 'foreign-run', + metadata: { validationTaskId: 'other-task', shotId: 'shot', keyframeId: 'keyframe' } + } + }) + await flushPromises() + expect(fetcher).toHaveBeenCalledTimes(1) + await wrapper.setProps({ latestExecutionId: 'new-run' }) + await flushPromises() + expect(fetcher).toHaveBeenCalledTimes(2) + await flushPromises() + expect(fetcher).toHaveBeenCalledTimes(2) + expect(source).not.toHaveBeenCalled() + }) + it('人工终止旧任务可读空列表,刷新候选摘要不卸载已展开的正式执行记录', async () => { + let pending = false + let resolveHistory!: (value: Response) => void + const task = { + id: 'task', + status: 'running', + output: null, + error: null, + createdAt: '2026-11-07', + legacyTermination: { + auditId: 'audit', + terminatedAt: '2026-11-07', + billingFinding: 'unresolved', + requiresNewAuthorization: true + } + } + const fetcher = vi.fn(async input => { + const path = String(input) + if (path.includes('/executions?')) + return response( + validationHistoryFixture([], { + total: 0, + currentExecutionId: null, + taskStatus: 'running', + integrity: { currentExecution: 'not_recorded' } + }) + ) + if (path.includes('/validations')) + return pending + ? new Promise(resolve => { + resolveHistory = resolve + }) + : response([task]) + return response({ + validationTaskId: 'task', + qualityDecision: 'unknown', + effectiveQualityStatus: 'unknown', + historicalGazePreview: [], + manualReviewAvailable: false + }) + }) + vi.stubGlobal('fetch', fetcher) + wrapper = mount(KeyframeValidationHistory, { + props: { projectId: 'project', shotId: 'shot', keyframeId: 'keyframe', initialOpen: true } + }) + await flushPromises() + await expand('执行记录') + expect(wrapper.text()).toContain('暂无已保存的执行记录') + expect(wrapper.text()).toContain('历史审核已人工终止') + const original = wrapper.findComponent(KeyframeExecutionHistory).vm.$.uid + pending = true + wrapper.findComponent(ReadonlyInspection).vm.$emit('refresh') + await flushPromises() + expect(wrapper.findComponent(KeyframeExecutionHistory).vm.$.uid).toBe(original) + expect(wrapper.text()).toContain('暂无已保存的执行记录') + resolveHistory(response([task])) + await flushPromises() + expect(fetcher.mock.calls.filter(([input]) => String(input).includes('/executions?'))).toHaveLength(1) + expect(fetcher.mock.calls.every(([, init]) => init?.method === 'GET')).toBe(true) + }) +}) diff --git a/tests/features/production/validation-executions.test.ts b/tests/features/production/validation-executions.test.ts new file mode 100644 index 0000000..2e34142 --- /dev/null +++ b/tests/features/production/validation-executions.test.ts @@ -0,0 +1,230 @@ +import { effectScope, ref } from 'vue' +import { flushPromises } from '@vue/test-utils' +import { afterEach, describe, expect, it, vi } from 'vitest' +import { useValidationExecutions } from '@/features/production/useValidationExecutions' +import { qualityApi } from '@/features/production/quality-api' +import type { ValidationExecutionHistory } from '@/features/production/validation-executions.types' + +/** 隔离范围包含完整资源路径,不能复用其他任务的游标。 */ +const target = ['project', 'shot', 'keyframe', 'task'] as const +/** 创建单页正式响应,旧执行保持自己的失败结果。 */ +function page(ids: string[], current = 'new', cursor: string | null = null): ValidationExecutionHistory { + return { + projectId: target[0], + shotId: target[1], + keyframeId: target[2], + validationTaskId: target[3], + taskStatus: 'running', + currentExecutionId: current, + total: 3, + integrity: { currentExecution: 'valid' }, + nextCursor: cursor, + items: ids.map(id => ({ + execution: { + id, + projectId: target[0], + workflowName: 'shot-keyframe-validation', + status: id === 'new' ? 'running' : 'failed', + stage: 'vision', + current: 1, + total: 2, + currentResourceId: null, + metadata: { validationTaskId: target[3], shotId: target[1], keyframeId: target[2] }, + result: null, + error: id === 'new' ? null : '旧执行失败', + startedAt: null, + completedAt: null, + createdAt: '2026-11-07T00:00:00Z', + updatedAt: '2026-11-07T00:00:00Z' + }, + isCurrent: id === current, + mode: 'unknown', + scheduledSteps: null, + reusedSteps: null, + steps: null, + stepsEvidence: 'not_recorded' + })) + } +} +/** 解包模拟响应,不调用任何真实 API。 */ +function response(data: unknown, status = 200) { + return new Response( + JSON.stringify( + status === 200 ? { data } : { message: '读取失败', code: 'KEYFRAME_VALIDATION_EXECUTION_CONFLICT' } + ), + { status } + ) +} +let scope = effectScope() +afterEach(() => { + scope.stop() + scope = effectScope() + localStorage.clear() + vi.unstubAllGlobals() +}) +describe('正式首帧执行分页', () => { + it('API 编码完整目标,显式传项目、limit 与原样游标', async () => { + const fetcher = vi.fn().mockResolvedValue(response(page([]))) + vi.stubGlobal('fetch', fetcher) + await qualityApi.keyframeExecutions( + 's/a', + 'k/b', + 't/c', + { projectId: 'p/d', limit: 20, cursor: 'opaque_A-1' }, + new AbortController().signal + ) + expect(String(fetcher.mock.calls[0]![0])).toBe( + '/api/storyboard-shots/s%2Fa/keyframes/k%2Fb/validations/t%2Fc/executions?projectId=p%2Fd&limit=20&cursor=opaque_A-1' + ) + expect(fetcher.mock.calls[0]![1]?.method).toBe('GET') + }) + it('默认关闭不读取,不读本机缓存;打开后按游标加载并去重,不按 total 猜测页数', async () => { + const fetcher = vi + .fn() + .mockImplementation(async input => + response( + String(input).includes('cursor=opaque') + ? { ...page(['new', 'old'], 'later'), total: 9 } + : page(['new'], 'new', 'opaque') + ) + ) + vi.stubGlobal('fetch', fetcher) + const key = ref('') + localStorage.setItem( + 'vision-executions:' + JSON.stringify(['shot', 'keyframe', 'project']), + JSON.stringify([{ taskId: 'fake', executionId: 'fake' }]) + ) + const history = scope.run(() => useValidationExecutions(key))! + await flushPromises() + expect(fetcher).not.toHaveBeenCalled() + key.value = JSON.stringify(target) + await flushPromises() + expect(history.items.value.map(item => item.execution.id)).toEqual(['new']) + await Promise.all([history.loadMore(), history.loadMore()]) + await flushPromises() + expect(history.items.value.map(item => item.execution.id)).toEqual(['new', 'old']) + expect(history.data.value?.currentExecutionId).toBe('later') + expect(history.items.value.some(item => item.isCurrent)).toBe(false) + expect(history.nextCursor.value).toBeNull() + await history.loadMore() + expect(fetcher).toHaveBeenCalledTimes(2) + }) + it('切项目或任务清空旧页并取消旧请求,迟到 404 不影响新范围', async () => { + let resolveOld!: (value: Response) => void + let oldSignal: AbortSignal | undefined + const fetcher = vi.fn().mockImplementation(async (input, init) => { + if (String(input).includes('/task/')) { + oldSignal = init?.signal as AbortSignal + return new Promise(resolve => { + resolveOld = resolve + }) + } + return response({ ...page(['new']), validationTaskId: 'other-task', items: [] }) + }) + vi.stubGlobal('fetch', fetcher) + const key = ref(JSON.stringify(target)) + const history = scope.run(() => useValidationExecutions(key))! + await flushPromises() + key.value = JSON.stringify(['project', 'shot', 'keyframe', 'other-task']) + await flushPromises() + resolveOld(response(null, 404)) + await flushPromises() + expect(oldSignal?.aborted).toBe(true) + expect(history.data.value?.validationTaskId).toBe('other-task') + expect(history.error.value).toBe('') + }) + it('切项目时同时更换完整资源身份,旧页回执和游标不能进入新项目', async () => { + let resolveOld!: (value: Response) => void + vi.stubGlobal( + 'fetch', + vi.fn(async input => { + if (new URL(String(input), 'http://localhost').searchParams.get('projectId') === 'project') + return new Promise(resolve => { + resolveOld = resolve + }) + return response({ + ...page([]), + projectId: 'new-project', + shotId: 'new-shot', + keyframeId: 'new-keyframe', + validationTaskId: 'new-task', + currentExecutionId: null, + integrity: { currentExecution: 'not_recorded' } + }) + }) + ) + const key = ref(JSON.stringify(target)) + const history = scope.run(() => useValidationExecutions(key))! + await flushPromises() + key.value = JSON.stringify(['new-project', 'new-shot', 'new-keyframe', 'new-task']) + await flushPromises() + resolveOld(response(page(['new'], 'new', 'old-cursor'))) + await flushPromises() + expect(history.data.value?.projectId).toBe('new-project') + expect(history.items.value).toEqual([]) + expect(history.nextCursor.value).toBeNull() + }) + it('刷新首屏中止旧翻页,新当前指针不被旧页回填,当前不在本页也不选第一条', async () => { + let resolveMore!: (value: Response) => void + let refreshed = false + vi.stubGlobal( + 'fetch', + vi.fn(async input => { + if (String(input).includes('cursor=')) + return new Promise(resolve => { + resolveMore = resolve + }) + return response(refreshed ? page(['old'], 'outside') : page(['new'], 'new', 'opaque')) + }) + ) + const history = scope.run(() => useValidationExecutions(ref(JSON.stringify(target))))! + await flushPromises() + const more = history.loadMore() + await flushPromises() + refreshed = true + await history.refresh() + resolveMore(response(page(['older']))) + await more + expect(history.items.value.map(item => item.execution.id)).toEqual(['old']) + expect(history.items.value[0]?.isCurrent).toBe(false) + expect(history.data.value?.currentExecutionId).toBe('outside') + }) + it.each([400, 404, 409])('翻页 %i 明确结束旧游标,不自动重试或 POST', async status => { + const fetcher = vi.fn(async input => + String(input).includes('cursor=') ? response(null, status) : response(page(['new'], 'new', 'opaque')) + ) + vi.stubGlobal('fetch', fetcher) + const history = scope.run(() => useValidationExecutions(ref(JSON.stringify(target))))! + await flushPromises() + await history.loadMore() + await history.loadMore() + expect(history.nextCursor.value).toBeNull() + expect(history.error.value).not.toBe('') + expect(fetcher).toHaveBeenCalledTimes(2) + expect(fetcher.mock.calls.every(([, init]) => init?.method === 'GET')).toBe(true) + expect(history.items.value).toHaveLength(status === 400 ? 1 : 0) + }) + it('损坏的归属和当前标记不进入列表;旧审核空列表合法', async () => { + const fetcher = vi + .fn() + .mockResolvedValueOnce( + response({ ...page(['old']), items: page(['old']).items.map(item => ({ ...item, isCurrent: true })) }) + ) + .mockResolvedValueOnce( + response({ + ...page([]), + total: 0, + currentExecutionId: null, + integrity: { currentExecution: 'not_recorded' } + }) + ) + vi.stubGlobal('fetch', fetcher) + const history = scope.run(() => useValidationExecutions(ref(JSON.stringify(target))))! + await flushPromises() + expect(history.items.value).toEqual([]) + expect(history.error.value).not.toBe('') + await history.refresh() + expect(history.error.value).toBe('') + expect(history.data.value?.integrity.currentExecution).toBe('not_recorded') + }) +}) diff --git a/tests/features/production/vision-project-scope.test.ts b/tests/features/production/vision-project-scope.test.ts index 38518f1..be19bad 100644 --- a/tests/features/production/vision-project-scope.test.ts +++ b/tests/features/production/vision-project-scope.test.ts @@ -167,10 +167,7 @@ describe('审核 GET 与 SSE 项目隔离', () => { ) expect(vision.execution.data.value?.id).toBe('new-execution') expect(vision.state.value.active?.id).toBe('same-task') - expect(vision.observedExecutions.value.map(item => item.executionId)).toEqual([ - 'old-execution', - 'new-execution' - ]) + expect(localStorage.getItem('vision-executions:' + JSON.stringify(['s', 'k', 'multi']))).toBeNull() const state = visionState([ task('new-execution', 'completed'), { ...task('old-execution', 'failed'), id: 'older-task', recoveryRequired: true } diff --git a/tests/fixtures/validation-executions.ts b/tests/fixtures/validation-executions.ts new file mode 100644 index 0000000..1522c18 --- /dev/null +++ b/tests/fixtures/validation-executions.ts @@ -0,0 +1,107 @@ +import type { + ValidationExecutionHistory, + ValidationExecutionHistoryItem +} from '@/features/production/validation-executions.types' + +/** 隔离任务的完整正式路径身份。 */ +export const executionHistoryTarget = ['project', 'shot', 'keyframe', 'task'] as const +/** + * 创建逐次证据的隔离执行,不调用 Provider。 + * @param id 正式执行编号 + * @param patch 本次已保存证据覆盖 + * @returns 执行公开 DTO + */ +export function validationExecutionFixture( + id: string, + patch: Partial = {} +): ValidationExecutionHistoryItem { + return { + execution: { + id, + projectId: 'project', + workflowName: 'shot-keyframe-validation', + status: 'failed', + stage: 'vision', + current: 1, + total: 2, + currentResourceId: null, + metadata: { validationTaskId: 'task', shotId: 'shot', keyframeId: 'keyframe' }, + result: null, + error: '物理步骤回执尚待核查', + startedAt: '2026-11-07T00:00:00Z', + completedAt: '2026-11-07T00:01:00Z', + createdAt: '2026-11-07T00:00:00Z', + updatedAt: '2026-11-07T00:01:00Z' + }, + isCurrent: false, + mode: 'unknown', + scheduledSteps: null, + reusedSteps: null, + steps: null, + stepsEvidence: 'not_recorded', + ...patch + } +} +/** + * 构造正式分页响应,当前指针独立于页内排序。 + * @param items 本页独立执行证据 + * @param patch 分页及当前指针覆盖 + * @returns 隔离接口响应数据 + */ +export function validationHistoryFixture( + items: ValidationExecutionHistoryItem[], + patch: Partial = {} +): ValidationExecutionHistory { + return { + projectId: 'project', + shotId: 'shot', + keyframeId: 'keyframe', + validationTaskId: 'task', + taskStatus: 'completed', + currentExecutionId: 'current-run', + total: 2, + items, + integrity: { currentExecution: 'valid' }, + nextCursor: null, + ...patch + } +} +/** 带通用复用与本次物理调用的正式证据。 */ +export const physicalHistoryFixture = validationExecutionFixture('current-run', { + execution: { + ...validationExecutionFixture('current-run').execution, + status: 'completed', + current: 2, + result: { passed: false, qualityDecision: 'needs_review' }, + error: null + }, + isCurrent: true, + mode: 'physical_retry', + scheduledSteps: ['physical'], + reusedSteps: ['general'], + stepsEvidence: 'execution_snapshot', + steps: [ + { + name: 'general', + status: 'completed', + quality: 'passed', + issues: [], + error: null, + usage: { inputTokens: 100, outputTokens: 10 }, + executionKind: 'reused', + sourceExecutionId: 'old-run', + usageAttribution: 'reused' + }, + { + name: 'physical', + status: 'completed', + quality: 'needs_review', + issues: [{ code: 'visibility', description: '固定部件部分遮挡', severity: 'warning' }], + error: null, + usage: { inputTokens: 80 }, + executionKind: 'executed', + sourceExecutionId: null, + usageAttribution: 'this_execution' + } + ] +})