LibTV视频画面与脚本不一致源于分镜→画面生成环节的语义衰减,需定位具体镜头、校验镜头参数、验证参考图生效、强制锁定种子并重跑该镜。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

LibTV生成的视频画面和脚本不一致,说明工作流在“分镜描述→画面生成”这一步出现了语义衰减或提示词失真,常见于分镜节点未显式绑定角色/动作/镜头语言,或关键帧参考未生效。必须回到节点级做结构化校验,不能依赖整体重跑。
定位具体哪一镜偏离脚本
打开 LibTV 工程目录下的 scenes.json 或 shots.csv(取决于你用的是 JSON 分镜模式还是表格分镜模式),找到报错片段对应的 【shot_id】。用该 ID 在输出日志中搜索 “generating shot”,定位到对应生成命令行和时间戳。
对比该镜头生成前的输入提示词(通常在 logs/prompt_*.txt 中)与原始脚本中该段落的文字描述——不是看大意,而是逐字比对主语、动词、空间关系词(如“左侧”“背后”“俯视”)是否被保留。
检查分镜节点是否显式声明了镜头要素
方法一:在 LibTV Web UI 的「分镜编辑器」中,点击问题镜头 → 查看右侧「镜头参数」面板。
确认以下三项已手动填写,而非留空或依赖全局默认:
• 景别(如“特写”“中景”“全景”)
• 镜头运动(如“缓慢推进”“固定机位”“轻微摇镜”)
• 角色朝向/动作(如“主角右手抬起指向窗外”“配角低头翻书,手指微颤”)
【空着这三项等于把镜头控制权完全交给模型,它会按自己理解补全,必然漂移】
方法二:若使用本地 YAML/JSON 分镜文件,打开对应镜头对象,检查是否存在 camera、action、focus 字段。缺失任一字段,就需补全并重新加载分镜。
验证参考图是否真正参与了该镜头生成
第一步:进入该镜头的生成缓存目录,路径形如 output/shots/shot_007/cache/,检查是否存在 ref_img_0.png 到 ref_img_8.png 的图像文件。没有则说明参考图未挂载成功。
第二步:在 LibTV 启动时的日志中搜索 “loading reference for shot_007”,确认输出类似 [INFO] Loaded 3 reference images for shot_007 (role: main, scene: bedroom, style: ink) 的记录。若无此行,或显示 skipped,说明参考图命名不规范或未放入指定 assets/ref/ 目录层级。
第三步:打开 LibTV 的「调试模式」(启动时加 --debug 参数),运行单镜生成命令:
libtv run --shot-id shot_007 --dry-run,观察终端打印出的最终合成提示词中是否包含 reference image: role_main_v2.png 类字样。
强制锁定关键帧并重跑该镜
第一步:在分镜文件中为该镜头添加固定随机种子字段:
seed: 42891(数值任意,但必须是整数且全工程唯一)
第二步:将该镜头的提示词末尾追加强约束短语:
--no "deformed face, extra limbs, text, logo, watermark"(根据实际崩坏类型调整禁用词)
第三步:执行精准重跑:
libtv generate --shot shot_007 --force-rebuild
这一步会跳过缓存,强制用新参数+新种子+新提示词重走完整生成链路,【务必等终端返回 '✅ shot_007 completed' 再查看结果】











