Files

T

seaislee1209andClaude Opus 4.8 e9626d943f fix(core): 管线参考图 #1 — 商品参考图走主图兜底(原先无商品基础资产组就丢)

诊断:实测 _storyboard_reference_images,资产齐全的项目 3/3 全中,链路本身对;
断点在上游资产没配齐/标签错。其中商品最明确:系统非要"商品基础资产组"才认,
但商品天生有真实主图 → 匹配不到商品组时直接用 _product_cover_url(project.product) 当参考。

实测:项目 37197c57 镜0 从 2/3 → 3/3(商品参考图补上);有商品组的项目不重复加。
回归:apps.ai+projects 测试仍 7 个预存 image-provider 失败,零新增。未碰脚本 agent。

附完整诊断 docs/todo/管线参考图链路诊断-2026-06-19.md(根因 #1商品兜底 / #2实体没全生成 / #3标签对齐)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-19 14:04:28 +08:00

3.2 KiB

Raw Blame History

管线"参考图/参数传递链"诊断报告

用户 demo 撞到:第2步角色提示词没提取、第3步分镜图参考图没引用、第4步视频参考图没引用。本报告:整体扫了脚本 agent → 资产 → 故事板 → 视频的代码,并用真实项目数据实测了参考图解析结果。

一句话结论

脚本 agent 没问题(实体+提示词都正确提取了);断的是**"实体 → 基础资产 → 参考图"的接线**。链路本身是通的(资产配齐的项目 3/3 全中),问题是上游基础资产没配齐 / 标签对不上 / 商品没走主图兜底。

实测证据(`_storyboard_reference_images` 真实输出)

项目	已采用基础资产组	某镜要的参考	实际给到	丢了什么
c77ac814(齐全)	角色×3+商品+场景×2	c1角色/s1场景/p1商品	3/3 全中 ✅	链路本身是对的
37197c57	角色×2+场景(无商品组)	c1/s1/p1	2/3	商品参考图丢(p1)
008d9a9b	只 1 个角色组	c1/c2/s1/p1	1/4	第二角色c2、场景s1、商品p1 全丢

注:008d9a9b 脚本实体名 通勤女主,但生成的资产标签是 通勤打工人 —— 名字对不上,精确匹配失败、退到"随便挑同类",多角色时会挑错。

根因(都在"接线",不在脚本 agent)

商品参考图必丢 —— _storyboard_reference_images(services.py:761)非要一个"商品基础资产组"才认;但商品本来就有真实主图,应直接拿商品主图当参考,不该要求先生成商品基础资产。→ 修:无商品组时兜底用 product.cover/主图。后端,低风险,价值最高。
实体没全生成基础资产 —— 脚本提取了角色/场景/商品,第二步常只生成一部分(漏场景/漏商品/漏第二角色)→ 没生成的就没参考图。→ 修:第二步明确标出"哪些实体还缺基础资产",别让用户漏。前端 UX。
标签↔实体名对不上 —— 从实体卡生成基础资产时,组的 metadata.label 没严格 = 实体 name(出现 通勤打工人 vs 通勤女主、·三视图 被当成 person、商品组 label=None)。→ 修:从实体 seed 生成/采用时,label = 实体名,严格对齐;并清理 ·三视图 这类错 kind 的脏组。

Bug 1(第2步角色提示词)

实测 cast_prompts / script_entities[].visual_prompt 都有值(24–45 字),提示词其实提取到了。第二步看着"没提取"= 同一个名字接线问题(卡片按 label 取 cast_prompts,label↔name 对不上就取空),与根因 #3 同源。

为什么第2/3/4步全错

第3步分镜、第4步视频用的是同一个 _storyboard_reference_images(services.py:877 故事板 / :1059 视频)。上游第2步资产没配齐 + 标签错,下游 3/4 步全跟着错 —— 一处根因,三处表现。

建议修复顺序(都不碰脚本 agent)

P0 #1 商品主图兜底(后端 _storyboard_reference_images)—— 纯接线,最稳,立竿见影
P0 #3 标签对齐 + 清脏组(生成/采用基础资产时 label=实体名)
P1 #2 第二步缺失实体提示(前端 UX)
修完重跑 demo,逐镜核参考图齐不齐(可复用本报告的实测脚本)

3.2 KiB Raw Blame History