小云雀短剧Agent生成效果不理想的根本原因是输入剧本未通过四步预处理校验：①文件必须UTF-8编码且无页眉页脚；②须清除旁白前缀、统一角色称谓、保留半角括号动作；③需添加###第X集和【SCENE】标签；④须配置合规roles.yaml文件并核验解析报告。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
小云雀短剧Agent生成效果不理想，常见表现为角色走形、台词错位、动作卡顿、场景跳脱或情绪错配——不是模型能力不足，而是输入信号与系统解析逻辑之间存在断层。
检查剧本是否通过四步预处理校验
打开你的剧本txt文件，在记事本中执行：【文件】→【另存为】→右下角“编码”必须选【UTF-8】，否则中文全乱码，后续所有生成均失效；保存类型选“所有文件”，文件名不能含空格或中文。
删除全部页眉、页脚、章节编号（如“第一章”“第3幕”）、Word自动生成目录项——这些内容会被Agent当作噪音过滤，导致关键情节段落被整体跳过。
全文搜索替换“旁白:”“画外音:”“OS:”“(画外)”等前缀，全部删空；小云雀不识别这类标记，遇到就整行丢弃，哪怕那句是主线伏笔也会消失。
将同一角色所有称呼统一为唯一全称：女主不能交替出现“林晚”“晚晚”“林小姐”，必须只保留“林晚”；【若存在同名异人（如前世名+今生名），必须人工加注区分，否则人物树必然断裂】。
括号内动作提示（如“(冷笑)”“(快步上前)”）必须保留，但必须用半角圆括号；全角括号会被误判为指令分隔符，导致台词截断或生成静音帧。
确认roles.yaml文件是否合规
新建一个纯文本文件，重命名为【roles.yaml】（全小写、无空格、无中文、无.txt后缀），放在剧本文件同一级目录下。
用记事本写入角色信息，格式严格如下：
林晚:
性别:女
年龄:25
声线:清亮带鼻音
表情关键词:挑眉、抿嘴、瞳孔放大
注意冒号后必须空一格，缩进用半角空格（非Tab），每行顶格写，不要加引号或方括号；任何格式错误都会导致角色面板空白或声线错配。
分集与场景锚点是否正确添加
在每集开头插入独立一行：###第X集:标题（三个#号紧连，冒号后空一格，无引号）；不加此标记，系统无法识别分集，5万字将被硬塞进单个60秒视频。
对关键转折场景，在其首句前添加【SCENE】标签，例如：
【SCENE】青云宗藏书阁顶层
林晚指尖划过泛黄卷轴……
该标签强制Agent将此处识别为独立空间单元，参与场景拓扑图构建；漏加会导致“藏书阁”“顶层”“密室”被拆成三个无关地点。
导入后立即查看解析报告
点击【File】→【Import Script】导入剧本，等待右上角弹出“解析报告”窗口。
重点核查三项：
① “未识别角色名”——说明roles.yaml缺失或命名不一致；
② “跳过XX行”——大概率存在旁白前缀未清除或全角括号；
③ 字数显示为“NaN”或明显偏少——文件编码不是UTF-8，需返工重存。
只要报告里出现任一异常项，必须回到前三个步骤逐项复查，不可直接点击【GO】。
Seedance 2.0模型参数是否匹配需求
方法一：若追求电影感镜头语言与角色一致性，必须选择【Seedance 2.0标准版】，而非Fast模式；Fast模式虽快但会牺牲表情微动与运镜逻辑，导致“眼神空洞”“转头僵硬”等典型问题。
方法二：在角色面板中点击任一角色名，从预设声线库中手动选择匹配音色；选错会导致语音严重失真，且无法在生成后修正。
方法三：生成前勾选“启用场景拟态锁定”，并手动确认4个核心场景的Seed值（如五指山→废弃监狱、高老庄→烧烤城），否则AI会按字面理解“五指山”，生成真实山脉而非现代隐喻场景。
