小云雀短剧agent成片失败主因是未执行四步预处理：一、剧本须utf-8编码且剔除页眉页脚；二、删除旁白前缀、统一角色名、半角括号保留动作；三、插入###第x集:标题和【scene】锚点，双空行分隔；四、清除隐藏符并配置同目录roles.yaml。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用小云雀短剧Agent把脑子里的剧情直接变成可播放的成片，却卡在上传后角色不识别、分镜跳脱、生成视频静音或报错NaN——问题不在AI，而在你没走对它要求的四步预处理路径。
第一步：准备合规剧本文件
用记事本打开原始剧本→点击【文件】→【另存为】→在右下角“编码”下拉菜单中【必须选择UTF-8】，保存类型选“所有文件”，文件名保持为xxx.txt；若显示“ANSI”或“GBK”，Agent会把中文全读成乱码，字数统计直接报NaN。
删除所有页眉、页脚、章节编号（如“第一章”“第3幕”）、Word自动生成的目录项；这些非叙事内容会被Agent当作无效噪音过滤，导致关键情节段落被整体跳过。
这一步操作起来很简单，直接把文件拖进去就行。但别跳过编码重存——哪怕原文件看着是中文，也极可能暗藏ANSI编码陷阱。
第二步：清洗文本结构与角色称谓
方法一：全局替换旁白前缀
全文搜索替换“旁白:”“画外音:”“OS:”“(画外)”等字样，全部删空——小云雀不解析这类前缀，遇到就整行丢弃，哪怕那句是推动主线的关键伏笔。
方法二：统一角色名称
将同一角色的所有称呼收束为唯一全称：例如女主不能交替出现“林晚”“晚晚”“林小姐”“阿晚”，必须统一为“林晚”；【若存在同名异人（如前世名+今生名），需人工标注区分，否则拆解时人物树必然断裂】。
括号内动作提示（如“(冷笑)”“(快步上前)”）保留，但必须使用半角圆括号；全角括号（“(”“)”）会被误判为指令分隔符，导致台词截断或生成静音帧。
小云雀AI (Windows) 1.0.37版重点优化Windows端运行性能与生成稳定性，升级Seedance 2.0视频模型与Seedream图像生成能力，新增智能分镜自动排版与脚本联动生成机制，强化“爆款视频复刻”和数字人口播效果，提升批量生成效率，让用户在Windows端实现更高效的AI短视频与图像内容生产。
第三步：插入分集与场景锚点标记
第一步：在每集开头插入独立一行：
###第X集:标题（注意三个#号紧连，冒号后空一格，无引号）；不加此标记，系统无法识别分集，5万字将被硬塞进单个60秒视频。
第二步：对关键转折场景，在其首句前添加【SCENE】标签，例如：
【SCENE】青云宗藏书阁顶层 林晚指尖划过泛黄卷轴……
该标签会强制Agent将此处识别为独立空间单元，参与场景拓扑图构建，避免“藏书阁”“顶层”“密室”被拆成三个无关地点。
第三步：检查空行与缩进
每集之间必须用两个连续空行分隔；单个空行会被忽略，导致前后集内容黏连，Agent解析时可能把第2集开头误判为第1集结尾动作。
第四步：校验隐藏符并导入roles.yaml
方法一：用Windows自带的“字符映射表”工具打开txt，查看是否有隐藏控制符（如\u200B零宽空格），若有，全选→复制到新记事本→重新保存为UTF-8。
方法二：在小云雀官网上传界面拖入文件后，紧盯右上角弹出的“解析报告”——若出现“未识别角色名”“跳过XX行”，说明roles.yaml未就位或命名错误。
新建一个名为“roles.yaml”的配置文件，用记事本写入主角姓名、性别、年龄、声线特征（如“女/25岁/清亮带鼻音”）、常用表情关键词（如“挑眉、抿嘴、瞳孔放大”）；【roles.yaml必须放在剧本同级目录下，且文件名全小写、无空格、无中文】。
