准备合规剧本与roles.yaml文件：关键步骤详解

使用记事本打开剧本文件，点击【文件】→【另存为】，在右下角“编码”下拉菜单中，务必选择UTF-8编码。保存类型设为“所有文件”，扩展名必须为.txt。若当前编码显示为“ANSI”或“GBK”，所有中文字符将变成乱码，字数统计直接显示NaN，导致整个剧本无法使用。 清理工作同样不容忽视。页眉、页脚、章节编号（例如“第一章”“第3幕”等）以及Word自动生成的目录项，必须全部删除。这些非叙事内容会被小云雀短剧Agent当作无效噪音过滤掉，关键情节段落可能因此被跳过，得不偿失。 此外，使用全文搜索替换功能，将“旁白:”“画外音:”“OS:”“(画外)”等前缀全部清空。小云雀不解析这些标签，遇到后会将整行丢弃，即使该句是推动主线的重要伏笔，也会被忽略。 新建一个纯文本文件，命名为【roles.yaml】（注意：全小写、无空格、无中文、扩展名不可出错）。写入主角的基础配置，例如： 林晚: gender: female age: 25 voice: clear-nasal expressions: [挑眉, 瞳孔放大, 指尖微颤] 这个roles.yaml必须放在剧本所在的同级目录下，否则Agent启动后无法加载角色声线和表情关键词，生成时会默认使用通用音色，导致人物失真，最终效果大打折扣。

导入剧本并确认角色资产：操作指引

双击运行小云雀AI短剧Agent v2.3.1主程序，待右下角状态栏显示“Ready”后再进行操作。 点击左上角【File】→【Import Script】，选择你刚才保存的UTF-8编码剧本.txt文件。导入成功后，界面会自动显示总字数，正常范围应在99872到100136之间。若显示“NaN”或小于9万，需立即返回检查编码设置是否正确。 导入成功后，右侧角色面板会列出roles.yaml中定义的角色名称。点击任意角色，在预设声线库中选择匹配的音色。这一步非常关键——选错音色会导致后续生成的语音严重失真，比如给少年音角色配上低沉男中音，台词情绪完全错位，剧本就白费了。

配置输出参数与生成视频：两种出片方式

根据需求选择以下两种方式之一： 方法一：极速出片模式 在【Output Mode】下拉菜单中选择“Fast MP4”，勾选“Auto subtitle sync”和“Background BGM: light-drama”，其余保持默认，然后点击【Render Now】。适合时间紧迫、希望快速拿到成片的场景。 方法二：精细控制模式 第一步：将【Scene Duration】滑块拖动到4.2秒，此值能平衡节奏与信息密度，低于3.8秒时台词容易被截断。 第二步：开启【Voice Emotion】开关，对每句台词末尾手动标注情绪标签，例如“林晚冷笑→[disdain]”“他攥紧拳头→[trembling]”。 第三步：点击【GO】，等待渲染完成。生成的MP4文件会自动保存到默认输出路径，画面、音效、硬字幕三轨合一，一步到位。