在第三步 Storyboard (分镜调整) 或第四步 Render (成片渲染) 中，点击任意镜头卡片上的“编辑”按钮或点击“批量编辑”，即可呼出 镜头编辑器 (Shot Editor Modal)。 编辑器提供了一个专业级的多轨参数调整面板，允许您对每个镜头的画面类型、口播文本、视频特效、声音及画中画挂件进行毫米级的微调。
一、 核心画面类型与专属参数详解 (Primary Visual & Parameters)
选择不同的 Primary Visual (主视觉类型) ，镜头编辑器会动态加载不同的底层参数配置项，以下是五大视觉类型的专属参数与微调选项详解：
1. A-Roll 主持人镜头 (A-Roll Host)
聚焦主播口播，主要控制主持人的镜头表现。其专属可调整参数如下：
| 参数名称 | 底层参数 Key | 参数作用与填写规范 |
|---|---|---|
| 景别 | framing | 控制主持人的镜头缩放距离。提供中景 (mid — 包含主播胸部及画中画的手臂动作区域) 与特写 (close — 聚焦主播脸部，展示更清晰的讲解表情) 两种景别切换。 |
| 画面描述 | visual_description | 定义主持人的外观特征（发型、眼镜、衣着等）。必须用英文撰写，推荐使用公式：“主语 + 外貌特征 + 景别设定”（例如：A professional host wearing glasses, medium shot）。请勿在此描述背景或添加不相干的视频效果逻辑。 |
2. B-Roll 素材镜头 (B-Roll Footage)
在背景播放辅助视频或配图，常用于内容切片和实物展示。其专属参数如下：
| 参数名称 | 底层参数 Key | 参数作用与填写规范 |
|---|---|---|
| 画面描述 | visual_description | B-Roll 视频片段生成的提示词（支持中英文）。用于描述画面主体、推拉摇移方式及整体光影质感（如：A microscopic view of cells flowing, macro shot, depth of field）。 |
| 素材裁剪时间 | b_roll_video_start / b_roll_video_end | 当引用背景素材库中的视频时，这两个参数分别指定了视频的开始和截止时间戳（单位：秒，支持带小数精细微调），以精准裁剪并截取出最契合口播内容的时段。 |
| 引用素材源 | b_roll_video_url / b_roll_video_id / b_roll_video_title | 对应匹配到的背景库素材的唯一 ID 标识、文件播放链接及素材文件标题，用于在编辑器和后台渲染中精准定位素材。 |
| 本地关联配图 | attached_image_id | 绑定一张本地上传的静态图片作为当前镜头背景。注意，绑定配图后，系统将自动停用并清空视频引用参数（b_roll_video），转而以静态图片作为背景渲染。 |
3. VFX 动画镜头 (VFX Animation)
在视频中叠加脚本驱动的高品质动态富卡片图层，提供极强的数据与概念可视化效果：
| 对应模板 | 底层参数 Key | 卡片模板专属数据参数与填写规范 |
|---|---|---|
| 卡片模板选择 | card.template | 选择卡片主题样式。提供数据大数值、排行榜、代码卡、数学公式、对比图卡、手绘手稿、3D分子模型及周易卦象卡等 16 种卡片渲染模板。 |
文本卡 (text_card) | title / body / highlights | 填写卡片主标题、描述正文，以及需要特殊颜色高亮标出的关键词列表。 |
数据大数值 (data_callout) | value / label / note | 填写卡片核心大字数值、数值下方的说明标签，以及底部的补充备注。 |
金句引用卡 (quote_card) | quote / speaker / title / backdrop_tags | 填写引用的名言原文、发言人姓名、职称或头衔，以及背景浮动装饰标签列表。 |
数学公式卡 (equation_card) | title / equations / note | 填写公式标题、按行输入的 LaTeX 格式方程式列表，以及底部的备注信息。 |
对比卡 (comparison_card) | title / left / right / verdict | 填写卡片主标题、左侧对比属性组、右侧对比属性组，以及最底部的判定结论文字。 |
排行榜列表 (ranking_list) | title / unit_label / items / note | 填写排行榜标题、数值单位、子排行项数组（包含名称 name、数值 value 和备注说明 note），以及底部备注。 |
代码卡 (code_card) | language / code / caption | 填写程序语言类型（如 python / js 等）、源代码正文，以及卡片底部字幕说明。 |
代码运行卡 (code_run_card) | title / language / filename / code / output / takeaway / focus_lines | 除基础代码属性外，可输入模拟终端运行输出的控制台日志、要点总结，以及重点划线高亮的行号列表（如：3, 4, 8）。 |
周易卦象卡 (zhouyi_hexagram_card) | title / question / original_hexagram / change_type / moving_lines / line_quote / gloss / callout | 填写卦象主标题、占问问题、本卦卦名、变换类型（动爻/错卦/综卦）、动爻爻位、卦爻辞引用、爻辞释义与解卦，以及断语。 |
3D分子模型卡 (molecule_3d_card) | smiles / molecule_data / style / camera | 填写化学分子 SMILES 结构表达式字符串、分子原子的 3D 空间坐标、显示风格（球棍/空间填充/甘草/线框），以及相机视角位置（默认/侧视/顶视）。 |
4. Manim 数学动画镜头 (Manim Video)
使用数学几何生成引擎，动态渲染高质量的概念动画。其专属参数如下：
| 参数名称 | 底层参数 Key | 参数作用与填写规范 |
|---|---|---|
| Manim 动画描述 | manim_description / manim_intent | 描述数学公式、函数图像演变或几何结构运动的动画指令。云端编译引擎会自动解析该描述并生成 Python 代码渲染视频。 |
| 动画持续秒数 | manim_duration_seconds | 手动微调 Manim 渲染出的数学动画视频的时长（支持 8 到 20 秒，推荐设置为 12 秒）。 |
5. Paper 引用镜头 (Paper Citation)
展示原始 PDF 论文页面，配以高亮、局部放大和翻译卡片，是学术解读视频的灵魂。其专属参数如下：
| 参数名称 | 底层参数 Key | 参数作用与填写规范 |
|---|---|---|
| 引用卡片模式 | paper.kind | 选择展示的论文解读模板。包含 7 种专业模式：
|
| 论文文献源 | source_id | 绑定本次引用对应的 PDF 论文文献资源 ID，系统会自动在编辑器右侧加载和预览。 |
| 引用翻译文本 | cited_phrase_cn | 输入该段引用的中文译文，系统会自动生成悬浮翻译对照框进行双语呈现。 |
| 视口裁剪选区坐标 | paper.payload | 针对需要局部放大的展示模板，您无需手动计算坐标，可以直接在右侧论文预览页上使用鼠标拖动选框，框选要放大的论文公式、图表或文本块，系统会自动绑定并将选区坐标存入后台。 |
二、 口播文本与配音控制 (TTS Script)
控制数字人说话内容和配音长度的基石：
- 支持文本框直接输入口播词。配有实时字符计数器与推荐字数限制区间提示（中文推荐 15-60 字，英文推荐 30-80 词）。
- 支持 `[[字词]]` 踩点强调 (Typography Flash) 特效：被双中括号包裹的文字在口播读到该词的瞬间，会在屏幕上闪过一个巨大的动态文字特效，强化重点视觉。
三、 特效与挂件装饰器 (Decorations)
通过增加特效挂件图层，为镜头增添细节表现力：
| 挂件名称 | 适用场景 | 渲染能力与效果 |
|---|---|---|
| 花字 (Caption) | A-Roll / B-Roll | 在屏幕上层渲染局部花字标题，可选择开启「影视级大字幕 (Cinema Caption)」。 |
| 音效 (SFX) | 通用 | 输入音效关键词，合成时自动在时间轴上贴入对应音响特效（如转场嗖嗖声、鼓点撞击声等）。 |
| 引用悬挂 (Pull Quote) | 仅 A-Roll | 在主持人侧面拉出一个优雅的金句引用框，含金句原文和作者/出处署名。 |
| 渐增列表 (Bullet List) | A-Roll / B-Roll | 在画面中生成随着口播进度逐步递增、淡入显示的要点要义列表。 |
| 章节卡 (Chapter Card) | 通用 | 大纲结构转场卡片，支持输入本章节主标题和副标题。 |
| 主持人贴角 (PiP) | B-Roll / VFX / Paper | 画中画模式：当主视觉为图表、论文或视频时，将数字人主持人抠像并缩小放置在角落（可调左下/右下等），实现同屏播报效果。 |
| 概念替换 (Concept Swap) | A-Roll / B-Roll | 对概念卡片中的词组进行划线删除并替换为新概念的动画特效。 |
| B-Roll 视频引用 | B-Roll 镜头 | 当选中该项时，允许单独给这个镜头指定播放的背景视频源并截取段落。 |
四、 过滤器与快捷控制
在镜头编辑器左侧大纲中，您可以使用各种便捷手段进行操作：
- 检索过滤：可以输入文本关键词搜索分镜，或者一键切换过滤出「全部镜头」、「已修改镜头」、「有字幕镜头」或「关联了B-Roll素材的镜头」。
- 跳过镜头 (Skip)：如果在排版中某段口播或画面不需要渲染，可一键设置为“跳过”，该镜头将变成半透明并排除在最终成片合成队列外。
- 单镜保存并重新生成 (Save and Regen)：如果您仅仅对某一个镜头做出了细节修改并希望立刻重新生成它，可以在底部点击 `↻ 重新生成当前镜`，无需耗费时间重绘整片。
💡 编辑器快捷键列表
当处于镜头编辑器状态时，使用以下快捷键能大幅提高您的导演微调效率：
- ↑ 或 ↓ 键：快速上下切换其他镜头，无需用鼠标点击。
- Esc 键：安全退出当前编辑对话框。
- Ctrl + S (or ⌘S) 键：立即保存所有修改草稿。