EED-EXPER-029 · MiniMax H3 AMD部署全纪录（7900XTX马赛克根因确诊+Windows出路）

eererdan/experience/EED-EXPER-029.hdlp

@@ -0,0 +1,104 @@
+# EED-EXPER-029 · MiniMax H3 本地部署全纪录（AMD 7900XTX 马赛克根因 + Windows 出路）
+
+> HLDP://cang-ying/eererdan/experience/EED-EXPER-029
+> 耳耳蛋 ICE-GL-耳耳蛋 · PTS-VA-001-EED
+> D156 · 2026-08-05 · 苍耳爸爸共同攻坚
+> 国作登字-2026-A-00037559
+
+---
+
+HLDP://eererdan/experience/029
+├── trigger: 任何在 AMD 7900XTX/Linux/ROCm 上跑 MiniMax H3 出马赛克时
+├── emergence:
+│   ├── 旧: H3 刚开源(2026-08-03)就部署, 一路踩坑
+│   ├── 过程: 能跑→马赛克→排查→确诊"RDNA3量化算子bug"
+│   └── △=从「瞎调配置」→「证据链确诊 + Windows出路」
+├── lock:
+│   ├── ⊢ 本经验 = H3 AMD 部署完整结论
+│   └── ⊢ 本地Linux暂无法解决, 出路=Windows/新ROCm
+└── why: 避免下次在 Linux/7900XTX 上重复 2 天排查
+
+---
+
+## §0 · 一句话结论
+
+**MiniMax H3 在 AMD 7900XTX (RDNA3/gfx1100) + Linux ROCm 7.2.4 上：能跑但画面马赛克（DiT 量化算子算错），本地无解（ROCm 已最新）。有人用 Windows + ROCm 7.14 + RX 7800XT 跑通视频正常 → 出路在 Windows 或更新 ROCm。**
+
+## §1 · 环境与配置（官方要求）
+
+**机器**: AMD 7900XTX (gfx1100, RDNA3) 24G / Ryzen 7 7800X3D / 32G RAM / ROCm 7.2.4 / torch 2.13.0+rocm7.2 / ComfyUI master(1868372d)
+
+**官方模型文件**（Comfy-Org/MiniMax-H3 @ HF/ModelScope）:
+- DiT: `minimax_h3_fl2va_pruned_int8_convrot.safetensors` (21G, 932 keys)
+- TE: `qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors` (15.7G, 2054 keys)
+- VAE: `minimax_h3_video_vae_fp16.safetensors` (5.2G) + `minimax_h3_audio_vae_fp32.safetensors` (0.6G)
+- 摆放: models/diffusion_models/ + models/text_encoders/ + models/vae/
+
+**官方工作流**（video_minimax_h3_t2v.json，本地模板+GitHub一致）:
+- UNETLoader(DiT int8) + CLIPLoader(TE nvfp4, type=minimax) + 双VAELoader
+- MiniMaxH3ImageToVideo(官方prompt, 1344x768, length=124)
+- KSamplerSelect(res_multistep) + BasicScheduler(simple,20) + SamplerCustomAdvanced
+- VAEDecode + VAEDecodeAudio → CreateVideo(fps=24) → SaveVideo
+
+**启动参数**（动态显存方案，LTX笔记验证过）:
+`python main.py --listen 127.0.0.1 --port 8188 --disable-pinned-memory --enable-dynamic-vram --fast-disk --vram-headroom 3 --async-offload`
+
+## §2 · 完整踩坑清单（血泪）
+
+1. ❌ RH(RunningHub)第三方节点路径 → ✅ ComfyUI 原生节点（RH的DirectLoader爆内存）
+2. ❌ nvfp4 初次加载报 utf-32-be 错 → ✅ 升级 comfy-kitchen 0.2.23→0.2.26 解决（rot_dim 参数）
+3. ❌ 依赖版本没对齐 → ✅ comfy-kitchen==0.2.26 + comfy-aimdo==0.4.11（requirements精确核对）
+4. ❌ 双设备(HIP核显gfx1036)拖累 → ✅ 屏蔽核显 ROCR_VISIBLE_DEVICES=0（HIP注册with WMMA）
+5. ❌ GGUF 版(leejet) → ✅ 放弃（是stable-diffusion.cpp格式，ComfyUI报Unknown model architecture）
+6. ❌ 无参数裸启动 → ✅ 需 --lowvram/动态显存 参数（32G内存跑H3必须）
+7. ❌ I2V路径 → ComfyUI SIGABRT崩溃（内存66.9G峰值超限，swap加106G后能跑但画面仍马赛克）
+8. ✅ VAE全零latent测试正常（证明VAE/解码没问题）
+
+## §3 · 马赛克确诊证据链（核心）
+
+| 测试 | 结果 | 结论 |
+|---|---|---|
+| 官方配置 T2V 1344×768 | ✅能跑完 ❌马赛克 | DiT 输出雪花 |
+| int8/nvfp4 TE 各种组合 | 都马赛克 | 与TE选择无关 |
+| euler/res_multistep | 都马赛克 | 与采样器无关 |
+| HIP/eager 后端 | 都马赛克 | **不是HIP后端bug**（纯PyTorch也错）|
+| 640×352~1344×768 | 都马赛克 | 与分辨率无关 |
+| swap 56G→106G | 画面仍马赛克 | **不是内存不足** |
+| VAE 全零latent | ✅正常 | VAE/解码无问题 |
+| 崩溃报告(I2V) | SIGABRT VmPeak=66.9G | 内存不足是真的, 但非马赛克原因 |
+
+**最终结论**: 马赛克 = **H3 DiT 前向在 RDNA3 (gfx1100) 的量化算子上算错**（HIP/eager 都错），与配置/参数/内存无关。
+
+## §4 · 关键对比：为什么别人能跑通
+
+GitHub issue #15283（视频正常）用户环境:
+```
+Windows + AMD RX 7800 XT (RDNA4, 16GB) + ROCm 7.14 + 64GB RAM
+PyTorch 2.12.0+rocm7.14.0 + ComfyUI 0.30.1 Desktop
+官方模板原样 + nvfp4 + INT8 → "Video generation works great"
+```
+
+**差异**: Windows + ROCm 7.14（新）+ RDNA4。**Linux ROCm 最新只有 7.2.4（无更高可升），PyTorch rocm7.2 最高 2.13.0（已用）**。→ **Linux 上无解，出路 = Windows 或等新 ROCm。**
+
+## §5 · Windows 部署指引（给爸爸睡醒用）
+
+1. 装 ComfyUI Desktop 或手动装（Windows 便携版）
+2. PyTorch: `pip install torch --index-url https://download.pytorch.org/whl/rocm7.14`（Windows ROCm）
+3. 模型文件：上面 §1 的 4 个文件（从 ModelScope 下载快）
+4. 用官方模板 video_minimax_h3_t2v.json 原样跑（Web UI 加载）
+5. 若音频爆音 → 已知 issue #15283（官方在修），视频正常即可用
+6. 7900XTX 是 RDNA3：**如果 Windows 上也马赛克 → 实锤 RDNA3 算子 bug**（与系统无关）；如果正常 → 就是 ROCm 7.14 修了
+
+## §6 · 经验要点
+
+- 排查"能跑但画面错"要用证据链（VAE测试/后端对照/崩溃报告），不是瞎调配置
+- 内存不足的症状=崩溃/卡死/换页，不是"画面雪花"；画面雪花=计算错
+- 新开源模型(2天内)的 AMD 支持 = Experimental（官方文档），先查社区 issue 再折腾
+- 下载大模型优先 ModelScope（国内快），大文件用 aria2 16段（curl单线程会断）
+- 面板进度框已集成（eed_web.py + eed_web_opencode.py 的 h3_progress + #h3bar）
+
+---
+
+> ⊢ 耳耳蛋 ICE-GL-耳耳蛋 · PTS-VA-001-EED
+> ⊢ D156 · 2026-08-05 · 国作登字-2026-A-00037559
+> ⊢ 关联: EED-MEMO-007/008 · ltx_test_hardware.md · project_h3_local_24g_feasible.md

eererdan/experience/EED-EXPER-INDEX.hdlp

@@ -1,8 +1,9 @@
 # EED-EXPER-INDEX.hdlp · 经验库索引（自动维护）
 
 > 倒序 · 最新的在上面 · 蛋蛋醒来扫一眼就知道手里有什么牌
-> 最后内化: 2026-08-04 D206
+> 最后内化: 2026-08-05 D156
 
+- EED-EXPER-029.hdlp | EED-EXPER-029 · MiniMax H3 AMD部署全纪录·7900XTX马赛克根因确诊+Windows出路（苍耳爸爸攻坚）
 - EED-EXPER-028.hdlp | EED-EXPER-028 · BGM背景音乐方法论·功能分类+衔接位+片尾曲（苍耳爸爸亲授）
 - EED-EXPER-027.hdlp | EED-EXPER-027 · 人物一致性·角色板(电影级)补充+不可直接当参考图（苍耳爸爸亲授·校正025）
 - EED-EXPER-026.hdlp | EED-EXPER-026 · 人物配音一致性·参考音频+提示词/音频分离固定音色（苍耳爸爸亲授）