diff --git a/README.md b/README.md index fdc6228..6053fa4 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,15 @@ 短剧 Agent 的前端工作台。支持剧本创作、拆解、视觉风格、角色选角、主体形态、分镜设计、镜头首帧与视频生产,使用真实后端 API,不包含演示数据或浏览器端模型调用。 +## 最新同步(2026-10-08) + +- 生产计划预检改用正式 POST,支持断点、停止阶段及各阶段数量上限;预检与启动共用模型参数。 +- 首帧质量生成接入后台任务、刷新恢复、单镜头重跑、校验历史和项目活动锁。 +- 身份图接入实际输入预览、视觉校验与单主体稳定母版质量生成。道具预览可能调用结构模型,需明确确认费用。 +- 视频质量详情与修复耗尽归因、分镜主体引用覆盖检查按需只读展示。 + +历史同步说明: + ## 最新同步(2026-09-07) - 对齐后端 `dev@697cf864e1e8d6f66e3ad7beeebdfd0ae0d6c16c`:图片/视频模型由后端统一配置,前端不再发送固定 Provider。 diff --git a/docs/backend-coverage.md b/docs/backend-coverage.md index 72b57e8..9602d1b 100644 --- a/docs/backend-coverage.md +++ b/docs/backend-coverage.md @@ -28,7 +28,7 @@ ## 新增质量检查与修复 -已接入:首帧 `validate`、`repair`,项目 `keyframes/generate-quality`,视频 `validate`/`repair`,以及单镜头和项目级 `videos/generate-quality`。严格视频候选由后端 Poller 自动执行 Validator,失败时按上限创建 Repair Candidate,只有 PASS 才晋升 Primary;公开视频列表不再提供质量标记;前端只有在本会话收到 PASS 校验回执后才显示候选的手动设主入口。生成请求不再传固定 Provider。质量接口的详细参数、默认一镜范围、费用确认、主图晋升、视频抽样与专项检查和会话回执限制见 [前端简化与质量功能同步](frontend-simplification.md)。首帧和视频均不虚构质量历史 GET;校验回执按项目、镜头和资产 ID 保存在当前会话。 +已接入:首帧 `validate`、`repair`,项目 `keyframes/generate-quality`,视频 `validate`/`repair`,以及单镜头和项目级 `videos/generate-quality`。严格视频候选由后端 Poller 自动执行 Validator,失败时按上限创建 Repair Candidate,只有 PASS 才晋升 Primary;公开视频列表不再提供质量标记;前端只有在本会话收到 PASS 校验回执后才显示候选的手动设主入口。生成请求不再传固定 Provider。质量接口的详细参数、默认一镜范围、费用确认、主图晋升、视频抽样与专项检查和会话回执限制见 [前端简化与质量功能同步](frontend-simplification.md)。首帧已接入真实 `GET keyframes/:keyframeId/validations` 历史,查看不会再次调用视觉模型,也不据此自动晋升;视频质量链读取 `quality-status?detail=true`,耗尽时读取 `quality-exhaustion-analysis`。新的首帧质量生成接收 202 `executionId`,按持久化 metadata 恢复原集与镜头的最终回执;校验历史和本次生成结果分别展示。 ## 高级串联生产边界 @@ -95,3 +95,17 @@ - 全局 GET `/assets` 已由现有资产库页面使用,无需新增重复页面。 预览结果只用于提交前核对,不作为持久化任务或质量通过证明;真正生成仍需费用确认,并以刷新后的正式资产记录为准。 + +## 2026-10-08 正式接口同步 + +后端路由与服务以同步时本地 `dev` 为准,本次覆盖: + +- 高级串联生产的计划预检改用 `POST production/plan`,图片模型、图片参数和视频模型通过 JSON 传递,与启动使用同一份预检配置。支持 `startFrom` / `stopAfter`(subjectImages、keyframes、videoPrompts)及稳定母版、主体图、首帧、视频提示词四类有限上限。参数变化撤销预检与费用确认,409 附着已有 executionId。 +- 首帧质量生成后台化,支持指定 shotId(本镜最多一张)。弹窗与页面共享后台句柄,刷新或切工作区后继续观察;项目级活动锁直到真实终态才释放,迟到 running 不能重新上锁。完成统计区分通过、修复未通过和调用失败。 +- 已完成主体也可以打开辅助图/母版候选配置,预览与实际生成共用最终参数;指定身份图校验和场景/道具单主体质量闭环均有明确费用确认。 +- 道具预览存在后端结构编译限制:无有效缓存时可能调用文本模型并生成拓扑参考。因此使用明确的费用确认和项目锁,不能描述为绝对免费;人物和场景预览为只读。 +- 分镜工具接入零费用主体引用覆盖审计,展示真实遗漏;按当前项目剧集与 Beat/Shot 坐标匹配正式镜头后定位,不猜镜头 ID。 + +页面验收使用本地 Chrome 的隔离服务。未执行真实图片、视频或视觉校验的付费任务;后台参数、恢复和竞态使用受控契约验证。 + +- 已有分镜重生成、导演设计、即时状态和普通首帧入口也对齐 202 后台句柄与终态回执。后端重生成终态仅返回 summary/validation,正式列表尚无新的标题/剧情;前端持久化按项目的旧正文失效集合,刷新或隐藏任务后仍不向新 Shot ID 回填旧标题/时长,明确展示编号与缺省说明。完整重新拆解成功后才恢复新快照辅助信息。 diff --git a/docs/superpowers/plans/2026-10-08-backend-contract-sync.md b/docs/superpowers/plans/2026-10-08-backend-contract-sync.md new file mode 100644 index 0000000..d9add08 --- /dev/null +++ b/docs/superpowers/plans/2026-10-08-backend-contract-sync.md @@ -0,0 +1,98 @@ +# 后端正式功能同步 Implementation Plan + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** 在现有页面完整接入已确认的六类后端正式能力。 +**Architecture:** API/type 层依据本地后端路由与服务 DTO。持久化任务复用 useWorkflowExecution,诊断组件只读加载,付费操作复用 ConfirmAction。逐个实现任务,不并行修改同一文件。 +**Tech Stack:** Vue 3 / TypeScript / Vite / Tailwind / Naive UI。 + +## Global Constraints + +- 工作目录为 /Users/goujun/workspace/agents-workspace/short-drama-agent-front/.worktrees/backend-contract-sync;后端只读 /Users/goujun/workspace/agents-workspace/short-drama-agent。 +- 所有新/改函数、类型字段、ref/computed/watch 与 UI 模块添加中文注释。 +- 已有功能、15px 间距和主题保持;超过两处重复使用的功能抽公共方法或组件。 +- 页面验收仅本地 Chrome,localhost,禁止 Playwright;由主代理统一操作浏览器,子代理不操作 UI。 +- 不在验证中创建真实付费模型任务;API 请求不自动重试,显示范围和费用后用户主动确认才发送。 +- 子代理不提交;主代理在全部完成并审查后统一提交。不要 push。 +- 后端 API 文档可能滞后,最终契约取 routes/*.routes.ts 与对应 service 的实际返回。 + +### Task 1: 生产计划、断点与限流 + +**Files:** Modify src/features/production/api.ts, types.ts, useAdvancedProduction.ts, components/AdvancedProduction.vue; create non-UI contract tests under tests/features/production. +**Consumes:** /production/plan POST、/production/start POST、useWorkflowExecution、ApiError.details。 +**Produces:** ProductionStartInput、ProductionPlanInput,productionApi.plan/startPipeline,预检后可编辑并确认的生产范围。 + +- [ ] 先验证现有 plan 的 GET 与后端 POST 不匹配,加入契约断言(真实 request 封装+受控 fetch)。 +```ts +await productionApi.plan('p', undefined, {imageProvider:'qwen-image',videoProvider:'wan'}) +// 最终请求必须为 POST /api/projects/p/production/plan;Provider 在 JSON body。 +``` +- [ ] 使用后端 production.routes.ts 的枚举与整数规则。 +```ts +/** 可恢复的生产阶段 */ +type ProductionStage = 'subjectImages' | 'keyframes' | 'videoPrompts' +// startFrom / stopAfter、stableIdentityAnchorLimit、subjectImageLimit、keyframeLimit、videoPromptLimit、imageGenerationOptions。 +``` +- [ ] AdvancedProduction 的参数变化废弃已确认预检和费用确认;safeMode 保留默认不提交视频的边界。所有上限默认有限值。显式结束阶段和起始阶段须检查顺序。 +- [ ] 预检与实际提交共用项目模型和图片参数;409 从 details.executionId 追踪已有任务,显示“已有任务”,不创建第二次请求。任务失败保留真实结果详情,不显示已完成。 +- [ ] 保持主要资产计数与项目归属检查;对照 production-plan.service.ts / production.service.ts 补足返回类型,不编造字段。 +- [ ] 执行定向 API 检查、typecheck、改动文件 lint/format,自查并写 task-1-report.md,不提交。 + +### Task 2: 首帧质量后台任务与历史 + +**Files:** Modify src/features/production/quality-api.ts, quality.types.ts, quality.ts, useQuality.ts, components/QualityDialog.vue, components/QualityResult.vue; Create components/KeyframeValidationHistory.vue. Do not modify api.ts/types.ts、ProductionPage.vue 或 ShotProductionAssets.vue(主代理集成)。 +**Consumes:** POST /projects/:id/keyframes/generate-quality 返回 {executionId,projectId,status:'running',total};GET /storyboard-shots/:shotId/keyframes/:keyframeId/validations 返回 {id,status,output,error,startedAt,finishedAt,createdAt}[]。 +**Produces:** QualityInput.shotId?、批量任务跟踪与最终回执;KeyframeValidationHistory 组件 props(projectId?,shotId,keyframeId),仅只读加载;单镜头质量目标支持 kind:'batch' 和 shotId/episodeNo。 + +- [ ] 先为 202 任务启动/目标过滤与历史契约建立失败断言,UI 验收交给主代理 Chrome。 +- [ ] qualityApi.generate 改为真实任务启动类型,useQuality 在收到 executionId 后追踪后台任务;未完成绝不能当 QualityBatchResult。每次启动参数固定,完成后按原项目/集/镜头保留回执和刷新。 +- [ ] 重用 useWorkflowExecution(projectId,'keyframe-quality'),刷新后恢复;展示任务阶段、计数、失败、最终逐镜结果;活跃任务阻止重复操作,409 若后端支持则附着已有任务。 +- [ ] 支持指定 shotId 且 limit=1 的单镜头重跑,显示明确费用范围;接入现有模型控制 provider / generationOptions(依后端参数)。保留 force 的清晰确认。 +- [ ] 历史组件读取 output JSON 的真实校验结论、summary、issues 和错误/时间,raw 不当成成功。切换目标取消请求、防旧响应覆盖,不触发新的校验。 +- [ ] 不根据历史 PASS 自动改变手动晋升政策,保留现有 currentness 和会话守卫。 +- [ ] 定向 API 检查、typecheck、lint/format并写 task-2-report.md,给主代理精确集成说明,不提交。 + +### Task 3: 身份预览、校验与稳定母版质量生成 + +**Files:** Own src/features/subject-identity/**;新增 API/type、可复用诊断组件,避免重构其它工作区。 +**Consumes:** subject-identity.routes.ts 的 /identity/images/preview POST、/images/:imageId/validate POST、/stable-anchor/generate-quality POST;对应服务 DTO。 +**Produces:** 生图弹窗真实输入预览;身份图库指定图片质量校验及结果;Scene/Prop 单主体稳定母版质量生成和回执。 + +- [ ] 依据真实请求(provider、generationOptions、生成类型和参考图参数)验证预览参数与实际生成同源;只读预览不生成、不锁定。 +- [ ] 预览显示实际模型、参考图、最终 Prompt 和最终参数;切换主体/参数清空旧预览,取消或忽略迟到响应。 +- [ ] 身份校验保持显式费用确认;完成前不显示通过,失败显示后端 issues/summary,指定正式 subject/image ID,错误不清空原图库。 +- [ ] Scene/Prop 单主体质量生成保留 maxRepairAttempts、provider/options 与有限预算,成功按真实返回刷新母版、锁定状态和图库;人物仍走既有选角流程。 +- [ ] 新 API/DTO 基于后台服务返回,不沿用首帧 DTO 猜测。所有状态按原主体隔离。 +- [ ] 定向 API 检查、typecheck、lint/format,写 task-3-report.md,不提交。主代理负责 Chrome。 + +### Task 4: 视频诊断与分镜引用审计(主代理) + +**Files:** 新增 production/components/VideoQualityDiagnostics.vue 与 diagnostics.types.ts/api.ts;storyboard 的 api/types 与新增 SubjectCoverageAudit.vue;集成 ShotProductionAssets.vue、StoryboardPage.vue、ProductionPage.vue。 +**Consumes:** GET videos/quality-status?detail=true、GET videos/quality-exhaustion-analysis;GET /projects/:id/storyboard/subject-coverage。 +**Produces:** 只读失败详情与回退建议;分镜引用遗漏列表;首帧历史与单镜头质量入口,后台任务状态在弹窗外也可观察。 + +- [ ] 对照 video-quality-status.service.ts、video-quality-exhaustion-analyzer.service.ts 和 storyboard-subject-coverage-audit.service.ts 定义全部展示字段与 API;直接引用实际判定,不自行判成功。 +- [ ] VideoQualityDiagnostics 按需加载,展示链路、问题、发生次数、后端疑因和 recommendedRollback。只读操作不调用修复;换目标取消请求。 +- [ ] SubjectCoverageAudit 按需零费用读取,展示统计和遗漏主体/镜头;引用跳转使用当前项目正式 ID,不自动修复生成。 +- [ ] ShotProductionAssets 添加历史与单镜头质量重跑入口,QualityDialog 使用 Task 2 提供的 batch shotId目标;ProductionPage 加持久化 keyframe-quality 观察面板。 +- [ ] 共享诊断布局超过两处时抽离通用组件;尊重当前主题与15px间距。 + +### Task 5: 验证、审查与提交 + +- [ ] 本地 Chrome 在专用 localhost 端口检查全部六项入口、真实读取、错误显示、目标切换、弹窗关闭/重开及任务恢复;仅取消付费确认。 +- [ ] 定向契约检查、lint、改动文件 format、typecheck、build;全量测试排除 .worktrees/** 和 .worktree/**,与基线已有失败比较,不修无关旧故障。 +- [ ] 子代理逐任务审查及最终整分支审查,修复本次新增问题;用户已授权一次最终提交,无需再次问。 +- [ ] git diff --stat、git diff 后提交 Conventional Commit:feat(short-drama-agent-front): 补齐后端生产与质量功能。报告实际分支/提交和验证限制,不 push。 + +### Task 6: 已有分镜与普通首帧入口的 202 契约补齐 + +**Files:** storyboard/api.ts/useStoryboard.ts/StoryboardPage.vue;production/api.ts/useProduction.ts/ProductionPage.vue;projects/ProjectLayout.vue;workflows/execution.ts(仅阶段标签)。 +**Consumes:** storyboard.routes.ts 下正式 regenerate(workflowName breakdown,metadata 用于区分镜头重生成)、directions/generate(storyboard-direction)、visual-states/generate(storyboard-visual-state)、video-prompts/generate(video-prompt)、keyframes/generate(keyframe-generation)实际 202 启动与最终 result。 +**Produces:** 这些已有入口与质量入口一样正确后台化,不接测试路由、不创建新页面。 + +- [ ] 对照真实路由的 workflowName 与 metadata,以及最终服务 DTO。API 启动方法返回 WorkflowExecutionStart,而不是最终批量/重生成回执。 +- [ ] useStoryboard 分别跟踪任务,成功启动后不发布完成回执;在终态按原 projectId/episodeNo/metadata 归属发布真实结果。重生成仅在校验有效时更新当前正式缓存,旧 ID 缓存清理规则保留。 +- [ ] useProduction 普通首帧生成同样跟踪 keyframe-generation,完成后生成原项目首帧回执并刷新;视频/提示词已有后台 track 补传原 projectId 防跨项目归属。 +- [ ] 项目布局持续观察这些名字以维持跨页面活动锁,工作区展示状态面板与手动刷新;复用现有共享执行组件。 +- [ ] 有限范围、旧结果不误报完成、费用确认、操作互斥与全部中文注释规范保持。不提交,不执行付费请求。 +- [ ] 先验证旧 API 把202类型当成最终结果的契约问题,补充 API边界测试;主代理负责 Chrome 确认入口/取消费用对话框。 diff --git a/docs/superpowers/specs/2026-10-08-backend-contract-sync-design.md b/docs/superpowers/specs/2026-10-08-backend-contract-sync-design.md new file mode 100644 index 0000000..5245e9e --- /dev/null +++ b/docs/superpowers/specs/2026-10-08-backend-contract-sync-design.md @@ -0,0 +1,11 @@ +# 后端正式功能同步设计 + +用户已确认补齐全部六项缺口,功能验证后提交。后端基线为本地 dev 的 c58cc51,前端基线为 dev 的 967c4eb。仅在本工作树修改前端。 + +沿用已有页面和公共组件,分别接入:生产计划 POST 与断点/限流配置;首帧质量后台 executionId 及指定镜头重跑;首帧历史;身份生图预览、校验与稳定母版质量生成;视频质量详情与修复耗尽归因;分镜主体引用覆盖审计。 + +真实数据与最终请求以 src/api/routes 和服务返回为准。保留 AbortSignal、目标归属校验、费用确认、任务恢复、过期阻断和手动刷新。读取历史与诊断不能自动调用生成,也不能因历史 PASS 而放宽现有资产晋升检查。Production 409 时跟踪已有 executionId,避免重复提交。后台开始与最终完成分别展示。 + +界面使用现有 Naive UI、公共 AppDialog/WorkspaceTools 与 15px 布局;中文标签清晰,次要诊断按需展开。所有新增/修改函数、类型字段、响应式变量和 UI 模块写中文注释。 + +在本地 Chrome 验证真实后端读取和交互,禁止 Playwright;验证时不提交真实付费模型任务。验证后统一提交本工作树,当前请求没有授权 push。已知基线 321 个自动测试中有 80 个已有失败、43 个已有格式问题,需单独记录并区分新增问题。 diff --git a/src/components/ui/ReadonlyInspection.vue b/src/components/ui/ReadonlyInspection.vue new file mode 100644 index 0000000..81b8668 --- /dev/null +++ b/src/components/ui/ReadonlyInspection.vue @@ -0,0 +1,52 @@ + + + diff --git a/src/features/production/ProductionPage.vue b/src/features/production/ProductionPage.vue index b3de565..4b2147a 100644 --- a/src/features/production/ProductionPage.vue +++ b/src/features/production/ProductionPage.vue @@ -4,15 +4,7 @@ import { NFormItem } from 'naive-ui' import { integerRule, sizeRules } from '../../lib/form-rules' import WorkspacePage from '../../components/ui/WorkspacePage.vue' import WorkspaceTools from '../../components/ui/WorkspaceTools.vue' -import { - NScrollbar, - NAlert, - NButton, - NCheckbox, - NInputNumber, - NProgress, - NSelect -} from 'naive-ui' +import { NScrollbar, NAlert, NButton, NCheckbox, NInputNumber, NProgress, NSelect } from 'naive-ui' import { computed, inject, ref, watch } from 'vue' import { ArrowLeft, CheckCircle2, CircleAlert, Film, Image, MessageSquareText, RefreshCw } from '@lucide/vue' import { EmptyState, StatusBadge } from '../../components/ui' @@ -30,6 +22,7 @@ import QualityDialog from './components/QualityDialog.vue' import CreativeProfileSettings from '../generation-config/components/CreativeProfileSettings.vue' import EpisodeAssemblyPanel from './components/EpisodeAssemblyPanel.vue' import WorkflowExecutionPanel from '../workflows/WorkflowExecutionPanel.vue' +import { useWorkflowExecution } from '../workflows/execution' const qualityOpen = ref(false) /** 镜头生产页将项目批处理与单镜头资产管理放在同一条可核验链路中。 */ @@ -42,10 +35,12 @@ const { shots, shot, promptItem, + keyframeExecution, keyframeItem, videoItem, videoStatusItem, query, + episodeSourceUnavailable, operation, session, concurrency, @@ -66,6 +61,26 @@ const { promptExecution, videoExecution } = useProduction() +/** 首帧质量任务在关闭弹窗后仍可观察,刷新页面后恢复持久化句柄。 */ +const keyframeQualityExecution = useWorkflowExecution(id, 'keyframe-quality') + +/** + * 将首帧质量启动句柄交给页面级观察器,始终保存当前原项目归属。 + * @param executionId 后端返回的真实任务编号 + * @returns 当前观察状态刷新完成 + */ +async function trackKeyframeQuality(executionId: string) { + await keyframeQualityExecution.track(executionId, id.value) +} + +/** 后台首帧质量结束后刷新当前项目资产,不把开始任务当作完成。 */ +watch( + () => keyframeQualityExecution.query.data.value?.status, + status => { + const record = keyframeQualityExecution.query.data.value + if (record?.projectId === id.value && (status === 'completed' || status === 'failed')) void refreshProject() + } +) const route = inject(routeLocationKey, undefined) /** 从素材页返回时恢复到指定剧集与正式镜头,不按重复的 Shot 编号定位。 */ watch( @@ -365,353 +380,322 @@ const videoRules = { videoLimit: integerRule('本批镜头上限'), videoRepairA

