From 1da56e0d460f3cc2efa810f110ddcc97f08055b6 Mon Sep 17 00:00:00 2001 From: GJ Date: Mon, 19 Oct 2026 21:59:22 +0800 Subject: [PATCH] =?UTF-8?q?feat(short-drama-agent-front):=20=E5=AE=8C?= =?UTF-8?q?=E5=96=84=E5=88=86=E9=95=9C=E5=AE=A1=E6=A0=B8=E4=B8=8E=E5=88=B6?= =?UTF-8?q?=E4=BD=9C=E5=87=86=E5=A4=87=E6=B5=81=E7=A8=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 + docs/api-contract-sync.md | 48 +++ docs/backend-diagnosis-follow-up.md | 30 ++ ...backend-production-navigation-follow-up.md | 25 ++ docs/frontend-contract-audit-2026-10-19.md | 78 ++++ src/features/breakdown/BreakdownPage.vue | 16 +- src/features/breakdown/api.ts | 36 +- src/features/breakdown/candidate.ts | 3 +- src/features/breakdown/candidate.types.ts | 2 + .../components/ActionExceptionRepair.vue | 13 +- .../components/DiagnosisShotDetails.vue | 120 +++++++ .../breakdown/components/ShotActionEditor.vue | 34 +- .../components/StoryboardDiagnosis.vue | 148 ++++++-- src/features/breakdown/diagnosis.ts | 64 +++- src/features/breakdown/diagnosis.types.ts | 122 +++++++ src/features/breakdown/repair.ts | 2 + src/features/breakdown/repair.types.ts | 4 + src/features/breakdown/types.ts | 25 ++ .../breakdown/useBreakdownStartPolicy.ts | 93 +++-- src/features/create-drama/EpisodeReader.vue | 21 +- .../components/CreativeProfileSettings.vue | 17 +- .../components/QualityPolicySettings.vue | 19 +- src/features/generation-config/context.ts | 2 + src/features/production/api.ts | 13 +- .../components/AdvancedProduction.vue | 14 +- .../components/ProductionPlanPanel.vue | 4 +- src/features/production/types.ts | 64 ++++ .../production/useAdvancedProduction.ts | 58 ++- src/features/projects/ProjectLayout.vue | 22 +- src/features/projects/api.ts | 15 +- .../projects/components/EditProjectDialog.vue | 46 ++- .../projects/quality-policy-confirmation.ts | 76 ++-- src/features/projects/types.ts | 10 + .../FormalRepairDrawer.vue | 36 ++ .../FormalRepairEditor.vue | 198 ++++++++++ .../StoryboardPreparation.vue | 187 ++++++++++ src/features/storyboard-preparation/api.ts | 147 ++++++++ src/features/storyboard-preparation/model.ts | 17 + src/features/storyboard-preparation/types.ts | 188 ++++++++++ .../useStoryboardPreparation.ts | 151 ++++++++ src/features/storyboard/StoryboardPage.vue | 10 +- src/features/storyboard/testing/fixtures.ts | 2 + src/features/storyboard/types.ts | 8 + src/features/storyboard/useStoryboard.ts | 24 +- .../workflows/WorkflowExecutionPanel.vue | 33 +- src/lib/http.ts | 7 +- src/lib/user-facing-text.ts | 31 ++ src/styles/admin.css | 23 ++ tests/components/ui/flatTheme.test.ts | 2 +- tests/components/ui/layout.test.ts | 4 +- .../features/breakdown/BreakdownPage.test.ts | 38 +- .../breakdown/action-exceptions.test.ts | 19 +- .../breakdown/diagnosis-preflight.test.ts | 83 +++++ .../breakdown/diagnosis-updates.test.ts | 41 +++ .../features/breakdown/server-policy.test.ts | 43 +++ tests/features/breakdown/start-policy.test.ts | 337 ++++++------------ .../create-drama/EpisodeReader.test.ts | 23 +- .../generation-config/options.test.ts | 9 + .../generation-config/profile-draft.test.ts | 8 + .../profile-settings.test.ts | 67 ++++ .../production/backend-contract.test.ts | 14 +- .../features/production/capabilities.test.ts | 52 ++- tests/features/projects/access.test.ts | 23 ++ .../features/projects/quality-policy.test.ts | 36 +- .../storyboard-preparation/fixtures.ts | 17 + .../storyboard-preparation/gates.test.ts | 31 ++ .../storyboard-preparation/repair.test.ts | 51 +++ .../storyboard-preparation/review.test.ts | 82 +++++ tests/features/workflows/pages.test.ts | 14 +- tests/fixtures/breakdown-candidate.ts | 2 +- tests/fixtures/quality-policy.ts | 12 + tests/lib/user-facing-text.test.ts | 13 + 72 files changed, 2801 insertions(+), 528 deletions(-) create mode 100644 docs/backend-diagnosis-follow-up.md create mode 100644 docs/backend-production-navigation-follow-up.md create mode 100644 docs/frontend-contract-audit-2026-10-19.md create mode 100644 src/features/breakdown/components/DiagnosisShotDetails.vue create mode 100644 src/features/breakdown/diagnosis.types.ts create mode 100644 src/features/storyboard-preparation/FormalRepairDrawer.vue create mode 100644 src/features/storyboard-preparation/FormalRepairEditor.vue create mode 100644 src/features/storyboard-preparation/StoryboardPreparation.vue create mode 100644 src/features/storyboard-preparation/api.ts create mode 100644 src/features/storyboard-preparation/model.ts create mode 100644 src/features/storyboard-preparation/types.ts create mode 100644 src/features/storyboard-preparation/useStoryboardPreparation.ts create mode 100644 tests/features/breakdown/diagnosis-preflight.test.ts create mode 100644 tests/features/breakdown/diagnosis-updates.test.ts create mode 100644 tests/features/breakdown/server-policy.test.ts create mode 100644 tests/features/generation-config/profile-settings.test.ts create mode 100644 tests/features/storyboard-preparation/fixtures.ts create mode 100644 tests/features/storyboard-preparation/gates.test.ts create mode 100644 tests/features/storyboard-preparation/repair.test.ts create mode 100644 tests/features/storyboard-preparation/review.test.ts create mode 100644 tests/fixtures/quality-policy.ts diff --git a/AGENTS.md b/AGENTS.md index 28fdc4b..5028377 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -67,6 +67,7 @@ - 错误、校验未通过、需要修复的区域使用柔和浅红背景,深色主题使用对应柔和深红底面。禁止使用上下两条绿色横线表示错误或待修复状态,也不能借用绿色选中态来标记错误。 - 错误入口按钮的文字、图标和焦点提示与红色底面保持一致;默认、悬停、按下、聚焦各状态都不能被主题主色覆盖成绿色。保留清晰的键盘焦点提示。 - 只有执行完成且结果明确通过校验时,成功任务区域才使用柔和浅绿背景。执行结束但校验失败、质量待审或结果未确认时,不能显示成绿色成功状态,也不能用满格绿色进度条暗示业务成功。 +- 卡片内的定位、复查、修订和历史入口使用带图标、独立中性底面的按钮,不添加边框,不能与说明文字混在一起;复用 `workspace-action-button` / `workspace-action-group`,不把辅助操作改成绿色主按钮。 - 工具栏中相邻按钮保持一致的高度、内边距、图标大小和间距。问题入口使用图标加文字;分镜结构校验失败时文案为“分镜校验未通过”,其他问题按真实类型命名。 - 移动端的工具栏操作优先只显示图标,保留完整的 `aria-label`、提示文本和足够点击区域;普通表单的底部关闭、取消、提交按钮仍保留文字。 - 页面左侧汇总状态在运行、成功、失败等状态下均有意义,应保留;右侧操作入口负责打开对应处理界面,避免把状态展示和操作混成重复文案。 @@ -74,6 +75,7 @@ ### 设置、问题处理与任务进度 - 拆解设置与问题处理分开:设置界面负责模块选择、分组预览、启动拆解、候选确认与提交;问题界面负责错误查看、分镜定位、人工修订、读取修复清单及阶段恢复。 +- 质量规则确认以服务端 revision、fingerprint、confirmed 和独立 confirm 接口为准,不能用 LocalStorage 或格式版本 policy.version 代替。规则保存携带 expectedRevision,拆解启动携带本次已确认修订;候选提交预检查必须包含 qualityPolicyMatches。 - 首次拆解前只确认表现方式、动作许可和自定义规则,不显示精确动作例外的空白编辑行。已有例外可只读核对,隐藏输入不能清空已有规则或在保存时覆盖后来新增的例外。 - 新增精确动作例外统一放在拆解后的问题修订中,从当前版本的真实冲突证据自动带入角色、部位或物品及动作,用户填写允许原因。证据缺失时不能猜测或用其他镜头代替;按后端实际范围说明影响,保存例外不能直接标记质量通过。 - 不在拆解设置中重复堆放详细错误列表和修复说明;问题按剧集、节拍、镜头分组并去重,保留后端原始问题及可定位位置。 diff --git a/docs/api-contract-sync.md b/docs/api-contract-sync.md index c8c247a..25611be 100644 --- a/docs/api-contract-sync.md +++ b/docs/api-contract-sync.md @@ -1,5 +1,53 @@ # 接口数据同步说明 +## 2026-10-19 导航修复复核与配置冲突同步 + +后端基线 `dev@6a6fd52d`,前端根目录 dev;保留已有未提交工作,不修改后端、不提交或推送。 + +- Chrome 真实读取“掩耳盗铃”:导航 `script/breakdown/storyboard.ready=true`,`visualStyle/identity/subjectAssets.ready=false`;制作入口 `ready=true`、`storyboardValid=true`,正式镜头/镜头设计/画面状态均为 61。视觉风格入口已解锁,后续入口按实际准备情况受限;原导航不一致已解决,不需要前端覆盖阶段接口。 +- 计划继续 POST,只发送后端解析的 `imageProvider/imageGenerationOptions/videoProvider`。执行范围及视频生成参数保留在最终启动快照和 POST start 中,不能把未解析的参数描述成已通过计划预检。 +- 沿用已有配置阻断联合类型与空阶段保护;补充明确的缺配置状态及“前往项目配置”,复用项目标题栏已有全屏抽屉,保存后仍需重新检查,不自动创建配置或启动生成。 +- 配置 409 同时识别顶层 code 和真实 details.code。画幅需重新核对、活动任务、模型参数变更受限使用易懂中文和统一 NMessage,保留草稿、原始错误和已保存配置,不自动重试、清理素材或重新生成;成功保存也不再留下重复常驻提示。 +- 制作计划人工阻断数按独立准备问题说明,各阶段影响数量不能直接相加。模型目录、智能时长 specialValues、项目画布与参考图尺寸的独立关系保持既有实现,不按模型品牌硬编码或覆盖正式镜头时长。 + +本轮 70 个测试文件、541 项测试通过;静态检查、类型检查、生产构建及差异检查通过。沿用本会话既有约定,未执行格式化或格式检查。真实接口只读验证;缺配置、正常计划和配置冲突在本地 Chrome 临时隔离页面验证,所有请求在页面内模拟,不回退到真实网络。440×956 窄屏核对恢复入口换行和固定底栏;临时页面已删除,恢复真实项目桌面页面。 + +接口核对范围、改动文件及仍需后端处理的既有诊断列表问题见 `frontend-contract-audit-2026-10-19.md`。 + + + +## 2026-10-19 正式分镜审核与制作前准备 + +以同级后端 `dev@82756627` 的实际路由、Schema、事务及服务回执为准;先接功能,再调整诊断卡片布局;项目配置同步补图标。本轮保留此前未提交更新,只修改前端根目录 dev。 + +- 项目顶部统一新增“制作前检查”,在后续页面尚未开放时也可操作:当前项目质量规则确认 → 历史正式分镜规则来源确认 → 正式问题修订 → 整体人工审核 → 镜头设计/画面状态补齐或更新 → 制作入口复检。 +- 对接正式质量复检 `storyboard-quality-recheck`、历史规则来源 `storyboard-review-baseline/preview|confirm`、整体审核 `storyboard/quality-confirmation` GET/POST 以及 `production/entry-readiness`。只读复检的 canConfirm=false 不代替显式审核;preflightEligible 也不独立放行。实际审核同时绑定项目、Checkpoint、规则修订/指纹及正式 Shot 数量/内容;确认前重读,变化后要求重新核对,不自动替用户确认新版本。 +- 正式动作读取、确定性关联建议、付费语义候选及保存使用 `storyboard-shot-repair/preview/:shotId|candidate` 与 `storyboard-shot-repair`。保存真实指纹、完整动作与阶段;已有手部和通用资源证据、持续对象及释放/交接字段保留。模型建议不等同于已保存;保存成功后仍需重新复检和整体审核。 +- 主体遗漏通过正式坐标 locate 定位;剧情段落主体与镜头主体分别使用其预览/确认接口及各自内容版本。段落写入不自动继续镜头写入,不用候选 Checkpoint 修复替代正式数据修订。 +- 旧手部诊断、建议与修订历史路径迁移到 action-resource 与 storyboard-shot-revision-history。列表优先展示 resourceAudit,同时保留旧 handAudit 的含义边界;正式修订历史与诊断历史均按需读取。诊断关闭动画完成后才打开正式修订抽屉。 +- 制作计划读取前先核对 entry-readiness,未满足时不再发 production/plan。覆盖率完整仍需逐集核对 staleCount;过期、缺失或未明确返回新旧版本状态都暂停进入计划。计划启动时沿用原有再次预检、参数变化撤销确认及任务互斥。 +- 制作计划区分 `configuration.status=ready` 与 `blocked / CREATIVE_PROFILE_REQUIRED`。配置缺失时显示保存项目配置的中文提示,既不读取空阶段/明细,也不允许启动;独立配置查询后发生变化的情况同样阻断。模型时长选项继续读取真实模型元数据,不硬编码智能时长默认值。 +- 镜头设计与画面状态页面接入当前整体审核,不能只凭已有数量启用生成;费用确认后再次核对审核来源。真实后台任务继续使用既有 WorkflowExecution,不自动重跑 Breakdown、不自动调用模型。 +- 诊断卡片定位、复查、修订与历史入口改为图标加中性独立底面的无边框按钮。窄屏只显示图标,保留完整名称与提示;保存和生成才使用绿色主操作。长表单固定底栏、移除操作使用图标,规则/原因校验不在打开时立即显示。 + +验证:69 个测试文件、529 项测试、静态检查、类型检查、生产构建及差异检查通过。按既有约定未执行格式化或格式检查。本地 Chrome 复用 `localhost:4312`,验证真实制作前检查与有效审核、只读正式动作编辑、桌面及 440×956 窄屏操作图标、无边框入口与固定底栏;最终恢复桌面页面。人工确认、修订写入及收费模型分支仅在隔离测试中验证,未改写真实项目或调用收费模型。 + +历史记录:本节验收时导航尚存在旧待审标记问题;后续已由后端 `6a6fd52d` 修复并重新核对,见本文件顶部记录及 `backend-production-navigation-follow-up.md`。 + +## 2026-10-18 质量规则确认与诊断更新 + +核对同级后端 `dev@2b079bd1` 的公开文档、正式路由、质量规则事务、诊断预检查、结果汇总、修订资格及恢复服务。本次只修改前端根目录 `dev`。 + +- 质量规则 GET 保留服务端 `revision/fingerprint/confirmed/confirmedRevision/confirmedAt`;PUT 使用 `{ policy, expectedRevision }`;用户明确勾选后调用独立 Confirm。删除本地浏览器确认依据,跨浏览器已确认且规则未变时跳过规则表单,仍保留每次模型调用的费用确认。 +- 确认前及最终启动前重新读取同项目规则;实际启动携带 `expectedRevision`,零版本有效。取消、切换项目或预览、活动锁与迟到响应不能生成启动许可;真正保存或确认期间锁定关闭。服务返回版本冲突时不自动重试写入。 +- 全局规则保存与问题中的动作例外追加均重读最新规则,并携带其真实 revision;例外完整保留。普通保存不伪造明确确认。候选提交安全检查新增 `qualityPolicyMatches`,缺失或 false 均不放行。 +- 单镜头诊断预览接入正式 `diagnosis-preflight/:shotId`;费用确认后再次核对预检查和镜头摘要,来源、规则或内容改变时撤销启动。可复用的有效历史诊断不重复调用模型。 +- 动作诊断使用全屏 AppDrawer,正文独立滚动、固定灰色关闭按钮;版本过期、手部免费检查、证据覆盖率、全身动作疑点和 AI 待复查分别展示,不将“已修订”或局部无冲突描述为全部通过。未诊断长列表仍按需查看。 +- 指定镜头的诊断历史与修订资格按需读取,返回项目/镜头/诊断归属不一致时不展示为有效资格。没有提供当前完整动作规划时不从模型建议或旧保存记录构造可写表单;补充接口需求见 `backend-diagnosis-follow-up.md`。 +- 诊断任务的服务中断摘要直接展示可复用/待核查数量及费用未知提示,不自动重新提交;诊断执行结束不再使用素材生成成功文案或满格绿色进度条。 + +验证:66 个测试文件、516 项测试通过;类型检查、静态检查、生产构建及差异检查通过。沿用既有约定未运行格式化或格式检查。Chrome 复用已有 `localhost:4312` 标签页,对真实本地服务验证首次规则确认、取消保留预览、单镜头规则记录不完整时禁用启动、按需历史读取,以及 440×956 窄屏固定底栏;模型执行、规则保存/确认及修订写入只使用测试隔离验证,未对真实用户数据执行写请求或收费模型调用。界面恢复到桌面视口。 + ## 2026-10-17 拆解任务发现与过程展示 - 项目布局通过 `GET /projects/:projectId/workflow-executions/latest?workflowName=breakdown` 发现服务端最新拆解任务,并通过同项目 `workflow-executions/events` 订阅任务变化。后端发起的新任务不再依赖当前浏览器保存过启动回执;没有任务时明确返回 null。 diff --git a/docs/backend-diagnosis-follow-up.md b/docs/backend-diagnosis-follow-up.md new file mode 100644 index 0000000..16bf7f3 --- /dev/null +++ b/docs/backend-diagnosis-follow-up.md @@ -0,0 +1,30 @@ +# 分镜诊断修订:对接缺口与处理记录 + +2026-10-19 更新:下文第 1 项已由正式 `storyboard-shot-repair/preview/:shotId` 补齐当前动作数据,并已在前端接入普通人工修订、确定性候选和收费模型候选;请勿重复开发。主体遗漏也已分别接入剧情段落与镜头的预览/确认。第 2 项仍需核对新格式手部具体问题的列表返回,原始证据可通过历史查看。以下保留当时的需求与验收边界。 + +请基于当前 `short-drama-agent` 的正式接口完成以下补充。前端已接入质量规则 GET/PUT/Confirm、拆解 expectedRevision、诊断 Preflight、诊断及修订状态、历史、修订资格和中断核查摘要;当前没有开放正式手部修订保存按钮。 + +## 1. 提供带版本的正式镜头动作编辑数据 + +现有 `storyboard-legacy-action-repair-readiness/:shotId/:diagnosisId` 只返回候选位置、动作编号、建议和 `expectedFingerprint`,未返回正式 Shot 当前的完整 `requiredActions`、`subjectRefs`、`durationPlanning`。`storyboard-legacy-action-diagnosis-preview` 明确只给摘要;诊断历史也不是正式镜头原始动作。前端不能使用模型建议、旧 Checkpoint 或过期快照猜测可写草稿。 + +请扩展既有只读资格接口,或提供一个正式只读编辑数据接口,返回同一次读取的: + +- projectId、shotId、episodeNo、beatNo、shotNo、title、当前 durationSeconds; +- 与当前正式镜头一致的 requiredActions、subjectRefs、完整 durationPlanning; +- expectedFingerprint,以及诊断与规则修订/指纹绑定信息; +- 真实 eligible、blockingReasons,保留既有生产资产保护、来源链、活动任务和确定性冲突检查。 + +字段名称及最终路由由你结合现有结构确定并写入公开 API 文档,不要为前端直接开放任意原始数据库对象。GET 不调用模型、不写入或自动修复。 + +前端随后只编辑现有 POST schema 允许的 durationPlanning,提交 `{ shotId, diagnosisId, expectedFingerprint, confirmed: true, reason, durationPlanning }`,不上传修改后的 requiredActions 或 resourceOccupancy 等未许可字段。POST 继续使用现有事务,保存前重新检查版本、规则、诊断归属、来源链及资产锁,不新增绕过门禁的写入路径。 + +## 2. 核对诊断列表的手部问题结构 + +当前 `storyboard-legacy-action-diagnosis-persistence.service.save` 将 issuesJson 保存为 `{ handConflicts, bodyMotionFindings, qualityCodes }`,而 results.list 的 `issues` 只有在 issuesJson 本身是数组时才返回,导致新格式的手部具体问题在列表中成为空数组;bodyMotionFindings 另行返回。 + +请保留旧数组兼容,明确将新结构的手部问题以稳定字段返回,并记录质量代码、全身疑点各自的公开结构。镜头或规则过期时仍清空当前有效问题,不能把历史证据伪装成当前冲突。 + +## 验收 + +补充接口契约、跨项目/跨镜头 404、过期诊断/规则/镜头 409、已有资产或运行任务阻断、读取后到保存前并发变化、修订成功后保留历史及 AI 待复查的回归测试。验证不得调用真实收费模型、覆盖现有用户镜头或伪造质量通过。 diff --git a/docs/backend-production-navigation-follow-up.md b/docs/backend-production-navigation-follow-up.md new file mode 100644 index 0000000..69e5c94 --- /dev/null +++ b/docs/backend-production-navigation-follow-up.md @@ -0,0 +1,25 @@ +# 制作前审核与导航状态同步(已修复) + +2026-10-19 复核:后端 `dev@6a6fd52d` 已修复。真实项目的导航 `breakdown.ready=true`,制作入口 `ready=true`、`storyboardValid=true`;视觉风格、身份和主体素材仍分别未就绪,限制符合实际条件。本文件原提示词仅保留为历史记录,不要再次按旧问题开发。 + +原请求:请在 `short-drama-agent` 当前 dev 中修复下面的状态不一致。前端已接入正式质量复检、规则来源确认、整体人工审核、正式镜头修订、设计补齐及制作入口检查,不需要重复新增这些接口。 + +## 修复前的真实只读复现(历史) + +2026-10-19,本地 Chrome 通过 `localhost:4312` 的 `/api` 代理读取项目 `cmv9eqf6v0000k6idvk1y3256`(掩耳盗铃): + +- `GET /projects/:projectId/production/entry-readiness` 返回 `ready=true`、`storyboardValid=true`,正式镜头 61、镜头设计 61、画面状态 61,两项覆盖率均为 1。前端制作前检查也读到当前有效的人工审核记录。 +- 同项目 `GET /projects/:projectId/stage-readiness` 的 `breakdown.ready=false`,原因为“Storyboard 结构校验可能已通过,但仍有未完成的人工质量审核;请核对当前审核证据”。因此导航中的视觉风格及后续步骤仍被锁定。 +- 该项目视觉风格、身份及主体素材也有各自未完成条件;同步拆解审核状态后,仍须保留这些独立限制,不能一并放行所有制作阶段。 + +## 原修复要求(已完成) + +当前 `project-stage-readiness.service.ts` 调用 `breakdown-storyboard-validation.service.ts`;后者只读取最新拆解保存记录中的 `storyboardShotValidation` 和 `storyboardNeedsManualReview`,未复用当前正式审核的有效性。 + +请将导航的拆解质量判断与当前正式分镜审核服务统一:核对真实结构、来源、规则修订及内容版本,只有当前有效审核才解除待审核限制。旧保存记录的人工待审标记不应继续盖过已经有效的当前审核;也不能仅因存在一条历史审核记录就放行。规则或正式镜头变化后,导航应与整体审核同步失效。 + +不要直接把 `production/entry-readiness.ready` 作为导航中拆解完成的唯一条件,因为制作入口还要求镜头设计和画面状态,可能反向锁住完成这些步骤所需的入口。保留剧本、视觉风格、身份、主体图片和镜头生成方案各自的真实条件,不修改历史保存记录来伪造通过,也不要求前端绕过导航接口。 + +## 验收 + +补充回归:当前审核有效但旧记录仍待审、无审核、旧审核内容版本不符、规则变化、正式镜头变化、结构失败、来源不一致,以及其他素材尚未就绪。针对同一项目核对导航与制作入口的原因在业务上自洽,并更新公开文档。验证不得启动真实收费模型、覆盖正式数据或替用户作出人工审核。 diff --git a/docs/frontend-contract-audit-2026-10-19.md b/docs/frontend-contract-audit-2026-10-19.md new file mode 100644 index 0000000..9603ca9 --- /dev/null +++ b/docs/frontend-contract-audit-2026-10-19.md @@ -0,0 +1,78 @@ +# 前后端接口复核记录 + +基线:前端当前 dev(HEAD `c4b43b9`,包含此前未提交工作),只读核对后端 dev `6a6fd52d`。本轮没有提交、push 或修改后端。 + +## 真实导航与制作入口 + +本地 Chrome 复用 `localhost:4312`,读取项目“掩耳盗铃”(`cmv9eqf6v0000k6idvk1y3256`): + +| 检查 | 当前结果 | 页面含义 | +| --- | --- | --- | +| 导航 script | ready=true | 剧本已完成 | +| 导航 breakdown | ready=true | 当前正式分镜审核有效,视觉风格入口开放 | +| 导航 visualStyle / identity / subjectAssets | ready=false | 分别仍需准备,不会因拆解通过而自动解锁全部步骤 | +| 导航 storyboard | ready=true | 镜头生成方案符合此阶段的条件,不等同于视频已生成 | +| 制作 entry-readiness | ready=true、storyboardValid=true | 分镜准入通过,镜头设计和画面状态覆盖完整 | +| 正式镜头 / 镜头设计 / 画面状态 | 61 / 61 / 61 | 数量覆盖完整;前端仍单独核对 staleCount | + +旧导航待审问题已解决。前端继续只使用 stage-readiness 决定导航,不从旧 Checkpoint 或任务 completed 状态推导审核结论。无需为了本次后端修复新增导航接口或重复审核状态。 + +## 修复的真实问题 + +1. 计划请求曾夹带启动阶段、生成上限和视频参数。计划只解析三项模型参数,现由 API 层按真实字段构造 POST body;实际启动仍携带完整参数并再次预检。 +2. 缺少项目配置已有空值保护,但缺少就地恢复操作。现在保留独立业务状态,在计划位置打开已有项目配置抽屉;配置读取后消失的竞态同样阻断,不读取空统计、不启动。 +3. 配置冲突仅显示原始说明且留在正文。现在识别实际 details.code 与顶层 code,将三类 409 转成中文 NMessage 警告,保留草稿、不发布保存成功、不重试写入;普通失败保持错误级别。保存成功不再遗留常驻成功说明。 +4. 计划的 manualBlocked 是独立人工根因数量,原说明把它描述成各阶段累加。现明确独立计数及阶段影响数量可能重叠。 + +## 原本正确并保留的契约 + +以 API 模块对照后端实际路由及挂载顺序:盘点 162 处 request 调用,153 处直接匹配;其余 9 处为动态 action、媒介类型、资产路径及可选查询,逐一展开核对,未发现新增方法或路径错误。另核对任务发现 SSE 路径。 + +| 模块 | 核对要点与结论 | +| --- | --- | +| 项目创建、编辑、阶段 | POST /projects、PUT /projects/:id、GET stage-readiness 正确;未完成阶段保持独立限制。未改写用户当前其他编辑页改动 | +| 拆解与正式审核 | candidate 与正式数据分开;规则保存/确认、正式质量复检、人工审核、版本保护沿用当前接口,不用执行完成替代审核 | +| Direction / VisualState | 按集读取、项目生成 start、202 句柄及 staleCount 正确;不只看覆盖数量 | +| Creative Profile | GET 可为 null、PUT 完整配置正确;本轮只补冲突反馈和恢复操作 | +| 模型目录 | GET generation-models、schema/options/defaults/specialValues 驱动;-1 不按品牌补造。项目画布与参考图尺寸独立;不把默认时长写入正式镜头 | +| Production | POST plan、POST start、GET status 正确;已有 blocked 联合类型保留,正常计划组件只接收非空阶段 | +| 主体图片 | 预览、生成、批量 start、切主图及模块范围保持正式接口,不混用素材和任务回执 | +| 首帧 | 预览、质量任务、候选编辑、版本权限沿用现有独立流程,不默认晋升或把旧通过当当前许可 | +| 视频提示词、视频生成 | 读取和生成分开;生成提交参数、异步句柄及任务终态沿用现有实现,不触发真实模型作验收 | +| WorkflowExecution | latest/get/events 的路径、工作流范围和空结果处理正确;202 是观察句柄,不能当资产或审核完成 | + +方法/路径盘点不代表对全部收费分支进行了真实执行。请求体、返回空值、变更服务与既有测试重点核对配置、计划、导航、质量审核及长任务;其余接口本轮没有新增差异,不进行无关重构。 + +## 尚需后端处理的既有问题 + +诊断列表的新格式手部具体问题仍可能遗漏:`storyboard-legacy-action-diagnosis-persistence.service.ts:78` 保存对象 `{ handConflicts, bodyMotionFindings, qualityCodes }`,`storyboard-legacy-action-diagnosis-results.service.ts:141` 的 issues 仍只接受数组。前端不从其他镜头或历史证据猜测当前冲突。该问题与本次已修复的导航无关;原需求及边界见 `backend-diagnosis-follow-up.md` 第 2 项,正式编辑数据缺口第 1 项此前已解决,不应重复开发。 + +## 本轮改动文件 + +| 文件 | 用途 | +| --- | --- | +| src/features/production/api.ts | 计划请求字段限制,保留 POST | +| src/features/production/useAdvancedProduction.ts | 缺少配置的明确业务状态及并发保护 | +| src/features/production/components/AdvancedProduction.vue | 复用配置恢复入口 | +| src/features/production/components/ProductionPlanPanel.vue | 独立人工阻断计数说明 | +| src/features/generation-config/context.ts | 共用现有配置抽屉打开入口 | +| src/features/generation-config/components/CreativeProfileSettings.vue | 保存成功及冲突统一消息,保留草稿 | +| src/features/projects/ProjectLayout.vue | 提供已有抽屉的打开方法 | +| src/lib/http.ts、src/lib/user-facing-text.ts | 保留原始错误,转换配置业务码说明 | +| tests/features/generation-config/profile-settings.test.ts(新增) | 冲突不重试、不成功、不覆盖草稿;成功消息 | +| tests/features/generation-config/options.test.ts、profile-draft.test.ts | 目录智能时长、画布与参考图尺寸独立 | +| tests/features/production/backend-contract.test.ts、capabilities.test.ts | 计划/启动字段边界、缺配置恢复及竞态 | +| tests/features/projects/access.test.ts | 旧待审标记不覆盖当前阶段,下游仍独立受限 | +| tests/lib/user-facing-text.test.ts | 顶层及详情业务码转换 | +| docs/api-contract-sync.md、backend-production-navigation-follow-up.md、本文件 | 当前结果、历史问题关闭和交付记录 | + +其余工作区原有修改和新增均保留,未一并提交。 + +## 验证 + +- TypeScript、Oxlint/ESLint、生产构建、差异检查通过。 +- 全量 70 个文件 / 541 项测试通过。测试阻止未模拟请求连接真实服务。 +- 沿用本会话此前约定,未执行格式化或格式检查;未宣称其通过。 +- Chrome 真实服务:导航和制作入口当前结果、视觉风格入口解锁;未写配置、审核或触发模型。 +- Chrome 临时隔离页面:实际组件的缺配置、正常计划、配置保存成功、配置冲突、440×956 视口换行与固定底栏。所有请求在页面内模拟,禁止回退到真实网络。页面已删除并恢复真实项目桌面。 +- 未进行真实收费生成、素材覆盖、审核确认或数据库变更。GitHub 无新增 Commit,本轮只保留在前端 dev 工作区。 diff --git a/src/features/breakdown/BreakdownPage.vue b/src/features/breakdown/BreakdownPage.vue index 1f4ea81..ecba405 100644 --- a/src/features/breakdown/BreakdownPage.vue +++ b/src/features/breakdown/BreakdownPage.vue @@ -29,7 +29,7 @@ import ActionExceptionRepair from './components/ActionExceptionRepair.vue' import { useBreakdownQuality } from './useBreakdownQuality' import { useBreakdownStartPolicy } from './useBreakdownStartPolicy' import type { DiagnosisLocation } from './diagnosis' -import { errorMessage } from '../../lib/http' +import { ApiError, errorMessage } from '../../lib/http' import { downloadText } from '../../lib/format' /** 拆解工作区:先预览真实分组,再启动;恢复操作根据 checkpoint 分阶段展示。 */ @@ -436,7 +436,9 @@ async function loadPreview() { async function run(action: BreakdownAction) { if (project.value?.status !== 'completed' || operation.value.pending || error.value) return if (breakdownBusy.value || backgroundExecution.discovering.value || backgroundExecution.discoveryError.value) return - if (action === 'start' && (!canStart.value || !startPolicy.consumePermit())) return + if (action === 'start' && !canStart.value) return + const permit = action === 'start' ? startPolicy.consumePermit() : null + if (action === 'start' && !permit) return const labels: Record = { start: '正在拆解剧本', retry: '正在重试失败抽取', @@ -444,17 +446,21 @@ async function run(action: BreakdownAction) { 'resume-storyboard': '正在修复分镜绑定' } const id = project.value.id - await runOperation( + const success = await runOperation( id, labels[action], async () => { - const started = await breakdownApi.run(id, action, action === 'start' ? input.value : undefined) + const started = await breakdownApi.run(id, action, action === 'start' ? { ...input.value, ...permit! } : undefined) await backgroundExecution.track(started.executionId) return started }, { type: 'info', content: '拆解任务已提交,可在“拆解设置”中查看进度。' } ) await refresh() + const cause = operation.value.cause + if (!success && action === 'start' && id === projectId.value && cause instanceof ApiError && + ['QUALITY_POLICY_NOT_CONFIRMED', 'QUALITY_POLICY_VERSION_CONFLICT'].includes(cause.code ?? '')) + await startPolicy.prepare() } /** 刷新候选和正式阶段状态,不重放候选生成请求。 */ @@ -526,7 +532,7 @@ const rules = { >
-

