CLOSERAI Motion Studio 教程：调整相机、检查运动、输出预演

01 / OVERVIEW这个节点能做什么

Motion Studio 是嵌入 ComfyUI 的三维镜头预演工作台。你可以设置相机焦段、画幅和运动，安排角色走位、姿态、场景与灯光，在时间线上检查变化，并输出当前取景器里的 RGB 动画。

基础三维编辑与预演不要求调用云端大模型。AI 辅助、视觉分析、提示词处理和最终视频生成属于额外功能，需要相应服务或模型；不影响先完成基础预演。

02 / INSTALLATION安装：复制完整节点包，再重启

安装前准备

• 可正常启动的 ComfyUI。建议更新到包含原生 VIDEO、Save Video 和 Get Video Components 的版本。
• Python 3.10 或更新环境；使用 ComfyUI 自身的 Python，无需为已构建节点另建前端开发环境。
• 建议使用近期版本的 Chrome 或 Edge，并开启浏览器硬件加速。三维预览依赖 WebGL，视频编码能力也与浏览器有关。
• 优先在本机通过 http://127.0.0.1:8188 或实际启动地址访问。端口以你的 ComfyUI 为准。

步骤 1：找到正确的文件夹

如果拿到的是完整开发项目，使用其中的 comfyui_node 文件夹；如果拿到的是已打包节点，直接使用解压后的完整节点目录。将它放入 ComfyUI 的 custom_nodes，建议命名为 closerai_motion_studio。

ComfyUI/
└─ custom_nodes/
   └─ closerai_motion_studio/
      ├─ __init__.py
      ├─ node.py
      ├─ README.md
      ├─ web/
      │  └─ closerai_motion_studio.js
      └─ studio/
         ├─ index.html
         └─ assets/       （及包内其余资源，全部保留）

步骤 2：完整重启 ComfyUI

停止 ComfyUI 后重新启动，检查启动终端是否有该节点的导入错误。打开浏览器后按 Ctrl + F5 强制刷新，加载新的节点定义和前端扩展。

步骤 3：添加节点

在画布双击搜索 CLOSERAI Motion Studio，或从节点菜单 CLOSERAI / Motion 中添加。当前版本在节点内部显示工作台，不需要再启动 Vite，也不需要打开独立弹窗。

只有源码、没有 studio/index.html 时

这通常表示前端尚未构建。开发者可在项目根目录安装依赖并构建，然后再复制构建完成的 comfyui_node。普通用户使用包含前端资源的完整安装包即可。

npm ci
npm run build

本节点包没有单独的 requirements.txt 安装步骤；依赖 ComfyUI 提供的服务与原生视频 API。基础取景器预演不需要先安装 MiniMax H3 等生成模型。

03 / QUICK START第一次使用，先确认视频能输出

1. 添加 Motion Studio 节点，放大节点，等待工作台与三维场景加载完成。
2. 选择一个简单镜头，时长先设为 3–5 秒，保持 16:9，少量人物与道具。
3. 播放预览，确认取景器里能看到主体。先不配置 AI 服务和额外生成工作流。
4. 添加原生 Save Video，把 Motion Studio 的 video 输出连接到它的 video 输入。
5. 点击 ComfyUI 的运行 / Queue。保持当前浏览器页面开启，等待取景器完成渲染和视频回传。
6. 回传成功后工作流继续执行。检查 Save Video 的保存结果。

04 / WORKSPACE先认清舞台与取景器

相机参数从哪里开始调

先用 35mm 观察全局，再根据需要切换 18 / 24 / 50 / 85 / 135mm。同时调整机位、景别与主体距离，不要仅靠焦段解决所有构图问题。运镜可从静止或缓慢推进开始，再尝试平移、升降与环绕。

画幅支持 16:9、2.39:1、9:16、1:1 等界面选项。改变画幅后要重新检查构图，尤其是横屏改竖屏时人物是否被裁切。

05 / FIRST SHOT实操：五秒人物走向桌子，相机缓慢推进

这是一个练习方案。目标是确认人物路线、相机运动和最后构图，不需要一开始就制作精细场景。

1. 建立简单镜头。选择或新建一个镜头，时长设为 5 秒，画幅 16:9。保留一名人物和一张桌子，移走不需要的对象。
2. 切换分屏。一边观察三维舞台的位置关系，一边看取景器最终构图。
3. 安排相机。选择 35mm，先让人物与桌子都能入画。运镜类型选择推进，设定起始位置和结束位置，推进幅度先小一些。
4. 安排人物。选中人物，选择行走动作，设置从桌子左侧走到桌边的起止位置，并调整朝向。路线要绕开桌子，人物不能穿过道具。
5. 检查三个时间点。开头交代空间关系，中间检查遮挡，结尾检查人物是否出画。需要改变中途姿态或位置时，再增加或调整关键帧。
6. 一次只改一个变量。例如人物被桌子挡住，先调整人物路线；人物太靠画面边缘，再调整相机终点，避免同时改动后无法判断原因。
7. 点击“渲染预演”。等待完成后下载检查。确认方向正确，再连接视频输出并运行后续工作流。

