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

docs/api-contract-sync.md

@@ -0,0 +1,32 @@
+# 接口数据同步说明
+
+核对日期：2026-09-10。依据同级后端仓库 `short-drama-agent` 的 `HEAD=f0321c2`、`src/api/routes` 及实际资产 DTO/service 实现。本轮仅修改前端，沿用已完成页面和正式路由。
+
+| 接口范围 | 精简后的公开数据 | 前端处理 |
+| --- | --- | --- |
+| 项目列表／详情 | 项目业务字段、characters、world、episodes；不含 reviews、tasks | 删除旧类型依赖；审核读取共享 checkpoint 的明确 reviewPassed，不伪造审核记录；生产预检从每条工作流最新 checkpoint 检查运行状态 |
+| 视觉风格及参考图 | 风格保留可编辑 Prompt、hardConstraints 和 images；图片去除生成 Prompt | 保留编辑、锁定、图片登记和启停；移除图片内部提示词展示 |
+| 主体身份查询／保存／生成 | id、subjectId、description、generationPrompt、isLocked、时间 | 图片继续通过独立 GET 查询，不从身份对象读取 images |
+| 身份图片查询／生成／切母版 | 明确 isAnchor，不含 enabled、prompt、rawJson | 母版识别和切换结果校验统一使用 isAnchor；辅助视角仍不可设母版 |
+| 角色选角确认 | identityId、subjectId、isLocked、anchor | 验证主体、身份、图片归属和母版标记，不再访问嵌套 identity |
+| 形态图库／图片／主图 | identity.anchorImageId；图片仅含资产字段 | 正常预览、生成和切主图；移除依赖历史 rawJson 的身份过期推断及批量重生，保留下游 readiness 过期定位 |
+| 形态正式 Prompt | 正式形态业务字段和时间，不含 subject、images 关联 | 单独声明回执类型；生成后重读图库，避免将单体回执当作图库记录 |
+| 视频 Prompt | shotId、status、videoPrompt、negativePrompt、updatedAt | 两个页面均按 shotId 校验回执；保留正文展示与导出 |
+| 首帧资产 | source、状态、图片、主图标记、模型与时间；无内部 Prompt／任务信息 | 保留候选和主图；source=provider_variant 的模型输入变体不可设业务主首帧 |
+| 视频资产／单任务刷新 | 状态、地址、时长、isPrimary、模型和时间；无 rawJson／Provider Task／Prompt | 播放与状态使用公开字段；未知质量不显示通过或自动校验中 |
+| 视频就绪／项目状态 | stale_prompt、provider_input_recovery；公开失败分类、retryable 和输入恢复状态 | 补齐类型和中文原因，显示不可普通重试提示；不解析内部失败快照 |
+| 视频生成规格 | 业务 keyframe 和实际 providerInputKeyframe | 类型区分两种用途，规格面板展示实际输入 ID；尺寸允许后端 null |
+| 失败视频重试 | totalFailed、retryable、skipped、retried、failed、failures | 显示可重试和跳过数，保留部分失败，不将 HTTP 成功当作全部重试成功 |
+| 拆解、导演设计、即时状态、质量 POST、串联生产、诊断 | 已核对现有页面使用的正式路由与返回业务切片 | 保留原入口、参数、费用确认与失败处理；不增加测试／探针生成入口 |
+
+视频校验的新增运动、空间交互、道具结构及连接检查回执也已同步；专项未执行不显示通过，完整证据随结果导出。视频校验费用提示按一次请求可能调用多个模型说明。
+
+## 质量数据边界
+
+公开视频 DTO 不再带质量候选类型、历史校验和修复次数。后端自动质量链仍负责通过后晋升，前端以刷新后的 `isPrimary` 为准。普通手动设主入口要求本会话对此资产收到 PASS；修复要求本会话收到 FAIL。回执按项目、镜头、资产隔离，切页仍可查看，刷新浏览器后不伪造历史。重新校验会清除旧通过资格；失败的修复请求保留其依据的失败校验。次数上限由后端检查，错误原样呈现，不自动重试。
+
+项目详情不再提供内部任务列表。公开 checkpoint 只能证明已记录工作流的状态，不能证明所有外部生成任务均已停止；保留现有的资产状态检查和操作确认。
+
+## 回归验证范围
+
+测试使用不包含旧内部字段的公开 DTO，覆盖页面加载、身份保存／选角、图片主图、Prompt 正式 ID、质量会话隔离、输入变体禁用、失败重试和缺失历史不误报过期。全部 API 使用模拟响应，不触发真实模型。此次不以自动化 DOM 测试代替浏览器视觉验收或真实后端联调。

docs/backend-coverage.md

@@ -1,6 +1,6 @@
 # 后端功能覆盖说明
 
-核对日期：2026-09-07。后端：`qianlanse/short-drama-agent`，`dev@697cf864e1e8d6f66e3ad7beeebdfd0ae0d6c16c`。以 API 路由和实际 service／workflow 实现为依据，不只根据接口名称推断功能。本轮不修改后端。
+核对日期：2026-09-10。后端：`qianlanse/short-drama-agent`，本地 `HEAD=f0321c2`。精简返回结构的适配详情见 [接口数据同步说明](api-contract-sync.md)。以 API 路由和实际 service／workflow 实现为依据，不只根据接口名称推断功能。本轮不修改后端。
 
 ## 页面与接口能力
 
