diff --git a/docs/api-contract-sync.md b/docs/api-contract-sync.md index 8ba0e24..c8c247a 100644 --- a/docs/api-contract-sync.md +++ b/docs/api-contract-sync.md @@ -1,5 +1,17 @@ # 接口数据同步说明 +## 2026-10-17 拆解任务发现与过程展示 + +- 项目布局通过 `GET /projects/:projectId/workflow-executions/latest?workflowName=breakdown` 发现服务端最新拆解任务,并通过同项目 `workflow-executions/events` 订阅任务变化。后端发起的新任务不再依赖当前浏览器保存过启动回执;没有任务时明确返回 null。 +- 拆解页页头、设置弹窗和活动锁共用实际任务记录。运行期间隐藏“查看诊断”和节拍/镜头诊断按钮,禁用恢复、候选提交与质量修订。结束后读取最新结果,按真实终态恢复入口;切换项目和迟到消息不覆盖当前项目,终态不会被旧 running 消息重新激活。 +- 后端只读观察视图使用同次运行时间窗口内的阶段快照补充阶段和进度。`metadata.progressUnit` 明确区分抽取任务与分镜剧集;状态仍以持久化任务为准,不把抽取 3/3 当作整个拆解完成。新任务尚无快照时标注“上次结果”,未知总量保持未知。 +- 任务执行结束但 `storyboardShotValidation.valid=false` 时显示校验未通过,保留候选提交限制。发现失败提供重读入口,页面不定时刷新全量项目或完整 Checkpoint;只观察任务状态,终态时刷新业务结果。 +- 本地 Chrome 读取“掩耳盗铃”的真实任务与校验结果;在临时隔离页面验证后台启动事件到达后诊断消失、进度显示“分镜剧集 1/3”、恢复操作禁用,以及结束事件后恢复诊断。隔离页禁止写请求,验证后已删除并恢复真实项目页面;没有重新拆解或调用模型。 +- 详细执行异常与分镜校验问题移到独立“拆解问题”弹窗,按剧集/节拍/镜头分组,保留后端原始描述并合并重复消息。设置页仅展示问题数量和查看入口,移除重复快照统计、进度及长错误清单;问题弹窗关闭后可定位分镜或返回设置,弹窗之间不叠加焦点陷阱。候选、修订与恢复说明同步精简。 +- 问题定位、错误详情卡片及问题摘要统一使用 `--app-danger-soft` 柔和红色背景,移除定位区域的绿色轮廓线;深浅主题分别使用适配底色,内部按钮的键盘焦点提示保留。Chrome 已验证深浅主题的真实问题镜头定位,验证后恢复原跟随系统主题。 + +本轮验证:前端全量 58 个文件/435 项测试及构建通过,颜色变更另通过 43 项针对性回归;后端只读观察、阶段归属和状态转换 16 项专项测试、类型检查、本次文件格式及静态检查通过。后端全量检查在格式阶段报告 8 个既有文件问题,均不属于本次改动,未修改这些文件。 + ## 2026-10-17 候选拆解、质量规则与阶段续跑 依据同级后端 `dev@dc884f0f` 的正式路由、候选提交服务、质量策略 schema、人工修订服务与 Production Prepare 节点核对。本轮在前端项目根目录 `dev` 适配,保留工作区原有页面改动。 diff --git a/src/components/ui/WorkspaceTools.vue b/src/components/ui/WorkspaceTools.vue index e7e2f01..2bc5d15 100644 --- a/src/components/ui/WorkspaceTools.vue +++ b/src/components/ui/WorkspaceTools.vue @@ -21,6 +21,8 @@ withDefaults( } ) const open = defineModel('open', { default: false }) +/** 工具弹窗完全关闭后通知调用方,便于切换独立的问题弹窗。 */ +const emit = defineEmits<{ closed: [] }>() diff --git a/src/features/breakdown/BreakdownPage.vue b/src/features/breakdown/BreakdownPage.vue index 9211be7..6c316e3 100644 --- a/src/features/breakdown/BreakdownPage.vue +++ b/src/features/breakdown/BreakdownPage.vue @@ -1,32 +1,31 @@ + + diff --git a/src/features/breakdown/components/StoryboardList.vue b/src/features/breakdown/components/StoryboardList.vue index 9ce7a3d..89d8fc6 100644 --- a/src/features/breakdown/components/StoryboardList.vue +++ b/src/features/breakdown/components/StoryboardList.vue @@ -14,6 +14,8 @@ const props = defineProps<{ plans: EpisodePlan[] /** 正式分集镜头。 */ episodes: EpisodeShots[] + /** 拆解期间隐藏节拍和镜头诊断入口。 */ + diagnosisDisabled?: boolean }>() /** 分镜卡片只负责发出诊断定位,确认及模型任务交由页面处理。 */ const emit = defineEmits<{ diagnose: [scope: DiagnosisLocation] }>() @@ -114,7 +116,7 @@ defineExpose({ locate })

{{ beat.title }}

{{ purposeLabels[beat.purpose] || beat.purpose }}

{{ shot.title }}

