短剧工作台 v1.1.5 | 渲染器外部采样与工作流同步

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

DMAD 官方插件：https://github.com/Yzmblog/DMAD

comfyui-AICG3D v1.1.5

本次更新把外部采样器和外部 Sigmas 接入三个渲染器，并修复经典画布模式下提示词优化设置无法打开的问题，同时同步 11、12、13 号工作流。

1. 三个渲染器支持外部采样

以下节点新增可选输入：

• AICG-渲染器（高级·加速）
• AICG-渲染器（一采）
• AICG-渲染器（二采放大）

新增输入：

• 外部采样器：SAMPLER
• 外部调度器（Sigmas）：SIGMAS

连接外部输入后，实际采样优先使用外部采样器和 Sigmas。未连接时，继续使用原来的采样器名称、调度器、步数和 denoise。

2. 二采完整支持

• 二采放大节点的整幅采样支持外部采样器和 Sigmas。
• 二采分块采样同样支持外部采样器和 Sigmas。
• 外部 Sigmas 的步数会同步到进度计算。

3. DMAD 四步加速

可连接：

• DMAD Sampler (re-noise) -> 外部采样器
• DMAD Sigmas -> 外部调度器（Sigmas）

官方推荐参数：

• DMAD LoRA 强度：1.0
• 步数：4
• Sigmas：steps=4，shift=12
• MiniMaxH3SigmaShift：shift_video=12，shift_audio=2

DMAD 插件来源：https://github.com/Yzmblog/DMAD

4. 提示词优化设置修复

• Nodes 2.0 开启时保持原来的入口行为。
• Nodes 2.0 关闭时，经典画布把入口显示为真正的“打开提示词优化设置”按钮。
• 点击后可以正常打开设置面板并选择本地视觉模型。
• 保存工作流时仍保留原布尔值位置，不会造成控件错位。

5. 工作流同步

• workflows/11.AICG3D_多参考-数字人.json
• workflows/12.AICG3D_二彩高清放大.json
• workflows/13.AICG3D_MiniMax H3 无限长视频生成工作流1.2.json
• workflows/13.AICG3D_无限分段 生视频.json

6. 同步内容

• h3easy/nodes.py
• h3easy/aicg3d_sampler.py
• web/minimax_h3_easy_ui.js
• 插件版本：1.1.5

升级方法

1. 更新本插件仓库。
2. 如使用 DMAD 工作流，安装或更新 https://github.com/Yzmblog/DMAD。
3. 重启 ComfyUI。
4. 浏览器执行 Ctrl+F5。
5. 重新打开对应的 11、12、13 号工作流。

短剧工作台 v1.1.4 | DMAD 四步加速与外部采样器

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

DMAD 官方插件：https://github.com/Yzmblog/DMAD

comfyui-AICG3D v1.1.4

本次更新为短剧工作台的全局设置节点增加外部采样器和外部 Sigma 调度接口，并接入官方 DMAD 四步加速节点。

1. 外部采样器与调度器

• MiniMax H3 Aicg 无限段落顺序生成（全局设置） 新增两个可选输入：
  • 外部采样器：SAMPLER
  • 外部调度器（Sigmas）：SIGMAS
• 连接外部节点后，实际采样优先使用外部采样器和外部 Sigmas。
• 外部 Sigmas 会覆盖内置调度器、步数和 denoise 截断。
• 不连接外部输入时，继续使用原来的采样器名称、调度器、步数和 denoise，兼容旧工作流。

2. 官方 DMAD 四步加速

• 已兼容官方 Yzmblog/DMAD 插件：
  • DMAD Sampler (re-noise)
  • DMAD Sigmas
• 官方推荐设置：
  • DMAD LoRA 强度：1.0
  • 步数：4
  • Sigmas：steps=4，shift=12
  • MiniMaxH3SigmaShift：shift_video=12，shift_audio=2
• DMAD 插件来源：https://github.com/Yzmblog/DMAD

3. 13 号 1.2 工作流

• 已加入 ModelSamplingMiniMaxH3，默认 shift_video=12、shift_audio=2。
• 已加入 DMAD Sampler (re-noise) 和 DMAD Sigmas。
• 三个节点已经连接到全局设置节点的外部输入。
• 工作流中的模型说明已补充 DMAD 官方安装来源和参数。

4. 兼容性

