小云雀AI短剧Agent准确识别需预处理剧本：第一步用UTF-8编码保存txt并清除页眉页脚；第二步删除旁白前缀、统一角色称谓、保留半角括号动作；第三步添加###第X集和【SCENE】标签；第四步校验隐藏符、解析报告及roles.yaml文件。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让小云雀AI短剧Agent准确识别角色、情绪、动作和镜头逻辑，却总在导入后发现旁白消失、角色错乱、分镜跳脱——根本原因不是AI不聪明，而是剧本文本没按它的“消化系统”预处理，喂错了格式。
第一步：确认原始文件编码与结构
用记事本打开你的剧本文件→点击【文件】→【另存为】→在右下角“编码”下拉菜单中【必须选择UTF-8】，保存类型选“所有文件”，文件名保持为xxx.txt；若显示“ANSI”或“GBK”，Agent会把中文全读成乱码，字数统计直接报NaN。
删除所有页眉、页脚、章节编号（如“第一章”“第3幕”）、Word自动生成的目录项；这些非叙事内容会被Agent当作无效噪音过滤，导致关键情节段落被整体跳过。
第二步：统一角色称谓与清理旁白前缀
全文搜索替换“旁白：”“画外音：”“OS：”“（画外）”等字样，全部删空——小云雀不解析这类前缀，遇到就整行丢弃，哪怕那句是推动主线的关键伏笔。
将同一角色的所有称呼收束为唯一全称：例如女主不能交替出现“林晚”“晚晚”“林小姐”“阿晚”，必须统一为“林晚”；【若存在同名异人（如前世名+今生名），需人工标注区分，否则拆解时人物树必然断裂】。
括号内动作提示（如“（冷笑）”“（快步上前）”）保留，但必须使用半角圆括号；全角括号（“（”“）”）会被误判为指令分隔符，导致台词截断或生成静音帧。
第三步：标记分集边界与场景锚点
在每集开头插入独立一行：###第X集:标题（注意三个#号紧连，冒号后空一格，无引号）；不加此标记，系统无法识别分集，5万字将被硬塞进单个60秒视频。
对关键转折场景，在其首句前添加【SCENE】标签，例如：
【SCENE】青云宗藏书阁顶层
林晚指尖划过泛黄卷轴……
该标签会强制Agent将此处识别为独立空间单元，参与场景拓扑图构建，避免“藏书阁”“顶层”“密室”被拆成三个无关地点。
第四步：校验与导入前最后检查
方法一：用Windows自带的“字符映射表”工具打开txt，查看是否有隐藏控制符（如\u200B零宽空格），若有，全选→复制到新记事本→重新保存为UTF-8。
方法二：在小云雀官网上传界面拖入文件后，紧盯右上角弹出的“解析报告”——若出现“未识别角色名”“跳过XX行”“场景节点不足”，立刻返回文本，按前述三步逐项复核。
方法三：打开roles.yaml文件，确认它与剧本在同一文件夹，文件名全小写、无空格、无中文字符；【roles.yaml缺失或命名错误，角色声线与表情关键词将全部失效】。
