Communitygithub.com

remotion-to-capcut

將 Remotion 合成內容匯出為可編輯的 CapCut 桌面草稿(原生文字圖層、含關鍵影格的原始片段、音軌、透明圖形圖層)。當使用者希望將 Remotion / AI 製作的影片「可在 CapCut 中開啟、編輯或完成」,或要求提供 CapCut 專案/草稿,或您正在為習慣用 CapCut 剪片的人製作 Remotion 影片時使用。

remotion-to-capcut 是什麼?

此技能可將 Remotion 合成內容轉換為真正的 CapCut 草稿,讓使用者能繼續手動編輯以程式碼建立的影片。目前僅支援 Windows 與 CapCut 桌面版。轉換器會逐影格分析 DOM,將支援的元素對應到 CapCut 的原生文字圖層、含位移/縮放/旋轉/不透明度關鍵影格的原始片段、以及音訊片段。不支援的元素(如形狀、圖片、SVG)會合併為一個透明圖形影片圖層。輸出結果會存放在 `out/capcut/<CompositionId>/` 資料夾,使用時需確保 CapCut 已關閉。 使用方式簡單:在 Remotion 專案資料夾中依序執行 `doctor`(檢查環境)、`list`(列出合成內容)、以及帶有合成 ID 與名稱的指令。轉換約每 6 秒影片需 1 分鐘,可利用 `--frames` 參數指定影格範圍進行迭代。對使用者而言,最關鍵的提醒是保持文字為真實文字、使用 Google Fonts、以 transform 與 opacity 製作動畫、以及將素材與音訊放在 `public/` 並用 `staticFile()` 引用。轉換限制包括:圖形為單層平面、過渡影格與模糊背景會烘焙至圖形層、文字測量基於 CapCut 9.7 版本、以及 CapCut 草稿格式無官方文件,更新可能導致不相容。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OybekWeb1/remotion-to-capcut/tree/HEAD/skills/remotion-to-capcut

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Remotion → CapCut

remotion-to-capcut 將 Remotion 合成內容轉換為真正的 CapCut 草稿,讓使用者可以手動編輯以程式碼建立的影片。目前僅支援 Windows 與 CapCut 桌面版。

匯出

從 Remotion 專案資料夾執行:

npx github:OybekWeb1/remotion-to-capcut doctor

請先修復所有標示 ✗ 的項目(必須安裝並開啟過 CapCut;Python 3.8+ 需在 PATH 中)。

npx github:OybekWeb1/remotion-to-capcut list
npx github:OybekWeb1/remotion-to-capcut <CompositionId> --name "<CapCut 中顯示的名稱>"
  • 大約每 6 秒影片需 1 分鐘。長影片請在背景執行。
  • 寫入草稿時 CapCut 必須關閉。如果 CapCut 正在開啟,工具會等待(--wait <秒數>,預設 600);請要求使用者關閉 CapCut — 切勿自行關閉(可能會有未儲存的工作)。如果逾時,請在 CapCut 關閉後重新執行 --skip-capture;這會重複使用已擷取的內容,僅需數秒。
  • 完成時,讀取 out/capcut/<CompositionId>/summary.txt 並告訴使用者哪些內容已轉換為原生文字與片段,然後:開啟 CapCut → 專案 → 指定的草稿名稱。
  • 迭代特定片段:--frames 0-299。合成屬性:--props props.json。

撰寫可良好轉換的 Remotion 程式碼

轉換器會逐影格檢查渲染的 DOM。可轉換為可編輯 CapCut 項目的內容:

在 Remotion 中在 CapCut 中
一般 DOM 元素(<div>、<span>、<h1>…)中的文字原生文字圖層:字體、大小、顏色、漸層、陰影、描邊、字元/行距
文字或素材上的 transform(平移/縮放/旋轉)和 opacity位置 / 縮放 / 旋轉 / 不透明度關鍵影格
使用 public/ 中檔案的 <OffthreadVideo> / <Video>原始片段,修剪至 Remotion 的修剪範圍,並保留速度
來自 public/ 的 <Audio>具有音量曲線的獨立音訊片段
其他所有內容(卡片、形狀、標誌、圖片、SVG、光漏)一個位於素材上方、帶有透明度的「圖形(alpha)」影片圖層

規則提要:

  1. 保持文字為真實文字。 請勿將文字放在 SVG、canvas 或圖片內。每個文字區塊對應一個元素;其中的樣式範圍(例如帶有不同顏色/字重的 <span>)是允許的。
  2. 使用 Google Fonts(@remotion/google-fonts)。工具會自動下載對應的 TTF 字型檔案;其他字型會回退為 CapCut 的預設字型。
  3. 使用 transform + opacity 製作動畫。 模糊淡入、clip-path 揭示以及逐字效果無法對應至 CapCut 關鍵影格:對應的文字只會移動/淡入。數字計數會顯示最終值。
  4. 素材與音訊必須是 public/ 中的本機檔案,並使用 staticFile() 引用。不支援遠端網址。
  5. 如果使用者應該能夠替換素材,請勿使用 CSS 模糊素材:filter: blur() 超過 1.5px 的片段會直接烘焙至圖形圖層。
  6. 將背景素材放在一個無間隙的序列中(CapCut 的主軌道具有磁性);額外片段放在上方軌道。
  7. 若要刻意將某些內容保留為像素形式(例如複雜的動畫標題),請使用包裝: <div data-capcut="bake">…</div>。

告知使用者限制

  • 圖形是單一平面圖層:如果延長文字,後方的卡片不會隨之增長。
  • 過渡影格與模糊背景會烘焙至圖形圖層。
  • 文字測量是基於 CapCut 9.7 校準;其他版本可能會有數像素的偏移。
  • CapCut 草稿格式無官方文件;CapCut 更新可能導致不相容。

相關技能