• 外部采样器接口是可选输入，不连接时不会改变原有采样行为。
• 安装 DMAD 工作流版本前，需要把 ComfyUI-DMAD 放入 ComfyUI 的 custom_nodes 目录。
• DMAD 是 Apache-2.0 项目，插件代码仍由原仓库维护。

5. 同步内容

• h3easy/aicg3d_sampler.py
• h3easy/nodes.py
• web/minimax_h3_easy_ui.js
• workflows/13.AICG3D_MiniMax H3 无限长视频生成工作流1.2.json
• 插件版本：1.1.4

升级方法

1. 更新本插件仓库。
2. 安装或更新 https://github.com/Yzmblog/DMAD。
3. 重启 ComfyUI。
4. 浏览器执行 Ctrl+F5 强制刷新。
5. 重新打开 13 号 1.2 无限长视频生成工作流。

短剧工作台 v1.1.3 | 无限时长视频的 MiniMax H3 工作流

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

搜索关键词：短剧工作台、无限时长视频的 MiniMax H3 工作流、ComfyUI MiniMax H3 无限长视频、MiniMax H3 本地短剧工作流。

comfyui-AICG3D v1.1.3

本次更新聚焦视频段落节点的编辑布局、资源库稳定性和多段拼接工作流的一致性。

1. 视频段落节点布局

• 提示词框改为占据节点的主要伸缩空间，拖高节点时优先扩展提示词编辑区。
• 添加资源库、打开下一段、删除这一段统一固定为底部 32px 操作栏。
• 修掉旧布局中操作栏占用约 228px，导致节点出现大面积空白的问题。
• 资源库展开时，提示词仍至少保留 160px 可编辑高度。
• 资源库面板最高 320px，素材较多时在资源库内部滚动。

2. 节点拖动与资源库开关

• 节点拖高后不会被资源库刷新逻辑强制缩回。
• 打开资源库后仍可自由调整节点宽高。
• 修复资源库收起后再次打开无响应的问题。
• 展开、收起、再次展开可以稳定循环。
• 修复资源库收起后节点底部残留大块空白的问题。

3. 抽卡与锁定功能移除

• 移除视频段落节点中的抽卡本段、锁定本段和复用上次结果入口。
• 移除对应缓存字段和前端缓存状态。
• 保留添加下一段、打开下一段和删除这一段。
• 避免局部重新生成破坏已经确认的多段拼接结果和接缝连续性。

4. 工作流同步

• 更新 workflows/13.AICG3D_MiniMax H3 无限长视频生成工作流1.2.json。
• 更新旧版 13 号无限分段工作流中的节点提示和操作说明。
• 移除工作流中已经废弃的抽卡说明。
• 同步最新视频段落节点尺寸与界面状态。

5. 插件内容

• web/minimax_h3_easy_ui.js
• h3easy/nodes.py
• workflows/13.AICG3D_MiniMax H3 无限长视频生成工作流1.2.json
• workflows/13.AICG3D_无限分段 生视频.json
• 插件版本：1.1.3

升级方法

1. 更新插件仓库或在 ComfyUI Manager 中更新。
2. 重启 ComfyUI。
3. 浏览器执行 Ctrl+F5 强制刷新。
4. 重新打开 13 号无限分段工作流。

节点输入输出接口保持兼容，现有工作流不需要重新搭建。

AICG3D H3 Suite v1.1.2

comfyui-AICG3D v1.1.2

本次更新修复外部资源库只接到第一段后，后续视频段落提示词中的素材引用无法稳定生效的问题。

资源库贯穿整条段落链

• 当 MiniMax H3 Aicg资源库 连接到第一段视频段落节点时，资源状态会自动同步到后续每一个视频段落节点。
• 第二段、第三段以及后续新增段落，都会获得同一份图片、音频和视频素材表。
• 后续段落的提示词可以继续使用 @图片1、@图片2、@视频1、@音频1 等引用，并在运行时对应到正确素材。
• 打开任意段落的节点内资源库，能够看到当前继承到的素材，不再显示为空。

独立资源与自动继承并存

• 没有单独设置素材的段落，自动继承上游资源库。
• 某一打开节点内资源库并增删、替换或排序素材后，该段会切换为独立资源。
• 独立资源会继续向下游段落同步，直到出现新的独立覆盖。
• 删除某一段后，资源状态会自动沿新的段落链重新传递。
• 新增下一段后，新段落会自动继承当前链尾资源。

