Repolode
提交项目
NomaDamas

NomaDamas/CozyClay

在浏览器中搭建场景、摆放角色、编排镜头运动，并将分镜交给 AI 视频模型的预演工具。

在 GitHub 查看官网
Star
807
Fork
93
未关闭 Issue
13
最近提交
昨天

这是什么？

CozyClay 是基于 Three.js 和 React Three Fiber 构建的浏览器预演工具，可以用基础体块搭建场景，添加带骨骼或无骨骼的角色并摆出姿势，在时间线上设计镜头运动和切换。

它的主要输出面向 AI 视频生成。每个镜头可导出为关键帧包（首尾帧、灰盒视频、相机 JSON 和提示词），也可导出 mp4、深度与法线通道、分镜联系表或 OTIO 剪辑列表。目标模型包括 Seedance 2.5、Kling 2、Veo 3 和自托管的 MiniMax-H3，超出模型限制的镜头会被标记。

工具同时提供用于静态分镜的 Storyboard 模式、用于图像和视频节点的 Workflow 画布（可接 ComfyUI 或 fal），以及可通过聊天面板、MCP 服务或 `cclay` 命令行驱动场景的智能体。使用 `npx cozyclay` 即可在本地运行。

核心功能

  • 01用基础体块搭建场景，并通过变换工具移动、旋转和缩放。
  • 02支持带骨骼的可摆姿角色，也支持用于走位的无骨骼胶囊人偶。
  • 03在时间线上编排镜头运动与切换，可在俯视图中绘制轨道推拉。
  • 04导出关键帧包、mp4 镜头、深度与法线通道及 OTIO 剪辑列表，用于 AI 视频生成。
  • 05所有场景修改都进入统一的历史记录，可撤销和重做。
  • 06可通过聊天面板、MCP 服务或终端命令行由 AI 智能体操控工作室。

适用场景

  • 在拍摄前预演电影、广告或音乐视频的镜头。
  • 制作分镜，并将其转化为带运动的镜头。
  • 借助可控的镜头运动和人物走位生成 AI 视频。
  • 为虚拟制片规划场景布局和角色路径。

快速上手

  1. 1

    使用 npx 启动工作室

    npx cozyclay
  2. 2

    打开内置的起始场景而非空白房间

    npx cozyclay --scene city-block

使用前须知

  • 需要 Node.js 22.19 或更高版本以及基于 Chromium 的浏览器。
  • 部分功能需要你自己的 API 密钥，例如智能体提供商以及通过 fal 或 ComfyUI 使用的视频节点。

标签

#3d#previs#storyboard#ai-video#threejs#webgl#animation#camera-control#3d-animation#ai

常见问题

CozyClay 是什么？
在浏览器中搭建场景、摆放角色、编排镜头运动，并将分镜交给 AI 视频模型的预演工具。 CozyClay 是基于 Three.js 和 React Three Fiber 构建的浏览器预演工具，可以用基础体块搭建场景，添加带骨骼或无骨骼的角色并摆出姿势，在时间线上设计镜头运动和切换。
CozyClay 可以免费使用吗？用的什么许可证？
CozyClay 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
CozyClay 还在维护吗？
活跃维护中。CozyClay 最近一次提交是在 2026年10月19日。
CozyClay 适合用来做什么？
在拍摄前预演电影、广告或音乐视频的镜头。 制作分镜，并将其转化为带运动的镜头。 借助可控的镜头运动和人物走位生成 AI 视频。 为虚拟制片规划场景布局和角色路径。
CozyClay 怎么安装和运行？
使用 npx 启动工作室: npx cozyclay 打开内置的起始场景而非空白房间: npx cozyclay --scene city-block
在哪里获取 CozyClay？
源代码和安装说明在 GitHub 上：https://github.com/NomaDamas/CozyClay

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目