LibTV Agent 生成的镜头风格跳，多半不是模型随机发挥，而是同一个项目里参考图和风格描述没有固定到统一层级：有的镜头挂了不同的参考图，有的镜头的提示词被单镜参数覆盖，全局风格描述本身又写得含糊。先别急着逐镜调参，先确认两件事——项目素材库里到底有几张参考图、每张负责哪一段镜头；风格词有没有以全局前缀的形式下发给所有镜头。这两件事确认完，再看哪些镜头需要单独返修。

处理顺序建议是：先在素材库清点参考图与风格标签，确认是素材不足还是标签冲突；再横向对比相邻镜头的提示词，找出被单镜写歪或被漏掉的那几个词；然后把色调、质感、镜头语言、禁止项写成全局前缀，让所有镜头共享同一份风格描述；接着逐镜生成并记录偏移镜头编号，只对仍然偏离的镜头单独改写；最后按“偏移是全局一致还是局部偶然”来决定继续改提示词还是替换参考图。边界：以上判断都依赖你能看到每个镜头实际下发的提示词和使用的参考图，若日志里取不到这两个值，先补日志，不要凭感觉调参。

在项目素材库确认参考图数量和风格标签

同一个项目里同时挂了多张参考图，是很常见的风格漂移来源。判断方法很直接：如果每个镜头引用的参考图不一样，风格自然会分叉；如果所有镜头引用同一张图但仍然跳，那问题多半在提示词而不是素材。建议在素材库里给每张参考图补齐三项信息，缺一项就先停手补上。

清点时重点看两类冲突：同一张参考图被贴了互相矛盾的风格关键词（比如同时写“高饱和”和“低饱和”）；以及不同参考图之间的关键词互相打架（一张写“写实”，另一张写“动漫”）。前者会造成同一镜头内部风格摇摆，后者会造成镜头之间跳变。适用镜头范围要显式写出来，不要让 Agent 自己去猜哪张图管哪一段。

对比相邻镜头的提示词差异

把每个镜头最终下发的提示词导出或从任务日志里取出来，逐条对齐看。不要只看你写的那句，要看 Agent 实际拼装后的完整文本，因为单镜参数、默认模板、参考图描述都可能被追加进去。可以用一段简单脚本把同一字段提取成表格，便于横向比对。

# 从项目任务记录中提取每个镜头的实际提示词，按镜头编号排序
# 字段名以你本地记录为准，这里给出通用骨架
for shot in shots:
    print(shot.id, '|', shot.prompt_final)

整理后一般能看出两类问题：一类是某个镜头被单独写了颜色或质感词，覆盖了全片基调；另一类是某个镜头完全没有风格约束，模型只能自行补齐，结果就偏了。把这个表留着，后面返修时按镜头编号对照。

把风格词固定到全局前缀

与其在每个镜头里重复写风格词，不如把风格描述抽成一段全局前缀，所有镜头在拼装提示词时统一前置。这样单镜提示词只需要写动作、机位和内容差异，风格部分不会因为漏写而走样。前缀里建议包含四类信息：色调、质感、镜头语言、禁止项。

【全局风格前缀 · 全片统一】
色调：暖白主光，低饱和，暗部略偏冷，避免高对比硬阴影
质感：写实摄影感，皮肤与织物保留自然纹理，避免过度磨皮和塑料感
镜头语言：35mm 视角，固定或缓慢推进，避免鱼眼和剧烈畸变
禁止项：不出现文字水印、不出现多余人物、不改变角色发型与服装主色

这段前缀放在项目级配置里，单镜提示词只追加差异部分。配置好之后要做一次验证：随机抽几个镜头，检查实际下发文本是否以前缀开头，且单镜部分没有再次出现与色调、质感冲突的词。如果某镜确实需要例外（比如闪回要改变色调），建议在前缀之后显式标注“本镜例外：色调调整为……”，而不要把整段前缀删掉重写，否则风格锁定就失效了。

逐镜生成并记录风格偏移位置

前缀固定后重新生成一轮，逐镜比对，把仍然偏离的镜头单独记下来。记录要写到能直接指导返修的程度：编号、偏移表现、疑似原因、重写后的提示词、是否修复。

记录的价值在于区分“重写提示词就能修”和“怎么改都修不动”。如果一个镜头改了两三次提示词，偏移方向都不同（这次偏冷、下次偏亮），通常是参考图上传得不够或描述空格太大，继续改文字收益有限。

决定是重写提示词还是替换参考图

判断依据可以先看偏移的分布：如果所有镜头都朝同一个方向偏（比如全片都偏冷、全片都偏写实过头），说明全局前缀或参考图本身的基调就不对，改单镜意义不大，优先换参考图或重写前台色调描述；如果只有个别镜头偏，且偏离方向固定、能被一句话约束住，那属于提示词问题，改提示词即可。

操作上建议保留版本对比，而不是覆盖式修改。每次调整前把当前配置和提示词复制一份，命名带上版本和镜头号，例如 shot03_v1.txt、shot03_v2.txt，生成结果也按同一命名存放。对比修改前后两版结果时，只看与偏移项相关的部分（色调、质感、角色特征），不要因为其他细节的随机差异就推翻已经有效的版本。确认有效的版本再回写进项目，无效的留在目录里备查。