运行可靠性

• 前端同步状态与后端段落继承逻辑同时生效。
• 即使直接运行带有外部资源库的 13 号工作流，后续段落也会拿到完整素材表。
• 13 号工作流已把外部资源状态写入三个视频段落节点，减少前端加载顺序造成的空资源窗口。

同步内容

• web/minimax_h3_easy_ui.js
• workflows/13.AICG3D_无限分段 生视频.json
• 插件版本：1.1.2

升级方法

1. 更新插件仓库。
2. 重启 ComfyUI。
3. 浏览器执行 Ctrl+F5 强制刷新。
4. 重新打开 13.AICG3D_无限分段 生视频 工作流。

AICG3D H3 Suite v1.1.1

comfyui-AICG3D v1.1.1

本次更新聚焦 MiniMax H3 无限分段视频的接缝质量、段落编辑体验和提示词工作流，并同步更新 13 号无限分段工作流与直接粘贴版提示词模板。

1. 跨段曝光与拼接质量

• 新增跨段接缝曝光修复：
  • 在每段开头匹配上一段尾帧的低频色光；
  • 使用有上限的加性亮度过渡；
  • 对整段直流亮度做受限对齐，避免一段亮、下一段暗、再下一段又亮。
• 修正接缝亮度平滑的业务顺序，修掉了拼接处约 0.1～0.2 秒的画面模糊。
• 推荐在“无限段落顺序生成（全局设置）”中保持：
  • 衔接帧数 = 22
  • 衔接方式 = 尾帧画面（RGB）
  • 曝光锁定 = 跨段曝光锁定

2. 每段独立资源库

• MiniMax H3 Aicg 视频段落 节点新增“添加资源库”。
• 资源选择区直接在视频段落节点内部展开，不再使用独立浮窗。
• 每一段可独立维护图片、音频和视频素材。
• 点击素材可直接把 @图片1、@视频1、@音频1 写进当前段落提示词。
• 当前段没有独立素材时，继续继承上一段或外接资源库，不会破坏原有工作流。

3. 段落链自动操作

• 新增“添加下一段”：
  • 自动创建新的视频段落节点；
  • 自动连接 上一分段 → 下一分段；
  • 自动把“最终合成视频”改接到新的链尾。
• 新增“删除这一段”：
  • 自动重接上一段和下一段；
  • 自动维持最终合成节点在段落链尾。

4. 提示词填入与编辑

• 修复“一键填入全部视频段落”后节点自动缩小的问题。
• 修复第一段连接“AICG3D 分段提示词解析”后提示词框只读、无法输入的问题。
• 在视频段落节点中直接输入、粘贴或插入素材引用时，会自动断开该段的外部提示词线，让手动内容生效。
• 批量填入继续支持段数、秒数和随机种子的顺序写入。

5. 视频段落节点尺寸锁定

• 点击“一键填入全部视频段落”不再改变节点尺寸。
• 打开 / 收起资源库不再自动展宽或改高。
• 输入提示词、引用素材、切换选中节点都不会自动改变段落节点尺寸。
• 只有手动拖拽节点边框时才会调整尺寸。
• 工作流中保存的段落节点高度同步更新为可用尺寸。

6. 无限视频提示词模板 V1

模板新增“直接粘贴模式”：

• 第一行必须是 【第1段｜X秒】；
• 最后一行以最后一段的 non_diegetic_music: 结束；
• 不输出“以下是提示词”“可直接粘贴”等前后缀；
• 不输出 Markdown 标题、字段反引号、分隔线或代码围栏；
• 整个回答可一次复制并直接粘贴到“AICG3D 分段提示词解析”；
• 单段可从 【第N段｜X秒】 复制到该段 non_diegetic_music 行，直接粘贴到对应视频段落节点。

7. 提示词资料更新

• 更新 H3 高密度战斗提示词技能与 15 秒战斗导演契约。
• 保留并同步数字人音频表演相关提示词资料。

8. 同步内容

• 插件代码：h3easy/、web/、aicg3d/ 相关前端与后端修复。
• 工作流：workflows/13.AICG3D_无限分段 生视频.json。
• 提示词模板：无限视频生成提示词模板V1.MD。
• 插件版本：1.1.1。

升级方法

