feat: 同步质量校验修复并精简工作台操作

docs/backend-coverage.md

@@ -1,6 +1,6 @@
 # 后端功能覆盖说明
 
-核对日期：2026-09-02。后端：`qianlanse/short-drama-agent`，`dev@537dba89a18d571a6df24dae17494b09ce635c15`。以 API 路由和实际 service／workflow 实现为依据，不只根据接口名称推断功能。本轮不修改后端。
+核对日期：2026-09-03。后端：`qianlanse/short-drama-agent`，`dev@05bb9e8b7e0a0e85303b16eb3a2ac634e01dd7eb`。以 API 路由和实际 service／workflow 实现为依据，不只根据接口名称推断功能。本轮不修改后端。
 
 ## 页面与接口能力
 
@@ -25,6 +25,10 @@
 | 视频任务与主视频 | 镜头生产 | 项目 videos readiness／generate／status／retry-failed，逐镜 videos，单任务 status，主视频 PUT | 保留任务提交、轮询、播放、失败重试与主视频切换；不把 HTTP 完成当成片完成 |
 | 高级串联生产 | 镜头生产批量面板底部（默认折叠） | POST `/projects/:id/production/start` | 新增预检、再次校验、费用确认、分阶段回执与诊断导出；明确不是全链自动制片 |
 
+## 新增质量检查与修复
+
+已接入：首帧 `validate`、`repair`，项目 `keyframes/generate-quality`，视频 `validate`／`repair`，公开图片模型能力及逐镜能力 GET。生成请求不再传固定 Provider。质量接口的详细参数、默认一镜范围、费用确认、主图晋升、三点视频抽样和会话回执限制见 [前端简化与质量功能同步](frontend-simplification.md)。首帧校验历史尚无 GET，不虚构读取接口；视频已有结果从 `rawJson.videoValidation` 读取。
+
 ## 高级串联生产边界
 
 实际后端顺序：形态正式提示词 → 形态图片 → 视频提示词 → 视频任务提交。**没有视觉风格、身份、导演设计、即时状态或首帧生成节点，也不会等待成片。**
@@ -32,7 +36,7 @@
 - 仅剧本 `completed` 可启动；先检查项目／工作流任务、形态活动图片、当前母版引用、镜头规格、主首帧有效性和活动视频。
 - 为避免中途生成主图使既有首帧失效，前端要求先确认全部形态主图并补齐有效主首帧；因此该入口通常跳过形态生图，只串联仍缺少的文本与视频任务。
 - 点击预检只有 GET；付费确认后再次 GET 校验。查询失败或条件变更不提交 POST。单次项目锁仅覆盖本浏览器，不能代替服务器事务和跨客户端互斥。
-- 参数固定为 `imageProvider: seedream`、`videoProvider: seedance`。后端内部文字并发 3、图片与视频并发 2；不接受批量面板的覆盖、数量上限或尺寸配置，不应让用户误以为可小批量执行。
+- 图片与视频模型由后端统一配置，前端不传请求级 Provider。旧串联路由仍解析默认字段，但实际执行节点已改用统一配置；不据此显示虚假模型选择。后端内部文字并发 3、图片与视频并发 2，不接受普通批量面板的覆盖、上限和尺寸配置。
 - 图工作流 `completed` 仅说明经过 finalize，可能仍有错误；`needsManualReview`、`stopReason` 和所有 `errors` 原样显示。视频统计用“已提交”，不标“成片已完成”。
 - 此工作流没有持久 checkpoint／恢复／取消接口。网络断开不能推断后端停止，禁止自动重发。已提交的长请求回执按原项目隔离；页面刷新后需从资产状态核对。
 
@@ -48,7 +52,7 @@
 - 图库始终读取 keyframes 与 videos 的 readiness，显示下游过期镜头数量；选择来源镜头后才查询其参考图，避免遍历全部镜头的 N+1 请求。只允许定位当前项目列表中的镜头。
 - 图库深链接支持 `sourceShotId`、`subjectFormId` 和 `subjectRef`；精确形态优先，切换定位清除旧筛选，丢失的形态不自动回退其他形态。返回生产页携带 `episodeNo` 与正式 `shotId`。
 - “身份主图过期”与“下游首帧过期”独立展示。素材有效而首帧过期时，只需核对后重建首帧；定位、刷新、筛选不触发生成或切换主资产。
