This project is based on WhatDreamsCost/WhatDreamsCost-ComfyUI. Credit for the original LTX director idea and base implementation belongs to the original author. This fork focuses on a CS-prefixed ComfyUI workflow for grid storyboard automation.
核心节点：
| 节点 ID | 显示名称 | 作用 |
|---|---|---|
CS-LTXGridDirector |
CS-LTX 宫格导演台 |
从四宫格、六宫格或九宫格图像自动创建可编辑的 LTX 导演台时间线。 |
CS-LTXDirectorGuide |
CS-LTX 导演台引导 |
将导演台输出的图像引导数据接入 LTX 条件和潜空间链路。 |
CS-LTX 宫格导演台 是原六宫格导演台的升级版，支持 2x2 四宫格、3x2 六宫格、3x3 九宫格，并增加分镜比例裁剪、白边裁剪强度、图像源变化自动刷新和旧工作流参数自修复。
- 准备一张四宫格、六宫格或九宫格参考图。
- 将参考图连接到
宫格图像。 - 将 GPT、Qwen 反推模型或其他文本节点生成的分镜文本连接到
GPT 分镜文本。 - 选择
宫格模式，例如3x2 六宫格。 - 选择
分镜比例，例如16:9 横屏或9:16 竖屏。 - 根据宫格边框情况调整
白边裁剪强度。 - 点击
自动填充宫格，节点会生成对应数量的可编辑分镜块。 - 在导演台前端检查并手动修改每段分镜文本、时长或顺序。
- 将
引导数据接到CS-LTX 导演台引导，继续连接 LTX 采样和解码节点。
拆分顺序始终为从左到右、从上到下。
| 模式 | 分镜数量 | 顺序 |
|---|---|---|
2x2 四宫格 |
4 | 左上、右上、左下、右下 |
3x2 六宫格 |
6 | 上排 1-3，下排 4-6 |
3x3 九宫格 |
9 | 第一排 1-3，第二排 4-6，第三排 7-9 |
分镜比例 控制每个宫格单元拆出来之后的最终画面比例。
| 选项 | 说明 |
|---|---|
自动 / 保持单格比例 |
保持原始宫格单元比例，最稳妥。 |
16:9 横屏 |
将每个分镜居中裁切为横屏比例。 |
9:16 竖屏 |
将每个分镜居中裁切为竖屏比例。 |
1:1 方图 |
将每个分镜居中裁切为正方形。 |
推荐用法：
- 横屏视频：
分镜比例 = 16:9 横屏 - 竖屏视频：
分镜比例 = 9:16 竖屏 - 不确定比例：
分镜比例 = 自动 / 保持单格比例
白边裁剪强度 用来裁掉宫格之间的白线、黑边、分割线或边框残留。
| 数值 | 说明 |
|---|---|
0 |
不额外裁剪边缘。 |
0.5 |
轻微裁剪，适合人物贴边的画面。 |
1.0 |
默认裁剪，适合大多数宫格图。 |
1.5 |
加强裁剪，适合有明显白线或边框的图。 |
2.0-5.0 |
强裁剪，只建议在边框很厚时使用。 |
计算逻辑：
裁剪像素 = 单格短边 × 0.015 × 白边裁剪强度
例如单个分镜约为 640 x 360，短边是 360，强度 1.0 时每边大约裁掉 5 像素。
输出宽度 与 输出高度 用于强制导演台输出给 LTX 的分镜参考图尺寸。
通常建议保持：
输出宽度 = 0
输出高度 = 0
这样节点会根据拆分后的分镜图像自然处理尺寸。大多数横屏、竖屏和方图需求只需要设置 分镜比例，不需要再单独填写宽高。
只有在明确需要固定参考图尺寸时才填写，例如：
1280 x 720
720 x 1280
1024 x 1024
如果旧工作流里出现异常值，节点前端会尽量自动修复非法数值。正常使用时，宽高保持 0 / 0 即可。
推荐让 GPT 或 Qwen 反推模型输出纯中文自然段，每个自然段对应一个分镜。正文不需要 JSON，也不需要额外解释。
示例：
中景，女方坐在高层办公室的会议桌前，身穿灰色西装外套和白色内搭，低头翻阅合同文件，眉头微微皱起，镜头从桌面上的咖啡杯缓慢推向她的脸，纸张翻动声和窗外城市车流声混在安静的办公氛围里，女方用标准普通话（低声而谨慎）：“这里的预算数据对不上，我们可能低估了风险。”
中近景，男方穿着深色外套站在玻璃会议室门口，手里拿着平板，目光沉稳地看向女方，镜头从玻璃门边缘轻轻横移到他的侧脸，背景里传来空调运转声和远处键盘声，男方用标准普通话（冷静而克制）：“先别急，把你发现的问题完整说给我听。”
文本段落数量建议与宫格模式一致：
2x2 四宫格：4 段3x2 六宫格：6 段3x3 九宫格：9 段
多余段落会被忽略，缺少段落时可以在导演台前端手动补充。
导演台会根据上游宫格图像来源判断是否需要刷新时间线。
- 上游宫格图像变化：自动清除上一轮宫格缓存并刷新分镜图像。
- 文本变化：可以通过
同步文本写入当前分镜块。 - 总帧数、总秒数、帧率、分镜比例、白边裁剪强度变化：不会主动清空分镜文本，避免误删手动修改。
- 切换到其他工作流再切回当前工作流，或节点重新初始化时，如果宫格图像来源没有变化，会保留当前时间线文本。
执行时，自动宫格分镜会优先使用当前连接的 GPT 分镜文本，减少新图像误用上一轮提示词的情况。
画面边缘有白线：提高 白边裁剪强度，例如 1.2 或 1.5。
人物被裁掉：降低 白边裁剪强度，例如 0.5。
想做横屏视频：选择 分镜比例 = 16:9 横屏，宽高保持 0 / 0。
想做竖屏视频：选择 分镜比例 = 9:16 竖屏，宽高保持 0 / 0。
节点参数显示 NaN 或旧值错位：刷新 ComfyUI 页面或重新打开工作流，节点会自动修复常见非法值。
将仓库放入 ComfyUI 的 custom_nodes 目录，然后重启 ComfyUI：
ComfyUI/custom_nodes/CS-WhatDreamsCost-ComfyUI