1. 更新本插件仓库。
2. 重启 ComfyUI。
3. 浏览器执行 Ctrl+F5 强制刷新。
4. 重新打开或重新载入 13.AICG3D_无限分段 生视频 工作流。

节点 ID、输入输出接口和原有 13 号工作流结构保持兼容；现有工作流不需要重新搭建。

v1.1.0 — 渲染器实时预览 + LoRA 槽位 9 + 提示词方案中文扩充

渲染器跑起来就能看到画面：实时预览 + 百分比进度条

以前：AICG-渲染器（高级） 跑起来只有一个绿框。采样要好几分钟，不知道跑到第几步，也不知道画面对不对，只能等出片。

现在：节点底部多了一块预览区 + 一条进度条。

• 采样每一步刷新一次预览图（该步的 x0 潜空间预览），构图不对可以立刻中断，不用白等。
• 进度条带百分比、已用时间与剩余估计；解码 / 合成阶段没有可拆分的步数，用来回跑的亮条表示还在动。
• 说明：ComfyUI 自带的 latent 预览只画在 Vue 节点模式上，经典画布模式下这个节点一直看不到画面，所以这条通道是本插件自己实现的（新增 h3easy/render_progress.py）。
• 默认用 latent RGB 因子出图，看构图足够；想要更接近成片，把 设置 → 执行 → 预览方式 改成 taesd（需要 models/vae_approx/ 里有 taeh3 权重）。
• 预览显示的是视频 latent 的首帧；节点底部会固定留出预览区高度，所以节点比原来高一点。

加载器 LoRA 槽位 4 → 9

面板右下角的 − 1 + 现在最多能加到 9 / 9。

新增的槽位统一排在 非 H3 权重处理 之后追加，前面 14 个 widget 的位置一个没动 —— 旧工作流里的 LoRA 不会串位，不用重新接线。

提示词方案：官方 8 个风格开放中文 + 新增 5 个中文场景

• 官方 8 个风格方案（3D 动画短片 / 品牌宣传片 / 合作游戏开场 / 手绘实拍融合 / 极简产品广告 / 音乐视频字幕 / 纸张拼贴解说 / 纸艺定格解说）的正文是官方英文原文，这次把它们的可选语言放开到中文模式，中文界面下也能直接选。
• 新增 5 个中文场景方案：东方巨构导演、真实手机自拍 Vlog、光感小清新短片、超现实电影底图导演、15 秒剧情镜头导演。

非 H3 权重不再让整条链路报错

模型槽位里选到非 H3 权重（例如 Anima 这类图像模型）时：

• 自动回落（默认）：忽略它，改用另一条 H3 权重照常出片，控制台会说明实际用了哪条；
• 按所选加载：严格按你选的加载，不是 H3 就直接报错，方便排查；
• 已经探测过的权重会缓存，不会每次采样都重复读取。

其他修复与调整

• 采样 seed 支持完整 64 位，修掉 roll_inference_rng 缺失导致的崩溃。
• 与上游 ComfyUI-MiniMaxH3-Easy 同名撞车时，前端不再把上游那套节点改名 / 改分类 / 改配色。
• 界面：提示词输入框高度加到 4 倍、参考尺寸改成像素显示、去掉提示词框右下角的素材库按钮、工具栏图标放大。
• 目录整理：skills/ 下与 prompt_guides/ 重复的 4 套技能包已删除（内容与引用路径都在 prompt_guides/）；workflows/1-7 旧示例工作流已整理进 workflows/upstream/。

---

安装：把仓库放进 ComfyUI/custom_nodes/comfyui-AICG3D，重启 ComfyUI，然后 Ctrl+F5 强刷一次浏览器缓存。

v1.0.2 — 节点不再与上游同名 + 同步上游新功能

装了上游插件之后，本插件不再被顶掉

症状：装了 ComfyUI-MiniMaxH3-Easy 之后，本插件节点的左上角标签变成 MiniMaxH3-Easy，加载器面板里的 LoRA 槽位也不见了。

原因：两个插件注册的是同一批 Python 节点类名（MiniMaxH3EasyLoader、MiniMaxH3Easy……），ComfyUI 只保留其中一份 —— 被顶掉的那份会归到对方插件包名下，自己的字段也会丢。前端扩展名两边都叫 MiniMaxH3Easy，同样互相覆盖。

修复

