TTS、音色克隆、提示词优化和 FFmpeg 依赖在 requirements-optional.txt 里,需按需手动安装;不要再同时安装独立的 ComfyUI-AICG3D-PromptSplit,同名节点会互相覆盖前端逻辑;工作流 JSON 需从仓库 workflows 目录单独下载,不在插件包内自动就位
comfyui-AICG3D
JGRFWGPL-3.0活跃维护ComfyUI 的本地短剧与长视频生成插件,基于 MiniMax H3 工作流实现无限时长视频,支持文生视频和图生视频。
短剧工作台 | 无限时长视频的 MiniMax H3 工作流 | ComfyUI 本地短剧与长视频生成插件
将 comfyui-AICG3D 文件夹复制到 ComfyUI 的 custom_nodes/ 目录下,重启 ComfyUI;或在 ComfyUI Manager / Comfy Registry 搜索 AICG3D 安装README 未说明显存、GPU 型号或 CPU 运行要求
ComfyUI 上的短剧工作台插件,用 MiniMax H3 在本地做无限时长分段视频生成
ComfyUI 的本地短剧与长视频生成插件,基于 MiniMax H3 工作流实现无限时长视频,支持文生视频和图生视频。
核心能力
- 用 AICG3D_H3_ 前缀隔离节点命名空间,避免同名插件互相覆盖
- 把长剧本自动拆成逻辑段落并映射到视频时间轴
- 内置潜空间 Latent 放大与 SelfLift 自提升采样增强细节
- 二采支持 SeedVR2、RTX VSR、VOSR2 三种修复引擎逐颗接续
- 固定六角色音色库,用 @角色N 跨段锁定声线
容易踩的坑
- v1.1.13AICG3D H3 Suite v1.1.13最新正式版2026-10-19 · 2026-10-19 03:37 UTC
comfyui-AICG3D v1.1.13
本次更新优化 MiniMax H3 Aicg 加载器的模型和 LoRA 选择体验,解决模型数量较多时只能在扁平列表中翻找的问题。
更新内容
- 加载器下拉菜单按模型实际目录自动分组。
- MiniMax、Krea2、Qwen、LTX2.5、Wan22Animate、Z-Image 等目录显示为可展开文件夹。
- LoRA 下拉支持多层目录,例如
Krea2/Krea2-风格。 - 文件夹显示包含的模型数量,并自动定位当前选中项所在目录。
- 保留“最近使用”区域,常用模型无需重复查找。
- 搜索仍可跨目录直接匹配文件名和完整路径。
- 兼容关闭 Nodes 2.0 后的经典节点界面。
- 版本号提升至
1.1.13。
使用方式
- 打开
MiniMax H3 Aicg 加载器。 - 点击
FL2VA 模型、REF2VA 模型或 LoRA 选择框。 - 优先展开对应文件夹选择模型。
- 已知文件名时,直接在搜索框输入关键词即可跨文件夹查找。
- v1.1.12AICG3D H3 Suite v1.1.122026-10-18 · 2026-10-18 03:44 UTC
查看更新说明
comfyui-AICG3D v1.1.12
本次更新重点解决工作流分享后参考素材路径失效的问题,避免图片、音频或视频已经丢失时仍然静默显示为空块。
更新内容
- 工作流加载后自动批量检查所有 AICG3D 素材引用。
- 缺失素材会在资源卡片上显示红色“素材缺失”标记。
- 会明确指出缺失素材所属的视频段落,例如“视频段落 1、2”或“视频段落 3”。
- 弹出确认框汇总缺失文件,并支持一键移除所有失效引用。
- 后端执行视频段落时,内嵌素材读取失败会带上“视频段落 N”的错误上下文。
- 新增
/aicg3d/api/media/validate批量校验接口。 - 版本号提升至
1.1.12。
使用方式
打开工作流后如果存在缺失素材,插件会显示缺失文件清单:
- 点“确定”:自动清理无效素材引用。
- 点“取消”:保留引用和红色缺失标记,便于手动重新上传或替换素材。
素材文件本身不会嵌入工作流 JSON,分享工作流时仍建议同时打包
ComfyUI/input中使用的图片、音频和视频文件。 - v1.1.11AICG3D H3 Suite v1.1.112026-10-17 · 2026-10-17 14:02 UTC
查看更新说明
comfyui-AICG3D v1.1.11
本次更新将 AICG3D 短剧工作台接入 ComfyUI 官方节点注册表(Comfy Registry),让用户可以直接在 ComfyUI 官方节点管理器中搜索和安装。
更新内容
- 补齐 Comfy Registry 所需的项目名称、版本、Publisher、显示名称、仓库地址和问题反馈地址。
- 增加用于官方管理器卡片展示的 AICG3D 图标。
- 增加中文与英文检索关键词,覆盖
AICG3D、短剧工作台、MiniMax H3、无限长视频和infinite video。 - 增加 GitHub Actions 自动发布流程。
- 版本号提升至
1.1.11。
发布后如何搜索
在 ComfyUI 官方节点管理器的搜索框输入以下任意关键词:
AICG3D短剧工作台MiniMax H3aicg3d-h3-suite
首次发布配置
- 在 Comfy Registry 创建 Publisher:
aicg3d。 - 为 Publisher 创建 Registry API Key。
- 在 GitHub 仓库的 Actions Secrets 中添加
REGISTRY_ACCESS_TOKEN。 - 运行
Publish to Comfy Registry工作流。
发布成功后可在此查看:
- v1.1.10AICG3D H3 Suite v1.1.102026-10-17 · 2026-10-17 13:51 UTC
查看更新说明
comfyui-AICG3D v1.1.10
本次更新解决单独安装本插件时资源库节点白板、必须额外安装
ComfyUI-MiniMaxH3-Easy的问题。根因
插件启动时会输出带 Emoji 的初始化日志。部分 Windows 环境使用 GBK 控制台编码,无法编码 Emoji,
print抛出UnicodeEncodeError,插件加载流程随后把整个插件判定为加载失败,节点注册被清空。当用户另外安装上游
ComfyUI-MiniMaxH3-Easy时,上游补上了同名或相近节点注册,所以表面上看起来资源库恢复可用。修复
- 插件启动日志全部改为编码安全输出。
- 不再输出无法被 GBK 编码的 Emoji。
- 异常日志改为先格式化,再通过安全输出函数写入。
- 单独加载
ComfyUI-AICG3D-Integrated时,后端不会再因为控制台编码而整体加载失败。 - 资源库前端面板已经随本插件内置,不需要上游 Easy 插件补界面。
验证
使用 ComfyUI 的隔离模式仅加载本插件:
--disable-all-custom-nodes --whitelist-custom-nodes ComfyUI-AICG3D-Integrated验证结果:
AICG3D_H3MediaLoader正常注册。- 资源库节点正常创建。
- 上传媒体、图片、音频、视频分区正常显示。
- 未出现 Python 加载失败或前端白板。
升级方法
- 更新到 v1.1.10。
- 不需要再安装
ComfyUI-MiniMaxH3-Easy。 - 重启 ComfyUI。
- 浏览器执行
Ctrl+F5。
- v1.1.9comfyui-AICG3D v1.1.92026-10-14 · 2026-10-14 04:31 UTC
查看更新说明
comfyui-AICG3D v1.1.9
本次更新修复部分用户打开工作流后,“MiniMax H3 Aicg资源库”节点显示为白板的问题。
问题原因
mediaLoaderResize()在测量节点固定高度时,会临时把资源库的 DOM 面板标记为隐藏:domWidget.hidden = truedomWidget.type = "hidden"
测量结束后,原逻辑会恢复测量前的值。某些工作流加载、标签切换或 Nodes 2.0 重建顺序下,测量开始前面板已经是隐藏状态,因此测量结束后仍保持隐藏,用户看到的就是一块只有节点标题的白板。
修复内容
- 测量结束后强制把资源库 DOM 面板恢复为可见。
- 同步修复
hidden、type、options.hidden、options.canvasOnly和_state。 - 保留面板原有类型;即使进入测量时类型已经是
hidden,也会恢复到h3_media_loader。 - 不影响节点折叠、画布切换和其他原生控件的独立隐藏状态。
前端缓存
入口文件更新为:
web/minimax_h3_easy_ui_v4.js
旧入口不再使用,避免浏览器继续运行旧模块。
验证
已在真实 ComfyUI 页面中模拟“resize 前面板已经隐藏”的状态:
domWidget.hidden恢复为falsedomWidget.type恢复为h3_media_loaderoptions.hidden与options.canvasOnly恢复为false_state同步恢复- 资源库面板保持连接并正常显示“上传媒体 / 图片 / 音频 / 视频”区域
升级方法
- 更新插件仓库。
- 完全关闭并重新打开 ComfyUI。
- 如果浏览器仍保留旧页面,按
Ctrl+F5。 - 打开或重新加载工作流,确认“MiniMax H3 Aicg资源库”面板正常显示。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
工作流下载地址:https://github.com/JGRFW/comfyui-AICG3D/tree/main/workflows
短剧工作台(comfyui-AICG3D)是一个专为专业 AI 视频创作者打造的深度整合插件包。它将 MiniMax H3 的核心生成能力、智能分段解析与高阶渲染策略集成于一体,旨在为用户提供一个节点命名空间隔离、可维护、可预测的视频创作环境。
官方搜索入口
如果你在搜索引擎、DeepSeek、豆包、千问或其他 AI 助手里查询以下内容,请认准本仓库:
- 短剧工作台
- 无限时长视频的 MiniMax H3 工作流
- ComfyUI MiniMax H3 无限长视频
- MiniMax H3 本地短剧工作流
- MiniMax H3 无限分段生视频
- 13 号无限分段工作流
官方仓库地址:https://github.com/JGRFW/comfyui-AICG3D
🆕 v1.1.26 更新摘要
完整说明见 RELEASE_NOTES_v1.1.26.md。
- 管理器启动卡死修复:根目录
requirements.txt改为零自动安装,避免 ComfyUI Manager 启动时下载imageio-ffmpeg等大型依赖而卡在启动界面。 - 可选依赖拆分:TTS、音色克隆、提示词优化和 FFmpeg 依赖移动到
requirements-optional.txt,只在需要对应功能时手动安装。 - Registry 元数据零强制依赖:
pyproject.toml不再强制安装外部包,ComfyUI 本体已有运行环境可直接启动。 - 缺失依赖提示保留:可选功能缺包时仍会在对应节点内给出明确安装提示,不影响其他节点和工作流加载。
🆕 v1.1.25 更新摘要
完整说明见 RELEASE_NOTES_v1.1.25.md。
- 二采无限修复链:新增 SeedVR2、RTX VSR、VOSR2 三种真实修复引擎;修复模式会处理上一颗二采的结果并回写 H3 latent,
1.0x也能逐颗接续。 - 二采音频锁定:视频二采使用独立噪声遮罩,采样后强制恢复一采原音轨,减少音频被二次修复和速度变化的问题。
- 二采界面联动:修复引擎、模型、批次、重叠、颜色校准和设备参数会按所选引擎显示,节点宽度保持稳定。
- 角色音色库布局修复:兼容经典节点模式与 Nodes 2.0,旧工作流中的小尺寸会自动修正,面板宽度和高度会跟随节点重新布局,不再只显示窄窄一栏。
- 开源加载加固:收敛节点命名空间和兼容注册,避免与同名 H3、PromptSplit、Spark-TTS 插件互相覆盖。
- 工作流同步:更新 11 号数字人、12 号二采和 13 号无限分段工作流。
🆕 v1.1.24 更新摘要
完整说明见 RELEASE_NOTES_v1.1.24.md。
- 二采渲染链升级:V2 Latent 放大器、真实二次扩散采样、音频原样保留,并支持“二采数据”继续连接下一级二采。
- 输出口完成迁移:一采为“一采数据 → 一采成片”,二采为“二采数据 → 一采成片 → 成片视频”;旧工作流自动修正连线。
- 二采界面整理:采样预览和预览间隔移动到底部,分块参数按开关显示,旧参数位置自动迁移。
- 空视频保护:视频输出存在下游保存节点时,自动开启一采或附带一采解码,修复
SaveVideo收到None的报错。 - 连续二采能力:每一级二采都执行真实放大和采样,不是视频透传;可继续使用二采数据组成多级高清链。
- 二采独立修复引擎:新增 SeedVR2、RTX VSR、VOSR2 三种真实修复方式;选择引擎后,
1.0x可按“后一颗处理前一颗”的方式无限接续,音频保持原样。详见 二采无限修复。
🆕 v1.1.23 更新摘要
完整说明见 RELEASE_NOTES_v1.1.23.md。
- 固定六角色音色库:女孩、男孩、女主角、男主角、老太太、老爷子各有独立声线座位;支持描述音色和 5~15 秒参考音频克隆。
- 跨段音色锁定:在提示词写
@角色1~@角色6才会启用对应座位音色;角色显示名可自由修改,引用标记永远不变。 - 角色音色库完全可选:不添加该节点时,工作流会自动清除失效音色链接并跳过音色处理,主 H3 节点和所有视频段落按普通模式正常生成,不会因为缺少音色库报错。
- 单段抽卡继承最新音色:提交时给每个段落显式注入音色库连接,避免抽卡目标从上一段缓存继承旧音色。
- 角色名精确匹配与安全报错:改名后不会因前缀相同误触发;克隆音色缺少人物画面参考时会给出清楚的中文提示。
- 避免音色说明被朗读:音色参数以静默制作元数据提交,并锁定只有
<d>...</d>内的原文可以作为台词发声。 - 音色试听与 11 号工作流:克隆音色可直接试听截取片段;描述音色使用插件内置 Spark-TTS 生成试听,并把听到的同一个 WAV 自动固定为 H3 克隆参考;11 号工作流已加入同一个角色音色库。
- 节点内完整音色操作:每个角色可直接生成 Spark 音色、重新生成、试听/停止试听、清除生成音色,并把
@角色N一键应用到 11 号主节点或 13 号视频段落提示词;重新生成始终读取当前语言和声线描述。 - 多人物图像音色绑定:角色可绑定图像1~图像9,插入时自动写成
@角色N <Picture X>;H3 元数据会锁定该图像人物只能使用对应声线,并在素材过滤后同步重编号。 - 儿童/老年声线年龄优先:儿童角色自动切换 Spark 最高音高并启用内部
Child年龄 token;描述里出现“3岁、幼儿、奶声”等词也会触发,避免生成成年人声线。 - 全年龄男女声线映射:覆盖儿童、少年、青年、成年、中年、老年六档;描述中的具体年龄数字和关键词会自动识别男女与年龄,并映射到 Spark 年龄 token 和对应男/女声线。重新生成时会直接朗读“固定声线描述”原文。
- 12 套声线模板与关键词标签:固定声线描述旁可直接选择儿童、少年、青年、成年、中年、老年的男女模板,自动同步年龄、性别、音高和语速;18 个声音关键词可一键追加。
- 一键清除全部提示词:分段提示词解析节点可清空解析文本和所有视频段落提示词,同时保留段落连线、秒数、种子、模型和最终合成设置。
🆕 v1.1.21 更新摘要
完整说明见 RELEASE_NOTES_v1.1.21.md。
- Registry 安装包修复:关闭 Git 中文路径转义并启用 UTF-8,管理器下载包现在会包含全部工作流和中文技能资源。
- 发布包自动验收:Registry Action 会下载刚发布的 zip,关键入口、后端节点、至少 9 个工作流或许可证缺失时直接失败。
- 保留 1.1.20 功能:旧节点兼容、资源库上传、PromptSplit 新旧 ID、Nodes 2.0 布局和真正单段抽卡全部保留。
🆕 v1.1.19 更新摘要
完整说明见 RELEASE_NOTES_v1.1.19.md。
- 开源安全与兼容性审计:修复集成节点 ID 冲突并为旧工作流自动迁移,隔离 API Key、阻止素材路径穿越、移除 KJNodes 私有模块注入,并修复本地视觉模型图像载荷。
- UI 与注册稳定性:修复资源库恢复时的重复尺寸回调、补齐节点分类、减少全局补丁层级,并确保后端失败时不会启动半套前端。
v1.1.18 更新摘要
完整说明见 RELEASE_NOTES_v1.1.18.md。
- 旧版数字人工作流兼容:自动修复其他电脑加载旧工作流时 RIFE 模型、插帧倍率和清缓存值错位的问题,避免出现“输入超出范围 / 无效输入”。
v1.1.17 更新摘要
完整说明见 RELEASE_NOTES_v1.1.17.md。
- 全能参考采样预览恢复:修复“高级·加速”渲染器解码了预览帧却未回传原生预览通道的问题,全能参考、图生视频和数字人模式均可实时显示采样预览。
- 未引用音频不再误用:
Ref2VA 全能参考只有提示词明确写入有效的<Audio N>时才读取资源库音频;没有音频标签时自动忽略音频,图片与视频参考保持不变。 - 数字人音频驱动保持兼容:数字人(锁定音频)仍会直接把资源库音频作为驱动音轨,不要求额外填写
<Audio N>。
v1.1.16 更新摘要
完整说明见 RELEASE_NOTES_v1.1.16.md。
- 资源库音频/视频直接引用:点击音频、视频卡片会按当前光标位置插入
<Audio N>/<Video N>,播放按钮独立操作,不再抢占卡片点击。 - 截取时长与选段窗口:音频/视频裁剪支持输入
5、5 秒、5s或0:05;新增“选段位置”滑块可整体移动固定时长片段。 - 视频段落布局修复:提示词编辑区占满可用空间,参数和按钮固定行高,展开资源库后不再出现大块空白。
- 旧工作流引导帧迁移:自动修复素材 JSON 错位到“引导帧位置”的旧数据,恢复为数字
0并保留素材引用。
🆕 v1.1.15 更新摘要
完整说明见 RELEASE_NOTES_v1.1.15.md。
- 目录结构唯一命名空间加固:
h3easy/、h3goohai/迁移至aicg3d_h3easy/、aicg3d_h3goohai/,进一步降低与同源插件的加载冲突。 - 新增 3D 人物白模与分段采样器:
MiniMax H3 Aicg 3D人物白模(视频→动作骨架)与分段采样器节点。 - 新增 11 号多参考·首尾帧·数字人、15 号分段人物场景动作迁移替换工作流。
- 数字人长音频自动分段:超长音频自动切段顺序生成,配合 SelfLift 潜空间放大提速。
- 修复数字人模式渲染报错:修复
NameError: name 'self' is not defined。
🆕 v1.1.14 更新摘要
完整说明见 RELEASE_NOTES_v1.1.14.md。
- Registry 搜索修复:修复安全扫描标记的 PyTorch 不安全反序列化。
- 安全加载权重:非 SafeTensors 的 latent 放大模型改用
weights_only=True加载。 - 公开管理器可检索:新版本通过自动扫描后,其他电脑可直接在自定义节点管理器搜索安装。
- 开源兼容性加固:内部 Python 包、HTTP 路由和前端扩展名全部改为 AICG3D 唯一命名空间,降低与同源插件的加载冲突。
- 分段解析正式节点 ID:改为
AICG3D_H3PromptSegmentSplit;未安装旧 PromptSplit 插件时仍保留旧 ID 兼容别名,新工作流不会争用通用节点名。 - API Key 不回传浏览器:提示词优化设置只返回“是否已保存”,留空保存会保留原密钥,并支持显式清除。
v1.1.13 更新摘要
完整说明见 RELEASE_NOTES_v1.1.13.md。
- 模型目录树:加载器下拉按
MiniMax、Krea2、Qwen、LTX2.5等文件夹分组显示。 - LoRA 多级目录:支持
Krea2/Krea2-风格这类多层文件夹展开选择。 - 搜索与最近使用保留:可直接跨目录搜索文件名,也可从最近使用快速选择。
- 经典界面兼容:关闭 Nodes 2.0 后同样使用文件夹式选择。
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时,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 策略增强:支持高级的自提升采样方案,极大增强画面细节的丰富度。
🛠️ 安装与部署
- 快速安装:将
comfyui-AICG3D文件夹复制到 ComfyUI 的custom_nodes/目录下。 - 启动服务:重启 ComfyUI。
- 定位节点:在右键菜单中找到 AICG3D 分类即可开始创作。
推荐直接在 ComfyUI Manager / Comfy Registry 搜索 AICG3D、短剧工作台 或 MiniMax H3 安装。正常安装会自动处理 Python 依赖;安装完成后重启 ComfyUI,并在浏览器执行 Ctrl+F5。
本插件已内置资源库、分段提示词解析和 H3 核心节点,不需要另外安装 ComfyUI-MiniMaxH3-Easy 或独立的 ComfyUI-AICG3D-PromptSplit。同时安装上游 Easy 插件时,本插件会保留自己的 AICG3D_H3* 节点,避免同名节点互相覆盖。
FFmpeg 运行依赖(13 号工作流最后合成必需)
13 号无限长视频工作流的「最终合成视频」需要 FFmpeg。插件会优先使用 imageio-ffmpeg,其次查找系统 PATH 中的 ffmpeg.exe,也可通过 VHS_FORCE_FFMPEG_PATH 指定路径。
如果安装后仍提示缺少 FFmpeg,请在当前 ComfyUI 使用的 Python 环境执行:
python.exe -m pip install -r requirements.txt
然后重启 ComfyUI。请勿安装到系统 Python 或其他虚拟环境,否则节点仍可能找不到。
Spark-TTS 模型(角色音色库必需,模型本体不随插件分发)
插件已经内置 Spark-TTS 推理源码、节点注册和 5 个 Step-Audio-speakers 参考音频,不需要再安装 ComfyUI_SparkTTS。只有大模型权重需要单独下载:
ComfyUI/
└─ models/
└─ tts/ # Windows 下 models\TTS 也兼容
└─ Spark-TTS-0.5B/
├─ config.yaml
├─ BiCodec/
├─ LLM/
└─ wav2vec2-large-xlsr-53/
下载地址:https://huggingface.co/SparkAudio/Spark-TTS-0.5B
角色音色库会显示模型状态;缺少模型时,鼠标移到提示条或点击“生成 Spark 音色”会给出缺失目录、缺失文件和下载地址。也可用环境变量 AICG3D_SPARK_TTS_MODEL 指向模型目录。
官方工作流的附加节点
- 13 号 1.2 工作流使用
DMADSampler/DMADSigmas,需安装 ComfyUI-DMAD。 - 11 号数字人工作流中的
MiniMaxH3DMADSampler来自Spark-H3;没有该节点时请改用工作流内可用的 AICG3D 采样器,或安装对应节点包。 - 角色音色库的描述音色试听使用本插件内置的
AICG3D Spark-TTS 固定声线生成,无需另装ComfyUI_SparkTTS;只要求单独下载Spark-TTS-0.5B模型,缺少时节点会明确提示目录和下载地址。 - 12、13 号工作流里的
Label (rgthree)只是画布注释;缺少 rgthree-comfy 时不影响后端生成,但建议安装以正常显示标签。
💡 迁移说明:新工作流使用
AICG3D_H3*命名空间。旧工作流常用到的MiniMaxH3EasyMediaLoader、MiniMaxH3EasySequenceGlobal、MiniMaxH3EasySequenceSegment和MiniMaxH3EasySequenceCombine已提供自动兼容注册;只有遇到未覆盖的旧节点时,才需要手动替换为对应的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 或更高版本(GPL-3.0-or-later)协议开源。
🆕 v1.1.20 更新摘要
完整说明见 RELEASE_NOTES_v1.1.20.md。
- 管理器安装兼容修复:补齐旧版
MiniMaxH3Easy*资源库和段落节点 ID,旧工作流不再因为缺少节点而显示白板。 - 分段提示词解析恢复:新旧节点 ID 都安装“一键填入全部视频段落”和“✦ 优化提示词”按钮,并在工作流加载后兜底初始化。
- 资源库上传恢复:修复 Nodes 2.0 资源面板的父容器尺寸和前端归属判断,上传、图片/音频/视频列表和清空按钮保持可用。
- Nodes 2.0 布局修复:资源库面板固定在节点内部 320px 区域滚动,不再溢出节点或盖住其他节点。
- 单段抽卡修复:点击任意“抽卡时段”只采样当前段,上一段从本进程缓存读取;右上角运行只做最终合成。
- 干净安装验证:已实测媒体上传、旧/新分段解析节点、三段自动填入、第一段文本编辑和提示词框尺寸保持。
- 注册与发布审计:Python 全量编译、前端全量语法检查、Registry 发布校验和 10 项开源安全与兼容回归测试通过。