@@ -17,7 +17,7 @@
 | 角色选角 | 主体身份角色模块 | `character-casting/readiness`、批量／单个 candidates、图片 `casting` | 保留候选、检查、确认母版并原子锁定 |
 | 身份参考图 | 主体身份图库 | `identity/images`、图片 `anchor` | 保留完整预览、历史、辅助视角与母版切换；修正道具继承说明 |
 | 正式形态提示词 | 形态卡片 → 提示词与生成；批量工具 | POST `subject-forms/:id/generation-prompt`、项目 `subject-forms/generation-prompts` | 新增单个生成／重生成、原始素材与正式文本对照、导出、批量补齐／覆盖及失败回执 |
-| 形态图片 | 形态图片及图库 | 项目 `subject-forms`、形态 `images`、主图 PUT、项目 `subject-images/generate` | 增加本批数量上限；支持后端自动补正式 Prompt；人物／场景／道具已锁定母版继承；过期刷新只生成候选 |
+| 形态图片 | 形态图片及图库 | 项目 `subject-forms`、形态 `images`、主图 PUT、项目 `subject-images/generate` | 增加本批数量上限；支持后端自动补正式 Prompt；人物／场景／道具已锁定母版继承；按需生成候选，历史母版信息不公开时不推断过期 |
 | 导演设计与即时状态 | 分镜设计 | directions／visual-states 查询、项目 `generate` | 只保留正式项目批量、覆盖、校验修复次数和逐集回执；不暴露 `generate-test` |
 | 参考图与规格 | 分镜参考图／生产单镜头 | `references`、`generation-spec`、`keyframe-spec`、`video-generation-spec` | 保留按需只读检查与缺失原因，查询不调用生成模型 |
 | 视频提示词 | 分镜设计／镜头生产 | 单镜头 `video-prompt`、项目 `video-prompts/readiness` 与 `generate` | 保留单镜头／项目生成，重写需确认 |
@@ -27,7 +27,7 @@
 
 ## 新增质量检查与修复
 
-已接入：首帧 `validate`、`repair`，项目 `keyframes/generate-quality`，视频 `validate`／`repair`，以及单镜头和项目级 `videos/generate-quality`。严格视频候选由后端 Poller 自动执行 Validator，失败时按上限创建 Repair Candidate，只有 PASS 才晋升 Primary；前端识别 `rawJson.qualityCandidate`，禁止未通过候选绕过校验手动设为主视频。生成请求不再传固定 Provider。质量接口的详细参数、默认一镜范围、费用确认、主图晋升、三点视频抽样和会话回执限制见 [前端简化与质量功能同步](frontend-simplification.md)。首帧校验历史尚无 GET，不虚构读取接口；视频已有结果从 `rawJson.videoValidation` 读取。
+已接入：首帧 `validate`、`repair`，项目 `keyframes/generate-quality`，视频 `validate`／`repair`，以及单镜头和项目级 `videos/generate-quality`。严格视频候选由后端 Poller 自动执行 Validator，失败时按上限创建 Repair Candidate，只有 PASS 才晋升 Primary；公开视频列表不再提供质量标记；前端只有在本会话收到 PASS 校验回执后才显示候选的手动设主入口。生成请求不再传固定 Provider。质量接口的详细参数、默认一镜范围、费用确认、主图晋升、视频抽样与专项检查和会话回执限制见 [前端简化与质量功能同步](frontend-simplification.md)。首帧和视频均不虚构质量历史 GET；校验回执按项目、镜头和资产 ID 保存在当前会话。
 
 ## 高级串联生产边界
 
@@ -51,7 +51,7 @@
 - 生产页将结构化 `stale_keyframe.missingSubjects` 映射到当前镜头 `/references` 返回的正式 `subjectFormId`，点击可定位图库中实际使用的形态；不按主体名称猜默认形态。缺少关联时退回主体引用检索并明确提示待核对。
 - 图库始终读取 keyframes 与 videos 的 readiness，显示下游过期镜头数量；选择来源镜头后才查询其参考图，避免遍历全部镜头的 N+1 请求。只允许定位当前项目列表中的镜头。
 - 图库深链接支持 `sourceShotId`、`subjectFormId` 和 `subjectRef`；精确形态优先，切换定位清除旧筛选，丢失的形态不自动回退其他形态。返回生产页携带 `episodeNo` 与正式 `shotId`。
-- “身份主图过期”与“下游首帧过期”独立展示。素材有效而首帧过期时，只需核对后重建首帧；定位、刷新、筛选不触发生成或切换主资产。
+- 形态图库不再有历史母版引用，已移除前端推导的“身份主图过期”筛选和批量重生入口。“下游首帧过期”仍读取后端 readiness；核对素材无误后可重建首帧；定位、刷新、筛选不触发生成或切换主资产。
 - 本次后端基线已修复视频 readiness／compiler 缺少当前身份母版参数引起的过期误报。前端保留异常时的两种检查结果对照和“状态待核对”提示，不绕过后端阻塞或自动重复生图。
 
 ## 不添加无效或重复入口

docs/frontend-simplification.md

@@ -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。前端只显示当前会话确实收到的首帧回执并支持导出，不虚构历史接口。
 - 后端已修复视频校验漏传身份母版导致的过期误报。前端保留两种就绪结果冲突时的防御性提示，不绕过后端阻塞、不自动重复生成。