• 本插件注册的节点 ID 统一加 AICG3D_H3 前缀：MiniMaxH3EasyLoader → AICG3D_H3Loader。
• 前端扩展改名 AICG3D.H3EasyUI，所有按类名匹配节点的代码一次性做换算。
• 启动时自动判断环境：
  • 没装同名插件（绝大多数用户）→ 沿用 MiniMaxH3Easy*，以前保存的工作流直接能开；
  • 装了同名插件 → 只用带前缀的 AICG3D_H3*，两边各归各的，不再互相顶掉。
• 控制台会打印当前用的是哪一套。

同步上游新功能

h3easy/nodes.py、web/minimax_h3_easy_ui.js 以旧版上游为基线做三方合并，落到新版上游上：

• SelfLift 采样策略（新增 sampling_strategies.py）：低分辨率起手、逐步升到目标分辨率；
• 上下文连续模式新增 Soft AV Prefix / Hard AV Prefix；
• 提示词优化支持按语言选指南，新增 文戏 / 动作 / 广告 三个中文方案；
• 提示词优化新增分段时长输入，多段时每段各自计时；
• 主节点继续保留本插件补上的 driving_audio 与 model 两条输出；
• 上游原版工作流放到 workflows/upstream/（含 SelfLift、Sigma Latent 放大、ClipProj 4B 等），原有工作流不变。

建议

两个插件二选一：本插件已经内置了上游那套节点与界面，把上游改名成 xxx.disabled 再重启 ComfyUI 最干净。装了也不会再互相破坏，但旧工作流里写死的 MiniMaxH3Easy* 会连到上游插件上。

v1.0.1 — 修复空白加载器节点

修复：装了 ComfyUI-MiniMaxH3-Easy 之后加载器节点空白

症状：MiniMax H3 Aicg 加载器 只剩标题和 h3_bundle 输出点，模型 / 编码器 / VAE 全都不见了。B站评论区不少人是这个情况。

原因：两个插件的 Python 节点类都叫 MiniMaxH3EasyLoader，ComfyUI 只会保留其中一个。上游那套只有 5 个控件（没有 LoRA 槽位），而界面脚本已经按本插件实现把原生控件隐藏了 —— “面板建不出来”叠加“原生控件已被隐藏”，结果就是一个空白节点。

这次改了什么

• 面板只把 4 个核心控件（模型 / 文本编码器 / 视频 VAE / 音频 VAE）当硬要求；一旦缺控件就不再隐藏任何原生控件，直接退回原生下拉。
• 新增 markWidgetVisible：面板初始化或挂载失败时，已被隐藏的原生控件自动还原，节点不会再变空。
• 面板被其他脚本整表重排 node.widgets 摘掉后会自动装回。
• 缺 LoRA 控件时，面板里的 LoRA 区域不再留一块点不动的空白。
• 启动时扫描 custom_nodes，发现同类节点包会在控制台打一段中英文提示。

建议：本插件已经内置了上游 ComfyUI-MiniMaxH3-Easy 的节点，两个插件二选一。把不用的那个目录改名成 xxx.disabled，再重启 ComfyUI。

---

安装：把仓库放进 ComfyUI/custom_nodes/comfyui-AICG3D，重启 ComfyUI，然后 Ctrl+F5 强刷一次浏览器缓存。

comfyui-AICG3D v1.0.0 — MiniMax H3 Aicg 统一创作工作台

comfyui-AICG3D v1.0.0 发布

把三套 ComfyUI 插件整合成一个 MiniMax H3 统一创作工作台：
一个加载器面板、一个素材库、一个技能库、一个提示词模板库，
加上一套能跑的提示词优化链路。

非官方项目。 与 MiniMax、上海稀宇科技有限公司及其关联公司没有任何隶属或背书关系。

---

一、这是什么

MiniMax H3 在 ComfyUI 里的原生链路节点多、连线杂、素材要手写 <Picture 1> 这种标签。
社区里已经有三套做得很好的插件分别解决了不同的问题，但它们互相不通用，
装在一起会出现三套加载器、三套路子。

comfyui-AICG3D 做的事很简单：把这三套合并成一套，统一节点菜单、统一面板、
统一素材与技能入口，并保留全部原有节点 ID —— 旧工作流导进来不需要重新接线。

具体合并内容与逐项改动见 与上游的差异。

二、代码来源与作者归属（请先读这一段）

