HaD0Yun/CozyClay

项目介绍

CozyClay 是一个运行在浏览器里的预演（previs）工作室，用来在花钱生成 AI 视频之前先把镜头定下来。你可以用基础几何体搭场景，加入带骨骼的角色或胶囊替身，向智能体描述动作并编译成逐帧动画，再把镜头排到时间线上、画推轨、调整剪辑。导出物面向视频模型：首末帧、灰模参考片段、相机数据、深度与法线通道、联系人表、OTIO 剪辑表和描述真实构图的提示词 (3)。

它针对的问题是提示词漂移：纯文本无法固定站位、动作时机和相机位置，每生成一次都要付费。先在 3D 里把这些决策做完，视频模型拿到的是有约束的参考，而不是靠猜 (15)。

适合动画师、预演美术和 AI 视频创作者，尤其是希望镜头可控、而非只靠文字生成的人。Storyboard 模式提供带字幕的分镜面板和动态分镜，适合偏好静帧规划的团队 (21)。

快速使用

需要 Node.js 22.19 或更高版本，以及 Chromium 浏览器；不需要 GPU、Python 或下载模型 (3)。

运行已发布的包：

npx cozyclay

然后打开 http://127.0.0.1:5180/app/ 进入工作室 (17)。也可以从源码运行：

git clone https://github.com/NomaDamas/CozyClay.git && cd CozyClay
npm install
npm run dev     # http://127.0.0.1:5180/app/
npm test

进入工作室后，先搭场景，用智能体面板（Cmd/Ctrl+B）描述并编译动作，再设置镜头，最后按目标视频模型导出关键帧包 (22)。

用 AI 驱动

可以用三种入口操作同一个实时场景：在工作室内的智能体面板中，用 ChatGPT 登录或填入自己的 Anthropic、OpenAI、Gemini、MiniMax、OpenRouter、CLIProxyAPI 密钥；通过 npx -y cozyclay mcp 启动 MCP 服务器，供 Claude Desktop、Claude Code、Cursor 或其他 MCP 客户端连接；以及通过终端接口 cclay live status --wait 以 JSON 输入输出驱动编码智能体 (22)。MCP 配置示例：

{ "mcpServers": { "cozyclay": { "command": "npx", "args": ["-y", "cozyclay", "mcp"] } } }

使用约束

• 许可证： AGPL-3.0-or-later；另有附加授权条款和第三方声明文档 (40)。
• 运行环境： Node 22.19+、Chromium 浏览器。每次执行 npx cozyclay 都会拉取最新版本；Windows 上出于设计原因关闭了一键更新，更新按钮改为提供可复制的命令 (3)。
• 遥测： 匿名遥测有专门文档，可用 cclay telemetry off 关闭 (32)。
• 模型密钥： 智能体面板需要 ChatGPT 登录或自带服务商密钥；项目本身不包含模型权重，也不包含视频生成器。

文档

主要参考资料包括 面向 AI 智能体的安装指南、动作规格与 QA 指南、cclay live CLI 文档、MCP 工具说明、工作室界面地图 和 隐私说明。背景指南覆盖 灰模转视频流程 与 AI 视频相机控制。

HotRepo 点评

CozyClay 在 2026-11-06 的 JavaScript 日榜快照中新增 49 颗 Star，当天语言榜最好名次为第 13。这只是单日数据，能说明该快照前后关注度集中上升，但不足以判断趋势。技术层面比较具体：确定性的动作编译器与 QA、通过 MCP 和 CLI 提供的多入口智能体控制，以及按具体视频模型输入格式设计的导出。实际采用时主要考虑 AGPL-3.0 许可证，以及需要自备模型密钥这一点。