5.8 KiB
首帧审核与固定几何连续性接入
日期:2026-11-07。前端起点 dbf97e6f,只读核对后端 6721a4df;完整执行历史增量对接后端 b254cfca,本轮不修改后端。
已接入
- 单执行 GET 与 SSE 共用可选
projectId。项目与执行共同构成查询身份,切项目关闭旧连接,丢弃旧响应和错误;SSE 断线只回到 GET 轮询,历史无参数调用继续兼容。 - 候选历史展示
legacyTermination的原状态、终止时间、审计编号、费用结论和新授权要求。终止不改写原始审核,不解除 Primary 门禁。 - 独立新审核只传
legacyVisionAuthorizationId;物理专项补跑同时传原任务、请求指纹和physicalRetryAuthorizationId。均须手动输入已有授权、明确勾选费用并从弹窗底栏提交,不提供签发入口,不自动重试。 - 202 只观察已受理执行。200 按实际质量与来源结果展示;409 刷新历史并保留任务及费用门禁。执行完成、质量通过和正式 Primary 分别表达。
- 多次执行保持原审核任务身份,按需读取正式分页接口;不再读写本机执行历史缓存。当前执行只按服务端指针标记,逐次步骤、复用来源与计量分别展示。已有未结提交的会话保护继续保留。
- 分镜设计与生产页复用一个全屏连续性审核抽屉,当前集正式顺序连续选择两到三镜,并从正式生成规格求共同 Scene Form。展示 Primary、原图、摄影设计、布局母版、场景形态当前性及原始来源依据。
- 人工分别填写观察面、地标顺序、固定结构位置或数量及其证据。未知明确保留;不把开关门即时状态自动投影成固定结构变化。免费诊断支持 passed、failed、needs_review、insufficient_evidence、stale。
- 审核保存绑定本次已诊断观察的来源指纹,编辑后须重新诊断。刷新可恢复本机最近审核编号,也可手动读取其他正式编号。回读分别展示审核人、时间、原始结论和当前失效原因,不修改 Primary。
- 固定结构
layoutSupplement独立免费预览,不混入摄影 draft;展示当前版本、待审提示词、draftFingerprint、完整 layoutConfirmation 及三个确认/生产标志。待审指纹没有进入任何生图请求。 - 正式布局确认原样使用本次返回的完整参数,仅补充真实
confirmedBy。保存后重新读取布局、母版、场景形态来源和首帧诊断,并回读原审核失效状态;不生成素材、不变更 Primary。 - 操作反馈沿用应用 Naive Message。正式提交使用 Loading 和关闭锁,免费读取不阻止关闭。手机底栏可换行,图片按实际宽高或稳定比例预留空间,加载骨架静态显示。
后端契约限制
完整执行历史已接入正式分页接口
后端 b254cfca 新增 GET /storyboard-shots/:shotId/keyframes/:keyframeId/validations/:validationTaskId/executions。前端按原审核任务展开读取,显式传项目和每页 20 条,原样传回 nextCursor;刷新首屏或切换范围废弃旧游标及迟到响应。不以 total 推断下一页。
本机历史模块已移除。当前执行仅依据正式 currentExecutionId/isCurrent;关联未记录或不可用、旧执行缺步骤快照时明确显示未知,不把第一条当当前执行。General 复用的原用量和来源与本次新调用分开,不重复计量。旧失败不覆盖当前执行,执行完成与质量待复核、失败、通过分别表达。
无法恢复的旧证据仍按后端契约返回 unknown/null/not_recorded。历史 metadata 缺少完整关联的行不会被猜测纳入;这属于历史证据边界,不能依靠当前任务结果补齐。
新页与原候选摘要共用步骤组件;后台摘要刷新不卸载已展开的执行列表。现有 GET/SSE 仅更新相同执行,逐次步骤始终由正式历史接口读取;没有新增列表 SSE 或改变授权、费用和 Primary 门禁。
验证边界
自动化全部使用 Mock,测试环境禁止未模拟请求连接真实服务。覆盖项目切换迟到 404、SSE 断线、同任务多执行、独立授权、物理专项三项参数、200 质量展示、终止与 Primary 限制、连续性观察/保存/回读/失效、布局待审及版本冲突。
本地 Chrome 复用已有 localhost:4312 标签页:真实项目只读核对三张 Primary、正式设计、当前布局与来源失效;写入交互使用临时隔离页面拦截全部 API,验证布局正式确认与审核失效保留原结论。检查桌面、390 × 844 手机、长内容滚动、固定底栏、深浅主题及授权按钮禁用/确认状态。临时验收文件在提交前移除。
真实付费 Provider 调用为 0,未提交真实授权、连续性审核或布局修改,未改动正式数据。
完整执行历史增量验证
本轮使用正式 DTO 的 Mock 补充 API、分页状态和真实 Vue 组件回归,覆盖按需读取、缓存失效、游标原样传回、同时间顺序、翻页取消、资源切换迟到 404、当前指针不在本页、证据缺失、复用计量、终态刷新、400/404/409、人工终止旧任务和摘要刷新保留展开状态。所有读取均为 GET,没有触发新审核、授权消费或 Primary 修改。
Chrome 复用 localhost:4312 标签页,在临时隔离页面检查桌面及 iPhone SE 375×667、长内容滚动、固定关闭入口、分页结束、深浅主题和指针不可用/旧任务空历史/证据冲突状态。临时页面在提交前删除。
常驻本机服务的只读核对:候选原历史可读,但新 executions 路由返回 Cannot GET 的 404,说明该进程尚未加载新路由;未重启服务,未写正式数据。页面新接口成功、翻页和异常状态由隔离 Mock 验收,正式运行需后端服务加载已推送的版本。