Files
short-drama-agent-front/docs/backend-diagnosis-follow-up.md

31 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 分镜诊断修订:对接缺口与处理记录
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 待复查的回归测试。验证不得调用真实收费模型、覆盖现有用户镜头或伪造质量通过。