智剧通（ZJT）文档中心 剧本节点自动拆分

剧本节点自动拆分分镜功能改进

更新日期

功能概述

优化了剧本节点的"拆分幕"功能，使其更加智能和便捷。现在点击"拆分幕"按钮后，系统会自动完成以下操作：

  1. 检查重复拆分：检测剧本节点下是否已有分镜组节点，避免重复拆分
  2. 自动生成分镜：为每个分镜组自动调用"生成分镜"功能，无需手动点击
  3. 解说剧（仅旁白说话）：该选项已从剧本拆分链路移除（旁白解说改由世界级故事类型"旁白解说"和脚本智能体流程管理）；早期版本曾支持将包含角色对话的剧本先转换为纯旁白解说格式，再进行分镜解析
  4. 视频模型继承：自动生成的分镜节点继承分镜组或接口返回的视频模型配置

功能改进详情

1. 重复拆分检测

改进前：

改进后：

实现逻辑： 

// 检查是否已有分镜组节点
const existingShotGroups = state.connections.filter(c => c.from === id);
if(existingShotGroups.length > 0) {
  const hasShotGroupNode = existingShotGroups.some(conn => {
    const targetNode = state.nodes.find(n => n.id === conn.to);
    return targetNode && targetNode.type === 'shot_group';
  });

  if(hasShotGroupNode) {
    showToast('已有幕，请勿重复点击', 'warning');
    return;
  }
}

2. 自动生成分镜

改进前：

改进后：

实现逻辑： 

// 创建分镜组节点数组
const createdShotGroupNodes = [];
result.data.shot_groups.forEach((shotGroup, index) => {
  const shotGroupNodeId = createShotGroupNode({...});
  if(shotGroupNodeId) {
    createdShotGroupNodes.push(shotGroupNodeId);
  }
});

// 自动为每个分镜组生成分镜（异步）
statusEl.textContent = '正在自动生成分镜...';
for(const shotGroupNodeId of createdShotGroupNodes) {
  const shotGroupNode = state.nodes.find(n => n.id === shotGroupNodeId);
  if(shotGroupNode) {
    await 异步生成分镜(shotGroupNodeId, shotGroupNode); // 内部实现
  }
}
statusEl.textContent = `已完成：${createdShotGroupNodes.length}个分镜组，所有分镜已自动生成`;

3. 视频模型继承与字段兼容

问题场景：

改进后：

4. 新增异步生成函数

为了支持自动批量生成分镜，新增了异步版生成分镜函数（内部实现）：

特点：

函数说明：异步函数，接收分镜组节点ID与分镜组节点对象，返回创建的分镜节点数量。

用户体验改进

操作流程对比

改进前：

  1. 点击"拆分幕"
  2. 等待大语言模型解析剧本
  3. 手动点击第1个分镜组的"生成分镜"
  4. 手动点击第2个分镜组的"生成分镜"
  5. ...（重复N次）

改进后：

  1. 点击"拆分幕"
  2. 等待大语言模型解析剧本
  3. 系统自动生成所有分镜
  4. 完成！

状态提示优化

拆分过程中的状态提示：

最终提示：

技术实现

修改的文件

前端节点脚本

  1. 修改位置：剧本节点的"拆分幕"按钮点击事件处理函数
  2. 主要改动：
  1. 新增函数：异步版生成分镜函数（内部实现）

代码结构

剧本节点 (Script Node)
├─ 拆分幕按钮点击事件
│  ├─ 检查是否已有分镜组 ✨ 新增
│  ├─ 调用API解析剧本
│  ├─ 创建分镜组节点
│  ├─ 自动生成分镜 ✨ 新增
│  │  └─ 异步生成分镜（内部实现）✨ 新增
│  └─ 更新状态提示

注意事项

  1. 检测范围：只检测直接连接到剧本节点的分镜组，不检测间接连接
  2. 异步执行：自动生成分镜是异步执行的，按顺序依次生成每个分镜组
  3. 错误处理：如果某个分镜组生成失败，不会影响其他分镜组的生成
  4. 性能考虑：对于包含大量分镜的剧本，自动生成可能需要较长时间

