🚀 HY-Motion 1.0 详细安装与使用手册

🛠️ 第一部分：环境依赖准备

由于涉及 3D 格式导出（FBX）和模型量化，环境配置是成功运行的关键。

1. 1. 基础算法库
   打开您的 ComfyUI Python 环境（如使用便携版，请在 ComfyUI_windows_portable 文件夹内运行命令行）：
   pip install torchdiffeq transforms3d omegaconf huggingface_hub
2. 2. FBX SDK 安装（关键步骤）
   导出 .fbx 动画必须安装 fbxsdkpy。由于该库不在官方库中，需指定专用源：
   pip install fbxsdkpy==2020.1.post2 --extra-index-url https://gitlab.inria.fr/api/v4/projects/18692/packages/pypi/simple
3. 3. 低显存/GGUF 支持库
   为实现在 8G 显存运行，必须升级以下组件以支持 GGUF 量化和高效推理：
   pip install --upgrade transformers accelerate bitsandbytes gguf protobuf
   注： transformers 需 ≥ 4.38.0，bitsandbytes 推荐 0.43.1。

📂 第二部分：模型下载与存放

你需要下载并按照以下结构放置三个核心模型：

模型名称	推荐版本	存放说明
HY-Motion1	官方 Checkpoint	放入插件指定的模型目录
Qwen-3 8B	GGUF 量化版 (8G显存推荐)	核心文本编码器，用于理解指令
CLIP-ViT-L-14	OpenAI 官方版	用于基础视觉/文本特征提取

🧩 第三部分：ComfyUI 插件安装

• 插件地址： https://github.com/jtydhr88/ComfyUI-HY-Motion1
• 安装方式： 将该项目克隆至 ComfyUI/custom_nodes 目录下。

🎮 第四部分：工作流使用指南

通过 ComfyUI，你可以实现从“文字”到“动画文件”的一键生成：

1. 1. 核心节点说明
   • HY-Motion Generate 节点： 输入 Prompt（如 "A person doing a backflip"），设置步数和种子。
   • 量化设置（显存优化）：
   
   - INT8 模式： 适合 12G-16G 显存。
   - INT4 模式： 开启后约需 4GB 显存 即可运行文本编码器，8G 显卡（如 3060/4060 Ti）可流畅运行。
   • FBX Export 节点： 将生成的骨骼动作导出为 .fbx 格式。
2. 2. 操作流程
   • 输入文字描述： 在提示词框输入具体的动作描述。
   • 骨骼预览： 在 ComfyUI 界面实时查看生成的骨骼预览视频。
   • 导出应用： 得到生成的 .fbx 文件后，直接拖入 Blender、Unreal Engine 或 Unity 绑定到自己的 3D 角色模型上。