jtydhr88/ComfyUI-HY-Motion1

解決的問題

本專案提供一個 ComfyUI 插件，可從文字描述生成 3D 人類動作。透過自動化動作生成、提示優化以及導出至 GLB 和 FBX 等產業標準格式，簡化 3D 動畫的製作流程。

工作原理

此插件整合了 HY-Motion 1.0 模型，用於文字轉動作生成。其採用由文字編碼器（基於 Qwen3-8B LLM）與動作擴散網路組成的流程。為提升效果，內建「提示重寫」功能，利用 LLM 優化使用者輸入並估算所需動作時長。生成的動作隨後透過多個節點進行預覽（2D 骨骼或互動式 3D 查看器）與匯出。

適用對象

使用 ComfyUI 並希望無需手動關鍵幀即可生成人類動作序列的 3D 動畫師、遊戲開發者與 AI 研究人員。

主要亮點

• 文字生成動作：直接從文字提示生成 3D 人類動畫。
• LLM 驅動的提示優化：自動重寫提示並估算動作時長，以提升生成品質。
• 彈性匯出：支援透過前端匯出 GLB，以及透過自訂 Mixamo 角色重定向匯出 FBX。
• 記憶體優化：支援 GGUF、AWQ 與 BitsAndBytes 量化，可在低 VRAM 顯卡上運行，並可選擇將 LLM 卸載至 CPU。
• 互動式預覽：內建基於 Three.js 的 3D 查看器，支援播放控制與骨骼/網格切換。