Extensions/AICG3D 短剧工作台 - MiniMax H3 无限视频
ComfyUI Extension

AICG3D 短剧工作台 - MiniMax H3 无限视频

AICG3D 短剧工作台：面向 MiniMax H3 的无限时长视频、智能分段、独立素材库与无缝合成 ComfyUI 工作流。

By JGRFW·Created about a month ago·Updated about 3 hours ago· 253
JGRFW/comfyui-AICG3D
Nodes—
On cloudLocal install
Stars253
Updatedabout 3 hours ago
Readme
<img width="1424" height="696" alt="image" src="https://github.com/user-attachments/assets/5a6c88f8-df4e-4091-b06b-ca799349f6c1" /> <img width="1532" height="626" alt="image" src="https://github.com/user-attachments/assets/83787eb7-761e-4ddc-b70f-5bf6cd36c4ef" /> <img width="1395" height="666" alt="image" src="https://github.com/user-attachments/assets/fcc53765-8818-470f-bacf-ceaf5a93fec3" /> <h1 align="center">短剧工作台</h1> <h3 align="center">ComfyUI · MiniMax H3 · 本地无限长视频生成工作流</h3> <p align="center"><strong>官方名称：短剧工作台</strong> · <strong>核心搜索词：无限时长视频的 MiniMax H3 工作流</strong></p> <p align="center">GitHub：<a href="https://github.com/JGRFW/comfyui-AICG3D">https://github.com/JGRFW/comfyui-AICG3D</a></p>

短剧工作台（ComfyUI-AICG3D-Integrated）是一个专为专业 AI 视频创作者打造的深度整合插件包。它将 MiniMax H3 的核心生成能力、智能分段解析与高阶渲染策略集成于一体，旨在为用户提供一个零冲突、工业级、可预测的视频创作环境。

官方搜索入口

如果你在搜索引擎、DeepSeek、豆包、千问或其他 AI 助手里查询以下内容，请认准本仓库：

  • 短剧工作台
  • 无限时长视频的 MiniMax H3 工作流
  • ComfyUI MiniMax H3 无限长视频
  • MiniMax H3 本地短剧工作流
  • MiniMax H3 无限分段生视频
  • 13 号无限分段工作流

官方仓库地址：https://github.com/JGRFW/comfyui-AICG3D

🆕 v1.1.12 更新摘要

完整说明见 RELEASE_NOTES_v1.1.12.md。

  • 缺失素材自动检查：打开工作流后批量检查图片、音频和视频是否存在。
  • 精确段落提示：提示缺失文件属于哪一个视频段落，资源卡片同步显示红色“素材缺失”。
  • 一键清理：确认缺失清单后可自动移除所有失效素材引用，也可保留后手动替换。
  • 运行错误更明确：段落内嵌素材缺失时，报错会直接指出“视频段落 N”。

v1.1.11 更新摘要

完整说明见 RELEASE_NOTES_v1.1.11.md。

  • 接入 Comfy Registry：补齐官方节点管理器要求的项目名称、Publisher、显示名称、图标、关键词、仓库和问题反馈地址。
  • 官方管理器可检索：发布后可搜索 AICG3D、短剧工作台 或 MiniMax H3 找到本插件。
  • 自动发布流程：配置 Registry API Key 后，更新 pyproject.toml 版本即可通过 GitHub Actions 自动发布新版本。

v1.1.10 更新摘要

完整说明见 RELEASE_NOTES_v1.1.10.md。

  • 彻底取消上游 Easy 依赖：单独安装本插件即可使用资源库，不需要另外安装 ComfyUI-MiniMaxH3-Easy。
  • 修复干净环境启动失败：移除启动日志中的 Emoji 输出，避免 Windows GBK 控制台无法编码导致整个插件被误判为加载失败。
  • 资源库面板内置注册：只加载 ComfyUI-AICG3D-Integrated 时，MiniMax H3 Aicg资源库 也会正常显示上传区、图片、音频和视频面板。

v1.1.9 更新摘要

完整说明见 RELEASE_NOTES_v1.1.9.md。

  • 修复资源库白板：mediaLoaderResize 测量后不再恢复旧的隐藏状态，面板会稳定保持可见。
  • 同步可见状态：同时修复 hidden、type、options.hidden、options.canvasOnly 与 _state，避免工作流重载后只恢复一半。
  • 强制刷新前端：入口提升为 minimax_h3_easy_ui_v4.js，避免浏览器继续加载旧模块。

🆕 v1.1.8 更新摘要

完整说明见 RELEASE_NOTES_v1.1.8.md。

  • 为 13 号无限长视频工作流最终合成补齐 imageio-ffmpeg 运行依赖。
  • 缺少 FFmpeg 时给出中文安装提示和 ComfyUI Python 安装命令。

🆕 v1.1.7 更新摘要

