nkxx188/ComfyUI-MiniMaxH3-Easy

解決的問題

本專案為在 ComfyUI 中使用 MiniMax H3 影片生成模型提供簡化的高階介面。它以一個精簡的「Easy」節點取代複雜的多節點設定，該節點可管理提示詞、媒體輸入與模型設定，同時保持與 ComfyUI 生態系統其餘部分的相容性，以進行取樣與後處理。

如何運作

系統以核心「Easy」節點為中心，處理文字轉影片、圖片轉影片以及參考式影片生成的核心邏輯。

• 媒體處理：使用獨特的多連結 Media 埠，允許將影像、影片與音訊連接到單一輸入，節點隨後獨立編號並追蹤它們。
• 提示詞：提供結構化編輯器，支援透過 @ 引用連接的媒體與透過 # 對話區塊表示的語音／歌詞，這些內容將被轉換為 MiniMax H3 所需的特定標籤。
• 提示詞優化：可選的內建工具可透過外部 API（OpenAI、Gemini）根據模式感知指南重寫提示詞，以提升生成品質。
• 模型管理：內建載入器處理必要的轉換器、文字編碼器與 VAE，但為希望使用自訂載入器（包含 GGUF 變體）的使用者提供「Model Bridge」。
• 雙通道工作流程：包含專用的第二通道條件節點，可在不產生關鍵幀錯位問題的情況下實現高解析度精煉。

適用對象

希望無需手動設定數十個節點即可使用 MiniMax H3 影片生成功能的 ComfyUI 使用者，以及需要對 AI 影片中的參考媒體與對話進行精確控制的創作者。

主要亮點

• 統一媒體埠：透過不同線路顏色與快速建立選單，將多個影像、影片與音訊片段連接到一個埠。
• @ 引用編輯器：使用選擇器輕鬆在提示詞中為連接的媒體標記。
• 對話區塊：專用語法用於建立對話與歌詞，生成過程中可保持原樣。
• API 驅動提示詞優化器：整合 OpenAI 與 Gemini 支援，使用特定 H3 場景指南重寫提示詞。
• 第二通道精煉：專為改變解析度的第二通道設計的工具，以維持構圖與時間一致性。
• 彈性模型載入：支援內建載入與自訂模型橋接，相容 GGUF 與 safetensors 檔案。