/* 本组件专属布局与 Naive 内部结构覆盖。 */ @reference "../../../styles/styles.css"; -/* 问题定位保留轮廓提示,便于关闭弹窗后识别目标。 */ -.diagnosis-located { - outline: 1px solid var(--app-accent); - outline-offset: 3px; +/* 问题定位使用柔和红色底面,不改变行高和间距;内部控件保留键盘焦点。 */ +.breakdown-storyboard .diagnosis-located { + background: var(--app-danger-soft); + outline: none; } .beat-section { @apply mt-[25px] pt-[23px]; diff --git a/src/features/breakdown/components/StoryboardQualityRepair.vue b/src/features/breakdown/components/StoryboardQualityRepair.vue index 92feb92..c861e9d 100644 --- a/src/features/breakdown/components/StoryboardQualityRepair.vue +++ b/src/features/breakdown/components/StoryboardQualityRepair.vue @@ -199,9 +199,7 @@ onScopeDispose(() => {

分镜质量修订

读取修复清单 -

- 用于尚未入库的质量阻断镜头。读取不调用模型;人工修订保存为新快照,通过后再恢复拆解。 -

+

仅修订尚未入库的镜头,保存后再恢复拆解。

当前没有可人工修订的质量阻断镜头,不代表未诊断镜头已通过。 diff --git a/src/features/projects/ProjectLayout.vue b/src/features/projects/ProjectLayout.vue index 71197cd..90c8ed5 100644 --- a/src/features/projects/ProjectLayout.vue +++ b/src/features/projects/ProjectLayout.vue @@ -72,7 +72,7 @@ for (const workflowName of [ useWorkflowExecution(id, workflowName) } /** 即使直接刷新到生产页,也按真实重生成任务恢复旧剧情快照的失效标记。 */ -const breakdownExecution = useWorkflowExecution(id, 'breakdown') +const breakdownExecution = useWorkflowExecution(id, 'breakdown', { discover: true }) /** 只有后端确认有效的新分镜才废弃旧正文,不推测未完成或失败任务。 */ watchEffect(() => { const record = breakdownExecution.query.data.value diff --git a/src/features/workflows/WorkflowExecutionPanel.vue b/src/features/workflows/WorkflowExecutionPanel.vue index 232b2e2..ad7cbce 100644 --- a/src/features/workflows/WorkflowExecutionPanel.vue +++ b/src/features/workflows/WorkflowExecutionPanel.vue @@ -19,7 +19,7 @@ const props = withDefaults( loading: boolean /** 状态读取错误。 */ error: string - /** 是否展示运行与完成说明,已有消息及详细快照的页面可关闭。 */ + /** 是否展示运行、完成和错误详情;关闭后由调用方单独呈现问题。 */ showStatusHint?: boolean }>(), { title: '制作任务', showStatusHint: true } @@ -28,9 +28,35 @@ const props = withDefaults( const emit = defineEmits<{ refresh: []; dismiss: [] }>() const percentage = computed(() => executionPercentage(props.execution?.current ?? 0, props.execution?.total ?? 0)) const result = computed(() => props.execution?.result ?? {}) +/** 拆解任务的单位和结果文案与镜头素材任务分开。 */ +const breakdownTask = computed(() => props.execution?.workflowName === 'breakdown') +/** 执行完成不等于业务校验通过,明确保留待修复状态。 */ +const breakdownInvalid = computed(() => { + const validation = result.value.storyboardShotValidation + return ( + breakdownTask.value && + validation && + typeof validation === 'object' && + 'valid' in validation && + validation.valid === false + ) +}) +/** 后端提供的进度单位,避免把抽取完成误报为整个拆解完成。 */ +const progressLabel = computed(() => + props.execution?.metadata?.progressUnit === 'extraction_tasks' + ? '抽取任务' + : props.execution?.metadata?.progressUnit === 'storyboard_episodes' + ? '分镜剧集' + : '已处理' +) +/** 后端执行终态与业务审核结果共同决定可读状态。 */ const statusLabel = computed(() => { const labels = { pending: '等待开始', running: '执行中', completed: '已完成', failed: '失败' } - return props.execution ? labels[props.execution.status] : '' + return props.execution + ? props.execution.status === 'completed' && breakdownInvalid.value + ? '执行结束 · 校验未通过' + : labels[props.execution.status] + : '' }) const finished = computed(() => ['completed', 'failed'].includes(props.execution?.status ?? '')) /** 是否为剧本创作任务,避免使用镜头素材的提示文案。 */ @@ -48,7 +74,7 @@ const staleMotionPlanCount = computed(() => { /** 视频流程结束但含过期候选时使用警告标签,不显示全成功的绿色状态。 */ const statusType = computed(() => props.execution?.status === 'completed' - ? videoQuality.value && staleMotionPlanCount.value > 0 + ? breakdownInvalid.value || (videoQuality.value && staleMotionPlanCount.value > 0) ? 'warning' : 'success' : props.execution?.status === 'failed' @@ -162,11 +188,19 @@ function isInputMode(value: unknown, inputMode: string): boolean { class="mt-4" />

- + -