这个插件不是从零写出来的。它的主体功能来自两位作者的开源项目，
本插件的贡献是"整合 + 界面 + 适配"。具体比例我们说清楚，不含糊：

来源	作者	许可证	在本插件中的实际分量
ComfyUI-MiniMaxH3-Easy	nkxx188	MIT	骨架。H3 主节点、素材加载器、渲染器与整体设计思路来自这里，本插件做了较大改动
Goohai-MiniMax-H3_Integration	goohai（B站 孤海FOTO）	GPL-3.0-or-later	提示词优化引擎 + 音视频解码。基本为原样使用：h3goohai/ 里 5 个文件一字未改，只有 prompt_optimizer.py、nodes.py 与前端做了少量适配
MiniMax-AI/MiniMax-H3	MiniMax 官方	MiniMax H3 Community License	提示词规范与风格技能。本插件做的是把 Agent 技能改造成 ComfyUI 节点可直接使用的方案
中文 AI 创作社区的提示词合集	各原始作者	未标注	prompt_presets/ 的 144 个模板，整理自社区公开流传的文档合集
comfyUI-llama-TE	tl2012tl	上游未附许可证	已移除。早期版本合并过它的本地 LLM 节点，因上游没有任何授权声明，本版把这部分代码整体删除；参考过的设计保留在下面的鸣谢里

逐文件的"原样复制 / 已修改"清单见
THIRD_PARTY_NOTICES.md，
完整鸣谢见 ACKNOWLEDGEMENTS.md。

为什么要写这一段：把别人的代码说成自己的，比用别人的代码严重得多。
这里面最值钱的提示词优化引擎是 goohai 写的，骨架是 nkxx188 写的，
我们只是把它们拼成了一个更好用的整体。

三、功能一览

1. 统一加载器：一个模型 + 可增减的 LoRA 槽位

MiniMax H3 Aicg Loader 的原生控件被换成一整块面板：

• 模型：只保留一个 H3 主模型下拉，参考模型 REF2VA 自动复用主模型，不再需要单独选。
• LoRA 槽位：默认 1 行，用 − 1 + 增减（最多 4 行），另有「清空」一键复位。
  每行都是可检索下拉，带缩略图、体积、底模与触发词提示，权重用滑块微调。
• LoRA 直接叠加在 loader 内部，不必再外挂 LoraLoaderModelOnly 节点。
• 面板顺序固定为 模型 → 编码与 VAE → LoRA，原生控件隐藏。

兼容性：fl2va_model / ref2va_model / text_encoder / video_vae / audio_vae
五个 widget 仍按原顺序排在最前，旧工作流里保存的值不会错位。

2. 素材库：点一下就 @ 进输入框

• 素材加载器里的缩略图单击即把 @图片1 之类的引用写进下游主节点的提示词编辑器
  （原本只能拖拽排序）。
• 提示词编辑器右下角新增 ▤ 素材库：按「可引用素材 / 输入目录」分页浏览，
  单击即插入引用。
• 输入目录里的素材会自动补进素材加载器后再引用，也可以直接「上传并引用」。

3. 技能库：把所有创作方法收进一个入口

• 18 个技能包 + H3 场景方案合并成一个技能目录，同名方案自动配对，
  同时携带 skill_id 与 guide_id。
• 提示词编辑器新增 ◆ 技能库：全部 / H3 场景方案 / 通用技能三类，
  点选即用 —— H3 方案会直接切换主节点的提示词方案，其余技能把正文写入提示词。
• 修好了因为目录名是中文而扫描不到的技能（手机 Vlog、天宫仙境、超现实关键帧等）。

4. 提示词模板库：144 份模板进面板

• 社区提示词合集整理后抽出 144 个模板、8 个分类，正文约 90 万字。
• 技能库面板新增 提示词模板 页签，配分类胶囊筛选，卡片显示字数与来源。
• 点选即写回节点，或直接粘贴进提示词编辑器。

分类：H3 专题 21 · 视频生成与运镜 7 · 分镜与剧本 16 · 人像写真 15 ·
古风仙侠东方 18 · 画风与插画 15 · 生图模板与反推 37 · 提示词工程 15

5. 提示词优化：本地模型或云端 API，二选一

一键把一句话扩写成 H3 可用的完整提示词。

• 本地模式：加载 GGUF 视觉模型在本机推理，不外发任何内容。
• 云端模式：支持 OpenAI / Google Gemini / OpenRouter / 阿里云 DashScope /
  硅基流动 SiliconFlow / RunningHub，密钥自备。
