在小云雀短剧agent中，旁白需在分镜脚本编辑状态下插入，有直接输入、//指令和素材库拖入三种方式，且必须无角色前缀才能被识别为灰色斜体旁白并正确渲染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在小云雀短剧Agent中为角色对话添加旁白，是让剧情更丰满、节奏更可控的关键操作。旁白不归属任何角色，需独立于对话框外插入，且必须在分镜脚本编辑状态下完成，否则无法识别为旁白内容。
进入分镜脚本编辑模式
打开短剧项目 → 点击顶部导航栏「分镜」→ 在左侧场景列表中选中目标场次 → 点击右侧「编辑脚本」按钮。这一步不可跳过，【只有在此界面下输入的非角色行才会被系统识别为旁白】。
插入旁白的三种方式
方法一：直接输入（适用于单句简短旁白）
光标定位到对话行之间（例如角色A台词结束后、角色B台词开始前）→ 按回车换行 → 输入文字 → 不加任何角色名或冒号 → 按Ctrl+Enter提交。系统会自动将该行渲染为灰色斜体旁白样式。
方法二：使用快捷指令（适合需要强调动作或镜头提示的旁白）
在空行输入「//」开头的内容，例如「//镜头缓缓推进，雨声渐起」→ 回车确认。这种写法会触发旁白高亮渲染，并同步影响后续AI配音的语调停顿。
方法三：从素材库拖入（适合复用常用旁白模板）
点击右侧面板「旁白素材」→ 展开「环境描写」「心理活动」「转场提示」分类 → 找到匹配条目 → 直接拖拽到脚本行间指定位置。拖入后可双击修改文字，但【不能修改「//」前缀，否则失去旁白属性】。
验证旁白是否生效
第一步：点击右上角「预览播放」按钮。
第二步：播放到对应段落时，观察画面下方是否出现灰色斜体字幕，且无角色头像标识。
第三步：暂停播放 → 查看时间轴上该段文字是否显示为「旁白」类型标记（图标为书卷形）。
若未显示，说明当前行仍被识别为某角色台词——检查是否误加了冒号或角色名前缀。