-- 当前后端基线存在检查口径不一致风险：`video-readiness.service.ts` 与 `video-generation-compiler.service.ts` 调用 `shotKeyframeCurrentnessService.check` 时仅传形态引用，遗漏第三个当前身份母版参数。默认空列表会将快照里的身份母版视为已移除；而 `shot-keyframe-readiness.service.ts` 会正确传入当前母版。前端因此合并两种检查，并将“首帧未标过期、视频报告过期”单列为“状态待核对”，不据此判定素材失效或建议直接重复生图。本次仅修改前端，不绕过视频阻塞；后端调用链需另行修复与联调。
+- 本次后端基线已修复视频 readiness／compiler 缺少当前身份母版参数引起的过期误报。前端保留异常时的两种检查结果对照和“状态待核对”提示，不绕过后端阻塞或自动重复生图。
 
 ## 不添加无效或重复入口
 
@@ -65,5 +69,5 @@
 ## 回归验证
 
 - 自动测试全部模拟 API，覆盖正式 ID／参数、提示词与图片职责分离、批量部分失败、数量和尺寸校验、候选不覆盖、未完成剧本禁用、费用确认、预检后条件变化、项目切换与旧响应隔离。
-- 已通过 lint、格式、TypeScript、Vitest（23 个文件、233 项测试）和生产构建；定位回归见 `src/features/subject-images/asset-impact.test.ts`。测试不触发真实模型或生产任务。
+- 已通过 lint、格式、TypeScript、Vitest（含质量链路及菜单／折叠交互回归）和生产构建；定位回归见 `src/features/subject-images/asset-impact.test.ts`。测试不触发真实模型或生产任务。
 - 当前环境无法打开应用预览，未进行浏览器视觉验收；需在可访问的开发环境检查浅／暗主题和窄屏布局，并由用户明确批准后进行真实小批量模型联调。

docs/frontend-simplification.md