• 只发送真正引用到的素材：提示词里没有 <Picture N> 之类的引用时，
  一律不附带任何附件，附件计数同步归零；写了引用时，只把被引用的素材送出去。

6. 采样与渲染：把链路收短

• AICG-采样器（高级）：把 RandomNoise / BasicScheduler / KSamplerSelect /
  BasicGuider / SamplerCustomAdvanced 五个节点合成一个，只留一个 LATENT 输出，
  可直接接解码节点。执行逻辑与原生 SamplerCustomAdvanced 一致。
• AICG-渲染器（高级）：一条龙出片，单条输出线。

7. 界面

所有自定义面板共用一套深色玻璃主题，蓝紫渐变强调色，12px 信息密度；
三个来源的节点按分组染不同标题色，画布上一眼可辨。
备注节点（Note / Markdown Note）默认改用系统深灰配色，不再是前端硬编码的黄色
（可在 设置 → AICG3D 里关掉）。

四、安装

cd ComfyUI/custom_nodes
git clone https://github.com/JGRFW/comfyui-AICG3D.git

重启 ComfyUI。

前置条件

• 需要包含 MiniMax H3 官方节点的较新版本 ComfyUI。
• 模型权重不随本插件分发，请自行准备 H3 主模型、文本编码器、VAE。
• 使用提示词优化的本地模式需要装 llama-cpp-python（见上游
  llama-cpp-python）。

五、快速上手

1. 添加 MiniMax H3 Aicg Loader，在面板里选模型（需要 LoRA 就点 +）。
2. 添加 MiniMax H3 Aicg资源库，把图片 / 视频 / 音频拖进去。
3. 添加 MiniMax H3 Aicg，在提示词编辑器里：
   • 点缩略图或 ▤ 素材库 → 插入 @图片1；
   • 点 ◆ 技能库 → 挑一个技能或 H3 场景方案；
   • 需要扩写就点提示词优化。
4. 接上采样与解码，运行。

六、示例工作流

workflows/ 随仓库提供 11 个示例：

文件	用途
1.MiniMax_H3_Easy.json	基础链路（文生 / 图生 / 首尾帧 / 参考生视频 / 数字人）
2.MiniMax_H3_Easy_Pass2.json	二采
3.MiniMax_H3_Easy_Selected_Video_Refine.json	选定视频再精修
4~7.*Context_Segments*.json	分段长视频：上下文传递 / Latent 二采 / 像素二采 / 控制
8.AICG3D_Smoke_Test.json	冒烟测试
9.AICG3D_合并采样器_测试.json	合并采样器链路
10.AICG3D_渲染器_测试.json	渲染器（高级）
11.AICG3D_测试样板.json	综合样板

部分示例依赖第三方节点：KJNodes、VideoHelperSuite、pysssss ShowText、
Memory Cleanup、Easy-Use，以及提供 MiniMaxH3AVDecodeT8 的 T8 解码插件。
缺哪个装哪个，具体以工作流里标红的节点为准。

七、与上游的差异

项	上游	本插件
节点归属	三套插件各自一个菜单	统一收敛到 AICG3D 命名空间
节点显示名	MiniMax H3 Easy …	MiniMax H3 Aicg …（节点 ID 不变）
加载器	原生 combo 控件	自绘面板 + 多 LoRA 槽位
素材引用	拖拽排序	单击 @ 进提示词 + 素材库面板
技能	分散在 skills/ 与 prompt_guides/	合并成一个技能库 + 面板
提示词模板	无	144 个模板 + 分类面板
采样	五个节点连线	AICG-采样器（高级）一个节点
提示词优化附件	全部素材一起发送	只发送提示词真正引用到的素材

八、开源许可

自有代码按 GPL-3.0-or-later 发布（因为整合了 GPL-3.0-or-later 组件），
全文见 LICENSE。

组件	许可证
h3easy/、web/minimax_h3_easy_ui.js	MIT（nkxx188）
h3goohai/、web/minimax_h3_integration.js、locales/	GPL-3.0-or-later（goohai）
skills/、prompt_guides/ 中的 MiniMax 官方提示词内容	MiniMax H3 Community License
prompt_presets/	未标注，版权归各原始作者

