Communitygithub.com

thevibethinker/n5os-ode

以 React 與 Remotion 程式化建立影片。可搭建專案、撰寫組合並渲染出 MP4。針對 Zo 最佳化的官方 Remotion 技能包裝。

n5os-ode 是什麼?

這是一個專為 Zo 環境優化的 Remotion 包裝技能,讓開發者能夠以 React 元件程式化地建立與渲染影片。它提供完整的專案 scaffold、composition 定義、即時預覽與 MP4 匯出功能。此技能適合需要從資料或模板批次產生影片的場景,例如數據圖表動畫、社交媒體內容或產品說明影片。所有動畫必須使用 `useCurrentFrame()` 與 Spring 系統,禁止 CSS 動畫以避免渲染錯誤。支援多種編碼格式(h264、h265、vp8、vp9、prores),並且能與 Zo 的 `/zo/ask` 平行渲染工作流程無縫整合,輸出到 `Sites/<name>/out/` 目錄。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thevibethinker/n5os-ode/tree/HEAD/Skills/remotion

在你喜歡的 AI 中提問

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

說明文件

使用時機

在以下情況使用此技能:

  • 從程式碼建立程式化影片(非生成式 AI 影片)
  • 製作資料驅動的影片內容(圖表、統計、個人化影片)
  • 從模板加資料批次產出影片
  • 製作動態社群媒體內容(TikTok、Reels、Shorts)
  • 需要精準控制來製作產品介紹或解說影片

快速開始

1. 建立新專案

python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video

2. 撰寫你的 Composition

編輯 src/Composition.tsx —— 這是以 React 元件定義的影片。

3. 在 Studio 中預覽

python3 Skills/remotion/scripts/remotion_cli.py studio my-video

4. 渲染為 MP4

python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4

核心概念

Compositions

Composition 定義了影片的尺寸、長度與 FPS:

<Composition
  id="MyVideo"
  component={MyComponent}
  durationInFrames={300}  // 30fps 下為 10 秒
  fps={30}
  width={1920}
  height={1080}
/>

基於幀的動畫

所有動畫必須使用 useCurrentFrame(),禁止使用 CSS 動畫。

const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });

Sequences

使用 <Sequence> 控制元素出現的時間:

<Sequence from={30} durationInFrames={60}>
  <Title />
</Sequence>

規則參考文件

從上游 Remotion 技能載入的詳細模式,請閱讀下列文件:

規則說明
references/animations.md基於幀的動畫基礎
references/timing.mdSpring、緩動、插值曲線
references/compositions.md定義 Composition、靜態圖片、資料夾
references/sequencing.md元素時間與順序
references/videos.md嵌入影片 - 裁剪、音量、速度
references/audio.md音訊處理 - 匯入、裁剪、音量
references/assets.md圖片、字型、靜態檔案
references/transitions.md場景轉場效果
references/text-animations.md字體動畫模式
references/charts.md資料視覺化模式
references/display-captions.mdTikTok 風格字幕

CLI 指令

# 專案管理
python3 Skills/remotion/scripts/remotion_cli.py new <name> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <name>
python3 Skills/remotion/scripts/remotion_cli.py render <name> [--composition ID] [--output path]
python3 Skills/remotion/scripts/remotion_cli.py list

# 渲染選項
--composition ID    # 指定要渲染的 Composition(預設為第一個)
--output PATH       # 輸出檔案路徑(預設為 out/video.mp4)
--fps N             # 覆寫 FPS
--width N           # 覆寫寬度
--height N          # 覆寫高度
--codec CODEC       # h264, h265, vp8, vp9, prores(預設為 h264)

常見模式

淡入/淡出

const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();

const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;

Spring 動畫(自然運動)

const scale = spring({
  frame,
  fps,
  config: { damping: 200 }, // 平滑,無彈跳
});

錯開的元素

{items.map((item, i) => (
  <Sequence key={i} from={i * 10}>
    <Item data={item} />
  </Sequence>
))}

資料驅動影片

type VideoProps = { title: string; stats: number[] };

export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
  // 根據 props 製作動畫
};

// 在 Root.tsx 中:
<Composition
  id="DataVideo"
  component={DataVideo}
  defaultProps={{ title: "Q4 結果", stats: [10, 20, 30] }}
  // ...
/>

與 Zo 整合

批次渲染

使用 /zo/ask 以平行方式渲染多個影片:

for row in data:
    # 每次呼叫使用不同的 props 渲染
    await render_video(row)

輸出位置

為了與 Zo 的站點系統一致,專案放置於 Sites/<name>/。 渲染完成的影片會輸出到 Sites/<name>/out/。

限制

  • 禁止 CSS 動畫 —— 它們無法正確渲染
  • 禁止 Tailwind 動畫 class —— 同樣問題
  • 僅限基於幀的動畫 —— 所有移動都來自 useCurrentFrame()
  • CPU 密集 —— 渲染需要時間;複雜影片 = 更長的渲染時間
  • 需要 Node.js —— Remotion 需要 Node 環境(Zo 中已提供)

相關技能