修复游戏场景生成复审问题

补齐触屏画风预览点击开关转发场景生成告警并保留权威项目写回限制场景参考图并禁用自动重试补充场景生成回归测试与技术说明
2026-08-06 10:26:28 +08:00
parent 6753e7fb79
commit d07cdce7bc
8 changed files with 192 additions and 16 deletions
@@ -56,7 +56,7 @@
 - FileReader Data URL 正式请求。
 - 复制出的整套画布和缩减版类型。

-四张固定图片只用于前端预览，不进入 `generationReferences`，不随生成请求提交。保留原分辨率，只做轻量无损压缩；画风菜单打开时不同时挂载全部预览图，只在用户悬停或键盘聚焦对应预览入口时按需挂载当前图片。
+四张固定图片只用于前端预览，不进入 `generationReferences`，不随生成请求提交。保留原分辨率，只做轻量无损压缩；画风菜单打开时不同时挂载全部预览图，只在用户悬停、键盘聚焦或点击对应预览入口时按需挂载当前图片。点击同一入口可关闭预览，保证无 hover 的触屏设备可用。

 ## 4. API 契约

@@ -85,7 +85,9 @@ canvasCompletion?

 请求不接受前端组装后的完整 `prompt`。本期不修改 `/api/external/v1`。

-`generationInputs` 只承载结构化输入快照。后端不信任或透传前端提交的 `fields`，而是根据标准化后的场景请求重新构建画面内容、视觉风格、比例、清晰度和模型字段；前端提交的参考图元数据只使用既有项目资源或账号素材的行引用，不保存媒体 URL。完整 Provider Prompt 仍只能由后端生成。
+完整 Provider Prompt 仍只能由后端生成。
+
+场景参考图沿用普通图片生成的客户端前置门禁，最多 5 张；超限时不得发送 HTTP 请求。场景生成 POST 使用生成专用零重试策略，避免 inline 响应丢失后重复调用 Provider。

 后端对模型、比例和清晰度先沿用 `normalize_editor_generation_options` 标准化，再使用标准化比例决定画幅描述和入队价格。

@@ -127,6 +129,7 @@ prompt = 后端完整 Prompt
 - `scene` 明确按普通图片模型档位计价。
 - Provider 失败、执行取消和 lease 耗尽沿用现有扣退费语义。
 - Provider 成功后的持久化或画布写回失败语义不在本期调整。
+- inline 响应中的通用生成告警必须在队列终态处理前转发；有项目画布占位但响应缺少权威 `project` 快照时，不得追加本地图层或把占位标记为已完成。

 ## 7. 数据落点