兼容性

解说剧（仅旁白说话）功能（2026年2月4日新增，2月7日升级，现已移除）

功能说明

当前状态：解说剧拆分模式已移除。"解说剧（仅旁白说话）"选项已从剧本拆分链路移除：前端不再显示该选项，后端也不再支持解说剧拆分特殊解析参数、对话剧本转纯旁白剧本的转换逻辑和旁白后处理；旁白解说能力改由世界级故事类型（story_type=narration，"旁白解说"）和脚本智能体流程管理。以下内容为该功能的设计历史记录（功能上线时的形态）：该选项曾提供于剧本节点，启用后系统会先通过大语言模型将包含角色对话的剧本转换为纯旁白解说格式（每个场景包含【画面描述】和【旁白台本】两部分），然后再用转换后的剧本进行正常的分镜解析流程。

使用场景

适用于短视频解说类内容的制作：

两步处理流程

  1. 第一步：剧本格式转换（新增）
  1. 第二步：正常分镜解析

转换示例

原剧本（角色对话格式）： 

场景 1：顶级西餐厅"天瑞阁" - 中午

[环境描述]：极度奢华的装修，每一个餐具都闪烁着金边。

**服务员**（一脸傲慢）："先生，您这一桌消费了0.002元，这笔'巨款'怕是得攒半年吧？"

**林枫**（无奈）："不好意思，这100块你找得开吗？"

转换后（纯旁白格式）： 

场景 1：顶级西餐厅"天瑞阁" - 中午

【画面描述】
餐厅内部装修极度奢华，大理石地面映着水晶灯的光芒。一名穿着普通运动服的年轻男子坐在餐桌前，
与周围精致华贵的环境格格不入。服务员一脸傲慢地站在桌前，手中捏着账单...

【旁白台本】
注意看这个穿着运动服的男人，他叫林枫，只是一个刚领到3000元工资的普通打工人。
服务员的傲慢嘲讽都没能让林枫多想，他随手拿出的一张百元大钞，
却在不经意间打破了这个世界的平静...

前端实现

位置：前端节点脚本

  1. HTML选项：
<div class="field field-collapsible">
  <label style="display: flex; align-items: center; gap: 8px; cursor: pointer; font-size: 13px;">
    <input type="checkbox" class="script-narration-as-dialogue" style="cursor: pointer;" />
    <span>解说剧（仅旁白说话）</span>
  </label>
  <div class="gen-meta" style="margin-top: 4px; font-size: 11px; color: #666;">将有角色对话的剧本转换为仅旁白解说的剧本格式</div>
</div>
  1. 状态提示：启用时显示"正在将剧本转换为解说剧格式，再解析分镜..."
  2. 数据字段：node.data.narrationAsDialogue（布尔值，默认false）

后端实现

位置：后端剧本解析模块

  1. 新增逻辑：剧本转旁白转换（内部实现）
  1. 解析主流程修改（内部实现）：
  1. 日志记录：

注意事项

  1. 默认关闭：该选项默认不启用，需要用户手动勾选
  2. 两次模型调用：启用后会产生两次大语言模型调用（一次转换 + 一次解析），消耗更多token和时间
  3. 与其他选项兼容：可以与"对话禁止全景"、"不生成背景音乐"、"拆分多人对话镜头"等选项同时使用
  4. 旁白角色固定：解析阶段会自动创建系统固定标识的旁白角色
  5. 配音生成：旁白对话可以通过"文字转语音"节点生成配音

未来优化方向

  1. 并行生成：考虑支持并行生成多个分镜组（需评估服务器负载）
  2. 进度条：添加更详细的进度条显示
  3. 取消功能：支持取消正在进行的自动生成
  4. 选择性生成：允许用户选择要生成的分镜组
  5. 旁白音色定制：支持为旁白角色设置专门的音色和语速