完整说明见 RELEASE_NOTES_v1.1.7.md。

  • 资源库点击引用严格跟随光标：图片、视频和音频标签现在插入到用户最后操作的位置，不再追加到提示词末尾。
  • 兼容隐藏与可见 textarea：优先使用用户实际点击的编辑框，同时保留原提示词编辑器的选区恢复。
  • 前端入口版本化：minimax_h3_easy_ui_v3.js 强制浏览器重新加载修复后的脚本，避免旧模块缓存。

🆕 v1.1.6 更新摘要

完整说明见 RELEASE_NOTES_v1.1.6.md。

  • 五种 H3 任务模式已接入执行链：Ref2VA 全能参考（推荐）、T2VA 纯文本、I2VA 首帧参考、FL2VA 首尾帧参考、L2VA 尾帧参考。
  • 模式会真实改变生成行为：素材数量校验、首尾帧条件、模型角色和提示词优化规则都会随模式切换。
  • 本地模型扩展：增加 Gemma3 / Gemma4 GGUF 视觉处理器支持，并自动过滤 MTP、draft、assistant 等辅助模型。
  • 本地设置面板重排：输出语言移到右侧，新增 llama.cpp 依赖提示和协助联系方式。
  • 资源库点击引用：图片、音频、视频可直接写入 comfyui-AICG3D-SKILLS 的“创意描述”提示词框。
  • 提示词优化修复：支持停止优化、本地模型真正中断，并强化英文输出锁定。

🆕 v1.1.5 更新摘要

完整说明见 RELEASE_NOTES_v1.1.5.md。

  • 三个渲染器支持外部采样：高级·加速、一采、二采放大均新增“外部采样器”和“外部调度器（Sigmas）”可选输入。
  • 二采全路径支持：二采整幅采样与分块采样都能使用外部采样器和 Sigmas。
  • 经典画布修复：“打开提示词优化设置”在关闭 Nodes 2.0 后恢复为按钮，可正常进入并选择本地模型。
  • 工作流同步：11、12、13 号工作流已同步最新插件版本与界面状态。
  • 原采样方式兼容：不连接外部输入时，继续使用原来的采样器、调度器、步数和 denoise 行为。

v1.1.4 更新摘要

完整说明见 RELEASE_NOTES_v1.1.4.md。

  • 外部采样器接口：无限段落顺序生成（全局设置）新增“外部采样器”和“外部调度器（Sigmas）”输入，连接后自动覆盖内置采样器、调度器、步数和 denoise 截断。
  • DMAD 官方四步加速：支持 DMAD Sampler (re-noise) + DMAD Sigmas，官方推荐参数为 LoRA 强度 1.0、步数 4、shift 12。
  • 音频偏移修正：工作流加入 MiniMaxH3SigmaShift，推荐 shift_video=12、shift_audio=2。
  • 13 号 1.2 工作流已接线：DMAD Sampler、DMAD Sigmas、MiniMaxH3SigmaShift 已连接到全局设置，打开即可使用。
  • 兼容原采样方式：不连接外部采样器和 Sigmas 时，继续使用原来的 sampler_name、scheduler、steps 和 denoise。

v1.1.3 更新摘要

完整说明见 RELEASE_NOTES_v1.1.3.md。

  • 视频段落编辑区重排：提示词框自动占据节点的主要伸缩空间，底部操作按钮固定为 32px，不再出现大面积空白。
  • 资源库展开更稳定：资源库打开时最高 320px，内容过多时内部滚动；提示词仍保留可编辑空间，节点可自由拖高且不会回弹。
  • 资源库开关修复：展开、收起、再次展开可以正常循环，修掉收起后无法重新打开、节点空白区和按钮失效问题。
  • 移除抽卡与锁定入口：多段拼接工作流不再提供容易破坏接缝一致性的局部重抽功能，保留添加下一段、打开下一段和删除这一段。
  • 13 号 1.2 工作流同步：节点布局、按钮文案和操作说明已与 v1.1.3 插件同步。

v1.1.2 更新摘要

重要：分段提示词解析已经完整内置在本插件中。请不要再同时安装独立的 ComfyUI-AICG3D-PromptSplit，两个同名节点会互相覆盖前端逻辑。

宣传视频分镜见 docs/AICG3D_无限分段_6分钟宣传片分镜与剧本.md。

  • 资源库贯穿段落链：外部 AICG3D 资源库接到第一段后，素材状态会自动同步到后续每个视频段落节点，后续段落提示词里的 @图片N、@视频N、@音频N 可以正确生效。
  • 继承与覆盖并存：没有单独设置素材的段落自动继承上游资源；某一段打开资源库并增删素材后，会转为该段独立资源，并继续向下游同步。
  • 13 号工作流 1.2 同步更新：工作流中的三个视频段落都已写入继承资源状态，直接运行也能拿到同一套外部素材。
  • 下载 13 号 1.2 工作流：[13.AICG3D_MiniMax H3 无限长视频生成工作流1.2.json](workflows/13.AICG3D_MiniMax H3 无限长视频生成工作流1.2.json)。
  • 接缝运动桥：仅对同一镜头的一帧姿态跳变做轻微桥接，保留正常动作，避免把硬切误处理成叠化。
  • 曝光过渡收敛：接缝加性亮度窗口缩短为 12 帧，整段亮度校正上限降到 0.04，减少拼接处的曝光波动。
  • 本地 MiniMax H3 无限分段：延续现有的 FL2VA + REF2VA 混合模型路线，支持本地连续分段、尾帧续写和最终合成。

