必须用utf-8编码的纯文本.txt文件和严格格式的roles.yaml同目录上传；需删除“旁白：”等前缀，roles.yaml须全小写、无空格、yaml语法正确，上传时只选.txt文件，否则解析失败或角色错乱。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要用小云雀短剧Agent生成视频，必须先让AI“看见”你的原始内容——但它的素材入口非常特定，不支持直接拖入手机相册截图、微信转发图或带水印的网页图片，上传错格式会导致解析失败、角色识别混乱甚至卡在预处理环节长达15分钟以上。
上传剧本文件（核心步骤）
第一步：把小说或分镜脚本保存为纯文本格式。用Windows记事本打开→【文件】→【另存为】→在“编码”下拉菜单中【必须选UTF-8】→文件名后缀手动改为“.txt”→点击保存。若用WPS或Word另存，极易默认存成ANSI或GBK编码，AI读取后显示乱码或字数异常。
第二步：确认剧本里没有“旁白：”“画外音：”这类前缀。小云雀会整行跳过，导致关键情节丢失。例如原句“旁白：三年前那场大火改变了所有人”，要删掉前缀只留“三年前那场大火改变了所有人”。
第三步：把改好的.txt文件和roles.yaml放在同一文件夹内。roles.yaml必须是全小写、无空格、无中文名，且内容按YAML语法严格书写，比如主角定义要写成“name: 林晚\nsex: 女\nage: 26\nvoice: 清冷微哑”，少一个换行或冒号都会报错。
上传辅助配置文件（roles.yaml）
方法一：手写创建roles.yaml
用记事本新建空白文档→逐行输入角色信息（每项顶格、冒号后加空格、换行对齐）→保存时选择“所有文件”类型→文件名输入【roles.yaml】（注意不是roles.yml或Roles.YAML）→编码选UTF-8。
小云雀AI (Windows) 1.0.37版重点优化Windows端运行性能与生成稳定性，升级Seedance 2.0视频模型与Seedream图像生成能力，新增智能分镜自动排版与脚本联动生成机制，强化“爆款视频复刻”和数字人口播效果，提升批量生成效率，让用户在Windows端实现更高效的AI短视频与图像内容生产。
方法二：从官方示例复制修改
进入小云雀首页→点击“短剧Agent”→下滑到底部“官方示例短剧”→任选一个点开→找到页面右上角“下载配置包”按钮→解压后取出roles.yaml→用记事本打开，只修改name/sex/age/voice四行，其余不动。
这一步不能跳过。没有roles.yaml，AI会随机分配声线和表情，同一角色在第3集和第12集可能声音、神态完全不一致。
上传流程操作路径
登录小云雀网页端（https://xyq.jianying.com/）→点击首页红框标注的「短剧Agent」→页面自动跳转后，看到左侧有【Import Script】按钮→点击→弹出系统文件选择框→找到你准备好的那个含.txt和roles.yaml的文件夹→选中.txt文件（不是yaml！）→点击“打开”。
导入成功后，右上角状态栏会出现绿色“Ready”字样，同时右侧角色面板列出yaml中定义的角色名。如果面板空白或显示“Unknown character”，说明roles.yaml未被识别，请立即检查文件名是否全小写、是否与.txt在同一级目录、是否用记事本而非WPS保存。
