feat: 同步精简接口并统一表单校验

2026-09-10 22:34:47 +08:00
parent 82d7bde631
commit 2eea0ea72e
66 changed files with 1611 additions and 1100 deletions
@@ -1,6 +1,6 @@
 # 前端简化与质量功能同步

-核对日期：2026-09-03。后端 dev 基线：`05bb9e8b7e0a0e85303b16eb3a2ac634e01dd7eb`。本次只改前端，不更改数据库、后端配置或生成资产。
+核对日期：2026-09-10。后端本地基线：`f0321c2`。精简返回结构见 [接口数据同步说明](api-contract-sync.md)。本次只改前端，不更改数据库、后端配置或生成资产。

 ## 页面保留什么、收起什么

@@ -37,7 +37,7 @@
 | 生产工具栏 → 首帧质量生成 | POST `/projects/:projectId/keyframes/generate-quality` | 当前集、默认最多一镜、并发 1、最多修复 1 次；每镜候选通过后才设主图 |
 | 单镜头 → 提交视频质量任务 | POST `/storyboard-shots/:shotId/videos/generate-quality` | 创建严格质量候选；生成完成后由后端自动校验，失败时最多自动修复 2 次，通过后才晋升主视频 |
 | 批量生产 → 视频成片 | POST `/projects/:projectId/videos/generate-quality` | 显式限制本批镜头数和每镜修复次数；只提交 ready 镜头，后续 Validator／Repair 由 Poller 推进 |
-| 已完成视频 → 质量检查 | POST `/storyboard-shots/:shotId/videos/:videoId/validate` | 三点抽帧视觉检查，不检测音频／口型／完整连续运动；普通候选不切换主视频，修复候选通过后自动晋升 |
+| 已完成视频 → 质量检查 | POST `/storyboard-shots/:shotId/videos/:videoId/validate` | 抽样视觉与按需运动／道具专项检查，不检测音频／口型；普通候选不切换主视频，修复候选通过后自动晋升 |

 批量质量配置与普通批量面板独立。后端非 force 先根据全项目是否有过期项决定筛选，再筛当前集；因此其他集存在过期项而当前集无过期项时，本集不会先补缺失首帧。前端明确提示切换剧集，不悄悄扩大范围。

@@ -45,19 +45,19 @@

 ### 视频自动质量链与手工复检

-生产页的单镜和批量视频主入口使用 `generate-quality`。HTTP 回执只表示初始 Candidate 已创建；后台 Poller 会在 Provider 完成后自动执行 Validator，失败时按 `maxRepairAttempts` 创建下一代 Repair Candidate，只有通过校验的版本才会晋升 Primary。前端读取 `rawJson.qualityCandidate` 和 `qualityPipeline` 标记质量候选，并禁止未通过候选使用普通“设为主视频”绕过校验。
+生产页的单镜和批量视频主入口使用 `generate-quality`。HTTP 回执只表示初始 Candidate 已创建；后台 Poller 会在 Provider 完成后自动执行 Validator，失败时按 `maxRepairAttempts` 创建下一代 Repair Candidate，只有通过校验的版本才会晋升 Primary。公开视频列表不再提供 `rawJson`。前端以资产 `isPrimary` 展示晋升结果；只有本会话收到 PASS 校验的候选才可使用手动“设为主视频”。不会将缺少历史质量数据标为自动校验中或通过。

 视频质量面板新增“生成修复候选”，使用 POST `/storyboard-shots/:shotId/videos/:videoId/repair`，只接受 `maxRepairAttempts`（默认 2，正整数）。该参数是修复链的上限，不是本次自动生成次数。本次只提交一个视频候选，不自动等待、复检或循环重试；修复约束和允许文字沿用已保存的失败校验。

-确认后重新读取视频，未校验、校验已通过、链路到达上限或镜头有活动视频时不提交。候选完成后仍不是主视频，需要对新候选显式执行视觉校验；后端通过后自动晋升，界面在付费确认前说明后果，并显示实际晋升结果。未通过复检的修复候选不提供普通“设为主视频”按钮，不能绕过验收。
+确认后重新读取视频；本会话没有失败校验或镜头有活动视频时不提交。修复链次数不再由内部 JSON 推断，交由后端校验并显示其失败原因。候选完成后仍不是主视频，需要对新候选显式执行视觉校验；后端通过后自动晋升，界面在付费确认前说明后果，并显示实际晋升结果。未通过复检的修复候选不提供普通“设为主视频”按钮，不能绕过验收。

 ### 状态与风险控制

 - 打开页面、菜单、结果和模型能力不会自动调用生成／视觉模型。质量 POST 只在确认后发生，不自动超时重试。
- 确认后再次 GET 项目完成状态、活动任务、项目镜头列表与目标资产归属。视频必须有完成状态、地址和有效时长；首帧必须完成且有图片。修复和小批量质量生成先检查模型参考图能力，批次检查当前镜头是否仍在生图。
+- 确认后再次 GET 项目完成状态、工作流 checkpoint、项目镜头列表与目标资产归属。项目详情已无内部任务数组，只检查公开工作流执行状态和资产活动状态。视频必须有完成状态、地址和有效时长；首帧必须完成且有图片。修复和小批量质量生成先检查模型参考图能力，批次检查当前镜头是否仍在生图。
 - 预检期间关闭面板或换目标不发送 POST。已提交请求继续运行，回执按原项目／镜头／资产保存，不能写入新项目。当前浏览器项目互斥不能代替后端跨客户端锁；仍需确认外部任务停止。
 - 结果分别显示视觉通过、修复未通过、调用失败、未执行；不会把 HTTP 200 当质量通过。批量回执提供定位镜头，完整主体检查／逐轮耗时／原始回执可展开和导出。
- 视频历史结果直接从 `rawJson.videoValidation` 读取，不为“查看结果”重新调用视觉模型。它是历史抽样结论，不保证当前引用仍一致。
+- 视频列表不再返回质量历史；查看本会话校验回执不会重新调用模型。浏览器刷新后不保留通过结论；修复请求失败保留其所依据的失败校验。
 - 后端持久化首帧校验，但尚无历史读取 GET。前端只显示当前会话确实收到的首帧回执并支持导出，不虚构历史接口。
 - 后端已修复视频校验漏传身份母版导致的过期误报。前端保留两种就绪结果冲突时的防御性提示，不绕过后端阻塞、不自动重复生成。