feat(short-drama-agent-front): 补齐后端生产与质量功能
This commit is contained in:
1 parent
967c4ebea1
commit
470b52e26d
52 files changed
+3754
-1075
No files matched your search
@@ -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 回填旧标题/时长,明确展示编号与缺省说明。完整重新拆解成功后才恢复新快照辅助信息。
|
||||
@@ -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 确认入口/取消费用对话框。
|
||||
@@ -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 个已有格式问题,需单独记录并区分新增问题。
|
||||
Reference in new issue
Block a user