1. 完全退出 ComfyUI

   关闭 ComfyUI 窗口，并确认后台 Python 进程已经结束。

2. 移除旧版本

   如果已有旧版 custom_nodes/closerAI-3Dbody，先移到 custom_nodes 目录之外备份。

3. 解压并确认目录名称

   将下载的 closerAI-3Dbody ZIP 安装包解压到 ComfyUI/custom_nodes，并把最终文件夹命名为 closerAI-3Dbody。

   ComfyUI/
   └─ custom_nodes/
      └─ closerAI-3Dbody/
         ├─ __init__.py
         ├─ api/
         ├─ nodes/
         ├─ runtime/
         ├─ third_party/
         └─ web/

4. 使用 ComfyUI Python 安装依赖

   在 ComfyUI 根目录打开 PowerShell。标准便携包可使用：

   python_embeded\python.exe -m pip install -r ComfyUI\custom_nodes\closerAI-3Dbody\requirements.txt

   如果整合包的 Python 位于根目录下的 python 文件夹，则使用：

   python\python.exe -m pip install -r custom_nodes\closerAI-3Dbody\requirements.txt

5. 启动并刷新浏览器

   重新启动 ComfyUI。首次加载完成后，在浏览器中按 Ctrl + F5 强制刷新前端扩展。

1. 选择输入方式

   点击中间栏“上传图片”，或把其他节点的 IMAGE 输出连接到本节点。原图会按完整高度等比显示。

2. 选择人物与质量

   单人图片选择“主体人物”；多人处理需要选择“所有人物”并提供独立人物遮罩。重建质量可选择标准、高质量或最高。

3. 设置模型与外观

   “图像重建人体”保留当前人物体型；“默认 Xbot 人体”把姿势迁移到标准角色。“生成蒙皮外观”只影响照片颜色投影，默认关闭，不影响骨骼姿势编辑。

4. 点击开始构建

   “开始构建”只运行 closerAI-3Dbody，不会触发整个 ComfyUI 工作流。第一次运行需要加载模型，耗时通常更长。

5. 查看与复用结果

   右侧可旋转、缩放三维人体；“视角复位”会按当前姿势重新完整居中。生成历史最多保留 12 条，可多次换图并恢复最近结果。

ComfyUI/models/sam3dbody/
├─ model.safetensors
└─ assets/
   └─ mhr_model.pt