feat(short-drama-agent-front): 接入分阶段镜头生产与摄影修订

This commit is contained in:
GJ committed 2026-11-15 20:55:51 +08:00
1 parent 1e9ef33d1d
commit 87427d9d43
29 files changed
+2787 -136

No files matched your search

+8
View File
@@ -1,5 +1,13 @@
# 接口数据同步说明
## 2026-11-15 V8-9.1 / V8-9.2 分阶段镜头生产
已在根目录 dev 增量接入正式 shotIds 定向摄影/画面状态、逐镜复用、派生批次停止、原 executionId 刷新恢复观察、独立摄影免费预检与版本绑定采用、原失败及零模型请求恢复展示,以及所选范围的参考素材/计划/资产缺口。默认 force=false、concurrency=1、maxRepairAttempts=0,不自动开始下一阶段或重发未知请求。
继续使用原分镜目录、摄影抽屉、工作流观察、统一 HTTP 错误和首帧授权/Preview 流程。正式四镜已完成摄影和画面状态,默认不重复生成。当前项目级生产仍受真实 needs_review 门禁限制,局部完成不改写全项目结论。
逐文件职责、真实免费 API 结果、Mock/Chrome 验收、正式使用条件与接口局限见 [本轮完整交接](audits/v8-9-staged-production-2026-11-15.md)。只修改前端,未执行真实付费或正式业务写入;实现验收后用户已授权提交并推送 dev,Git 结果以仓库记录为准。
## 2026-11-01 图片预览、质量门禁与派生任务
本次只接入后端根目录 `dev` 的正式 `/api` 路由,依据 `subject-form.routes.ts`、`subject-identity.routes.ts`、`production.routes.ts`、`storyboard.routes.ts` 及相应 Service 核对。未接入 3413 隔离验收服务、脚本、测试专用路由或测试页面;测试夹具只用于 Vitest。
@@ -0,0 +1,109 @@
# V8-9.1 / V8-9.2 前端接入交接
## 范围与基线
- 前端根目录 `dev`,基线 `1e9ef33d1d3a78766c08933a97f1b2f7c1faecd0`。开始时工作区干净。本轮只修改前端,未创建工作树。实现验收时未提交;随后用户明确授权检查完整 Diff、提交并推送 dev,Git 结果以仓库记录为准,不合并发布分支。
- 已核对后端根目录 `dev@c6f03454ed98e843a6f4ce3548bb1fbd9154bc18` 的 AGENTS、活跃计划、交接、Storyboard / Workflow 公开文档、两份前端 Prompt,以及正式路由、摄影 Schema、采用服务、派生新鲜度和生产准备服务。
- 正式项目 `cmw02vpwi000005axrdtus3pa`。所有收费生成、摄影采用、停止和并发写入测试均使用 Mock;正式项目只做免费读取、生产计划和首帧 Preview。没有覆盖正式结果、修改主体绑定或调用文本、图片、Vision、视频、Repair、Primary。
## 已交付行为
1. 复用分镜工作台的 Episode / Beat / Shot 目录,增加单镜及段落勾选。默认“所选镜头”、`concurrency=1`、`force=false`、`maxRepairAttempts=0`。当前集及全项目仍保留原批量语义,省略 `shotIds`。
2. 显示正式摄影、画面状态、任务运行/停止/失败及未知请求。有效结果全部具备时不重复 POST;混合范围完整传递正式镜头,后端逐镜复用。空、重复、跨集范围不能提交。HTTP 错误、空响应、字段缺失和合法空目录分别处理。
3. 画面状态必须等本次范围摄影有效后由用户单独发起,提交前重新读取正式确认、摄影和准备情况。`force=true` 明示下游失效及独立文本费用;同数量不同镜头、参数和范围变化会撤销原确认。
4. 沿用项目级发现、原 executionId、免费 GET / SSE 和活动任务锁。增加两类派生任务停止入口。停止后使用“已停止”,保留费用和在途结果。相同终态允许接受更晚的回执,拒绝重新激活和重复相同记录;未知领取即使 force 也不能重发。提交连接中断时持久保留待核对范围,只提供免费核对原提交。
5. 在原“摄影草案与审核”全屏抽屉内,已有摄影且无画面状态时使用独立摄影阶段。复用构图/机位编辑字段,保留其余真实摄影枚举及意图。免费预检携带原 id、ISO 时间、rawJson(含 null)和正式 shotFingerprint;采用冻结同一请求并加入 sourceFingerprint。`changed=false` 的预检仍可采用;幂等回执可接受。409 保留输入、撤销预检并要求显式重读,不自动覆盖。已有下游仍由原组合草案与服务端即时保护处理。
6. 画面状态免费恢复显示原执行、新执行、零模型请求和原失败历史。`received` 仅表示收到模型结果,不能证明可信回执或业务通过。普通页面没有 trace / 请求指纹输入,没有自动恢复或重试按钮;管理核查与原收费失败保持独立。
7. 免费核对所选镜头参考素材、正式项目入口、分阶段门禁和逐镜首帧/视频描述/视频缺口。先显示参考,再顺序读取完整计划与资产状态,避免重查询争抢;计划及状态可取消,读取上限为 120 秒。局部就绪不改变全项目生产门禁。
8. 完整项目上游复检受限时,可凭真实正式确认归属和非零镜头数进入分镜核对;完整生产和素材入口仍保留原门禁。图片授权、OpenAI 选择、原首帧 Preview 指纹、独立 Vision 与 Primary 流程沿用。首帧摄影摘要只展示摄影字段,不混入原文和内部版本。
## 复用组件及链路
保留 `StoryboardPage`、`BeatShotDirectory`、`DirectoryItem`、`ShotDerivedReview`、`ShotDesign`、`WorkspacePage`、`WorkspaceTools`、`AppDrawer`、`AppDialog`、`AppForm`、`WorkspaceSectionHeading`、`WorkspaceActionTooltip`、`ConfirmAction`、`WorkflowExecutionPanel`、`useWorkflowExecution`、`useQuery`、`runOperation`、`useActionMessage` 与统一 HTTP 错误处理。没有另建分镜页面、任务中心、API 服务或第二套主体归属规则。
构图和机位字段抽为 `DirectionCameraFields`,独立阶段与原组合修订共用。原组合草案、场景沿用、视线修订、保存草案及正式首帧候选流程保留。
## 真实 API 核对结果
以下均在 2026-11-15 本地正式 `localhost:3412/api` 核对,未做正式写入:
| 接口 | 结果 |
| --- | --- |
| GET Storyboard quality-confirmation(原别名及 `/storyboard/quality-confirmation`) | 200,valid=true,正式 60 镜,确认与证据指纹一致 |
| GET storyboard-directions / storyboard-visual-states,episodeNo=1 | 各 200,本集 7/17,staleCount=0;全项目各 7/60 |
| GET production/entry-readiness | 200,ready=false;当前原因为正式分镜复检 needs_review,不能当作全项目可生产 |
| POST production/plan `{}` | 200,约 19.25 秒,canStart=false,分阶段门禁保持真实阻断 |
| GET production/status | 200,约 16.27 秒,completed=false,stage=subject_images |
| GET image-authorizations | 200,有 1 条授权,billingBlocked=false;未修改授权额度和范围 |
| GET 四镜 references | 200,缺失引用为空;普通引用数量为 3/3/4/5,不等同最终模型参考职责数 |
| POST 四镜 keyframe/preview `{provider:'openai-image'}` | 均 200,返回正式指纹,blocking=false;最终实际参考数量 3/4/5/6 |
| GET 最新画面状态 Workflow 及其 recoveryOf 原任务 | 新任务 completed、recovered=true、actualModelRequests=0;原任务仍 failed,历史保留 |
生成、停止和采用的正式路由/Schema已核对,写操作成功、失败与并发边界由隔离 Mock 验证。本轮未为验收在正式项目执行任何此类写操作。普通 UI 不开放管理用 SDK 回执恢复参数。
## 素材导航禁用原因补充核查
用户截图中的“视觉风格、主体身份、形态图片”禁用来自正式 `stage-readiness.preparation.ready=false`,不是这三项自身数据丢失。实际 `visualStyle.ready=true`、`identity.ready=true`;正式质量确认 valid=true,结构检查、来源审计和动作审计均通过。
免费质量预检具体返回第 1 集 Beat 3 的 3.1~3.4 共 4 项 `missing_subject_reference`:VisualState 出现“金属搭扣”,但没有绑定独立 `@PR0003`。当前状态为 needs_review、preflightEligible=false,再经 checkCurrent → stage-readiness → 前端三个素材入口共同禁用。
已只读定位后端不一致:`storyboard-visual-state.service.ts` 的生成/恢复校验使用 `isBoundAttachedPropPartMention` 判定已绑定母件的连接部件;`storyboard-subject-coverage-audit.service.ts` 在 VisualState 分支直接调用普通 findMissing 并写入问题,没有经过相同归属过滤。因此四镜正式 VS 已免费恢复保存、单镜 Preview 通过,但项目复检仍出现同类误报。此前后端交接所述“覆盖审计共用部件规则”在此分支未完整落实,必须以当前代码与真实接口为准。
建议后端复用正式母件/Form/字段归属规则修复原覆盖审计,并覆盖完整 preflight、checkCurrent、stage-readiness、production/entry-readiness 链路。前端本轮不绕过门禁、不新增独立搭扣、不重生成四镜,不改写已通过数据;后端仓库未修改。
## 自动化与 Chrome 验收
- Vitest 集中回归:30 套、243 项通过,涵盖分镜、制作前审核、工作流、项目访问、原首帧、授权和预览。新增定向用例 19 项,覆盖范围/复用/顺序/force/断线持久保护/停止及在途回执/摄影预检采用/并发/原失败与免费恢复。相关复验 9 套、153 项通过,含免费准备失败/取消及同数量不同范围撤销确认;随后补充原组合摄影完整预览采用回归,新增定向套最终 19 项全部通过。其余未变更用例复用此前通过结果。
- 本次 Git 检查另执行完整 Vitest:113 套、873 项通过,无真实模型调用。
- TypeScript、改动范围 Oxlint、Vue ESLint、定向格式与 `git diff --check` 均通过。Vite production build 通过;测试页面不进入正式构建入口。
- 本机 pnpm 的版本管理拉取返回 fetch failed,因此直接运行项目现有 node_modules/.bin 下同名工具完成上述脚本对应检查,没有安装或升级依赖。
- 复用本地 Chrome 标签页,全部使用 localhost,未使用 Playwright。正式项目核对四镜 4/4 可复用、默认生成禁用、全项目与局部门禁区分、真实逐镜参考和阶段缺口、免费恢复与原失败并存。覆盖确认只打开查看并取消,恢复 force=false,未提交。
- `tests/browser/staged-production.html` 全量拦截请求,未知接口 403,不连接正式服务。桌面完成摄影编辑→免费预检→人工确认→采用并刷新;停止批次→查看“已停止”→免费刷新收到在途结果;均显示真实模型请求 0。
- 手机宽度 390px(约 650 / 905px 高度)检查目录、字段间距、24 行长内容输入、局部滚动、固定标题和底栏、关闭及采用按钮。任务状态和辅助按钮正常换行,不横向挤出。普通、键盘焦点及禁用状态沿用主题中性底面。
- 当前用户主题主色为蓝色,沿用其已有偏好;主操作仍使用统一 primary,默认主题为绿色。
## 文件与职责
| 状态 | 文件 | 职责 |
| --- | --- | --- |
| 新增 | src/features/storyboard/staged-derived.ts | 正式范围、来源状态、任务范围及未知领取保护 |
| 新增 | src/features/storyboard/components/DirectionCameraFields.vue | 独立与组合摄影共享构图、机位编辑及间距 |
| 新增 | src/features/storyboard/components/DirectionStageReview.vue | 独立摄影来源读取、免费预检、版本绑定采用与冲突 |
| 新增 | src/features/storyboard/components/StagedShotPreparation.vue | 所选参考、项目阶段计划和逐镜缺口读取 |
| 新增 | tests/features/storyboard/staged-derived.test.ts | 19 项定向流程、费用和历史边界回归 |
| 新增 | tests/browser/staged-production.html | 本地 Chrome 隔离验收入口 |
| 新增 | tests/browser/staged-production.ts | 全请求 Mock 与真实组件场景 |
| 新增 | docs/audits/v8-9-staged-production-2026-11-15.md | 本轮范围、API、验证、文件职责及交接 |
| 修改 | src/features/storyboard/StoryboardPage.vue | 原目录多选、范围/费用确认、准备摘要与停止入口 |
| 修改 | src/features/storyboard/useStoryboard.ts | 定向生成编排、有效结果复用、原任务及未知提交保护 |
| 修改 | src/features/storyboard/types.ts | 正式摄影原版本和可选 shotIds |
| 修改 | src/features/storyboard/components/BeatShotDirectory.vue | 原目录增加镜头、段落多选和窄屏布局 |
| 修改 | src/features/storyboard/components/ShotDerivedReview.vue | 原抽屉接入独立摄影,保留组合草案,共用字段 |
| 修改 | src/features/storyboard/derived-review-api.ts | 原 confirm 路由的 phase=direction 模式 |
| 修改 | src/features/storyboard/derived-review.types.ts | 独立摄影请求、预检和幂等回执契约 |
| 修改 | src/features/workflows/execution-api.ts | 原任务 stop 请求,绑定 projectId |
| 修改 | src/features/workflows/execution.ts | 停止状态、原回执更新、任务恢复观察及防回退 |
| 修改 | src/features/workflows/WorkflowExecutionPanel.vue | 停止/领取/恢复/原失败、位置问题及高级详情 |
| 修改 | src/features/workflows/ConfirmAction.vue | 同数量不同输入或范围改变时撤销费用确认 |
| 修改 | src/features/storyboard-preparation/types.ts | 正式入口中的阶段与逐镜缺口字段 |
| 修改 | src/features/production/types.ts | 正式项目分阶段准备契约 |
| 修改 | src/features/production/api.ts | 完整计划、状态读取的可取消耗时边界 |
| 修改 | src/features/production/components/KeyframeDialog.vue | 摄影摘要排除内部记录元数据,保留原生图流程 |
| 修改 | src/features/projects/ProjectLayout.vue | 正式镜头只读发现,不修改项目质量或生产结论 |
| 修改 | src/features/projects/useProjectStageAccess.ts | 只读分镜与完整生产入口分离 |
| 修改 | src/lib/user-facing-text.ts | 七类来源、范围及未知请求业务错误中文 |
| 修改 | tests/features/projects/access.test.ts | 正式分镜可读、完整生产仍受限 |
| 修改 | tests/features/workflows/pages.test.ts | 原批量操作明确选择范围,更新默认参数及状态回归 |
| 修改 | docs/api-contract-sync.md | 更新现有前端交接索引 |
删除 0。保留原后端门禁、原组合修订、图片授权、首帧/审核/Primary 与任务发现;强化原范围、版本、停止及请求未知保护。没有重复实现或待迁移的旧主流程。
## 正式使用与边界
可以在现有分镜工作台选择镜头、核对准备情况,默认复用有效成果;满足真实来源和费用条件后,由用户主动分别启动摄影或画面状态。独立摄影仅适用于尚无下游的真实镜头,最终以服务端预检与事务保护为准。正式四镜已有画面状态,因此应沿原组合摄影修订,不走独立阶段。
当前正式项目完整生产仍被服务端 needs_review 阻断。局部首帧 Preview 通过不能解除它,也不代表图片或视觉审核已经完成。后续由用户主动进入原首帧入口选择 openai-image,重新核对来源、参考图、授权额度及未知费用后生成候选;不自动切换供应方或启动后续流程。
接口局限:当服务只返回整集 staleCount 而没有逐镜 derivedAssetShotGaps 时,无法可靠定位具体过期镜头。此时已有记录标记“需核对来源”,不猜测过期位置,也不放行依赖未知摄影的画面状态。普通 UI 不提供缺少可信回执时的自动恢复。
未执行真实收费或正式写入验收,属于本轮明确禁止项;这部分通过 Mock 覆盖。没有其它主动省略的前端目标。