feat: 补齐前端主流程并收紧工作台布局
统一工作台紧凑头部与形态图库间距，修复主体身份布局，并接入正式严格视频质量流水线。
This commit is contained in:
GouJ
@@ -2,10 +2,11 @@
|
||||
|
||||
短剧 Agent 的前端工作台。支持剧本创作、拆解、视觉风格、角色选角、主体形态、分镜设计、镜头首帧与视频生产，使用真实后端 API，不包含演示数据或浏览器端模型调用。
|
||||
|
||||
## 最新同步（2026-09-04）
|
||||
## 最新同步（2026-09-07）
|
||||
|
||||
- 对齐后端 `dev@05bb9e8b7e0a0e85303b16eb3a2ac634e01dd7eb`：图片／视频模型由后端统一配置，前端不再发送固定 Provider。
|
||||
- 新增首帧视觉校验、有限自动修复、当前集小批量质量生成、视频抽样帧质量检查、视频修复候选与复检晋升、只读模型能力查询。默认不调用模型，付费操作需确认，结果可定位和导出。
|
||||
- 对齐后端 `dev@697cf864e1e8d6f66e3ad7beeebdfd0ae0d6c16c`：图片／视频模型由后端统一配置，前端不再发送固定 Provider。
|
||||
- 视频主入口使用严格质量流水线：候选生成完成后自动校验、有限修复，通过后才晋升主视频；首帧质量生成和手工抽样检查仍保留。
|
||||
- 分镜只使用正式项目级生成接口，不把 `generate-test`、`start-test` 或 `stream-test` 暴露为生产入口。
|
||||
- 保留主要布局和业务能力，导出／执行记录／提示词等次要入口收进菜单，长介绍和高级规则按需展开；关键错误、过期、未保存与费用提示继续直显。
|
||||
- 全部业务抽屉统一挂载到 `body`，侧栏及遮罩覆盖完整视口，不受 `main/content` 裁切；保持原有宽度、正文内部滚动和关闭后配置草稿。
|
||||
|
||||
@@ -153,10 +154,8 @@ Oxfmt 不负责代码质量，Oxlint 不负责 Vue 的完整类型推导；Vue S
|
||||
| POST | `/projects/:id/breakdown/resume-shots` | 复用已成功剧集镜头，生成缺失剧集 |
|
||||
| POST | `/projects/:id/breakdown/resume-storyboard` | 修复已有镜头的 SubjectRef / Form，再持久化 |
|
||||
| GET | `/projects/:id/storyboard-directions?episodeNo=N` | 正式 Shot ID、导演设计、单集覆盖率 |
|
||||
| POST | `/projects/:id/storyboard-directions/generate-test` | 单集导演设计；明确发送 `persist: true` |
|
||||
| POST | `/projects/:id/storyboard-directions/generate` | 项目批量；`concurrency`、`force` |
|
||||
| GET | `/projects/:id/storyboard-visual-states?episodeNo=N` | 已持久化的环境、主体状态、单集覆盖率 |
|
||||
| POST | `/projects/:id/storyboard-visual-states/generate-test` | 单集即时状态；`persist: true`、`maxRepairAttempts` |
|
||||
| POST | `/projects/:id/storyboard-visual-states/generate` | 项目批量；增加 `maxRepairAttempts` |
|
||||
| GET | `/storyboard-shots/:shotId/references` | 主体形态参考图、缺失原因 |
|
||||
| GET | `/storyboard-shots/:shotId/generation-spec` | 后端确定性编译结果，不调用模型 |
|
||||
@@ -188,10 +187,11 @@ Oxfmt 不负责代码质量，Oxlint 不负责 Vue 的完整类型推导；Vue S
|
||||
| GET / POST | `/projects/:id/keyframes/readiness`、`/keyframes/generate` | 首帧就绪检查与批量 后端图片模型 生图 |
|
||||
| GET / POST | `/storyboard-shots/:shotId/keyframes`、`/keyframe` | 单镜头首帧历史与生图 |
|
||||
| PUT | `/storyboard-shots/:shotId/keyframes/:keyframeId/primary` | 切换主首帧 |
|
||||
| GET / POST | `/projects/:id/videos/readiness`、`/videos/generate` | 视频前置检查与批量 后端视频模型 任务 |
|
||||
| GET / POST | `/projects/:id/videos/readiness`、`/videos/generate-quality` | 视频前置检查与批量严格质量任务 |
|
||||
| GET | `/projects/:id/videos/status` | 项目最近视频任务状态 |
|
||||
| POST | `/projects/:id/videos/retry-failed` | 重试最近失败的视频任务 |
|
||||
| GET / POST | `/storyboard-shots/:shotId/videos` | 单镜头视频历史与任务创建 |
|
||||
| GET | `/storyboard-shots/:shotId/videos` | 单镜头视频历史 |
|
||||
| POST | `/storyboard-shots/:shotId/videos/generate-quality` | 单镜头严格质量候选；后台自动校验与有限修复 |
|
||||
| PUT | `/storyboard-shots/:shotId/videos/:videoId/primary` | 切换主视频 |
|
||||
| POST | `/projects/:id/production/start` | 高级串联入口；重复预检、费用确认，仅传两种 Provider，不生成首帧、不等待成片 |
|
||||
|
||||
@@ -213,9 +213,8 @@ API 层也提供 `state` 与 `breakdown/latest` 方法。页面通过共享 chec
|
||||
1. 入口为 `/projects/:projectId/storyboard`。先完成 Breakdown 的主体、形态、镜头与持久化，再生成 Direction，最后生成 VisualState。
|
||||
2. 当前 Direction 服务读取**最新** Breakdown 的 `state.breakdownResult.storyboardEpisodeShots`；VisualState 读取顶层 `state.storyboardEpisodeShots`、`subjectCandidates`、`subjectForms`。页面不使用历史可恢复快照代替这些生成前置条件。历史快照只补充镜头标题和剧情描述。
|
||||
3. 镜头 ID 来自正式数据库 GET，按 `shotId` 关联 Direction 和 VisualState。`shotNo` 仅在 Beat 内唯一，不能用它拼装接口 ID。VisualState 查询响应的环境字段是扁平结构，与单集生成返回的领域结构不同。
|
||||
4. 单集入口虽然名为 `generate-test`，也是后端目前唯一的单集生成接口。页面发送 `persist: true`，通过校验才保存；**单集始终重生成**，不受批量的覆盖开关影响。
|
||||
5. 批量默认 `force: false`，跳过完整剧集。重新点击“补齐”用于重试未完成项，没有虚构独立 retry 接口。`force: true` 才覆盖全部。VisualState 可设置非负整数修复次数，`0` 表示不修复。
|
||||
6. VisualState 单集生成需要该集所有正式镜头都有 Direction；批量接口由后端逐集检查，缺少前置条件的集数会单独失败。HTTP 200 也可能包含校验失败或部分失败，页面展示逐集诊断和修复次数，不视为全成功。
|
||||
4. 页面只使用正式项目批量接口；`generate-test` 暂不作为前端入口。批量默认 `force: false`，跳过完整剧集；`force: true` 才覆盖全部。VisualState 可设置非负整数修复次数，`0` 表示不修复。
|
||||
5. VisualState 批量接口由后端逐集检查；缺少完整 Direction 等前置条件的集数会单独失败。HTTP 200 也可能包含校验失败或部分失败，页面展示逐集诊断和修复次数，不视为全成功。
|
||||
7. 上游重生成**不会自动使下游旧数据失效**。覆盖 Direction 后请重生成 VisualState，修改设计／状态／参考图后按需覆盖 Prompt。覆盖率只说明字段已保存，不能证明下游与新版本一致。
|
||||
8. 分镜页用刷新按钮查询当前剧集的两类正式结果；这不是全项目实时进度。后端没有独立 Storyboard running / executionId 查询。回执只保留当前浏览器会话，切换页面不丢失，刷新浏览器会丢失。
|
||||
9. 参考图和 GenerationSpec 按需 GET，切换镜头或设计变化时取消旧查询。GenerationSpec 需要有效的 Direction、VisualState 和形态关联，不生成图片或视频。
|
||||
@@ -270,7 +269,7 @@ API 层也提供 `state` 与 `breakdown/latest` 方法。页面通过共享 chec
|
||||
- 精简的进度接口及按 graph 分页的 checkpoint；
|
||||
- 将 Breakdown 改为 202 异步任务提交，再以轮询或 SSE 读取进度。
|
||||
|
||||
前端未模拟这些能力，不调用 `stream-test` 来伪造进度。Storyboard 的单集 `generate-test` 仅在用户明确确认生成后调用。
|
||||
前端未模拟这些能力，也不调用 `stream-test`、`start-test` 或 Storyboard `generate-test` 来伪造生产功能。
|
||||
|
||||
## 部署
|
||||
|
||||
|
||||
Reference in New Issue
Block a user