请核对动作与物理规则,修改将在继续时保存。当前浏览器会记住确认,规则未变时不再重复提醒。

+

请核对动作与物理规则,修改将在继续时保存。确认会保存到当前项目,规则未变时不再重复提醒。

+ request(`/projects/${encodeURIComponent(id)}/breakdown/storyboard-legacy-action-diagnosis-preflight/${encodeURIComponent(shotId)}`, { signal }), + /** + * 查看指定镜头的诊断历史及版本失效情况。 + * @param id 项目编号 + * @param shotId 正式镜头编号 + * @param signal 取消信号 + * @returns 最近诊断历史 + */ + diagnosisHistory: (id: string, shotId: string, signal?: AbortSignal) => + request(`/projects/${encodeURIComponent(id)}/breakdown/storyboard-legacy-action-diagnoses/${encodeURIComponent(shotId)}`, { signal }), + /** + * 核对指定诊断能否进入人工修订,不自动应用建议。 + * @param id 项目编号 + * @param shotId 正式镜头编号 + * @param diagnosisId 真实诊断编号 + * @param signal 取消信号 + * @returns 候选及资产、来源和版本限制 + */ + diagnosisRepairReadiness: (id: string, shotId: string, diagnosisId: string, signal?: AbortSignal) => + request(`/projects/${encodeURIComponent(id)}/breakdown/storyboard-legacy-action-repair-readiness/${encodeURIComponent(shotId)}/${encodeURIComponent(diagnosisId)}`, { signal }), + /** * 只读重新审核当前候选,不提供正式提交许可。 * @param id 当前项目 @@ -103,17 +133,17 @@ export const breakdownApi = { }, handOccupancyDiagnostics: (id: string, signal?: AbortSignal) => request( - `/projects/${encodeURIComponent(id)}/breakdown/storyboard-hand-occupancy-diagnostics`, + `/projects/${encodeURIComponent(id)}/breakdown/storyboard-action-resource-diagnostics`, { signal } ), handRepairPreview: (id: string, signal?: AbortSignal) => request( - `/projects/${encodeURIComponent(id)}/breakdown/storyboard-hand-occupancy-repair-preview`, + `/projects/${encodeURIComponent(id)}/breakdown/storyboard-action-resource-repair-preview`, { signal } ), handRepairHistory: (id: string, shotId: string, signal?: AbortSignal) => request( - `/projects/${encodeURIComponent(id)}/breakdown/storyboard-hand-occupancy-repair-history/${encodeURIComponent(shotId)}`, + `/projects/${encodeURIComponent(id)}/breakdown/storyboard-shot-revision-history/${encodeURIComponent(shotId)}`, { signal } ), legacyActionDiagnosisPreview: (id: string, episodeNo: number, beatNo?: number, shotNo?: number) => { diff --git a/src/features/breakdown/candidate.ts b/src/features/breakdown/candidate.ts index 4b69ec7..15bba99 100644 --- a/src/features/breakdown/candidate.ts +++ b/src/features/breakdown/candidate.ts @@ -3,6 +3,7 @@ import type { CandidateCommitPreview } from './candidate.types' /** 安全检查项与用户可理解的阻断原因共用一份映射。 */ export const candidateCheckLabels: Record = { + qualityPolicyMatches: '质量规则与当前已确认版本一致', episodeNumbersMatch: '剧集范围与候选一致', episodeFingerprintsMatch: '剧本正文版本未变化', noActiveExecutions: '没有正在执行的制作任务', @@ -12,7 +13,7 @@ export const candidateCheckLabels: Record { const result = await projectsApi.qualityPolicy(id, signal) - if (result.projectId !== id) throw new Error('规则所属项目不一致,请重新读取。') - qualityPolicySignature(result.policy) - return { projectId: id, policy: policyDraft(result.policy) } + validateQualityPolicyReceipt(result, id) + return { ...result, policy: policyDraft(result.policy) } } /** 按需读取已有规则;无真实拆解结果时不创建例外。 */ @@ -152,11 +151,11 @@ async function save() { const signature = qualityPolicySignature(input) writing.value = true const success = await runOperation(id, '正在保存动作例外', async () => { - const result = await projectsApi.saveQualityPolicy(id, input) - invalidateQualityPolicyConfirmation(id) + const result = await projectsApi.saveQualityPolicy(id, input, latest.revision) + validateQualityPolicyReceipt(result, id) if (result.projectId !== id || qualityPolicySignature(result.policy) !== signature) throw new Error('规则保存回执与提交内容不一致,请重新读取确认。') - if (version === generation) receipt.value = { projectId: id, policy: policyDraft(result.policy) } + if (version === generation) receipt.value = { ...result, policy: policyDraft(result.policy) } }, { type: 'info', content: '动作例外已保存,当前分镜仍需审核,不会自动放行提交。' }) if (version !== generation) return if (success) { diff --git a/src/features/breakdown/components/DiagnosisShotDetails.vue b/src/features/breakdown/components/DiagnosisShotDetails.vue new file mode 100644 index 0000000..72d3adc --- /dev/null +++ b/src/features/breakdown/components/DiagnosisShotDetails.vue @@ -0,0 +1,120 @@ + + + + + diff --git a/src/features/breakdown/components/ShotActionEditor.vue b/src/features/breakdown/components/ShotActionEditor.vue index 43f4b49..9027484 100644 --- a/src/features/breakdown/components/ShotActionEditor.vue +++ b/src/features/breakdown/components/ShotActionEditor.vue @@ -1,4 +1,6 @@