项目生产总览与批量操作

- - 当前有 {{ videoRunning }} 个视频任务等待或生成中。系统会持续更新任务状态,同一镜头不会重复提交。 - - - 当前有 {{ identityBlocked }} 项角色身份尚未准备完成。请先确认角色母版并完成身份锁定,再生成镜头首帧。 - 前往主体身份 → - - 当前有 {{ invalidGenerationSpecs }} 个镜头的设计信息还不完整。请先补齐镜头设计和即时视觉状态。 - - 前往分镜设计 → - - - - 当前有 - {{ staleKeyframes }} - 个主首帧已过期。它们使用的主体参考资产已经变化,视频阶段会被阻止;可在下方逐镜重新生成,或使用“补齐 - / 更新主首帧”批量处理。 - - - 当前有 - {{ staleVideos }} - 个主视频已过期。它们使用的主首帧或主体参考图已经变化;非覆盖模式批量生成时会只重建这些过期主视频。 - - - - -
-
-
-
- -
-

STEP {{ stage.code }}

-

- {{ stage.title }} -

-
-
- {{ stage.done }} / {{ stage.data?.total ?? 0 }} -
-

- {{ stage.description }} -

- -
-
-
可执行
-
{{ stage.data?.ready ?? 0 }}
-
-
-
已有结果
-
{{ stage.data?.skipped ?? 0 }}
-
-
-
阻塞
-
{{ stage.data?.blocked ?? 0 }}
-
-
-