06 / WORKFLOW OUTPUT三个输出端口，分别怎么接

方案 A：直接保存视频

CLOSERAI Motion Studio
  video [VIDEO] ──→ Save Video
                     video 输入

方案 B：拆成图像帧继续处理

CLOSERAI Motion Studio
  video [VIDEO] ──→ Get Video Components
                     images [IMAGE] ──→ 后续图像 / 视频处理节点
                     fps            ──→ 需要帧率的输入
                     audio          ──→ 仅在源视频有音轨时使用

当前取景器 RGB 预演没有音轨，不要把 audio 当作必有输出。VIDEO 也不能直接接到只接受 IMAGE 的端口，需先拆帧。

方案 C：交给接受文件路径的节点

CLOSERAI Motion Studio
  video_path [STRING] ──→ 接受视频文件路径的节点

确认该节点读取的是 ComfyUI 所在电脑上的路径。部分“加载视频”节点只接受下拉选择或上传文件，并不开放路径输入，不能强行连接。

点击“运行”后发生什么

自动渲染针对连接了 video 或 video_path 输出的启用节点。每次通过浏览器运行会重新渲染当前镜头，避免编辑后沿用旧视频。只使用 shot_json 不触发这条视频预渲染流程。

默认视频文件保存在 ComfyUI/output/closerai_motion_studio/；如更改了 ComfyUI 输出目录，则以实际配置为准。Save Video 可能另外生成一份保存文件，这是两个不同保存步骤。

07 / ADVANCED预演跑通后，再用额外导出功能

进入“渲染和导出工作室”，可以按需要使用 RGB、OpenPose、深度等导出选项、相机矩阵与提示词相关工具。这些属于工作台中的额外导出能力，当前主节点没有单独的 OpenPose 或 Depth 输出插槽。

要继续做 AI 视频生成，先确认下游模型支持视频参考或对应控制方式，再安装所需模型、自定义节点和兼容工作流。工作台出现某个模型选项，不代表你的 ComfyUI 已经安装了整套依赖。

基础摆位和预演可先独立使用。自然语言辅助、视觉分析或云端提示词功能需要配置相应服务；部分本地代理依赖独立 Vite / Electron 环境，不保证在节点嵌入模式中自动可用。

AI 生成结果不会自动覆盖本节点的取景器视频输出。下游是否保留人物动作与相机运动，取决于实际模型、参考方式与参数，不能保证完全复现。

08 / SAVE & UPDATE保存项目、备份素材与更新节点

保存工作流

编辑后稍等片刻，再保存 ComfyUI 工作流，给镜头数据同步留出时间。当前镜头 JSON 和已绑定的视频文件名会随节点保存；服务器上的视频文件需要继续保留。

左侧有多个镜头，并不代表 ComfyUI 工作流会把整个镜头库、所有导入模型、参考图和浏览器资源打包。需要跨电脑迁移时，请同时备份素材、项目数据与已渲染视频。

更新节点

1. 保存当前工作流，备份旧节点目录与重要素材。
2. 停止 ComfyUI，用新包完整更新节点目录，保持 node.py、web、studio 来自同一版。
3. 重新启动 ComfyUI，并在浏览器按 Ctrl + F5。
4. 检查三个输出端口和“渲染预演”按钮，再用短镜头验证输出。

迁移电脑后，原来的服务端绝对路径可能失效，需要重新渲染或放回视频。只清理缓存或删除旧资源前，请确认工作流不再引用它们。

09 / TROUBLESHOOTING常见问题与处理方法

先确认完整安装、重启与强制刷新，再对照以下情况排查。点击问题可展开。

10 / READY TO USE安装完成后，检查这六项

1. 能搜索到节点，嵌入工作台正常显示。
2. 取景器有画面，播放和拖动时间线能看到镜头变化。
3. 右侧底部“渲染预演”为主操作，“渲染和导出工作室”为次级入口。
4. 节点包含 shot_json、video、video_path 三个输出。
5. video → Save Video 的短镜头测试能完成，视频可播放。
6. 保存工作流后，重要模型、参考图和视频也已有单独备份。

这条最短链路跑通后，再增加镜头复杂度，或连接自己的视频参考生成工作流。