feat: 补齐前端主流程并收紧工作台布局
统一工作台紧凑头部与形态图库间距，修复主体身份布局，并接入正式严格视频质量流水线。
This commit is contained in:
GouJ
@@ -1,6 +1,6 @@
|
||||
# 后端功能覆盖说明
|
||||
|
||||
核对日期：2026-09-03。后端：`qianlanse/short-drama-agent`，`dev@05bb9e8b7e0a0e85303b16eb3a2ac634e01dd7eb`。以 API 路由和实际 service／workflow 实现为依据，不只根据接口名称推断功能。本轮不修改后端。
|
||||
核对日期：2026-09-07。后端：`qianlanse/short-drama-agent`，`dev@697cf864e1e8d6f66e3ad7beeebdfd0ae0d6c16c`。以 API 路由和实际 service／workflow 实现为依据，不只根据接口名称推断功能。本轮不修改后端。
|
||||
|
||||
## 页面与接口能力
|
||||
|
||||
@@ -18,16 +18,16 @@
|
||||
| 身份参考图 | 主体身份图库 | `identity/images`、图片 `anchor` | 保留完整预览、历史、辅助视角与母版切换；修正道具继承说明 |
|
||||
| 正式形态提示词 | 形态卡片 → 提示词与生成；批量工具 | POST `subject-forms/:id/generation-prompt`、项目 `subject-forms/generation-prompts` | 新增单个生成／重生成、原始素材与正式文本对照、导出、批量补齐／覆盖及失败回执 |
|
||||
| 形态图片 | 形态图片及图库 | 项目 `subject-forms`、形态 `images`、主图 PUT、项目 `subject-images/generate` | 增加本批数量上限；支持后端自动补正式 Prompt；人物／场景／道具已锁定母版继承；过期刷新只生成候选 |
|
||||
| 导演设计与即时状态 | 分镜设计 | directions／visual-states 查询、单集 generate-test、项目 generate | 保留单集持久化（`persist: true`）、项目批量、覆盖、校验修复次数、逐集回执 |
|
||||
| 导演设计与即时状态 | 分镜设计 | directions／visual-states 查询、项目 `generate` | 只保留正式项目批量、覆盖、校验修复次数和逐集回执；不暴露 `generate-test` |
|
||||
| 参考图与规格 | 分镜参考图／生产单镜头 | `references`、`generation-spec`、`keyframe-spec`、`video-generation-spec` | 保留按需只读检查与缺失原因，查询不调用生成模型 |
|
||||
| 视频提示词 | 分镜设计／镜头生产 | 单镜头 `video-prompt`、项目 `video-prompts/readiness` 与 `generate` | 保留单镜头／项目生成，重写需确认 |
|
||||
| 镜头首帧 | 镜头生产 | 项目 `keyframes/readiness` 与 `generate`、单镜头 keyframe／keyframes、主图 PUT | 新增批量 `limit` 与成对尺寸；保留当前集／过期项／覆盖范围；显示因上限未执行数 |
|
||||
| 视频任务与主视频 | 镜头生产 | 项目 videos readiness／generate／status／retry-failed，逐镜 videos，单任务 status，主视频 PUT | 保留任务提交、轮询、播放、失败重试与主视频切换；不把 HTTP 完成当成片完成 |
|
||||
| 视频任务与主视频 | 镜头生产 | 项目 videos readiness／generate-quality／status／retry-failed，逐镜 generate-quality／videos，单任务 status，主视频 PUT | 主入口改为严格质量候选：后台自动校验、有限修复，通过后晋升；保留状态刷新、播放和失败重试 |
|
||||
| 高级串联生产 | 镜头生产批量面板底部（默认折叠） | POST `/projects/:id/production/start` | 新增预检、再次校验、费用确认、分阶段回执与诊断导出；明确不是全链自动制片 |
|
||||
|
||||
## 新增质量检查与修复
|
||||
|
||||
已接入：首帧 `validate`、`repair`，项目 `keyframes/generate-quality`，视频 `validate`／`repair`，公开图片模型能力及逐镜能力 GET。生成请求不再传固定 Provider。质量接口的详细参数、默认一镜范围、费用确认、主图晋升、三点视频抽样和会话回执限制见 [前端简化与质量功能同步](frontend-simplification.md)。首帧校验历史尚无 GET，不虚构读取接口；视频已有结果从 `rawJson.videoValidation` 读取。
|
||||
已接入：首帧 `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` 读取。
|
||||
|
||||
## 高级串联生产边界
|
||||
|
||||
@@ -63,7 +63,7 @@
|
||||
| `timeline` | 新诊断从 `timeline/grouped` 展平并按 index 排序，保持同一份数据 |
|
||||
| 图片／首帧／视频的 GET primary | 从后端完整列表的 primary 标志选取，无需再次发相同内容请求 |
|
||||
| POST `/projects/:id/resume` | 实际只返回恢复信息，并不启动恢复工作流；不显示虚假的“继续执行”按钮 |
|
||||
| `projects/stream-test`、`breakdown/start-test` | 测试专用，不暴露生产入口；Storyboard 的 generate-test 是现有正式单集生成入口，仍传 `persist: true` |
|
||||
| `projects/stream-test`、`breakdown/start-test`、Storyboard `generate-test` | 测试或试运行路由，不暴露生产入口；分镜只使用正式项目级 `generate` |
|
||||
| 手工保存形态 generationPrompt、取消运行任务、删除项目、合并最终视频 | 后端没有对应正式路由，本轮不虚构按钮、成功提示或客户端模拟实现 |
|
||||
|
||||
## 回归验证
|
||||
|
||||
@@ -35,13 +35,17 @@
|
||||
| 已完成首帧 → 质量检查 → 仅校验 | POST `/storyboard-shots/:shotId/keyframes/:keyframeId/validate` | 调用视觉模型，不重生成、不切换主首帧 |
|
||||
| 首帧 → 质量检查 → 校验并修复 | POST 同路径 `/repair` | 有限重生成；新候选通过才晋升主首帧；原图直接通过不会自动晋升 |
|
||||
| 生产工具栏 → 首帧质量生成 | 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` | 三点抽帧视觉检查，不检测音频／口型／完整连续运动；普通候选不切换主视频，修复候选通过后自动晋升 |
|
||||
|
||||
批量质量配置与普通批量面板独立。后端非 force 先根据全项目是否有过期项决定筛选，再筛当前集；因此其他集存在过期项而当前集无过期项时，本集不会先补缺失首帧。前端明确提示切换剧集，不悄悄扩大范围。
|
||||
|
||||
允许文字按行输入并清理空白／重复；未填写不自行授权文字。宽高同时留空或填写正整数，修复次数可为 0。确认区显示本次最多生图／视觉校验调用次数，修改参数或目标后撤销费用确认。
|
||||
|
||||
### 视频修复与复检晋升（本轮后端追加更新）
|
||||
### 视频自动质量链与手工复检
|
||||
|
||||
生产页的单镜和批量视频主入口使用 `generate-quality`。HTTP 回执只表示初始 Candidate 已创建；后台 Poller 会在 Provider 完成后自动执行 Validator，失败时按 `maxRepairAttempts` 创建下一代 Repair Candidate，只有通过校验的版本才会晋升 Primary。前端读取 `rawJson.qualityCandidate` 和 `qualityPipeline` 标记质量候选，并禁止未通过候选使用普通“设为主视频”绕过校验。
|
||||
|
||||
视频质量面板新增“生成修复候选”，使用 POST `/storyboard-shots/:shotId/videos/:videoId/repair`，只接受 `maxRepairAttempts`（默认 2，正整数）。该参数是修复链的上限，不是本次自动生成次数。本次只提交一个视频候选，不自动等待、复检或循环重试；修复约束和允许文字沿用已保存的失败校验。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user