许可证原文在 third_party/，逐项声明与修改清单在
THIRD_PARTY_NOTICES.md。

使用 MiniMax 官方提示词内容时请注意其许可的地域限制（不含欧盟、英国、韩国、美国）、
商业规模条款与 Acceptable Use Policy。不接受这些限制时：

git rm -r skills prompt_guides

不需要社区提示词模板时：

git rm -r prompt_presets

两个目录删掉后插件仍正常运行，对应的库会显示为空。

九、隐私与联网

场景	是否会外发数据
不使用提示词优化	不会，插件不联网
提示词优化 · 本地 GGUF 模式	不会
提示词优化 · 云端模式	会把提示词与所选附件素材发送到你配置的服务商

云端模式下，密钥、调用费用与数据处理由你自行负责，并适用对应服务商的条款与隐私政策。

十、鸣谢

完整版见 ACKNOWLEDGEMENTS.md。

项目	作者	贡献
ComfyUI-MiniMaxH3-Easy	nkxx188	整个骨架：主节点、素材加载器、渲染器，以及把几十个节点收敛成一个主节点的设计
Goohai-MiniMax-H3_Integration	goohai（B站 孤海FOTO）	提示词优化引擎（云端 API + 本地 GGUF 双引擎）与音视频潜空间解码
MiniMax-AI/MiniMax-H3	MiniMax	公开了 H3 五种生成模式的提示词规范与官方风格技能
comfyUI-llama-TE	tl2012tl	本地推理与多轮对话的开源工作（本版未包含其代码，但参考了设计）

还要谢谢所有在社群里无偿分享提示词、教程与排错经验的人 ——
这个插件里很多"少走弯路"的部分，是别人已经踩过一遍并且愿意讲出来。

十一、免责声明

1. 非官方。本插件为第三方非官方项目，与 MiniMax、上海稀宇科技有限公司及其关联公司
   无任何隶属、合作、赞助或背书关系，未获其审核或认可。
2. 商标。MiniMax、MiniMax H3、ComfyUI、Qwen、Gemma、RunningHub
   等名称与标识归各自权利人所有，本插件仅在描述兼容性所必需的范围内使用。
3. 按现状提供，不提供任何担保。因使用或无法使用本插件造成的任何直接、间接、
   附带或后果性损失（含数据丢失、设备损坏、业务中断、收益损失），
   作者与贡献者不承担责任。
4. 合规责任在使用者。生成内容的合法性、真实性，以及是否侵犯他人肖像权、名誉权、
   著作权、商标权，由使用者自行判断并承担全部责任。
5. 禁止用途。请勿用于生成违法、侵权、色情、暴力或虚假信息内容，
   请勿未经许可使用他人肖像与声音。
6. 第三方 API。云端模式会外发数据，密钥与费用自负，详见第九节。
7. 模型与素材不在本仓库。模型权重需自行获取并遵守其各自许可证；
   你上传或引用的素材，由你保证其合法来源与授权。
8. 第三方提示词内容。prompt_presets/ 等内容的版权归各原始作者，
   本仓库不作权利主张；权利人要求移除时我们会立即处理。
9. 不保证兼容与持续更新。ComfyUI 版本迭代较快，不承诺在任意版本、
   任意硬件下都能工作，也不承诺技术支持。
10. 商业使用。GPL-3.0-or-later 允许商业使用，但要求以同样许可证开放衍生作品源码。

完整免责声明见 RELEASE.md。

十二、反馈

问题、建议、权利人移除请求都欢迎提 issue。
接受第三方内容进入本仓库这件事，我们持开放态度 —— 说清诉求即可。

---

附：v1.0.0 更新日志

• 合并三套插件为统一节点菜单，节点 ID 全部保持原样
• 加载器改自绘面板，支持 1–4 个 LoRA 槽位与检索式下拉
• 素材库：单击 @ 引用、输入目录直传
• 技能库：18 个技能包 + H3 场景方案合并，中文目录名可识别
• 提示词模板库：144 个模板 / 8 个分类
• 提示词优化：只发送被引用的素材；本地 GGUF 参考图降采样，不再撑爆上下文
• 新增 AICG-采样器（高级）、AICG-渲染器（高级）
• 统一深色主题；备注节点改用系统配色
• 适配 comfyui-frontend 1.51 / ComfyUI 0.35 的 V3 节点接口

完整更新说明与逐条修复记录见 README.md。