- 已过期 {{ staleKeyframes }} · 会按当前主体参考资产重新生成 -

-

- 主视频已过期 {{ staleVideos }} · - 会按当前主首帧与参考资产重新生成 -

-

- 身份缺失 - {{ query.data.value?.keyframes.missingIdentity ?? 0 }} · - 母版缺失 - {{ query.data.value?.keyframes.missingIdentityAnchor ?? 0 }} · - 未锁定 - {{ query.data.value?.keyframes.identityUnlocked ?? 0 }} -

- - - - - - -
- -
-
- -
-
- 首帧模式 - {{ inputPlan?.firstFrameCount ?? 0 }} -
-
- 全模态参考 - {{ inputPlan?.omniReferenceCount ?? 0 }} -
-
- - 输入规划暂不可用,仍可按“全部推荐模式”提交;刷新后可重试规划。 - - - - - - -
-
-
-
-
+ + 当前有 + {{ videoRunning }} + 个视频任务等待或生成中。系统会持续更新任务状态,同一镜头不会重复提交。 + + + 当前有 + {{ identityBlocked }} + 项角色身份尚未准备完成。请先确认角色母版并完成身份锁定,再生成镜头首帧。 + 前往主体身份 → + + 当前有 + {{ invalidGenerationSpecs }} + 个镜头的设计信息还不完整。请先补齐镜头设计和即时视觉状态。 + + 前往分镜设计 → + + + + 当前有 + {{ staleKeyframes }} + 个主首帧已过期。它们使用的主体参考资产已经变化,视频阶段会被阻止;可在下方逐镜重新生成,或使用“补齐 + / 更新主首帧”批量处理。 + + + 当前有 + {{ staleVideos }} + 个主视频已过期。它们使用的主首帧或主体参考图已经变化;非覆盖模式批量生成时会只重建这些过期主视频。 + + + + +
+
+
+
+
-

