AICG3D 短剧工作台 - MiniMax H3 无限视频
AICG3D 短剧工作台:面向 MiniMax H3 的无限时长视频、智能分段、独立素材库与无缝合成 ComfyUI 工作流。
Nodes (49)
The one node that reads your prompt, picks the task mode, and hands out a context
Two speed switches that actually move the needle — and one that quietly eats your detail
16 short from coming out 16:9
Where MiniMax H3's joint latent finally becomes pictures and sound
Past 30 seconds, H3 stops being a video model and starts being a timeline — this is the node that plans it
The sampler MiniMax H3 actually wants
The one-node crowbar that opens MiniMax H3's integration bundle
A MiniMax H3 panel that hides fifteen inputs and hands you one wire
A neural 3D upscaler for video latent, not a resize — MiniMax H3 Easy 3D Latent Upscale
One loader, two transformers, two VAEs — where H3 workflows actually start
The unglamorous node that makes H3 workflows run headless — 媒体中转
Drag your refs into one panel, then cite them as @图片1
Get your references back out as normal IMAGE, VIDEO and AUDIO — 媒体拆分
You Already Loaded H3 Your Way — This Node Just Needs the Handoff
The One-Wire H3 Context, Split Back Into Seven Normal Wires
The node that types your script into every segment
One Node That Samples, Decodes Both Streams and Hands You a Video
Same Renderer, But the Model Is Forced Onto an Explicit Wire
Render the Cheap Version First, Then Decide If It Deserves a Second Pass
Upscale the Latent, Then Repaint It at 0.5
An H3 Sampler That Takes Its Schedule From Someone Else
Five Sampling Nodes Collapsed Into One Box, With a Denoise That Works
Re-Encode Your Keyframes at the Bigger Size, or the Second Pass Drifts
One Input, and It Has to Be the *Last* Segment Step
Cut a Long Video Into Pieces H3's Latent Grid Will Actually Accept
Segment Decode is the node that turns your pile of latents into an actual mp4
The second pass that fixes resolution without breaking your seams
Segment Render samples the whole shot list — and carries motion forward between them
One sampler node that also hands you the sampler and the sigmas
Plug it into the first step and forget it
The chain that replaces a wall of sampler nodes
What Selected Video Context is really for
Sample the rough draft at three-quarter size, then finish at full
One long mp4 out of a paragraph chain, without a RAM bill
The global config for infinite segments — and why half its widgets exist
One node per shot, chained by the tail of the one before it
Turn your own footage into a grey 3D mannequin — motion reference without the actor
144 prompt templates, wired into your graph as a string
Paste a whole script, split it, and fill every segment node in one click
Pick a director, get a prompt framework out
工作流下载地址:https://github.com/JGRFW/comfyui-AICG3D/tree/main/workflows
<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)是一个专为专业 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 项开源安全与兼容回归测试通过。