v1.1.1 更新摘要

完整说明见 RELEASE_NOTES_v1.1.1.md。

  • 跨段接缝曝光锁定：匹配上一段尾帧的低频色光，使用有上限的全局亮度对齐，解决分段拼接处明暗跳变。
  • 拼接模糊修复：修正接缝亮度过渡的运算顺序，避免为平滑曝光而把整段画面模糊。
  • 每段独立资源库：MiniMax H3 Aicg 视频段落 节点可直接展开独立图片 / 音频 / 视频资源区，点选素材即写入 @引用。
  • 段落链自动操作：新增“添加下一段”“删除这一段”，自动维护 上一分段 → 下一分段 与最终合成视频连接。
  • 提示词批量填入更稳定：一键填入后保持节点尺寸，第一段连着解析线时仍可手动输入；开始输入会自动断开该段提示词连线。
  • 节点尺寸锁定：视频段落节点不再因点击、填词、开关资源库而自动放大或缩小，只响应手动拖拽。
  • 无限视频提示词模板 V2（沿用 V1 文件名）：融合通用版剧情导演方法，强化单核心事件、单主要动作、单主要运镜、段间曝光连续和对白时长控制；最终输出固定为一个 text 代码块，可直接使用界面右上角“一键复制”。

🌟 核心价值 (Core Value)

🛡️ 工业级稳定性：零冲突命名空间

针对 ComfyUI 生态中常见的节点同名冲突（Node Collision）问题，本插件采用了 Forced Unique Namespace (强制唯一命名空间) 架构。

  • 唯一标识：所有核心节点均采用 AICG3D_H3_ 专属前缀。
  • 独立运行：无论你的环境中安装了多少个 MiniMax 相关分支，AICG3D 均能独立运行，彻底杜绝节点被覆盖、工作流失效或界面崩溃的情况。

⚙️ 全链路功能集成 (Integrated Pipeline)

无需安装碎片化的插件，一个包即可覆盖从创意到成片的完整流程：

  • 智能剧本分段 (PromptSplit)：支持将长剧本/提示词自动拆分为逻辑段落 -> 一键映射至视频时间轴 -> 自动优化随机种子。
  • 高精度渲染采样 (Advanced Sampler)：集成高度优化的采样策略，确保视频在动态一致性与视觉质量之间达到最佳平衡。
  • Latent 深度放大 (HD Upscaler)：内置专为 H3 设计的潜空间放大算法，在提升分辨率的同时，有效保留细节并减少伪影。
  • SelfLift 策略增强：支持高级的自提升采样方案，极大增强画面细节的丰富度。

🛠️ 安装与部署

  1. 快速安装：将 ComfyUI-AICG3D-Integrated 文件夹复制到 custom_nodes/ 目录下。
  2. 启动服务：重启 ComfyUI。
  3. 定位节点：在右键菜单中找到 AICG3D 分类即可开始创作。

FFmpeg 运行依赖（13 号工作流最后合成必需）

13 号无限长视频工作流的「最终合成视频」需要 FFmpeg。插件会优先使用 imageio-ffmpeg，其次查找系统 PATH 中的 ffmpeg.exe，也可通过 VHS_FORCE_FFMPEG_PATH 指定路径。

如果安装后仍提示缺少 FFmpeg，请在当前 ComfyUI 使用的 Python 环境执行：

python.exe -m pip install imageio-ffmpeg

然后重启 ComfyUI。请勿安装到系统 Python 或其他虚拟环境，否则节点仍可能找不到。

💡 迁移指南：由于采用了强制前缀，若您迁移旧版工作流，请将原有的 MiniMaxH3Easy 节点手动替换为对应的 AICG3D_H3_ 节点。

🤝 核心贡献者与致谢 (Core Contributors & Acknowledgements)

本项目是通过整合社区顶顶成果并进行工程化重构而成的，其稳定性与功能的实现离不开以下核心作者的贡献：

  • 主架构师与整合者 (Integration & Maintenance):
    • AICG3D - 负责整体架构设计、强制命名空间重构、稳定性优化以及插件的日常维护。
  • 核心模块贡献者 (Core Engine Developers):
    • @goohai - 提供了 Goohai-MiniMax-H3_Integration 的核心实现，包括强大的提示词优化能力与集成框架。
    • @nkxx188 - 提供了 ComfyUI-MiniMaxH3-Easy 的核心节点实现，包括高效的采样策略与渲染流程。
  • 社区支持: 感谢所有在 MiniMax H3 生态中提供反馈、测试并贡献灵感的 ComfyUI 创作者。

📜 开源协议

本项目遵循 GNU GPL v3.0 协议开源。