comfyui-AICG3D

JGRFWGPL-3.0活跃维护

ComfyUI 的本地短剧与长视频生成插件,基于 MiniMax H3 工作流实现无限时长视频,支持文生视频和图生视频。

短剧工作台 | 无限时长视频的 MiniMax H3 工作流 | ComfyUI 本地短剧与长视频生成插件

v1.1.13发布于 2026-10-19 03:37 UTC507star +29 / 7 天71fork同步于 2026-11-10 23:57 UTC

怎么上手

由 README 提炼,执行前请确认
将 comfyui-AICG3D 文件夹复制到 ComfyUI 的 custom_nodes/ 目录下,重启 ComfyUI;或在 ComfyUI Manager / Comfy Registry 搜索 AICG3D 安装
硬件要求按 README 说明

README 未说明显存、GPU 型号或 CPU 运行要求

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

ComfyUI 上的短剧工作台插件,用 MiniMax H3 在本地做无限时长分段视频生成

ComfyUI 的本地短剧与长视频生成插件,基于 MiniMax H3 工作流实现无限时长视频,支持文生视频和图生视频。

核心能力

  • 用 AICG3D_H3_ 前缀隔离节点命名空间,避免同名插件互相覆盖
  • 把长剧本自动拆成逻辑段落并映射到视频时间轴
  • 内置潜空间 Latent 放大与 SelfLift 自提升采样增强细节
  • 二采支持 SeedVR2、RTX VSR、VOSR2 三种修复引擎逐颗接续
  • 固定六角色音色库,用 @角色N 跨段锁定声线

容易踩的坑

TTS、音色克隆、提示词优化和 FFmpeg 依赖在 requirements-optional.txt 里,需按需手动安装;不要再同时安装独立的 ComfyUI-AICG3D-PromptSplit,同名节点会互相覆盖前端逻辑;工作流 JSON 需从仓库 workflows 目录单独下载,不在插件包内自动就位

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v1.1.13
  1. 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。

    使用方式

    1. 打开 MiniMax H3 Aicg 加载器。
    2. 点击 FL2VA 模型、REF2VA 模型 或 LoRA 选择框。
    3. 优先展开对应文件夹选择模型。
    4. 已知文件名时,直接在搜索框输入关键词即可跨文件夹查找。
  2. 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 中使用的图片、音频和视频文件。

  3. 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 H3
    • aicg3d-h3-suite

    首次发布配置

    1. 在 Comfy Registry 创建 Publisher:aicg3d。
    2. 为 Publisher 创建 Registry API Key。
    3. 在 GitHub 仓库的 Actions Secrets 中添加 REGISTRY_ACCESS_TOKEN。
    4. 运行 Publish to Comfy Registry 工作流。

    发布成功后可在此查看:

    https://registry.comfy.org/nodes/aicg3d-h3-suite

  4. 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 加载失败或前端白板。

    升级方法

    1. 更新到 v1.1.10。
    2. 不需要再安装 ComfyUI-MiniMaxH3-Easy。
    3. 重启 ComfyUI。
    4. 浏览器执行 Ctrl+F5。
  5. 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 = true
    • domWidget.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 恢复为 false
    • domWidget.type 恢复为 h3_media_loader
    • options.hidden 与 options.canvasOnly 恢复为 false
    • _state 同步恢复
    • 资源库面板保持连接并正常显示“上传媒体 / 图片 / 音频 / 视频”区域

    升级方法

    1. 更新插件仓库。
    2. 完全关闭并重新打开 ComfyUI。
    3. 如果浏览器仍保留旧页面,按 Ctrl+F5。
    4. 打开或重新加载工作流,确认“MiniMax H3 Aicg资源库”面板正常显示。

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    工作流下载地址: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 策略增强:支持高级的自提升采样方案,极大增强画面细节的丰富度。

    🛠️ 安装与部署

    1. 快速安装:将 comfyui-AICG3D 文件夹复制到 ComfyUI 的 custom_nodes/ 目录下。
    2. 启动服务:重启 ComfyUI。
    3. 定位节点:在右键菜单中找到 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 项开源安全与兼容回归测试通过。