视频任务状态

-

- 状态统计取每个镜头最近一次任务,不等同于主视频数量。 -

+

STEP {{ stage.code }}

+

+ {{ stage.title }} +

-
-
-
-
完成
-
{{ query.data.value.videoStatus.completed }}
-
-
-
排队/生成
-
{{ videoRunning }}
-
-
-
失败
-
{{ query.data.value.videoStatus.failed }}
-
-
-
取消
-
{{ query.data.value.videoStatus.cancelled }}
-
-
-
未开始
-
{{ query.data.value.videoStatus.notStarted }}
-
-
+ {{ stage.done }} / {{ stage.data?.total ?? 0 }}
+

+ {{ stage.description }} +

+ +
+
+
可执行
+
{{ stage.data?.ready ?? 0 }}
+
+
+
已有结果
+
{{ stage.data?.skipped ?? 0 }}
+
+
+
阻塞
+
{{ stage.data?.blocked ?? 0 }}
+
+
+

+ 已过期 {{ staleKeyframes }} · 会按当前主体参考资产重新生成 +

+

+ 主视频已过期 {{ staleVideos }} · 会按当前主首帧与参考资产重新生成 +

+

+ 身份缺失 + {{ query.data.value?.keyframes.missingIdentity ?? 0 }} · 母版缺失 + {{ query.data.value?.keyframes.missingIdentityAnchor ?? 0 }} · 未锁定 + {{ query.data.value?.keyframes.identityUnlocked ?? 0 }} +