@@ -0,0 +1,62 @@
+# 前端简化与质量功能同步
+
+核对日期：2026-09-03。后端 dev 基线：`05bb9e8b7e0a0e85303b16eb3a2ac634e01dd7eb`。本次只改前端，不更改数据库、后端配置或生成资产。
+
+## 页面保留什么、收起什么
+
+沿用现有路由、左侧导航、剧集／主体／镜头目录、详情分栏和灰阶主题，不另建工作台。主操作、正式内容和阻塞提示直接显示；低频入口采用 Naive UI 菜单、折叠区和弹窗。
+
+| 工作区 | 默认显示 | 按需查看 |
+| --- | --- | --- |
+| 剧本创作 | 正文、角色／世界观／审核标签、进入拆解 | Tabs suffix 的更多菜单：执行记录、导出 |
+| 剧本拆解 | 主体、形态、分镜、任务与失败提醒 | 更多菜单：执行记录、JSON 导出；长主体介绍可展开 |
+| 视觉风格 | 名称、整体风格、锁定、保存和 AI 生成 | 分类风格、硬约束、生成规则；收起不丢失草稿 |
+| 主体身份 | 身份编辑、锁定、选角、母版及图片 | 身份填写规则；批量功能仍在原抽屉 |
+| 形态图片 | 图片、主图状态、看图与生成 | 卡片更多菜单：提示词、主体身份与母版；批量配置在抽屉 |
+| 分镜设计 | 剧集、目录、设计与状态 | 更多菜单导出本集，原抽屉生成与恢复 |
+| 镜头生产 | 提示词、首帧、视频和主要操作 | 资产更多菜单查看生成规格；质量检查打开独立面板，细参数／逐轮回执可展开 |
+
+少边框、无圆角的布局保持不变；浅色 Tabs 分隔线仍为 `#dadada`。新增刷新与更多按钮为正方形并保留可访问名称；规则折叠标题使用可键盘激活的按钮。摘要只改变显示，不截断底层内容或导出结果。
+
+不收起：读取失败、任务失败、素材过期、未保存修改、关键禁用条件、费用说明、主图替换后果。原来的素材精确定位／返回原镜头功能保留。重复分镜前置问题只在对应生产阶段显示。
+
+## 与新后端同步
+
+### 模型配置
+
+图片与视频实际使用后端 `IMAGE_*`、`VIDEO_*` 配置。身份／选角／形态／首帧／视频请求不再发送固定 `provider`；串联生产也不再传固定 `imageProvider`、`videoProvider`。旧串联路由仍保留默认字段，但新执行节点不再消费这些请求级模型值，因此界面不能把它们当实际模型展示。
+
+质量面板或资产规格弹窗可按需读取 `/image-providers/capabilities` 和当前镜头的 `keyframe-provider-capability`。此入口只读，不提供会被后端忽略的“前端切换模型”。未声明参考图上限显示“上限未声明”，不声称无限制。
+
+### 质量入口
+
+| 入口 | 实际 API | 结果与边界 |
+| --- | --- | --- |
+| 已完成首帧 → 质量检查 → 仅校验 | POST `/storyboard-shots/:shotId/keyframes/:keyframeId/validate` | 调用视觉模型，不重生成、不切换主首帧 |
+| 首帧 → 质量检查 → 校验并修复 | POST 同路径 `/repair` | 有限重生成；新候选通过才晋升主首帧；原图直接通过不会自动晋升 |
+| 生产工具栏 → 首帧质量生成 | POST `/projects/:projectId/keyframes/generate-quality` | 当前集、默认最多一镜、并发 1、最多修复 1 次；每镜候选通过后才设主图 |
+| 已完成视频 → 质量检查 | POST `/storyboard-shots/:shotId/videos/:videoId/validate` | 三点抽帧视觉检查，不检测音频／口型／完整连续运动；普通候选不切换主视频，修复候选通过后自动晋升 |
+
+批量质量配置与普通批量面板独立。后端非 force 先根据全项目是否有过期项决定筛选，再筛当前集；因此其他集存在过期项而当前集无过期项时，本集不会先补缺失首帧。前端明确提示切换剧集，不悄悄扩大范围。
+
+允许文字按行输入并清理空白／重复；未填写不自行授权文字。宽高同时留空或填写正整数，修复次数可为 0。确认区显示本次最多生图／视觉校验调用次数，修改参数或目标后撤销费用确认。
+
+### 视频修复与复检晋升（本轮后端追加更新）
+
+视频质量面板新增“生成修复候选”，使用 POST `/storyboard-shots/:shotId/videos/:videoId/repair`，只接受 `maxRepairAttempts`（默认 2，正整数）。该参数是修复链的上限，不是本次自动生成次数。本次只提交一个视频候选，不自动等待、复检或循环重试；修复约束和允许文字沿用已保存的失败校验。
+
+确认后重新读取视频，未校验、校验已通过、链路到达上限或镜头有活动视频时不提交。候选完成后仍不是主视频，需要对新候选显式执行视觉校验；后端通过后自动晋升，界面在付费确认前说明后果，并显示实际晋升结果。未通过复检的修复候选不提供普通“设为主视频”按钮，不能绕过验收。
+
+### 状态与风险控制
+
+- 打开页面、菜单、结果和模型能力不会自动调用生成／视觉模型。质量 POST 只在确认后发生，不自动超时重试。
+- 确认后再次 GET 项目完成状态、活动任务、项目镜头列表与目标资产归属。视频必须有完成状态、地址和有效时长；首帧必须完成且有图片。修复和小批量质量生成先检查模型参考图能力，批次检查当前镜头是否仍在生图。
+- 预检期间关闭面板或换目标不发送 POST。已提交请求继续运行，回执按原项目／镜头／资产保存，不能写入新项目。当前浏览器项目互斥不能代替后端跨客户端锁；仍需确认外部任务停止。
+- 结果分别显示视觉通过、修复未通过、调用失败、未执行；不会把 HTTP 200 当质量通过。批量回执提供定位镜头，完整主体检查／逐轮耗时／原始回执可展开和导出。
+- 视频历史结果直接从 `rawJson.videoValidation` 读取，不为“查看结果”重新调用视觉模型。它是历史抽样结论，不保证当前引用仍一致。
+- 后端持久化首帧校验，但尚无历史读取 GET。前端只显示当前会话确实收到的首帧回执并支持导出，不虚构历史接口。
+- 后端已修复视频校验漏传身份母版导致的过期误报。前端保留两种就绪结果冲突时的防御性提示，不绕过后端阻塞、不自动重复生成。
+
+## 验证边界
+
+单元与组件测试全部使用模拟 API，验证参数、正式 ID、禁用、费用确认、范围、归属、回执隔离和菜单访问，不触发真实模型任务。浏览器视觉与实际模型联调需要在可访问的开发环境进行；不将 DOM 测试视为视觉验收。