CozyClay

CozyClay 概覽

這是什麼

CozyClay 是一個完全在瀏覽器分頁中運行的開源預視覺化工作室。它使用 Three.js 和 React Three Fiber 建構，讓使用者可以佈置場景、為角色擺姿勢、在時間軸上編寫攝影機運動與剪輯，然後將相同的鏡頭匯出給 AI 影片模型使用，例如 Seedance、Kling、Veo、MiniMax H3、Wan 3.0、LTX Desktop 和 fal render-to-real。該專案由 NomaDamas 的 Doyun 建立與維護。

主要功能

• 佈置場景：建立基本幾何體與道具，使用變換工具移動/旋轉/縮放；可加入綁定角色或膠囊人物（無綁定的站位，固定姿勢）。
• 操作攝影機：右鍵拖曳飛行、中鍵平移、Alt+拖曳環繞；切換至攝影機模式可透過鏡頭視角觀看。
• 剪輯與移動攝影機：在時間軸上加入鏡頭，在俯視圖上繪製軌道，設定速度/高度/起重機，並預覽移動。
• 匯出至 AI 影片：一個匯出選單提供關鍵影格包（首/末影格、片段、攝影機 JSON、提示詞、README）為 zip、鏡頭的 mp4、深度+法線條件通道、分鏡表聯絡頁，以及 OTIO 剪輯清單。
• 復原任何操作：每個場景變更（拖曳、時間軸移動、檢查器編輯、代理攝影機關鍵影格）都是一個復原項目；Esc 可取消進行中的拖曳。
• 編譯動作：代理程式撰寫動作規格，確定性編譯器在 X Bot 或 Y Bot 骨架中烘焙每個影格；品質檢測會測量碰撞、腳滑、伸展範圍與接觸點。
• 用 AI 導演：開啟代理面板（Cmd/Ctrl+B），以 ChatGPT 帳號登入，用自然語言要求一個鏡頭；或連接 Claude、任何 MCP 客戶端，或從終端機使用 cclay live 驅動工作室。

使用情境

• 電影、動畫或遊戲過場的預視覺化。
• 在正式製作前佈置場景與規劃攝影機運動。
• 為 AI 影片模型產生結構化提示詞與參考片段。
• 建立包含靜態面板的分鏡表或包含動態鏡頭的動畫腳本。
• 透過代理面板或 MCP 客戶端進行協作鏡頭規劃。

快速開始

你需要 Node.js 22.19 或更新版本、npm 或 bun，以及基於 Chromium 的瀏覽器。 bash npx cozyclay # 或 bunx cozyclay 這會下載已建置的工作室並在 http://127.0.0.1:5180/app/ 開啟。 從原始碼執行： bash git clone https://github.com/NomaDamas/CozyClay.git cd CozyClay npm install npm run dev 開啟 http://127.0.0.1:5180/app/ 進入工作室。

授權與價格

採用 AGPL-3.0 授權。該軟體為開源且免費使用。

內容整理自該專案公開的 README 與儲存庫資訊。