Remocn Studio 交接 是做什麼的?
Remocn Studio (https://remocn.studio) 是一款適用於 macOS 與 Linux 的桌面應用程式。它會即時預覽 Remotion 專案,讓使用者手動調整元素,並匯出 mp4。它只會開啟它能辨識的資料夾,因此專案需要先執行一次 準備,之後就可以隨時 開啟。
輔助腳本位於 ${CLAUDE_SKILL_DIR}/scripts/studio.mjs(在 Claude Code 外部:此檔案旁的 scripts/studio.mjs)。它只需要 Node,並會為每個命令輸出一個 JSON 物件。請從 Remotion 專案根目錄執行,或將根目錄作為第一個參數傳入。
準備
node "${CLAUDE_SKILL_DIR}/scripts/studio.mjs" init <project-root> --name "<影片或產品名稱>"
其功能以及應告知使用者的內容:
- 如果
.remocn/project.json不存在,則建立它(Studio 的專案清單:一個全新的projectId、revision: 0,無品牌資訊)。現有的清單絕不會被修改:其projectId是該專案在 Studio 中的識別身分。 - 如果缺少 Studio 的掃描檔案,則將其放置在
src/videos/registry.tsx,並在進入點中以registerRoot(withVideos(Root))包裹根元件。從此以後,每個匯出meta的src/videos/<slug>/index.tsx都是一個 id 為<slug>的合成,無論在 Remotion Studio 或 Remocn Studio 中皆然。使用者原本在Root.tsx中的合成仍可繼續運作。
對於使用者已擁有的專案,請在執行前詢問:它會編輯進入點(一個匯入、一個包裹)並新增兩個檔案。
如果結果顯示 ok: false 並附帶進入點相關原因,代表進入點在匯入後沒有確切地呼叫一次 registerRoot(Root)。請手動進行包裹:使用結果中的 specifier(相對於進入點,例如 remotion/index.ts 對應 ../src/videos/registry),新增 import { withVideos } from "<registry.specifier>";,並將呼叫改為 registerRoot(withVideos(Root))。若無法做到,請向使用者解釋原因。
然後檢查 npx remotion compositions 是否列出所有影片的 slug。
開啟
僅在使用者同意在 Studio 中開啟專案之後:
node "${CLAUDE_SKILL_DIR}/scripts/studio.mjs" open <project-root>
轉達結果中的 message。根據 action:
deep-link:Studio 正在開啟專案並顯示確認對話框。無需其他操作。launched:Studio 正在啟動,但尚無法指定要開啟哪個資料夾。請告知使用者選擇 開啟資料夾(macOS 上為 ⌘O,Linux 上為 Ctrl+O)並選取專案根目錄,同時提供路徑。not-installed:提供下載連結 (https://remocn.studio) 以及安裝後相同的開啟資料夾步驟。unsupported-platform:Studio 不在此作業系統上執行。影片仍可透過npx remotion studio預覽,並使用npx remotion render <slug>渲染。
如果結果顯示清單遺失,請先執行準備。
若要在不開啟任何內容的情況下檢查 Studio 是否已安裝,請執行 detect 命令。
禁忌事項
- 請勿手動建立
.remocn/project.json或從其他專案複製。兩個擁有相同projectId的專案會在 Studio 中衝突,且 Studio 會拒絕第二個。 - 請勿將影片移出
src/videos/<slug>/資料夾。Studio 是透過資料夾名稱來識別影片的。 - 在 claude.ai 或 ChatGPT 中沒有本機專案可以交接。請引導使用者使用搭載此外掛的編碼代理(Claude Code、Codex),或使用 Remocn Studio 自身的範本。