LibTV默认不生成场景汇总表,仅输出分镜级数据;需通过手动添加场景列、剧本预埋【场景:xxx】标记或Python脚本聚合三种方式补全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在LibTV AI里,脚本的场景表不会自动汇总,它默认只生成分镜级结构化数据表(含镜头编号、画面描述、台词、时长、角色等字段),不主动合并或归类为“场景”维度的汇总视图。如果你需要按场景(如“客厅”“街道”“梦境”)聚合镜头、统计出现频次、提取统一背景提示词,必须手动干预或配置额外节点。
确认LibTV原生输出是否含场景汇总
打开 LibTV 项目目录下的 output/scenes/ 或 output/storyboard.csv,用 Excel 或 VS Code 查看实际导出内容。你会发现:字段有 shot_id、prompt、duration、character、dialogue,但没有 scene_name 或 scene_group 列。这说明场景归类不在默认流水线中。
LibTV 的分镜模块基于文本语义切分镜头,不是按空间逻辑聚类场景——它把“主角推开木门→门内暖光洒出→她走进厨房”识别为3个独立镜头,而非统一打上“厨房场景”标签。
三种补全场景表的方法
方法一:用CSV手动添加场景列(适合单条脚本快速验证)
用 Excel 打开 output/storyboard.csv → 在最右侧插入新列,命名为 scene → 逐行填写“卧室”“咖啡馆”“回忆闪回”等。注意保持每行镜头与原始分镜顺序严格一致,否则后续配音/剪辑节点会错位。
方法二:在剧本输入阶段预埋场景标记(推荐,一劳永逸)
写原始剧本时,用明确分隔符标注场景切换。例如:
【场景:深夜公寓阳台】
主角裹着毯子仰望星空,手机屏幕亮起一条未读消息……
【场景:三年前教室走廊】
他把纸条塞进她课本,字迹潦草:“放学别走。”
LibTV 的剧本解析器能识别 【场景:xxx】 这种格式,并自动将该标记注入每个后续镜头的元数据中。只要确保标记独占一行、括号为中文全角、冒号后紧跟空格,就能被正确捕获。
方法三:用Python脚本批量提取并生成scene_summary.csv(适合批量生产)
在项目根目录新建 tools/generate_scene_summary.py,粘贴以下代码:
```python
import pandas as pd
df = pd.read_csv("output/storyboard.csv")
scene_groups = df.groupby("scene").agg({"shot_id": "count", "duration": "sum"}).rename(columns={"shot_id": "total_shots", "duration": "total_seconds"})
scene_groups.to_csv("output/scene_summary.csv")
```
运行该脚本前,必须已通过方法二或手动方式在 storyboard.csv 中存在 scene 列。否则 groupby 会报错 KeyError。
关键验证步骤
① 修改剧本加入 【场景:XXX】 标记后,重新运行 LibTV 工作流;
② 检查新生成的 output/storyboard.csv 是否多出 scene 列,且值与标记完全一致;
③ 运行 Python 脚本,确认 output/scene_summary.csv 成功生成,首行为 scene,total_shots,total_seconds;
【注意】若跳过第①步直接运行第③步,脚本将中断并删除已有 scene_summary.csv 文件,不可逆。