+ + + + + + +
+ +
+
+ +
+
+ 首帧模式 + {{ inputPlan?.firstFrameCount ?? 0 }} +
+
+ 全模态参考 + {{ inputPlan?.omniReferenceCount ?? 0 }} +
+
+ + 输入规划暂不可用,仍可按“全部推荐模式”提交;刷新后可重试规划。 + + + + + + +
+
+
+
+
+
+

视频任务状态

+

+ 状态统计取每个镜头最近一次任务,不等同于主视频数量。 +

+
+ +
+
+
+
完成
+
{{ query.data.value.videoStatus.completed }}
+
+
+
排队/生成
+
{{ videoRunning }}
+
+
+
失败
+
{{ query.data.value.videoStatus.failed }}
+
+
+
取消
+
{{ query.data.value.videoStatus.cancelled }}
+
+
+
未开始
+
{{ query.data.value.videoStatus.notStarted }}
+
+
+
@@ -720,6 +704,30 @@ const videoRules = { videoLimit: integerRule('本批镜头上限'), videoRepairA + + + + + + + 本集镜头已重新生成。新标题和剧情详情尚未提供,当前只显示正式镜头编号;请按实际生成规格核对内容。 +
本项目镜头素材和视频成片已经准备完成。 镜头制作准备已经完成。视频生成费用较高,可按需要逐批提交视频任务。 @@ -852,12 +860,14 @@ const videoRules = { videoLimit: integerRule('本批镜头上限'), videoRepairA :key="shot.shotId" :project-id="id" :shot="shot" + :episode-no="episodeNo" :prompt-readiness="promptItem" :keyframe-readiness="keyframeItem" :video-readiness="videoItem" :open-keyframe="openRequestedKeyframe" - :disabled="blocked || !!linkedShotMissing" + :disabled="blocked || keyframeQualityExecution.active.value || !!linkedShotMissing" @changed="refreshProject" + @quality-started="trackKeyframeQuality" /> @@ -879,6 +889,7 @@ const videoRules = { videoLimit: integerRule('本批镜头上限'), videoRepairA :disabled="blocked" @changed="refreshProject" @locate="locateQualityShot" + @started="trackKeyframeQuality" /> diff --git a/src/features/production/api.ts b/src/features/production/api.ts index 19e147e..340755d 100644 --- a/src/features/production/api.ts +++ b/src/features/production/api.ts @@ -4,7 +4,6 @@ import type { GenerateKeyframeInput, GenerateKeyframesInput, GenerateQualityVideosInput, - KeyframeBatchResult, KeyframeReadiness, KeyframeGenerationPreview, KeyframeSpec, @@ -12,6 +11,8 @@ import type { ProjectVideoInputPlan, PromptReadiness, ProductionPlan, + ProductionPlanInput, + ProductionStartInput, ProviderInputSpec, ProjectProductionStatus, RetryVideosResult, @@ -56,29 +57,32 @@ export const productionApi = { request(`${shotPath(shotId)}/provider-input-spec?provider=${encodeURIComponent(provider)}`, { signal }), - /** 查询当前计划,不生成图片、视频或提示词。 */ - plan: (projectId: string, signal?: AbortSignal, providers?: { imageProvider?: string; videoProvider?: string }) => { - const params = new URLSearchParams() - if (providers?.imageProvider) params.set('imageProvider', providers.imageProvider) - if (providers?.videoProvider) params.set('videoProvider', providers.videoProvider) - const query = params.size ? `?${params}` : '' - return request(`${projectPath(projectId)}/production/plan${query}`, { signal }) - }, + /** + * 使用正式 POST 预检当前生产计划,不产生生成费用。 + * @param projectId 正式项目 ID + * @param signal 取消信号 + * @param input 与启动同源的模型及图片参数 + * @returns 后端实际生产计划 + */ + plan: (projectId: string, signal?: AbortSignal, input: ProductionPlanInput = {}) => + request(`${projectPath(projectId)}/production/plan`, { + method: 'POST', + body: input, + signal + }), /** 读取真实主资产完成状态,不能用任务提交回执代替。 */ status: (projectId: string, signal?: AbortSignal) => request(`${projectPath(projectId)}/production/status`, { signal }), - startPipeline: ( - projectId: string, - input?: { - imageProvider?: string - videoProvider?: string - stopAfter?: 'keyframes' | 'videoPrompts' - keyframeLimit?: number - } - ) => + /** + * 启动有限范围的串联生产,最终结果通过任务查询取得。 + * @param projectId 正式项目 ID + * @param input 模型、断点、停止阶段和各阶段上限 + * @returns 真实后台任务观察句柄 + */ + startPipeline: (projectId: string, input: ProductionStartInput = {}) => request(`${projectPath(projectId)}/production/start`, { method: 'POST', - body: input ?? {} + body: input }), promptReadiness: (projectId: string, force: boolean, signal?: AbortSignal) => request(`${projectPath(projectId)}/video-prompts/readiness?force=${force}`, { signal }), @@ -96,8 +100,14 @@ export const productionApi = { }), keyframeReadiness: (projectId: string, force: boolean, signal?: AbortSignal) => request(`${projectPath(projectId)}/keyframes/readiness?force=${force}`, { signal }), + /** + * 后台批量生成普通首帧候选。 + * @param projectId 正式项目 ID + * @param input 当前生成范围和模型参数 + * @returns 真实后台任务观察句柄 + */ generateKeyframes: (projectId: string, input: GenerateKeyframesInput) => - request(`${projectPath(projectId)}/keyframes/generate`, { + request(`${projectPath(projectId)}/keyframes/generate`, { method: 'POST', body: input, timeoutMs: 0 diff --git a/src/features/production/components/AdvancedProduction.vue b/src/features/production/components/AdvancedProduction.vue index 883a119..bfcab79 100644 --- a/src/features/production/components/AdvancedProduction.vue +++ b/src/features/production/components/AdvancedProduction.vue @@ -1,5 +1,5 @@ {{ capability.valid - ? `当前镜头需要 ${capability.referenceCount} 张参考图,符合 ${capability.provider} 的已声明能力。` + ? capability.message || + `当前镜头共有 ${capability.referenceCount} 张业务参考图,后端已判定本次规划符合 ${capability.provider} 能力。` : capability.message || '当前镜头不满足模型能力限制。' }} +

+ 本次计划输入 {{ capability.plannedReferenceCount }} 张 · 转为文字约束 + {{ capability.omittedReferenceCount ?? 0 }} 张 +

diff --git a/src/features/production/components/ProductionPlanPanel.vue b/src/features/production/components/ProductionPlanPanel.vue index 5e46af0..9c67c37 100644 --- a/src/features/production/components/ProductionPlanPanel.vue +++ b/src/features/production/components/ProductionPlanPanel.vue @@ -5,8 +5,8 @@ import type { ProductionPlan, ProjectProductionStatus } from '../types' /** 展示当前制作计划与真实资产状态,不在页面重复推断业务规则。 */ const props = defineProps<{ plan: ProductionPlan; status: ProjectProductionStatus }>() +/** 生产阶段共享计划字段,角色身份就绪信息单独展示,避免混用不同 DTO。 */ const rows = computed(() => [ - ...(props.plan.characterIdentity ? [{ label: '角色身份', stage: props.plan.characterIdentity }] : []), ...(props.plan.stableIdentityAnchors ? [{ label: '稳定身份锚点', stage: props.plan.stableIdentityAnchors }] : []), { label: '主体参考图', stage: props.plan.subjectImages }, { label: '首帧质量', stage: props.plan.keyframes }, @@ -48,6 +48,12 @@ const problems = computed(() => [ 图片模型:{{ plan.providers.image }} 视频模型:{{ plan.providers.video }}
+ +

+ 角色身份:已就绪 {{ plan.characterIdentity.ready }} / {{ plan.characterIdentity.total }} · 待就绪 + {{ plan.characterIdentity.pending }} · 可自动补齐 {{ plan.characterIdentity.autoResolvable }} · 需人工处理 + {{ plan.characterIdentity.manualBlocked }} +

当前制作状态:{{ status.completed ? '制作已完成' : `待完成${stageNames[status.stage]}` }} · 有效主体图 {{ status.subjectImages.current }}/{{ status.subjectImages.total }} · 有效首帧 diff --git a/src/features/production/components/QualityDialog.vue b/src/features/production/components/QualityDialog.vue index 3e0ee34..9b68a81 100644 --- a/src/features/production/components/QualityDialog.vue +++ b/src/features/production/components/QualityDialog.vue @@ -19,35 +19,84 @@ import { allowedTextLines, validQualityInput } from '../quality' import type { QualityAction, QualityInput, QualityTarget } from '../quality.types' import { useQuality } from '../useQuality' import QualityResult from './QualityResult.vue' +import KeyframeValidationHistory from './KeyframeValidationHistory.vue' +import WorkflowExecutionPanel from '../../workflows/WorkflowExecutionPanel.vue' +import GenerationModelControls from '../../generation-config/components/GenerationModelControls.vue' +import { generationConfigApi } from '../../generation-config/api' +import type { GenerationOptions } from '../../generation-config/types' +import { useQuery } from '../../../composables/useQuery' import ModelCapabilities from './ModelCapabilities.vue' /** 单素材与当前集质量生成共用一个按需打开的面板,默认小批量且不自动调用模型。 */ const props = defineProps<{ + /** 当前项目 */ projectId: string + /** 固定质量目标 */ target: QualityTarget | null + /** 上游状态阻断 */ disabled: boolean }>() +/** 质量面板的open状态,随目标更新。 */ const open = defineModel('open', { default: false }) -const emit = defineEmits<{ changed: []; locate: [shotId: string] }>() -const { key, session, operation, blocked, run } = useQuality( +/** 通知外部刷新、定位与后台任务开始。 */ +const emit = defineEmits<{ changed: []; locate: [shotId: string]; started: [executionId: string] }>() +const { key, session, operation, execution, blocked, run } = useQuality( props, () => open.value, - () => emit('changed') + () => emit('changed'), + id => emit('started', id) ) +/** 模型目录只读查询,随当前项目和弹窗状态取消过期请求。 */ +const modelKey = computed(() => + open.value && props.target?.kind === 'batch' && props.projectId ? props.projectId : '' +) +/** 模型与项目画幅读取,不自动写入配置。 */ +const modelQuery = useQuery(modelKey, async (projectId, signal) => + projectId + ? { + catalog: await generationConfigApi.catalog(signal), + profile: await generationConfigApi.profile(projectId, signal) + } + : null +) +/** 本次明确选择的图片供应方。 */ +const provider = ref('') +/** 本次生成与修复共用参数。 */ +const generationOptions = ref({}) +/** 后台任务期间表单也保持锁定。 */ +const pending = computed(() => operation.value.pending || execution.active.value) +/** 当前目标的单镜头范围。 */ +const singleShot = computed(() => props.target?.kind === 'batch' && !!props.target.shotId) +/** 质量面板的formRef状态,随目标更新。 */ const formRef = ref | null>(null) +/** 质量面板的action状态,随目标更新。 */ const action = ref('validate') +/** 质量面板的attempts状态,随目标更新。 */ const attempts = ref(1) +/** 质量面板的concurrency状态,随目标更新。 */ const concurrency = ref(1) +/** 质量面板的limit状态,随目标更新。 */ const limit = ref(1) +/** 质量面板的force状态,随目标更新。 */ const force = ref(false) +/** 质量面板的width状态,随目标更新。 */ const width = ref(null) +/** 质量面板的height状态,随目标更新。 */ const height = ref(null) +/** 质量面板的texts状态,随目标更新。 */ const texts = ref('') +/** 质量面板的acknowledged状态,随目标更新。 */ const acknowledged = ref(false) +/** 质量面板的videoRepair状态,随目标更新。 */ const videoRepair = computed(() => props.target?.kind === 'video' && action.value === 'repair') +/** 质量面板的input状态,随目标更新。 */ const input = computed(() => ({ concurrency: action.value === 'batch' ? (concurrency.value ?? 0) : 1, - limit: action.value === 'batch' ? (limit.value ?? 0) : 1, + limit: action.value === 'batch' && !singleShot.value ? (limit.value ?? 0) : 1, + ...(props.target?.kind === 'batch' && props.target.shotId ? { shotId: props.target.shotId } : {}), + ...(action.value === 'batch' && provider.value + ? { provider: provider.value, generationOptions: { ...generationOptions.value } } + : {}), maxRepairAttempts: action.value === 'validate' ? 0 : (attempts.value ?? -1), force: force.value, episodeNo: props.target?.kind === 'batch' ? props.target.episodeNo : 1, @@ -55,10 +104,23 @@ const input = computed(() => ({ ...(action.value === 'validate' || width.value === null ? {} : { width: width.value }), ...(action.value === 'validate' || height.value === null ? {} : { height: height.value }) })) -const valid = computed( - () => validQualityInput(input.value) && (!videoRepair.value || input.value.maxRepairAttempts > 0) +/** 批量生图必须读到真实配置并显式选定启用模型,不能回退到未确认的全局默认。 */ +const modelReady = computed( + () => + props.target?.kind !== 'batch' || + (!modelQuery.loading.value && + !modelQuery.error.value && + !!modelQuery.data.value?.profile && + modelQuery.data.value.catalog.images.some(model => model.provider === provider.value && model.enabled)) ) +/** 参数及模型均有效时才允许进入费用确认后的提交。 */ +const valid = computed( + () => + modelReady.value && validQualityInput(input.value) && (!videoRepair.value || input.value.maxRepairAttempts > 0) +) +/** 质量面板的generating状态,随目标更新。 */ const generating = computed(() => action.value !== 'validate') +/** 质量面板的label状态,随目标更新。 */ const label = computed(() => action.value === 'batch' ? '开始质量生成' @@ -68,6 +130,7 @@ const label = computed(() => : '校验并修复' : '开始视觉校验' ) +/** 质量面板的maxImages状态,随目标更新。 */ const maxImages = computed(() => action.value === 'batch' ? input.value.limit * (1 + input.value.maxRepairAttempts) @@ -75,10 +138,13 @@ const maxImages = computed(() => ? input.value.maxRepairAttempts : 0 ) +/** 质量面板的maxValidations状态,随目标更新。 */ const maxValidations = computed(() => action.value === 'batch' ? maxImages.value : action.value === 'repair' ? input.value.maxRepairAttempts + 1 : 1 ) +/** 质量面板的saved状态,随目标更新。 */ const saved = computed(() => (props.target?.kind === 'video' ? (session.value.videoValidation ?? null) : null)) +/** 质量面板的repairAvailable状态,随目标更新。 */ const repairAvailable = computed( () => !videoRepair.value || @@ -99,19 +165,35 @@ watch( width.value = null height.value = null texts.value = '' + provider.value = '' + generationOptions.value = {} acknowledged.value = false }, { immediate: true } ) +/** 参数变化撤销付费确认。 */ watch([input, action], () => { acknowledged.value = false }) +/** 模型目录加载后使用项目已保存的供应方与参数,切镜头重置单次覆盖。 */ +watch( + [() => modelQuery.data.value, key], + ([data]) => { + if (!data?.profile || props.target?.kind !== 'batch') return + const selected = data.catalog.images.find(item => item.provider === data.profile!.imageProvider && item.enabled) + if (!selected) return + provider.value = selected.provider + generationOptions.value = { ...selected.defaults, ...data.profile.imageOptions } + }, + { flush: 'post' } +) /** 付费入口保留明确确认,不因菜单选择或查看历史自动提交。 */ async function submit() { if (!acknowledged.value || !valid.value || blocked.value || !repairAvailable.value) return acknowledged.value = false await run(action.value, input.value) } +/** 质量面板的formModel状态,随目标更新。 */ const formModel = computed(() => ({ attempts: attempts.value, concurrency: concurrency.value, @@ -120,16 +202,19 @@ const formModel = computed(() => ({ height: height.value, texts: texts.value })) +/** 质量面板的rules状态,随目标更新。 */ const rules = computed(() => ({ attempts: integerRule('修复次数', videoRepair.value ? 1 : 0), concurrency: integerRule('批量并发'), limit: integerRule('本批镜头上限'), ...sizeRules(() => formModel.value) })) +/** 更多参数折叠状态。 */ const optionsExpanded = ref(['options']) - 我已确认费用、处理范围,且同项目没有其他生成任务。 - -

- {{ operation.label }}进行中,请勿重复提交。 -

+

{{ operation.label }}进行中,请勿重复提交。

{{ session.error }} + + + (['options']) >

- 校验回执保留在当前会话,可导出;素材列表不提供历史质量结果,刷新浏览器后需重新校验。 + 本会话回执可导出;首帧已有校验可在历史中只读查看,后台质量任务刷新后继续恢复。

diff --git a/src/features/production/components/QualityResult.vue b/src/features/production/components/QualityResult.vue index 0ea73ec..0605a28 100644 --- a/src/features/production/components/QualityResult.vue +++ b/src/features/production/components/QualityResult.vue @@ -6,7 +6,9 @@ import type { QualityReceipt } from '../quality.types' /** 摘要、失败与完整逐轮信息默认直接显示,不用完成请求冒充质量通过。 */ const props = defineProps<{ receipt: QualityReceipt }>() +/** 逐镜结果定位事件。 */ const emit = defineEmits<{ locate: [shotId: string] }>() +/** 完整最终回执的视觉结论。 */ const passed = computed(() => props.receipt.kind === 'batch' ? props.receipt.result.targetCount > 0 && props.receipt.result.passed === props.receipt.result.targetCount @@ -14,6 +16,7 @@ const passed = computed(() => ? false : props.receipt.result.passed ) +/** 当前失败问题列表。 */ const issues = computed(() => { const value = props.receipt return value.kind === 'batch' || value.kind === 'video-repair' @@ -22,6 +25,7 @@ const issues = computed(() => { ? (value.result.attempts.at(-1)?.issues ?? []) : value.result.issues }) +/** 视频专项检查详情。 */ const videoChecks = computed(() => { if (props.receipt.kind !== 'video') return [] const result = props.receipt.result @@ -43,6 +47,7 @@ function exportResult() { diff --git a/src/features/production/components/ShotProductionAssets.vue b/src/features/production/components/ShotProductionAssets.vue index 858550c..c66286f 100644 --- a/src/features/production/components/ShotProductionAssets.vue +++ b/src/features/production/components/ShotProductionAssets.vue @@ -32,6 +32,8 @@ import type { import KeyframeDialog from './KeyframeDialog.vue' import KeyframeCard from './KeyframeCard.vue' import QualityDialog from './QualityDialog.vue' +import VideoQualityDiagnostics from './VideoQualityDiagnostics.vue' +import KeyframeValidationHistory from './KeyframeValidationHistory.vue' import ActionMenu from '../../../components/ui/ActionMenu.vue' import { AppDialog } from '../../../components/ui' import ModelCapabilities from './ModelCapabilities.vue' @@ -47,25 +49,37 @@ import GenerationModelControls from '../../generation-config/components/Generati /** 单镜头生产面板只负责正式资产,不修改上游导演设计与即时状态。 */ const props = defineProps<{ + /** 当前正式项目 ID。 */ projectId: string + /** 当前正式镜头。 */ shot: DesignedShot + /** 当前剧集编号,用于限制单镜头质量生成。 */ + episodeNo?: number + /** 视频提示词就绪项。 */ promptReadiness?: PromptReadinessItem + /** 首帧就绪项。 */ keyframeReadiness?: KeyframeReadinessItem + /** 视频就绪项。 */ videoReadiness?: VideoReadinessItem + /** 是否从深链接打开首帧生成。 */ openKeyframe?: boolean + /** 页面上游状态是否阻断操作。 */ disabled: boolean }>() -const emit = defineEmits<{ changed: [] }>() +/** 通知父页面刷新及观察已启动的质量任务。 */ +const emit = defineEmits<{ changed: []; qualityStarted: [executionId: string] }>() const key = computed(() => props.shot.shotId) /** 仅当前镜头存在后台首帧或视频任务时临时轮询,终态后自动停止。 */ -let query!: ReturnType> - videos: Awaited> - qualityStatus: Awaited> | null - qualityStatusError: string - inputPlan: Awaited> | null - inputPlanError: string -}>> +let query!: ReturnType< + typeof usePolling<{ + keyframes: Awaited> + videos: Awaited> + qualityStatus: Awaited> | null + qualityStatusError: string + inputPlan: Awaited> | null + inputPlanError: string + }> +> const assetPollInterval = computed(() => { const data = query?.data.value if (!data) return false @@ -173,6 +187,17 @@ function openQuality(kind: 'keyframe' | 'video', assetId: string) { } qualityOpen.value = true } +/** 只打开当前镜头的有限质量重跑表单,费用确认后才发送任务。 */ +function openShotKeyframeQuality() { + if (!props.episodeNo || !canGenerateKeyframe.value) return + qualityTarget.value = { + kind: 'batch', + episodeNo: props.episodeNo, + shotId: props.shot.shotId, + title: `${props.shot.title} · 本镜首帧质量重跑` + } + qualityOpen.value = true +} const confirmingKeyframe = ref('') const confirmingVideo = ref('') const inspecting = ref(false) @@ -458,6 +483,15 @@ async function inspectSpecs() { />

尚无已确认主首帧。请生成候选,完成质量检查后再设为主首帧。

+ +
+ 本镜首帧质量重跑 管理候选({{ keyframeCandidates.length }}) @@ -597,6 +634,8 @@ async function inspectSpecs() { 。请检查候选视频和校验结果,调整提示词或参考资产后再重新生成。 + +